@fungi.computer/truffle 0.0.0-stage → 0.1.1

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

@@ -0,0 +1,1567 @@
+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">;
+export declare class LocalSessionPathConflict extends Error {
+    readonly name = "LocalSessionPathConflict";
+    constructor();
+}
+export type OpenLocalServiceRuntime = (options: Parameters<typeof openPrivateLocalRuntimeHost>[0]) => Promise<LocalServiceRuntime>;
+/** One service owns each store, independently of how many clients select it. */
+export declare function createLocalServiceOwners(openRuntime?: OpenLocalServiceRuntime, recoveryDirectory?: string): {
+    createSession: (creation: PrivateLocalSessionCreation) => Promise<{
+        agentId: string;
+        databasePath: string;
+        sessionId: string;
+        session: Readonly<{
+            address: string;
+            command: import("@fungi.computer/shiitake").SessionCommandHandler;
+            abort: () => Promise<void>;
+            send: (text: string, options?: import("@fungi.computer/shiitake").SendOptions) => Promise<import("@fungi.computer/shiitake").Accepted>;
+            cancel: (input: Readonly<{
+                commandId: string;
+                onlyIfPending?: boolean;
+            }>) => Promise<import("@fungi.computer/shiitake").CancelResult>;
+            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: (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">;
+    }>;
+    select: (selection: PrivateLocalServiceSelection, createRequestId?: string) => Promise<{
+        agentId: string;
+        databasePath: string;
+        sessionId: string;
+        session: Readonly<{
+            address: string;
+            command: import("@fungi.computer/shiitake").SessionCommandHandler;
+            abort: () => Promise<void>;
+            send: (text: string, options?: import("@fungi.computer/shiitake").SendOptions) => Promise<import("@fungi.computer/shiitake").Accepted>;
+            cancel: (input: Readonly<{
+                commandId: string;
+                onlyIfPending?: boolean;
+            }>) => Promise<import("@fungi.computer/shiitake").CancelResult>;
+            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: (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">;
+    }>;
+    restore: () => Promise<void>;
+    close: () => Promise<void>;
+};