@termlink/protocol 0.1.0

package/dist/events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.d.ts","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/events.js

@@ -0,0 +1,98 @@
+import { z } from "zod";
+import { HostInfo, PROTOCOL_VERSION, SessionInfo, TerminalSize } from "./common.js";
+import { DecisionEffect, InputRequest } from "./input.js";
+import { DeltaField, Item } from "./items.js";
+const event = (type, payload) => z.object({
+    v: z.literal(PROTOCOL_VERSION),
+    kind: z.literal("evt"),
+    type: z.literal(type),
+    ts: z.number(),
+    sessionId: z.string().optional(),
+    /** Present only on durable session events; increases by one per session. */
+    seq: z.number().int().positive().optional(),
+    payload,
+});
+export const Usage = z.object({
+    inputTokens: z.number().int(),
+    outputTokens: z.number().int(),
+    costUsd: z.number().optional(),
+});
+// Host channel: delivered to every connection, never sequenced.
+export const HostReadyEvent = event("host.ready", HostInfo);
+export const SessionCreatedEvent = event("session.created", z.object({ session: SessionInfo }));
+export const SessionUpdatedEvent = event("session.updated", z.object({ session: SessionInfo }));
+export const SessionClosedEvent = event("session.closed", z.object({
+    session: SessionInfo,
+    reason: z.string().nullable(),
+    /** Terminal sessions: how the shell exited. Null when it was killed. */
+    exitCode: z.number().int().nullable().optional(),
+}));
+// Session channel: delivered to connections attached to the session.
+export const TurnStartedEvent = event("turn.started", z.object({
+    turnId: z.string(),
+    /** The user message item that opened this turn. It arrives just before, with turnId null. */
+    userItemId: z.string().optional(),
+}));
+export const TurnCompletedEvent = event("turn.completed", z.object({
+    turnId: z.string(),
+    status: z.enum(["completed", "interrupted", "failed"]),
+    usage: Usage.optional(),
+    error: z.string().optional(),
+}));
+export const ItemStartedEvent = event("item.started", z.object({ turnId: z.string().nullable(), item: Item }));
+export const ItemDeltaEvent = event("item.delta", z.object({ itemId: z.string(), field: DeltaField, delta: z.string() }));
+/** Full snapshot of an item still in progress. Used for catch-up after attach. */
+export const ItemUpdatedEvent = event("item.updated", z.object({ item: Item }));
+/** Final, authoritative state of an item. May arrive without a matching item.started. */
+export const ItemCompletedEvent = event("item.completed", z.object({ turnId: z.string().nullable(), item: Item }));
+export const InputRequiredEvent = event("input.required", z.object({ request: InputRequest }));
+export const InputResolvedEvent = event("input.resolved", z.object({
+    requestId: z.string(),
+    decisionId: z.string().nullable(),
+    effect: DecisionEffect,
+    by: z.enum(["user", "policy", "host"]),
+}));
+export const ErrorEvent = event("error", z.object({ code: z.string(), message: z.string() }));
+/** Provider-specific data with no common shape yet. Clients may ignore it. */
+export const ProviderEvent = event("provider.event", z.object({ name: z.string(), data: z.unknown() }));
+// Terminal channel: delivered to connections attached to a terminal session. Never sequenced.
+/** The PTY size changed. */
+export const TerminalSizeEvent = event("terminal.size", TerminalSize);
+/**
+ * Clear your terminal: the whole screen follows as output bytes. Sent to everyone
+ * attached when a client attaches, since the relay cannot address one client.
+ */
+export const TerminalResetEvent = event("terminal.reset", TerminalSize);
+export const AgentEvent = z.discriminatedUnion("type", [
+    HostReadyEvent,
+    SessionCreatedEvent,
+    SessionUpdatedEvent,
+    SessionClosedEvent,
+    TurnStartedEvent,
+    TurnCompletedEvent,
+    ItemStartedEvent,
+    ItemDeltaEvent,
+    ItemUpdatedEvent,
+    ItemCompletedEvent,
+    InputRequiredEvent,
+    InputResolvedEvent,
+    ErrorEvent,
+    ProviderEvent,
+    TerminalSizeEvent,
+    TerminalResetEvent,
+]);
+/** Session events that get a seq and are kept for replay. Everything else is ephemeral. */
+export const DURABLE_EVENT_TYPES = [
+    "turn.started",
+    "turn.completed",
+    "item.started",
+    "item.completed",
+    "input.required",
+    "input.resolved",
+    "error",
+];
+const durable = new Set(DURABLE_EVENT_TYPES);
+export function isDurableEvent(type) {
+    return durable.has(type);
+}
+//# sourceMappingURL=events.js.map

package/dist/events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"events.js","sourceRoot":"","sources":["../src/events.ts"],"names":[],"mappings":"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"}

package/dist/frames.d.ts

@@ -0,0 +1,49 @@
+import { z } from "zod";
+/**
+ * One piece of a message too large for a single transport frame. The TermLink relay
+ * caps frames at 64 KiB, so both sides split larger messages and reassemble them.
+ * `data` pieces concatenated in index order are the original message's JSON text.
+ */
+export declare const Chunk: z.ZodObject<{
+    v: z.ZodLiteral<1>;
+    kind: z.ZodLiteral<"chunk">;
+    id: z.ZodString;
+    index: z.ZodNumber;
+    total: z.ZodNumber;
+    data: z.ZodString;
+}, z.core.$strip>;
+export type Chunk = z.infer<typeof Chunk>;
+/** Frame limit that fits under the relay's 64 KiB with room to spare. */
+export declare const RELAY_FRAME_BYTES: number;
+/** Serializes a message into one or more text frames, each at most `maxBytes` of UTF-8. */
+export declare function encodeFrames(message: unknown, maxBytes: number, makeId: () => string): string[];
+/**
+ * Reassembles chunked messages. push() returns the parsed message once a frame
+ * completes one (a whole message completes immediately), or undefined while
+ * pieces are still missing. Incomplete messages are dropped after `timeoutMs`.
+ */
+export declare class FrameAssembler {
+    #private;
+    constructor(options?: {
+        maxMessageBytes?: number;
+        timeoutMs?: number;
+    });
+    /** Throws on a frame that is not JSON or a message that grows past the size limit. */
+    push(frame: string, now?: number): unknown;
+}
+export declare const TERMINAL_FRAME_OUTPUT: 1;
+export declare const TERMINAL_FRAME_INPUT: 2;
+export type TerminalFrameKind = typeof TERMINAL_FRAME_OUTPUT | typeof TERMINAL_FRAME_INPUT;
+export interface TerminalFrame {
+    kind: TerminalFrameKind;
+    sessionId: string;
+    payload: Uint8Array;
+}
+/** Largest payload per frame: the relay's limit less the header and some room. */
+export declare const TERMINAL_FRAME_PAYLOAD_BYTES: number;
+export declare function encodeTerminalFrame(kind: TerminalFrameKind, sessionId: string, payload: Uint8Array): Uint8Array;
+/** Returns null for anything that is not a terminal frame. */
+export declare function decodeTerminalFrame(data: Uint8Array): TerminalFrame | null;
+/** Splits a byte run into frames that each fit under the relay's frame limit. */
+export declare function encodeTerminalFrames(kind: TerminalFrameKind, sessionId: string, payload: Uint8Array, maxPayloadBytes?: number): Uint8Array[];
+//# sourceMappingURL=frames.d.ts.map

package/dist/frames.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.d.ts","sourceRoot":"","sources":["../src/frames.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB;;;;GAIG;AACH,eAAO,MAAM,KAAK;;;;;;;iBAOhB,CAAC;AACH,MAAM,MAAM,KAAK,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,KAAK,CAAC,CAAC;AAE1C,yEAAyE;AACzE,eAAO,MAAM,iBAAiB,QAAY,CAAC;AAS3C,2FAA2F;AAC3F,wBAAgB,YAAY,CAAC,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,MAAM,GAAG,MAAM,EAAE,CA0B/F;AASD;;;;GAIG;AACH,qBAAa,cAAc;;IAKzB,YAAY,OAAO,GAAE;QAAE,eAAe,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,EAGzE;IAED,sFAAsF;IACtF,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,SAAa,GAAG,OAAO,CAuB7C;CAOF;AAWD,eAAO,MAAM,qBAAqB,EAAG,CAAU,CAAC;AAChD,eAAO,MAAM,oBAAoB,EAAG,CAAU,CAAC;AAC/C,MAAM,MAAM,iBAAiB,GAAG,OAAO,qBAAqB,GAAG,OAAO,oBAAoB,CAAC;AAE3F,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,iBAAiB,CAAC;IACxB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,UAAU,CAAC;CACrB;AAED,kFAAkF;AAClF,eAAO,MAAM,4BAA4B,QAA0B,CAAC;AAIpE,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,iBAAiB,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,GAAG,UAAU,CAS/G;AAED,8DAA8D;AAC9D,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,UAAU,GAAG,aAAa,GAAG,IAAI,CAO1E;AAED,iFAAiF;AACjF,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,iBAAiB,EACvB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,UAAU,EACnB,eAAe,SAA+B,GAC7C,UAAU,EAAE,CAOd"}

package/dist/frames.js

@@ -0,0 +1,143 @@
+import { z } from "zod";
+import { PROTOCOL_VERSION } from "./common.js";
+/**
+ * One piece of a message too large for a single transport frame. The TermLink relay
+ * caps frames at 64 KiB, so both sides split larger messages and reassemble them.
+ * `data` pieces concatenated in index order are the original message's JSON text.
+ */
+export const Chunk = z.object({
+    v: z.literal(PROTOCOL_VERSION),
+    kind: z.literal("chunk"),
+    id: z.string().min(1).max(64),
+    index: z.number().int().min(0),
+    total: z.number().int().min(1).max(100_000),
+    data: z.string(),
+});
+/** Frame limit that fits under the relay's 64 KiB with room to spare. */
+export const RELAY_FRAME_BYTES = 60 * 1024;
+const encoder = new TextEncoder();
+const byteLength = (text) => encoder.encode(text).length;
+function isHighSurrogate(code) {
+    return code >= 0xd800 && code <= 0xdbff;
+}
+/** Serializes a message into one or more text frames, each at most `maxBytes` of UTF-8. */
+export function encodeFrames(message, maxBytes, makeId) {
+    const json = JSON.stringify(message);
+    if (byteLength(json) <= maxBytes)
+        return [json];
+    const id = makeId();
+    // Frame overhead besides `data`, with room for the index and total digits.
+    const overhead = byteLength(JSON.stringify({ v: PROTOCOL_VERSION, kind: "chunk", id, index: 0, total: 0, data: "" })) + 16;
+    const budget = maxBytes - overhead;
+    if (budget < 64)
+        throw new Error(`frame limit ${maxBytes} is too small`);
+    const parts = [];
+    let rest = json;
+    while (rest.length > 0) {
+        let size = Math.min(rest.length, budget);
+        for (;;) {
+            // Never split a surrogate pair across frames.
+            if (size < rest.length && isHighSurrogate(rest.charCodeAt(size - 1)))
+                size--;
+            if (byteLength(JSON.stringify(rest.slice(0, size))) <= budget || size <= 1)
+                break;
+            size = Math.floor(size / 2);
+        }
+        parts.push(rest.slice(0, size));
+        rest = rest.slice(size);
+    }
+    return parts.map((data, index) => JSON.stringify({ v: PROTOCOL_VERSION, kind: "chunk", id, index, total: parts.length, data }));
+}
+/**
+ * Reassembles chunked messages. push() returns the parsed message once a frame
+ * completes one (a whole message completes immediately), or undefined while
+ * pieces are still missing. Incomplete messages are dropped after `timeoutMs`.
+ */
+export class FrameAssembler {
+    #pending = new Map();
+    #maxMessageBytes;
+    #timeoutMs;
+    constructor(options = {}) {
+        this.#maxMessageBytes = options.maxMessageBytes ?? 16 * 1024 * 1024;
+        this.#timeoutMs = options.timeoutMs ?? 60_000;
+    }
+    /** Throws on a frame that is not JSON or a message that grows past the size limit. */
+    push(frame, now = Date.now()) {
+        const data = JSON.parse(frame);
+        const chunk = Chunk.safeParse(data);
+        if (!chunk.success)
+            return data;
+        this.#expire(now);
+        const { id, index, total, data: piece } = chunk.data;
+        let pending = this.#pending.get(id);
+        if (!pending) {
+            pending = { parts: new Array(total), received: 0, bytes: 0, startedAt: now };
+            this.#pending.set(id, pending);
+        }
+        if (index >= pending.parts.length || pending.parts[index] !== undefined)
+            return undefined;
+        pending.parts[index] = piece;
+        pending.received++;
+        pending.bytes += piece.length;
+        if (pending.bytes > this.#maxMessageBytes) {
+            this.#pending.delete(id);
+            throw new Error(`chunked message ${id} exceeds ${this.#maxMessageBytes} bytes`);
+        }
+        if (pending.received < pending.parts.length)
+            return undefined;
+        this.#pending.delete(id);
+        return JSON.parse(pending.parts.join(""));
+    }
+    #expire(now) {
+        for (const [id, pending] of this.#pending) {
+            if (now - pending.startedAt > this.#timeoutMs)
+                this.#pending.delete(id);
+        }
+    }
+}
+// Terminal bytes travel in WebSocket binary frames, not in JSON, so nothing is base64
+// encoded or parsed on the way. Every frame names its session, because the relay merges
+// all clients into one host socket and no per-connection numbering is possible.
+//
+//   byte 0      kind: 1 = output (host -> client), 2 = input (client -> host)
+//   byte 1      length n of the session id
+//   byte 2..    session id, n ASCII bytes
+//   the rest    PTY bytes as they are
+export const TERMINAL_FRAME_OUTPUT = 1;
+export const TERMINAL_FRAME_INPUT = 2;
+/** Largest payload per frame: the relay's limit less the header and some room. */
+export const TERMINAL_FRAME_PAYLOAD_BYTES = RELAY_FRAME_BYTES - 128;
+const TERMINAL_FRAME_KINDS = [TERMINAL_FRAME_OUTPUT, TERMINAL_FRAME_INPUT];
+export function encodeTerminalFrame(kind, sessionId, payload) {
+    const id = encoder.encode(sessionId);
+    if (id.length === 0 || id.length > 255)
+        throw new Error(`session id is ${id.length} bytes; 1-255 allowed`);
+    const frame = new Uint8Array(2 + id.length + payload.length);
+    frame[0] = kind;
+    frame[1] = id.length;
+    frame.set(id, 2);
+    frame.set(payload, 2 + id.length);
+    return frame;
+}
+/** Returns null for anything that is not a terminal frame. */
+export function decodeTerminalFrame(data) {
+    if (data.length < 3)
+        return null;
+    const kind = data[0] ?? 0;
+    const idLength = data[1] ?? 0;
+    if (!TERMINAL_FRAME_KINDS.includes(kind) || idLength === 0 || data.length < 2 + idLength)
+        return null;
+    const sessionId = new TextDecoder().decode(data.subarray(2, 2 + idLength));
+    return { kind: kind, sessionId, payload: data.subarray(2 + idLength) };
+}
+/** Splits a byte run into frames that each fit under the relay's frame limit. */
+export function encodeTerminalFrames(kind, sessionId, payload, maxPayloadBytes = TERMINAL_FRAME_PAYLOAD_BYTES) {
+    if (payload.length <= maxPayloadBytes)
+        return [encodeTerminalFrame(kind, sessionId, payload)];
+    const frames = [];
+    for (let offset = 0; offset < payload.length; offset += maxPayloadBytes) {
+        frames.push(encodeTerminalFrame(kind, sessionId, payload.subarray(offset, offset + maxPayloadBytes)));
+    }
+    return frames;
+}
+//# sourceMappingURL=frames.js.map

package/dist/frames.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"frames.js","sourceRoot":"","sources":["../src/frames.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export * from "./common.js";
+export * from "./items.js";
+export * from "./input.js";
+export * from "./events.js";
+export * from "./commands.js";
+export * from "./frames.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,7 @@
+export * from "./common.js";
+export * from "./items.js";
+export * from "./input.js";
+export * from "./events.js";
+export * from "./commands.js";
+export * from "./frames.js";
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC;AAC5B,cAAc,YAAY,CAAC;AAC3B,cAAc,YAAY,CAAC;AAC3B,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,aAAa,CAAC"}

package/dist/input.d.ts

@@ -0,0 +1,91 @@
+import { z } from "zod";
+/** What a decision does. The host maps it back to the provider's own vocabulary. */
+export declare const DecisionEffect: z.ZodEnum<{
+    allow: "allow";
+    allow_session: "allow_session";
+    cancel: "cancel";
+    deny: "deny";
+}>;
+export type DecisionEffect = z.infer<typeof DecisionEffect>;
+export declare const Decision: z.ZodObject<{
+    id: z.ZodString;
+    label: z.ZodString;
+    effect: z.ZodEnum<{
+        allow: "allow";
+        allow_session: "allow_session";
+        cancel: "cancel";
+        deny: "deny";
+    }>;
+}, z.core.$strip>;
+export type Decision = z.infer<typeof Decision>;
+export declare const Question: z.ZodObject<{
+    id: z.ZodString;
+    question: z.ZodString;
+    options: z.ZodArray<z.ZodObject<{
+        label: z.ZodString;
+        description: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+    multiSelect: z.ZodBoolean;
+}, z.core.$strip>;
+export type Question = z.infer<typeof Question>;
+export declare const InputKind: z.ZodEnum<{
+    command_approval: "command_approval";
+    file_approval: "file_approval";
+    plan_approval: "plan_approval";
+    question: "question";
+    tool_approval: "tool_approval";
+}>;
+export type InputKind = z.infer<typeof InputKind>;
+/**
+ * Anything that blocks a turn until a person answers. The host decides which
+ * decisions exist; clients render them and reply with a decisionId.
+ */
+export declare const InputRequest: z.ZodObject<{
+    requestId: z.ZodString;
+    kind: z.ZodEnum<{
+        command_approval: "command_approval";
+        file_approval: "file_approval";
+        plan_approval: "plan_approval";
+        question: "question";
+        tool_approval: "tool_approval";
+    }>;
+    itemId: z.ZodOptional<z.ZodString>;
+    title: z.ZodString;
+    body: z.ZodOptional<z.ZodString>;
+    command: z.ZodOptional<z.ZodString>;
+    cwd: z.ZodOptional<z.ZodString>;
+    changes: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        path: z.ZodString;
+        action: z.ZodEnum<{
+            add: "add";
+            delete: "delete";
+            modify: "modify";
+            rename: "rename";
+        }>;
+        movePath: z.ZodOptional<z.ZodString>;
+        diff: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>>;
+    toolName: z.ZodOptional<z.ZodString>;
+    toolInput: z.ZodOptional<z.ZodUnknown>;
+    questions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        question: z.ZodString;
+        options: z.ZodArray<z.ZodObject<{
+            label: z.ZodString;
+            description: z.ZodOptional<z.ZodString>;
+        }, z.core.$strip>>;
+        multiSelect: z.ZodBoolean;
+    }, z.core.$strip>>>;
+    decisions: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        label: z.ZodString;
+        effect: z.ZodEnum<{
+            allow: "allow";
+            allow_session: "allow_session";
+            cancel: "cancel";
+            deny: "deny";
+        }>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type InputRequest = z.infer<typeof InputRequest>;
+//# sourceMappingURL=input.d.ts.map

package/dist/input.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.d.ts","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,oFAAoF;AACpF,eAAO,MAAM,cAAc;;;;;EAAuD,CAAC;AACnF,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,QAAQ;;;;;;;;;iBAInB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,QAAQ;;;;;;;;iBAKnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC;AAEhD,eAAO,MAAM,SAAS;;;;;;EAMpB,CAAC;AACH,MAAM,MAAM,SAAS,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,SAAS,CAAC,CAAC;AAElD;;;GAGG;AACH,eAAO,MAAM,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAcvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC"}

package/dist/input.js

@@ -0,0 +1,42 @@
+import { z } from "zod";
+import { FileChange } from "./items.js";
+/** What a decision does. The host maps it back to the provider's own vocabulary. */
+export const DecisionEffect = z.enum(["allow", "allow_session", "deny", "cancel"]);
+export const Decision = z.object({
+    id: z.string(),
+    label: z.string(),
+    effect: DecisionEffect,
+});
+export const Question = z.object({
+    id: z.string(),
+    question: z.string(),
+    options: z.array(z.object({ label: z.string(), description: z.string().optional() })),
+    multiSelect: z.boolean(),
+});
+export const InputKind = z.enum([
+    "command_approval",
+    "file_approval",
+    "tool_approval",
+    "question",
+    "plan_approval",
+]);
+/**
+ * Anything that blocks a turn until a person answers. The host decides which
+ * decisions exist; clients render them and reply with a decisionId.
+ */
+export const InputRequest = z.object({
+    requestId: z.string(),
+    kind: InputKind,
+    /** The item this request is about, when there is one. */
+    itemId: z.string().optional(),
+    title: z.string(),
+    body: z.string().optional(),
+    command: z.string().optional(),
+    cwd: z.string().optional(),
+    changes: z.array(FileChange).optional(),
+    toolName: z.string().optional(),
+    toolInput: z.unknown().optional(),
+    questions: z.array(Question).optional(),
+    decisions: z.array(Decision).min(1),
+});
+//# sourceMappingURL=input.js.map

package/dist/input.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"input.js","sourceRoot":"","sources":["../src/input.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAExC,oFAAoF;AACpF,MAAM,CAAC,MAAM,cAAc,GAAG,CAAC,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,QAAQ,CAAC,CAAC,CAAC;AAGnF,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,MAAM,EAAE,cAAc;CACvB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,MAAM,CAAC;IAC/B,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE;IACd,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE;IACpB,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC;IACrF,WAAW,EAAE,CAAC,CAAC,OAAO,EAAE;CACzB,CAAC,CAAC;AAGH,MAAM,CAAC,MAAM,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC;IAC9B,kBAAkB;IAClB,eAAe;IACf,eAAe;IACf,UAAU;IACV,eAAe;CAChB,CAAC,CAAC;AAGH;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;IACrB,IAAI,EAAE,SAAS;IACf,yDAAyD;IACzD,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,KAAK,EAAE,CAAC,CAAC,MAAM,EAAE;IACjB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC1B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,EAAE;IACvC,SAAS,EAAE,CAAC,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACpC,CAAC,CAAC"}