Interface: SessionEventTypeMap

Makaio Framework / contracts / SessionEventTypeMap

Interface: SessionEventTypeMap

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:217

Map of session event types to their payload schemas.

Plugin Extension Pattern: Plugins can extend this interface via TypeScript declaration merging to add custom event types:

Example

// In plugin code
declare module '@makaio/contracts' {
  interface SessionEventTypeMap {
    'timeline.summary': {
      messageId: string;
      role: 'user' | 'assistant';
      summary: string;
    };
  }
}

Core event types are defined here to maintain type safety for the base system. Plugins augment this map without modifying source code.

Properties

agent.added

agent.added: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:230

Agent added to session (correlation link).

adapterId

adapterId: string

adapterName

adapterName: string

adapterSessionId

adapterSessionId: string

agentId

agentId: string

cwd?

optional cwd?: string

model?

optional model?: string

role?

optional role?: "lead" | "member"

sessionId

sessionId: string

branch.created

branch.created: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:281

Branch created from parent session.

childSessionId

childSessionId: string

forkPointMessageId?

optional forkPointMessageId?: string

kind

kind: "fork" | "branch" | "aside" | "subagent" | "compress" | "rewrite" | "coordinator"

parentSessionId

parentSessionId: string

branch.merged

branch.merged: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:291

Branch merged into parent session.

childSessionId

childSessionId: string

parentSessionId

parentSessionId: string

resultJson?

optional resultJson?: string

resultMessageId?

optional resultMessageId?: string

fork-summary.generated

fork-summary.generated: object

Defined in: ../../../packages/services/core/src/session/session-events/__tests__/shared.ts:68

Fork summary generation event. Matches the UI chat view contract.

fromMessageId

fromMessageId: string

personaName?

optional personaName?: string

summaryText

summaryText: string

toMessageId

toMessageId: string

git.checkout

git.checkout: object

Defined in: ../../../packages/services/core/src/session/session-events/__tests__/shared.ts:25

currentBranch

currentBranch: string

previousBranch?

optional previousBranch?: string

repoPath

repoPath: string

worktree?

optional worktree?: string

git.commit

git.commit: object

Defined in: ../../../packages/services/core/src/session/session-events/__tests__/shared.ts:15

author

author: string

branch

branch: string

commitTimestamp

commitTimestamp: string

email

email: string

hash

hash: string

message

message: string

repoPath

repoPath: string

worktree?

optional worktree?: string

git.merge

git.merge: object

Defined in: ../../../packages/services/core/src/session/session-events/__tests__/shared.ts:31

mergeCommit

mergeCommit: string

repoPath

repoPath: string

sourceBranch

sourceBranch: string

targetBranch

targetBranch: string

worktree?

optional worktree?: string

git.pr.context

git.pr.context: object

Defined in: ../../../packages/services/core/src/session/session-events/__tests__/shared.ts:38

branch

branch: string

prId

prId: string

prNumber

prNumber: number

prTitle

prTitle: string

prUrl

prUrl: string

repoPath

repoPath: string

message

message: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:221

Message correlation event linking messages table to session events.

messageId

messageId: string

role

role: "user" | "assistant"

turnId

turnId: string | null

question-extractor.result

question-extractor.result: object

Defined in: ../../../packages/services/core/src/session/session-events/__tests__/shared.ts:46

questions

questions: object[]

turnId

turnId: string

session.compacted

session.compacted: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:312

Emitted on the parent session when a Claude Code compaction boundary is imported. Uses the plugin event path — not a core event type.

compressChildSessionId

compressChildSessionId: string

Makaio session ID of the compress child (post-compaction session).

preTokens

preTokens: number | null

Approximate token count before compaction.

summary

summary: string | null

Summary text from the isCompactSummary user message when available.

trigger

trigger: "manual" | "auto"

Whether compaction was triggered manually (/compact) or automatically.

skill.activated

skill.activated: object

Defined in: ../../../packages/contracts/src/skill/types.ts:38

Skill activated for a session agent.

agentId

agentId: string

skillName

skillName: string

trigger

trigger: "model" | "user" | "auto" | "reinjection"

turnNumber?

optional turnNumber?: number

skill.catalog.built

skill.catalog.built: object

Defined in: ../../../packages/contracts/src/skill/types.ts:31

Skill catalog built for a session agent.

adapterId?

optional adapterId?: string

agentId

agentId: string

cwd

cwd: string

skillNames

skillNames: string[]

skill.deactivated

skill.deactivated: object

Defined in: ../../../packages/contracts/src/skill/types.ts:45

Skill deactivated for a session agent.

agentId

agentId: string

reason

reason: "user" | "cwd_changed" | "session_end" | "replaced"

skillName

skillName: string

squash

squash: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:301

Context compression event.

compressedMessageIds?

optional compressedMessageIds?: string[]

summaryJson

summaryJson: string

tokensAfter?

optional tokensAfter?: number

tokensBefore?

optional tokensBefore?: number

timeline.summary

timeline.summary: object

Defined in: ../../../packages/services/core/src/session/session-events/__tests__/shared.ts:53

messageId

messageId: string

role

role: "user" | "assistant"

summary

summary: string

tool.tracked

tool.tracked: object

Defined in: ../../../packages/services/core/src/session/session-events/__tests__/shared.ts:58

operationCount

operationCount: number

toolCallId

toolCallId: string

toolName

toolName: string

trackedCallId

trackedCallId: string

turn.completed

turn.completed: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:255

Turn completed event.

error?

optional error?: string

initiator?

optional initiator?: object

initiator.source

source: "user" | "extension" | "system"

Origin category

initiator.sourceId?

optional sourceId?: string

Identifier for the specific origin.

Examples: 'routine:validation', 'loop', 'subagent:xyz'.

sessionId

sessionId: string

success

success: boolean

turnId

turnId: string

turn.started

turn.started: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:244

Turn started event.

agentIds

agentIds: string[]

initiator?

optional initiator?: object

initiator.source

source: "user" | "extension" | "system"

Origin category

initiator.sourceId?

optional sourceId?: string

Identifier for the specific origin.

Examples: 'routine:validation', 'loop', 'subagent:xyz'.

messageId

messageId: string

sessionId

sessionId: string

turnId

turnId: string

user_message.acknowledged

user_message.acknowledged: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:271

User message acknowledged by agent.

agentId

agentId: string

Agent that acknowledged

messageId

messageId: string

User message identifier

sessionId

sessionId: string

Makaio session ID

turnId

turnId: string

Turn identifier (UUID)

turnNumber

turnNumber: number

Monotonic per-session ordinal (1-based).

user_message.completed

user_message.completed: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:276

User message processing completed.

agentId

agentId: string

Agent that completed processing

error?

optional error?: string

Error message when outcome=‘error’

mergedInto?

optional mergedInto?: string

Present when outcome=‘merged’: the messageId this was folded into

messageId

messageId: string

User message identifier

outcome

outcome: "error" | "completed" | "superseded" | "merged" | "cancelled" | "rejected" = MessageOutcomeSchema

Processing outcome

sessionId

sessionId: string

Makaio session ID

supersededBy?

optional supersededBy?: string

Present when outcome=‘superseded’: the messageId that replaced this one

turnId

turnId: string

Turn identifier (UUID)

turnNumber

turnNumber: number

Monotonic per-session ordinal (1-based).

user_message.sent

user_message.sent: object

Defined in: ../../../packages/contracts/src/session/schemas/event.ts:266

User message sent to session.

agentIds

agentIds: string[]

Targeted agent IDs

content

content: string | { blocks: { content: string; type: "text"; } | { source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "image"; } | { source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "document"; } | { attachmentType: "file" | "directory"; displayName?: string; fileName: string; filePath: string; source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "attachment"; } | { content: string; metadata?: Record<string, unknown>; type: "reasoning"; } | { args: Record<string, unknown>; name: string; toolCallId: string; type: "tool_call"; } | { isError?: boolean; output: string; toolCallId: string; type: "tool_output"; } | ({ content: string; type: "text"; } | { source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "image"; } | { source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "document"; } | { attachmentType: "file" | "directory"; displayName?: string; fileName: string; filePath: string; source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "attachment"; } | { content: string; metadata?: Record<string, unknown>; type: "reasoning"; } | { args: Record<string, unknown>; name: string; toolCallId: string; type: "tool_call"; } | { isError?: boolean; output: string; toolCallId: string; type: "tool_output"; })[]; role?: "user" | "assistant" | "system"; } = MessageInputSchema

Message content

messageId

messageId: string

User message identifier

origin?

optional origin?: "text" | "voice" | "compact"

Message origin (for example, voice input pipeline)

sessionId

sessionId: string

Makaio session ID

source?

optional source?: "user" | "extension" | "system"

Request source provenance from session.sendMessage payload

turnId

turnId: string

Turn identifier (UUID)

turnNumber

turnNumber: number

Monotonic per-session ordinal (1-based).