@makaio/contracts 1.0.0-dev-1779051654000

package/dist/session/schemas/orchestrator.d.ts

@@ -0,0 +1,1271 @@
+import { z } from 'zod';
+/**
+ * Identifies the origin of a turn for loop prevention and audit.
+ *
+ * Used by extensions (e.g., Routine) to distinguish user-initiated turns from
+ * extension-initiated turns, preventing recursive execution loops.
+ */
+export declare const TurnInitiatorSchema: z.ZodObject<{
+    source: z.ZodEnum<{
+        extension: "extension";
+        system: "system";
+        user: "user";
+    }>;
+    sourceId: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+/** Parsed type for {@link TurnInitiatorSchema}. */
+export type TurnInitiator = z.infer<typeof TurnInitiatorSchema>;
+/**
+ * Orchestrator schemas for turn lifecycle and user message routing.
+ *
+ * These schemas are owned by SessionOrchestrator, not SessionService.
+ * SessionService handles lifecycle (CRUD); orchestrator handles routing/turns.
+ */
+export declare const OrchestratorSchemas: {
+    /**
+     * Send a message to a session's agents.
+     *
+     * Subject: `session.sendMessage`
+     * Type: Request (RPC)
+     *
+     * Single entry point for all user messages. Handles:
+     * - Creating session if sessionId does not exist
+     * - Auto-attaching agent via adapter.startAgent if session has no agents
+     * - Turn lifecycle (creates turn if none active)
+     * - Routing to targeted agents
+     *
+     * Default targets lead agent; use `agentIds: 'all'` for broadcast.
+     * @example
+     * ```typescript
+     * // Start new conversation (client generates sessionId)
+     * const { sessionId, messageId, turnId } = await bus.request(SessionSubjects.sendMessage, {
+     *   sessionId: crypto.randomUUID(),
+     *   agent: { kind: 'adapter', adapterName: 'anthropic-sdk', model: 'sonnet' },
+     *   message: 'Hello!',
+     * });
+     *
+     * // Continue conversation (agent already attached)
+     * await bus.request(SessionSubjects.sendMessage, {
+     *   sessionId,
+     *   message: 'Follow-up question',
+     * });
+     *
+     * // Broadcast to all agents
+     * await bus.request(SessionSubjects.sendMessage, {
+     *   sessionId,
+     *   message: 'What do you all think?',
+     *   agentIds: 'all',
+     * });
+     * ```
+     */
+    sendMessage: {
+        request: z.ZodObject<{
+            sessionId: z.ZodString;
+            message: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                role: z.ZodOptional<z.ZodEnum<{
+                    assistant: "assistant";
+                    system: "system";
+                    user: "user";
+                }>>;
+                blocks: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    content: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"image">;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"document">;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"attachment">;
+                    fileName: z.ZodString;
+                    filePath: z.ZodString;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                    displayName: z.ZodOptional<z.ZodString>;
+                    attachmentType: z.ZodEnum<{
+                        directory: "directory";
+                        file: "file";
+                    }>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"reasoning">;
+                    content: z.ZodString;
+                    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"tool_call">;
+                    toolCallId: z.ZodString;
+                    name: z.ZodString;
+                    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"tool_output">;
+                    toolCallId: z.ZodString;
+                    output: z.ZodString;
+                    isError: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    content: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"image">;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"document">;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"attachment">;
+                    fileName: z.ZodString;
+                    filePath: z.ZodString;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                    displayName: z.ZodOptional<z.ZodString>;
+                    attachmentType: z.ZodEnum<{
+                        directory: "directory";
+                        file: "file";
+                    }>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"reasoning">;
+                    content: z.ZodString;
+                    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"tool_call">;
+                    toolCallId: z.ZodString;
+                    name: z.ZodString;
+                    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"tool_output">;
+                    toolCallId: z.ZodString;
+                    output: z.ZodString;
+                    isError: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>], "type">>]>;
+            }, z.core.$strip>]>;
+            agent: z.ZodOptional<z.ZodUnion<readonly [z.ZodObject<{
+                providerConfigId: z.ZodOptional<z.ZodString>;
+                model: z.ZodOptional<z.ZodString>;
+                reasoningEffort: z.ZodOptional<z.ZodEnum<{
+                    "extra-high": "extra-high";
+                    high: "high";
+                    low: "low";
+                    medium: "medium";
+                    none: "none";
+                }>>;
+                cwd: z.ZodOptional<z.ZodString>;
+                systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    mode: z.ZodLiteral<"append">;
+                    content: z.ZodString;
+                }, z.core.$strip>]>>;
+                allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                mcpSessionContext: z.ZodOptional<z.ZodObject<{
+                    sessionId: z.ZodString;
+                    servers: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        transport: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"stdio">;
+                            command: z.ZodString;
+                            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                        }, z.core.$strip>, z.ZodObject<{
+                            url: z.ZodString;
+                            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                name: z.ZodString;
+                                permission_policy: z.ZodEnum<{
+                                    always_allow: "always_allow";
+                                    always_ask: "always_ask";
+                                    always_deny: "always_deny";
+                                }>;
+                            }, z.core.$strip>>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                            type: z.ZodLiteral<"sse">;
+                        }, z.core.$strip>, z.ZodObject<{
+                            url: z.ZodString;
+                            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                name: z.ZodString;
+                                permission_policy: z.ZodEnum<{
+                                    always_allow: "always_allow";
+                                    always_ask: "always_ask";
+                                    always_deny: "always_deny";
+                                }>;
+                            }, z.core.$strip>>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                            type: z.ZodLiteral<"http">;
+                        }, z.core.$strip>], "type">;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                        }>;
+                    }, z.core.$strip>>;
+                    directTools: z.ZodArray<z.ZodObject<{
+                        fullName: z.ZodString;
+                        originalName: z.ZodString;
+                        serverName: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                            hidden: "hidden";
+                        }>;
+                        enabled: z.ZodBoolean;
+                        enabledBy: z.ZodOptional<z.ZodEnum<{
+                            discovery: "discovery";
+                            toolset: "toolset";
+                        }>>;
+                        enabledAt: z.ZodOptional<z.ZodNumber>;
+                        exposed: z.ZodBoolean;
+                    }, z.core.$strip>>;
+                    discoverableTools: z.ZodArray<z.ZodObject<{
+                        fullName: z.ZodString;
+                        originalName: z.ZodString;
+                        serverName: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                            hidden: "hidden";
+                        }>;
+                        enabled: z.ZodBoolean;
+                        enabledBy: z.ZodOptional<z.ZodEnum<{
+                            discovery: "discovery";
+                            toolset: "toolset";
+                        }>>;
+                        enabledAt: z.ZodOptional<z.ZodNumber>;
+                        exposed: z.ZodBoolean;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                kind: z.ZodLiteral<"adapter">;
+                adapterName: z.ZodOptional<z.ZodString>;
+                adapterId: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>, z.ZodObject<{
+                providerConfigId: z.ZodOptional<z.ZodString>;
+                reasoningEffort: z.ZodOptional<z.ZodEnum<{
+                    "extra-high": "extra-high";
+                    high: "high";
+                    low: "low";
+                    medium: "medium";
+                    none: "none";
+                }>>;
+                cwd: z.ZodOptional<z.ZodString>;
+                systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    mode: z.ZodLiteral<"append">;
+                    content: z.ZodString;
+                }, z.core.$strip>]>>;
+                allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                mcpSessionContext: z.ZodOptional<z.ZodObject<{
+                    sessionId: z.ZodString;
+                    servers: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        transport: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"stdio">;
+                            command: z.ZodString;
+                            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                        }, z.core.$strip>, z.ZodObject<{
+                            url: z.ZodString;
+                            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                name: z.ZodString;
+                                permission_policy: z.ZodEnum<{
+                                    always_allow: "always_allow";
+                                    always_ask: "always_ask";
+                                    always_deny: "always_deny";
+                                }>;
+                            }, z.core.$strip>>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                            type: z.ZodLiteral<"sse">;
+                        }, z.core.$strip>, z.ZodObject<{
+                            url: z.ZodString;
+                            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                name: z.ZodString;
+                                permission_policy: z.ZodEnum<{
+                                    always_allow: "always_allow";
+                                    always_ask: "always_ask";
+                                    always_deny: "always_deny";
+                                }>;
+                            }, z.core.$strip>>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                            type: z.ZodLiteral<"http">;
+                        }, z.core.$strip>], "type">;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                        }>;
+                    }, z.core.$strip>>;
+                    directTools: z.ZodArray<z.ZodObject<{
+                        fullName: z.ZodString;
+                        originalName: z.ZodString;
+                        serverName: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                            hidden: "hidden";
+                        }>;
+                        enabled: z.ZodBoolean;
+                        enabledBy: z.ZodOptional<z.ZodEnum<{
+                            discovery: "discovery";
+                            toolset: "toolset";
+                        }>>;
+                        enabledAt: z.ZodOptional<z.ZodNumber>;
+                        exposed: z.ZodBoolean;
+                    }, z.core.$strip>>;
+                    discoverableTools: z.ZodArray<z.ZodObject<{
+                        fullName: z.ZodString;
+                        originalName: z.ZodString;
+                        serverName: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                            hidden: "hidden";
+                        }>;
+                        enabled: z.ZodBoolean;
+                        enabledBy: z.ZodOptional<z.ZodEnum<{
+                            discovery: "discovery";
+                            toolset: "toolset";
+                        }>>;
+                        enabledAt: z.ZodOptional<z.ZodNumber>;
+                        exposed: z.ZodBoolean;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                kind: z.ZodLiteral<"canonical-model">;
+                model: z.ZodString;
+            }, z.core.$loose>, z.ZodObject<{
+                providerConfigId: z.ZodOptional<z.ZodString>;
+                model: z.ZodOptional<z.ZodString>;
+                reasoningEffort: z.ZodOptional<z.ZodEnum<{
+                    "extra-high": "extra-high";
+                    high: "high";
+                    low: "low";
+                    medium: "medium";
+                    none: "none";
+                }>>;
+                cwd: z.ZodOptional<z.ZodString>;
+                systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    mode: z.ZodLiteral<"append">;
+                    content: z.ZodString;
+                }, z.core.$strip>]>>;
+                allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                mcpSessionContext: z.ZodOptional<z.ZodObject<{
+                    sessionId: z.ZodString;
+                    servers: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        transport: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"stdio">;
+                            command: z.ZodString;
+                            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                        }, z.core.$strip>, z.ZodObject<{
+                            url: z.ZodString;
+                            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                name: z.ZodString;
+                                permission_policy: z.ZodEnum<{
+                                    always_allow: "always_allow";
+                                    always_ask: "always_ask";
+                                    always_deny: "always_deny";
+                                }>;
+                            }, z.core.$strip>>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                            type: z.ZodLiteral<"sse">;
+                        }, z.core.$strip>, z.ZodObject<{
+                            url: z.ZodString;
+                            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                name: z.ZodString;
+                                permission_policy: z.ZodEnum<{
+                                    always_allow: "always_allow";
+                                    always_ask: "always_ask";
+                                    always_deny: "always_deny";
+                                }>;
+                            }, z.core.$strip>>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                            type: z.ZodLiteral<"http">;
+                        }, z.core.$strip>], "type">;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                        }>;
+                    }, z.core.$strip>>;
+                    directTools: z.ZodArray<z.ZodObject<{
+                        fullName: z.ZodString;
+                        originalName: z.ZodString;
+                        serverName: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                            hidden: "hidden";
+                        }>;
+                        enabled: z.ZodBoolean;
+                        enabledBy: z.ZodOptional<z.ZodEnum<{
+                            discovery: "discovery";
+                            toolset: "toolset";
+                        }>>;
+                        enabledAt: z.ZodOptional<z.ZodNumber>;
+                        exposed: z.ZodBoolean;
+                    }, z.core.$strip>>;
+                    discoverableTools: z.ZodArray<z.ZodObject<{
+                        fullName: z.ZodString;
+                        originalName: z.ZodString;
+                        serverName: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                            hidden: "hidden";
+                        }>;
+                        enabled: z.ZodBoolean;
+                        enabledBy: z.ZodOptional<z.ZodEnum<{
+                            discovery: "discovery";
+                            toolset: "toolset";
+                        }>>;
+                        enabledAt: z.ZodOptional<z.ZodNumber>;
+                        exposed: z.ZodBoolean;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                kind: z.ZodString;
+            }, z.core.$loose>]>>;
+            agentIds: z.ZodOptional<z.ZodUnion<readonly [z.ZodArray<z.ZodString>, z.ZodLiteral<"all">]>>;
+            deliveryMode: z.ZodOptional<z.ZodEnum<{
+                enqueue: "enqueue";
+            }>>;
+            turnId: z.ZodOptional<z.ZodString>;
+            sessionContext: z.ZodOptional<z.ZodObject<{
+                messageHistory: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    role: z.ZodOptional<z.ZodEnum<{
+                        assistant: "assistant";
+                        system: "system";
+                        user: "user";
+                    }>>;
+                    blocks: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"text">;
+                        content: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"image">;
+                        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"base64">;
+                            data: z.ZodString;
+                            mimeType: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"url">;
+                            url: z.ZodString;
+                            mimeType: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>], "type">;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"document">;
+                        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"base64">;
+                            data: z.ZodString;
+                            mimeType: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"url">;
+                            url: z.ZodString;
+                            mimeType: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>], "type">;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"attachment">;
+                        fileName: z.ZodString;
+                        filePath: z.ZodString;
+                        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"base64">;
+                            data: z.ZodString;
+                            mimeType: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"url">;
+                            url: z.ZodString;
+                            mimeType: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>], "type">;
+                        displayName: z.ZodOptional<z.ZodString>;
+                        attachmentType: z.ZodEnum<{
+                            directory: "directory";
+                            file: "file";
+                        }>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"reasoning">;
+                        content: z.ZodString;
+                        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"tool_call">;
+                        toolCallId: z.ZodString;
+                        name: z.ZodString;
+                        args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"tool_output">;
+                        toolCallId: z.ZodString;
+                        output: z.ZodString;
+                        isError: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"text">;
+                        content: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"image">;
+                        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"base64">;
+                            data: z.ZodString;
+                            mimeType: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"url">;
+                            url: z.ZodString;
+                            mimeType: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>], "type">;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"document">;
+                        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"base64">;
+                            data: z.ZodString;
+                            mimeType: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"url">;
+                            url: z.ZodString;
+                            mimeType: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>], "type">;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"attachment">;
+                        fileName: z.ZodString;
+                        filePath: z.ZodString;
+                        source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"base64">;
+                            data: z.ZodString;
+                            mimeType: z.ZodString;
+                        }, z.core.$strip>, z.ZodObject<{
+                            type: z.ZodLiteral<"url">;
+                            url: z.ZodString;
+                            mimeType: z.ZodOptional<z.ZodString>;
+                        }, z.core.$strip>], "type">;
+                        displayName: z.ZodOptional<z.ZodString>;
+                        attachmentType: z.ZodEnum<{
+                            directory: "directory";
+                            file: "file";
+                        }>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"reasoning">;
+                        content: z.ZodString;
+                        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"tool_call">;
+                        toolCallId: z.ZodString;
+                        name: z.ZodString;
+                        args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"tool_output">;
+                        toolCallId: z.ZodString;
+                        output: z.ZodString;
+                        isError: z.ZodOptional<z.ZodBoolean>;
+                    }, z.core.$strip>], "type">>]>;
+                }, z.core.$strip>>>;
+                hasNewTransforms: z.ZodOptional<z.ZodBoolean>;
+                hasCompression: z.ZodOptional<z.ZodBoolean>;
+                extractedContext: z.ZodOptional<z.ZodUnknown>;
+                isFirstTurn: z.ZodOptional<z.ZodBoolean>;
+                hasConnectorSwap: z.ZodOptional<z.ZodBoolean>;
+                turnContext: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodType<import("@makaio/framework/contracts").JsonValue, unknown, z.core.$ZodTypeInternals<import("@makaio/framework/contracts").JsonValue, unknown>>>>;
+            }, z.core.$strip>>;
+            responseSchema: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            source: z.ZodOptional<z.ZodEnum<{
+                extension: "extension";
+                system: "system";
+                user: "user";
+            }>>;
+            extensionId: z.ZodOptional<z.ZodString>;
+            originWindowId: z.ZodOptional<z.ZodString>;
+            skipConnectorSwapWarning: z.ZodOptional<z.ZodBoolean>;
+            origin: z.ZodOptional<z.ZodEnum<{
+                compact: "compact";
+                text: "text";
+                voice: "voice";
+            }>>;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            messageId: z.ZodString;
+            turnId: z.ZodString;
+            sessionId: z.ZodString;
+        }, z.core.$strip>;
+    };
+    /**
+     * Explicitly attach an agent to a session.
+     *
+     * Subject: `session.agent.attach`
+     * Type: Request (RPC)
+     *
+     * Unlike auto-attach via sendMessage, this RPC provides explicit control over:
+     * - Agent role (lead vs member)
+     * - Attaching without sending a message
+     *
+     * For branching conversations (fork), use `session.fork` to create a new session
+     * with copied history, then attach agents to the new session.
+     *
+     * Use this for multi-agent scenarios or when you need to pre-attach agents
+     * before sending messages.
+     * @example
+     * ```typescript
+     * // Attach a second agent as a member
+     * const { agentId } = await bus.request(SessionSubjects.agent.attach, {
+     *   sessionId: 'session-123',
+     *   agent: { kind: 'adapter', adapterName: 'openai-node', model: 'gpt-4o' },
+     *   role: 'member',
+     * });
+     *
+     * // Attach with initial message using a persona
+     * const { agentId, messageId } = await bus.request(SessionSubjects.agent.attach, {
+     *   sessionId: 'session-123',
+     *   agent: { kind: 'persona', personaId: 'p-456' },
+     *   role: 'lead',
+     *   initialMessage: 'Take over as lead',
+     * });
+     * ```
+     */
+    'agent.attach': {
+        request: z.ZodObject<{
+            sessionId: z.ZodString;
+            agent: z.ZodObject<{
+                kind: z.ZodString;
+                providerConfigId: z.ZodOptional<z.ZodString>;
+                model: z.ZodOptional<z.ZodString>;
+                reasoningEffort: z.ZodOptional<z.ZodEnum<{
+                    "extra-high": "extra-high";
+                    high: "high";
+                    low: "low";
+                    medium: "medium";
+                    none: "none";
+                }>>;
+                cwd: z.ZodOptional<z.ZodString>;
+                systemPrompt: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                    mode: z.ZodLiteral<"append">;
+                    content: z.ZodString;
+                }, z.core.$strip>]>>;
+                allowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                disallowedTools: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                mcpSessionContext: z.ZodOptional<z.ZodObject<{
+                    sessionId: z.ZodString;
+                    servers: z.ZodArray<z.ZodObject<{
+                        name: z.ZodString;
+                        transport: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                            type: z.ZodLiteral<"stdio">;
+                            command: z.ZodString;
+                            args: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                            env: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                        }, z.core.$strip>, z.ZodObject<{
+                            url: z.ZodString;
+                            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                name: z.ZodString;
+                                permission_policy: z.ZodEnum<{
+                                    always_allow: "always_allow";
+                                    always_ask: "always_ask";
+                                    always_deny: "always_deny";
+                                }>;
+                            }, z.core.$strip>>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                            type: z.ZodLiteral<"sse">;
+                        }, z.core.$strip>, z.ZodObject<{
+                            url: z.ZodString;
+                            headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                                name: z.ZodString;
+                                permission_policy: z.ZodEnum<{
+                                    always_allow: "always_allow";
+                                    always_ask: "always_ask";
+                                    always_deny: "always_deny";
+                                }>;
+                            }, z.core.$strip>>>;
+                            alwaysLoad: z.ZodOptional<z.ZodBoolean>;
+                            type: z.ZodLiteral<"http">;
+                        }, z.core.$strip>], "type">;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                        }>;
+                    }, z.core.$strip>>;
+                    directTools: z.ZodArray<z.ZodObject<{
+                        fullName: z.ZodString;
+                        originalName: z.ZodString;
+                        serverName: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                            hidden: "hidden";
+                        }>;
+                        enabled: z.ZodBoolean;
+                        enabledBy: z.ZodOptional<z.ZodEnum<{
+                            discovery: "discovery";
+                            toolset: "toolset";
+                        }>>;
+                        enabledAt: z.ZodOptional<z.ZodNumber>;
+                        exposed: z.ZodBoolean;
+                    }, z.core.$strip>>;
+                    discoverableTools: z.ZodArray<z.ZodObject<{
+                        fullName: z.ZodString;
+                        originalName: z.ZodString;
+                        serverName: z.ZodString;
+                        description: z.ZodOptional<z.ZodString>;
+                        inputSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                        exposureMode: z.ZodEnum<{
+                            direct: "direct";
+                            discovery: "discovery";
+                            hidden: "hidden";
+                        }>;
+                        enabled: z.ZodBoolean;
+                        enabledBy: z.ZodOptional<z.ZodEnum<{
+                            discovery: "discovery";
+                            toolset: "toolset";
+                        }>>;
+                        enabledAt: z.ZodOptional<z.ZodNumber>;
+                        exposed: z.ZodBoolean;
+                    }, z.core.$strip>>;
+                }, z.core.$strip>>;
+                allowedDirectories: z.ZodOptional<z.ZodArray<z.ZodString>>;
+            }, z.core.$loose>;
+            initialMessage: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+                role: z.ZodOptional<z.ZodEnum<{
+                    assistant: "assistant";
+                    system: "system";
+                    user: "user";
+                }>>;
+                blocks: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    content: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"image">;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"document">;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"attachment">;
+                    fileName: z.ZodString;
+                    filePath: z.ZodString;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                    displayName: z.ZodOptional<z.ZodString>;
+                    attachmentType: z.ZodEnum<{
+                        directory: "directory";
+                        file: "file";
+                    }>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"reasoning">;
+                    content: z.ZodString;
+                    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"tool_call">;
+                    toolCallId: z.ZodString;
+                    name: z.ZodString;
+                    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"tool_output">;
+                    toolCallId: z.ZodString;
+                    output: z.ZodString;
+                    isError: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"text">;
+                    content: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"image">;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"document">;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"attachment">;
+                    fileName: z.ZodString;
+                    filePath: z.ZodString;
+                    source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                        type: z.ZodLiteral<"base64">;
+                        data: z.ZodString;
+                        mimeType: z.ZodString;
+                    }, z.core.$strip>, z.ZodObject<{
+                        type: z.ZodLiteral<"url">;
+                        url: z.ZodString;
+                        mimeType: z.ZodOptional<z.ZodString>;
+                    }, z.core.$strip>], "type">;
+                    displayName: z.ZodOptional<z.ZodString>;
+                    attachmentType: z.ZodEnum<{
+                        directory: "directory";
+                        file: "file";
+                    }>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"reasoning">;
+                    content: z.ZodString;
+                    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"tool_call">;
+                    toolCallId: z.ZodString;
+                    name: z.ZodString;
+                    args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"tool_output">;
+                    toolCallId: z.ZodString;
+                    output: z.ZodString;
+                    isError: z.ZodOptional<z.ZodBoolean>;
+                }, z.core.$strip>], "type">>]>;
+            }, z.core.$strip>]>>;
+            role: z.ZodOptional<z.ZodEnum<{
+                lead: "lead";
+                member: "member";
+            }>>;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            agentId: z.ZodString;
+            adapterSessionId: z.ZodString;
+            role: z.ZodEnum<{
+                lead: "lead";
+                member: "member";
+            }>;
+            messageId: z.ZodOptional<z.ZodString>;
+            turnId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+    };
+    /**
+     * Turn started.
+     *
+     * Subject: `session.turn.started`
+     * Type: Event (fire-and-forget)
+     * Emitted when: First user message of a turn is received
+     */
+    'turn.started': z.ZodObject<{
+        sessionId: z.ZodString;
+        turnId: z.ZodString;
+        turnNumber: z.ZodNumber;
+        messageId: z.ZodString;
+        agentIds: z.ZodArray<z.ZodString>;
+        initiator: z.ZodOptional<z.ZodObject<{
+            source: z.ZodEnum<{
+                extension: "extension";
+                system: "system";
+                user: "user";
+            }>;
+            sourceId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    /**
+     * Turn completed.
+     *
+     * Subject: `session.turn.completed`
+     * Type: Event (fire-and-forget)
+     * Emitted when: All targeted agents have completed processing
+     *
+     * Semantics:
+     * - success=true: all agents completed with outcome='completed'
+     * - success=false: any agent had outcome='error'
+     * - cancelled/superseded/merged outcomes are neutral (not errors)
+     */
+    'turn.completed': z.ZodObject<{
+        sessionId: z.ZodString;
+        turnId: z.ZodString;
+        turnNumber: z.ZodNumber;
+        success: z.ZodBoolean;
+        error: z.ZodOptional<z.ZodString>;
+        initiator: z.ZodOptional<z.ZodObject<{
+            source: z.ZodEnum<{
+                extension: "extension";
+                system: "system";
+                user: "user";
+            }>;
+            sourceId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+    }, z.core.$strip>;
+    /**
+     * User message sent to session.
+     *
+     * Subject: `session.user_message.sent`
+     * Type: Event (fire-and-forget)
+     * Emitted when: User sends a message (before routing to agents)
+     */
+    'user_message.sent': z.ZodObject<{
+        sessionId: z.ZodString;
+        turnId: z.ZodString;
+        turnNumber: z.ZodNumber;
+        messageId: z.ZodString;
+        content: z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            role: z.ZodOptional<z.ZodEnum<{
+                assistant: "assistant";
+                system: "system";
+                user: "user";
+            }>>;
+            blocks: z.ZodUnion<readonly [z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                content: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"image">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"base64">;
+                    data: z.ZodString;
+                    mimeType: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>], "type">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"document">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"base64">;
+                    data: z.ZodString;
+                    mimeType: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>], "type">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"attachment">;
+                fileName: z.ZodString;
+                filePath: z.ZodString;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"base64">;
+                    data: z.ZodString;
+                    mimeType: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>], "type">;
+                displayName: z.ZodOptional<z.ZodString>;
+                attachmentType: z.ZodEnum<{
+                    directory: "directory";
+                    file: "file";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"reasoning">;
+                content: z.ZodString;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"tool_call">;
+                toolCallId: z.ZodString;
+                name: z.ZodString;
+                args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"tool_output">;
+                toolCallId: z.ZodString;
+                output: z.ZodString;
+                isError: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>], "type">, z.ZodArray<z.ZodDiscriminatedUnion<[z.ZodObject<{
+                type: z.ZodLiteral<"text">;
+                content: z.ZodString;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"image">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"base64">;
+                    data: z.ZodString;
+                    mimeType: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>], "type">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"document">;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"base64">;
+                    data: z.ZodString;
+                    mimeType: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>], "type">;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"attachment">;
+                fileName: z.ZodString;
+                filePath: z.ZodString;
+                source: z.ZodDiscriminatedUnion<[z.ZodObject<{
+                    type: z.ZodLiteral<"base64">;
+                    data: z.ZodString;
+                    mimeType: z.ZodString;
+                }, z.core.$strip>, z.ZodObject<{
+                    type: z.ZodLiteral<"url">;
+                    url: z.ZodString;
+                    mimeType: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>], "type">;
+                displayName: z.ZodOptional<z.ZodString>;
+                attachmentType: z.ZodEnum<{
+                    directory: "directory";
+                    file: "file";
+                }>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"reasoning">;
+                content: z.ZodString;
+                metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"tool_call">;
+                toolCallId: z.ZodString;
+                name: z.ZodString;
+                args: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, z.core.$strip>, z.ZodObject<{
+                type: z.ZodLiteral<"tool_output">;
+                toolCallId: z.ZodString;
+                output: z.ZodString;
+                isError: z.ZodOptional<z.ZodBoolean>;
+            }, z.core.$strip>], "type">>]>;
+        }, z.core.$strip>]>;
+        agentIds: z.ZodArray<z.ZodString>;
+        source: z.ZodOptional<z.ZodEnum<{
+            extension: "extension";
+            system: "system";
+            user: "user";
+        }>>;
+        origin: z.ZodOptional<z.ZodEnum<{
+            compact: "compact";
+            text: "text";
+            voice: "voice";
+        }>>;
+    }, z.core.$strip>;
+    /**
+     * User message acknowledged by agent.
+     *
+     * Subject: `session.user_message.acknowledged`
+     * Type: Event (fire-and-forget)
+     * Emitted when: An agent receives and begins processing the message
+     */
+    'user_message.acknowledged': z.ZodObject<{
+        sessionId: z.ZodString;
+        turnId: z.ZodString;
+        turnNumber: z.ZodNumber;
+        messageId: z.ZodString;
+        agentId: z.ZodString;
+    }, z.core.$strip>;
+    /**
+     * User message processing completed by agent.
+     *
+     * Subject: `session.user_message.completed`
+     * Type: Event (fire-and-forget)
+     * Emitted when: An agent finishes processing the message
+     */
+    'user_message.completed': z.ZodObject<{
+        sessionId: z.ZodString;
+        turnId: z.ZodString;
+        turnNumber: z.ZodNumber;
+        messageId: z.ZodString;
+        agentId: z.ZodString;
+        outcome: z.ZodEnum<{
+            cancelled: "cancelled";
+            completed: "completed";
+            error: "error";
+            merged: "merged";
+            rejected: "rejected";
+            superseded: "superseded";
+        }>;
+        supersededBy: z.ZodOptional<z.ZodString>;
+        mergedInto: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>;
+    /**
+     * Fork a session to create a branch point in conversation history.
+     *
+     * Subject: `session.fork`
+     * Type: Request (RPC)
+     *
+     * Creates a new session that references the parent via parentSessionId
+     * and forkPointMessageId. NO message copying occurs - full conversation
+     * is assembled via getFullConversation() which traverses the parent chain.
+     *
+     * The forked session starts with no agents - use agent.attach to add agents.
+     * @example
+     * ```typescript
+     * // Fork entire session history
+     * const { sessionId } = await bus.request(SessionSubjects.fork, {
+     *   sourceSessionId: 'session-123',
+     * });
+     *
+     * // Fork from a specific message (branch point)
+     * const { sessionId } = await bus.request(SessionSubjects.fork, {
+     *   sourceSessionId: 'session-123',
+     *   fromMessageId: 'msg-abc',
+     *   name: 'Alternative approach',
+     * });
+     * ```
+     */
+    fork: {
+        request: z.ZodObject<{
+            sourceSessionId: z.ZodString;
+            fromMessageId: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            branchKind: z.ZodOptional<z.ZodEnum<{
+                aside: "aside";
+                branch: "branch";
+                fork: "fork";
+            }>>;
+            transforms: z.ZodOptional<z.ZodObject<{
+                removedMessageIds: z.ZodOptional<z.ZodArray<z.ZodString>>;
+                appliedPipeline: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    actionId: z.ZodString;
+                    options: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                }, z.core.$strip>>>;
+                segments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    fromMessageId: z.ZodString;
+                    toMessageId: z.ZodString;
+                    policy: z.ZodEnum<{
+                        exclude: "exclude";
+                        summarize: "summarize";
+                        verbatim: "verbatim";
+                    }>;
+                    stripReasoning: z.ZodOptional<z.ZodBoolean>;
+                    stripToolOutputs: z.ZodOptional<z.ZodBoolean>;
+                    overrides: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodLiteral<"exclude">>>;
+                    summaryText: z.ZodOptional<z.ZodString>;
+                }, z.core.$strip>>>;
+            }, z.core.$strip>>;
+            targetWorkingDirectory: z.ZodOptional<z.ZodString>;
+            existingSessionId: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            sessionId: z.ZodString;
+        }, z.core.$strip>;
+    };
+    /**
+     * Aggregated session-level token usage.
+     *
+     * Subject: `session.usage`
+     * Type: Event (fire-and-forget)
+     * Emitted when: UsageAggregator receives adapter.session.usage events
+     *
+     * Aggregates token usage across all adapters in a session.
+     * UsageAggregator listens to adapter.session.usage events, aggregates them
+     * per-session (keyed by adapterSessionId to avoid collisions), and emits
+     * this canonical session-level usage event.
+     *
+     * ContextTracker consumes this to track context window usage against thresholds.
+     * @example
+     * ```typescript
+     * bus.on(SessionSubjects.usage, (ctx) => {
+     *   console.debug(
+     *     `Session ${ctx.payload.sessionId}: ${ctx.payload.totalTokens} tokens ` +
+     *     `(${ctx.payload.adapterCount} adapters)`
+     *   );
+     * });
+     * ```
+     */
+    usage: {
+        request: z.ZodObject<{
+            sessionId: z.ZodString;
+            totalInputTokens: z.ZodNumber;
+            totalOutputTokens: z.ZodNumber;
+            totalTokens: z.ZodNumber;
+            totalCalls: z.ZodNumber;
+            adapterCount: z.ZodNumber;
+        }, z.core.$strip>;
+        response: z.ZodObject<{
+            acknowledged: z.ZodLiteral<true>;
+        }, z.core.$strip>;
+    };
+};
+export type SendMessageRequest = z.infer<typeof OrchestratorSchemas.sendMessage.request>;
+export type SendMessageResponse = z.infer<typeof OrchestratorSchemas.sendMessage.response>;
+export type AgentAttachRequest = z.infer<(typeof OrchestratorSchemas)['agent.attach']['request']>;
+export type AgentAttachResponse = z.infer<(typeof OrchestratorSchemas)['agent.attach']['response']>;
+export type TurnStarted = z.infer<(typeof OrchestratorSchemas)['turn.started']>;
+export type TurnCompleted = z.infer<(typeof OrchestratorSchemas)['turn.completed']>;
+export type UserMessageSent = z.infer<(typeof OrchestratorSchemas)['user_message.sent']>;
+export type UserMessageAcknowledged = z.infer<(typeof OrchestratorSchemas)['user_message.acknowledged']>;
+export type UserMessageCompleted = z.infer<(typeof OrchestratorSchemas)['user_message.completed']>;
+export type SessionForkRequest = z.infer<(typeof OrchestratorSchemas)['fork']['request']>;
+export type SessionForkResponse = z.infer<(typeof OrchestratorSchemas)['fork']['response']>;
+export type SessionUsagePayload = z.infer<typeof OrchestratorSchemas.usage.request>;
+export type SessionUsageResponse = z.infer<typeof OrchestratorSchemas.usage.response>;
+//# sourceMappingURL=orchestrator.d.ts.map