Interface: PostTurnContext

Arbitrary context extensions contributed by the host-registered SessionSubjects.enrichContext handler. Framework spreads these onto the context object at hook-call time. Empty object in OSS mode.

Inherited from

SessionHookContext.contextExtensions

correlationId?

readonly optional correlationId?: string

Defined in: ../../../packages/hooks/src/types/hook-context.ts:194

Correlation identifier for tracing

error?

readonly optional error?: string

Defined in: ../../../packages/hooks/src/types/hook-context.ts:188

Error message if any agent failed

hookEvent

readonly hookEvent: "PostTurn"

Defined in: ../../../packages/hooks/src/types/hook-context.ts:180

messageId

readonly messageId: string

Defined in: ../../../packages/hooks/src/types/hook-context.ts:192

Message identifier for correlation

payload

readonly payload: object

Defined in: ../../../packages/hooks/src/types/hook-context.ts:190

Full turn.completed payload for advanced use

error?

optional error?: string

Error message if any agent failed

initiator?

optional initiator?: object

Origin of the turn (for loop prevention and audit)

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

Makaio session ID

success

success: boolean

Whether all agents completed successfully

turnId

turnId: string

Turn identifier (UUID)

turnNumber

turnNumber: number

Monotonic per-session ordinal (1-based).

recentHistory

readonly recentHistory: object[]

Defined in: ../../../packages/hooks/src/types/hook-context.ts:74

Recent turn history, oldest first (up to 10 turns)

completedAt?

optional completedAt?: number

Turn completion timestamp (Unix ms)

error?

optional error?: string

Error message if status is ‘error’

sessionId

sessionId: string

Session this turn belongs to

startedAt

startedAt: number

Turn start timestamp (Unix ms)

status

status: "error" | "completed" | "active" = TurnStatusSchema

Turn status

turnId

turnId: string

Unique turn identifier

turnNumber

turnNumber: number

Monotonic per-session ordinal (1-based), assigned by turn storage at creation.

usage?

optional usage?: object

Aggregated usage/cost for this turn. Populated on turn completion.

usage.byAgent?

optional byAgent?: Record<string, { cost?: number; inputTokens: number; outputTokens: number; }>

Optional per-agent breakdown (for multi-agent turns)

usage.total

total: object = UsageMetricsSchema

Total aggregated usage across all agents

usage.total.cost?

optional cost?: number

Computed cost in USD (optional, requires pricing data)

usage.total.inputTokens

inputTokens: number

Input tokens consumed

usage.total.outputTokens

outputTokens: number

Output tokens generated

Inherited from

SessionHookContext.recentHistory

session?

readonly optional session?: IMakaioSession

Defined in: ../../../packages/hooks/src/types/hook-context.ts:72

Session object (populated when sessionId is available)

Inherited from

SessionHookContext.session

sessionId

readonly sessionId: string

Defined in: ../../../packages/hooks/src/types/hook-context.ts:182

Session ID where turn completed

success

readonly success: boolean

Defined in: ../../../packages/hooks/src/types/hook-context.ts:186

Whether all agents completed successfully

turnId

readonly turnId: string

Defined in: ../../../packages/hooks/src/types/hook-context.ts:184

Turn identifier

Methods

next()

next(): Promise<void>

Defined in: ../../../packages/hooks/src/types/hook-context.ts:198

Continue to the next interceptor in the chain.

Returns

Promise<void>

stopPropagation()

stopPropagation(): void

Defined in: ../../../packages/hooks/src/types/hook-context.ts:203

Stop propagation of this event. Subsequent interceptors and handlers will NOT be called.

Returns

void