Interface: IMakaioSession

Makaio Framework / contracts / IMakaioSession

Interface: IMakaioSession

Defined in: ../../../packages/contracts/src/session/types.ts:25

A makaio orchestration session.

Represents a logical conversation context that may span multiple agents and adapters over time. Sessions track which agents have participated and the overall lifecycle state.

Declared as an interface (rather than a plain type alias) to allow host-tier code to add host-owned fields via TypeScript declaration merging without touching framework source. Host consumers augment this interface inside a declare module '@makaio/contracts' block.

Extends

output<typeof MakaioSessionSchema>

Properties

adapterId?

optional adapterId?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:67

Adapter instance ID (machine/installation specific). Used to determine if native resume is possible.

Inherited from

z.infer.adapterId

adapterName?

optional adapterName?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:57

Adapter type name (e.g., ‘claude-code’, ‘codex-mcp’). Identifies the source adapter for native imports.

Inherited from

z.infer.adapterName

adapterSessionId?

optional adapterSessionId?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:62

Provider’s session ID. For native imports, this is the external tool’s session identifier.

Inherited from

z.infer.adapterSessionId

agents

agents: object[]

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:22

Agents currently or previously attached to this session

adapterId

adapterId: string

Adapter instance that owns this agent

adapterName

adapterName: string

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

adapterSessionId?

optional adapterSessionId?: string

Provider’s session ID for native resume support

agentId

agentId: string

Unique agent execution unit ID (stable across connector swaps and restarts)

clientId?

optional clientId?: string

Client identifier for the client application this agent runs under (e.g., ‘claude-code’, ‘codex’). Omit for API-only adapters.

compressionMode?

optional compressionMode?: "manual" | "auto" | "off"

Compression mode for session context management.

createdAt

createdAt: number

Timestamp when agent was created (= when added to session)

cwd?

optional cwd?: string

Current working directory

harnessId?

optional harnessId?: string

Resolved harness ID for this agent.

lastActivityAt

lastActivityAt: number

Timestamp of last activity (message sent/received)

model?

optional model?: string

Current model identifier

personaId?

optional personaId?: string

Persona used to configure this agent (if any).

profileId?

optional profileId?: string

Profile used to configure this agent (if any).

providerConfigId?

optional providerConfigId?: string

Provider config UUID for credential/endpoint resolution

role

role: "lead" | "member" = AgentRoleSchema

Agent’s role in the session

sessionId

sessionId: string

Makaio session this agent belongs to

status

status: "active" | "idle" | "dead" | "disposed" = AgentStatusSchema

Agent lifecycle status

Inherited from

z.infer.agents

approvalPolicyOverride?

optional approvalPolicyOverride?: "always-ask" | "reject" | "full-access" | null

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:110

User-set approval policy override for this session. When set, takes precedence over the persona → profile → harness cascade. Null means “use the cascade” (default behavior).

Inherited from

z.infer.approvalPolicyOverride

branchKind?

optional branchKind?: "fork" | "branch" | "aside" | "subagent" | "compress" | "rewrite" | "coordinator"

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:52

Type of branch this session represents. Undefined for root sessions (not created from another session).

Inherited from

z.infer.branchKind

clientAccountId?

optional clientAccountId?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:71

Canonical client account linked to this session.

Inherited from

z.infer.clientAccountId

clientId?

optional clientId?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:69

Client application this session is linked to (for example claude-code).

Inherited from

z.infer.clientId

createdAt

createdAt: number

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:18

Timestamp when the session was created

Inherited from

z.infer.createdAt

executionTargetId?

optional executionTargetId?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:103

Stamped execution target — set during first startAgent resolution.

Inherited from

z.infer.executionTargetId

forkPointMessageId?

optional forkPointMessageId?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:47

Message ID where this session forked from parent. The last message that was copied from parent to this fork. Undefined for root sessions.

Inherited from

z.infer.forkPointMessageId

forkTransforms?

optional forkTransforms?: object

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:96

Fork transforms for context projection (fork sessions only). Contains removedMessageIds and appliedPipeline configuration.

appliedPipeline?

optional appliedPipeline?: object[]

Pipeline steps to apply (must be ‘transformation’ category)

removedMessageIds?

optional removedMessageIds?: string[]

Message IDs to exclude from projected context

segments?

optional segments?: object[]

Segment-based context curation policies. When present, supersedes removedMessageIds and appliedPipeline.

Inherited from

z.infer.forkTransforms

isImported?

optional isImported?: boolean

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:91

Whether this session was imported from external source.

true: Imported (allow incremental re-imports)
false: Created by Makaio runtime (skip on import)

Inherited from

z.infer.isImported

isOrchestrated?

optional isOrchestrated?: boolean

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:79

Whether this session has been modified by Makaio orchestration. False = native session, can use adapter’s native resume. True = Makaio modified history, must inject context.

Inherited from

z.infer.isOrchestrated

lastActivityAt

lastActivityAt: number

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:20

Timestamp of last activity in the session

Inherited from

z.infer.lastActivityAt

lastClientIdentityObservation?

optional lastClientIdentityObservation?: object

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:73

Latest raw client identity observation persisted for the session.

clientId

clientId: string

kind

kind: string

observedAt

observedAt: number = EpochMillisecondsSchema

payload

payload: Record<string, unknown> = JsonObjectSchema

source

source: string

Inherited from

z.infer.lastClientIdentityObservation

leadAgentId?

optional leadAgentId?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:33

Lead agent ID (receives messages by default). Undefined if no agents yet.

Inherited from

z.infer.leadAgentId

parentSessionId?

optional parentSessionId?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:35

Parent session ID (for forked sessions). Undefined for root sessions.

Inherited from

z.infer.parentSessionId

rootSessionId?

optional rootSessionId?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:41

Root session ID for fork chains. Denormalized for efficient “find all sessions in family” queries. Undefined for root sessions (they ARE the root).

Inherited from

z.infer.rootSessionId

sessionId

sessionId: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:16

Unique session identifier

Inherited from

z.infer.sessionId

spawningToolCallId?

optional spawningToolCallId?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:105

Tool call ID of the Agent/spawn_subagent invocation that spawned this session. Only present for subagent sessions.

Inherited from

z.infer.spawningToolCallId

status

status: "active" | "closed" | "archived" | "discovered"

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:31

Current session status.

'active': Ongoing session, agent is running or paused.
'closed': Completed session, no longer active.
'archived': Manually archived by the user.
'discovered': Stub created from log discovery; full import not yet done.

Inherited from

z.infer.status

summary?

optional summary?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:83

Session summary for search and context. Undefined until generated.

Inherited from

z.infer.summary

summaryUpdatedAt?

optional summaryUpdatedAt?: number

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:85

Timestamp when summary was last updated. Used to detect staleness.

Inherited from

z.infer.summaryUpdatedAt

targetWorkingDirectory?

optional targetWorkingDirectory?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:101

Target working directory for this session. Used to override the default working directory for forked sessions.

Inherited from

z.infer.targetWorkingDirectory

title?

optional title?: string

Defined in: ../../../packages/contracts/src/session/schemas/session.ts:81

Session title for sidebar display. Undefined until generated.

Inherited from

z.infer.title