@termlink/protocol 0.1.0

package/dist/commands.d.ts.map

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

package/dist/commands.js

@@ -0,0 +1,96 @@
+import { z } from "zod";
+import { AutoApprove, PROTOCOL_VERSION, ProviderId, TerminalSize } from "./common.js";
+import { AgentEvent } from "./events.js";
+const command = (type, payload) => z.object({
+    v: z.literal(PROTOCOL_VERSION),
+    kind: z.literal("cmd"),
+    reqId: z.string().min(1).max(64),
+    type: z.literal(type),
+    payload,
+});
+const id = z.string().min(1).max(64);
+const SessionRef = z.object({ sessionId: id });
+export const UserInput = z.object({
+    text: z.string().min(1).max(100_000),
+});
+export const HostInfoCommand = command("host.info", z.object({}));
+export const SessionListCommand = command("session.list", z.object({}));
+export const SessionCreateCommand = command("session.create", z.object({
+    provider: ProviderId,
+    cwd: z.string().min(1).max(4096),
+    title: z.string().max(200).optional(),
+    /** Agent sessions: defaults to the host's setting (off unless the host was started otherwise). */
+    autoApprove: AutoApprove.optional(),
+    /** Terminal sessions: initial size. Defaults to 80x24. */
+    cols: TerminalSize.shape.cols.optional(),
+    rows: TerminalSize.shape.rows.optional(),
+    /**
+     * Terminal sessions: names this client for flow control (see terminal.ack).
+     * The creating connection is attached as this client.
+     */
+    clientId: id.optional(),
+}));
+export const SessionAttachCommand = command("session.attach", SessionRef.extend({
+    /** Agent sessions: replay durable events after this seq. */
+    afterSeq: z.number().int().min(0).optional(),
+    /** Terminal sessions: names this client for flow control (see terminal.ack). */
+    clientId: id.optional(),
+}));
+export const SessionDetachCommand = command("session.detach", SessionRef.extend({ clientId: id.optional() }));
+export const SessionSendCommand = command("session.send", SessionRef.extend({ input: UserInput }));
+export const SessionInterruptCommand = command("session.interrupt", SessionRef);
+export const SessionCloseCommand = command("session.close", SessionRef);
+/** Changes agent session settings. Changing autoApprove also applies to approvals already waiting. */
+export const SessionConfigureCommand = command("session.configure", SessionRef.extend({ autoApprove: AutoApprove.optional() }));
+export const InputRespondCommand = command("input.respond", SessionRef.extend({
+    requestId: id,
+    decisionId: id,
+    /** Answers to question-kind requests, keyed by question id. */
+    answers: z.record(z.string(), z.string()).optional(),
+}));
+// Terminal sessions. Bytes travel in binary frames (see frames.ts); these are the controls.
+/** Sets the PTY size. The last client to ask wins; everyone hears terminal.size. */
+export const TerminalResizeCommand = command("terminal.resize", SessionRef.extend(TerminalSize.shape));
+/**
+ * Flow control. `bytes` is how much terminal output this client has written to its
+ * terminal since it attached (cumulative). The host pauses the shell when the slowest
+ * client falls too far behind, so a phone on a slow link is not dropped by the relay.
+ */
+export const TerminalAckCommand = command("terminal.ack", SessionRef.extend({ clientId: id, bytes: z.number().int().min(0) }));
+/** Ends the shell process. Ctrl+C is not a command: it is the byte 0x03 written to the terminal. */
+export const TerminalKillCommand = command("terminal.kill", SessionRef);
+export const Command = z.discriminatedUnion("type", [
+    HostInfoCommand,
+    SessionListCommand,
+    SessionCreateCommand,
+    SessionAttachCommand,
+    SessionDetachCommand,
+    SessionSendCommand,
+    SessionInterruptCommand,
+    SessionCloseCommand,
+    SessionConfigureCommand,
+    InputRespondCommand,
+    TerminalResizeCommand,
+    TerminalAckCommand,
+    TerminalKillCommand,
+]);
+export const ErrorCode = z.enum(["bad_request", "forbidden", "not_found", "conflict", "unsupported", "internal"]);
+export const Response = z.union([
+    z.object({
+        v: z.literal(PROTOCOL_VERSION),
+        kind: z.literal("res"),
+        reqId: z.string(),
+        ok: z.literal(true),
+        result: z.unknown(),
+    }),
+    z.object({
+        v: z.literal(PROTOCOL_VERSION),
+        kind: z.literal("res"),
+        reqId: z.string(),
+        ok: z.literal(false),
+        error: z.object({ code: ErrorCode, message: z.string() }),
+    }),
+]);
+/** Everything a host sends to a client as JSON. Terminal bytes travel as binary frames. */
+export const HostMessage = z.union([AgentEvent, Response]);
+//# sourceMappingURL=commands.js.map

package/dist/commands.js.map

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

package/dist/common.d.ts

@@ -0,0 +1,109 @@
+import { z } from "zod";
+export declare const PROTOCOL_VERSION: 1;
+/**
+ * What a session carries. A terminal is a byte stream to a shell; an agent session is
+ * turns, items and approval requests in JSON.
+ */
+export declare const SessionKind: z.ZodEnum<{
+    agent: "agent";
+    terminal: "terminal";
+}>;
+export type SessionKind = z.infer<typeof SessionKind>;
+/**
+ * Provider ids are open strings: a host lists the ones it has in host.ready, with a
+ * kind and a label, so clients need not know them ahead of time.
+ */
+export declare const ProviderId: z.ZodString;
+export type ProviderId = z.infer<typeof ProviderId>;
+export declare const TERMINAL_PROVIDER: "terminal";
+export declare const SessionStatus: z.ZodEnum<{
+    closed: "closed";
+    idle: "idle";
+    running: "running";
+    starting: "starting";
+    waiting_input: "waiting_input";
+}>;
+export type SessionStatus = z.infer<typeof SessionStatus>;
+/**
+ * How an agent session answers approvals by itself. A convenience, not a security boundary:
+ * the boundary stays the OS account and the agent's own sandbox.
+ *   off    ask for everything
+ *   edits  allow file changes
+ *   all    allow commands, file changes and other tools
+ * Questions and plan approvals always wait for a person.
+ */
+export declare const AutoApprove: z.ZodEnum<{
+    all: "all";
+    edits: "edits";
+    off: "off";
+}>;
+export type AutoApprove = z.infer<typeof AutoApprove>;
+export declare const TerminalSize: z.ZodObject<{
+    cols: z.ZodNumber;
+    rows: z.ZodNumber;
+}, z.core.$strip>;
+export type TerminalSize = z.infer<typeof TerminalSize>;
+export declare const SessionInfo: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        agent: "agent";
+        terminal: "terminal";
+    }>;
+    provider: z.ZodString;
+    providerSessionId: z.ZodNullable<z.ZodString>;
+    cwd: z.ZodString;
+    title: z.ZodNullable<z.ZodString>;
+    status: z.ZodEnum<{
+        closed: "closed";
+        idle: "idle";
+        running: "running";
+        starting: "starting";
+        waiting_input: "waiting_input";
+    }>;
+    createdAt: z.ZodNumber;
+    updatedAt: z.ZodNumber;
+    lastSeq: z.ZodNumber;
+    autoApprove: z.ZodOptional<z.ZodEnum<{
+        all: "all";
+        edits: "edits";
+        off: "off";
+    }>>;
+    cols: z.ZodOptional<z.ZodNumber>;
+    rows: z.ZodOptional<z.ZodNumber>;
+    pid: z.ZodOptional<z.ZodNumber>;
+    exitCode: z.ZodOptional<z.ZodNullable<z.ZodNumber>>;
+}, z.core.$strip>;
+export type SessionInfo = z.infer<typeof SessionInfo>;
+export declare const ProviderStatus: z.ZodObject<{
+    id: z.ZodString;
+    kind: z.ZodEnum<{
+        agent: "agent";
+        terminal: "terminal";
+    }>;
+    label: z.ZodString;
+    available: z.ZodBoolean;
+    version: z.ZodNullable<z.ZodString>;
+    detail: z.ZodNullable<z.ZodString>;
+}, z.core.$strip>;
+export type ProviderStatus = z.infer<typeof ProviderStatus>;
+export declare const HostInfo: z.ZodObject<{
+    hostId: z.ZodString;
+    name: z.ZodString;
+    version: z.ZodString;
+    protocol: z.ZodLiteral<1>;
+    os: z.ZodString;
+    providers: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        kind: z.ZodEnum<{
+            agent: "agent";
+            terminal: "terminal";
+        }>;
+        label: z.ZodString;
+        available: z.ZodBoolean;
+        version: z.ZodNullable<z.ZodString>;
+        detail: z.ZodNullable<z.ZodString>;
+    }, z.core.$strip>>;
+    roots: z.ZodOptional<z.ZodArray<z.ZodString>>;
+}, z.core.$strip>;
+export type HostInfo = z.infer<typeof HostInfo>;
+//# sourceMappingURL=common.d.ts.map

package/dist/common.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../src/common.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,eAAO,MAAM,gBAAgB,EAAG,CAAU,CAAC;AAE3C;;;GAGG;AACH,eAAO,MAAM,WAAW;;;EAAgC,CAAC;AACzD,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD;;;GAGG;AACH,eAAO,MAAM,UAAU,aAI8D,CAAC;AACtF,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAEpD,eAAO,MAAM,iBAAiB,EAAG,UAAmB,CAAC;AAErD,eAAO,MAAM,aAAa;;;;;;EAAqE,CAAC;AAChG,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,aAAa,CAAC,CAAC;AAE1D;;;;;;;GAOG;AACH,eAAO,MAAM,WAAW;;;;EAAkC,CAAC;AAC3D,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,YAAY;;;iBAGvB,CAAC;AACH,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,YAAY,CAAC,CAAC;AAExD,eAAO,MAAM,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAqBtB,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,eAAO,MAAM,cAAc;;;;;;;;;;iBAQzB,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAE5D,eAAO,MAAM,QAAQ;;;;;;;;;;;;;;;;;;iBAYnB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,QAAQ,CAAC,CAAC"}

package/dist/common.js

@@ -0,0 +1,76 @@
+import { z } from "zod";
+export const PROTOCOL_VERSION = 1;
+/**
+ * What a session carries. A terminal is a byte stream to a shell; an agent session is
+ * turns, items and approval requests in JSON.
+ */
+export const SessionKind = z.enum(["terminal", "agent"]);
+/**
+ * Provider ids are open strings: a host lists the ones it has in host.ready, with a
+ * kind and a label, so clients need not know them ahead of time.
+ */
+export const ProviderId = z
+    .string()
+    .min(1)
+    .max(32)
+    .regex(/^[a-z][a-z0-9_-]*$/, "provider ids are lowercase letters, digits, _ and -");
+export const TERMINAL_PROVIDER = "terminal";
+export const SessionStatus = z.enum(["starting", "idle", "running", "waiting_input", "closed"]);
+/**
+ * How an agent session answers approvals by itself. A convenience, not a security boundary:
+ * the boundary stays the OS account and the agent's own sandbox.
+ *   off    ask for everything
+ *   edits  allow file changes
+ *   all    allow commands, file changes and other tools
+ * Questions and plan approvals always wait for a person.
+ */
+export const AutoApprove = z.enum(["off", "edits", "all"]);
+export const TerminalSize = z.object({
+    cols: z.number().int().min(1).max(1000),
+    rows: z.number().int().min(1).max(1000),
+});
+export const SessionInfo = z.object({
+    id: z.string(),
+    kind: SessionKind,
+    provider: ProviderId,
+    /** Claude session id or Codex thread id, once the provider has assigned one. Null for terminals. */
+    providerSessionId: z.string().nullable(),
+    cwd: z.string(),
+    title: z.string().nullable(),
+    status: SessionStatus,
+    createdAt: z.number(),
+    updatedAt: z.number(),
+    /** Highest seq emitted on this session so far. Always 0 for terminals, which have no replay log. */
+    lastSeq: z.number().int(),
+    /** Agent sessions only. */
+    autoApprove: AutoApprove.optional(),
+    /** Terminal sessions only. */
+    cols: z.number().int().optional(),
+    rows: z.number().int().optional(),
+    pid: z.number().int().optional(),
+    /** Terminal sessions only, once the shell has exited. */
+    exitCode: z.number().int().nullable().optional(),
+});
+export const ProviderStatus = z.object({
+    id: ProviderId,
+    kind: SessionKind,
+    /** What to call it on screen: "Terminal", "Claude", "Codex". */
+    label: z.string(),
+    available: z.boolean(),
+    version: z.string().nullable(),
+    detail: z.string().nullable(),
+});
+export const HostInfo = z.object({
+    hostId: z.string(),
+    name: z.string(),
+    version: z.string(),
+    protocol: z.literal(PROTOCOL_VERSION),
+    os: z.string(),
+    providers: z.array(ProviderStatus),
+    /**
+     * Folders sessions may be opened in. A relative session.create cwd resolves
+     * against the first one. Absent means the host does not restrict cwd.
+     */
+    roots: z.array(z.string()).optional(),
+});
+//# sourceMappingURL=common.js.map

package/dist/common.js.map

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