@theowlops/boombot 0.0.0-stage → 1.1.1

package/dist/node_modules/@boombot/protocol/gateway-protocol/commands.d.ts

@@ -0,0 +1,4349 @@
+import { z } from "zod";
+import type { Envelope } from "./envelope.js";
+/**
+ * Typed command schemas for every command the web UI (phase 1) needs.
+ *
+ * Each command definition carries a literal `type`, a zod `payload` schema
+ * (what the client sends inside the envelope) and a zod `response` schema
+ * (what the gateway returns inside the response envelope).
+ *
+ * Wire-evolution rule (additive-first): payloads and responses only ever gain
+ * OPTIONAL fields. Unknown fields are stripped, never rejected, so a newer
+ * server can talk to an older client within the same wire version.
+ */
+/**
+ * Provider kind on the wire. Accepts any non-empty string — the gateway's
+ * provider service validates it against the live profile registry (built-ins
+ * plus user-defined custom providers from `custom-providers.json`), so the
+ * wire schema stays permissive while the service stays strict.
+ */
+export declare const providerKindSchema: z.ZodString;
+/** Per-model reasoning knobs. Each wire protocol maps them its own way. */
+export declare const reasoningProfileSchema: z.ZodObject<{
+    /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+    effort: z.ZodOptional<z.ZodString>;
+    /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+    budgetTokens: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    effort?: string | undefined;
+    budgetTokens?: number | undefined;
+}, {
+    effort?: string | undefined;
+    budgetTokens?: number | undefined;
+}>;
+/**
+ * Request profile: per-request overrides merged in three tiers —
+ * kind defaults < provider.extra < per-model override. Stored in
+ * providers.json, applied by the gateway when building provider requests.
+ */
+export declare const requestProfileSchema: z.ZodObject<{
+    maxTokens: z.ZodOptional<z.ZodNumber>;
+    temperature: z.ZodOptional<z.ZodNumber>;
+    topP: z.ZodOptional<z.ZodNumber>;
+    /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    /** Extra top-level fields merged into the JSON request body. */
+    extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    reasoning: z.ZodOptional<z.ZodObject<{
+        /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+        effort: z.ZodOptional<z.ZodString>;
+        /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+        budgetTokens: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        effort?: string | undefined;
+        budgetTokens?: number | undefined;
+    }, {
+        effort?: string | undefined;
+        budgetTokens?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+    topP?: number | undefined;
+    headers?: Record<string, string> | undefined;
+    extraBody?: Record<string, unknown> | undefined;
+    reasoning?: {
+        effort?: string | undefined;
+        budgetTokens?: number | undefined;
+    } | undefined;
+}, {
+    maxTokens?: number | undefined;
+    temperature?: number | undefined;
+    topP?: number | undefined;
+    headers?: Record<string, string> | undefined;
+    extraBody?: Record<string, unknown> | undefined;
+    reasoning?: {
+        effort?: string | undefined;
+        budgetTokens?: number | undefined;
+    } | undefined;
+}>;
+export declare const providerSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    hasKey: z.ZodBoolean;
+    /** Number of API keys in the provider's KeyRoulette ring. */
+    keyCount: z.ZodNumber;
+    /** Key-rotation cursor: index of the ring entry tried first (operational state). */
+    keyCursor: z.ZodOptional<z.ZodNumber>;
+    active: z.ZodBoolean;
+    /** Default chat model for turns. Never overwritten by probe discovery. */
+    model: z.ZodOptional<z.ZodString>;
+    models: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Provider-level request profile (tier 2 of 3). */
+    extra: z.ZodOptional<z.ZodObject<{
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+        /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Extra top-level fields merged into the JSON request body. */
+        extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        reasoning: z.ZodOptional<z.ZodObject<{
+            /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+            effort: z.ZodOptional<z.ZodString>;
+            /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+            budgetTokens: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        }, {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }>>;
+    /** Per-model request profile overrides (tier 3 of 3), keyed by model id. */
+    modelProfiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+        /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Extra top-level fields merged into the JSON request body. */
+        extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        reasoning: z.ZodOptional<z.ZodObject<{
+            /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+            effort: z.ZodOptional<z.ZodString>;
+            /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+            budgetTokens: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        }, {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }>>>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    kind: string;
+    hasKey: boolean;
+    keyCount: number;
+    active: boolean;
+    model?: string | undefined;
+    baseUrl?: string | undefined;
+    keyCursor?: number | undefined;
+    models?: string[] | undefined;
+    extra?: {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    } | undefined;
+    modelProfiles?: Record<string, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }> | undefined;
+}, {
+    name: string;
+    id: string;
+    kind: string;
+    hasKey: boolean;
+    keyCount: number;
+    active: boolean;
+    model?: string | undefined;
+    baseUrl?: string | undefined;
+    keyCursor?: number | undefined;
+    models?: string[] | undefined;
+    extra?: {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    } | undefined;
+    modelProfiles?: Record<string, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }> | undefined;
+}>;
+/** Provider record as sent by the client on `provider.save`. `apiKey`/`apiKeys` are write-only and never echoed back. */
+export declare const providerInputSchema: z.ZodObject<Omit<{
+    id: z.ZodString;
+    name: z.ZodString;
+    kind: z.ZodString;
+    baseUrl: z.ZodOptional<z.ZodString>;
+    hasKey: z.ZodBoolean;
+    /** Number of API keys in the provider's KeyRoulette ring. */
+    keyCount: z.ZodNumber;
+    /** Key-rotation cursor: index of the ring entry tried first (operational state). */
+    keyCursor: z.ZodOptional<z.ZodNumber>;
+    active: z.ZodBoolean;
+    /** Default chat model for turns. Never overwritten by probe discovery. */
+    model: z.ZodOptional<z.ZodString>;
+    models: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    /** Provider-level request profile (tier 2 of 3). */
+    extra: z.ZodOptional<z.ZodObject<{
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+        /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Extra top-level fields merged into the JSON request body. */
+        extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        reasoning: z.ZodOptional<z.ZodObject<{
+            /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+            effort: z.ZodOptional<z.ZodString>;
+            /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+            budgetTokens: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        }, {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }>>;
+    /** Per-model request profile overrides (tier 3 of 3), keyed by model id. */
+    modelProfiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+        maxTokens: z.ZodOptional<z.ZodNumber>;
+        temperature: z.ZodOptional<z.ZodNumber>;
+        topP: z.ZodOptional<z.ZodNumber>;
+        /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        /** Extra top-level fields merged into the JSON request body. */
+        extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        reasoning: z.ZodOptional<z.ZodObject<{
+            /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+            effort: z.ZodOptional<z.ZodString>;
+            /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+            budgetTokens: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        }, {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }>>>;
+}, "hasKey" | "keyCount" | "keyCursor" | "active"> & {
+    hasKey: z.ZodOptional<z.ZodBoolean>;
+    /** Server default when omitted. */
+    active: z.ZodOptional<z.ZodBoolean>;
+    apiKey: z.ZodOptional<z.ZodString>;
+    /**
+     * Replace the whole key ring. Mutually exclusive with `apiKey`;
+     * omitted = keep stored keys, `[]` = clear.
+     */
+    apiKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    kind: string;
+    model?: string | undefined;
+    baseUrl?: string | undefined;
+    hasKey?: boolean | undefined;
+    active?: boolean | undefined;
+    models?: string[] | undefined;
+    extra?: {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    } | undefined;
+    modelProfiles?: Record<string, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }> | undefined;
+    apiKey?: string | undefined;
+    apiKeys?: string[] | undefined;
+}, {
+    name: string;
+    id: string;
+    kind: string;
+    model?: string | undefined;
+    baseUrl?: string | undefined;
+    hasKey?: boolean | undefined;
+    active?: boolean | undefined;
+    models?: string[] | undefined;
+    extra?: {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    } | undefined;
+    modelProfiles?: Record<string, {
+        maxTokens?: number | undefined;
+        temperature?: number | undefined;
+        topP?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        extraBody?: Record<string, unknown> | undefined;
+        reasoning?: {
+            effort?: string | undefined;
+            budgetTokens?: number | undefined;
+        } | undefined;
+    }> | undefined;
+    apiKey?: string | undefined;
+    apiKeys?: string[] | undefined;
+}>;
+export declare const sessionConfigSnapshotSchema: z.ZodObject<{
+    model: z.ZodOptional<z.ZodString>;
+    provider: z.ZodOptional<z.ZodString>;
+    toolsEnabled: z.ZodNumber;
+    systemPromptHash: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    toolsEnabled: number;
+    systemPromptHash: string;
+    model?: string | undefined;
+    provider?: string | undefined;
+}, {
+    toolsEnabled: number;
+    systemPromptHash: string;
+    model?: string | undefined;
+    provider?: string | undefined;
+}>;
+export declare const sessionSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    messageCount: z.ZodNumber;
+    /** P1-7: point-in-time config serving the session's turns; absent until the first turn. */
+    configSnapshot: z.ZodOptional<z.ZodObject<{
+        model: z.ZodOptional<z.ZodString>;
+        provider: z.ZodOptional<z.ZodString>;
+        toolsEnabled: z.ZodNumber;
+        systemPromptHash: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        toolsEnabled: number;
+        systemPromptHash: string;
+        model?: string | undefined;
+        provider?: string | undefined;
+    }, {
+        toolsEnabled: number;
+        systemPromptHash: string;
+        model?: string | undefined;
+        provider?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    title: string;
+    updatedAt: string;
+    messageCount: number;
+    configSnapshot?: {
+        toolsEnabled: number;
+        systemPromptHash: string;
+        model?: string | undefined;
+        provider?: string | undefined;
+    } | undefined;
+}, {
+    id: string;
+    createdAt: string;
+    title: string;
+    updatedAt: string;
+    messageCount: number;
+    configSnapshot?: {
+        toolsEnabled: number;
+        systemPromptHash: string;
+        model?: string | undefined;
+        provider?: string | undefined;
+    } | undefined;
+}>;
+export declare const messageSchema: z.ZodObject<{
+    id: z.ZodString;
+    role: z.ZodEnum<["user", "assistant", "system", "tool"]>;
+    content: z.ZodString;
+    createdAt: z.ZodString;
+    toolCallId: z.ZodOptional<z.ZodString>;
+    toolName: z.ZodOptional<z.ZodString>;
+    /** P1-6: context checkpoint flag — prompt projection starts here. */
+    isCheckpoint: z.ZodOptional<z.ZodBoolean>;
+    /**
+     * P2-3: active variant index the read resolved to. Present and > 0 when a
+     * variant's content is shown; absent means the base row's content.
+     */
+    variantIndex: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    role: "system" | "user" | "assistant" | "tool";
+    id: string;
+    createdAt: string;
+    content: string;
+    toolName?: string | undefined;
+    toolCallId?: string | undefined;
+    isCheckpoint?: boolean | undefined;
+    variantIndex?: number | undefined;
+}, {
+    role: "system" | "user" | "assistant" | "tool";
+    id: string;
+    createdAt: string;
+    content: string;
+    toolName?: string | undefined;
+    toolCallId?: string | undefined;
+    isCheckpoint?: boolean | undefined;
+    variantIndex?: number | undefined;
+}>;
+/** P2-3: one alternate content stored at a message position. */
+export declare const variantSchema: z.ZodObject<{
+    id: z.ZodString;
+    sessionId: z.ZodString;
+    messageId: z.ZodString;
+    variantIndex: z.ZodNumber;
+    content: z.ZodString;
+    createdAt: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    sessionId: string;
+    content: string;
+    variantIndex: number;
+    messageId: string;
+}, {
+    id: string;
+    createdAt: string;
+    sessionId: string;
+    content: string;
+    variantIndex: number;
+    messageId: string;
+}>;
+export declare const scheduleSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    cron: z.ZodString;
+    prompt: z.ZodString;
+    enabled: z.ZodBoolean;
+    nextRunAt: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    enabled: boolean;
+    name: string;
+    id: string;
+    prompt: string;
+    cron: string;
+    nextRunAt?: string | undefined;
+}, {
+    enabled: boolean;
+    name: string;
+    id: string;
+    prompt: string;
+    cron: string;
+    nextRunAt?: string | undefined;
+}>;
+export declare const memoryHitSchema: z.ZodObject<{
+    id: z.ZodString;
+    excerpt: z.ZodString;
+    score: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    excerpt: string;
+    score: number;
+}, {
+    id: string;
+    excerpt: string;
+    score: number;
+}>;
+export declare const channelSchema: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodString;
+    status: z.ZodEnum<["connected", "disconnected", "error", "pending"]>;
+    displayName: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: string;
+    status: "error" | "pending" | "connected" | "disconnected";
+    displayName: string;
+}, {
+    id: string;
+    kind: string;
+    status: "error" | "pending" | "connected" | "disconnected";
+    displayName: string;
+}>;
+export declare const attachmentSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    mimeType: z.ZodString;
+    sizeBytes: z.ZodNumber;
+    ref: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    name: string;
+    id: string;
+    mimeType: string;
+    sizeBytes: number;
+    ref: string;
+}, {
+    name: string;
+    id: string;
+    mimeType: string;
+    sizeBytes: number;
+    ref: string;
+}>;
+export declare const turnStatusSchema: z.ZodEnum<["queued", "running", "completed", "cancelled", "failed"]>;
+export declare const taskStatusSchema: z.ZodEnum<["queued", "running", "paused", "awaiting_approval", "completed", "failed", "cancelled", "interrupted"]>;
+export declare const taskStepSchema: z.ZodObject<{
+    id: z.ZodString;
+    index: z.ZodNumber;
+    kind: z.ZodLiteral<"turn">;
+    prompt: z.ZodString;
+    status: z.ZodEnum<["pending", "running", "done", "failed", "skipped"]>;
+    attempts: z.ZodNumber;
+    output: z.ZodOptional<z.ZodString>;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    kind: "turn";
+    status: "done" | "running" | "failed" | "pending" | "skipped";
+    prompt: string;
+    attempts: number;
+    index: number;
+    output?: string | undefined;
+    error?: string | undefined;
+}, {
+    id: string;
+    kind: "turn";
+    status: "done" | "running" | "failed" | "pending" | "skipped";
+    prompt: string;
+    attempts: number;
+    index: number;
+    output?: string | undefined;
+    error?: string | undefined;
+}>;
+export declare const taskSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    sessionId: z.ZodOptional<z.ZodString>;
+    status: z.ZodEnum<["queued", "running", "paused", "awaiting_approval", "completed", "failed", "cancelled", "interrupted"]>;
+    steps: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        index: z.ZodNumber;
+        kind: z.ZodLiteral<"turn">;
+        prompt: z.ZodString;
+        status: z.ZodEnum<["pending", "running", "done", "failed", "skipped"]>;
+        attempts: z.ZodNumber;
+        output: z.ZodOptional<z.ZodString>;
+        error: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        id: string;
+        kind: "turn";
+        status: "done" | "running" | "failed" | "pending" | "skipped";
+        prompt: string;
+        attempts: number;
+        index: number;
+        output?: string | undefined;
+        error?: string | undefined;
+    }, {
+        id: string;
+        kind: "turn";
+        status: "done" | "running" | "failed" | "pending" | "skipped";
+        prompt: string;
+        attempts: number;
+        index: number;
+        output?: string | undefined;
+        error?: string | undefined;
+    }>, "many">;
+    currentStepIndex: z.ZodNumber;
+    approval: z.ZodOptional<z.ZodObject<{
+        runId: z.ZodString;
+        toolName: z.ZodString;
+        reason: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        reason: string;
+        runId: string;
+        toolName: string;
+    }, {
+        reason: string;
+        runId: string;
+        toolName: string;
+    }>>;
+    createdAt: z.ZodString;
+    updatedAt: z.ZodString;
+    error: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    id: string;
+    createdAt: string;
+    status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+    steps: {
+        id: string;
+        kind: "turn";
+        status: "done" | "running" | "failed" | "pending" | "skipped";
+        prompt: string;
+        attempts: number;
+        index: number;
+        output?: string | undefined;
+        error?: string | undefined;
+    }[];
+    title: string;
+    updatedAt: string;
+    currentStepIndex: number;
+    error?: string | undefined;
+    sessionId?: string | undefined;
+    approval?: {
+        reason: string;
+        runId: string;
+        toolName: string;
+    } | undefined;
+}, {
+    id: string;
+    createdAt: string;
+    status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+    steps: {
+        id: string;
+        kind: "turn";
+        status: "done" | "running" | "failed" | "pending" | "skipped";
+        prompt: string;
+        attempts: number;
+        index: number;
+        output?: string | undefined;
+        error?: string | undefined;
+    }[];
+    title: string;
+    updatedAt: string;
+    currentStepIndex: number;
+    error?: string | undefined;
+    sessionId?: string | undefined;
+    approval?: {
+        reason: string;
+        runId: string;
+        toolName: string;
+    } | undefined;
+}>;
+/** Inferred wire types for the task runner — single source of truth is taskSchema. */
+export type TaskStatus = z.infer<typeof taskStatusSchema>;
+export type TaskStep = z.infer<typeof taskStepSchema>;
+export type Task = z.infer<typeof taskSchema>;
+export interface CommandDef<TType extends string, TPayload extends z.ZodTypeAny, TResponse extends z.ZodTypeAny> {
+    type: TType;
+    payload: TPayload;
+    response: TResponse;
+}
+/** Every known command type, mapped to its payload/response schemas. */
+export declare const COMMAND_SCHEMAS: {
+    readonly "channel.connect": {
+        type: string;
+        payload: z.ZodUnion<[z.ZodObject<{
+            channel: z.ZodLiteral<"telegram">;
+            botToken: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            channel: "telegram";
+            botToken: string;
+        }, {
+            channel: "telegram";
+            botToken: string;
+        }>, z.ZodObject<{
+            channel: z.ZodLiteral<"zalo">;
+            mode: z.ZodOptional<z.ZodLiteral<"oa">>;
+            appId: z.ZodOptional<z.ZodString>;
+            appSecret: z.ZodOptional<z.ZodString>;
+            redirectUri: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            channel: "zalo";
+            redirectUri: string;
+            mode?: "oa" | undefined;
+            appId?: string | undefined;
+            appSecret?: string | undefined;
+        }, {
+            channel: "zalo";
+            redirectUri: string;
+            mode?: "oa" | undefined;
+            appId?: string | undefined;
+            appSecret?: string | undefined;
+        }>, z.ZodObject<{
+            channel: z.ZodLiteral<"zalo">;
+            mode: z.ZodLiteral<"personal">;
+        }, "strip", z.ZodTypeAny, {
+            mode: "personal";
+            channel: "zalo";
+        }, {
+            mode: "personal";
+            channel: "zalo";
+        }>]>;
+        response: z.ZodDiscriminatedUnion<"status", [z.ZodObject<{
+            status: z.ZodLiteral<"connected">;
+            displayName: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "connected";
+            displayName: string;
+        }, {
+            status: "connected";
+            displayName: string;
+        }>, z.ZodObject<{
+            status: z.ZodLiteral<"authorization_required">;
+            authorizationUrl: z.ZodString;
+            expiresAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "authorization_required";
+            authorizationUrl: string;
+            expiresAt: string;
+        }, {
+            status: "authorization_required";
+            authorizationUrl: string;
+            expiresAt: string;
+        }>, z.ZodObject<{
+            status: z.ZodLiteral<"qr_required">;
+            qrDataUrl: z.ZodString;
+            expiresAt: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            status: "qr_required";
+            expiresAt: string;
+            qrDataUrl: string;
+        }, {
+            status: "qr_required";
+            expiresAt: string;
+            qrDataUrl: string;
+        }>]>;
+    };
+    readonly "channel.pair": {
+        type: string;
+        payload: z.ZodObject<{
+            channel: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            channel: string;
+        }, {
+            channel: string;
+        }>;
+        response: z.ZodObject<{
+            code: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            code: string;
+        }, {
+            code: string;
+        }>;
+    };
+    readonly "channel.unpair": {
+        type: string;
+        payload: z.ZodObject<{
+            channel: z.ZodString;
+            target: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            channel: string;
+            target: string;
+        }, {
+            channel: string;
+            target: string;
+        }>;
+        response: z.ZodObject<{
+            ok: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+        }, {
+            ok: boolean;
+        }>;
+    };
+    readonly "schedule.run-now": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+        }, {
+            id: string;
+        }>;
+        response: z.ZodObject<{
+            ok: z.ZodBoolean;
+            turnId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+            turnId?: string | undefined;
+        }, {
+            ok: boolean;
+            turnId?: string | undefined;
+        }>;
+    };
+    readonly "agent.turn.submit": {
+        type: string;
+        payload: z.ZodObject<{
+            sessionId: z.ZodOptional<z.ZodString>;
+            message: z.ZodString;
+            attachments: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                mimeType: z.ZodString;
+                sizeBytes: z.ZodNumber;
+                ref: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                id: string;
+                mimeType: string;
+                sizeBytes: number;
+                ref: string;
+            }, {
+                name: string;
+                id: string;
+                mimeType: string;
+                sizeBytes: number;
+                ref: string;
+            }>, "many">>;
+        }, "strip", z.ZodTypeAny, {
+            message: string;
+            sessionId?: string | undefined;
+            attachments?: {
+                name: string;
+                id: string;
+                mimeType: string;
+                sizeBytes: number;
+                ref: string;
+            }[] | undefined;
+        }, {
+            message: string;
+            sessionId?: string | undefined;
+            attachments?: {
+                name: string;
+                id: string;
+                mimeType: string;
+                sizeBytes: number;
+                ref: string;
+            }[] | undefined;
+        }>;
+        response: z.ZodObject<{
+            turnId: z.ZodString;
+            status: z.ZodEnum<["queued", "running", "completed", "cancelled", "failed"]>;
+        }, "strip", z.ZodTypeAny, {
+            status: "completed" | "cancelled" | "queued" | "running" | "failed";
+            turnId: string;
+        }, {
+            status: "completed" | "cancelled" | "queued" | "running" | "failed";
+            turnId: string;
+        }>;
+    };
+    readonly "agent.turn.cancel": {
+        type: string;
+        payload: z.ZodObject<{
+            turnId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            turnId: string;
+        }, {
+            turnId: string;
+        }>;
+        response: z.ZodObject<{
+            turnId: z.ZodString;
+            status: z.ZodEnum<["queued", "running", "completed", "cancelled", "failed"]>;
+        }, "strip", z.ZodTypeAny, {
+            status: "completed" | "cancelled" | "queued" | "running" | "failed";
+            turnId: string;
+        }, {
+            status: "completed" | "cancelled" | "queued" | "running" | "failed";
+            turnId: string;
+        }>;
+    };
+    readonly "turn.approve": {
+        type: string;
+        payload: z.ZodObject<{
+            /** The runId from the matching `turn.approval_required` event. */
+            runId: z.ZodString;
+            approved: z.ZodBoolean;
+            editedArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            approved: boolean;
+            runId: string;
+            editedArgs?: Record<string, unknown> | undefined;
+        }, {
+            approved: boolean;
+            runId: string;
+            editedArgs?: Record<string, unknown> | undefined;
+        }>;
+        response: z.ZodObject<{
+            runId: z.ZodString;
+            approved: z.ZodBoolean;
+            resumed: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            approved: boolean;
+            runId: string;
+            resumed: boolean;
+        }, {
+            approved: boolean;
+            runId: string;
+            resumed: boolean;
+        }>;
+    };
+    readonly "session.list": {
+        type: string;
+        payload: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        response: z.ZodObject<{
+            sessions: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                messageCount: z.ZodNumber;
+                /** P1-7: point-in-time config serving the session's turns; absent until the first turn. */
+                configSnapshot: z.ZodOptional<z.ZodObject<{
+                    model: z.ZodOptional<z.ZodString>;
+                    provider: z.ZodOptional<z.ZodString>;
+                    toolsEnabled: z.ZodNumber;
+                    systemPromptHash: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                }, {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            sessions: {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }[];
+        }, {
+            sessions: {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }[];
+        }>;
+    };
+    readonly "session.get": {
+        type: string;
+        payload: z.ZodObject<{
+            sessionId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            sessionId: string;
+        }, {
+            sessionId: string;
+        }>;
+        response: z.ZodObject<{
+            session: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                messageCount: z.ZodNumber;
+                /** P1-7: point-in-time config serving the session's turns; absent until the first turn. */
+                configSnapshot: z.ZodOptional<z.ZodObject<{
+                    model: z.ZodOptional<z.ZodString>;
+                    provider: z.ZodOptional<z.ZodString>;
+                    toolsEnabled: z.ZodNumber;
+                    systemPromptHash: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                }, {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }>;
+            messages: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                role: z.ZodEnum<["user", "assistant", "system", "tool"]>;
+                content: z.ZodString;
+                createdAt: z.ZodString;
+                toolCallId: z.ZodOptional<z.ZodString>;
+                toolName: z.ZodOptional<z.ZodString>;
+                /** P1-6: context checkpoint flag — prompt projection starts here. */
+                isCheckpoint: z.ZodOptional<z.ZodBoolean>;
+                /**
+                 * P2-3: active variant index the read resolved to. Present and > 0 when a
+                 * variant's content is shown; absent means the base row's content.
+                 */
+                variantIndex: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            }, {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            session: {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            };
+            messages: {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            }[];
+        }, {
+            session: {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            };
+            messages: {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            }[];
+        }>;
+    };
+    readonly "session.create": {
+        type: string;
+        payload: z.ZodObject<{
+            title: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            title?: string | undefined;
+        }, {
+            title?: string | undefined;
+        }>;
+        response: z.ZodObject<{
+            session: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                messageCount: z.ZodNumber;
+                /** P1-7: point-in-time config serving the session's turns; absent until the first turn. */
+                configSnapshot: z.ZodOptional<z.ZodObject<{
+                    model: z.ZodOptional<z.ZodString>;
+                    provider: z.ZodOptional<z.ZodString>;
+                    toolsEnabled: z.ZodNumber;
+                    systemPromptHash: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                }, {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            session: {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            };
+        }, {
+            session: {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            };
+        }>;
+    };
+    readonly "session.delete": {
+        type: string;
+        payload: z.ZodObject<{
+            sessionId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            sessionId: string;
+        }, {
+            sessionId: string;
+        }>;
+        response: z.ZodObject<{
+            ok: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+        }, {
+            ok: boolean;
+        }>;
+    };
+    readonly "session.rename": {
+        type: string;
+        payload: z.ZodObject<{
+            sessionId: z.ZodString;
+            title: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            sessionId: string;
+            title: string;
+        }, {
+            sessionId: string;
+            title: string;
+        }>;
+        response: z.ZodObject<{
+            session: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                messageCount: z.ZodNumber;
+                /** P1-7: point-in-time config serving the session's turns; absent until the first turn. */
+                configSnapshot: z.ZodOptional<z.ZodObject<{
+                    model: z.ZodOptional<z.ZodString>;
+                    provider: z.ZodOptional<z.ZodString>;
+                    toolsEnabled: z.ZodNumber;
+                    systemPromptHash: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                }, {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            session: {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            };
+        }, {
+            session: {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            };
+        }>;
+    };
+    readonly "session.undo": {
+        type: string;
+        payload: z.ZodObject<{
+            sessionId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            sessionId: string;
+        }, {
+            sessionId: string;
+        }>;
+        response: z.ZodObject<{
+            removedCount: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            removedCount: number;
+        }, {
+            removedCount: number;
+        }>;
+    };
+    readonly "session.branch": {
+        type: string;
+        payload: z.ZodObject<{
+            sessionId: z.ZodString;
+            title: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            sessionId: string;
+            title?: string | undefined;
+        }, {
+            sessionId: string;
+            title?: string | undefined;
+        }>;
+        response: z.ZodObject<{
+            session: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                messageCount: z.ZodNumber;
+                /** P1-7: point-in-time config serving the session's turns; absent until the first turn. */
+                configSnapshot: z.ZodOptional<z.ZodObject<{
+                    model: z.ZodOptional<z.ZodString>;
+                    provider: z.ZodOptional<z.ZodString>;
+                    toolsEnabled: z.ZodNumber;
+                    systemPromptHash: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                }, {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                }>>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            session: {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            };
+        }, {
+            session: {
+                id: string;
+                createdAt: string;
+                title: string;
+                updatedAt: string;
+                messageCount: number;
+                configSnapshot?: {
+                    toolsEnabled: number;
+                    systemPromptHash: string;
+                    model?: string | undefined;
+                    provider?: string | undefined;
+                } | undefined;
+            };
+        }>;
+    };
+    readonly "session.checkpoint": {
+        type: string;
+        payload: z.ZodObject<{
+            sessionId: z.ZodString;
+            /** Omit to checkpoint the latest message. */
+            messageId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            sessionId: string;
+            messageId?: string | undefined;
+        }, {
+            sessionId: string;
+            messageId?: string | undefined;
+        }>;
+        response: z.ZodObject<{
+            message: z.ZodObject<{
+                id: z.ZodString;
+                role: z.ZodEnum<["user", "assistant", "system", "tool"]>;
+                content: z.ZodString;
+                createdAt: z.ZodString;
+                toolCallId: z.ZodOptional<z.ZodString>;
+                toolName: z.ZodOptional<z.ZodString>;
+                /** P1-6: context checkpoint flag — prompt projection starts here. */
+                isCheckpoint: z.ZodOptional<z.ZodBoolean>;
+                /**
+                 * P2-3: active variant index the read resolved to. Present and > 0 when a
+                 * variant's content is shown; absent means the base row's content.
+                 */
+                variantIndex: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            }, {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            message: {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            };
+        }, {
+            message: {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            };
+        }>;
+    };
+    readonly "session.variant.create": {
+        type: string;
+        payload: z.ZodObject<{
+            sessionId: z.ZodString;
+            messageId: z.ZodString;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            sessionId: string;
+            content: string;
+            messageId: string;
+        }, {
+            sessionId: string;
+            content: string;
+            messageId: string;
+        }>;
+        response: z.ZodObject<{
+            variant: z.ZodObject<{
+                id: z.ZodString;
+                sessionId: z.ZodString;
+                messageId: z.ZodString;
+                variantIndex: z.ZodNumber;
+                content: z.ZodString;
+                createdAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                sessionId: string;
+                content: string;
+                variantIndex: number;
+                messageId: string;
+            }, {
+                id: string;
+                createdAt: string;
+                sessionId: string;
+                content: string;
+                variantIndex: number;
+                messageId: string;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            variant: {
+                id: string;
+                createdAt: string;
+                sessionId: string;
+                content: string;
+                variantIndex: number;
+                messageId: string;
+            };
+        }, {
+            variant: {
+                id: string;
+                createdAt: string;
+                sessionId: string;
+                content: string;
+                variantIndex: number;
+                messageId: string;
+            };
+        }>;
+    };
+    readonly "session.variant.select": {
+        type: string;
+        payload: z.ZodObject<{
+            sessionId: z.ZodString;
+            messageId: z.ZodString;
+            /** 0 re-selects the base row. */
+            variantIndex: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            sessionId: string;
+            variantIndex: number;
+            messageId: string;
+        }, {
+            sessionId: string;
+            variantIndex: number;
+            messageId: string;
+        }>;
+        response: z.ZodObject<{
+            message: z.ZodObject<{
+                id: z.ZodString;
+                role: z.ZodEnum<["user", "assistant", "system", "tool"]>;
+                content: z.ZodString;
+                createdAt: z.ZodString;
+                toolCallId: z.ZodOptional<z.ZodString>;
+                toolName: z.ZodOptional<z.ZodString>;
+                /** P1-6: context checkpoint flag — prompt projection starts here. */
+                isCheckpoint: z.ZodOptional<z.ZodBoolean>;
+                /**
+                 * P2-3: active variant index the read resolved to. Present and > 0 when a
+                 * variant's content is shown; absent means the base row's content.
+                 */
+                variantIndex: z.ZodOptional<z.ZodNumber>;
+            }, "strip", z.ZodTypeAny, {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            }, {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            message: {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            };
+        }, {
+            message: {
+                role: "system" | "user" | "assistant" | "tool";
+                id: string;
+                createdAt: string;
+                content: string;
+                toolName?: string | undefined;
+                toolCallId?: string | undefined;
+                isCheckpoint?: boolean | undefined;
+                variantIndex?: number | undefined;
+            };
+        }>;
+    };
+    readonly "session.variant.list": {
+        type: string;
+        payload: z.ZodObject<{
+            sessionId: z.ZodString;
+            messageId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            sessionId: string;
+            messageId: string;
+        }, {
+            sessionId: string;
+            messageId: string;
+        }>;
+        response: z.ZodObject<{
+            variants: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                sessionId: z.ZodString;
+                messageId: z.ZodString;
+                variantIndex: z.ZodNumber;
+                content: z.ZodString;
+                createdAt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                sessionId: string;
+                content: string;
+                variantIndex: number;
+                messageId: string;
+            }, {
+                id: string;
+                createdAt: string;
+                sessionId: string;
+                content: string;
+                variantIndex: number;
+                messageId: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            variants: {
+                id: string;
+                createdAt: string;
+                sessionId: string;
+                content: string;
+                variantIndex: number;
+                messageId: string;
+            }[];
+        }, {
+            variants: {
+                id: string;
+                createdAt: string;
+                sessionId: string;
+                content: string;
+                variantIndex: number;
+                messageId: string;
+            }[];
+        }>;
+    };
+    readonly "provider.list": {
+        type: string;
+        payload: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        response: z.ZodObject<{
+            providers: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                kind: z.ZodString;
+                baseUrl: z.ZodOptional<z.ZodString>;
+                hasKey: z.ZodBoolean;
+                /** Number of API keys in the provider's KeyRoulette ring. */
+                keyCount: z.ZodNumber;
+                /** Key-rotation cursor: index of the ring entry tried first (operational state). */
+                keyCursor: z.ZodOptional<z.ZodNumber>;
+                active: z.ZodBoolean;
+                /** Default chat model for turns. Never overwritten by probe discovery. */
+                model: z.ZodOptional<z.ZodString>;
+                models: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                /** Provider-level request profile (tier 2 of 3). */
+                extra: z.ZodOptional<z.ZodObject<{
+                    maxTokens: z.ZodOptional<z.ZodNumber>;
+                    temperature: z.ZodOptional<z.ZodNumber>;
+                    topP: z.ZodOptional<z.ZodNumber>;
+                    /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+                    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    /** Extra top-level fields merged into the JSON request body. */
+                    extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    reasoning: z.ZodOptional<z.ZodObject<{
+                        /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+                        effort: z.ZodOptional<z.ZodString>;
+                        /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+                        budgetTokens: z.ZodOptional<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }>>;
+                /** Per-model request profile overrides (tier 3 of 3), keyed by model id. */
+                modelProfiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    maxTokens: z.ZodOptional<z.ZodNumber>;
+                    temperature: z.ZodOptional<z.ZodNumber>;
+                    topP: z.ZodOptional<z.ZodNumber>;
+                    /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+                    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    /** Extra top-level fields merged into the JSON request body. */
+                    extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    reasoning: z.ZodOptional<z.ZodObject<{
+                        /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+                        effort: z.ZodOptional<z.ZodString>;
+                        /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+                        budgetTokens: z.ZodOptional<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            }, {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            providers: {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            }[];
+        }, {
+            providers: {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            }[];
+        }>;
+    };
+    readonly "provider.save": {
+        type: string;
+        payload: z.ZodObject<{
+            provider: z.ZodObject<Omit<{
+                id: z.ZodString;
+                name: z.ZodString;
+                kind: z.ZodString;
+                baseUrl: z.ZodOptional<z.ZodString>;
+                hasKey: z.ZodBoolean;
+                /** Number of API keys in the provider's KeyRoulette ring. */
+                keyCount: z.ZodNumber;
+                /** Key-rotation cursor: index of the ring entry tried first (operational state). */
+                keyCursor: z.ZodOptional<z.ZodNumber>;
+                active: z.ZodBoolean;
+                /** Default chat model for turns. Never overwritten by probe discovery. */
+                model: z.ZodOptional<z.ZodString>;
+                models: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                /** Provider-level request profile (tier 2 of 3). */
+                extra: z.ZodOptional<z.ZodObject<{
+                    maxTokens: z.ZodOptional<z.ZodNumber>;
+                    temperature: z.ZodOptional<z.ZodNumber>;
+                    topP: z.ZodOptional<z.ZodNumber>;
+                    /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+                    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    /** Extra top-level fields merged into the JSON request body. */
+                    extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    reasoning: z.ZodOptional<z.ZodObject<{
+                        /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+                        effort: z.ZodOptional<z.ZodString>;
+                        /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+                        budgetTokens: z.ZodOptional<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }>>;
+                /** Per-model request profile overrides (tier 3 of 3), keyed by model id. */
+                modelProfiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    maxTokens: z.ZodOptional<z.ZodNumber>;
+                    temperature: z.ZodOptional<z.ZodNumber>;
+                    topP: z.ZodOptional<z.ZodNumber>;
+                    /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+                    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    /** Extra top-level fields merged into the JSON request body. */
+                    extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    reasoning: z.ZodOptional<z.ZodObject<{
+                        /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+                        effort: z.ZodOptional<z.ZodString>;
+                        /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+                        budgetTokens: z.ZodOptional<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }>>>;
+            }, "hasKey" | "keyCount" | "keyCursor" | "active"> & {
+                hasKey: z.ZodOptional<z.ZodBoolean>;
+                /** Server default when omitted. */
+                active: z.ZodOptional<z.ZodBoolean>;
+                apiKey: z.ZodOptional<z.ZodString>;
+                /**
+                 * Replace the whole key ring. Mutually exclusive with `apiKey`;
+                 * omitted = keep stored keys, `[]` = clear.
+                 */
+                apiKeys: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                id: string;
+                kind: string;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                hasKey?: boolean | undefined;
+                active?: boolean | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+                apiKey?: string | undefined;
+                apiKeys?: string[] | undefined;
+            }, {
+                name: string;
+                id: string;
+                kind: string;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                hasKey?: boolean | undefined;
+                active?: boolean | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+                apiKey?: string | undefined;
+                apiKeys?: string[] | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            provider: {
+                name: string;
+                id: string;
+                kind: string;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                hasKey?: boolean | undefined;
+                active?: boolean | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+                apiKey?: string | undefined;
+                apiKeys?: string[] | undefined;
+            };
+        }, {
+            provider: {
+                name: string;
+                id: string;
+                kind: string;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                hasKey?: boolean | undefined;
+                active?: boolean | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+                apiKey?: string | undefined;
+                apiKeys?: string[] | undefined;
+            };
+        }>;
+        response: z.ZodObject<{
+            provider: z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                kind: z.ZodString;
+                baseUrl: z.ZodOptional<z.ZodString>;
+                hasKey: z.ZodBoolean;
+                /** Number of API keys in the provider's KeyRoulette ring. */
+                keyCount: z.ZodNumber;
+                /** Key-rotation cursor: index of the ring entry tried first (operational state). */
+                keyCursor: z.ZodOptional<z.ZodNumber>;
+                active: z.ZodBoolean;
+                /** Default chat model for turns. Never overwritten by probe discovery. */
+                model: z.ZodOptional<z.ZodString>;
+                models: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                /** Provider-level request profile (tier 2 of 3). */
+                extra: z.ZodOptional<z.ZodObject<{
+                    maxTokens: z.ZodOptional<z.ZodNumber>;
+                    temperature: z.ZodOptional<z.ZodNumber>;
+                    topP: z.ZodOptional<z.ZodNumber>;
+                    /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+                    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    /** Extra top-level fields merged into the JSON request body. */
+                    extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    reasoning: z.ZodOptional<z.ZodObject<{
+                        /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+                        effort: z.ZodOptional<z.ZodString>;
+                        /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+                        budgetTokens: z.ZodOptional<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }>>;
+                /** Per-model request profile overrides (tier 3 of 3), keyed by model id. */
+                modelProfiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    maxTokens: z.ZodOptional<z.ZodNumber>;
+                    temperature: z.ZodOptional<z.ZodNumber>;
+                    topP: z.ZodOptional<z.ZodNumber>;
+                    /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+                    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    /** Extra top-level fields merged into the JSON request body. */
+                    extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    reasoning: z.ZodOptional<z.ZodObject<{
+                        /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+                        effort: z.ZodOptional<z.ZodString>;
+                        /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+                        budgetTokens: z.ZodOptional<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            }, {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            provider: {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            };
+        }, {
+            provider: {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            };
+        }>;
+    };
+    readonly "provider.test": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+        }, {
+            id: string;
+        }>;
+        response: z.ZodObject<{
+            ok: z.ZodBoolean;
+            latencyMs: z.ZodOptional<z.ZodNumber>;
+            detail: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+            detail?: string | undefined;
+            latencyMs?: number | undefined;
+        }, {
+            ok: boolean;
+            detail?: string | undefined;
+            latencyMs?: number | undefined;
+        }>;
+    };
+    readonly "provider.activate": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+        }, {
+            id: string;
+        }>;
+        response: z.ZodObject<{
+            provider: z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                kind: z.ZodString;
+                baseUrl: z.ZodOptional<z.ZodString>;
+                hasKey: z.ZodBoolean;
+                /** Number of API keys in the provider's KeyRoulette ring. */
+                keyCount: z.ZodNumber;
+                /** Key-rotation cursor: index of the ring entry tried first (operational state). */
+                keyCursor: z.ZodOptional<z.ZodNumber>;
+                active: z.ZodBoolean;
+                /** Default chat model for turns. Never overwritten by probe discovery. */
+                model: z.ZodOptional<z.ZodString>;
+                models: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+                /** Provider-level request profile (tier 2 of 3). */
+                extra: z.ZodOptional<z.ZodObject<{
+                    maxTokens: z.ZodOptional<z.ZodNumber>;
+                    temperature: z.ZodOptional<z.ZodNumber>;
+                    topP: z.ZodOptional<z.ZodNumber>;
+                    /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+                    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    /** Extra top-level fields merged into the JSON request body. */
+                    extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    reasoning: z.ZodOptional<z.ZodObject<{
+                        /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+                        effort: z.ZodOptional<z.ZodString>;
+                        /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+                        budgetTokens: z.ZodOptional<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }>>;
+                /** Per-model request profile overrides (tier 3 of 3), keyed by model id. */
+                modelProfiles: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodObject<{
+                    maxTokens: z.ZodOptional<z.ZodNumber>;
+                    temperature: z.ZodOptional<z.ZodNumber>;
+                    topP: z.ZodOptional<z.ZodNumber>;
+                    /** Extra HTTP headers merged over (but never overriding) the auth headers. */
+                    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+                    /** Extra top-level fields merged into the JSON request body. */
+                    extraBody: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+                    reasoning: z.ZodOptional<z.ZodObject<{
+                        /** OpenAI-style reasoning effort (sent as `reasoning_effort` on OpenAI-compatible kinds). */
+                        effort: z.ZodOptional<z.ZodString>;
+                        /** Anthropic-style thinking budget in tokens (sent as `thinking.budget_tokens`). */
+                        budgetTokens: z.ZodOptional<z.ZodNumber>;
+                    }, "strip", z.ZodTypeAny, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }, {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    }>>;
+                }, "strip", z.ZodTypeAny, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }>>>;
+            }, "strip", z.ZodTypeAny, {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            }, {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            provider: {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            };
+        }, {
+            provider: {
+                name: string;
+                id: string;
+                kind: string;
+                hasKey: boolean;
+                keyCount: number;
+                active: boolean;
+                model?: string | undefined;
+                baseUrl?: string | undefined;
+                keyCursor?: number | undefined;
+                models?: string[] | undefined;
+                extra?: {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                } | undefined;
+                modelProfiles?: Record<string, {
+                    maxTokens?: number | undefined;
+                    temperature?: number | undefined;
+                    topP?: number | undefined;
+                    headers?: Record<string, string> | undefined;
+                    extraBody?: Record<string, unknown> | undefined;
+                    reasoning?: {
+                        effort?: string | undefined;
+                        budgetTokens?: number | undefined;
+                    } | undefined;
+                }> | undefined;
+            };
+        }>;
+    };
+    readonly "provider.delete": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+        }, {
+            id: string;
+        }>;
+        response: z.ZodObject<{
+            ok: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+        }, {
+            ok: boolean;
+        }>;
+    };
+    readonly "schedule.list": {
+        type: string;
+        payload: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        response: z.ZodObject<{
+            schedules: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                cron: z.ZodString;
+                prompt: z.ZodString;
+                enabled: z.ZodBoolean;
+                nextRunAt: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            }, {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            schedules: {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            }[];
+        }, {
+            schedules: {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            }[];
+        }>;
+    };
+    readonly "schedule.create": {
+        type: string;
+        payload: z.ZodObject<{
+            name: z.ZodString;
+            cron: z.ZodString;
+            prompt: z.ZodString;
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            name: string;
+            prompt: string;
+            cron: string;
+            enabled?: boolean | undefined;
+        }, {
+            name: string;
+            prompt: string;
+            cron: string;
+            enabled?: boolean | undefined;
+        }>;
+        response: z.ZodObject<{
+            schedule: z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                cron: z.ZodString;
+                prompt: z.ZodString;
+                enabled: z.ZodBoolean;
+                nextRunAt: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            }, {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            schedule: {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            };
+        }, {
+            schedule: {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            };
+        }>;
+    };
+    readonly "schedule.update": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodOptional<z.ZodString>;
+            cron: z.ZodOptional<z.ZodString>;
+            prompt: z.ZodOptional<z.ZodString>;
+            enabled: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            enabled?: boolean | undefined;
+            name?: string | undefined;
+            prompt?: string | undefined;
+            cron?: string | undefined;
+        }, {
+            id: string;
+            enabled?: boolean | undefined;
+            name?: string | undefined;
+            prompt?: string | undefined;
+            cron?: string | undefined;
+        }>;
+        response: z.ZodObject<{
+            schedule: z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                cron: z.ZodString;
+                prompt: z.ZodString;
+                enabled: z.ZodBoolean;
+                nextRunAt: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            }, {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            schedule: {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            };
+        }, {
+            schedule: {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            };
+        }>;
+    };
+    readonly "schedule.delete": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+        }, {
+            id: string;
+        }>;
+        response: z.ZodObject<{
+            ok: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+        }, {
+            ok: boolean;
+        }>;
+    };
+    readonly "schedule.toggle": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+            enabled: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            enabled: boolean;
+            id: string;
+        }, {
+            enabled: boolean;
+            id: string;
+        }>;
+        response: z.ZodObject<{
+            schedule: z.ZodObject<{
+                id: z.ZodString;
+                name: z.ZodString;
+                cron: z.ZodString;
+                prompt: z.ZodString;
+                enabled: z.ZodBoolean;
+                nextRunAt: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            }, {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            schedule: {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            };
+        }, {
+            schedule: {
+                enabled: boolean;
+                name: string;
+                id: string;
+                prompt: string;
+                cron: string;
+                nextRunAt?: string | undefined;
+            };
+        }>;
+    };
+    readonly "memory.search": {
+        type: string;
+        payload: z.ZodObject<{
+            query: z.ZodString;
+            limit: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            query: string;
+            limit?: number | undefined;
+        }, {
+            query: string;
+            limit?: number | undefined;
+        }>;
+        response: z.ZodObject<{
+            results: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                excerpt: z.ZodString;
+                score: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                excerpt: string;
+                score: number;
+            }, {
+                id: string;
+                excerpt: string;
+                score: number;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            results: {
+                id: string;
+                excerpt: string;
+                score: number;
+            }[];
+        }, {
+            results: {
+                id: string;
+                excerpt: string;
+                score: number;
+            }[];
+        }>;
+    };
+    readonly "memory.note": {
+        type: string;
+        payload: z.ZodObject<{
+            text: z.ZodEffects<z.ZodString, string, string>;
+            meta: z.ZodOptional<z.ZodEffects<z.ZodRecord<z.ZodString, z.ZodString>, Record<string, string>, Record<string, string>>>;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            meta?: Record<string, string> | undefined;
+        }, {
+            text: string;
+            meta?: Record<string, string> | undefined;
+        }>;
+        response: z.ZodObject<{
+            ok: z.ZodLiteral<true>;
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            ok: true;
+        }, {
+            id: string;
+            ok: true;
+        }>;
+    };
+    readonly "channel.list": {
+        type: string;
+        payload: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        response: z.ZodObject<{
+            channels: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                kind: z.ZodString;
+                status: z.ZodEnum<["connected", "disconnected", "error", "pending"]>;
+                displayName: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                kind: string;
+                status: "error" | "pending" | "connected" | "disconnected";
+                displayName: string;
+            }, {
+                id: string;
+                kind: string;
+                status: "error" | "pending" | "connected" | "disconnected";
+                displayName: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            channels: {
+                id: string;
+                kind: string;
+                status: "error" | "pending" | "connected" | "disconnected";
+                displayName: string;
+            }[];
+        }, {
+            channels: {
+                id: string;
+                kind: string;
+                status: "error" | "pending" | "connected" | "disconnected";
+                displayName: string;
+            }[];
+        }>;
+    };
+    readonly "gateway.health": {
+        type: string;
+        payload: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        response: z.ZodObject<{
+            ok: z.ZodBoolean;
+            version: z.ZodString;
+            wireVersion: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            version: string;
+            ok: boolean;
+            wireVersion: number;
+        }, {
+            version: string;
+            ok: boolean;
+            wireVersion: number;
+        }>;
+    };
+    readonly "task.create": {
+        type: string;
+        payload: z.ZodObject<{
+            title: z.ZodString;
+            steps: z.ZodArray<z.ZodObject<{
+                prompt: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                prompt: string;
+            }, {
+                prompt: string;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            steps: {
+                prompt: string;
+            }[];
+            title: string;
+        }, {
+            steps: {
+                prompt: string;
+            }[];
+            title: string;
+        }>;
+        response: z.ZodObject<{
+            task: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                sessionId: z.ZodOptional<z.ZodString>;
+                status: z.ZodEnum<["queued", "running", "paused", "awaiting_approval", "completed", "failed", "cancelled", "interrupted"]>;
+                steps: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    index: z.ZodNumber;
+                    kind: z.ZodLiteral<"turn">;
+                    prompt: z.ZodString;
+                    status: z.ZodEnum<["pending", "running", "done", "failed", "skipped"]>;
+                    attempts: z.ZodNumber;
+                    output: z.ZodOptional<z.ZodString>;
+                    error: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }>, "many">;
+                currentStepIndex: z.ZodNumber;
+                approval: z.ZodOptional<z.ZodObject<{
+                    runId: z.ZodString;
+                    toolName: z.ZodString;
+                    reason: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }>>;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                error: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }>;
+    };
+    readonly "task.list": {
+        type: string;
+        payload: z.ZodObject<{}, "strip", z.ZodTypeAny, {}, {}>;
+        response: z.ZodObject<{
+            tasks: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                sessionId: z.ZodOptional<z.ZodString>;
+                status: z.ZodEnum<["queued", "running", "paused", "awaiting_approval", "completed", "failed", "cancelled", "interrupted"]>;
+                steps: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    index: z.ZodNumber;
+                    kind: z.ZodLiteral<"turn">;
+                    prompt: z.ZodString;
+                    status: z.ZodEnum<["pending", "running", "done", "failed", "skipped"]>;
+                    attempts: z.ZodNumber;
+                    output: z.ZodOptional<z.ZodString>;
+                    error: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }>, "many">;
+                currentStepIndex: z.ZodNumber;
+                approval: z.ZodOptional<z.ZodObject<{
+                    runId: z.ZodString;
+                    toolName: z.ZodString;
+                    reason: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }>>;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                error: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }>, "many">;
+        }, "strip", z.ZodTypeAny, {
+            tasks: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }[];
+        }, {
+            tasks: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }[];
+        }>;
+    };
+    readonly "task.get": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+        }, {
+            id: string;
+        }>;
+        response: z.ZodObject<{
+            task: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                sessionId: z.ZodOptional<z.ZodString>;
+                status: z.ZodEnum<["queued", "running", "paused", "awaiting_approval", "completed", "failed", "cancelled", "interrupted"]>;
+                steps: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    index: z.ZodNumber;
+                    kind: z.ZodLiteral<"turn">;
+                    prompt: z.ZodString;
+                    status: z.ZodEnum<["pending", "running", "done", "failed", "skipped"]>;
+                    attempts: z.ZodNumber;
+                    output: z.ZodOptional<z.ZodString>;
+                    error: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }>, "many">;
+                currentStepIndex: z.ZodNumber;
+                approval: z.ZodOptional<z.ZodObject<{
+                    runId: z.ZodString;
+                    toolName: z.ZodString;
+                    reason: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }>>;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                error: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }>;
+    };
+    readonly "task.pause": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+        }, {
+            id: string;
+        }>;
+        response: z.ZodObject<{
+            task: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                sessionId: z.ZodOptional<z.ZodString>;
+                status: z.ZodEnum<["queued", "running", "paused", "awaiting_approval", "completed", "failed", "cancelled", "interrupted"]>;
+                steps: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    index: z.ZodNumber;
+                    kind: z.ZodLiteral<"turn">;
+                    prompt: z.ZodString;
+                    status: z.ZodEnum<["pending", "running", "done", "failed", "skipped"]>;
+                    attempts: z.ZodNumber;
+                    output: z.ZodOptional<z.ZodString>;
+                    error: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }>, "many">;
+                currentStepIndex: z.ZodNumber;
+                approval: z.ZodOptional<z.ZodObject<{
+                    runId: z.ZodString;
+                    toolName: z.ZodString;
+                    reason: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }>>;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                error: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }>;
+    };
+    readonly "task.resume": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+            approved: z.ZodOptional<z.ZodBoolean>;
+            editedArgs: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            approved?: boolean | undefined;
+            editedArgs?: Record<string, unknown> | undefined;
+        }, {
+            id: string;
+            approved?: boolean | undefined;
+            editedArgs?: Record<string, unknown> | undefined;
+        }>;
+        response: z.ZodObject<{
+            task: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                sessionId: z.ZodOptional<z.ZodString>;
+                status: z.ZodEnum<["queued", "running", "paused", "awaiting_approval", "completed", "failed", "cancelled", "interrupted"]>;
+                steps: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    index: z.ZodNumber;
+                    kind: z.ZodLiteral<"turn">;
+                    prompt: z.ZodString;
+                    status: z.ZodEnum<["pending", "running", "done", "failed", "skipped"]>;
+                    attempts: z.ZodNumber;
+                    output: z.ZodOptional<z.ZodString>;
+                    error: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }>, "many">;
+                currentStepIndex: z.ZodNumber;
+                approval: z.ZodOptional<z.ZodObject<{
+                    runId: z.ZodString;
+                    toolName: z.ZodString;
+                    reason: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }>>;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                error: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }>;
+    };
+    readonly "task.cancel": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+        }, {
+            id: string;
+        }>;
+        response: z.ZodObject<{
+            ok: z.ZodBoolean;
+        }, "strip", z.ZodTypeAny, {
+            ok: boolean;
+        }, {
+            ok: boolean;
+        }>;
+    };
+    readonly "task.redirect": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+            message: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            message: string;
+        }, {
+            id: string;
+            message: string;
+        }>;
+        response: z.ZodObject<{
+            task: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                sessionId: z.ZodOptional<z.ZodString>;
+                status: z.ZodEnum<["queued", "running", "paused", "awaiting_approval", "completed", "failed", "cancelled", "interrupted"]>;
+                steps: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    index: z.ZodNumber;
+                    kind: z.ZodLiteral<"turn">;
+                    prompt: z.ZodString;
+                    status: z.ZodEnum<["pending", "running", "done", "failed", "skipped"]>;
+                    attempts: z.ZodNumber;
+                    output: z.ZodOptional<z.ZodString>;
+                    error: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }>, "many">;
+                currentStepIndex: z.ZodNumber;
+                approval: z.ZodOptional<z.ZodObject<{
+                    runId: z.ZodString;
+                    toolName: z.ZodString;
+                    reason: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }>>;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                error: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }>;
+    };
+    readonly "task.retry": {
+        type: string;
+        payload: z.ZodObject<{
+            id: z.ZodString;
+            fromStep: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            fromStep?: number | undefined;
+        }, {
+            id: string;
+            fromStep?: number | undefined;
+        }>;
+        response: z.ZodObject<{
+            task: z.ZodObject<{
+                id: z.ZodString;
+                title: z.ZodString;
+                sessionId: z.ZodOptional<z.ZodString>;
+                status: z.ZodEnum<["queued", "running", "paused", "awaiting_approval", "completed", "failed", "cancelled", "interrupted"]>;
+                steps: z.ZodArray<z.ZodObject<{
+                    id: z.ZodString;
+                    index: z.ZodNumber;
+                    kind: z.ZodLiteral<"turn">;
+                    prompt: z.ZodString;
+                    status: z.ZodEnum<["pending", "running", "done", "failed", "skipped"]>;
+                    attempts: z.ZodNumber;
+                    output: z.ZodOptional<z.ZodString>;
+                    error: z.ZodOptional<z.ZodString>;
+                }, "strip", z.ZodTypeAny, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }, {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }>, "many">;
+                currentStepIndex: z.ZodNumber;
+                approval: z.ZodOptional<z.ZodObject<{
+                    runId: z.ZodString;
+                    toolName: z.ZodString;
+                    reason: z.ZodString;
+                }, "strip", z.ZodTypeAny, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }, {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                }>>;
+                createdAt: z.ZodString;
+                updatedAt: z.ZodString;
+                error: z.ZodOptional<z.ZodString>;
+            }, "strip", z.ZodTypeAny, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }, {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            }>;
+        }, "strip", z.ZodTypeAny, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }, {
+            task: {
+                id: string;
+                createdAt: string;
+                status: "completed" | "cancelled" | "queued" | "running" | "paused" | "awaiting_approval" | "failed" | "interrupted";
+                steps: {
+                    id: string;
+                    kind: "turn";
+                    status: "done" | "running" | "failed" | "pending" | "skipped";
+                    prompt: string;
+                    attempts: number;
+                    index: number;
+                    output?: string | undefined;
+                    error?: string | undefined;
+                }[];
+                title: string;
+                updatedAt: string;
+                currentStepIndex: number;
+                error?: string | undefined;
+                sessionId?: string | undefined;
+                approval?: {
+                    reason: string;
+                    runId: string;
+                    toolName: string;
+                } | undefined;
+            };
+        }>;
+    };
+};
+/** Union of all known command type literals. */
+export type CommandType = keyof typeof COMMAND_SCHEMAS;
+/** Validated payload type for a given command. */
+export type CommandPayload<T extends CommandType> = z.infer<(typeof COMMAND_SCHEMAS)[T]["payload"]>;
+/** Validated response type for a given command. */
+export type CommandResponse<T extends CommandType> = z.infer<(typeof COMMAND_SCHEMAS)[T]["response"]>;
+/** A validated command: discriminated union over every known command type. */
+export type ParsedCommand = {
+    [K in CommandType]: {
+        type: K;
+        payload: CommandPayload<K>;
+    };
+}[CommandType];
+/**
+ * Validate an envelope's payload against the schema registered for its `type`.
+ * Throws {@link ProtocolError}:
+ * - UNKNOWN_COMMAND when `type` is not registered,
+ * - INVALID_PAYLOAD when the payload fails its schema (zod issues in `details`).
+ */
+export declare function parseCommand(envelope: Envelope<string, unknown>): ParsedCommand;
+/**
+ * Validate a raw response body for a given command type.
+ * Throws {@link ProtocolError} with code INVALID_PAYLOAD on schema mismatch.
+ */
+export declare function parseCommandResponse<T extends CommandType>(type: T, raw: unknown): CommandResponse<T>;