@nexus-code/remote-protocol 0.0.0-stage → 0.2.0

package/dist/view.d.ts

@@ -0,0 +1,1560 @@
+/**
+ * A chat as another device draws it: the conversation the serving device's
+ * app already made of its program's log, trimmed of what only that app
+ * uses. The shapes follow the desktop app's chat model, so its chat view can
+ * draw a remote one as it draws its own; Claude Code's and Codex's own
+ * formats stay on the serving device, which keeps up with their versions.
+ *
+ * An item or call of a kind this version does not know stays parseable
+ * (UnknownItemSchema): a newer device may send more, and an older one skips it.
+ */
+import { z } from "zod";
+/** An image a message or a tool result holds. Its bytes stay on the serving device in v1. */
+export declare const ImageRefSchema: z.ZodObject<{
+    mediaType: z.ZodString;
+    /** How many bytes the image takes. */
+    bytes: z.ZodNumber;
+}, "strip", z.ZodTypeAny, {
+    mediaType: string;
+    bytes: number;
+}, {
+    mediaType: string;
+    bytes: number;
+}>;
+export type ImageRef = z.infer<typeof ImageRefSchema>;
+export declare const UserItemSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"user">;
+    key: z.ZodString;
+    text: z.ZodString;
+    images: z.ZodArray<z.ZodObject<{
+        mediaType: z.ZodString;
+        /** How many bytes the image takes. */
+        bytes: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        mediaType: string;
+        bytes: number;
+    }, {
+        mediaType: string;
+        bytes: number;
+    }>, "many">;
+    /** sent: written to the program; taken: the program read it. */
+    state: z.ZodEnum<["sent", "taken"]>;
+    /** Written during a turn and not read yet: it waits above the composer. */
+    queued: z.ZodOptional<z.ZodBoolean>;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "user";
+    key: string;
+    text: string;
+    images: {
+        mediaType: string;
+        bytes: number;
+    }[];
+    state: "sent" | "taken";
+    at?: number | undefined;
+    queued?: boolean | undefined;
+}, {
+    kind: "user";
+    key: string;
+    text: string;
+    images: {
+        mediaType: string;
+        bytes: number;
+    }[];
+    state: "sent" | "taken";
+    at?: number | undefined;
+    queued?: boolean | undefined;
+}>;
+export declare const AssistantBlockSchema: z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+    type: z.ZodLiteral<"text">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "text";
+    text: string;
+}, {
+    type: "text";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"thinking">;
+    text: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "thinking";
+    text: string;
+}, {
+    type: "thinking";
+    text: string;
+}>, z.ZodObject<{
+    type: z.ZodLiteral<"tool">;
+    toolUseId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    type: "tool";
+    toolUseId: string;
+}, {
+    type: "tool";
+    toolUseId: string;
+}>]>;
+export declare const AssistantItemSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"assistant">;
+    key: z.ZodString;
+    messageId: z.ZodString;
+    blocks: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "text";
+        text: string;
+    }, {
+        type: "text";
+        text: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"thinking">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "thinking";
+        text: string;
+    }, {
+        type: "thinking";
+        text: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"tool">;
+        toolUseId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "tool";
+        toolUseId: string;
+    }, {
+        type: "tool";
+        toolUseId: string;
+    }>]>, "many">;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "assistant";
+    key: string;
+    messageId: string;
+    blocks: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "thinking";
+        text: string;
+    } | {
+        type: "tool";
+        toolUseId: string;
+    })[];
+    at?: number | undefined;
+}, {
+    kind: "assistant";
+    key: string;
+    messageId: string;
+    blocks: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "thinking";
+        text: string;
+    } | {
+        type: "tool";
+        toolUseId: string;
+    })[];
+    at?: number | undefined;
+}>;
+export type ViewAssistantItem = z.infer<typeof AssistantItemSchema>;
+export declare const NoticeItemSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"notice">;
+    key: z.ZodString;
+    /** interrupted, exited, restarted, compacted, cleared, error…: a code the app names. */
+    code: z.ZodString;
+    detail: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    kind: "notice";
+    key: string;
+    at?: number | undefined;
+    detail?: string | undefined;
+}, {
+    code: string;
+    kind: "notice";
+    key: string;
+    at?: number | undefined;
+    detail?: string | undefined;
+}>;
+/**
+ * Where an agent that sent a message can be answered: its tab, on the
+ * device `deviceId` (absent: the device this chat runs on). `nexus chat
+ * send` takes it as it is.
+ */
+export declare const ReplyAddressSchema: z.ZodObject<{
+    deviceId: z.ZodOptional<z.ZodString>;
+    workspaceId: z.ZodString;
+    tabId: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    workspaceId: string;
+    tabId: string;
+    deviceId?: string | undefined;
+}, {
+    workspaceId: string;
+    tabId: string;
+    deviceId?: string | undefined;
+}>;
+export type ReplyAddress = z.infer<typeof ReplyAddressSchema>;
+/** A message the program took that the user did not write: another session's, a channel's. */
+export declare const ReceivedItemSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"received">;
+    key: z.ZodString;
+    from: z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        /** Sent from another device of the account: which one, as it names itself. */
+        device: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name: string;
+        }, {
+            id: string;
+            name: string;
+        }>>;
+        /** Where the sender takes an answer. */
+        replyTo: z.ZodOptional<z.ZodObject<{
+            deviceId: z.ZodOptional<z.ZodString>;
+            workspaceId: z.ZodString;
+            tabId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        }, {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        name?: string | undefined;
+        agent?: string | undefined;
+        device?: {
+            id: string;
+            name: string;
+        } | undefined;
+        replyTo?: {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        } | undefined;
+    }, {
+        kind: string;
+        name?: string | undefined;
+        agent?: string | undefined;
+        device?: {
+            id: string;
+            name: string;
+        } | undefined;
+        replyTo?: {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        } | undefined;
+    }>;
+    text: z.ZodString;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    from: {
+        kind: string;
+        name?: string | undefined;
+        agent?: string | undefined;
+        device?: {
+            id: string;
+            name: string;
+        } | undefined;
+        replyTo?: {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        } | undefined;
+    };
+    kind: "received";
+    key: string;
+    text: string;
+    at?: number | undefined;
+}, {
+    from: {
+        kind: string;
+        name?: string | undefined;
+        agent?: string | undefined;
+        device?: {
+            id: string;
+            name: string;
+        } | undefined;
+        replyTo?: {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        } | undefined;
+    };
+    kind: "received";
+    key: string;
+    text: string;
+    at?: number | undefined;
+}>;
+export declare const TaskEndItemSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"task_end">;
+    key: z.ZodString;
+    taskId: z.ZodString;
+    status: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    taskType: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    wakes: z.ZodOptional<z.ZodBoolean>;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    kind: "task_end";
+    key: string;
+    taskId: string;
+    at?: number | undefined;
+    toolUseId?: string | undefined;
+    description?: string | undefined;
+    taskType?: string | undefined;
+    summary?: string | undefined;
+    wakes?: boolean | undefined;
+}, {
+    status: string;
+    kind: "task_end";
+    key: string;
+    taskId: string;
+    at?: number | undefined;
+    toolUseId?: string | undefined;
+    description?: string | undefined;
+    taskType?: string | undefined;
+    summary?: string | undefined;
+    wakes?: boolean | undefined;
+}>;
+export declare const ShellItemSchema: z.ZodObject<{
+    kind: z.ZodLiteral<"shell">;
+    key: z.ZodString;
+    command: z.ZodString;
+    stdout: z.ZodOptional<z.ZodString>;
+    stderr: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "shell";
+    key: string;
+    command: string;
+    at?: number | undefined;
+    stdout?: string | undefined;
+    stderr?: string | undefined;
+}, {
+    kind: "shell";
+    key: string;
+    command: string;
+    at?: number | undefined;
+    stdout?: string | undefined;
+    stderr?: string | undefined;
+}>;
+/** The item kinds this version knows. */
+export declare const ITEM_KINDS: ReadonlySet<string>;
+/**
+ * An item of a kind this version does not know: kept so the list stays
+ * whole, and not drawn. A known kind that does not fit its shape is no such item.
+ */
+export declare const UnknownItemSchema: z.ZodObject<{
+    kind: z.ZodEffects<z.ZodString, string, string>;
+    key: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    kind: z.ZodEffects<z.ZodString, string, string>;
+    key: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    kind: z.ZodEffects<z.ZodString, string, string>;
+    key: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>;
+export declare const ViewItemSchema: z.ZodUnion<[z.ZodObject<{
+    kind: z.ZodLiteral<"user">;
+    key: z.ZodString;
+    text: z.ZodString;
+    images: z.ZodArray<z.ZodObject<{
+        mediaType: z.ZodString;
+        /** How many bytes the image takes. */
+        bytes: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        mediaType: string;
+        bytes: number;
+    }, {
+        mediaType: string;
+        bytes: number;
+    }>, "many">;
+    /** sent: written to the program; taken: the program read it. */
+    state: z.ZodEnum<["sent", "taken"]>;
+    /** Written during a turn and not read yet: it waits above the composer. */
+    queued: z.ZodOptional<z.ZodBoolean>;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "user";
+    key: string;
+    text: string;
+    images: {
+        mediaType: string;
+        bytes: number;
+    }[];
+    state: "sent" | "taken";
+    at?: number | undefined;
+    queued?: boolean | undefined;
+}, {
+    kind: "user";
+    key: string;
+    text: string;
+    images: {
+        mediaType: string;
+        bytes: number;
+    }[];
+    state: "sent" | "taken";
+    at?: number | undefined;
+    queued?: boolean | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"assistant">;
+    key: z.ZodString;
+    messageId: z.ZodString;
+    blocks: z.ZodArray<z.ZodDiscriminatedUnion<"type", [z.ZodObject<{
+        type: z.ZodLiteral<"text">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "text";
+        text: string;
+    }, {
+        type: "text";
+        text: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"thinking">;
+        text: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "thinking";
+        text: string;
+    }, {
+        type: "thinking";
+        text: string;
+    }>, z.ZodObject<{
+        type: z.ZodLiteral<"tool">;
+        toolUseId: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        type: "tool";
+        toolUseId: string;
+    }, {
+        type: "tool";
+        toolUseId: string;
+    }>]>, "many">;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "assistant";
+    key: string;
+    messageId: string;
+    blocks: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "thinking";
+        text: string;
+    } | {
+        type: "tool";
+        toolUseId: string;
+    })[];
+    at?: number | undefined;
+}, {
+    kind: "assistant";
+    key: string;
+    messageId: string;
+    blocks: ({
+        type: "text";
+        text: string;
+    } | {
+        type: "thinking";
+        text: string;
+    } | {
+        type: "tool";
+        toolUseId: string;
+    })[];
+    at?: number | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"notice">;
+    key: z.ZodString;
+    /** interrupted, exited, restarted, compacted, cleared, error…: a code the app names. */
+    code: z.ZodString;
+    detail: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    code: string;
+    kind: "notice";
+    key: string;
+    at?: number | undefined;
+    detail?: string | undefined;
+}, {
+    code: string;
+    kind: "notice";
+    key: string;
+    at?: number | undefined;
+    detail?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"received">;
+    key: z.ZodString;
+    from: z.ZodObject<{
+        kind: z.ZodString;
+        name: z.ZodOptional<z.ZodString>;
+        agent: z.ZodOptional<z.ZodString>;
+        /** Sent from another device of the account: which one, as it names itself. */
+        device: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            id: string;
+            name: string;
+        }, {
+            id: string;
+            name: string;
+        }>>;
+        /** Where the sender takes an answer. */
+        replyTo: z.ZodOptional<z.ZodObject<{
+            deviceId: z.ZodOptional<z.ZodString>;
+            workspaceId: z.ZodString;
+            tabId: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        }, {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        kind: string;
+        name?: string | undefined;
+        agent?: string | undefined;
+        device?: {
+            id: string;
+            name: string;
+        } | undefined;
+        replyTo?: {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        } | undefined;
+    }, {
+        kind: string;
+        name?: string | undefined;
+        agent?: string | undefined;
+        device?: {
+            id: string;
+            name: string;
+        } | undefined;
+        replyTo?: {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        } | undefined;
+    }>;
+    text: z.ZodString;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    from: {
+        kind: string;
+        name?: string | undefined;
+        agent?: string | undefined;
+        device?: {
+            id: string;
+            name: string;
+        } | undefined;
+        replyTo?: {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        } | undefined;
+    };
+    kind: "received";
+    key: string;
+    text: string;
+    at?: number | undefined;
+}, {
+    from: {
+        kind: string;
+        name?: string | undefined;
+        agent?: string | undefined;
+        device?: {
+            id: string;
+            name: string;
+        } | undefined;
+        replyTo?: {
+            workspaceId: string;
+            tabId: string;
+            deviceId?: string | undefined;
+        } | undefined;
+    };
+    kind: "received";
+    key: string;
+    text: string;
+    at?: number | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"task_end">;
+    key: z.ZodString;
+    taskId: z.ZodString;
+    status: z.ZodString;
+    description: z.ZodOptional<z.ZodString>;
+    taskType: z.ZodOptional<z.ZodString>;
+    summary: z.ZodOptional<z.ZodString>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    wakes: z.ZodOptional<z.ZodBoolean>;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    kind: "task_end";
+    key: string;
+    taskId: string;
+    at?: number | undefined;
+    toolUseId?: string | undefined;
+    description?: string | undefined;
+    taskType?: string | undefined;
+    summary?: string | undefined;
+    wakes?: boolean | undefined;
+}, {
+    status: string;
+    kind: "task_end";
+    key: string;
+    taskId: string;
+    at?: number | undefined;
+    toolUseId?: string | undefined;
+    description?: string | undefined;
+    taskType?: string | undefined;
+    summary?: string | undefined;
+    wakes?: boolean | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodLiteral<"shell">;
+    key: z.ZodString;
+    command: z.ZodString;
+    stdout: z.ZodOptional<z.ZodString>;
+    stderr: z.ZodOptional<z.ZodString>;
+    at: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    kind: "shell";
+    key: string;
+    command: string;
+    at?: number | undefined;
+    stdout?: string | undefined;
+    stderr?: string | undefined;
+}, {
+    kind: "shell";
+    key: string;
+    command: string;
+    at?: number | undefined;
+    stdout?: string | undefined;
+    stderr?: string | undefined;
+}>, z.ZodObject<{
+    kind: z.ZodEffects<z.ZodString, string, string>;
+    key: z.ZodString;
+}, "passthrough", z.ZodTypeAny, z.objectOutputType<{
+    kind: z.ZodEffects<z.ZodString, string, string>;
+    key: z.ZodString;
+}, z.ZodTypeAny, "passthrough">, z.objectInputType<{
+    kind: z.ZodEffects<z.ZodString, string, string>;
+    key: z.ZodString;
+}, z.ZodTypeAny, "passthrough">>]>;
+export type ViewItem = z.infer<typeof ViewItemSchema>;
+/** Most characters of a tool's result text sent; the rest is cut (`truncated`). */
+export declare const MAX_RESULT_TEXT: number;
+export declare const ViewToolCallSchema: z.ZodObject<{
+    id: z.ZodString;
+    name: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    input: z.ZodUnknown;
+    /** streaming, running, done, error, denied, stopped. */
+    status: z.ZodString;
+    result: z.ZodOptional<z.ZodObject<{
+        text: z.ZodString;
+        isError: z.ZodBoolean;
+        /** The program's structured result: a run's stdout, an edit's patch. */
+        structured: z.ZodOptional<z.ZodUnknown>;
+        images: z.ZodArray<z.ZodObject<{
+            mediaType: z.ZodString;
+            /** How many bytes the image takes. */
+            bytes: z.ZodNumber;
+        }, "strip", z.ZodTypeAny, {
+            mediaType: string;
+            bytes: number;
+        }, {
+            mediaType: string;
+            bytes: number;
+        }>, "many">;
+        /** The text was longer than MAX_RESULT_TEXT and is cut there. */
+        truncated: z.ZodOptional<z.ZodBoolean>;
+    }, "strip", z.ZodTypeAny, {
+        text: string;
+        images: {
+            mediaType: string;
+            bytes: number;
+        }[];
+        isError: boolean;
+        structured?: unknown;
+        truncated?: boolean | undefined;
+    }, {
+        text: string;
+        images: {
+            mediaType: string;
+            bytes: number;
+        }[];
+        isError: boolean;
+        structured?: unknown;
+        truncated?: boolean | undefined;
+    }>>;
+    /** The agent call it runs under; null on the main thread. */
+    parentToolUseId: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    id: string;
+    name: string;
+    parentToolUseId: string | null;
+    displayName?: string | undefined;
+    input?: unknown;
+    result?: {
+        text: string;
+        images: {
+            mediaType: string;
+            bytes: number;
+        }[];
+        isError: boolean;
+        structured?: unknown;
+        truncated?: boolean | undefined;
+    } | undefined;
+}, {
+    status: string;
+    id: string;
+    name: string;
+    parentToolUseId: string | null;
+    displayName?: string | undefined;
+    input?: unknown;
+    result?: {
+        text: string;
+        images: {
+            mediaType: string;
+            bytes: number;
+        }[];
+        isError: boolean;
+        structured?: unknown;
+        truncated?: boolean | undefined;
+    } | undefined;
+}>;
+export type ViewToolCall = z.infer<typeof ViewToolCallSchema>;
+/** A tool the program asks to run, which the user allows or denies. */
+export declare const ViewPermissionSchema: z.ZodObject<{
+    requestId: z.ZodString;
+    toolName: z.ZodString;
+    displayName: z.ZodOptional<z.ZodString>;
+    input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+    description: z.ZodOptional<z.ZodString>;
+    decisionReason: z.ZodOptional<z.ZodString>;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    /** A subagent's request. */
+    agentId: z.ZodOptional<z.ZodString>;
+    /** The call as the card previews it, when the input alone does not tell it. */
+    preview: z.ZodOptional<z.ZodObject<{
+        id: z.ZodString;
+        name: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        input: z.ZodUnknown;
+        /** streaming, running, done, error, denied, stopped. */
+        status: z.ZodString;
+        result: z.ZodOptional<z.ZodObject<{
+            text: z.ZodString;
+            isError: z.ZodBoolean;
+            /** The program's structured result: a run's stdout, an edit's patch. */
+            structured: z.ZodOptional<z.ZodUnknown>;
+            images: z.ZodArray<z.ZodObject<{
+                mediaType: z.ZodString;
+                /** How many bytes the image takes. */
+                bytes: z.ZodNumber;
+            }, "strip", z.ZodTypeAny, {
+                mediaType: string;
+                bytes: number;
+            }, {
+                mediaType: string;
+                bytes: number;
+            }>, "many">;
+            /** The text was longer than MAX_RESULT_TEXT and is cut there. */
+            truncated: z.ZodOptional<z.ZodBoolean>;
+        }, "strip", z.ZodTypeAny, {
+            text: string;
+            images: {
+                mediaType: string;
+                bytes: number;
+            }[];
+            isError: boolean;
+            structured?: unknown;
+            truncated?: boolean | undefined;
+        }, {
+            text: string;
+            images: {
+                mediaType: string;
+                bytes: number;
+            }[];
+            isError: boolean;
+            structured?: unknown;
+            truncated?: boolean | undefined;
+        }>>;
+        /** The agent call it runs under; null on the main thread. */
+        parentToolUseId: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        id: string;
+        name: string;
+        parentToolUseId: string | null;
+        displayName?: string | undefined;
+        input?: unknown;
+        result?: {
+            text: string;
+            images: {
+                mediaType: string;
+                bytes: number;
+            }[];
+            isError: boolean;
+            structured?: unknown;
+            truncated?: boolean | undefined;
+        } | undefined;
+    }, {
+        status: string;
+        id: string;
+        name: string;
+        parentToolUseId: string | null;
+        displayName?: string | undefined;
+        input?: unknown;
+        result?: {
+            text: string;
+            images: {
+                mediaType: string;
+                bytes: number;
+            }[];
+            isError: boolean;
+            structured?: unknown;
+            truncated?: boolean | undefined;
+        } | undefined;
+    }>>;
+    /**
+     * What "always allow" would add, one choice each, in the serving
+     * device's words ("Allow Bash(npm test:*) in this folder"): chat.answer
+     * picks them by index.
+     */
+    suggestions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        label: string;
+    }, {
+        label: string;
+    }>, "many">>;
+}, "strip", z.ZodTypeAny, {
+    input: Record<string, unknown>;
+    requestId: string;
+    toolName: string;
+    toolUseId?: string | undefined;
+    description?: string | undefined;
+    displayName?: string | undefined;
+    decisionReason?: string | undefined;
+    agentId?: string | undefined;
+    preview?: {
+        status: string;
+        id: string;
+        name: string;
+        parentToolUseId: string | null;
+        displayName?: string | undefined;
+        input?: unknown;
+        result?: {
+            text: string;
+            images: {
+                mediaType: string;
+                bytes: number;
+            }[];
+            isError: boolean;
+            structured?: unknown;
+            truncated?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    suggestions?: {
+        label: string;
+    }[] | undefined;
+}, {
+    input: Record<string, unknown>;
+    requestId: string;
+    toolName: string;
+    toolUseId?: string | undefined;
+    description?: string | undefined;
+    displayName?: string | undefined;
+    decisionReason?: string | undefined;
+    agentId?: string | undefined;
+    preview?: {
+        status: string;
+        id: string;
+        name: string;
+        parentToolUseId: string | null;
+        displayName?: string | undefined;
+        input?: unknown;
+        result?: {
+            text: string;
+            images: {
+                mediaType: string;
+                bytes: number;
+            }[];
+            isError: boolean;
+            structured?: unknown;
+            truncated?: boolean | undefined;
+        } | undefined;
+    } | undefined;
+    suggestions?: {
+        label: string;
+    }[] | undefined;
+}>;
+export type ViewPermission = z.infer<typeof ViewPermissionSchema>;
+/** A task the program runs beside the turn: a background run, a subagent. */
+export declare const ViewTaskSchema: z.ZodObject<{
+    taskId: z.ZodString;
+    type: z.ZodString;
+    description: z.ZodString;
+    status: z.ZodString;
+    toolUseId: z.ZodOptional<z.ZodString>;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    endedAt: z.ZodOptional<z.ZodNumber>;
+    summary: z.ZodOptional<z.ZodString>;
+    activity: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    type: string;
+    status: string;
+    taskId: string;
+    description: string;
+    toolUseId?: string | undefined;
+    summary?: string | undefined;
+    startedAt?: number | undefined;
+    endedAt?: number | undefined;
+    activity?: string | undefined;
+}, {
+    type: string;
+    status: string;
+    taskId: string;
+    description: string;
+    toolUseId?: string | undefined;
+    summary?: string | undefined;
+    startedAt?: number | undefined;
+    endedAt?: number | undefined;
+    activity?: string | undefined;
+}>;
+export type ViewTask = z.infer<typeof ViewTaskSchema>;
+/** The reply being written: what the program streamed of its next message so far. */
+export declare const ViewStreamingSchema: z.ZodObject<{
+    messageId: z.ZodString;
+    blocks: z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["text", "thinking", "tool_use"]>;
+        text: z.ZodString;
+        toolUseId: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "text" | "thinking" | "tool_use";
+        text: string;
+        toolUseId?: string | undefined;
+    }, {
+        type: "text" | "thinking" | "tool_use";
+        text: string;
+        toolUseId?: string | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    messageId: string;
+    blocks: {
+        type: "text" | "thinking" | "tool_use";
+        text: string;
+        toolUseId?: string | undefined;
+    }[];
+}, {
+    messageId: string;
+    blocks: {
+        type: "text" | "thinking" | "tool_use";
+        text: string;
+        toolUseId?: string | undefined;
+    }[];
+}>;
+export type ViewStreaming = z.infer<typeof ViewStreamingSchema>;
+/** Where a chat stands, apart from its messages. */
+export declare const ChatStatusSchema: z.ZodObject<{
+    agent: z.ZodEnum<["claude", "codex"]>;
+    title: z.ZodString;
+    /** The model it runs, as its program names it. */
+    model: z.ZodOptional<z.ZodString>;
+    effort: z.ZodOptional<z.ZodString>;
+    permissionMode: z.ZodOptional<z.ZodString>;
+    /** A turn is under way. */
+    running: z.ZodBoolean;
+    process: z.ZodEnum<["none", "running", "exited"]>;
+    turn: z.ZodNullable<z.ZodObject<{
+        startedAt: z.ZodOptional<z.ZodNumber>;
+        outputTokens: z.ZodNumber;
+        /** requesting, compacting… */
+        status: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        outputTokens: number;
+        status?: string | undefined;
+        startedAt?: number | undefined;
+    }, {
+        outputTokens: number;
+        status?: string | undefined;
+        startedAt?: number | undefined;
+    }>>;
+    streaming: z.ZodNullable<z.ZodObject<{
+        messageId: z.ZodString;
+        blocks: z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["text", "thinking", "tool_use"]>;
+            text: z.ZodString;
+            toolUseId: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "text" | "thinking" | "tool_use";
+            text: string;
+            toolUseId?: string | undefined;
+        }, {
+            type: "text" | "thinking" | "tool_use";
+            text: string;
+            toolUseId?: string | undefined;
+        }>, "many">;
+    }, "strip", z.ZodTypeAny, {
+        messageId: string;
+        blocks: {
+            type: "text" | "thinking" | "tool_use";
+            text: string;
+            toolUseId?: string | undefined;
+        }[];
+    }, {
+        messageId: string;
+        blocks: {
+            type: "text" | "thinking" | "tool_use";
+            text: string;
+            toolUseId?: string | undefined;
+        }[];
+    }>>;
+    permissions: z.ZodArray<z.ZodObject<{
+        requestId: z.ZodString;
+        toolName: z.ZodString;
+        displayName: z.ZodOptional<z.ZodString>;
+        input: z.ZodRecord<z.ZodString, z.ZodUnknown>;
+        description: z.ZodOptional<z.ZodString>;
+        decisionReason: z.ZodOptional<z.ZodString>;
+        toolUseId: z.ZodOptional<z.ZodString>;
+        /** A subagent's request. */
+        agentId: z.ZodOptional<z.ZodString>;
+        /** The call as the card previews it, when the input alone does not tell it. */
+        preview: z.ZodOptional<z.ZodObject<{
+            id: z.ZodString;
+            name: z.ZodString;
+            displayName: z.ZodOptional<z.ZodString>;
+            input: z.ZodUnknown;
+            /** streaming, running, done, error, denied, stopped. */
+            status: z.ZodString;
+            result: z.ZodOptional<z.ZodObject<{
+                text: z.ZodString;
+                isError: z.ZodBoolean;
+                /** The program's structured result: a run's stdout, an edit's patch. */
+                structured: z.ZodOptional<z.ZodUnknown>;
+                images: z.ZodArray<z.ZodObject<{
+                    mediaType: z.ZodString;
+                    /** How many bytes the image takes. */
+                    bytes: z.ZodNumber;
+                }, "strip", z.ZodTypeAny, {
+                    mediaType: string;
+                    bytes: number;
+                }, {
+                    mediaType: string;
+                    bytes: number;
+                }>, "many">;
+                /** The text was longer than MAX_RESULT_TEXT and is cut there. */
+                truncated: z.ZodOptional<z.ZodBoolean>;
+            }, "strip", z.ZodTypeAny, {
+                text: string;
+                images: {
+                    mediaType: string;
+                    bytes: number;
+                }[];
+                isError: boolean;
+                structured?: unknown;
+                truncated?: boolean | undefined;
+            }, {
+                text: string;
+                images: {
+                    mediaType: string;
+                    bytes: number;
+                }[];
+                isError: boolean;
+                structured?: unknown;
+                truncated?: boolean | undefined;
+            }>>;
+            /** The agent call it runs under; null on the main thread. */
+            parentToolUseId: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            status: string;
+            id: string;
+            name: string;
+            parentToolUseId: string | null;
+            displayName?: string | undefined;
+            input?: unknown;
+            result?: {
+                text: string;
+                images: {
+                    mediaType: string;
+                    bytes: number;
+                }[];
+                isError: boolean;
+                structured?: unknown;
+                truncated?: boolean | undefined;
+            } | undefined;
+        }, {
+            status: string;
+            id: string;
+            name: string;
+            parentToolUseId: string | null;
+            displayName?: string | undefined;
+            input?: unknown;
+            result?: {
+                text: string;
+                images: {
+                    mediaType: string;
+                    bytes: number;
+                }[];
+                isError: boolean;
+                structured?: unknown;
+                truncated?: boolean | undefined;
+            } | undefined;
+        }>>;
+        /**
+         * What "always allow" would add, one choice each, in the serving
+         * device's words ("Allow Bash(npm test:*) in this folder"): chat.answer
+         * picks them by index.
+         */
+        suggestions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            label: string;
+        }, {
+            label: string;
+        }>, "many">>;
+    }, "strip", z.ZodTypeAny, {
+        input: Record<string, unknown>;
+        requestId: string;
+        toolName: string;
+        toolUseId?: string | undefined;
+        description?: string | undefined;
+        displayName?: string | undefined;
+        decisionReason?: string | undefined;
+        agentId?: string | undefined;
+        preview?: {
+            status: string;
+            id: string;
+            name: string;
+            parentToolUseId: string | null;
+            displayName?: string | undefined;
+            input?: unknown;
+            result?: {
+                text: string;
+                images: {
+                    mediaType: string;
+                    bytes: number;
+                }[];
+                isError: boolean;
+                structured?: unknown;
+                truncated?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        suggestions?: {
+            label: string;
+        }[] | undefined;
+    }, {
+        input: Record<string, unknown>;
+        requestId: string;
+        toolName: string;
+        toolUseId?: string | undefined;
+        description?: string | undefined;
+        displayName?: string | undefined;
+        decisionReason?: string | undefined;
+        agentId?: string | undefined;
+        preview?: {
+            status: string;
+            id: string;
+            name: string;
+            parentToolUseId: string | null;
+            displayName?: string | undefined;
+            input?: unknown;
+            result?: {
+                text: string;
+                images: {
+                    mediaType: string;
+                    bytes: number;
+                }[];
+                isError: boolean;
+                structured?: unknown;
+                truncated?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        suggestions?: {
+            label: string;
+        }[] | undefined;
+    }>, "many">;
+}, "strip", z.ZodTypeAny, {
+    agent: "claude" | "codex";
+    title: string;
+    running: boolean;
+    process: "running" | "none" | "exited";
+    turn: {
+        outputTokens: number;
+        status?: string | undefined;
+        startedAt?: number | undefined;
+    } | null;
+    streaming: {
+        messageId: string;
+        blocks: {
+            type: "text" | "thinking" | "tool_use";
+            text: string;
+            toolUseId?: string | undefined;
+        }[];
+    } | null;
+    permissions: {
+        input: Record<string, unknown>;
+        requestId: string;
+        toolName: string;
+        toolUseId?: string | undefined;
+        description?: string | undefined;
+        displayName?: string | undefined;
+        decisionReason?: string | undefined;
+        agentId?: string | undefined;
+        preview?: {
+            status: string;
+            id: string;
+            name: string;
+            parentToolUseId: string | null;
+            displayName?: string | undefined;
+            input?: unknown;
+            result?: {
+                text: string;
+                images: {
+                    mediaType: string;
+                    bytes: number;
+                }[];
+                isError: boolean;
+                structured?: unknown;
+                truncated?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        suggestions?: {
+            label: string;
+        }[] | undefined;
+    }[];
+    model?: string | undefined;
+    effort?: string | undefined;
+    permissionMode?: string | undefined;
+}, {
+    agent: "claude" | "codex";
+    title: string;
+    running: boolean;
+    process: "running" | "none" | "exited";
+    turn: {
+        outputTokens: number;
+        status?: string | undefined;
+        startedAt?: number | undefined;
+    } | null;
+    streaming: {
+        messageId: string;
+        blocks: {
+            type: "text" | "thinking" | "tool_use";
+            text: string;
+            toolUseId?: string | undefined;
+        }[];
+    } | null;
+    permissions: {
+        input: Record<string, unknown>;
+        requestId: string;
+        toolName: string;
+        toolUseId?: string | undefined;
+        description?: string | undefined;
+        displayName?: string | undefined;
+        decisionReason?: string | undefined;
+        agentId?: string | undefined;
+        preview?: {
+            status: string;
+            id: string;
+            name: string;
+            parentToolUseId: string | null;
+            displayName?: string | undefined;
+            input?: unknown;
+            result?: {
+                text: string;
+                images: {
+                    mediaType: string;
+                    bytes: number;
+                }[];
+                isError: boolean;
+                structured?: unknown;
+                truncated?: boolean | undefined;
+            } | undefined;
+        } | undefined;
+        suggestions?: {
+            label: string;
+        }[] | undefined;
+    }[];
+    model?: string | undefined;
+    effort?: string | undefined;
+    permissionMode?: string | undefined;
+}>;
+export type ChatStatus = z.infer<typeof ChatStatusSchema>;
+/** One step of the agent's to-do list. */
+export declare const ViewTodoSchema: z.ZodObject<{
+    content: z.ZodString;
+    /** pending, in_progress or completed. */
+    status: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    content: string;
+}, {
+    status: string;
+    content: string;
+}>;
+/** A subagent the turn called (an Agent tool call). */
+export declare const ViewAgentRowSchema: z.ZodObject<{
+    toolUseId: z.ZodString;
+    description: z.ZodString;
+    /** running, completed, failed or stopped. */
+    status: z.ZodString;
+    startedAt: z.ZodOptional<z.ZodNumber>;
+    endedAt: z.ZodOptional<z.ZodNumber>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    toolUseId: string;
+    description: string;
+    startedAt?: number | undefined;
+    endedAt?: number | undefined;
+}, {
+    status: string;
+    toolUseId: string;
+    description: string;
+    startedAt?: number | undefined;
+    endedAt?: number | undefined;
+}>;
+/** A goal the chat works toward (/goal), and where it stands. */
+export declare const ViewGoalSchema: z.ZodObject<{
+    condition: z.ZodString;
+    /** active, paused, met or failed. */
+    status: z.ZodString;
+    setAt: z.ZodOptional<z.ZodNumber>;
+    /** How many checks found it unmet so far. */
+    checks: z.ZodNumber;
+    /** Once it ended: why. */
+    reason: z.ZodOptional<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    status: string;
+    condition: string;
+    checks: number;
+    setAt?: number | undefined;
+    reason?: string | undefined;
+}, {
+    status: string;
+    condition: string;
+    checks: number;
+    setAt?: number | undefined;
+    reason?: string | undefined;
+}>;
+export type ViewGoal = z.infer<typeof ViewGoalSchema>;
+/**
+ * What the chat's side panel shows beside the conversation: the to-do
+ * list, the tasks and subagents, the files it changed, the context it
+ * fills, what it cost, and its goal.
+ */
+export declare const ChatPanelSchema: z.ZodObject<{
+    todos: z.ZodArray<z.ZodObject<{
+        content: z.ZodString;
+        /** pending, in_progress or completed. */
+        status: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        content: string;
+    }, {
+        status: string;
+        content: string;
+    }>, "many">;
+    /** Background runs and the like, by the program's task ids (chat.stopTask stops one). */
+    tasks: z.ZodArray<z.ZodObject<{
+        taskId: z.ZodString;
+        type: z.ZodString;
+        description: z.ZodString;
+        status: z.ZodString;
+        toolUseId: z.ZodOptional<z.ZodString>;
+        startedAt: z.ZodOptional<z.ZodNumber>;
+        endedAt: z.ZodOptional<z.ZodNumber>;
+        summary: z.ZodOptional<z.ZodString>;
+        activity: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: string;
+        status: string;
+        taskId: string;
+        description: string;
+        toolUseId?: string | undefined;
+        summary?: string | undefined;
+        startedAt?: number | undefined;
+        endedAt?: number | undefined;
+        activity?: string | undefined;
+    }, {
+        type: string;
+        status: string;
+        taskId: string;
+        description: string;
+        toolUseId?: string | undefined;
+        summary?: string | undefined;
+        startedAt?: number | undefined;
+        endedAt?: number | undefined;
+        activity?: string | undefined;
+    }>, "many">;
+    agents: z.ZodArray<z.ZodObject<{
+        toolUseId: z.ZodString;
+        description: z.ZodString;
+        /** running, completed, failed or stopped. */
+        status: z.ZodString;
+        startedAt: z.ZodOptional<z.ZodNumber>;
+        endedAt: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        toolUseId: string;
+        description: string;
+        startedAt?: number | undefined;
+        endedAt?: number | undefined;
+    }, {
+        status: string;
+        toolUseId: string;
+        description: string;
+        startedAt?: number | undefined;
+        endedAt?: number | undefined;
+    }>, "many">;
+    changedFiles: z.ZodArray<z.ZodObject<{
+        /** Absolute, on the serving device, as the chat's tool calls name it. */
+        path: z.ZodString;
+        added: z.ZodOptional<z.ZodNumber>;
+        removed: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        path: string;
+        added?: number | undefined;
+        removed?: number | undefined;
+    }, {
+        path: string;
+        added?: number | undefined;
+        removed?: number | undefined;
+    }>, "many">;
+    /** The context window: tokens in it, and how many it takes; null before the program said. */
+    context: z.ZodNullable<z.ZodObject<{
+        usedTokens: z.ZodNumber;
+        maxTokens: z.ZodNumber;
+    }, "strip", z.ZodTypeAny, {
+        usedTokens: number;
+        maxTokens: number;
+    }, {
+        usedTokens: number;
+        maxTokens: number;
+    }>>;
+    /** What the conversation cost so far, in US dollars, when the program tells it. */
+    costUsd: z.ZodOptional<z.ZodNumber>;
+    goal: z.ZodNullable<z.ZodObject<{
+        condition: z.ZodString;
+        /** active, paused, met or failed. */
+        status: z.ZodString;
+        setAt: z.ZodOptional<z.ZodNumber>;
+        /** How many checks found it unmet so far. */
+        checks: z.ZodNumber;
+        /** Once it ended: why. */
+        reason: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        status: string;
+        condition: string;
+        checks: number;
+        setAt?: number | undefined;
+        reason?: string | undefined;
+    }, {
+        status: string;
+        condition: string;
+        checks: number;
+        setAt?: number | undefined;
+        reason?: string | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    todos: {
+        status: string;
+        content: string;
+    }[];
+    tasks: {
+        type: string;
+        status: string;
+        taskId: string;
+        description: string;
+        toolUseId?: string | undefined;
+        summary?: string | undefined;
+        startedAt?: number | undefined;
+        endedAt?: number | undefined;
+        activity?: string | undefined;
+    }[];
+    agents: {
+        status: string;
+        toolUseId: string;
+        description: string;
+        startedAt?: number | undefined;
+        endedAt?: number | undefined;
+    }[];
+    changedFiles: {
+        path: string;
+        added?: number | undefined;
+        removed?: number | undefined;
+    }[];
+    context: {
+        usedTokens: number;
+        maxTokens: number;
+    } | null;
+    goal: {
+        status: string;
+        condition: string;
+        checks: number;
+        setAt?: number | undefined;
+        reason?: string | undefined;
+    } | null;
+    costUsd?: number | undefined;
+}, {
+    todos: {
+        status: string;
+        content: string;
+    }[];
+    tasks: {
+        type: string;
+        status: string;
+        taskId: string;
+        description: string;
+        toolUseId?: string | undefined;
+        summary?: string | undefined;
+        startedAt?: number | undefined;
+        endedAt?: number | undefined;
+        activity?: string | undefined;
+    }[];
+    agents: {
+        status: string;
+        toolUseId: string;
+        description: string;
+        startedAt?: number | undefined;
+        endedAt?: number | undefined;
+    }[];
+    changedFiles: {
+        path: string;
+        added?: number | undefined;
+        removed?: number | undefined;
+    }[];
+    context: {
+        usedTokens: number;
+        maxTokens: number;
+    } | null;
+    goal: {
+        status: string;
+        condition: string;
+        checks: number;
+        setAt?: number | undefined;
+        reason?: string | undefined;
+    } | null;
+    costUsd?: number | undefined;
+}>;
+export type ChatPanel = z.infer<typeof ChatPanelSchema>;
+//# sourceMappingURL=view.d.ts.map