happy-imou-cloud 2.1.41 → 2.1.43

package/dist/lib.d.cts

@@ -1392,19 +1392,19 @@ declare const UpdateSchema: z.ZodObject<{
             flavor?: string | null | undefined;
         }>>>;
     }, "strip", z.ZodTypeAny, {
-        id: string;
         t: "new-session";
+        id: string;
         seq: number;
         metadata: string;
         metadataVersion: number;
         agentState: string | null;
         agentStateVersion: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         sessionIndex?: {
             machineId?: string | null | undefined;
             hostPid?: number | null | undefined;
@@ -1413,19 +1413,19 @@ declare const UpdateSchema: z.ZodObject<{
             flavor?: string | null | undefined;
         } | null | undefined;
     }, {
-        id: string;
         t: "new-session";
+        id: string;
         seq: number;
         metadata: string;
         metadataVersion: number;
         agentState: string | null;
         agentStateVersion: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         sessionIndex?: {
             machineId?: string | null | undefined;
             hostPid?: number | null | undefined;
@@ -1670,22 +1670,22 @@ declare const UpdateSchema: z.ZodObject<{
     createdAt: z.ZodNumber;
 }, "strip", z.ZodTypeAny, {
     id: string;
-    createdAt: number;
     seq: number;
+    createdAt: number;
     body: {
-        id: string;
         t: "new-session";
+        id: string;
         seq: number;
         metadata: string;
         metadataVersion: number;
         agentState: string | null;
         agentStateVersion: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         sessionIndex?: {
             machineId?: string | null | undefined;
             hostPid?: number | null | undefined;
@@ -1749,22 +1749,22 @@ declare const UpdateSchema: z.ZodObject<{
     };
 }, {
     id: string;
-    createdAt: number;
     seq: number;
+    createdAt: number;
     body: {
-        id: string;
         t: "new-session";
+        id: string;
         seq: number;
         metadata: string;
         metadataVersion: number;
         agentState: string | null;
         agentStateVersion: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         sessionIndex?: {
             machineId?: string | null | undefined;
             hostPid?: number | null | undefined;
@@ -1953,8 +1953,6 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         lastChangeSeq: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         metadata?: string | undefined;
         metadataVersion?: number | undefined;
@@ -1963,14 +1961,14 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         pendingCount?: number | undefined;
         pendingVersion?: number | undefined;
         deleted?: boolean | undefined;
     }, {
         id: string;
         lastChangeSeq: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         metadata?: string | undefined;
         metadataVersion?: number | undefined;
@@ -1979,6 +1977,8 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         pendingCount?: number | undefined;
         pendingVersion?: number | undefined;
         deleted?: boolean | undefined;
@@ -2018,9 +2018,9 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
                 p: string;
             };
             id: string;
+            seq: number;
             createdAt: number;
             updatedAt: number;
-            seq: number;
             localId: string | null;
         }, {
             content: {
@@ -2031,9 +2031,9 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
                 p: string;
             };
             id: string;
+            seq: number;
             createdAt: number;
             updatedAt: number;
-            seq: number;
             localId: string | null;
         }>, "many">;
         truncated: z.ZodBoolean;
@@ -2048,9 +2048,9 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
                 p: string;
             };
             id: string;
+            seq: number;
             createdAt: number;
             updatedAt: number;
-            seq: number;
             localId: string | null;
         }[];
         truncated: boolean;
@@ -2065,9 +2065,9 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
                 p: string;
             };
             id: string;
+            seq: number;
             createdAt: number;
             updatedAt: number;
-            seq: number;
             localId: string | null;
         }[];
         truncated: boolean;
@@ -2086,8 +2086,6 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
     session: {
         id: string;
         lastChangeSeq: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         metadata?: string | undefined;
         metadataVersion?: number | undefined;
@@ -2096,6 +2094,8 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         pendingCount?: number | undefined;
         pendingVersion?: number | undefined;
         deleted?: boolean | undefined;
@@ -2110,9 +2110,9 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
                 p: string;
             };
             id: string;
+            seq: number;
             createdAt: number;
             updatedAt: number;
-            seq: number;
             localId: string | null;
         }[];
         truncated: boolean;
@@ -2131,8 +2131,6 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
     session: {
         id: string;
         lastChangeSeq: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         metadata?: string | undefined;
         metadataVersion?: number | undefined;
@@ -2141,6 +2139,8 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         pendingCount?: number | undefined;
         pendingVersion?: number | undefined;
         deleted?: boolean | undefined;
@@ -2155,9 +2155,9 @@ declare const ProtocolV3SessionSnapshotResponseSchema: z.ZodObject<{
                 p: string;
             };
             id: string;
+            seq: number;
             createdAt: number;
             updatedAt: number;
-            seq: number;
             localId: string | null;
         }[];
         truncated: boolean;
@@ -2273,8 +2273,6 @@ declare const ProtocolV3SessionChangesResponseSchema: z.ZodObject<{
     }, "strip", z.ZodTypeAny, {
         id: string;
         lastChangeSeq: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         metadata?: string | undefined;
         metadataVersion?: number | undefined;
@@ -2283,14 +2281,14 @@ declare const ProtocolV3SessionChangesResponseSchema: z.ZodObject<{
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         pendingCount?: number | undefined;
         pendingVersion?: number | undefined;
         deleted?: boolean | undefined;
     }, {
         id: string;
         lastChangeSeq: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         metadata?: string | undefined;
         metadataVersion?: number | undefined;
@@ -2299,6 +2297,8 @@ declare const ProtocolV3SessionChangesResponseSchema: z.ZodObject<{
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         pendingCount?: number | undefined;
         pendingVersion?: number | undefined;
         deleted?: boolean | undefined;
@@ -2345,8 +2345,6 @@ declare const ProtocolV3SessionChangesResponseSchema: z.ZodObject<{
     session: {
         id: string;
         lastChangeSeq: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         metadata?: string | undefined;
         metadataVersion?: number | undefined;
@@ -2355,6 +2353,8 @@ declare const ProtocolV3SessionChangesResponseSchema: z.ZodObject<{
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         pendingCount?: number | undefined;
         pendingVersion?: number | undefined;
         deleted?: boolean | undefined;
@@ -2383,8 +2383,6 @@ declare const ProtocolV3SessionChangesResponseSchema: z.ZodObject<{
     session: {
         id: string;
         lastChangeSeq: number;
-        createdAt?: number | undefined;
-        updatedAt?: number | undefined;
         title?: string | null | undefined;
         metadata?: string | undefined;
         metadataVersion?: number | undefined;
@@ -2393,6 +2391,8 @@ declare const ProtocolV3SessionChangesResponseSchema: z.ZodObject<{
         dataEncryptionKey?: string | null | undefined;
         active?: boolean | undefined;
         activeAt?: number | undefined;
+        createdAt?: number | undefined;
+        updatedAt?: number | undefined;
         pendingCount?: number | undefined;
         pendingVersion?: number | undefined;
         deleted?: boolean | undefined;
@@ -2790,185 +2790,995 @@ declare const UserMessageSchema: z.ZodObject<{
     } | undefined;
 }>;
 type UserMessage = z.infer<typeof UserMessageSchema>;
-type Metadata = {
-    path: string;
-    host: string;
-    version?: string;
-    name?: string;
-    os?: string;
-    summary?: {
+declare const MessageContentSchema: z.ZodUnion<[z.ZodObject<{
+    role: z.ZodLiteral<"user">;
+    content: z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "text";
         text: string;
-        updatedAt: number;
-    };
-    machineId?: string;
-    claudeSessionId?: string;
-    claudeTranscriptPath?: string;
-    codexSessionId?: string;
-    tools?: string[];
-    slashCommands?: string[];
-    homeDir: string;
-    happyHomeDir: string;
-    happyLibDir: string;
-    happyToolsDir: string;
-    startedFromDaemon?: boolean;
-    hostPid?: number;
-    startedBy?: 'daemon' | 'terminal';
-    managedSessionTag?: string;
-    lifecycleState?: 'running' | 'archiveRequested' | 'archived' | string;
-    lifecycleStateSince?: number;
-    archivedBy?: string;
-    archiveReason?: string;
-    flavor?: string;
-    machineOnline?: boolean;
-    machineOnlineAt?: number;
-    happyOrg?: HappyOrgMetadata;
-};
-type AgentState = {
-    controlledByUser?: boolean | null | undefined;
-    requests?: {
-        [id: string]: {
-            tool: string;
-            arguments: any;
-            createdAt: number;
-            requestKind?: 'permission' | 'selection';
-            options?: Array<{
-                optionId: string;
-                label: string;
-                description?: string;
-            }>;
-            defaultOptionId?: string;
-        };
-    };
-    completedRequests?: {
-        [id: string]: {
-            tool: string;
-            arguments: any;
-            createdAt: number;
-            completedAt: number;
-            status: 'canceled' | 'denied' | 'approved';
-            reason?: string;
-            mode?: PermissionMode;
-            decision?: 'approved' | 'approved_for_session' | 'denied' | 'abort';
-            allowTools?: string[];
-            requestKind?: 'permission' | 'selection';
-            selectedOptionId?: string;
-        };
-    };
-};
-
-/**
- * Common RPC types and interfaces for both session and machine clients
- */
-/**
- * Generic RPC handler function type
- * @template TRequest - The request data type
- * @template TResponse - The response data type
- */
-type RpcHandler<TRequest = any, TResponse = any> = (data: TRequest) => TResponse | Promise<TResponse>;
-/**
- * RPC request data from server
- */
-interface RpcRequest {
-    method: string;
-    params: string;
-}
-/**
- * Configuration for RPC handler manager
- */
-interface RpcHandlerConfig {
-    scopePrefix: string;
-    encryptionKey: Uint8Array;
-    encryptionVariant: 'legacy' | 'dataKey';
-    logger?: (message: string, data?: any) => void;
-}
-
-/**
- * Generic RPC handler manager for session and machine clients
- * Manages RPC method registration, encryption/decryption, and handler execution
- */
-
-declare class RpcHandlerManager {
-    private handlers;
-    private readonly scopePrefix;
-    private readonly encryptionKey;
-    private readonly encryptionVariant;
-    private readonly logger;
-    private socket;
-    constructor(config: RpcHandlerConfig);
-    /**
-     * Register an RPC handler for a specific method
-     * @param method - The method name (without prefix)
-     * @param handler - The handler function
-     */
-    registerHandler<TRequest = any, TResponse = any>(method: string, handler: RpcHandler<TRequest, TResponse>): void;
-    /**
-     * Handle an incoming RPC request
-     * @param request - The RPC request data
-     * @param callback - The response callback
-     */
-    handleRequest(request: RpcRequest): Promise<any>;
-    onSocketConnect(socket: Socket): void;
-    onSocketDisconnect(): void;
-    /**
-     * Get the number of registered handlers
-     */
-    getHandlerCount(): number;
-    /**
-     * Check if a handler is registered
-     * @param method - The method name (without prefix)
-     */
-    hasHandler(method: string): boolean;
-    /**
-     * Clear all handlers
-     */
-    clearHandlers(): void;
-    /**
-     * Get the prefixed method name
-     * @param method - The method name
-     */
-    private getPrefixedMethod;
-}
-
-/**
- * Minimal persistence functions for happy CLI
- *
- * Handles settings and private key storage in ~/.happy/ or local .happy/
- */
-
-type SigningCredentials = {
-    version: 1;
-    keyId: string;
-    seed: string;
-    algorithm: 'HMAC-SHA256';
-};
-type Credentials = {
-    token: string;
-    signing?: SigningCredentials | null;
-    aesKey?: string;
-    encryption: {
-        type: 'legacy';
-        secret: Uint8Array;
-    } | {
-        type: 'dataKey';
-        publicKey: Uint8Array;
-        machineKey: Uint8Array;
-    };
-};
-
-type MessageStreamPhase = 'start' | 'delta' | 'commit' | 'abort';
-type MessageStreamMode = 'append' | 'replace';
-type MessageStreamMetadata = {
-    streamId: string;
-    messageId: string;
-    phase: MessageStreamPhase;
-    mode: MessageStreamMode;
-};
-
-/**
- * ACP (Agent Communication Protocol) message data types.
- * This is the unified format for all agent messages - CLI adapts each provider's format to ACP.
- */
-type ACPMessageData = ({
+    }, {
+        type: "text";
+        text: string;
+    }>;
+    localKey: z.ZodOptional<z.ZodString>;
+    meta: z.ZodOptional<z.ZodObject<{
+        sentFrom: z.ZodOptional<z.ZodString>;
+        permissionMode: z.ZodOptional<z.ZodEnum<["default", "acceptEdits", "bypassPermissions", "plan", "read-only", "safe-yolo", "yolo"]>>;
+        model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fallbackModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        customSystemPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        appendSystemPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        allowedTools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+        disallowedTools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+        happyOrg: z.ZodOptional<z.ZodObject<{
+            taskContext: z.ZodOptional<z.ZodObject<{
+                taskId: z.ZodString;
+                organizationId: z.ZodString;
+                organizationRootPath: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                memberAgentId: z.ZodString;
+                supervisorAgentId: z.ZodString;
+                positionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                responsibilityId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            }, {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            }>>;
+            control: z.ZodOptional<z.ZodObject<{
+                action: z.ZodEnum<["terminate", "reopen"]>;
+                reason: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                newContext: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                newDecision: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                newResource: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            }, {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            }>>;
+            replyContext: z.ZodOptional<z.ZodObject<{
+                dispatchId: z.ZodString;
+                taskId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                scope: z.ZodString;
+                replyTo: z.ZodString;
+                memberAgentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                sessionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                positionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                responsibilityId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                routeType: z.ZodNullable<z.ZodOptional<z.ZodEnum<["direct_reply", "version_planning_reply", "analysis_task", "implementation_task", "ack_plus_reply"]>>>;
+                ackType: z.ZodNullable<z.ZodOptional<z.ZodEnum<["none", "read_ack", "dispatch_ack", "route_ack", "progress_ack"]>>>;
+                replyMode: z.ZodNullable<z.ZodOptional<z.ZodEnum<["reply-first", "analysis-first"]>>>;
+                planIntent: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                routerReason: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                goldenRouteId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            }, {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        }, {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | null | undefined;
+        sentFrom?: string | undefined;
+        permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | "read-only" | "safe-yolo" | "yolo" | undefined;
+        fallbackModel?: string | null | undefined;
+        customSystemPrompt?: string | null | undefined;
+        appendSystemPrompt?: string | null | undefined;
+        allowedTools?: string[] | null | undefined;
+        disallowedTools?: string[] | null | undefined;
+        happyOrg?: {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        model?: string | null | undefined;
+        sentFrom?: string | undefined;
+        permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | "read-only" | "safe-yolo" | "yolo" | undefined;
+        fallbackModel?: string | null | undefined;
+        customSystemPrompt?: string | null | undefined;
+        appendSystemPrompt?: string | null | undefined;
+        allowedTools?: string[] | null | undefined;
+        disallowedTools?: string[] | null | undefined;
+        happyOrg?: {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    content: {
+        type: "text";
+        text: string;
+    };
+    role: "user";
+    localKey?: string | undefined;
+    meta?: {
+        model?: string | null | undefined;
+        sentFrom?: string | undefined;
+        permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | "read-only" | "safe-yolo" | "yolo" | undefined;
+        fallbackModel?: string | null | undefined;
+        customSystemPrompt?: string | null | undefined;
+        appendSystemPrompt?: string | null | undefined;
+        allowedTools?: string[] | null | undefined;
+        disallowedTools?: string[] | null | undefined;
+        happyOrg?: {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    content: {
+        type: "text";
+        text: string;
+    };
+    role: "user";
+    localKey?: string | undefined;
+    meta?: {
+        model?: string | null | undefined;
+        sentFrom?: string | undefined;
+        permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | "read-only" | "safe-yolo" | "yolo" | undefined;
+        fallbackModel?: string | null | undefined;
+        customSystemPrompt?: string | null | undefined;
+        appendSystemPrompt?: string | null | undefined;
+        allowedTools?: string[] | null | undefined;
+        disallowedTools?: string[] | null | undefined;
+        happyOrg?: {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}>, z.ZodObject<{
+    role: z.ZodLiteral<"agent">;
+    content: z.ZodUnion<[z.ZodObject<{
+        type: z.ZodLiteral<"output">;
+        data: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        type: "output";
+        data?: unknown;
+    }, {
+        type: "output";
+        data?: unknown;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"codex">;
+        data: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        type: "codex";
+        data?: unknown;
+    }, {
+        type: "codex";
+        data?: unknown;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"acp">;
+        provider: z.ZodEnum<["gemini", "codex", "claude", "opencode"]>;
+        data: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        type: "acp";
+        provider: "codex" | "gemini" | "claude" | "opencode";
+        data?: unknown;
+    }, {
+        type: "acp";
+        provider: "codex" | "gemini" | "claude" | "opencode";
+        data?: unknown;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"event">;
+        id: z.ZodOptional<z.ZodString>;
+        data: z.ZodUnknown;
+    }, "strip", z.ZodTypeAny, {
+        type: "event";
+        id?: string | undefined;
+        data?: unknown;
+    }, {
+        type: "event";
+        id?: string | undefined;
+        data?: unknown;
+    }>]>;
+    meta: z.ZodOptional<z.ZodObject<{
+        sentFrom: z.ZodOptional<z.ZodString>;
+        permissionMode: z.ZodOptional<z.ZodEnum<["default", "acceptEdits", "bypassPermissions", "plan", "read-only", "safe-yolo", "yolo"]>>;
+        model: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        fallbackModel: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        customSystemPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        appendSystemPrompt: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+        allowedTools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+        disallowedTools: z.ZodOptional<z.ZodNullable<z.ZodArray<z.ZodString, "many">>>;
+        happyOrg: z.ZodOptional<z.ZodObject<{
+            taskContext: z.ZodOptional<z.ZodObject<{
+                taskId: z.ZodString;
+                organizationId: z.ZodString;
+                organizationRootPath: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                memberAgentId: z.ZodString;
+                supervisorAgentId: z.ZodString;
+                positionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                responsibilityId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            }, {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            }>>;
+            control: z.ZodOptional<z.ZodObject<{
+                action: z.ZodEnum<["terminate", "reopen"]>;
+                reason: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                newContext: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                newDecision: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                newResource: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            }, {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            }>>;
+            replyContext: z.ZodOptional<z.ZodObject<{
+                dispatchId: z.ZodString;
+                taskId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                organizationId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                scope: z.ZodString;
+                replyTo: z.ZodString;
+                memberAgentId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                sessionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                positionId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                responsibilityId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                routeType: z.ZodNullable<z.ZodOptional<z.ZodEnum<["direct_reply", "version_planning_reply", "analysis_task", "implementation_task", "ack_plus_reply"]>>>;
+                ackType: z.ZodNullable<z.ZodOptional<z.ZodEnum<["none", "read_ack", "dispatch_ack", "route_ack", "progress_ack"]>>>;
+                replyMode: z.ZodNullable<z.ZodOptional<z.ZodEnum<["reply-first", "analysis-first"]>>>;
+                planIntent: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                routerReason: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+                goldenRouteId: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            }, "strip", z.ZodTypeAny, {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            }, {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            }>>;
+        }, "strip", z.ZodTypeAny, {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        }, {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        model?: string | null | undefined;
+        sentFrom?: string | undefined;
+        permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | "read-only" | "safe-yolo" | "yolo" | undefined;
+        fallbackModel?: string | null | undefined;
+        customSystemPrompt?: string | null | undefined;
+        appendSystemPrompt?: string | null | undefined;
+        allowedTools?: string[] | null | undefined;
+        disallowedTools?: string[] | null | undefined;
+        happyOrg?: {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        } | undefined;
+    }, {
+        model?: string | null | undefined;
+        sentFrom?: string | undefined;
+        permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | "read-only" | "safe-yolo" | "yolo" | undefined;
+        fallbackModel?: string | null | undefined;
+        customSystemPrompt?: string | null | undefined;
+        appendSystemPrompt?: string | null | undefined;
+        allowedTools?: string[] | null | undefined;
+        disallowedTools?: string[] | null | undefined;
+        happyOrg?: {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        } | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    content: {
+        type: "output";
+        data?: unknown;
+    } | {
+        type: "codex";
+        data?: unknown;
+    } | {
+        type: "acp";
+        provider: "codex" | "gemini" | "claude" | "opencode";
+        data?: unknown;
+    } | {
+        type: "event";
+        id?: string | undefined;
+        data?: unknown;
+    };
+    role: "agent";
+    meta?: {
+        model?: string | null | undefined;
+        sentFrom?: string | undefined;
+        permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | "read-only" | "safe-yolo" | "yolo" | undefined;
+        fallbackModel?: string | null | undefined;
+        customSystemPrompt?: string | null | undefined;
+        appendSystemPrompt?: string | null | undefined;
+        allowedTools?: string[] | null | undefined;
+        disallowedTools?: string[] | null | undefined;
+        happyOrg?: {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}, {
+    content: {
+        type: "output";
+        data?: unknown;
+    } | {
+        type: "codex";
+        data?: unknown;
+    } | {
+        type: "acp";
+        provider: "codex" | "gemini" | "claude" | "opencode";
+        data?: unknown;
+    } | {
+        type: "event";
+        id?: string | undefined;
+        data?: unknown;
+    };
+    role: "agent";
+    meta?: {
+        model?: string | null | undefined;
+        sentFrom?: string | undefined;
+        permissionMode?: "default" | "acceptEdits" | "bypassPermissions" | "plan" | "read-only" | "safe-yolo" | "yolo" | undefined;
+        fallbackModel?: string | null | undefined;
+        customSystemPrompt?: string | null | undefined;
+        appendSystemPrompt?: string | null | undefined;
+        allowedTools?: string[] | null | undefined;
+        disallowedTools?: string[] | null | undefined;
+        happyOrg?: {
+            taskContext?: {
+                taskId: string;
+                organizationId: string;
+                memberAgentId: string;
+                supervisorAgentId: string;
+                organizationRootPath?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+            } | undefined;
+            control?: {
+                action: "terminate" | "reopen";
+                reason?: string | null | undefined;
+                newContext?: string | null | undefined;
+                newDecision?: string | null | undefined;
+                newResource?: string | null | undefined;
+            } | undefined;
+            replyContext?: {
+                dispatchId: string;
+                scope: string;
+                replyTo: string;
+                sessionId?: string | null | undefined;
+                taskId?: string | null | undefined;
+                organizationId?: string | null | undefined;
+                memberAgentId?: string | null | undefined;
+                positionId?: string | null | undefined;
+                responsibilityId?: string | null | undefined;
+                routeType?: "direct_reply" | "version_planning_reply" | "analysis_task" | "implementation_task" | "ack_plus_reply" | null | undefined;
+                ackType?: "none" | "read_ack" | "dispatch_ack" | "route_ack" | "progress_ack" | null | undefined;
+                replyMode?: "reply-first" | "analysis-first" | null | undefined;
+                planIntent?: string | null | undefined;
+                routerReason?: string | null | undefined;
+                goldenRouteId?: string | null | undefined;
+            } | undefined;
+        } | undefined;
+    } | undefined;
+}>]>;
+type MessageContent = z.infer<typeof MessageContentSchema>;
+type Metadata = {
+    path: string;
+    host: string;
+    version?: string;
+    name?: string;
+    os?: string;
+    summary?: {
+        text: string;
+        updatedAt: number;
+    };
+    machineId?: string;
+    claudeSessionId?: string;
+    claudeTranscriptPath?: string;
+    codexSessionId?: string;
+    tools?: string[];
+    slashCommands?: string[];
+    homeDir: string;
+    happyHomeDir: string;
+    happyLibDir: string;
+    happyToolsDir: string;
+    startedFromDaemon?: boolean;
+    hostPid?: number;
+    startedBy?: 'daemon' | 'terminal';
+    managedSessionTag?: string;
+    lifecycleState?: 'running' | 'archiveRequested' | 'archived' | string;
+    lifecycleStateSince?: number;
+    archivedBy?: string;
+    archiveReason?: string;
+    flavor?: string;
+    machineOnline?: boolean;
+    machineOnlineAt?: number;
+    happyOrg?: HappyOrgMetadata;
+};
+type AgentState = {
+    controlledByUser?: boolean | null | undefined;
+    requests?: {
+        [id: string]: {
+            tool: string;
+            arguments: any;
+            createdAt: number;
+            requestKind?: 'permission' | 'selection';
+            options?: Array<{
+                optionId: string;
+                label: string;
+                description?: string;
+            }>;
+            defaultOptionId?: string;
+        };
+    };
+    completedRequests?: {
+        [id: string]: {
+            tool: string;
+            arguments: any;
+            createdAt: number;
+            completedAt: number;
+            status: 'canceled' | 'denied' | 'approved';
+            reason?: string;
+            mode?: PermissionMode;
+            decision?: 'approved' | 'approved_for_session' | 'denied' | 'abort';
+            allowTools?: string[];
+            requestKind?: 'permission' | 'selection';
+            selectedOptionId?: string;
+        };
+    };
+};
+
+/**
+ * Common RPC types and interfaces for both session and machine clients
+ */
+/**
+ * Generic RPC handler function type
+ * @template TRequest - The request data type
+ * @template TResponse - The response data type
+ */
+type RpcHandler<TRequest = any, TResponse = any> = (data: TRequest) => TResponse | Promise<TResponse>;
+/**
+ * RPC request data from server
+ */
+interface RpcRequest {
+    method: string;
+    params: string;
+}
+/**
+ * Configuration for RPC handler manager
+ */
+interface RpcHandlerConfig {
+    scopePrefix: string;
+    encryptionKey: Uint8Array;
+    encryptionVariant: 'legacy' | 'dataKey';
+    logger?: (message: string, data?: any) => void;
+}
+
+/**
+ * Generic RPC handler manager for session and machine clients
+ * Manages RPC method registration, encryption/decryption, and handler execution
+ */
+
+declare class RpcHandlerManager {
+    private handlers;
+    private readonly scopePrefix;
+    private readonly encryptionKey;
+    private readonly encryptionVariant;
+    private readonly logger;
+    private socket;
+    constructor(config: RpcHandlerConfig);
+    /**
+     * Register an RPC handler for a specific method
+     * @param method - The method name (without prefix)
+     * @param handler - The handler function
+     */
+    registerHandler<TRequest = any, TResponse = any>(method: string, handler: RpcHandler<TRequest, TResponse>): void;
+    /**
+     * Handle an incoming RPC request
+     * @param request - The RPC request data
+     * @param callback - The response callback
+     */
+    handleRequest(request: RpcRequest): Promise<any>;
+    onSocketConnect(socket: Socket): void;
+    onSocketDisconnect(): void;
+    /**
+     * Get the number of registered handlers
+     */
+    getHandlerCount(): number;
+    /**
+     * Check if a handler is registered
+     * @param method - The method name (without prefix)
+     */
+    hasHandler(method: string): boolean;
+    /**
+     * Clear all handlers
+     */
+    clearHandlers(): void;
+    /**
+     * Get the prefixed method name
+     * @param method - The method name
+     */
+    private getPrefixedMethod;
+}
+
+/**
+ * Minimal persistence functions for happy CLI
+ *
+ * Handles settings and private key storage in ~/.happy/ or local .happy/
+ */
+
+type SigningCredentials = {
+    version: 1;
+    keyId: string;
+    seed: string;
+    algorithm: 'HMAC-SHA256';
+};
+type Credentials = {
+    token: string;
+    signing?: SigningCredentials | null;
+    aesKey?: string;
+    encryption: {
+        type: 'legacy';
+        secret: Uint8Array;
+    } | {
+        type: 'dataKey';
+        publicKey: Uint8Array;
+        machineKey: Uint8Array;
+    };
+};
+
+type MessageStreamPhase = 'start' | 'delta' | 'commit' | 'abort';
+type MessageStreamMode = 'append' | 'replace';
+type MessageStreamMetadata = {
+    streamId: string;
+    messageId: string;
+    phase: MessageStreamPhase;
+    mode: MessageStreamMode;
+};
+
+/**
+ * ACP (Agent Communication Protocol) message data types.
+ * This is the unified format for all agent messages - CLI adapts each provider's format to ACP.
+ */
+type ACPMessageData = ({
     type: 'message';
     message: string;
 } & Partial<MessageStreamMetadata> & {
@@ -3030,6 +3840,13 @@ type ACPMessageData = ({
     type: 'token_count';
     [key: string]: unknown;
 };
+type SessionTranscriptSource = 'snapshot' | 'live';
+interface SessionTranscriptMessage {
+    source: SessionTranscriptSource;
+    seq: number | null;
+    message: MessageContent;
+    queuesPendingInput: boolean;
+}
 interface ProtocolV3SessionSyncOptions {
     getSessionSnapshot: (sessionId: string, limit?: number) => Promise<ProtocolV3SessionSnapshotResponse | null>;
     getSessionChanges: (sessionId: string, afterSeq: number, limit?: number) => Promise<ProtocolV3SessionChangesResponse | null>;
@@ -3044,8 +3861,11 @@ declare class ApiSessionClient extends EventEmitter {
     private agentState;
     private agentStateVersion;
     private socket;
+    private readonly initialSessionSeq;
     private pendingMessages;
     private pendingMessageCallback;
+    private pendingSessionMessages;
+    private pendingSessionMessageCallback;
     readonly rpcHandlerManager: RpcHandlerManager;
     private agentStateLock;
     private metadataLock;
@@ -3077,12 +3897,14 @@ declare class ApiSessionClient extends EventEmitter {
     private happyOrgSignedCredentialsPromise;
     constructor(credentials: Credentials, session: Session);
     onUserMessage(callback: (data: UserMessage) => void): void;
+    onSessionMessage(callback: (data: SessionTranscriptMessage) => void): void;
     configureProtocolV3Sync(options: ProtocolV3SessionSyncOptions | null): void;
     getProtocolV3DescriptorSnapshot(): ProtocolV3Descriptor | null;
     getProtocolV3SocketCapabilitiesSnapshot(): ProtocolV3SocketCapabilities | null;
     getMetadataSnapshot(): Metadata | null;
     getAgentStateSnapshot(): AgentState | null;
     private mergeRuntimeMetadata;
+    private didSessionValueChange;
     waitForMetadataUpdate(signal?: AbortSignal): Promise<Metadata | null>;
     /**
      * Send message to session
@@ -3146,6 +3968,7 @@ declare class ApiSessionClient extends EventEmitter {
      * The plaintext JSON is parsed and validated as a UserMessage.
      */
     private dispatchPlaintextSessionMessage;
+    private dispatchSessionTranscriptMessage;
     private maybeAutoAcknowledgeHappyOrgDispatch;
     private resolveHappyOrgDispatchBusinessAckCandidate;
     private hasRecordedHappyOrgDispatchAck;
@@ -3203,6 +4026,10 @@ interface SpawnSessionOptions {
         TMUX_SESSION_NAME?: string;
         TMUX_TMPDIR?: string;
     };
+    resume?: SpawnSessionResumeOptions;
+}
+interface SpawnSessionResumeOptions {
+    providerSessionId: string;
 }
 type SpawnSessionResult = {
     type: 'success';