@maiaos/protocol 0.1.0-canary.1

package/dist/session/contract.d.ts

@@ -0,0 +1,1184 @@
+import type { InferRuntimeSchema } from "../runtime-schema/index.js";
+import type { SessionObserveResult } from "./observation-contract.js";
+import type { SessionResumeResult, SessionStopResult } from "./stop-resume-contract.js";
+export declare const sessionSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly createdAt: string;
+    readonly id: string;
+    readonly projectId: string;
+    readonly revision: string;
+    readonly state: "failed" | "idle" | "interrupted" | "recovering" | "running" | "starting" | "stopped" | "stopping" | "waiting-approval";
+    readonly updatedAt: string;
+    readonly workspaceId: string;
+    readonly workspaceRevision: string;
+    readonly agentDefinitionRef?: {
+        readonly contentDigest: string;
+        readonly key: string;
+        readonly version: string;
+    } | undefined;
+    readonly executor?: {
+        readonly connectionId: string;
+        readonly kind: "claude-code" | "codex-cli";
+        readonly model?: string | undefined;
+    } | undefined;
+    readonly failure?: {
+        readonly code: string;
+        readonly message: string;
+    } | undefined;
+    readonly schemaVersion: 4;
+    readonly title?: string | undefined;
+    readonly worktree?: {
+        readonly baseRef: string;
+        readonly baseRevision: string;
+        readonly branch: string;
+        readonly setup: "failed" | "none" | "pending" | "succeeded";
+        readonly skills?: readonly {
+            readonly digest: string;
+            readonly name: string;
+        }[] | undefined;
+        readonly state: "active" | "archived" | "removed";
+    } | undefined;
+}>;
+export type Session = InferRuntimeSchema<typeof sessionSchema>;
+/**
+ * Why a Session or a turn failed: a protocol error code and a short message
+ * Maia wrote, never vendor output.
+ */
+export type FailureDetail = NonNullable<Session["failure"]>;
+export declare const sessionEventSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly eventType: "session.created";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly adoptedFrom?: {
+            readonly nativeId: string;
+            readonly workingDirectory: "original" | "relocated";
+        } | undefined;
+        readonly agentDefinitionRef?: {
+            readonly contentDigest: string;
+            readonly key: string;
+            readonly version: string;
+        } | undefined;
+        readonly executor?: {
+            readonly connectionId: string;
+            readonly kind: "claude-code" | "codex-cli";
+            readonly model?: string | undefined;
+        } | undefined;
+        readonly projectId: string;
+        readonly workspaceId: string;
+        readonly workspaceRevision: string;
+        readonly worktree?: {
+            readonly baseRef: string;
+            readonly baseRevision: string;
+            readonly branch: string;
+        } | undefined;
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly eventType: "session.start.requested";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly [x: string]: never;
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly eventType: "session.runtime.started";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly executableVersion: string;
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly eventType: "session.runtime.recovery.requested";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly [x: string]: never;
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly eventType: "session.runtime.resumed";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly executableVersion: string;
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly eventType: "session.runtime.failed";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly failure?: {
+            readonly code: string;
+            readonly message: string;
+        } | undefined;
+        readonly reason: "activation_failed" | "activation_outcome_unknown" | "runtime_exited";
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly eventType: "session.stopped";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly holdId?: string | undefined;
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly eventType: "session.resume.requested";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly [x: string]: never;
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly eventType: "session.archived";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly branch: string;
+        readonly branchRevision: string;
+        readonly pruneAfter: string;
+        readonly snapshot: "clean" | "committed";
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly eventType: "session.renamed";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly title: string;
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly eventType: "session.worktree.removed";
+    readonly globalCursor: string;
+    readonly payload: {
+        readonly branch: string;
+        readonly cleanupOperationId: string;
+    };
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+} | {
+    readonly commandId: string;
+    readonly globalCursor: string;
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+    readonly eventType: "turn.queued";
+    readonly payload: {
+        readonly turnId: string;
+    };
+} | {
+    readonly commandId: string;
+    readonly globalCursor: string;
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+    readonly eventType: "turn.dispatching";
+    readonly payload: {
+        readonly turnId: string;
+    };
+} | {
+    readonly commandId: string;
+    readonly globalCursor: string;
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+    readonly eventType: "turn.started";
+    readonly payload: {
+        readonly turnId: string;
+    };
+} | {
+    readonly commandId: string;
+    readonly globalCursor: string;
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+    readonly eventType: "turn.completed";
+    readonly payload: {
+        readonly turnId: string;
+    };
+} | {
+    readonly commandId: string;
+    readonly globalCursor: string;
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+    readonly eventType: "turn.interrupted";
+    readonly payload: {
+        readonly turnId: string;
+    };
+} | {
+    readonly commandId: string;
+    readonly globalCursor: string;
+    readonly recordedAt: string;
+    readonly schemaVersion: 4;
+    readonly sessionCursor: string;
+    readonly sessionId: string;
+    readonly eventType: "turn.failed";
+    readonly payload: {
+        readonly turnId: string;
+    };
+}>;
+export type SessionEvent = InferRuntimeSchema<typeof sessionEventSchema>;
+export declare const sessionCreateParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly expectedRevision: "0";
+    readonly workspaceId: string;
+    readonly connectionId?: string | undefined;
+    readonly definitionRef?: {
+        readonly contentDigest: string;
+        readonly key: string;
+        readonly version: string;
+    } | undefined;
+    readonly executor?: "claude-code" | "codex-cli" | undefined;
+    readonly model?: string | undefined;
+    readonly role?: "orchestrator" | "worker" | undefined;
+    readonly title?: string | undefined;
+    readonly worktree?: {
+        readonly baseRef: string;
+    } | undefined;
+}>;
+export type SessionCreateParameters = InferRuntimeSchema<typeof sessionCreateParametersSchema>;
+export declare const sessionMailboxSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly contentBytes: string;
+    readonly createdAt: string;
+    readonly deliveryCount: string;
+    readonly id: string;
+    readonly revision: string;
+    readonly schemaVersion: 1;
+    readonly sessionId: string;
+    readonly updatedAt: string;
+    readonly workspaceId: string;
+}>;
+export type SessionMailbox = InferRuntimeSchema<typeof sessionMailboxSchema>;
+export declare const sessionMessageSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly body: string;
+    readonly createdAt: string;
+    readonly digest: string;
+    readonly id: string;
+    readonly recipientSessionId: string;
+    readonly schemaVersion: 1;
+    readonly senderSessionId: string;
+    readonly subject: string;
+    readonly workspaceId: string;
+}>;
+export type SessionMessage = InferRuntimeSchema<typeof sessionMessageSchema>;
+export declare const sessionDeliverySchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly attemptCount: number;
+    readonly createdAt: string;
+    readonly firstCheckedAt?: string | undefined;
+    readonly id: string;
+    readonly lastCheckedAt?: string | undefined;
+    readonly mailboxId: string;
+    readonly message: {
+        readonly body: string;
+        readonly createdAt: string;
+        readonly digest: string;
+        readonly id: string;
+        readonly recipientSessionId: string;
+        readonly schemaVersion: 1;
+        readonly senderSessionId: string;
+        readonly subject: string;
+        readonly workspaceId: string;
+    };
+    readonly sequence: string;
+    readonly state: "pending";
+} | {
+    readonly attemptCount: number;
+    readonly createdAt: string;
+    readonly firstCheckedAt?: string | undefined;
+    readonly id: string;
+    readonly lastCheckedAt?: string | undefined;
+    readonly mailboxId: string;
+    readonly message: {
+        readonly body: string;
+        readonly createdAt: string;
+        readonly digest: string;
+        readonly id: string;
+        readonly recipientSessionId: string;
+        readonly schemaVersion: 1;
+        readonly senderSessionId: string;
+        readonly subject: string;
+        readonly workspaceId: string;
+    };
+    readonly sequence: string;
+    readonly acknowledgedAt: string;
+    readonly acknowledgingSessionId: string;
+    readonly state: "acknowledged";
+}>;
+export type SessionDelivery = InferRuntimeSchema<typeof sessionDeliverySchema>;
+export declare const sessionMessageSendParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly body: string;
+    readonly commandId: string;
+    readonly recipientSessionId: string;
+    readonly subject: string;
+}>;
+export type SessionMessageSendParameters = InferRuntimeSchema<typeof sessionMessageSendParametersSchema>;
+export declare const sessionInboxCheckParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly limit?: number | undefined;
+}>;
+export type SessionInboxCheckParameters = InferRuntimeSchema<typeof sessionInboxCheckParametersSchema>;
+export declare const sessionInboxAckParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly deliveryId: string;
+    readonly expectedMailboxRevision: string;
+}>;
+export type SessionInboxAckParameters = InferRuntimeSchema<typeof sessionInboxAckParametersSchema>;
+export declare const sessionListParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly afterCursor?: string | undefined;
+    readonly attention?: boolean | undefined;
+    readonly limit?: number | undefined;
+    readonly projectId?: string | undefined;
+    readonly states?: readonly ("failed" | "idle" | "interrupted" | "recovering" | "running" | "starting" | "stopped" | "stopping" | "waiting-approval")[] | undefined;
+}>;
+export type SessionListParameters = InferRuntimeSchema<typeof sessionListParametersSchema>;
+export declare const sessionShowParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly sessionId: string;
+}>;
+export type SessionShowParameters = InferRuntimeSchema<typeof sessionShowParametersSchema>;
+export declare const sessionSpawnParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly expectedRevision: "0";
+    readonly workspaceId: string;
+    readonly definitionRef?: {
+        readonly contentDigest: string;
+        readonly key: string;
+        readonly version: string;
+    } | undefined;
+    readonly harness: "maia-agent" | "pi";
+    readonly parentSessionId: string;
+}>;
+export type SessionSpawnParameters = InferRuntimeSchema<typeof sessionSpawnParametersSchema>;
+export declare const sessionSpawnResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly delivery: "duplicate" | "new";
+    readonly harness: "maia-agent" | "pi";
+    readonly method: "session.spawn";
+    readonly parentSessionId: string;
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+    readonly session: {
+        readonly createdAt: string;
+        readonly id: string;
+        readonly projectId: string;
+        readonly revision: string;
+        readonly state: "failed" | "idle" | "interrupted" | "recovering" | "running" | "starting" | "stopped" | "stopping" | "waiting-approval";
+        readonly updatedAt: string;
+        readonly workspaceId: string;
+        readonly workspaceRevision: string;
+        readonly agentDefinitionRef?: {
+            readonly contentDigest: string;
+            readonly key: string;
+            readonly version: string;
+        } | undefined;
+        readonly executor?: {
+            readonly connectionId: string;
+            readonly kind: "claude-code" | "codex-cli";
+            readonly model?: string | undefined;
+        } | undefined;
+        readonly failure?: {
+            readonly code: string;
+            readonly message: string;
+        } | undefined;
+        readonly schemaVersion: 4;
+        readonly title?: string | undefined;
+        readonly worktree?: {
+            readonly baseRef: string;
+            readonly baseRevision: string;
+            readonly branch: string;
+            readonly setup: "failed" | "none" | "pending" | "succeeded";
+            readonly skills?: readonly {
+                readonly digest: string;
+                readonly name: string;
+            }[] | undefined;
+            readonly state: "active" | "archived" | "removed";
+        } | undefined;
+    };
+}>;
+export type SessionSpawnResult = InferRuntimeSchema<typeof sessionSpawnResultSchema>;
+export declare const sessionEventsListParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly afterSessionCursor: string;
+    readonly limit: number;
+    readonly sessionId: string;
+}>;
+export type SessionEventsListParameters = InferRuntimeSchema<typeof sessionEventsListParametersSchema>;
+export declare const sessionCreateResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly delivery: "duplicate" | "new";
+    readonly method: "session.create";
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+    readonly session: {
+        readonly createdAt: string;
+        readonly id: string;
+        readonly projectId: string;
+        readonly revision: string;
+        readonly state: "failed" | "idle" | "interrupted" | "recovering" | "running" | "starting" | "stopped" | "stopping" | "waiting-approval";
+        readonly updatedAt: string;
+        readonly workspaceId: string;
+        readonly workspaceRevision: string;
+        readonly agentDefinitionRef?: {
+            readonly contentDigest: string;
+            readonly key: string;
+            readonly version: string;
+        } | undefined;
+        readonly executor?: {
+            readonly connectionId: string;
+            readonly kind: "claude-code" | "codex-cli";
+            readonly model?: string | undefined;
+        } | undefined;
+        readonly failure?: {
+            readonly code: string;
+            readonly message: string;
+        } | undefined;
+        readonly schemaVersion: 4;
+        readonly title?: string | undefined;
+        readonly worktree?: {
+            readonly baseRef: string;
+            readonly baseRevision: string;
+            readonly branch: string;
+            readonly setup: "failed" | "none" | "pending" | "succeeded";
+            readonly skills?: readonly {
+                readonly digest: string;
+                readonly name: string;
+            }[] | undefined;
+            readonly state: "active" | "archived" | "removed";
+        } | undefined;
+    };
+}>;
+export type SessionCreateResult = InferRuntimeSchema<typeof sessionCreateResultSchema>;
+export declare const sessionMessageSendResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly delivery: "duplicate" | "new";
+    readonly deliveryId: string;
+    readonly mailboxId: string;
+    readonly message: {
+        readonly body: string;
+        readonly createdAt: string;
+        readonly digest: string;
+        readonly id: string;
+        readonly recipientSessionId: string;
+        readonly schemaVersion: 1;
+        readonly senderSessionId: string;
+        readonly subject: string;
+        readonly workspaceId: string;
+    };
+    readonly method: "session.message.send";
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+    readonly sequence: string;
+}>;
+export type SessionMessageSendResult = InferRuntimeSchema<typeof sessionMessageSendResultSchema>;
+export declare const sessionInboxCheckResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly deliveries: readonly {
+        readonly attemptCount: number;
+        readonly createdAt: string;
+        readonly firstCheckedAt?: string | undefined;
+        readonly id: string;
+        readonly lastCheckedAt?: string | undefined;
+        readonly mailboxId: string;
+        readonly message: {
+            readonly body: string;
+            readonly createdAt: string;
+            readonly digest: string;
+            readonly id: string;
+            readonly recipientSessionId: string;
+            readonly schemaVersion: 1;
+            readonly senderSessionId: string;
+            readonly subject: string;
+            readonly workspaceId: string;
+        };
+        readonly sequence: string;
+        readonly state: "pending";
+    }[];
+    readonly mailbox: {
+        readonly contentBytes: string;
+        readonly createdAt: string;
+        readonly deliveryCount: string;
+        readonly id: string;
+        readonly revision: string;
+        readonly schemaVersion: 1;
+        readonly sessionId: string;
+        readonly updatedAt: string;
+        readonly workspaceId: string;
+    };
+    readonly method: "session.inbox.check";
+}>;
+export type SessionInboxCheckResult = InferRuntimeSchema<typeof sessionInboxCheckResultSchema>;
+export declare const sessionInboxAckResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly delivery: "duplicate" | "new";
+    readonly deliveryRecord: {
+        readonly attemptCount: number;
+        readonly createdAt: string;
+        readonly firstCheckedAt?: string | undefined;
+        readonly id: string;
+        readonly lastCheckedAt?: string | undefined;
+        readonly mailboxId: string;
+        readonly message: {
+            readonly body: string;
+            readonly createdAt: string;
+            readonly digest: string;
+            readonly id: string;
+            readonly recipientSessionId: string;
+            readonly schemaVersion: 1;
+            readonly senderSessionId: string;
+            readonly subject: string;
+            readonly workspaceId: string;
+        };
+        readonly sequence: string;
+        readonly acknowledgedAt: string;
+        readonly acknowledgingSessionId: string;
+        readonly state: "acknowledged";
+    };
+    readonly mailboxId: string;
+    readonly mailboxRevision: string;
+    readonly method: "session.inbox.ack";
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+}>;
+export type SessionInboxAckResult = InferRuntimeSchema<typeof sessionInboxAckResultSchema>;
+export declare const sessionListResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly attention?: readonly {
+        readonly attention: "approval_pending" | "failed" | "question" | "settled_unreviewed" | "stalled" | "turn_failed";
+        readonly sessionId: string;
+    }[] | undefined;
+    readonly items: readonly {
+        readonly createdAt: string;
+        readonly id: string;
+        readonly projectId: string;
+        readonly revision: string;
+        readonly state: "failed" | "idle" | "interrupted" | "recovering" | "running" | "starting" | "stopped" | "stopping" | "waiting-approval";
+        readonly updatedAt: string;
+        readonly workspaceId: string;
+        readonly workspaceRevision: string;
+        readonly agentDefinitionRef?: {
+            readonly contentDigest: string;
+            readonly key: string;
+            readonly version: string;
+        } | undefined;
+        readonly executor?: {
+            readonly connectionId: string;
+            readonly kind: "claude-code" | "codex-cli";
+            readonly model?: string | undefined;
+        } | undefined;
+        readonly failure?: {
+            readonly code: string;
+            readonly message: string;
+        } | undefined;
+        readonly schemaVersion: 4;
+        readonly title?: string | undefined;
+        readonly worktree?: {
+            readonly baseRef: string;
+            readonly baseRevision: string;
+            readonly branch: string;
+            readonly setup: "failed" | "none" | "pending" | "succeeded";
+            readonly skills?: readonly {
+                readonly digest: string;
+                readonly name: string;
+            }[] | undefined;
+            readonly state: "active" | "archived" | "removed";
+        } | undefined;
+    }[];
+    readonly method: "session.list";
+    readonly nextCursor?: string | undefined;
+}>;
+export type SessionListResult = InferRuntimeSchema<typeof sessionListResultSchema>;
+export declare const sessionShowResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly method: "session.show";
+    readonly session: {
+        readonly createdAt: string;
+        readonly id: string;
+        readonly projectId: string;
+        readonly revision: string;
+        readonly state: "failed" | "idle" | "interrupted" | "recovering" | "running" | "starting" | "stopped" | "stopping" | "waiting-approval";
+        readonly updatedAt: string;
+        readonly workspaceId: string;
+        readonly workspaceRevision: string;
+        readonly agentDefinitionRef?: {
+            readonly contentDigest: string;
+            readonly key: string;
+            readonly version: string;
+        } | undefined;
+        readonly executor?: {
+            readonly connectionId: string;
+            readonly kind: "claude-code" | "codex-cli";
+            readonly model?: string | undefined;
+        } | undefined;
+        readonly failure?: {
+            readonly code: string;
+            readonly message: string;
+        } | undefined;
+        readonly schemaVersion: 4;
+        readonly title?: string | undefined;
+        readonly worktree?: {
+            readonly baseRef: string;
+            readonly baseRevision: string;
+            readonly branch: string;
+            readonly setup: "failed" | "none" | "pending" | "succeeded";
+            readonly skills?: readonly {
+                readonly digest: string;
+                readonly name: string;
+            }[] | undefined;
+            readonly state: "active" | "archived" | "removed";
+        } | undefined;
+    };
+}>;
+export type SessionShowResult = InferRuntimeSchema<typeof sessionShowResultSchema>;
+export declare const sessionEventsListResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly headSessionCursor: string;
+    readonly items: readonly ({
+        readonly commandId: string;
+        readonly eventType: "session.created";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly adoptedFrom?: {
+                readonly nativeId: string;
+                readonly workingDirectory: "original" | "relocated";
+            } | undefined;
+            readonly agentDefinitionRef?: {
+                readonly contentDigest: string;
+                readonly key: string;
+                readonly version: string;
+            } | undefined;
+            readonly executor?: {
+                readonly connectionId: string;
+                readonly kind: "claude-code" | "codex-cli";
+                readonly model?: string | undefined;
+            } | undefined;
+            readonly projectId: string;
+            readonly workspaceId: string;
+            readonly workspaceRevision: string;
+            readonly worktree?: {
+                readonly baseRef: string;
+                readonly baseRevision: string;
+                readonly branch: string;
+            } | undefined;
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly eventType: "session.start.requested";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly [x: string]: never;
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly eventType: "session.runtime.started";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly executableVersion: string;
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly eventType: "session.runtime.recovery.requested";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly [x: string]: never;
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly eventType: "session.runtime.resumed";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly executableVersion: string;
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly eventType: "session.runtime.failed";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly failure?: {
+                readonly code: string;
+                readonly message: string;
+            } | undefined;
+            readonly reason: "activation_failed" | "activation_outcome_unknown" | "runtime_exited";
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly eventType: "session.stopped";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly holdId?: string | undefined;
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly eventType: "session.resume.requested";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly [x: string]: never;
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly eventType: "session.archived";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly branch: string;
+            readonly branchRevision: string;
+            readonly pruneAfter: string;
+            readonly snapshot: "clean" | "committed";
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly eventType: "session.renamed";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly title: string;
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly eventType: "session.worktree.removed";
+        readonly globalCursor: string;
+        readonly payload: {
+            readonly branch: string;
+            readonly cleanupOperationId: string;
+        };
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+    } | {
+        readonly commandId: string;
+        readonly globalCursor: string;
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+        readonly eventType: "turn.queued";
+        readonly payload: {
+            readonly turnId: string;
+        };
+    } | {
+        readonly commandId: string;
+        readonly globalCursor: string;
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+        readonly eventType: "turn.dispatching";
+        readonly payload: {
+            readonly turnId: string;
+        };
+    } | {
+        readonly commandId: string;
+        readonly globalCursor: string;
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+        readonly eventType: "turn.started";
+        readonly payload: {
+            readonly turnId: string;
+        };
+    } | {
+        readonly commandId: string;
+        readonly globalCursor: string;
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+        readonly eventType: "turn.completed";
+        readonly payload: {
+            readonly turnId: string;
+        };
+    } | {
+        readonly commandId: string;
+        readonly globalCursor: string;
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+        readonly eventType: "turn.interrupted";
+        readonly payload: {
+            readonly turnId: string;
+        };
+    } | {
+        readonly commandId: string;
+        readonly globalCursor: string;
+        readonly recordedAt: string;
+        readonly schemaVersion: 4;
+        readonly sessionCursor: string;
+        readonly sessionId: string;
+        readonly eventType: "turn.failed";
+        readonly payload: {
+            readonly turnId: string;
+        };
+    })[];
+    readonly method: "session.events.list";
+    readonly nextSessionCursor?: string | undefined;
+    readonly sessionId: string;
+}>;
+export type SessionEventsListResult = InferRuntimeSchema<typeof sessionEventsListResultSchema>;
+export declare const sessionStartParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly expectedRevision: string;
+    readonly sessionId: string;
+}>;
+export type SessionStartParameters = InferRuntimeSchema<typeof sessionStartParametersSchema>;
+export declare const sessionStartResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly delivery: "duplicate" | "new";
+    readonly method: "session.start";
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+    readonly session: {
+        readonly createdAt: string;
+        readonly id: string;
+        readonly projectId: string;
+        readonly revision: string;
+        readonly state: "failed" | "idle" | "interrupted" | "recovering" | "running" | "starting" | "stopped" | "stopping" | "waiting-approval";
+        readonly updatedAt: string;
+        readonly workspaceId: string;
+        readonly workspaceRevision: string;
+        readonly agentDefinitionRef?: {
+            readonly contentDigest: string;
+            readonly key: string;
+            readonly version: string;
+        } | undefined;
+        readonly executor?: {
+            readonly connectionId: string;
+            readonly kind: "claude-code" | "codex-cli";
+            readonly model?: string | undefined;
+        } | undefined;
+        readonly failure?: {
+            readonly code: string;
+            readonly message: string;
+        } | undefined;
+        readonly schemaVersion: 4;
+        readonly title?: string | undefined;
+        readonly worktree?: {
+            readonly baseRef: string;
+            readonly baseRevision: string;
+            readonly branch: string;
+            readonly setup: "failed" | "none" | "pending" | "succeeded";
+            readonly skills?: readonly {
+                readonly digest: string;
+                readonly name: string;
+            }[] | undefined;
+            readonly state: "active" | "archived" | "removed";
+        } | undefined;
+    };
+}>;
+export type SessionStartResult = InferRuntimeSchema<typeof sessionStartResultSchema>;
+export type SessionResult = SessionArchiveResult | SessionCreateResult | SessionDiffResult | SessionEventsListResult | SessionInboxAckResult | SessionInboxCheckResult | SessionListResult | SessionMessageSendResult | SessionObserveResult | SessionRenameResult | SessionResumeResult | SessionShowResult | SessionSpawnResult | SessionStartResult | SessionStopResult;
+export declare const sessionBaseRefSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<string>;
+export type SessionBaseRef = InferRuntimeSchema<typeof sessionBaseRefSchema>;
+export declare const sessionWorktreeSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly baseRef: string;
+    readonly baseRevision: string;
+    readonly branch: string;
+    readonly setup: "failed" | "none" | "pending" | "succeeded";
+    readonly skills?: readonly {
+        readonly digest: string;
+        readonly name: string;
+    }[] | undefined;
+    readonly state: "active" | "archived" | "removed";
+}>;
+export type SessionWorktree = InferRuntimeSchema<typeof sessionWorktreeSchema>;
+export declare const sessionDiffParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly sessionId: string;
+    readonly stat?: boolean | undefined;
+}>;
+export type SessionDiffParameters = InferRuntimeSchema<typeof sessionDiffParametersSchema>;
+export declare const sessionDiffResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly baseRevision: string;
+    readonly branch: string;
+    readonly deletions: number;
+    readonly files: readonly {
+        readonly deletions?: number | undefined;
+        readonly insertions?: number | undefined;
+        readonly path: string;
+        readonly previousPath?: string | undefined;
+        readonly status: "added" | "copied" | "deleted" | "modified" | "renamed" | "type_changed";
+    }[];
+    readonly insertions: number;
+    readonly method: "session.diff";
+    readonly patch?: string | undefined;
+    readonly patchTruncated?: true | undefined;
+    readonly sessionId: string;
+    readonly totalFiles: number;
+}>;
+export type SessionDiffResult = InferRuntimeSchema<typeof sessionDiffResultSchema>;
+export declare const sessionArchiveParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly expectedRevision: string;
+    readonly sessionId: string;
+}>;
+export type SessionArchiveParameters = InferRuntimeSchema<typeof sessionArchiveParametersSchema>;
+export declare const sessionArchiveResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly archive?: {
+        readonly branch: string;
+        readonly branchRevision: string;
+        readonly pruneAfter: string;
+        readonly snapshot: "clean" | "committed";
+    } | undefined;
+    readonly delivery: "duplicate" | "new";
+    readonly method: "session.archive";
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+    readonly session: {
+        readonly createdAt: string;
+        readonly id: string;
+        readonly projectId: string;
+        readonly revision: string;
+        readonly state: "failed" | "idle" | "interrupted" | "recovering" | "running" | "starting" | "stopped" | "stopping" | "waiting-approval";
+        readonly updatedAt: string;
+        readonly workspaceId: string;
+        readonly workspaceRevision: string;
+        readonly agentDefinitionRef?: {
+            readonly contentDigest: string;
+            readonly key: string;
+            readonly version: string;
+        } | undefined;
+        readonly executor?: {
+            readonly connectionId: string;
+            readonly kind: "claude-code" | "codex-cli";
+            readonly model?: string | undefined;
+        } | undefined;
+        readonly failure?: {
+            readonly code: string;
+            readonly message: string;
+        } | undefined;
+        readonly schemaVersion: 4;
+        readonly title?: string | undefined;
+        readonly worktree?: {
+            readonly baseRef: string;
+            readonly baseRevision: string;
+            readonly branch: string;
+            readonly setup: "failed" | "none" | "pending" | "succeeded";
+            readonly skills?: readonly {
+                readonly digest: string;
+                readonly name: string;
+            }[] | undefined;
+            readonly state: "active" | "archived" | "removed";
+        } | undefined;
+    };
+}>;
+export type SessionArchiveResult = InferRuntimeSchema<typeof sessionArchiveResultSchema>;
+export declare const sessionRenameParametersSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly commandId: string;
+    readonly expectedRevision: string;
+    readonly sessionId: string;
+    readonly title: string;
+}>;
+export type SessionRenameParameters = InferRuntimeSchema<typeof sessionRenameParametersSchema>;
+export declare const sessionRenameResultSchema: import("../runtime-schema/runtime-schema.js").RuntimeSchema<{
+    readonly delivery: "duplicate" | "new";
+    readonly method: "session.rename";
+    readonly receipt: {
+        readonly actorId: string;
+        readonly aggregateRevision: string;
+        readonly commandId: string;
+        readonly createdAt: string;
+        readonly eventCursor: string;
+        readonly method: string;
+        readonly receiptId: string;
+        readonly schemaVersion: 1;
+        readonly state: "succeeded";
+        readonly target: {
+            readonly id: string;
+            readonly type: string;
+        };
+        readonly updatedAt: string;
+    };
+    readonly session: {
+        readonly createdAt: string;
+        readonly id: string;
+        readonly projectId: string;
+        readonly revision: string;
+        readonly state: "failed" | "idle" | "interrupted" | "recovering" | "running" | "starting" | "stopped" | "stopping" | "waiting-approval";
+        readonly updatedAt: string;
+        readonly workspaceId: string;
+        readonly workspaceRevision: string;
+        readonly agentDefinitionRef?: {
+            readonly contentDigest: string;
+            readonly key: string;
+            readonly version: string;
+        } | undefined;
+        readonly executor?: {
+            readonly connectionId: string;
+            readonly kind: "claude-code" | "codex-cli";
+            readonly model?: string | undefined;
+        } | undefined;
+        readonly failure?: {
+            readonly code: string;
+            readonly message: string;
+        } | undefined;
+        readonly schemaVersion: 4;
+        readonly title?: string | undefined;
+        readonly worktree?: {
+            readonly baseRef: string;
+            readonly baseRevision: string;
+            readonly branch: string;
+            readonly setup: "failed" | "none" | "pending" | "succeeded";
+            readonly skills?: readonly {
+                readonly digest: string;
+                readonly name: string;
+            }[] | undefined;
+            readonly state: "active" | "archived" | "removed";
+        } | undefined;
+    };
+}>;
+export type SessionRenameResult = InferRuntimeSchema<typeof sessionRenameResultSchema>;
+//# sourceMappingURL=contract.d.ts.map