Type Alias: SessionSnapshot

Makaio Framework

---

Makaio Framework / contracts / SessionSnapshot

Type Alias: SessionSnapshot

SessionSnapshot = z.infer<typeof SessionSnapshotSchema>

Defined in: ../../../packages/contracts/src/session/schemas/snapshot.ts:150

Type Composition

• SessionSnapshot
  • z.infer<typeof SessionSnapshotSchema>
    • typeof SessionSnapshotSchema

Resolved Shape

type SessionSnapshot = {
  version: '1.0';
  exportedAt: number;
  options: { includeEvents: boolean; includeToolOutputs: boolean; includeAncestors: boolean; includeChildren: boolean; };
  sessions: Array<{ sessionId: string; createdAt: number; lastActivityAt: number; agents: Array<{ agentId: string; adapterId: string; adapterName: string; sessionId: string; role: 'lead' | 'member'; status: 'idle' | 'active' | 'dead' | 'disposed'; createdAt: number; lastActivityAt: number; adapterSessionId?: string | undefined; model?: string | undefined; cwd?: string | undefined; providerConfigId?: string | undefined; personaId?: string | undefined; profileId?: string | undefined; harnessId?: string | undefined; clientId?: string | undefined; compressionMode?: 'auto' | 'manual' | 'off' | undefined; }>; status: 'active' | 'discovered' | 'closed' | 'archived'; leadAgentId?: string | undefined; parentSessionId?: string | undefined; rootSessionId?: string | undefined; forkPointMessageId?: string | undefined; branchKind?: 'fork' | 'subagent' | 'compress' | 'branch' | 'aside' | 'rewrite' | 'coordinator' | undefined; adapterName?: string | undefined; adapterSessionId?: string | undefined; adapterId?: string | undefined; clientId?: string | undefined; clientAccountId?: string | undefined; lastClientIdentityObservation?: { clientId: string; source: string; kind: string; observedAt: number; payload: Record<string, unknown>; } | undefined; isOrchestrated?: boolean | undefined; title?: string | undefined; summary?: string | undefined; summaryUpdatedAt?: number | undefined; isImported?: boolean | undefined; forkTransforms?: { removedMessageIds?: Array<string> | undefined; appliedPipeline?: Array<{ actionId: string; options?: Record<string, unknown> | undefined; }> | undefined; segments?: Array<{ fromMessageId: string; toMessageId: string; policy: 'verbatim' | 'summarize' | 'exclude'; stripReasoning?: boolean | undefined; stripToolOutputs?: boolean | undefined; overrides?: Record<string, 'exclude'> | undefined; summaryText?: string | undefined; }> | undefined; } | undefined; targetWorkingDirectory?: string | undefined; executionTargetId?: string | undefined; spawningToolCallId?: string | undefined; approvalPolicyOverride?: 'reject' | 'always-ask' | 'full-access' | null | undefined; }>;
  agents: Array<{ agentId: string; adapterId: string; adapterName: string; sessionId: string; role: 'lead' | 'member'; status: 'idle' | 'active' | 'dead' | 'disposed'; createdAt: number; lastActivityAt: number; adapterSessionId?: string | undefined; model?: string | undefined; cwd?: string | undefined; providerConfigId?: string | undefined; personaId?: string | undefined; profileId?: string | undefined; harnessId?: string | undefined; clientId?: string | undefined; compressionMode?: 'auto' | 'manual' | 'off' | undefined; }>;
  messages: Array<{ messageId: string; turnId: string | null; sessionId: string; role: 'user' | 'assistant'; contentText: string; blocks: Array<{ type: 'text'; content: string; } | { type: 'image'; source: { type: 'base64'; data: string; mimeType: string; } | { type: 'url'; url: string; mimeType?: string | undefined; }; } | { type: 'document'; source: { type: 'base64'; data: string; mimeType: string; } | { type: 'url'; url: string; mimeType?: string | undefined; }; } | { type: 'attachment'; fileName: string; filePath: string; source: { type: 'base64'; data: string; mimeType: string; } | { type: 'url'; url: string; mimeType?: string | undefined; }; attachmentType: 'file' | 'directory'; displayName?: string | undefined; } | { type: 'reasoning'; content: string; metadata?: Record<string, unknown> | undefined; } | { type: 'tool_call'; toolCallId: string; name: string; args: Record<string, unknown>; } | { type: 'tool_output'; toolCallId: string; output: string; isError?: boolean | undefined; }>; timestamp: number; agentId?: string | undefined; adapterSessionId?: string | undefined; adapterMessageId?: string | undefined; editOf?: string | undefined; origin?: 'text' | 'voice' | 'compact' | undefined; }>;
  turns: Array<{ turnId: string; sessionId: string; turnNumber: number; startedAt: number; status: 'error' | 'completed' | 'active'; completedAt?: number | undefined; error?: string | undefined; usage?: { total: { inputTokens: number; outputTokens: number; cost?: number | undefined; }; byAgent?: Record<string, { inputTokens: number; outputTokens: number; cost?: number | undefined; }> | undefined; } | undefined; }>;
  events?: Array<{ sessionId: string; eventId: string; timestamp: number; type: 'agent.added'; payload: { sessionId: string; adapterSessionId: string; agentId: string; adapterId: string; adapterName: string; role?: 'lead' | 'member' | undefined; model?: string | undefined; cwd?: string | undefined; }; } | { sessionId: string; eventId: string; timestamp: number; type: 'user_message.sent'; payload: { sessionId: string; turnId: string; turnNumber: number; messageId: string; content: string | { blocks: { type: 'text'; content: string; } | { type: 'image'; source: { type: 'base64'; data: string; mimeType: string; } | { type: 'url'; url: string; mimeType?: string | undefined; }; } | { type: 'document'; source: { type: 'base64'; data: string; mimeType: string; } | { type: 'url'; url: string; mimeType?: string | undefined; }; } | { type: 'attachment'; fileName: string; filePath: string; source: { type: 'base64'; data: string; mimeType: string; } | { type: 'url'; url: string; mimeType?: string | undefined; }; attachmentType: 'file' | 'directory'; displayName?: string | undefined; } | { type: 'reasoning'; content: string; metadata?: Record<string, unknown> | undefined; } | { type: 'tool_call'; toolCallId: string; name: string; args: Record<string, unknown>; } | { type: 'tool_output'; toolCallId: string; output: string; isError?: boolean | undefined; } | Array<{ type: 'text'; content: string; } | { type: 'image'; source: { type: 'base64'; data: string; mimeType: string; } | { type: 'url'; url: string; mimeType?: string | undefined; }; } | { type: 'document'; source: { type: 'base64'; data: string; mimeType: string; } | { type: 'url'; url: string; mimeType?: string | undefined; }; } | { type: 'attachment'; fileName: string; filePath: string; source: { type: 'base64'; data: string; mimeType: string; } | { type: 'url'; url: string; mimeType?: string | undefined; }; attachmentType: 'file' | 'directory'; displayName?: string | undefined; } | { type: 'reasoning'; content: string; metadata?: Record<string, unknown> | undefined; } | { type: 'tool_call'; toolCallId: string; name: string; args: Record<string, unknown>; } | { type: 'tool_output'; toolCallId: string; output: string; isError?: boolean | undefined; }>; role?: 'user' | 'assistant' | 'system' | undefined; }; agentIds: Array<string>; source?: 'user' | 'system' | 'extension' | undefined; origin?: 'text' | 'voice' | 'compact' | undefined; }; } | { sessionId: string; eventId: string; timestamp: number; type: 'user_message.acknowledged'; payload: { sessionId: string; turnId: string; turnNumber: number; messageId: string; agentId: string; }; } | { sessionId: string; eventId: string; timestamp: number; type: 'user_message.completed'; payload: { sessionId: string; turnId: string; turnNumber: number; messageId: string; agentId: string; outcome: 'error' | 'completed' | 'superseded' | 'merged' | 'cancelled' | 'rejected'; supersededBy?: string | undefined; mergedInto?: string | undefined; error?: string | undefined; }; } | { sessionId: string; eventId: string; timestamp: number; type: 'turn.started'; payload: { sessionId: string; turnId: string; turnNumber: number; messageId: string; agentIds: Array<string>; initiator?: { source: 'user' | 'system' | 'extension'; sourceId?: string | undefined; } | undefined; }; } | { sessionId: string; eventId: string; timestamp: number; type: 'turn.completed'; payload: { sessionId: string; turnId: string; turnNumber: number; success: boolean; error?: string | undefined; initiator?: { source: 'user' | 'system' | 'extension'; sourceId?: string | undefined; } | undefined; }; } | { sessionId: string; eventId: string; timestamp: number; type: 'message'; payload: { messageId: string; turnId: string | null; role: 'user' | 'assistant'; }; } | { sessionId: string; eventId: string; timestamp: number; type: 'branch.created'; payload: { childSessionId: string; parentSessionId: string; kind: 'fork' | 'subagent' | 'compress' | 'branch' | 'aside' | 'rewrite' | 'coordinator'; forkPointMessageId?: string | undefined; }; } | { sessionId: string; eventId: string; timestamp: number; type: 'branch.merged'; payload: { childSessionId: string; parentSessionId: string; resultJson?: string | undefined; resultMessageId?: string | undefined; }; } | { sessionId: string; eventId: string; timestamp: number; type: 'squash'; payload: { summaryJson: string; tokensBefore?: number | undefined; tokensAfter?: number | undefined; compressedMessageIds?: Array<string> | undefined; }; } | { sessionId: string; eventId: string; timestamp: number; type: string; payload: Record<string, unknown>; }> | undefined;
};