Interface: SessionEventTypeMap

Makaio Framework / contracts/session / 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

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

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.

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

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).