@wardby/cli 0.5.2 → 0.6.0

package/dist/native-worker/protocol.d.ts

@@ -0,0 +1,744 @@
+/**
+ * The native sandbox worker contract, version 1 (docs/private native sandbox
+ * plan, phase 2). The worker runs the unchanged NativeEngine; everything it
+ * needs from outside — model calls, built-in tools, privileged sandbox
+ * bridges, progress, streamed text, and the terminal result — is a call to the
+ * trusted gateway. The worker is untrusted: the gateway validates every
+ * request against these schemas, and nothing in WorkerInput can carry a
+ * secret value or a credential.
+ *
+ * Transport-neutral: the same messages travel in-process (loopback), over a
+ * child process's stdio, and (phase 3) over HTTP.
+ */
+import { z } from "zod";
+export declare const NATIVE_WORKER_PROTOCOL_VERSION = 1;
+/** Above the sandbox's 12 MiB bridge-result cap, plus envelope. */
+export declare const MAX_MESSAGE_BYTES: number;
+export type ProtocolErrorCode = "unsupported_protocol_version" | "message_too_large" | "message_not_json" | "message_invalid";
+export declare class ProtocolError extends Error {
+    readonly code: ProtocolErrorCode;
+    constructor(code: ProtocolErrorCode, message?: string);
+}
+/** Errors the gateway returns for a call; the worker treats them as final for that call. */
+export type GatewayErrorCode = 
+/** The run is no longer pending/running, or its task was cancelled: stop. */
+"run_not_drivable"
+/** This callId was already used for a call that is still in flight or not replayable. */
+ | "duplicate_call"
+/** A name the run is not allowed to use (unknown tool, bridge, or built-in). */
+ | "not_allowed" | "invalid_request"
+/** A privileged bridge failed; `message` is what the tool sees, as in-process. */
+ | "bridge_error"
+/** The run's budget cannot cover another model call (the gateway's reservation was refused). */
+ | "budget_exhausted"
+/** The worker's network isolation is not proven yet: retry shortly. */
+ | "not_ready" | "internal";
+export declare class GatewayError extends Error {
+    readonly code: GatewayErrorCode;
+    constructor(code: GatewayErrorCode, message: string);
+}
+export declare const LlmRequestSchema: z.ZodObject<{
+    model: z.ZodString;
+    messages: z.ZodArray<z.ZodObject<{
+        role: z.ZodEnum<["system", "user", "assistant", "tool"]>;
+        content: z.ZodString;
+        toolCallId: z.ZodOptional<z.ZodString>;
+        name: z.ZodOptional<z.ZodString>;
+        toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            argsJson: z.ZodString;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            id: string;
+            argsJson: string;
+        }, {
+            name: string;
+            id: string;
+            argsJson: string;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        content: string;
+        role: "system" | "user" | "assistant" | "tool";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
+        toolCalls?: {
+            name: string;
+            id: string;
+            argsJson: string;
+        }[] | undefined;
+    }, {
+        content: string;
+        role: "system" | "user" | "assistant" | "tool";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
+        toolCalls?: {
+            name: string;
+            id: string;
+            argsJson: string;
+        }[] | undefined;
+    }>, "many">;
+    tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }, {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }>, "many">>;
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    stopSequences: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "xhigh", "max"]>>;
+}, "strict", z.ZodTypeAny, {
+    model: string;
+    messages: {
+        content: string;
+        role: "system" | "user" | "assistant" | "tool";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
+        toolCalls?: {
+            name: string;
+            id: string;
+            argsJson: string;
+        }[] | undefined;
+    }[];
+    effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    tools?: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }[] | undefined;
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    stopSequences?: string[] | undefined;
+}, {
+    model: string;
+    messages: {
+        content: string;
+        role: "system" | "user" | "assistant" | "tool";
+        name?: string | undefined;
+        toolCallId?: string | undefined;
+        toolCalls?: {
+            name: string;
+            id: string;
+            argsJson: string;
+        }[] | undefined;
+    }[];
+    effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+    tools?: {
+        name: string;
+        description: string;
+        parameters: Record<string, unknown>;
+    }[] | undefined;
+    temperature?: number | undefined;
+    maxTokens?: number | undefined;
+    stopSequences?: string[] | undefined;
+}>;
+export declare const LlmStreamEventSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    delta: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    type: "text";
+    delta: string;
+}, {
+    type: "text";
+    delta: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"tool_call">;
+    id: z.ZodString;
+    name: z.ZodString;
+    argsJson: z.ZodString;
+}, "strict", z.ZodTypeAny, {
+    name: string;
+    type: "tool_call";
+    id: string;
+    argsJson: string;
+}, {
+    name: string;
+    type: "tool_call";
+    id: string;
+    argsJson: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"done">;
+    stopReason: z.ZodString;
+    usage: z.ZodObject<{
+        inputTokens: z.ZodNumber;
+        outputTokens: z.ZodNumber;
+        cachedInputTokens: z.ZodOptional<z.ZodNumber>;
+        cacheWriteTokens: z.ZodOptional<z.ZodNumber>;
+        costUsd: z.ZodNumber;
+    }, "strict", z.ZodTypeAny, {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheWriteTokens?: number | undefined;
+        cachedInputTokens?: number | undefined;
+    }, {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheWriteTokens?: number | undefined;
+        cachedInputTokens?: number | undefined;
+    }>;
+}, "strict", z.ZodTypeAny, {
+    type: "done";
+    usage: {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheWriteTokens?: number | undefined;
+        cachedInputTokens?: number | undefined;
+    };
+    stopReason: string;
+}, {
+    type: "done";
+    usage: {
+        costUsd: number;
+        inputTokens: number;
+        outputTokens: number;
+        cacheWriteTokens?: number | undefined;
+        cachedInputTokens?: number | undefined;
+    };
+    stopReason: string;
+}>]>;
+/** Everything the worker is given, once, at start. No secret values and no credentials. */
+export declare const WorkerInputSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    agent: z.ZodObject<{
+        systemPrompt: z.ZodString;
+        model: z.ZodString;
+        budgetUsd: z.ZodNumber;
+        maxTurns: z.ZodNumber;
+        effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "xhigh", "max"]>>;
+        untrustedContext: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        model: string;
+        budgetUsd: number;
+        maxTurns: number;
+        systemPrompt: string;
+        effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+        untrustedContext?: string | undefined;
+    }, {
+        model: string;
+        budgetUsd: number;
+        maxTurns: number;
+        systemPrompt: string;
+        effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+        untrustedContext?: string | undefined;
+    }>;
+    tools: z.ZodArray<z.ZodObject<{
+        name: z.ZodString;
+        description: z.ZodString;
+        jsonSchema: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        description: string;
+        jsonSchema: Record<string, unknown>;
+    }, {
+        name: string;
+        description: string;
+        jsonSchema: Record<string, unknown>;
+    }>, "many">;
+    /** Names the gateway serves (memory, repo_*, jira_*, sub-agent memory, delegate_to_*). */
+    builtinTools: z.ZodArray<z.ZodString, "many">;
+    /** User tools the worker runs itself, by name. */
+    userTools: z.ZodRecord<z.ZodString, z.ZodObject<{
+        code: z.ZodString;
+        paramsZod: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        code: string;
+        paramsZod: string;
+    }, {
+        code: string;
+        paramsZod: string;
+    }>>;
+    /** Tool names whose calls in one turn may run at the same time (delegations, when opted in). */
+    runsConcurrently: z.ZodArray<z.ZodString, "many">;
+    /** The run's pinned catalog entry, so the engine's local budget checks price without a network call. */
+    pricing: z.ZodObject<{
+        provider: z.ZodString;
+        modelId: z.ZodString;
+        encoding: z.ZodEnum<["cl100k_base", "o200k_base"]>;
+        inputPerMTok: z.ZodNumber;
+        outputPerMTok: z.ZodNumber;
+        cachedInputPerMTok: z.ZodNumber;
+        cacheWritePerMTok: z.ZodNumber;
+        efforts: z.ZodArray<z.ZodEnum<["low", "medium", "high", "xhigh", "max"]>, "many">;
+        thinkingMode: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        provider: string;
+        modelId: string;
+        encoding: "cl100k_base" | "o200k_base";
+        inputPerMTok: number;
+        outputPerMTok: number;
+        cachedInputPerMTok: number;
+        cacheWritePerMTok: number;
+        efforts: ("low" | "medium" | "high" | "xhigh" | "max")[];
+        thinkingMode: string;
+    }, {
+        provider: string;
+        modelId: string;
+        encoding: "cl100k_base" | "o200k_base";
+        inputPerMTok: number;
+        outputPerMTok: number;
+        cachedInputPerMTok: number;
+        cacheWritePerMTok: number;
+        efforts: ("low" | "medium" | "high" | "xhigh" | "max")[];
+        thinkingMode: string;
+    }>;
+    /**
+     * Where and how to reach the HTTP gateway. Absent: the gateway is on this process's stdio.
+     * The capability is given once, here, on the worker's stdin; it is never in its environment,
+     * argv, or the server's stored snapshot (only its hash is stored).
+     */
+    gateway: z.ZodOptional<z.ZodObject<{
+        url: z.ZodString;
+        capability: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        url: string;
+        capability: string;
+    }, {
+        url: string;
+        capability: string;
+    }>>;
+}, "strict", z.ZodTypeAny, {
+    runId: string;
+    agent: {
+        model: string;
+        budgetUsd: number;
+        maxTurns: number;
+        systemPrompt: string;
+        effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+        untrustedContext?: string | undefined;
+    };
+    tools: {
+        name: string;
+        description: string;
+        jsonSchema: Record<string, unknown>;
+    }[];
+    v: 1;
+    builtinTools: string[];
+    userTools: Record<string, {
+        code: string;
+        paramsZod: string;
+    }>;
+    runsConcurrently: string[];
+    pricing: {
+        provider: string;
+        modelId: string;
+        encoding: "cl100k_base" | "o200k_base";
+        inputPerMTok: number;
+        outputPerMTok: number;
+        cachedInputPerMTok: number;
+        cacheWritePerMTok: number;
+        efforts: ("low" | "medium" | "high" | "xhigh" | "max")[];
+        thinkingMode: string;
+    };
+    gateway?: {
+        url: string;
+        capability: string;
+    } | undefined;
+}, {
+    runId: string;
+    agent: {
+        model: string;
+        budgetUsd: number;
+        maxTurns: number;
+        systemPrompt: string;
+        effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+        untrustedContext?: string | undefined;
+    };
+    tools: {
+        name: string;
+        description: string;
+        jsonSchema: Record<string, unknown>;
+    }[];
+    v: 1;
+    builtinTools: string[];
+    userTools: Record<string, {
+        code: string;
+        paramsZod: string;
+    }>;
+    runsConcurrently: string[];
+    pricing: {
+        provider: string;
+        modelId: string;
+        encoding: "cl100k_base" | "o200k_base";
+        inputPerMTok: number;
+        outputPerMTok: number;
+        cachedInputPerMTok: number;
+        cacheWritePerMTok: number;
+        efforts: ("low" | "medium" | "high" | "xhigh" | "max")[];
+        thinkingMode: string;
+    };
+    gateway?: {
+        url: string;
+        capability: string;
+    } | undefined;
+}>;
+export type WorkerInput = z.infer<typeof WorkerInputSchema>;
+/** Each gateway method and its params. */
+export declare const GatewayParamsSchemas: {
+    readonly "llm.stream": z.ZodObject<{
+        request: z.ZodObject<{
+            model: z.ZodString;
+            messages: z.ZodArray<z.ZodObject<{
+                role: z.ZodEnum<["system", "user", "assistant", "tool"]>;
+                content: z.ZodString;
+                toolCallId: z.ZodOptional<z.ZodString>;
+                name: z.ZodOptional<z.ZodString>;
+                toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    name: z.ZodString;
+                    argsJson: z.ZodString;
+                }, "strict", z.ZodTypeAny, {
+                    name: string;
+                    id: string;
+                    argsJson: string;
+                }, {
+                    name: string;
+                    id: string;
+                    argsJson: string;
+                }>, "many">>;
+            }, "strict", z.ZodTypeAny, {
+                content: string;
+                role: "system" | "user" | "assistant" | "tool";
+                name?: string | undefined;
+                toolCallId?: string | undefined;
+                toolCalls?: {
+                    name: string;
+                    id: string;
+                    argsJson: string;
+                }[] | undefined;
+            }, {
+                content: string;
+                role: "system" | "user" | "assistant" | "tool";
+                name?: string | undefined;
+                toolCallId?: string | undefined;
+                toolCalls?: {
+                    name: string;
+                    id: string;
+                    argsJson: string;
+                }[] | undefined;
+            }>, "many">;
+            tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                name: z.ZodString;
+                description: z.ZodString;
+                parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+            }, "strict", z.ZodTypeAny, {
+                name: string;
+                description: string;
+                parameters: Record<string, unknown>;
+            }, {
+                name: string;
+                description: string;
+                parameters: Record<string, unknown>;
+            }>, "many">>;
+            maxTokens: z.ZodOptional<z.ZodNumber>;
+            temperature: z.ZodOptional<z.ZodNumber>;
+            stopSequences: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            effort: z.ZodOptional<z.ZodEnum<["low", "medium", "high", "xhigh", "max"]>>;
+        }, "strict", z.ZodTypeAny, {
+            model: string;
+            messages: {
+                content: string;
+                role: "system" | "user" | "assistant" | "tool";
+                name?: string | undefined;
+                toolCallId?: string | undefined;
+                toolCalls?: {
+                    name: string;
+                    id: string;
+                    argsJson: string;
+                }[] | undefined;
+            }[];
+            effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+            tools?: {
+                name: string;
+                description: string;
+                parameters: Record<string, unknown>;
+            }[] | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            stopSequences?: string[] | undefined;
+        }, {
+            model: string;
+            messages: {
+                content: string;
+                role: "system" | "user" | "assistant" | "tool";
+                name?: string | undefined;
+                toolCallId?: string | undefined;
+                toolCalls?: {
+                    name: string;
+                    id: string;
+                    argsJson: string;
+                }[] | undefined;
+            }[];
+            effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+            tools?: {
+                name: string;
+                description: string;
+                parameters: Record<string, unknown>;
+            }[] | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            stopSequences?: string[] | undefined;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        request: {
+            model: string;
+            messages: {
+                content: string;
+                role: "system" | "user" | "assistant" | "tool";
+                name?: string | undefined;
+                toolCallId?: string | undefined;
+                toolCalls?: {
+                    name: string;
+                    id: string;
+                    argsJson: string;
+                }[] | undefined;
+            }[];
+            effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+            tools?: {
+                name: string;
+                description: string;
+                parameters: Record<string, unknown>;
+            }[] | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            stopSequences?: string[] | undefined;
+        };
+    }, {
+        request: {
+            model: string;
+            messages: {
+                content: string;
+                role: "system" | "user" | "assistant" | "tool";
+                name?: string | undefined;
+                toolCallId?: string | undefined;
+                toolCalls?: {
+                    name: string;
+                    id: string;
+                    argsJson: string;
+                }[] | undefined;
+            }[];
+            effort?: "low" | "medium" | "high" | "xhigh" | "max" | undefined;
+            tools?: {
+                name: string;
+                description: string;
+                parameters: Record<string, unknown>;
+            }[] | undefined;
+            temperature?: number | undefined;
+            maxTokens?: number | undefined;
+            stopSequences?: string[] | undefined;
+        };
+    }>;
+    readonly "llm.countTokens": z.ZodObject<{
+        model: z.ZodString;
+        messages: z.ZodArray<z.ZodObject<{
+            role: z.ZodEnum<["system", "user", "assistant", "tool"]>;
+            content: z.ZodString;
+            toolCallId: z.ZodOptional<z.ZodString>;
+            name: z.ZodOptional<z.ZodString>;
+            toolCalls: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                argsJson: z.ZodString;
+            }, "strict", z.ZodTypeAny, {
+                name: string;
+                id: string;
+                argsJson: string;
+            }, {
+                name: string;
+                id: string;
+                argsJson: string;
+            }>, "many">>;
+        }, "strict", z.ZodTypeAny, {
+            content: string;
+            role: "system" | "user" | "assistant" | "tool";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                argsJson: string;
+            }[] | undefined;
+        }, {
+            content: string;
+            role: "system" | "user" | "assistant" | "tool";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                argsJson: string;
+            }[] | undefined;
+        }>, "many">;
+        tools: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            name: z.ZodString;
+            description: z.ZodString;
+            parameters: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        }, "strict", z.ZodTypeAny, {
+            name: string;
+            description: string;
+            parameters: Record<string, unknown>;
+        }, {
+            name: string;
+            description: string;
+            parameters: Record<string, unknown>;
+        }>, "many">>;
+    }, "strict", z.ZodTypeAny, {
+        model: string;
+        messages: {
+            content: string;
+            role: "system" | "user" | "assistant" | "tool";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                argsJson: string;
+            }[] | undefined;
+        }[];
+        tools?: {
+            name: string;
+            description: string;
+            parameters: Record<string, unknown>;
+        }[] | undefined;
+    }, {
+        model: string;
+        messages: {
+            content: string;
+            role: "system" | "user" | "assistant" | "tool";
+            name?: string | undefined;
+            toolCallId?: string | undefined;
+            toolCalls?: {
+                name: string;
+                id: string;
+                argsJson: string;
+            }[] | undefined;
+        }[];
+        tools?: {
+            name: string;
+            description: string;
+            parameters: Record<string, unknown>;
+        }[] | undefined;
+    }>;
+    readonly "builtin.call": z.ZodObject<{
+        name: z.ZodString;
+        argsJson: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        name: string;
+        argsJson: string;
+    }, {
+        name: string;
+        argsJson: string;
+    }>;
+    /** `invocation` names one tool call, so its bridges share one privileged host (secret redaction is per call). */
+    readonly "host.call": z.ZodObject<{
+        tool: z.ZodString;
+        invocation: z.ZodString;
+        bridge: z.ZodString;
+        argsJson: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        tool: string;
+        bridge: string;
+        argsJson: string;
+        invocation: string;
+    }, {
+        tool: string;
+        bridge: string;
+        argsJson: string;
+        invocation: string;
+    }>;
+    readonly progress: z.ZodObject<{
+        turns: z.ZodNumber;
+        usage: z.ZodObject<{
+            tokensIn: z.ZodNumber;
+            tokensOut: z.ZodNumber;
+            costUsd: z.ZodNumber;
+        }, "strict", z.ZodTypeAny, {
+            tokensIn: number;
+            tokensOut: number;
+            costUsd: number;
+        }, {
+            tokensIn: number;
+            tokensOut: number;
+            costUsd: number;
+        }>;
+    }, "strict", z.ZodTypeAny, {
+        usage: {
+            tokensIn: number;
+            tokensOut: number;
+            costUsd: number;
+        };
+        turns: number;
+    }, {
+        usage: {
+            tokensIn: number;
+            tokensOut: number;
+            costUsd: number;
+        };
+        turns: number;
+    }>;
+    readonly text: z.ZodObject<{
+        seq: z.ZodNumber;
+        delta: z.ZodString;
+    }, "strict", z.ZodTypeAny, {
+        delta: string;
+        seq: number;
+    }, {
+        delta: string;
+        seq: number;
+    }>;
+    readonly finish: z.ZodObject<{
+        status: z.ZodEnum<["succeeded", "budget_exhausted", "refused", "failed"]>;
+        finalText: z.ZodString;
+        turns: z.ZodNumber;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strict", z.ZodTypeAny, {
+        status: "failed" | "budget_exhausted" | "succeeded" | "refused";
+        finalText: string;
+        turns: number;
+        error?: string | undefined;
+    }, {
+        status: "failed" | "budget_exhausted" | "succeeded" | "refused";
+        finalText: string;
+        turns: number;
+        error?: string | undefined;
+    }>;
+};
+export type GatewayMethod = keyof typeof GatewayParamsSchemas;
+export type GatewayParams<M extends GatewayMethod> = z.infer<(typeof GatewayParamsSchemas)[M]>;
+export declare const GatewayRequestSchema: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    runId: z.ZodString;
+    callId: z.ZodString;
+    method: z.ZodEnum<["text" | "finish" | "llm.stream" | "llm.countTokens" | "builtin.call" | "host.call" | "progress", ...("text" | "finish" | "llm.stream" | "llm.countTokens" | "builtin.call" | "host.call" | "progress")[]]>;
+    params: z.ZodUnknown;
+}, "strict", z.ZodTypeAny, {
+    runId: string;
+    method: "text" | "finish" | "llm.stream" | "llm.countTokens" | "builtin.call" | "host.call" | "progress";
+    v: 1;
+    callId: string;
+    params?: unknown;
+}, {
+    runId: string;
+    method: "text" | "finish" | "llm.stream" | "llm.countTokens" | "builtin.call" | "host.call" | "progress";
+    v: 1;
+    callId: string;
+    params?: unknown;
+}>;
+export type GatewayRequest = z.infer<typeof GatewayRequestSchema>;
+/** Rejects before parsing a message too large to accept. */
+export declare function assertMessageSize(text: string): void;
+/** Parses a JSON message text with the size cap, version check, and schema. */
+export declare function parseMessage<T>(text: string, schema: z.ZodType<T>): T;
+/** A gateway request's params, validated for its method. */
+export declare function parseParams<M extends GatewayMethod>(method: M, params: unknown): GatewayParams<M>;