Interface: PostStepContext

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:249

Correlation identifier for tracing

hookEvent

readonly hookEvent: "PostStep"

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

messageId?

readonly optional messageId?: string

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

Message ID being processed

payload

readonly payload: object

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

Full step.finished payload for advanced use

adapterId

adapterId: string

Adapter instance identifier (required)

adapterName

adapterName: string

Adapter type name (e.g., ‘claude-code’) (required)

adapterSessionId

adapterSessionId: string

Provider’s native session ID (e.g., Claude conversation ID)

agentId

agentId: string

Unique agent identifier (required)

blockIndex

blockIndex: number

Content block index in the turn

clientId?

optional clientId?: string

Client identifier for the owning application/runtime when known.

content

content: { 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"; } = SessionMessageBlockSchema

Step content for PostStep hooks (text, reasoning, tool_call, or tool_output)

Union Members

Type Literal

{ content: string; type: "text"; }

Type Literal

{ source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "image"; }

Type Literal

{ source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "document"; }

Type Literal

{ attachmentType: "file" | "directory"; displayName?: string; fileName: string; filePath: string; source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "attachment"; }

attachmentType

attachmentType: "file" | "directory" = AttachmentTypeSchema

Whether the attachment is a file or directory

displayName?

optional displayName?: string

Optional human-readable display name override

fileName

fileName: string

Original filename with extension (e.g. “api-spec.yaml”) — for display and type inference

filePath

filePath: string

Server-side file path — always populated before message reaches adapters

source

source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; } = ContentSourceSchema

Inline content — base64 for binary, raw string for text

type

type: "attachment"

Type Literal

{ content: string; metadata?: Record<string, unknown>; type: "reasoning"; }

content

content: string

metadata?

optional metadata?: Record<string, unknown>

Optional provider/runtime metadata for reasoning blocks.

type

type: "reasoning"

Type Literal

{ args: Record<string, unknown>; name: string; toolCallId: string; type: "tool_call"; }

Type Literal

{ isError?: boolean; output: string; toolCallId: string; type: "tool_output"; }

messageId?

optional messageId?: string

Message ID being processed

occurredAt?

optional occurredAt?: number

Event occurrence timestamp in epoch milliseconds when known.

providerConfigId?

optional providerConfigId?: string

Resolved provider configuration identifier when known.

sessionId?

optional sessionId?: string

Makaio session ID (NOT provider’s native session ID)

stepType

stepType: "text" | "reasoning" | "tool_use" = StepTypeSchema

Step type (content block type)

turnId?

optional turnId?: string

Turn ID from the session orchestrator. Optional for backward compatibility.

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 optional sessionId?: string

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

Session ID where step completed

stepContent?

readonly optional stepContent?: { 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"; }

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

Step content block (if available).

Fetched from message storage with retry logic. May be undefined if:

messageId not available
Message not yet persisted (timing window)
Block index out of range

Contains actual content: reasoning text, tool args, or message text.

Union Members

Type Literal

{ content: string; type: "text"; }

Type Literal

{ source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "image"; }

Type Literal

{ source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; }; type: "document"; }

Type Literal

attachmentType

attachmentType: "file" | "directory" = AttachmentTypeSchema

Whether the attachment is a file or directory

displayName?

optional displayName?: string

Optional human-readable display name override

fileName

fileName: string

Original filename with extension (e.g. “api-spec.yaml”) — for display and type inference

filePath

filePath: string

Server-side file path — always populated before message reaches adapters

source

source: { data: string; mimeType: string; type: "base64"; } | { mimeType?: string; type: "url"; url: string; } = ContentSourceSchema

Inline content — base64 for binary, raw string for text

type

type: "attachment"

Type Literal

{ content: string; metadata?: Record<string, unknown>; type: "reasoning"; }

content

content: string

metadata?

optional metadata?: Record<string, unknown>

Optional provider/runtime metadata for reasoning blocks.

type

type: "reasoning"

Type Literal

{ args: Record<string, unknown>; name: string; toolCallId: string; type: "tool_call"; }

Type Literal

{ isError?: boolean; output: string; toolCallId: string; type: "tool_output"; }

stepType

readonly stepType: "text" | "reasoning" | "tool_use"

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

Step type (reasoning, tool_use, text)

Methods

next()

next(): Promise<void>

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

Continue to the next interceptor in the chain.

Returns

Promise<void>

stopPropagation()

stopPropagation(): void

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

Stop propagation of this event.

Returns

void