@fungi.computer/truffle 0.1.1 → 0.2.0

package/dist/private-local-service-owner.d.ts

@@ -1,1567 +1,135 @@
+import type { Accepted, CancelResult } from "@fungi.computer/shiitake";
+import { type PrivateLocalConfigRoot } from "./private-local-config-root.js";
+import type { ServiceLogLifecycle } from "./private-local-service-log.js";
+import type { StopAllResult } from "./private-local-stop-all.js";
+import { type LocalExtensions } from "./local-extensions.js";
 import type { PrivateLocalServiceSelection, PrivateLocalSessionCreation } from "./private-local-service-contract.js";
 import { openPrivateLocalRuntimeHost, type PrivateLocalRuntimeHost } from "./private-local-runtime-host.js";
-export type LocalServiceRuntime = Pick<PrivateLocalRuntimeHost, "databasePath" | "agentId" | "getSession" | "effectiveModel" | "setModel" | "assertModelReady" | "listSessions" | "createSession" | "deleteSession" | "extensions" | "bindSessionPath" | "acceptMail" | "readSettlement" | "close">;
+import type { LocalUiAttachment } from "./private-local-ui-attachment.js";
+export type LocalServiceRuntime = Pick<PrivateLocalRuntimeHost, "databasePath" | "agentId" | "name" | "getSession" | "effectiveModel" | "setModel" | "setArchived" | "setRequireSandbox" | "sandboxStatus" | "pendingDelegation" | "assertModelReady" | "listSessions" | "createSession" | "deleteSession" | "extensions" | "prepareReload" | "bindSessionPath" | "acceptMail" | "readSettlement" | "idle" | "close">;
 export declare class LocalSessionPathConflict extends Error {
     readonly name = "LocalSessionPathConflict";
     constructor();
 }
-export type OpenLocalServiceRuntime = (options: Parameters<typeof openPrivateLocalRuntimeHost>[0]) => Promise<LocalServiceRuntime>;
+/**
+ * A folder holds several Agent stores and the request chose none of them.
+ * The service never picks one for the caller; --agent, --db or the
+ * landing screen does.
+ */
+export declare class LocalAgentSelectionAmbiguous extends Error {
+    readonly name = "LocalAgentSelectionAmbiguous";
+    readonly agentIds: readonly string[];
+    constructor(agentIds: readonly string[]);
+}
+export type OpenLocalServiceRuntime = (
+/** Selected by the service, never by a client selection or Agent Files root. */
+options: Parameters<typeof openPrivateLocalRuntimeHost>[0] & Readonly<{
+    configRoot: PrivateLocalConfigRoot;
+}>) => Promise<LocalServiceRuntime>;
 /** One service owns each store, independently of how many clients select it. */
-export declare function createLocalServiceOwners(openRuntime?: OpenLocalServiceRuntime, recoveryDirectory?: string): {
+export declare function createLocalServiceOwners(openRuntime?: OpenLocalServiceRuntime, recoveryDirectory?: string, 
+/** The installed-extension owner that decides what each Agent holds. */
+suppliedExtensions?: Pick<LocalExtensions, "assertHeldByAgent" | "enableAgent">, 
+/** How often idle Agents are checked; one is released on its second idle check. */
+idleSweepMs?: number, 
+/** Read the recovery manifest; tests can hold this I/O independently of opens. */
+readRecoveryManifest?: (path: string) => Promise<string>, 
+/** Report only the classification, never the manifest or exception text. */
+onRecoveryDisabled?: ServiceLogLifecycle["recoveryDisabled"], configRoot?: PrivateLocalConfigRoot): {
+    refreshMesh: () => Promise<void>;
     createSession: (creation: PrivateLocalSessionCreation) => Promise<{
         agentId: string;
         databasePath: string;
+        invocationRoot: string;
         sessionId: string;
         session: Readonly<{
             address: string;
             command: import("@fungi.computer/shiitake").SessionCommandHandler;
+            withdraw: (requestId: string) => Promise<import("@fungi.computer/shiitake/client").WithdrawResult>;
             abort: () => Promise<void>;
-            send: (text: string, options?: import("@fungi.computer/shiitake").SendOptions) => Promise<import("@fungi.computer/shiitake").Accepted>;
+            send: (text: string, options?: import("@fungi.computer/shiitake").SendOptions) => Promise<Accepted>;
             cancel: (input: Readonly<{
                 commandId: string;
                 onlyIfPending?: boolean;
-            }>) => Promise<import("@fungi.computer/shiitake").CancelResult>;
+            }>) => Promise<CancelResult>;
+            latestPending: () => Promise<import("@fungi.computer/shiitake/client").SessionPendingPrompt | null>;
             extension: (extensionId: string) => import("@fungi.computer/shiitake").SessionExtensionControls;
             modelPreference: Readonly<{
-                read: () => Promise<import("@fungi.computer/shiitake/model-preference").ModelPreference | null>;
-                set: (preference: import("@fungi.computer/shiitake/model-preference").ModelPreference | null) => Promise<void>;
+                read: () => Promise<import("@fungi.computer/shiitake").ModelPreference | null>;
+                set: (preference: import("@fungi.computer/shiitake").ModelPreference | null) => Promise<void>;
             }>;
             read: (input?: import("@fungi.computer/shiitake").ReadOptions) => Promise<import("@fungi.computer/shiitake").SessionSnapshot>;
             subscribe: (input: import("@fungi.computer/shiitake").SubscribeOptions) => AsyncIterable<import("@fungi.computer/shiitake").SessionFrame>;
             watch: (input?: import("@fungi.computer/shiitake").WatchOptions) => Promise<import("@fungi.computer/shiitake").SessionWatch>;
         }>;
-        effectiveModel: (sessionId: string, signal: AbortSignal) => Promise<import("./private-local-effective-model.js").PrivateLocalEffectiveModel>;
-        routes: import("hono/hono-base").HonoBase<import("@fungi.computer/shiitake/http").ShiitakeHttpEnv, {
-            "/extensions": {
-                $get: {
-                    input: {};
-                    output: readonly {
-                        readonly id: string;
-                        readonly version: string;
-                        readonly revision: string;
-                        readonly status: "running" | "stopped";
-                        readonly reason: string | null;
-                        readonly stoppedAt: number | null;
-                    }[];
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/extensions/:extensionId/resume": {
-                $post: {
-                    input: {
-                        param: {
-                            extensionId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {
-                        param: {
-                            extensionId: string;
-                        };
-                    };
-                    output: {
-                        readonly id: string;
-                        readonly version: string;
-                        readonly revision: string;
-                        readonly status: "running" | "stopped";
-                        readonly reason: string | null;
-                        readonly stoppedAt: number | null;
-                    };
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/extensions/:extensionId/commands/:command": {
-                $post: {
-                    input: {
-                        param: {
-                            extensionId: string;
-                        } & {
-                            command: string;
-                        };
-                    };
-                    output: {};
-                    outputFormat: string;
-                    status: import("hono/utils/http-status").StatusCode;
-                };
-            };
-        } & {
-            "/sessions/:sessionId/extensions/:extensionId/commands/:command": {
-                $post: {
-                    input: {
-                        param: {
-                            extensionId: string;
-                        } & {
-                            command: string;
-                        } & {
-                            sessionId: string;
-                        };
-                    };
-                    output: {};
-                    outputFormat: string;
-                    status: import("hono/utils/http-status").StatusCode;
-                };
-            };
-        } & {
-            "/sessions": {
-                $post: {
-                    input: {
-                        json: {
-                            readonly requestId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {
-                        json: {
-                            readonly requestId: string;
-                        };
-                    };
-                    output: {
-                        sessionId: string;
-                    };
-                    outputFormat: "json";
-                    status: 201;
-                };
-            };
-        } & {
-            "/sessions/:sessionId": {
-                $delete: {
-                    input: {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        deleted: boolean;
-                    };
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/sessions": {
-                $get: {
-                    input: {};
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {};
-                    output: {
-                        readonly sessions: readonly ({
-                            readonly sessionId: string;
-                            readonly state: "unavailable";
-                        } | {
-                            readonly createdAt: number;
-                            readonly lastActivityAt: number;
-                            readonly settledAt?: number | undefined;
-                            readonly title: string;
-                            readonly state: import("@fungi.computer/shiitake").SessionInboxState;
-                            readonly sessionId: string;
-                        })[];
-                        readonly next: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/sessions/:sessionId/model-preference": {
-                $get: {
-                    input: {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly providerId: string;
-                        readonly modelId: string;
-                        readonly reasoning?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-                    } | null;
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/sessions/:sessionId/model-preference": {
-                $put: {
-                    input: {
-                        json: {
-                            readonly providerId: string;
-                            readonly modelId: string;
-                            readonly reasoning?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-                        } | null;
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {
-                        json: {
-                            readonly providerId: string;
-                            readonly modelId: string;
-                            readonly reasoning?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-                        } | null;
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: null;
-                    outputFormat: "body";
-                    status: 204;
-                };
-            };
-        } & {
-            "/sessions/:sessionId/command": {
-                $post: {
-                    input: {
-                        json: {
-                            readonly command: {
-                                readonly requestId: string;
-                                readonly type: "prompt";
-                                readonly text: string;
-                                readonly delivery: "followUp" | "steer";
-                                readonly images?: readonly {
-                                    readonly type: "image";
-                                    readonly data: string;
-                                    readonly mimeType: string;
-                                }[];
-                            } | {
-                                readonly type: "abort";
-                            } | {
-                                readonly type: "cancel";
-                                readonly commandId: string;
-                                readonly onlyIfPending?: boolean | undefined;
-                            } | {
-                                readonly type: "branch";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "fork";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "operator";
-                                readonly requestId: string;
-                                readonly author: "operator" | "party";
-                                readonly text: string;
-                            } | {
-                                readonly requestId: string;
-                                readonly type: "compact";
-                                readonly instructions?: string;
-                            } | {
-                                readonly type: "title";
-                                readonly title: string | null;
-                            };
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {
-                        json: {
-                            readonly command: {
-                                readonly requestId: string;
-                                readonly type: "prompt";
-                                readonly text: string;
-                                readonly delivery: "followUp" | "steer";
-                                readonly images?: readonly {
-                                    readonly type: "image";
-                                    readonly data: string;
-                                    readonly mimeType: string;
-                                }[];
-                            } | {
-                                readonly type: "abort";
-                            } | {
-                                readonly type: "cancel";
-                                readonly commandId: string;
-                                readonly onlyIfPending?: boolean | undefined;
-                            } | {
-                                readonly type: "branch";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "fork";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "operator";
-                                readonly requestId: string;
-                                readonly author: "operator" | "party";
-                                readonly text: string;
-                            } | {
-                                readonly requestId: string;
-                                readonly type: "compact";
-                                readonly instructions?: string;
-                            } | {
-                                readonly type: "title";
-                                readonly title: string | null;
-                            };
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: null;
-                    outputFormat: "body";
-                    status: 204;
-                } | {
-                    input: {
-                        json: {
-                            readonly command: {
-                                readonly requestId: string;
-                                readonly type: "prompt";
-                                readonly text: string;
-                                readonly delivery: "followUp" | "steer";
-                                readonly images?: readonly {
-                                    readonly type: "image";
-                                    readonly data: string;
-                                    readonly mimeType: string;
-                                }[];
-                            } | {
-                                readonly type: "abort";
-                            } | {
-                                readonly type: "cancel";
-                                readonly commandId: string;
-                                readonly onlyIfPending?: boolean | undefined;
-                            } | {
-                                readonly type: "branch";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "fork";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "operator";
-                                readonly requestId: string;
-                                readonly author: "operator" | "party";
-                                readonly text: string;
-                            } | {
-                                readonly requestId: string;
-                                readonly type: "compact";
-                                readonly instructions?: string;
-                            } | {
-                                readonly type: "title";
-                                readonly title: string | null;
-                            };
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly status: "accepted";
-                        readonly commandId: string;
-                    } | {
-                        readonly status: "too_late";
-                        readonly commandId: string;
-                    } | {
-                        readonly sessionId: string;
-                    };
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/sessions/:sessionId": {
-                $get: {
-                    input: {
-                        query: {
-                            readonly includeSandboxFailures?: "true" | undefined;
-                            readonly limit?: number | undefined;
-                            readonly before?: string | undefined;
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {
-                        query: {
-                            readonly includeSandboxFailures?: "true" | undefined;
-                            readonly limit?: number | undefined;
-                            readonly before?: string | undefined;
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly sessionId: string;
-                        readonly cursor: string | null;
-                        readonly hasMore: boolean;
-                        readonly oldestCursor?: string | null | undefined;
-                        readonly messages: readonly {
-                            readonly meta?: any;
-                            readonly origin?: {
-                                readonly extensionId: string;
-                                readonly correlation: string | null;
-                            } | undefined;
-                            readonly id: string;
-                            readonly sequence: number;
-                            readonly commandId: string | null;
-                            readonly value: {
-                                role: "system";
-                                content: string | {
-                                    type: "text";
-                                    text: string;
-                                    textSignature?: string | undefined;
-                                }[];
-                                sections?: {
-                                    [x: string]: string | null;
-                                } | undefined;
-                                toolsAdded?: {
-                                    name: string;
-                                    description: string;
-                                    parameters: never;
-                                    constrainedSampling?: false | {
-                                        type: "json_schema";
-                                        strict: "prefer" | "require";
-                                    } | {
-                                        type: "grammar";
-                                        variants: {
-                                            openai_lark?: string | undefined;
-                                            openai_regex?: string | undefined;
-                                        };
-                                    } | undefined;
-                                }[] | undefined;
-                                toolsRemoved?: {
-                                    name: string;
-                                }[] | undefined;
-                                timestamp: number;
-                            } | {
-                                role: "user";
-                                content: string | ({
-                                    type: "text";
-                                    text: string;
-                                    textSignature?: string | undefined;
-                                } | {
-                                    type: "image";
-                                    data: string;
-                                    mimeType: string;
-                                })[];
-                                timestamp: number;
-                            } | {
-                                role: "assistant";
-                                content: ({
-                                    type: "text";
-                                    text: string;
-                                    textSignature?: string | undefined;
-                                } | {
-                                    type: "toolCall";
-                                    id: string;
-                                    name: string;
-                                    arguments: {
-                                        [x: string]: any;
-                                    };
-                                    thoughtSignature?: string | undefined;
-                                    namespace?: string | undefined;
-                                } | {
-                                    type: "thinking";
-                                    thinking: string;
-                                    thinkingSignature?: string | undefined;
-                                    redacted?: boolean | undefined;
-                                })[];
-                                api: import("@earendil-works/pi-ai").Api;
-                                provider: import("@earendil-works/pi-ai").ProviderId;
-                                model: string;
-                                responseModel?: string | undefined;
-                                responseId?: string | undefined;
-                                providerThinkingLevel?: string | undefined;
-                                thinkingLevel?: import("@earendil-works/pi-ai").ModelThinkingLevel | undefined;
-                                diagnostics?: {
-                                    type: string;
-                                    timestamp: number;
-                                    error?: {
-                                        name?: string | undefined;
-                                        message: string;
-                                        stack?: string | undefined;
-                                        code?: string | number | undefined;
-                                    } | undefined;
-                                    details?: {
-                                        [x: string]: any;
-                                    } | undefined;
-                                }[] | undefined;
-                                usage: {
-                                    input: number;
-                                    output: number;
-                                    cacheRead: number;
-                                    cacheWrite: number;
-                                    cacheWrite1h?: number | undefined;
-                                    reasoning?: number | undefined;
-                                    totalTokens: number;
-                                    cost: {
-                                        input: number;
-                                        output: number;
-                                        cacheRead: number;
-                                        cacheWrite: number;
-                                        total: number;
-                                    };
-                                };
-                                stopReason: import("@earendil-works/pi-ai").StopReason;
-                                deferred?: {
-                                    provider: string;
-                                    modelId: string;
-                                    api: string;
-                                    id: string;
-                                    expiresAt?: number | undefined;
-                                    pollAfterMs?: number | undefined;
-                                    data?: any;
-                                } | undefined;
-                                errorMessage?: string | undefined;
-                                rawStopReason?: string | undefined;
-                                endTurn?: boolean | undefined;
-                                timestamp: number;
-                            } | {
-                                role: "toolResult";
-                                toolCallId: string;
-                                toolName: string;
-                                content: ({
-                                    type: "text";
-                                    text: string;
-                                    textSignature?: string | undefined;
-                                } | {
-                                    type: "image";
-                                    data: string;
-                                    mimeType: string;
-                                })[];
-                                details?: any;
-                                usage?: {
-                                    input: number;
-                                    output: number;
-                                    cacheRead: number;
-                                    cacheWrite: number;
-                                    cacheWrite1h?: number | undefined;
-                                    reasoning?: number | undefined;
-                                    totalTokens: number;
-                                    cost: {
-                                        input: number;
-                                        output: number;
-                                        cacheRead: number;
-                                        cacheWrite: number;
-                                        total: number;
-                                    };
-                                } | undefined;
-                                nestedCalls?: {
-                                    calls: {
-                                        id: string;
-                                        name: string;
-                                        arguments?: {
-                                            [x: string]: any;
-                                        } | undefined;
-                                        argumentsBytes?: number | undefined;
-                                        status: "ok" | "error" | "unfinished";
-                                        durationMs?: number | undefined;
-                                        error?: string | undefined;
-                                    }[];
-                                    complete: boolean;
-                                } | undefined;
-                                isError: boolean;
-                                timestamp: number;
-                            };
-                        }[];
-                        readonly terminals: readonly {
-                            readonly commandId: string;
-                            readonly outcome: "completed" | "cancelled" | "failed" | "interrupted";
-                            readonly sequence: number;
-                            readonly diagnostic: string | null;
-                            readonly meta?: any;
-                        }[];
-                        readonly compactions?: readonly {
-                            readonly id: string;
-                            readonly sequence: number;
-                            readonly at: number;
-                            readonly tokensBefore: number;
-                            readonly tokensAfter: number | null;
-                            readonly trigger: import("@fungi.computer/shiitake").SessionCompactionTrigger | null;
-                        }[] | undefined;
-                        readonly compactionNotices?: readonly {
-                            readonly id: string;
-                            readonly sequence: number;
-                            readonly at: number;
-                            readonly trigger: import("@fungi.computer/shiitake").SessionCompactionTrigger;
-                            readonly result: "nothing_to_compact" | "failed";
-                            readonly diagnostic: string | null;
-                        }[] | undefined;
-                        readonly sandboxFailures?: readonly {
-                            readonly kind: "sandbox_failure";
-                            readonly ref: string;
-                            readonly executionId: string;
-                            readonly adapter: string;
-                            readonly buildSha: string | null;
-                            readonly tag: "Unknown" | "SourceInvalid" | "GuestThrew" | "DeadlineExceeded" | "Cancelled" | "DispatchLost" | "SandboxCrashed" | "BadResponse" | "ResultTooLarge" | "ResultNotJson" | "CapabilityFailed";
-                            readonly fields: {
-                                readonly [x: string]: any;
-                            };
-                            readonly healthAlert: boolean;
-                        }[] | undefined;
-                        readonly pending: {
-                            readonly total: number;
-                            readonly prompts: readonly {
-                                readonly meta?: any;
-                                readonly origin?: {
-                                    readonly extensionId: string;
-                                    readonly correlation: string | null;
-                                } | undefined;
-                                readonly commandId: string;
-                                readonly text: string;
-                                readonly images?: readonly {
-                                    readonly type: "image";
-                                    readonly data: string;
-                                    readonly mimeType: string;
-                                }[] | undefined;
-                                readonly delivery: import("@fungi.computer/shiitake").PromptDelivery;
-                            }[];
-                            readonly hasMore: boolean;
-                        };
-                        readonly activity: {
-                            readonly queue: {
-                                readonly state: "idle";
-                            } | {
-                                readonly state: "queued";
-                                readonly commandId: string;
-                                readonly runningWork: {
-                                    readonly kind: "session";
-                                    readonly sessionId: string;
-                                    readonly commandId: string;
-                                } | {
-                                    readonly kind: "host";
-                                    readonly lane: string;
-                                    readonly jobId: string;
-                                } | null;
-                            } | {
-                                readonly state: "running";
-                                readonly commandId: string;
-                            };
-                            readonly cancellationRequested: boolean;
-                            readonly retry: {
-                                readonly attempt: number;
-                                readonly maxAttempts: number;
-                                readonly delayMs: number;
-                                readonly errorMessage: string;
-                                readonly scheduledAt: number;
-                            } | null;
-                            readonly activeTool: string | null;
-                            readonly lastModelChoiceSequence: number | null;
-                            readonly compaction: {
-                                readonly trigger: import("@fungi.computer/shiitake").SessionCompactionTrigger;
-                            } | null;
-                        };
-                        readonly progress: {
-                            readonly messageId: string;
-                            readonly revision: number;
-                            readonly text: string;
-                            readonly thinking: string;
-                            readonly textTruncated: boolean;
-                            readonly thinkingTruncated: boolean;
-                        } | null;
-                        readonly extensions: {
-                            readonly [x: string]: {
-                                readonly status: "running";
-                                readonly revision: string;
-                                readonly value: any;
-                                readonly catalog?: any;
-                            } | {
-                                readonly status: "stopped";
-                                readonly revision: string;
-                                readonly reason: string;
-                            };
-                        };
-                        readonly attention: readonly {
-                            readonly id: string;
-                            readonly kind: string;
-                            readonly summary: string;
-                            readonly since: number;
-                            readonly extensionId: string;
-                            readonly expiresAt?: number | undefined;
-                        }[];
-                        readonly context?: {
-                            readonly tokens: number;
-                            readonly window: number | null;
-                        } | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/sessions/:sessionId/events": {
-                $get: {
-                    input: {
-                        query: {
-                            readonly includeSandboxFailures?: "true" | undefined;
-                            readonly limit?: number | undefined;
-                            readonly after?: string | undefined;
-                            readonly mode?: "subscribe" | undefined;
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {};
-                    outputFormat: string;
-                    status: import("hono/utils/http-status").StatusCode;
-                } | {
-                    input: {
-                        query: {
-                            readonly includeSandboxFailures?: "true" | undefined;
-                            readonly limit?: number | undefined;
-                            readonly after?: string | undefined;
-                            readonly mode?: "subscribe" | undefined;
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                };
-            };
-        }, "/", "/sessions/:sessionId/events">;
+        /** End this selection's use; the mounted route reopens the Agent later. */
+        release: () => void;
     }>;
     select: (selection: PrivateLocalServiceSelection, createRequestId?: string) => Promise<{
         agentId: string;
         databasePath: string;
+        invocationRoot: string;
         sessionId: string;
         session: Readonly<{
             address: string;
             command: import("@fungi.computer/shiitake").SessionCommandHandler;
+            withdraw: (requestId: string) => Promise<import("@fungi.computer/shiitake/client").WithdrawResult>;
             abort: () => Promise<void>;
-            send: (text: string, options?: import("@fungi.computer/shiitake").SendOptions) => Promise<import("@fungi.computer/shiitake").Accepted>;
+            send: (text: string, options?: import("@fungi.computer/shiitake").SendOptions) => Promise<Accepted>;
             cancel: (input: Readonly<{
                 commandId: string;
                 onlyIfPending?: boolean;
-            }>) => Promise<import("@fungi.computer/shiitake").CancelResult>;
+            }>) => Promise<CancelResult>;
+            latestPending: () => Promise<import("@fungi.computer/shiitake/client").SessionPendingPrompt | null>;
             extension: (extensionId: string) => import("@fungi.computer/shiitake").SessionExtensionControls;
             modelPreference: Readonly<{
-                read: () => Promise<import("@fungi.computer/shiitake/model-preference").ModelPreference | null>;
-                set: (preference: import("@fungi.computer/shiitake/model-preference").ModelPreference | null) => Promise<void>;
+                read: () => Promise<import("@fungi.computer/shiitake").ModelPreference | null>;
+                set: (preference: import("@fungi.computer/shiitake").ModelPreference | null) => Promise<void>;
             }>;
             read: (input?: import("@fungi.computer/shiitake").ReadOptions) => Promise<import("@fungi.computer/shiitake").SessionSnapshot>;
             subscribe: (input: import("@fungi.computer/shiitake").SubscribeOptions) => AsyncIterable<import("@fungi.computer/shiitake").SessionFrame>;
             watch: (input?: import("@fungi.computer/shiitake").WatchOptions) => Promise<import("@fungi.computer/shiitake").SessionWatch>;
         }>;
-        effectiveModel: (sessionId: string, signal: AbortSignal) => Promise<import("./private-local-effective-model.js").PrivateLocalEffectiveModel>;
-        routes: import("hono/hono-base").HonoBase<import("@fungi.computer/shiitake/http").ShiitakeHttpEnv, {
-            "/extensions": {
-                $get: {
-                    input: {};
-                    output: readonly {
-                        readonly id: string;
-                        readonly version: string;
-                        readonly revision: string;
-                        readonly status: "running" | "stopped";
-                        readonly reason: string | null;
-                        readonly stoppedAt: number | null;
-                    }[];
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/extensions/:extensionId/resume": {
-                $post: {
-                    input: {
-                        param: {
-                            extensionId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {
-                        param: {
-                            extensionId: string;
-                        };
-                    };
-                    output: {
-                        readonly id: string;
-                        readonly version: string;
-                        readonly revision: string;
-                        readonly status: "running" | "stopped";
-                        readonly reason: string | null;
-                        readonly stoppedAt: number | null;
-                    };
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/extensions/:extensionId/commands/:command": {
-                $post: {
-                    input: {
-                        param: {
-                            extensionId: string;
-                        } & {
-                            command: string;
-                        };
-                    };
-                    output: {};
-                    outputFormat: string;
-                    status: import("hono/utils/http-status").StatusCode;
-                };
-            };
-        } & {
-            "/sessions/:sessionId/extensions/:extensionId/commands/:command": {
-                $post: {
-                    input: {
-                        param: {
-                            extensionId: string;
-                        } & {
-                            command: string;
-                        } & {
-                            sessionId: string;
-                        };
-                    };
-                    output: {};
-                    outputFormat: string;
-                    status: import("hono/utils/http-status").StatusCode;
-                };
-            };
-        } & {
-            "/sessions": {
-                $post: {
-                    input: {
-                        json: {
-                            readonly requestId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {
-                        json: {
-                            readonly requestId: string;
-                        };
-                    };
-                    output: {
-                        sessionId: string;
-                    };
-                    outputFormat: "json";
-                    status: 201;
-                };
-            };
-        } & {
-            "/sessions/:sessionId": {
-                $delete: {
-                    input: {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        deleted: boolean;
-                    };
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/sessions": {
-                $get: {
-                    input: {};
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {};
-                    output: {
-                        readonly sessions: readonly ({
-                            readonly sessionId: string;
-                            readonly state: "unavailable";
-                        } | {
-                            readonly createdAt: number;
-                            readonly lastActivityAt: number;
-                            readonly settledAt?: number | undefined;
-                            readonly title: string;
-                            readonly state: import("@fungi.computer/shiitake").SessionInboxState;
-                            readonly sessionId: string;
-                        })[];
-                        readonly next: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/sessions/:sessionId/model-preference": {
-                $get: {
-                    input: {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly providerId: string;
-                        readonly modelId: string;
-                        readonly reasoning?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-                    } | null;
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/sessions/:sessionId/model-preference": {
-                $put: {
-                    input: {
-                        json: {
-                            readonly providerId: string;
-                            readonly modelId: string;
-                            readonly reasoning?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-                        } | null;
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {
-                        json: {
-                            readonly providerId: string;
-                            readonly modelId: string;
-                            readonly reasoning?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
-                        } | null;
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: null;
-                    outputFormat: "body";
-                    status: 204;
-                };
-            };
-        } & {
-            "/sessions/:sessionId/command": {
-                $post: {
-                    input: {
-                        json: {
-                            readonly command: {
-                                readonly requestId: string;
-                                readonly type: "prompt";
-                                readonly text: string;
-                                readonly delivery: "followUp" | "steer";
-                                readonly images?: readonly {
-                                    readonly type: "image";
-                                    readonly data: string;
-                                    readonly mimeType: string;
-                                }[];
-                            } | {
-                                readonly type: "abort";
-                            } | {
-                                readonly type: "cancel";
-                                readonly commandId: string;
-                                readonly onlyIfPending?: boolean | undefined;
-                            } | {
-                                readonly type: "branch";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "fork";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "operator";
-                                readonly requestId: string;
-                                readonly author: "operator" | "party";
-                                readonly text: string;
-                            } | {
-                                readonly requestId: string;
-                                readonly type: "compact";
-                                readonly instructions?: string;
-                            } | {
-                                readonly type: "title";
-                                readonly title: string | null;
-                            };
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {
-                        json: {
-                            readonly command: {
-                                readonly requestId: string;
-                                readonly type: "prompt";
-                                readonly text: string;
-                                readonly delivery: "followUp" | "steer";
-                                readonly images?: readonly {
-                                    readonly type: "image";
-                                    readonly data: string;
-                                    readonly mimeType: string;
-                                }[];
-                            } | {
-                                readonly type: "abort";
-                            } | {
-                                readonly type: "cancel";
-                                readonly commandId: string;
-                                readonly onlyIfPending?: boolean | undefined;
-                            } | {
-                                readonly type: "branch";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "fork";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "operator";
-                                readonly requestId: string;
-                                readonly author: "operator" | "party";
-                                readonly text: string;
-                            } | {
-                                readonly requestId: string;
-                                readonly type: "compact";
-                                readonly instructions?: string;
-                            } | {
-                                readonly type: "title";
-                                readonly title: string | null;
-                            };
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: null;
-                    outputFormat: "body";
-                    status: 204;
-                } | {
-                    input: {
-                        json: {
-                            readonly command: {
-                                readonly requestId: string;
-                                readonly type: "prompt";
-                                readonly text: string;
-                                readonly delivery: "followUp" | "steer";
-                                readonly images?: readonly {
-                                    readonly type: "image";
-                                    readonly data: string;
-                                    readonly mimeType: string;
-                                }[];
-                            } | {
-                                readonly type: "abort";
-                            } | {
-                                readonly type: "cancel";
-                                readonly commandId: string;
-                                readonly onlyIfPending?: boolean | undefined;
-                            } | {
-                                readonly type: "branch";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "fork";
-                                readonly entryId: string;
-                            } | {
-                                readonly type: "operator";
-                                readonly requestId: string;
-                                readonly author: "operator" | "party";
-                                readonly text: string;
-                            } | {
-                                readonly requestId: string;
-                                readonly type: "compact";
-                                readonly instructions?: string;
-                            } | {
-                                readonly type: "title";
-                                readonly title: string | null;
-                            };
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly status: "accepted";
-                        readonly commandId: string;
-                    } | {
-                        readonly status: "too_late";
-                        readonly commandId: string;
-                    } | {
-                        readonly sessionId: string;
-                    };
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/sessions/:sessionId": {
-                $get: {
-                    input: {
-                        query: {
-                            readonly includeSandboxFailures?: "true" | undefined;
-                            readonly limit?: number | undefined;
-                            readonly before?: string | undefined;
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                } | {
-                    input: {
-                        query: {
-                            readonly includeSandboxFailures?: "true" | undefined;
-                            readonly limit?: number | undefined;
-                            readonly before?: string | undefined;
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly sessionId: string;
-                        readonly cursor: string | null;
-                        readonly hasMore: boolean;
-                        readonly oldestCursor?: string | null | undefined;
-                        readonly messages: readonly {
-                            readonly meta?: any;
-                            readonly origin?: {
-                                readonly extensionId: string;
-                                readonly correlation: string | null;
-                            } | undefined;
-                            readonly id: string;
-                            readonly sequence: number;
-                            readonly commandId: string | null;
-                            readonly value: {
-                                role: "system";
-                                content: string | {
-                                    type: "text";
-                                    text: string;
-                                    textSignature?: string | undefined;
-                                }[];
-                                sections?: {
-                                    [x: string]: string | null;
-                                } | undefined;
-                                toolsAdded?: {
-                                    name: string;
-                                    description: string;
-                                    parameters: never;
-                                    constrainedSampling?: false | {
-                                        type: "json_schema";
-                                        strict: "prefer" | "require";
-                                    } | {
-                                        type: "grammar";
-                                        variants: {
-                                            openai_lark?: string | undefined;
-                                            openai_regex?: string | undefined;
-                                        };
-                                    } | undefined;
-                                }[] | undefined;
-                                toolsRemoved?: {
-                                    name: string;
-                                }[] | undefined;
-                                timestamp: number;
-                            } | {
-                                role: "user";
-                                content: string | ({
-                                    type: "text";
-                                    text: string;
-                                    textSignature?: string | undefined;
-                                } | {
-                                    type: "image";
-                                    data: string;
-                                    mimeType: string;
-                                })[];
-                                timestamp: number;
-                            } | {
-                                role: "assistant";
-                                content: ({
-                                    type: "text";
-                                    text: string;
-                                    textSignature?: string | undefined;
-                                } | {
-                                    type: "toolCall";
-                                    id: string;
-                                    name: string;
-                                    arguments: {
-                                        [x: string]: any;
-                                    };
-                                    thoughtSignature?: string | undefined;
-                                    namespace?: string | undefined;
-                                } | {
-                                    type: "thinking";
-                                    thinking: string;
-                                    thinkingSignature?: string | undefined;
-                                    redacted?: boolean | undefined;
-                                })[];
-                                api: import("@earendil-works/pi-ai").Api;
-                                provider: import("@earendil-works/pi-ai").ProviderId;
-                                model: string;
-                                responseModel?: string | undefined;
-                                responseId?: string | undefined;
-                                providerThinkingLevel?: string | undefined;
-                                thinkingLevel?: import("@earendil-works/pi-ai").ModelThinkingLevel | undefined;
-                                diagnostics?: {
-                                    type: string;
-                                    timestamp: number;
-                                    error?: {
-                                        name?: string | undefined;
-                                        message: string;
-                                        stack?: string | undefined;
-                                        code?: string | number | undefined;
-                                    } | undefined;
-                                    details?: {
-                                        [x: string]: any;
-                                    } | undefined;
-                                }[] | undefined;
-                                usage: {
-                                    input: number;
-                                    output: number;
-                                    cacheRead: number;
-                                    cacheWrite: number;
-                                    cacheWrite1h?: number | undefined;
-                                    reasoning?: number | undefined;
-                                    totalTokens: number;
-                                    cost: {
-                                        input: number;
-                                        output: number;
-                                        cacheRead: number;
-                                        cacheWrite: number;
-                                        total: number;
-                                    };
-                                };
-                                stopReason: import("@earendil-works/pi-ai").StopReason;
-                                deferred?: {
-                                    provider: string;
-                                    modelId: string;
-                                    api: string;
-                                    id: string;
-                                    expiresAt?: number | undefined;
-                                    pollAfterMs?: number | undefined;
-                                    data?: any;
-                                } | undefined;
-                                errorMessage?: string | undefined;
-                                rawStopReason?: string | undefined;
-                                endTurn?: boolean | undefined;
-                                timestamp: number;
-                            } | {
-                                role: "toolResult";
-                                toolCallId: string;
-                                toolName: string;
-                                content: ({
-                                    type: "text";
-                                    text: string;
-                                    textSignature?: string | undefined;
-                                } | {
-                                    type: "image";
-                                    data: string;
-                                    mimeType: string;
-                                })[];
-                                details?: any;
-                                usage?: {
-                                    input: number;
-                                    output: number;
-                                    cacheRead: number;
-                                    cacheWrite: number;
-                                    cacheWrite1h?: number | undefined;
-                                    reasoning?: number | undefined;
-                                    totalTokens: number;
-                                    cost: {
-                                        input: number;
-                                        output: number;
-                                        cacheRead: number;
-                                        cacheWrite: number;
-                                        total: number;
-                                    };
-                                } | undefined;
-                                nestedCalls?: {
-                                    calls: {
-                                        id: string;
-                                        name: string;
-                                        arguments?: {
-                                            [x: string]: any;
-                                        } | undefined;
-                                        argumentsBytes?: number | undefined;
-                                        status: "ok" | "error" | "unfinished";
-                                        durationMs?: number | undefined;
-                                        error?: string | undefined;
-                                    }[];
-                                    complete: boolean;
-                                } | undefined;
-                                isError: boolean;
-                                timestamp: number;
-                            };
-                        }[];
-                        readonly terminals: readonly {
-                            readonly commandId: string;
-                            readonly outcome: "completed" | "cancelled" | "failed" | "interrupted";
-                            readonly sequence: number;
-                            readonly diagnostic: string | null;
-                            readonly meta?: any;
-                        }[];
-                        readonly compactions?: readonly {
-                            readonly id: string;
-                            readonly sequence: number;
-                            readonly at: number;
-                            readonly tokensBefore: number;
-                            readonly tokensAfter: number | null;
-                            readonly trigger: import("@fungi.computer/shiitake").SessionCompactionTrigger | null;
-                        }[] | undefined;
-                        readonly compactionNotices?: readonly {
-                            readonly id: string;
-                            readonly sequence: number;
-                            readonly at: number;
-                            readonly trigger: import("@fungi.computer/shiitake").SessionCompactionTrigger;
-                            readonly result: "nothing_to_compact" | "failed";
-                            readonly diagnostic: string | null;
-                        }[] | undefined;
-                        readonly sandboxFailures?: readonly {
-                            readonly kind: "sandbox_failure";
-                            readonly ref: string;
-                            readonly executionId: string;
-                            readonly adapter: string;
-                            readonly buildSha: string | null;
-                            readonly tag: "Unknown" | "SourceInvalid" | "GuestThrew" | "DeadlineExceeded" | "Cancelled" | "DispatchLost" | "SandboxCrashed" | "BadResponse" | "ResultTooLarge" | "ResultNotJson" | "CapabilityFailed";
-                            readonly fields: {
-                                readonly [x: string]: any;
-                            };
-                            readonly healthAlert: boolean;
-                        }[] | undefined;
-                        readonly pending: {
-                            readonly total: number;
-                            readonly prompts: readonly {
-                                readonly meta?: any;
-                                readonly origin?: {
-                                    readonly extensionId: string;
-                                    readonly correlation: string | null;
-                                } | undefined;
-                                readonly commandId: string;
-                                readonly text: string;
-                                readonly images?: readonly {
-                                    readonly type: "image";
-                                    readonly data: string;
-                                    readonly mimeType: string;
-                                }[] | undefined;
-                                readonly delivery: import("@fungi.computer/shiitake").PromptDelivery;
-                            }[];
-                            readonly hasMore: boolean;
-                        };
-                        readonly activity: {
-                            readonly queue: {
-                                readonly state: "idle";
-                            } | {
-                                readonly state: "queued";
-                                readonly commandId: string;
-                                readonly runningWork: {
-                                    readonly kind: "session";
-                                    readonly sessionId: string;
-                                    readonly commandId: string;
-                                } | {
-                                    readonly kind: "host";
-                                    readonly lane: string;
-                                    readonly jobId: string;
-                                } | null;
-                            } | {
-                                readonly state: "running";
-                                readonly commandId: string;
-                            };
-                            readonly cancellationRequested: boolean;
-                            readonly retry: {
-                                readonly attempt: number;
-                                readonly maxAttempts: number;
-                                readonly delayMs: number;
-                                readonly errorMessage: string;
-                                readonly scheduledAt: number;
-                            } | null;
-                            readonly activeTool: string | null;
-                            readonly lastModelChoiceSequence: number | null;
-                            readonly compaction: {
-                                readonly trigger: import("@fungi.computer/shiitake").SessionCompactionTrigger;
-                            } | null;
-                        };
-                        readonly progress: {
-                            readonly messageId: string;
-                            readonly revision: number;
-                            readonly text: string;
-                            readonly thinking: string;
-                            readonly textTruncated: boolean;
-                            readonly thinkingTruncated: boolean;
-                        } | null;
-                        readonly extensions: {
-                            readonly [x: string]: {
-                                readonly status: "running";
-                                readonly revision: string;
-                                readonly value: any;
-                                readonly catalog?: any;
-                            } | {
-                                readonly status: "stopped";
-                                readonly revision: string;
-                                readonly reason: string;
-                            };
-                        };
-                        readonly attention: readonly {
-                            readonly id: string;
-                            readonly kind: string;
-                            readonly summary: string;
-                            readonly since: number;
-                            readonly extensionId: string;
-                            readonly expiresAt?: number | undefined;
-                        }[];
-                        readonly context?: {
-                            readonly tokens: number;
-                            readonly window: number | null;
-                        } | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 200;
-                };
-            };
-        } & {
-            "/sessions/:sessionId/events": {
-                $get: {
-                    input: {
-                        query: {
-                            readonly includeSandboxFailures?: "true" | undefined;
-                            readonly limit?: number | undefined;
-                            readonly after?: string | undefined;
-                            readonly mode?: "subscribe" | undefined;
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {};
-                    outputFormat: string;
-                    status: import("hono/utils/http-status").StatusCode;
-                } | {
-                    input: {
-                        query: {
-                            readonly includeSandboxFailures?: "true" | undefined;
-                            readonly limit?: number | undefined;
-                            readonly after?: string | undefined;
-                            readonly mode?: "subscribe" | undefined;
-                        };
-                    } & {
-                        param: {
-                            sessionId: string;
-                        };
-                    };
-                    output: {
-                        readonly cause: "closed" | "conflict" | "incompatible" | "invalid" | "rejected" | "unavailable" | "storage_pressure" | "context_too_large";
-                        readonly _tag: "ShiitakeError";
-                        readonly boundary: "contract" | "extensions" | "instructions" | "model" | "runtime" | "store" | "tools";
-                        readonly message: string;
-                        readonly requestId?: string | undefined;
-                    };
-                    outputFormat: "json";
-                    status: 400;
-                };
-            };
-        }, "/", "/sessions/:sessionId/events">;
+        /** End this selection's use; the mounted route reopens the Agent later. */
+        release: () => void;
+    }>;
+    serve: (selection: Pick<PrivateLocalServiceSelection, "invocationRoot" | "databasePath" | "fungiMcp">, request: Request, attachment?: LocalUiAttachment) => Promise<Response>;
+    effectiveModel: (selection: Pick<PrivateLocalServiceSelection, "invocationRoot" | "databasePath" | "fungiMcp">, sessionId: string, signal: AbortSignal) => Promise<{
+        agentName: "Shiitake";
+        providerId: string;
+        providerName: string;
+        modelId: string;
+        modelName: string;
+        credential: {
+            kind: "oauth" | "api_key" | "missing";
+            source: string;
+        };
+        label: string;
+        reasoning?: "minimal" | "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    }>;
+    sandboxStatus: (selection: Pick<PrivateLocalServiceSelection, "invocationRoot" | "databasePath" | "fungiMcp">, signal: AbortSignal) => Promise<{
+        state: "available";
+        requireSandbox: boolean;
+    } | {
+        state: "unavailable";
+        requireSandbox: boolean;
+        reason: {
+            kind: "missing" | "invalid-digest" | "digest-mismatch" | "not-executable" | "unsupported-platform" | "invalid-folder" | "backend-refused";
+            message: string;
+        };
     }>;
+    sweepIdle: () => Promise<void>;
+    archive: (request: Readonly<{
+        invocationRoot: string;
+        agentId: string;
+        archived: boolean;
+    }>, signal: AbortSignal) => Promise<void>;
+    stopAll: (request: Readonly<{
+        invocationRoot: string;
+        agentId: string;
+    }>) => Promise<StopAllResult>;
     restore: () => Promise<void>;
     close: () => Promise<void>;
+    reload: (invocationRoot: string, clientPath: string) => Promise<void>;
+    unfinishedOwners: () => string[];
 };