@zakstam/codex-local-component 0.6.0 → 0.7.1

package/dist/host/convexPreset.d.ts

@@ -0,0 +1,1422 @@
+import { type CodexHostComponentRefs, type CodexHostComponentsInput, type HostActorContext, type HostMutationRunner, type HostQueryRunner } from "./convexSlice.js";
+import { HOST_SURFACE_MANIFEST } from "./surfaceManifest.js";
+export type CodexHostSliceProfile = "runtimeOwned" | "dispatchManaged";
+export type CodexHostSliceIngestMode = "streamOnly" | "mixed";
+export type CodexHostSliceThreadMode = "create" | "resolve";
+export type CodexHostSliceFeatures = {
+    hooks?: boolean;
+    approvals?: boolean;
+    serverRequests?: boolean;
+    reasoning?: boolean;
+    observability?: boolean;
+    hygiene?: boolean;
+};
+type ExtractCodexHostComponentRefs<Components extends CodexHostComponentsInput> = Components extends {
+    codexLocal: infer Component;
+} ? Component extends CodexHostComponentRefs ? Component : never : Components extends CodexHostComponentRefs ? Components : never;
+export type DefineCodexHostSliceOptions<Components extends CodexHostComponentsInput = CodexHostComponentsInput> = {
+    components: Components;
+    serverActor: HostActorContext;
+    profile: CodexHostSliceProfile;
+    ingestMode: CodexHostSliceIngestMode;
+    threadMode: CodexHostSliceThreadMode;
+    features?: CodexHostSliceFeatures;
+};
+export declare function defineCodexHostSlice<Components extends CodexHostComponentsInput>(options: DefineCodexHostSliceOptions<Components>): {
+    profile: CodexHostSliceProfile;
+    mutations: {
+        interruptTurnForHooks?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                turnId: import("convex/values").VString<string, "required">;
+                reason: import("convex/values").VString<string | undefined, "optional">;
+            };
+            returns: import("convex/values").VNull<null, "required">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                turnId: string;
+                reason?: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["turns"]["interrupt"]>>;
+        };
+        upsertPendingServerRequestForHooks?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                requestId: import("convex/values").VUnion<string | number, [import("convex/values").VString<string, "required">, import("convex/values").VFloat64<number, "required">], "required", never>;
+                threadId: import("convex/values").VString<string, "required">;
+                turnId: import("convex/values").VString<string, "required">;
+                itemId: import("convex/values").VString<string, "required">;
+                method: import("convex/values").VUnion<"item/commandExecution/requestApproval" | "item/fileChange/requestApproval" | "item/tool/requestUserInput" | "item/tool/call", [import("convex/values").VLiteral<"item/commandExecution/requestApproval", "required">, import("convex/values").VLiteral<"item/fileChange/requestApproval", "required">, import("convex/values").VLiteral<"item/tool/requestUserInput", "required">, import("convex/values").VLiteral<"item/tool/call", "required">], "required", never>;
+                payloadJson: import("convex/values").VString<string, "required">;
+                reason: import("convex/values").VString<string | undefined, "optional">;
+                questionsJson: import("convex/values").VString<string | undefined, "optional">;
+                requestedAt: import("convex/values").VFloat64<number, "required">;
+            };
+            returns: import("convex/values").VNull<null, "required">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                requestId: string | number;
+                threadId: string;
+                turnId: string;
+                itemId: string;
+                method: "item/commandExecution/requestApproval" | "item/fileChange/requestApproval" | "item/tool/requestUserInput" | "item/tool/call";
+                payloadJson: string;
+                reason?: string;
+                questionsJson?: string;
+                requestedAt: number;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["serverRequests"]["upsertPending"]>>;
+        };
+        resolvePendingServerRequestForHooks?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                requestId: import("convex/values").VUnion<string | number, [import("convex/values").VString<string, "required">, import("convex/values").VFloat64<number, "required">], "required", never>;
+                status: import("convex/values").VUnion<"answered" | "expired", [import("convex/values").VLiteral<"answered", "required">, import("convex/values").VLiteral<"expired", "required">], "required", never>;
+                resolvedAt: import("convex/values").VFloat64<number, "required">;
+                responseJson: import("convex/values").VString<string | undefined, "optional">;
+            };
+            returns: import("convex/values").VNull<null, "required">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                requestId: string | number;
+                status: "answered" | "expired";
+                resolvedAt: number;
+                responseJson?: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["serverRequests"]["resolve"]>>;
+        };
+        respondApprovalForHooks?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                turnId: import("convex/values").VString<string, "required">;
+                itemId: import("convex/values").VString<string, "required">;
+                decision: import("convex/values").VUnion<"declined" | "accepted", [import("convex/values").VLiteral<"accepted", "required">, import("convex/values").VLiteral<"declined", "required">], "required", never>;
+            };
+            returns: import("convex/values").VNull<null, "required">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                turnId: string;
+                itemId: string;
+                decision: "accepted" | "declined";
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["approvals"]["respond"]>>;
+        };
+        ensureThread: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string | undefined, "optional">;
+                externalThreadId: import("convex/values").VString<string | undefined, "optional">;
+                model: import("convex/values").VString<string | undefined, "optional">;
+                cwd: import("convex/values").VString<string | undefined, "optional">;
+            };
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId?: string;
+                externalThreadId?: string;
+                model?: string;
+                cwd?: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["threads"]["resolve"]> | import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["threads"]["create"]>>;
+        };
+        enqueueTurnDispatch: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                dispatchId: import("convex/values").VString<string | undefined, "optional">;
+                turnId: import("convex/values").VString<string, "required">;
+                idempotencyKey: import("convex/values").VString<string, "required">;
+                input: import("convex/values").VArray<{
+                    text?: string;
+                    url?: string;
+                    path?: string;
+                    type: string;
+                }[], import("convex/values").VObject<{
+                    text?: string;
+                    url?: string;
+                    path?: string;
+                    type: string;
+                }, {
+                    type: import("convex/values").VString<string, "required">;
+                    text: import("convex/values").VString<string | undefined, "optional">;
+                    url: import("convex/values").VString<string | undefined, "optional">;
+                    path: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "text" | "type" | "url" | "path">, "required">;
+            };
+            returns: import("convex/values").VObject<{
+                status: "completed" | "failed" | "cancelled" | "queued" | "claimed" | "started";
+                turnId: string;
+                accepted: boolean;
+                dispatchId: string;
+            }, {
+                dispatchId: import("convex/values").VString<string, "required">;
+                turnId: import("convex/values").VString<string, "required">;
+                status: import("convex/values").VUnion<"completed" | "failed" | "cancelled" | "queued" | "claimed" | "started", [import("convex/values").VLiteral<"queued", "required">, import("convex/values").VLiteral<"claimed", "required">, import("convex/values").VLiteral<"started", "required">, import("convex/values").VLiteral<"completed", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"cancelled", "required">], "required", never>;
+                accepted: import("convex/values").VBoolean<boolean, "required">;
+            }, "required", "status" | "turnId" | "accepted" | "dispatchId">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                dispatchId?: string;
+                turnId: string;
+                idempotencyKey: string;
+                input: Array<{
+                    type: string;
+                    text?: string;
+                    url?: string;
+                    path?: string;
+                }>;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["dispatch"]["enqueueTurnDispatch"]>>;
+        };
+        claimNextTurnDispatch: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                claimOwner: import("convex/values").VString<string, "required">;
+                leaseMs: import("convex/values").VFloat64<number | undefined, "optional">;
+            };
+            returns: import("convex/values").VUnion<{
+                inputText: string;
+                turnId: string;
+                idempotencyKey: string;
+                dispatchId: string;
+                claimToken: string;
+                leaseExpiresAt: number;
+                attemptCount: number;
+            } | null, [import("convex/values").VNull<null, "required">, import("convex/values").VObject<{
+                inputText: string;
+                turnId: string;
+                idempotencyKey: string;
+                dispatchId: string;
+                claimToken: string;
+                leaseExpiresAt: number;
+                attemptCount: number;
+            }, {
+                dispatchId: import("convex/values").VString<string, "required">;
+                turnId: import("convex/values").VString<string, "required">;
+                idempotencyKey: import("convex/values").VString<string, "required">;
+                inputText: import("convex/values").VString<string, "required">;
+                claimToken: import("convex/values").VString<string, "required">;
+                leaseExpiresAt: import("convex/values").VFloat64<number, "required">;
+                attemptCount: import("convex/values").VFloat64<number, "required">;
+            }, "required", "inputText" | "turnId" | "idempotencyKey" | "dispatchId" | "claimToken" | "leaseExpiresAt" | "attemptCount">], "required", "inputText" | "turnId" | "idempotencyKey" | "dispatchId" | "claimToken" | "leaseExpiresAt" | "attemptCount">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                claimOwner: string;
+                leaseMs?: number;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["dispatch"]["claimNextTurnDispatch"]>>;
+        };
+        markTurnDispatchStarted: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                dispatchId: import("convex/values").VString<string, "required">;
+                claimToken: import("convex/values").VString<string, "required">;
+                runtimeThreadId: import("convex/values").VString<string | undefined, "optional">;
+                runtimeTurnId: import("convex/values").VString<string | undefined, "optional">;
+            };
+            returns: import("convex/values").VNull<null, "required">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                dispatchId: string;
+                claimToken: string;
+                runtimeThreadId?: string;
+                runtimeTurnId?: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["dispatch"]["markTurnStarted"]>>;
+        };
+        markTurnDispatchCompleted: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                dispatchId: import("convex/values").VString<string, "required">;
+                claimToken: import("convex/values").VString<string, "required">;
+            };
+            returns: import("convex/values").VNull<null, "required">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                dispatchId: string;
+                claimToken: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["dispatch"]["markTurnCompleted"]>>;
+        };
+        markTurnDispatchFailed: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                dispatchId: import("convex/values").VString<string, "required">;
+                claimToken: import("convex/values").VString<string, "required">;
+                code: import("convex/values").VString<string | undefined, "optional">;
+                reason: import("convex/values").VString<string, "required">;
+            };
+            returns: import("convex/values").VNull<null, "required">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                dispatchId: string;
+                claimToken: string;
+                code?: string;
+                reason: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["dispatch"]["markTurnFailed"]>>;
+        };
+        cancelTurnDispatch: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                dispatchId: import("convex/values").VString<string, "required">;
+                claimToken: import("convex/values").VString<string | undefined, "optional">;
+                reason: import("convex/values").VString<string, "required">;
+            };
+            returns: import("convex/values").VNull<null, "required">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                dispatchId: string;
+                claimToken?: string;
+                reason: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["dispatch"]["cancelTurnDispatch"]>>;
+        };
+        ensureSession: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                sessionId: import("convex/values").VString<string, "required">;
+                threadId: import("convex/values").VString<string, "required">;
+            };
+            returns: import("convex/values").VObject<{
+                status: "active" | "created";
+                threadId: string;
+                sessionId: string;
+            }, {
+                sessionId: import("convex/values").VString<string, "required">;
+                threadId: import("convex/values").VString<string, "required">;
+                status: import("convex/values").VUnion<"active" | "created", [import("convex/values").VLiteral<"created", "required">, import("convex/values").VLiteral<"active", "required">], "required", never>;
+            }, "required", "status" | "threadId" | "sessionId">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                sessionId: string;
+                threadId: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["sync"]["ensureSession"]>>;
+        };
+        ingestEvent: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                sessionId: import("convex/values").VString<string, "required">;
+                threadId: import("convex/values").VString<string, "required">;
+                event: import("convex/values").VUnion<{
+                    turnId: string;
+                    kind: string;
+                    createdAt: number;
+                    cursorEnd: number;
+                    payloadJson: string;
+                    streamId: string;
+                    eventId: string;
+                    cursorStart: number;
+                } | {
+                    type: "stream_delta";
+                    turnId: string;
+                    kind: string;
+                    createdAt: number;
+                    cursorEnd: number;
+                    payloadJson: string;
+                    streamId: string;
+                    eventId: string;
+                    cursorStart: number;
+                } | {
+                    turnId?: string;
+                    type: "lifecycle_event";
+                    kind: string;
+                    createdAt: number;
+                    payloadJson: string;
+                    eventId: string;
+                }, [import("convex/values").VObject<{
+                    turnId: string;
+                    kind: string;
+                    createdAt: number;
+                    cursorEnd: number;
+                    payloadJson: string;
+                    streamId: string;
+                    eventId: string;
+                    cursorStart: number;
+                }, {
+                    eventId: import("convex/values").VString<string, "required">;
+                    turnId: import("convex/values").VString<string, "required">;
+                    streamId: import("convex/values").VString<string, "required">;
+                    kind: import("convex/values").VString<string, "required">;
+                    payloadJson: import("convex/values").VString<string, "required">;
+                    cursorStart: import("convex/values").VFloat64<number, "required">;
+                    cursorEnd: import("convex/values").VFloat64<number, "required">;
+                    createdAt: import("convex/values").VFloat64<number, "required">;
+                }, "required", "turnId" | "kind" | "createdAt" | "cursorEnd" | "payloadJson" | "streamId" | "eventId" | "cursorStart">, import("convex/values").VObject<{
+                    type: "stream_delta";
+                    turnId: string;
+                    kind: string;
+                    createdAt: number;
+                    cursorEnd: number;
+                    payloadJson: string;
+                    streamId: string;
+                    eventId: string;
+                    cursorStart: number;
+                }, {
+                    type: import("convex/values").VLiteral<"stream_delta", "required">;
+                    eventId: import("convex/values").VString<string, "required">;
+                    turnId: import("convex/values").VString<string, "required">;
+                    streamId: import("convex/values").VString<string, "required">;
+                    kind: import("convex/values").VString<string, "required">;
+                    payloadJson: import("convex/values").VString<string, "required">;
+                    cursorStart: import("convex/values").VFloat64<number, "required">;
+                    cursorEnd: import("convex/values").VFloat64<number, "required">;
+                    createdAt: import("convex/values").VFloat64<number, "required">;
+                }, "required", "type" | "turnId" | "kind" | "createdAt" | "cursorEnd" | "payloadJson" | "streamId" | "eventId" | "cursorStart">, import("convex/values").VObject<{
+                    turnId?: string;
+                    type: "lifecycle_event";
+                    kind: string;
+                    createdAt: number;
+                    payloadJson: string;
+                    eventId: string;
+                }, {
+                    type: import("convex/values").VLiteral<"lifecycle_event", "required">;
+                    eventId: import("convex/values").VString<string, "required">;
+                    turnId: import("convex/values").VString<string | undefined, "optional">;
+                    kind: import("convex/values").VString<string, "required">;
+                    payloadJson: import("convex/values").VString<string, "required">;
+                    createdAt: import("convex/values").VFloat64<number, "required">;
+                }, "required", "type" | "turnId" | "kind" | "createdAt" | "payloadJson" | "eventId">], "required", "type" | "turnId" | "kind" | "createdAt" | "cursorEnd" | "payloadJson" | "streamId" | "eventId" | "cursorStart">;
+            };
+            returns: import("convex/values").VObject<{
+                recovery?: {
+                    action: "session_rebound";
+                    threadId: string;
+                    sessionId: string;
+                };
+                status: "ok" | "partial" | "session_recovered" | "rejected";
+                errors: {
+                    message: string;
+                    code: "SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "OUT_OF_ORDER" | "REPLAY_GAP" | "UNKNOWN";
+                    recoverable: boolean;
+                }[];
+                ingestStatus: "ok" | "partial";
+                ackedStreams: {
+                    streamId: string;
+                    ackCursorEnd: number;
+                }[];
+            }, {
+                status: import("convex/values").VUnion<"ok" | "partial" | "session_recovered" | "rejected", [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"partial", "required">, import("convex/values").VLiteral<"session_recovered", "required">, import("convex/values").VLiteral<"rejected", "required">], "required", never>;
+                ingestStatus: import("convex/values").VUnion<"ok" | "partial", [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"partial", "required">], "required", never>;
+                ackedStreams: import("convex/values").VArray<{
+                    streamId: string;
+                    ackCursorEnd: number;
+                }[], import("convex/values").VObject<{
+                    streamId: string;
+                    ackCursorEnd: number;
+                }, {
+                    streamId: import("convex/values").VString<string, "required">;
+                    ackCursorEnd: import("convex/values").VFloat64<number, "required">;
+                }, "required", "streamId" | "ackCursorEnd">, "required">;
+                recovery: import("convex/values").VObject<{
+                    action: "session_rebound";
+                    threadId: string;
+                    sessionId: string;
+                } | undefined, {
+                    action: import("convex/values").VLiteral<"session_rebound", "required">;
+                    sessionId: import("convex/values").VString<string, "required">;
+                    threadId: import("convex/values").VString<string, "required">;
+                }, "optional", "action" | "threadId" | "sessionId">;
+                errors: import("convex/values").VArray<{
+                    message: string;
+                    code: "SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "OUT_OF_ORDER" | "REPLAY_GAP" | "UNKNOWN";
+                    recoverable: boolean;
+                }[], import("convex/values").VObject<{
+                    message: string;
+                    code: "SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "OUT_OF_ORDER" | "REPLAY_GAP" | "UNKNOWN";
+                    recoverable: boolean;
+                }, {
+                    code: import("convex/values").VUnion<"SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "OUT_OF_ORDER" | "REPLAY_GAP" | "UNKNOWN", [import("convex/values").VLiteral<"SESSION_NOT_FOUND", "required">, import("convex/values").VLiteral<"SESSION_THREAD_MISMATCH", "required">, import("convex/values").VLiteral<"OUT_OF_ORDER", "required">, import("convex/values").VLiteral<"REPLAY_GAP", "required">, import("convex/values").VLiteral<"UNKNOWN", "required">], "required", never>;
+                    message: import("convex/values").VString<string, "required">;
+                    recoverable: import("convex/values").VBoolean<boolean, "required">;
+                }, "required", "message" | "code" | "recoverable">, "required">;
+            }, "required", "status" | "errors" | "ingestStatus" | "ackedStreams" | "recovery" | "recovery.action" | "recovery.threadId" | "recovery.sessionId">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                sessionId: string;
+                threadId: string;
+                event: {
+                    eventId: string;
+                    turnId: string;
+                    streamId: string;
+                    kind: string;
+                    payloadJson: string;
+                    cursorStart: number;
+                    cursorEnd: number;
+                    createdAt: number;
+                } | {
+                    type: "stream_delta";
+                    eventId: string;
+                    turnId: string;
+                    streamId: string;
+                    kind: string;
+                    payloadJson: string;
+                    cursorStart: number;
+                    cursorEnd: number;
+                    createdAt: number;
+                } | {
+                    type: "lifecycle_event";
+                    eventId: string;
+                    turnId?: string;
+                    kind: string;
+                    payloadJson: string;
+                    createdAt: number;
+                };
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["sync"]["ingestSafe"]>>;
+        };
+        ingestBatch: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                sessionId: import("convex/values").VString<string, "required">;
+                threadId: import("convex/values").VString<string, "required">;
+                deltas: import("convex/values").VArray<({
+                    turnId: string;
+                    kind: string;
+                    createdAt: number;
+                    cursorEnd: number;
+                    payloadJson: string;
+                    streamId: string;
+                    eventId: string;
+                    cursorStart: number;
+                } | {
+                    type: "stream_delta";
+                    turnId: string;
+                    kind: string;
+                    createdAt: number;
+                    cursorEnd: number;
+                    payloadJson: string;
+                    streamId: string;
+                    eventId: string;
+                    cursorStart: number;
+                } | {
+                    turnId?: string;
+                    type: "lifecycle_event";
+                    kind: string;
+                    createdAt: number;
+                    payloadJson: string;
+                    eventId: string;
+                })[], import("convex/values").VUnion<{
+                    turnId: string;
+                    kind: string;
+                    createdAt: number;
+                    cursorEnd: number;
+                    payloadJson: string;
+                    streamId: string;
+                    eventId: string;
+                    cursorStart: number;
+                } | {
+                    type: "stream_delta";
+                    turnId: string;
+                    kind: string;
+                    createdAt: number;
+                    cursorEnd: number;
+                    payloadJson: string;
+                    streamId: string;
+                    eventId: string;
+                    cursorStart: number;
+                } | {
+                    turnId?: string;
+                    type: "lifecycle_event";
+                    kind: string;
+                    createdAt: number;
+                    payloadJson: string;
+                    eventId: string;
+                }, [import("convex/values").VObject<{
+                    turnId: string;
+                    kind: string;
+                    createdAt: number;
+                    cursorEnd: number;
+                    payloadJson: string;
+                    streamId: string;
+                    eventId: string;
+                    cursorStart: number;
+                }, {
+                    eventId: import("convex/values").VString<string, "required">;
+                    turnId: import("convex/values").VString<string, "required">;
+                    streamId: import("convex/values").VString<string, "required">;
+                    kind: import("convex/values").VString<string, "required">;
+                    payloadJson: import("convex/values").VString<string, "required">;
+                    cursorStart: import("convex/values").VFloat64<number, "required">;
+                    cursorEnd: import("convex/values").VFloat64<number, "required">;
+                    createdAt: import("convex/values").VFloat64<number, "required">;
+                }, "required", "turnId" | "kind" | "createdAt" | "cursorEnd" | "payloadJson" | "streamId" | "eventId" | "cursorStart">, import("convex/values").VObject<{
+                    type: "stream_delta";
+                    turnId: string;
+                    kind: string;
+                    createdAt: number;
+                    cursorEnd: number;
+                    payloadJson: string;
+                    streamId: string;
+                    eventId: string;
+                    cursorStart: number;
+                }, {
+                    type: import("convex/values").VLiteral<"stream_delta", "required">;
+                    eventId: import("convex/values").VString<string, "required">;
+                    turnId: import("convex/values").VString<string, "required">;
+                    streamId: import("convex/values").VString<string, "required">;
+                    kind: import("convex/values").VString<string, "required">;
+                    payloadJson: import("convex/values").VString<string, "required">;
+                    cursorStart: import("convex/values").VFloat64<number, "required">;
+                    cursorEnd: import("convex/values").VFloat64<number, "required">;
+                    createdAt: import("convex/values").VFloat64<number, "required">;
+                }, "required", "type" | "turnId" | "kind" | "createdAt" | "cursorEnd" | "payloadJson" | "streamId" | "eventId" | "cursorStart">, import("convex/values").VObject<{
+                    turnId?: string;
+                    type: "lifecycle_event";
+                    kind: string;
+                    createdAt: number;
+                    payloadJson: string;
+                    eventId: string;
+                }, {
+                    type: import("convex/values").VLiteral<"lifecycle_event", "required">;
+                    eventId: import("convex/values").VString<string, "required">;
+                    turnId: import("convex/values").VString<string | undefined, "optional">;
+                    kind: import("convex/values").VString<string, "required">;
+                    payloadJson: import("convex/values").VString<string, "required">;
+                    createdAt: import("convex/values").VFloat64<number, "required">;
+                }, "required", "type" | "turnId" | "kind" | "createdAt" | "payloadJson" | "eventId">], "required", "type" | "turnId" | "kind" | "createdAt" | "cursorEnd" | "payloadJson" | "streamId" | "eventId" | "cursorStart">, "required">;
+                runtime: import("convex/values").VObject<{
+                    saveStreamDeltas?: boolean;
+                    saveReasoningDeltas?: boolean;
+                    exposeRawReasoningDeltas?: boolean;
+                    maxDeltasPerStreamRead?: number;
+                    maxDeltasPerRequestRead?: number;
+                    finishedStreamDeleteDelayMs?: number;
+                } | undefined, {
+                    saveStreamDeltas: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                    saveReasoningDeltas: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                    exposeRawReasoningDeltas: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                    maxDeltasPerStreamRead: import("convex/values").VFloat64<number | undefined, "optional">;
+                    maxDeltasPerRequestRead: import("convex/values").VFloat64<number | undefined, "optional">;
+                    finishedStreamDeleteDelayMs: import("convex/values").VFloat64<number | undefined, "optional">;
+                }, "optional", "saveStreamDeltas" | "saveReasoningDeltas" | "exposeRawReasoningDeltas" | "maxDeltasPerStreamRead" | "maxDeltasPerRequestRead" | "finishedStreamDeleteDelayMs">;
+            };
+            returns: import("convex/values").VObject<{
+                recovery?: {
+                    action: "session_rebound";
+                    threadId: string;
+                    sessionId: string;
+                };
+                status: "ok" | "partial" | "session_recovered" | "rejected";
+                errors: {
+                    message: string;
+                    code: "SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "OUT_OF_ORDER" | "REPLAY_GAP" | "UNKNOWN";
+                    recoverable: boolean;
+                }[];
+                ingestStatus: "ok" | "partial";
+                ackedStreams: {
+                    streamId: string;
+                    ackCursorEnd: number;
+                }[];
+            }, {
+                status: import("convex/values").VUnion<"ok" | "partial" | "session_recovered" | "rejected", [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"partial", "required">, import("convex/values").VLiteral<"session_recovered", "required">, import("convex/values").VLiteral<"rejected", "required">], "required", never>;
+                ingestStatus: import("convex/values").VUnion<"ok" | "partial", [import("convex/values").VLiteral<"ok", "required">, import("convex/values").VLiteral<"partial", "required">], "required", never>;
+                ackedStreams: import("convex/values").VArray<{
+                    streamId: string;
+                    ackCursorEnd: number;
+                }[], import("convex/values").VObject<{
+                    streamId: string;
+                    ackCursorEnd: number;
+                }, {
+                    streamId: import("convex/values").VString<string, "required">;
+                    ackCursorEnd: import("convex/values").VFloat64<number, "required">;
+                }, "required", "streamId" | "ackCursorEnd">, "required">;
+                recovery: import("convex/values").VObject<{
+                    action: "session_rebound";
+                    threadId: string;
+                    sessionId: string;
+                } | undefined, {
+                    action: import("convex/values").VLiteral<"session_rebound", "required">;
+                    sessionId: import("convex/values").VString<string, "required">;
+                    threadId: import("convex/values").VString<string, "required">;
+                }, "optional", "action" | "threadId" | "sessionId">;
+                errors: import("convex/values").VArray<{
+                    message: string;
+                    code: "SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "OUT_OF_ORDER" | "REPLAY_GAP" | "UNKNOWN";
+                    recoverable: boolean;
+                }[], import("convex/values").VObject<{
+                    message: string;
+                    code: "SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "OUT_OF_ORDER" | "REPLAY_GAP" | "UNKNOWN";
+                    recoverable: boolean;
+                }, {
+                    code: import("convex/values").VUnion<"SESSION_NOT_FOUND" | "SESSION_THREAD_MISMATCH" | "OUT_OF_ORDER" | "REPLAY_GAP" | "UNKNOWN", [import("convex/values").VLiteral<"SESSION_NOT_FOUND", "required">, import("convex/values").VLiteral<"SESSION_THREAD_MISMATCH", "required">, import("convex/values").VLiteral<"OUT_OF_ORDER", "required">, import("convex/values").VLiteral<"REPLAY_GAP", "required">, import("convex/values").VLiteral<"UNKNOWN", "required">], "required", never>;
+                    message: import("convex/values").VString<string, "required">;
+                    recoverable: import("convex/values").VBoolean<boolean, "required">;
+                }, "required", "message" | "code" | "recoverable">, "required">;
+            }, "required", "status" | "errors" | "ingestStatus" | "ackedStreams" | "recovery" | "recovery.action" | "recovery.threadId" | "recovery.sessionId">;
+            handler: (ctx: HostMutationRunner & HostQueryRunner, args: {
+                actor: HostActorContext;
+                sessionId: string;
+                threadId: string;
+                deltas: Array<{
+                    eventId: string;
+                    turnId: string;
+                    streamId: string;
+                    kind: string;
+                    payloadJson: string;
+                    cursorStart: number;
+                    cursorEnd: number;
+                    createdAt: number;
+                } | {
+                    type: "stream_delta";
+                    eventId: string;
+                    turnId: string;
+                    streamId: string;
+                    kind: string;
+                    payloadJson: string;
+                    cursorStart: number;
+                    cursorEnd: number;
+                    createdAt: number;
+                } | {
+                    type: "lifecycle_event";
+                    eventId: string;
+                    turnId?: string;
+                    kind: string;
+                    payloadJson: string;
+                    createdAt: number;
+                }>;
+                runtime?: {
+                    saveStreamDeltas?: boolean;
+                    saveReasoningDeltas?: boolean;
+                    exposeRawReasoningDeltas?: boolean;
+                    maxDeltasPerStreamRead?: number;
+                    maxDeltasPerRequestRead?: number;
+                    finishedStreamDeleteDelayMs?: number;
+                };
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["sync"]["ingestSafe"]>>;
+        };
+    };
+    queries: {
+        listPendingServerRequestsForHooks?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string | undefined, "optional">;
+                limit: import("convex/values").VFloat64<number | undefined, "optional">;
+            };
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId?: string;
+                limit?: number;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["serverRequests"]["listPending"]>>;
+        };
+        listPendingApprovalsForHooks?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string | undefined, "optional">;
+                paginationOpts: import("convex/values").VObject<{
+                    id?: number;
+                    endCursor?: string | null;
+                    maximumRowsRead?: number;
+                    maximumBytesRead?: number;
+                    numItems: number;
+                    cursor: string | null;
+                }, {
+                    numItems: import("convex/values").VFloat64<number, "required">;
+                    cursor: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+                    endCursor: import("convex/values").VUnion<string | null | undefined, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "optional", never>;
+                    id: import("convex/values").VFloat64<number | undefined, "optional">;
+                    maximumRowsRead: import("convex/values").VFloat64<number | undefined, "optional">;
+                    maximumBytesRead: import("convex/values").VFloat64<number | undefined, "optional">;
+                }, "required", "id" | "cursor" | "numItems" | "endCursor" | "maximumRowsRead" | "maximumBytesRead">;
+            };
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId?: string;
+                paginationOpts: {
+                    cursor: string | null;
+                    numItems: number;
+                };
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["approvals"]["listPending"]>>;
+        };
+        listThreadReasoningForHooks?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                paginationOpts: import("convex/values").VObject<{
+                    id?: number;
+                    endCursor?: string | null;
+                    maximumRowsRead?: number;
+                    maximumBytesRead?: number;
+                    numItems: number;
+                    cursor: string | null;
+                }, {
+                    numItems: import("convex/values").VFloat64<number, "required">;
+                    cursor: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+                    endCursor: import("convex/values").VUnion<string | null | undefined, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "optional", never>;
+                    id: import("convex/values").VFloat64<number | undefined, "optional">;
+                    maximumRowsRead: import("convex/values").VFloat64<number | undefined, "optional">;
+                    maximumBytesRead: import("convex/values").VFloat64<number | undefined, "optional">;
+                }, "required", "id" | "cursor" | "numItems" | "endCursor" | "maximumRowsRead" | "maximumBytesRead">;
+                includeRaw: import("convex/values").VBoolean<boolean | undefined, "optional">;
+            };
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                paginationOpts: {
+                    cursor: string | null;
+                    numItems: number;
+                };
+                includeRaw?: boolean;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["reasoning"]["listByThread"]>>;
+        };
+        listThreadMessagesForHooks?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                paginationOpts: import("convex/values").VObject<{
+                    id?: number;
+                    endCursor?: string | null;
+                    maximumRowsRead?: number;
+                    maximumBytesRead?: number;
+                    numItems: number;
+                    cursor: string | null;
+                }, {
+                    numItems: import("convex/values").VFloat64<number, "required">;
+                    cursor: import("convex/values").VUnion<string | null, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "required", never>;
+                    endCursor: import("convex/values").VUnion<string | null | undefined, [import("convex/values").VString<string, "required">, import("convex/values").VNull<null, "required">], "optional", never>;
+                    id: import("convex/values").VFloat64<number | undefined, "optional">;
+                    maximumRowsRead: import("convex/values").VFloat64<number | undefined, "optional">;
+                    maximumBytesRead: import("convex/values").VFloat64<number | undefined, "optional">;
+                }, "required", "id" | "cursor" | "numItems" | "endCursor" | "maximumRowsRead" | "maximumBytesRead">;
+                streamArgs: import("convex/values").VUnion<{
+                    startOrder?: number;
+                    kind: "list";
+                } | {
+                    kind: "deltas";
+                    cursors: {
+                        cursor: number;
+                        streamId: string;
+                    }[];
+                } | undefined, [import("convex/values").VObject<{
+                    startOrder?: number;
+                    kind: "list";
+                }, {
+                    kind: import("convex/values").VLiteral<"list", "required">;
+                    startOrder: import("convex/values").VFloat64<number | undefined, "optional">;
+                }, "required", "kind" | "startOrder">, import("convex/values").VObject<{
+                    kind: "deltas";
+                    cursors: {
+                        cursor: number;
+                        streamId: string;
+                    }[];
+                }, {
+                    kind: import("convex/values").VLiteral<"deltas", "required">;
+                    cursors: import("convex/values").VArray<{
+                        cursor: number;
+                        streamId: string;
+                    }[], import("convex/values").VObject<{
+                        cursor: number;
+                        streamId: string;
+                    }, {
+                        streamId: import("convex/values").VString<string, "required">;
+                        cursor: import("convex/values").VFloat64<number, "required">;
+                    }, "required", "cursor" | "streamId">, "required">;
+                }, "required", "kind" | "cursors">], "optional", "kind" | "startOrder" | "cursors">;
+                runtime: import("convex/values").VObject<{
+                    saveStreamDeltas?: boolean;
+                    saveReasoningDeltas?: boolean;
+                    exposeRawReasoningDeltas?: boolean;
+                    maxDeltasPerStreamRead?: number;
+                    maxDeltasPerRequestRead?: number;
+                    finishedStreamDeleteDelayMs?: number;
+                } | undefined, {
+                    saveStreamDeltas: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                    saveReasoningDeltas: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                    exposeRawReasoningDeltas: import("convex/values").VBoolean<boolean | undefined, "optional">;
+                    maxDeltasPerStreamRead: import("convex/values").VFloat64<number | undefined, "optional">;
+                    maxDeltasPerRequestRead: import("convex/values").VFloat64<number | undefined, "optional">;
+                    finishedStreamDeleteDelayMs: import("convex/values").VFloat64<number | undefined, "optional">;
+                }, "optional", "saveStreamDeltas" | "saveReasoningDeltas" | "exposeRawReasoningDeltas" | "maxDeltasPerStreamRead" | "maxDeltasPerRequestRead" | "finishedStreamDeleteDelayMs">;
+            };
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                paginationOpts: {
+                    cursor: string | null;
+                    numItems: number;
+                };
+                streamArgs?: {
+                    kind: "list";
+                    startOrder?: number;
+                } | {
+                    kind: "deltas";
+                    cursors: Array<{
+                        streamId: string;
+                        cursor: number;
+                    }>;
+                };
+                runtime?: {
+                    saveStreamDeltas?: boolean;
+                    saveReasoningDeltas?: boolean;
+                    exposeRawReasoningDeltas?: boolean;
+                    maxDeltasPerStreamRead?: number;
+                    maxDeltasPerRequestRead?: number;
+                    finishedStreamDeleteDelayMs?: number;
+                };
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["messages"]["listByThread"]> & {
+                streams?: {
+                    kind: "list";
+                    streams: Array<{
+                        streamId: string;
+                        state: string;
+                    }>;
+                } | {
+                    kind: "deltas";
+                    streams: Array<{
+                        streamId: string;
+                        state: string;
+                    }>;
+                    deltas: Array<Record<string, unknown>>;
+                    streamWindows: Array<{
+                        streamId: string;
+                        status: "ok" | "rebased" | "stale";
+                        serverCursorStart: number;
+                        serverCursorEnd: number;
+                    }>;
+                    nextCheckpoints: Array<{
+                        streamId: string;
+                        cursor: number;
+                    }>;
+                };
+            }>;
+        };
+        listTurnMessagesForHooks?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                turnId: import("convex/values").VString<string, "required">;
+            };
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                turnId: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["messages"]["getByTurn"]>>;
+        };
+        dataHygiene?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+            };
+            returns: import("convex/values").VObject<{
+                scannedStreamStats: number;
+                streamStatOrphans: number;
+                orphanStreamIds: string[];
+            }, {
+                scannedStreamStats: import("convex/values").VFloat64<number, "required">;
+                streamStatOrphans: import("convex/values").VFloat64<number, "required">;
+                orphanStreamIds: import("convex/values").VArray<string[], import("convex/values").VString<string, "required">, "required">;
+            }, "required", "scannedStreamStats" | "streamStatOrphans" | "orphanStreamIds">;
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+            }) => Promise<{
+                scannedStreamStats: number;
+                streamStatOrphans: number;
+                orphanStreamIds: string[];
+            }>;
+        };
+        getDispatchObservability?: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                dispatchId: import("convex/values").VString<string | undefined, "optional">;
+                turnId: import("convex/values").VString<string | undefined, "optional">;
+            };
+            returns: import("convex/values").VObject<{
+                threadId: string;
+                turn: {
+                    status?: string;
+                    turnId?: string;
+                };
+                runtime: {
+                    runtimeThreadId?: string;
+                    runtimeTurnId?: string;
+                    inFlight: boolean;
+                };
+                dispatch: {
+                    startedAt?: number;
+                    completedAt?: number;
+                    claimOwner?: string;
+                    claimToken?: string;
+                    runtimeThreadId?: string;
+                    runtimeTurnId?: string;
+                    failureCode?: string;
+                    failureReason?: string;
+                    cancelledAt?: number;
+                    inputText: string;
+                    status: "completed" | "failed" | "cancelled" | "queued" | "claimed" | "started";
+                    turnId: string;
+                    createdAt: number;
+                    updatedAt: number;
+                    idempotencyKey: string;
+                    dispatchId: string;
+                    leaseExpiresAt: number;
+                    attemptCount: number;
+                } | null;
+                claim: {
+                    leaseExpiresAt?: number;
+                    owner?: string;
+                    token?: string;
+                    active: boolean;
+                };
+                correlations: {
+                    dispatchId?: string;
+                    claimToken?: string;
+                    runtimeThreadId?: string;
+                    runtimeTurnId?: string;
+                    localTurnId?: string;
+                };
+            }, {
+                threadId: import("convex/values").VString<string, "required">;
+                dispatch: import("convex/values").VUnion<{
+                    startedAt?: number;
+                    completedAt?: number;
+                    claimOwner?: string;
+                    claimToken?: string;
+                    runtimeThreadId?: string;
+                    runtimeTurnId?: string;
+                    failureCode?: string;
+                    failureReason?: string;
+                    cancelledAt?: number;
+                    inputText: string;
+                    status: "completed" | "failed" | "cancelled" | "queued" | "claimed" | "started";
+                    turnId: string;
+                    createdAt: number;
+                    updatedAt: number;
+                    idempotencyKey: string;
+                    dispatchId: string;
+                    leaseExpiresAt: number;
+                    attemptCount: number;
+                } | null, [import("convex/values").VNull<null, "required">, import("convex/values").VObject<{
+                    startedAt?: number;
+                    completedAt?: number;
+                    claimOwner?: string;
+                    claimToken?: string;
+                    runtimeThreadId?: string;
+                    runtimeTurnId?: string;
+                    failureCode?: string;
+                    failureReason?: string;
+                    cancelledAt?: number;
+                    inputText: string;
+                    status: "completed" | "failed" | "cancelled" | "queued" | "claimed" | "started";
+                    turnId: string;
+                    createdAt: number;
+                    updatedAt: number;
+                    idempotencyKey: string;
+                    dispatchId: string;
+                    leaseExpiresAt: number;
+                    attemptCount: number;
+                }, {
+                    dispatchId: import("convex/values").VString<string, "required">;
+                    turnId: import("convex/values").VString<string, "required">;
+                    status: import("convex/values").VUnion<"completed" | "failed" | "cancelled" | "queued" | "claimed" | "started", [import("convex/values").VLiteral<"queued", "required">, import("convex/values").VLiteral<"claimed", "required">, import("convex/values").VLiteral<"started", "required">, import("convex/values").VLiteral<"completed", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"cancelled", "required">], "required", never>;
+                    idempotencyKey: import("convex/values").VString<string, "required">;
+                    inputText: import("convex/values").VString<string, "required">;
+                    claimToken: import("convex/values").VString<string | undefined, "optional">;
+                    claimOwner: import("convex/values").VString<string | undefined, "optional">;
+                    leaseExpiresAt: import("convex/values").VFloat64<number, "required">;
+                    attemptCount: import("convex/values").VFloat64<number, "required">;
+                    runtimeThreadId: import("convex/values").VString<string | undefined, "optional">;
+                    runtimeTurnId: import("convex/values").VString<string | undefined, "optional">;
+                    failureCode: import("convex/values").VString<string | undefined, "optional">;
+                    failureReason: import("convex/values").VString<string | undefined, "optional">;
+                    createdAt: import("convex/values").VFloat64<number, "required">;
+                    updatedAt: import("convex/values").VFloat64<number, "required">;
+                    startedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+                    completedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+                    cancelledAt: import("convex/values").VFloat64<number | undefined, "optional">;
+                }, "required", "inputText" | "status" | "turnId" | "createdAt" | "updatedAt" | "idempotencyKey" | "startedAt" | "completedAt" | "dispatchId" | "claimOwner" | "claimToken" | "leaseExpiresAt" | "attemptCount" | "runtimeThreadId" | "runtimeTurnId" | "failureCode" | "failureReason" | "cancelledAt">], "required", "inputText" | "status" | "turnId" | "createdAt" | "updatedAt" | "idempotencyKey" | "startedAt" | "completedAt" | "dispatchId" | "claimOwner" | "claimToken" | "leaseExpiresAt" | "attemptCount" | "runtimeThreadId" | "runtimeTurnId" | "failureCode" | "failureReason" | "cancelledAt">;
+                claim: import("convex/values").VObject<{
+                    leaseExpiresAt?: number;
+                    owner?: string;
+                    token?: string;
+                    active: boolean;
+                }, {
+                    owner: import("convex/values").VString<string | undefined, "optional">;
+                    token: import("convex/values").VString<string | undefined, "optional">;
+                    leaseExpiresAt: import("convex/values").VFloat64<number | undefined, "optional">;
+                    active: import("convex/values").VBoolean<boolean, "required">;
+                }, "required", "active" | "leaseExpiresAt" | "owner" | "token">;
+                runtime: import("convex/values").VObject<{
+                    runtimeThreadId?: string;
+                    runtimeTurnId?: string;
+                    inFlight: boolean;
+                }, {
+                    runtimeThreadId: import("convex/values").VString<string | undefined, "optional">;
+                    runtimeTurnId: import("convex/values").VString<string | undefined, "optional">;
+                    inFlight: import("convex/values").VBoolean<boolean, "required">;
+                }, "required", "runtimeThreadId" | "runtimeTurnId" | "inFlight">;
+                turn: import("convex/values").VObject<{
+                    status?: string;
+                    turnId?: string;
+                }, {
+                    turnId: import("convex/values").VString<string | undefined, "optional">;
+                    status: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "status" | "turnId">;
+                correlations: import("convex/values").VObject<{
+                    dispatchId?: string;
+                    claimToken?: string;
+                    runtimeThreadId?: string;
+                    runtimeTurnId?: string;
+                    localTurnId?: string;
+                }, {
+                    dispatchId: import("convex/values").VString<string | undefined, "optional">;
+                    claimToken: import("convex/values").VString<string | undefined, "optional">;
+                    localTurnId: import("convex/values").VString<string | undefined, "optional">;
+                    runtimeTurnId: import("convex/values").VString<string | undefined, "optional">;
+                    runtimeThreadId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "dispatchId" | "claimToken" | "runtimeThreadId" | "runtimeTurnId" | "localTurnId">;
+            }, "required", "threadId" | "turn" | "runtime" | "dispatch" | "claim" | "correlations" | "turn.status" | "turn.turnId" | "runtime.runtimeThreadId" | "runtime.runtimeTurnId" | "runtime.inFlight" | "dispatch.inputText" | "dispatch.status" | "dispatch.turnId" | "dispatch.createdAt" | "dispatch.updatedAt" | "dispatch.idempotencyKey" | "dispatch.startedAt" | "dispatch.completedAt" | "dispatch.dispatchId" | "dispatch.claimOwner" | "dispatch.claimToken" | "dispatch.leaseExpiresAt" | "dispatch.attemptCount" | "dispatch.runtimeThreadId" | "dispatch.runtimeTurnId" | "dispatch.failureCode" | "dispatch.failureReason" | "dispatch.cancelledAt" | "claim.active" | "claim.leaseExpiresAt" | "claim.owner" | "claim.token" | "correlations.dispatchId" | "correlations.claimToken" | "correlations.runtimeThreadId" | "correlations.runtimeTurnId" | "correlations.localTurnId">;
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                dispatchId?: string;
+                turnId?: string;
+            }) => Promise<{
+                threadId: string;
+                dispatch: import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["dispatch"]["getTurnDispatchState"]>;
+                claim: {
+                    owner?: string;
+                    token?: string;
+                    leaseExpiresAt?: number;
+                    active: boolean;
+                };
+                runtime: {
+                    runtimeThreadId?: string;
+                    runtimeTurnId?: string;
+                    inFlight: boolean;
+                };
+                turn: {
+                    turnId?: string;
+                    status?: string;
+                };
+                correlations: {
+                    dispatchId?: string;
+                    claimToken?: string;
+                    localTurnId?: string;
+                    runtimeTurnId?: string;
+                    runtimeThreadId?: string;
+                };
+            }>;
+        };
+        validateHostWiring: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string | undefined, "optional">;
+            };
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId?: string;
+            }) => Promise<{
+                ok: boolean;
+                checks: {
+                    name: string;
+                    ok: boolean;
+                    error?: string;
+                }[];
+            }>;
+        };
+        getTurnDispatchState: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+                dispatchId: import("convex/values").VString<string | undefined, "optional">;
+                turnId: import("convex/values").VString<string | undefined, "optional">;
+            };
+            returns: import("convex/values").VUnion<{
+                startedAt?: number;
+                completedAt?: number;
+                claimOwner?: string;
+                claimToken?: string;
+                runtimeThreadId?: string;
+                runtimeTurnId?: string;
+                failureCode?: string;
+                failureReason?: string;
+                cancelledAt?: number;
+                inputText: string;
+                status: "completed" | "failed" | "cancelled" | "queued" | "claimed" | "started";
+                turnId: string;
+                createdAt: number;
+                updatedAt: number;
+                idempotencyKey: string;
+                dispatchId: string;
+                leaseExpiresAt: number;
+                attemptCount: number;
+            } | null, [import("convex/values").VNull<null, "required">, import("convex/values").VObject<{
+                startedAt?: number;
+                completedAt?: number;
+                claimOwner?: string;
+                claimToken?: string;
+                runtimeThreadId?: string;
+                runtimeTurnId?: string;
+                failureCode?: string;
+                failureReason?: string;
+                cancelledAt?: number;
+                inputText: string;
+                status: "completed" | "failed" | "cancelled" | "queued" | "claimed" | "started";
+                turnId: string;
+                createdAt: number;
+                updatedAt: number;
+                idempotencyKey: string;
+                dispatchId: string;
+                leaseExpiresAt: number;
+                attemptCount: number;
+            }, {
+                dispatchId: import("convex/values").VString<string, "required">;
+                turnId: import("convex/values").VString<string, "required">;
+                status: import("convex/values").VUnion<"completed" | "failed" | "cancelled" | "queued" | "claimed" | "started", [import("convex/values").VLiteral<"queued", "required">, import("convex/values").VLiteral<"claimed", "required">, import("convex/values").VLiteral<"started", "required">, import("convex/values").VLiteral<"completed", "required">, import("convex/values").VLiteral<"failed", "required">, import("convex/values").VLiteral<"cancelled", "required">], "required", never>;
+                idempotencyKey: import("convex/values").VString<string, "required">;
+                inputText: import("convex/values").VString<string, "required">;
+                claimToken: import("convex/values").VString<string | undefined, "optional">;
+                claimOwner: import("convex/values").VString<string | undefined, "optional">;
+                leaseExpiresAt: import("convex/values").VFloat64<number, "required">;
+                attemptCount: import("convex/values").VFloat64<number, "required">;
+                runtimeThreadId: import("convex/values").VString<string | undefined, "optional">;
+                runtimeTurnId: import("convex/values").VString<string | undefined, "optional">;
+                failureCode: import("convex/values").VString<string | undefined, "optional">;
+                failureReason: import("convex/values").VString<string | undefined, "optional">;
+                createdAt: import("convex/values").VFloat64<number, "required">;
+                updatedAt: import("convex/values").VFloat64<number, "required">;
+                startedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+                completedAt: import("convex/values").VFloat64<number | undefined, "optional">;
+                cancelledAt: import("convex/values").VFloat64<number | undefined, "optional">;
+            }, "required", "inputText" | "status" | "turnId" | "createdAt" | "updatedAt" | "idempotencyKey" | "startedAt" | "completedAt" | "dispatchId" | "claimOwner" | "claimToken" | "leaseExpiresAt" | "attemptCount" | "runtimeThreadId" | "runtimeTurnId" | "failureCode" | "failureReason" | "cancelledAt">], "required", "inputText" | "status" | "turnId" | "createdAt" | "updatedAt" | "idempotencyKey" | "startedAt" | "completedAt" | "dispatchId" | "claimOwner" | "claimToken" | "leaseExpiresAt" | "attemptCount" | "runtimeThreadId" | "runtimeTurnId" | "failureCode" | "failureReason" | "cancelledAt">;
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+                dispatchId?: string;
+                turnId?: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["dispatch"]["getTurnDispatchState"]>>;
+        };
+        threadSnapshot: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+            };
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+            }) => Promise<import("convex/server").FunctionReturnType<ExtractCodexHostComponentRefs<Components>["threads"]["getState"]>>;
+        };
+        persistenceStats: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+            };
+            returns: import("convex/values").VObject<{
+                deltaCount: number;
+                streamCount: number;
+                latestCursorByStream: {
+                    cursor: number;
+                    streamId: string;
+                }[];
+            }, {
+                streamCount: import("convex/values").VFloat64<number, "required">;
+                deltaCount: import("convex/values").VFloat64<number, "required">;
+                latestCursorByStream: import("convex/values").VArray<{
+                    cursor: number;
+                    streamId: string;
+                }[], import("convex/values").VObject<{
+                    cursor: number;
+                    streamId: string;
+                }, {
+                    streamId: import("convex/values").VString<string, "required">;
+                    cursor: import("convex/values").VFloat64<number, "required">;
+                }, "required", "cursor" | "streamId">, "required">;
+            }, "required", "deltaCount" | "streamCount" | "latestCursorByStream">;
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+            }) => Promise<{
+                streamCount: number;
+                deltaCount: number;
+                latestCursorByStream: Array<{
+                    streamId: string;
+                    cursor: number;
+                }>;
+            }>;
+        };
+        durableHistoryStats: {
+            args: {
+                actor: import("convex/values").VObject<{
+                    userId?: string;
+                }, {
+                    userId: import("convex/values").VString<string | undefined, "optional">;
+                }, "required", "userId">;
+                threadId: import("convex/values").VString<string, "required">;
+            };
+            returns: import("convex/values").VObject<{
+                messageCountInPage: number;
+                latest: {
+                    text: string;
+                    role: string;
+                    status: string;
+                    turnId: string;
+                    messageId: string;
+                }[];
+            }, {
+                messageCountInPage: import("convex/values").VFloat64<number, "required">;
+                latest: import("convex/values").VArray<{
+                    text: string;
+                    role: string;
+                    status: string;
+                    turnId: string;
+                    messageId: string;
+                }[], import("convex/values").VObject<{
+                    text: string;
+                    role: string;
+                    status: string;
+                    turnId: string;
+                    messageId: string;
+                }, {
+                    messageId: import("convex/values").VString<string, "required">;
+                    turnId: import("convex/values").VString<string, "required">;
+                    role: import("convex/values").VString<string, "required">;
+                    status: import("convex/values").VString<string, "required">;
+                    text: import("convex/values").VString<string, "required">;
+                }, "required", "text" | "role" | "status" | "turnId" | "messageId">, "required">;
+            }, "required", "messageCountInPage" | "latest">;
+            handler: (ctx: HostQueryRunner, args: {
+                actor: HostActorContext;
+                threadId: string;
+            }) => Promise<{
+                messageCountInPage: number;
+                latest: {
+                    messageId: string;
+                    turnId: string;
+                    role: string;
+                    status: string;
+                    text: string;
+                }[];
+            }>;
+        };
+    };
+};
+type CodexHostSliceDefinitions = ReturnType<typeof defineCodexHostSlice>;
+type PickRequiredKeys<T, Keys extends keyof T> = {
+    [K in Keys]-?: T[K];
+};
+type DispatchManagedMutationKeys = (typeof HOST_SURFACE_MANIFEST.dispatchManaged.mutations)[number];
+type DispatchManagedQueryKeys = (typeof HOST_SURFACE_MANIFEST.dispatchManaged.queries)[number];
+type RuntimeOwnedMutationKeys = (typeof HOST_SURFACE_MANIFEST.runtimeOwned.mutations)[number];
+type RuntimeOwnedQueryKeys = (typeof HOST_SURFACE_MANIFEST.runtimeOwned.queries)[number];
+export type DispatchManagedHostDefinitions = {
+    profile: "dispatchManaged";
+    mutations: PickRequiredKeys<CodexHostSliceDefinitions["mutations"], DispatchManagedMutationKeys>;
+    queries: PickRequiredKeys<CodexHostSliceDefinitions["queries"], DispatchManagedQueryKeys>;
+};
+export type RuntimeOwnedHostDefinitions = {
+    profile: "runtimeOwned";
+    mutations: PickRequiredKeys<CodexHostSliceDefinitions["mutations"], RuntimeOwnedMutationKeys>;
+    queries: PickRequiredKeys<CodexHostSliceDefinitions["queries"], RuntimeOwnedQueryKeys>;
+};
+export type DefineDispatchManagedHostSliceOptions<Components extends CodexHostComponentsInput = CodexHostComponentsInput> = Pick<DefineCodexHostSliceOptions<Components>, "components" | "serverActor">;
+export type DefineRuntimeOwnedHostSliceOptions<Components extends CodexHostComponentsInput = CodexHostComponentsInput> = Pick<DefineCodexHostSliceOptions<Components>, "components" | "serverActor">;
+export declare function defineDispatchManagedHostSlice<Components extends CodexHostComponentsInput>(options: DefineDispatchManagedHostSliceOptions<Components>): DispatchManagedHostDefinitions;
+export declare function defineRuntimeOwnedHostSlice<Components extends CodexHostComponentsInput>(options: DefineRuntimeOwnedHostSliceOptions<Components>): RuntimeOwnedHostDefinitions;
+export {};
+//# sourceMappingURL=convexPreset.d.ts.map