chivgent 0.11.0 → 0.12.0

package/dist/remote/client.js

@@ -0,0 +1,173 @@
+import { createConnection } from "node:net";
+import { encodeMessage, FramingError, LineDecoder, parseLine } from "./framing.js";
+import { parseServerMessage, PROTOCOL_VERSION, } from "./protocol.js";
+export class RemoteError extends Error {
+    code;
+    constructor(message, code) {
+        super(message);
+        this.code = code;
+        this.name = "RemoteError";
+    }
+}
+/**
+ * A client attached to a session running in another process.
+ *
+ * It holds no state of its own: it sends prompts and renders what comes back.
+ * That is what keeps a second client honest — two attached clients see one
+ * stream because there is only one session.
+ */
+export class RemoteSession {
+    options;
+    socket;
+    decoder = new LineDecoder();
+    hello;
+    pending;
+    closedReason;
+    constructor(options) {
+        this.options = options;
+    }
+    get session() {
+        if (this.hello === undefined) {
+            throw new RemoteError("Not connected.");
+        }
+        return this.hello.session;
+    }
+    get toolNames() {
+        return this.hello?.tools ?? [];
+    }
+    async connect() {
+        const socket = await new Promise((resolve, reject) => {
+            const candidate = createConnection(this.options.socketPath);
+            candidate.once("connect", () => {
+                candidate.off("error", reject);
+                resolve(candidate);
+            });
+            candidate.once("error", (error) => {
+                reject(new RemoteError(error.code === "ENOENT" || error.code === "ECONNREFUSED"
+                    ? `No chivgent server is listening on ${this.options.socketPath}.`
+                    : `Could not connect to ${this.options.socketPath}: ${error.message}`));
+            });
+        });
+        this.socket = socket;
+        socket.setNoDelay(true);
+        socket.on("data", (chunk) => this.receive(chunk));
+        socket.on("close", () => this.handleClose());
+        socket.on("error", () => this.handleClose());
+        return new Promise((resolve, reject) => {
+            const timer = setTimeout(() => {
+                reject(new RemoteError("The server did not answer the handshake."));
+            }, 5_000);
+            this.onHello = (hello) => {
+                clearTimeout(timer);
+                resolve(hello);
+            };
+            this.onHelloError = (error) => {
+                clearTimeout(timer);
+                reject(error);
+            };
+            this.write({ type: "hello", version: PROTOCOL_VERSION });
+        });
+    }
+    onHello;
+    onHelloError;
+    /** Sends a prompt and resolves when the run it started finishes. */
+    prompt(text) {
+        if (this.socket === undefined) {
+            return Promise.reject(new RemoteError("Not connected."));
+        }
+        if (this.pending !== undefined) {
+            return Promise.reject(new RemoteError("A prompt is already in flight."));
+        }
+        return new Promise((resolve, reject) => {
+            this.pending = { resolve, reject };
+            this.write({ type: "prompt", text });
+        });
+    }
+    interrupt() {
+        if (this.socket !== undefined && !this.socket.destroyed) {
+            this.write({ type: "interrupt" });
+        }
+    }
+    close() {
+        this.socket?.end();
+        this.socket?.destroy();
+        this.socket = undefined;
+    }
+    write(message) {
+        this.socket?.write(encodeMessage(message));
+    }
+    receive(chunk) {
+        let lines;
+        try {
+            lines = this.decoder.push(chunk);
+        }
+        catch (error) {
+            const message = error instanceof FramingError ? error.message : "Framing error.";
+            this.failAll(new RemoteError(message));
+            return;
+        }
+        for (const line of lines) {
+            const parsed = parseLine(line);
+            if ("error" in parsed) {
+                this.options.onError?.("bad_message", parsed.error);
+                continue;
+            }
+            const message = parseServerMessage(parsed.value);
+            if ("error" in message) {
+                this.options.onError?.("bad_message", message.error);
+                continue;
+            }
+            switch (message.message.type) {
+                case "hello":
+                    this.hello = message.message;
+                    this.onHello?.(message.message);
+                    this.onHello = undefined;
+                    this.onHelloError = undefined;
+                    break;
+                case "event":
+                    this.options.onEvent?.(message.message.event);
+                    break;
+                case "result": {
+                    const pending = this.pending;
+                    this.pending = undefined;
+                    pending?.resolve(message.message);
+                    break;
+                }
+                case "error": {
+                    const error = new RemoteError(message.message.message, message.message.code);
+                    this.options.onError?.(message.message.code, message.message.message);
+                    if (this.onHelloError !== undefined) {
+                        this.onHelloError(error);
+                        this.onHello = undefined;
+                        this.onHelloError = undefined;
+                        break;
+                    }
+                    // A busy or agent error ends the prompt that caused it; the
+                    // connection itself stays usable.
+                    const pending = this.pending;
+                    this.pending = undefined;
+                    pending?.reject(error);
+                    break;
+                }
+                case "bye":
+                    this.closedReason = message.message.reason;
+                    break;
+            }
+        }
+    }
+    handleClose() {
+        this.socket = undefined;
+        this.failAll(new RemoteError(this.closedReason === undefined
+            ? "The chivgent server closed the connection."
+            : `The chivgent server closed the connection: ${this.closedReason}`));
+    }
+    failAll(error) {
+        const pending = this.pending;
+        this.pending = undefined;
+        pending?.reject(error);
+        this.onHelloError?.(error);
+        this.onHello = undefined;
+        this.onHelloError = undefined;
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/remote/client.js.map

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

package/dist/remote/framing.d.ts

@@ -0,0 +1,33 @@
+/**
+ * JSON Lines framing.
+ *
+ * One JSON object per line, the same shape the session log and `--json` mode
+ * already use. A length-prefixed binary frame would be needed to carry
+ * attachments; every message here is required to be JSON-serialisable, so the
+ * simpler framing is enough and stays inspectable with `nc`.
+ */
+export declare const MAX_LINE_BYTES: number;
+export declare class FramingError extends Error {
+    constructor(message: string);
+}
+export declare function encodeMessage(value: unknown): string;
+/**
+ * Splits a byte stream into lines without unbounded buffering.
+ *
+ * A peer that never sends a newline must not be able to exhaust memory, so the
+ * buffer is capped and overflow is a protocol error rather than a slow death.
+ */
+export declare class LineDecoder {
+    private readonly maxLineBytes;
+    private buffer;
+    private readonly decoder;
+    constructor(maxLineBytes?: number);
+    push(chunk: Buffer): string[];
+}
+/** Parses one line, or returns why it could not be parsed. */
+export declare function parseLine(line: string): {
+    readonly value: unknown;
+} | {
+    readonly error: string;
+};
+//# sourceMappingURL=framing.d.ts.map

package/dist/remote/framing.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.d.ts","sourceRoot":"","sources":["../../src/remote/framing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,eAAO,MAAM,cAAc,QAAc,CAAC;AAE1C,qBAAa,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAO,EAAE,MAAM,EAG1B;CACF;AAED,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,MAAM,CAMpD;AAED;;;;;GAKG;AACH,qBAAa,WAAW;IAIV,OAAO,CAAC,QAAQ,CAAC,YAAY;IAHzC,OAAO,CAAC,MAAM,CAAM;IACpB,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA4B;IAEpD,YAA6B,YAAY,GAAE,MAAuB,EAAI;IAEtE,IAAI,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAuB5B;CACF;AAED,8DAA8D;AAC9D,wBAAgB,SAAS,CACvB,IAAI,EAAE,MAAM,GACX;IAAE,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,CAQ1D"}

package/dist/remote/framing.js

@@ -0,0 +1,68 @@
+/**
+ * JSON Lines framing.
+ *
+ * One JSON object per line, the same shape the session log and `--json` mode
+ * already use. A length-prefixed binary frame would be needed to carry
+ * attachments; every message here is required to be JSON-serialisable, so the
+ * simpler framing is enough and stays inspectable with `nc`.
+ */
+export const MAX_LINE_BYTES = 1024 * 1024;
+export class FramingError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "FramingError";
+    }
+}
+export function encodeMessage(value) {
+    const line = JSON.stringify(value);
+    if (line === undefined) {
+        throw new FramingError("Message is not JSON-serialisable.");
+    }
+    return `${line}\n`;
+}
+/**
+ * Splits a byte stream into lines without unbounded buffering.
+ *
+ * A peer that never sends a newline must not be able to exhaust memory, so the
+ * buffer is capped and overflow is a protocol error rather than a slow death.
+ */
+export class LineDecoder {
+    maxLineBytes;
+    buffer = "";
+    decoder = new TextDecoder("utf-8");
+    constructor(maxLineBytes = MAX_LINE_BYTES) {
+        this.maxLineBytes = maxLineBytes;
+    }
+    push(chunk) {
+        this.buffer += this.decoder.decode(chunk, { stream: true });
+        const lines = [];
+        for (;;) {
+            const index = this.buffer.indexOf("\n");
+            if (index === -1) {
+                break;
+            }
+            const line = this.buffer.slice(0, index);
+            this.buffer = this.buffer.slice(index + 1);
+            const trimmed = line.trim();
+            if (trimmed.length > 0) {
+                lines.push(trimmed);
+            }
+        }
+        if (Buffer.byteLength(this.buffer, "utf8") > this.maxLineBytes) {
+            throw new FramingError(`A single line exceeded the ${this.maxLineBytes}-byte limit.`);
+        }
+        return lines;
+    }
+}
+/** Parses one line, or returns why it could not be parsed. */
+export function parseLine(line) {
+    try {
+        return { value: JSON.parse(line) };
+    }
+    catch (error) {
+        return {
+            error: error instanceof Error ? error.message : "Invalid JSON.",
+        };
+    }
+}
+//# sourceMappingURL=framing.js.map

package/dist/remote/framing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"framing.js","sourceRoot":"","sources":["../../src/remote/framing.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,MAAM,CAAC,MAAM,cAAc,GAAG,IAAI,GAAG,IAAI,CAAC;AAE1C,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED,MAAM,UAAU,aAAa,CAAC,KAAc;IAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACnC,IAAI,IAAI,KAAK,SAAS,EAAE,CAAC;QACvB,MAAM,IAAI,YAAY,CAAC,mCAAmC,CAAC,CAAC;IAC9D,CAAC;IACD,OAAO,GAAG,IAAI,IAAI,CAAC;AACrB,CAAC;AAED;;;;;GAKG;AACH,MAAM,OAAO,WAAW;IAIO,YAAY;IAHjC,MAAM,GAAG,EAAE,CAAC;IACH,OAAO,GAAG,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;IAEpD,YAA6B,YAAY,GAAW,cAAc;4BAArC,YAAY;IAA4B,CAAC;IAEtE,IAAI,CAAC,KAAa;QAChB,IAAI,CAAC,MAAM,IAAI,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;QAC5D,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,SAAS,CAAC;YACR,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACxC,IAAI,KAAK,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,MAAM;YACR,CAAC;YACD,MAAM,IAAI,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YACzC,IAAI,CAAC,MAAM,GAAG,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;YAC3C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;gBACvB,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACtB,CAAC;QACH,CAAC;QAED,IAAI,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YAC/D,MAAM,IAAI,YAAY,CACpB,8BAA8B,IAAI,CAAC,YAAY,cAAc,CAC9D,CAAC;QACJ,CAAC;QACD,OAAO,KAAK,CAAC;IACf,CAAC;CACF;AAED,8DAA8D;AAC9D,MAAM,UAAU,SAAS,CACvB,IAAY;IAEZ,IAAI,CAAC;QACH,OAAO,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;IACrC,CAAC;IAAC,OAAO,KAAc,EAAE,CAAC;QACxB,OAAO;YACL,KAAK,EAAE,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,eAAe;SAChE,CAAC;IACJ,CAAC;AACH,CAAC"}

package/dist/remote/protocol.d.ts

@@ -0,0 +1,81 @@
+import type { AgentEvent } from "../events.js";
+import type { Message } from "../messages.js";
+/**
+ * Bumped whenever the shape below changes in a way an older peer would
+ * misread. A mismatch is refused with both versions named, which costs one
+ * release note and saves a baffling debugging session later.
+ */
+export declare const PROTOCOL_VERSION = 1;
+export type ProtocolErrorCode = "version_mismatch" | "busy" | "bad_message" | "too_large" | "agent_error";
+export interface SessionSummary {
+    readonly id: string;
+    readonly cwd: string;
+    readonly turns: number;
+    readonly messages: number;
+    /** Capabilities the server was started with, so an attaching client can see them. */
+    readonly capabilities: readonly string[];
+}
+export interface ClientHello {
+    readonly type: "hello";
+    readonly version: number;
+}
+export interface ClientPrompt {
+    readonly type: "prompt";
+    readonly text: string;
+}
+export interface ClientInterrupt {
+    readonly type: "interrupt";
+}
+export type ClientMessage = ClientHello | ClientPrompt | ClientInterrupt;
+export interface ServerHello {
+    readonly type: "hello";
+    readonly version: number;
+    readonly session: SessionSummary;
+    readonly tools: readonly string[];
+}
+export interface ServerError {
+    readonly type: "error";
+    readonly code: ProtocolErrorCode;
+    readonly message: string;
+}
+/**
+ * An AgentEvent, wrapped rather than sent bare.
+ *
+ * Without the wrapper the protocol's own messages share a namespace with the
+ * agent's events, and the day an event type called "error" is added the two
+ * collide silently.
+ */
+export interface ServerEvent {
+    readonly type: "event";
+    readonly event: AgentEvent;
+}
+export interface ServerBye {
+    readonly type: "bye";
+    readonly reason: string;
+}
+/** Sent when a run finishes, so a one-shot client knows when to leave. */
+export interface ServerResult {
+    readonly type: "result";
+    readonly status: "completed" | "max_turns" | "aborted" | "error";
+    readonly messages: number;
+}
+export type ServerMessage = ServerHello | ServerError | ServerEvent | ServerBye | ServerResult;
+/** Parses one client message, or returns why it is not one. */
+export declare function parseClientMessage(value: unknown): {
+    readonly message: ClientMessage;
+} | {
+    readonly error: string;
+};
+export declare function parseServerMessage(value: unknown): {
+    readonly message: ServerMessage;
+} | {
+    readonly error: string;
+};
+export declare function summariseSession(options: {
+    readonly id: string;
+    readonly cwd: string;
+    readonly turns: number;
+    readonly messages: readonly Message[];
+    readonly capabilities: readonly string[];
+}): SessionSummary;
+//# sourceMappingURL=protocol.d.ts.map

package/dist/remote/protocol.d.ts.map

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

package/dist/remote/protocol.js

@@ -0,0 +1,79 @@
+/**
+ * Bumped whenever the shape below changes in a way an older peer would
+ * misread. A mismatch is refused with both versions named, which costs one
+ * release note and saves a baffling debugging session later.
+ */
+export const PROTOCOL_VERSION = 1;
+function isRecord(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value);
+}
+/** Parses one client message, or returns why it is not one. */
+export function parseClientMessage(value) {
+    if (!isRecord(value)) {
+        return { error: "A message must be a JSON object." };
+    }
+    switch (value.type) {
+        case "hello":
+            if (typeof value.version !== "number" || !Number.isInteger(value.version)) {
+                return { error: "hello needs an integer version." };
+            }
+            return { message: { type: "hello", version: value.version } };
+        case "prompt":
+            if (typeof value.text !== "string" || value.text.trim().length === 0) {
+                return { error: "prompt needs a non-empty text." };
+            }
+            return { message: { type: "prompt", text: value.text } };
+        case "interrupt":
+            return { message: { type: "interrupt" } };
+        default:
+            return { error: `Unknown message type: ${String(value.type)}` };
+    }
+}
+export function parseServerMessage(value) {
+    if (!isRecord(value)) {
+        return { error: "A message must be a JSON object." };
+    }
+    switch (value.type) {
+        case "hello":
+            if (typeof value.version !== "number" ||
+                !isRecord(value.session) ||
+                !Array.isArray(value.tools)) {
+                return { error: "hello is missing version, session or tools." };
+            }
+            return { message: value };
+        case "error":
+            if (typeof value.message !== "string" || typeof value.code !== "string") {
+                return { error: "error needs a code and a message." };
+            }
+            return { message: value };
+        case "event":
+            if (!isRecord(value.event) || typeof value.event.type !== "string") {
+                return { error: "event needs an event object." };
+            }
+            return { message: value };
+        case "result":
+            if (typeof value.status !== "string") {
+                return { error: "result needs a status." };
+            }
+            return { message: value };
+        case "bye":
+            return {
+                message: {
+                    type: "bye",
+                    reason: typeof value.reason === "string" ? value.reason : "",
+                },
+            };
+        default:
+            return { error: `Unknown message type: ${String(value.type)}` };
+    }
+}
+export function summariseSession(options) {
+    return {
+        id: options.id,
+        cwd: options.cwd,
+        turns: options.turns,
+        messages: options.messages.length,
+        capabilities: options.capabilities,
+    };
+}
+//# sourceMappingURL=protocol.js.map

package/dist/remote/protocol.js.map

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

package/dist/remote/repl.d.ts

@@ -0,0 +1,18 @@
+import type { OutputStream } from "../render.js";
+import type { RemoteSession } from "./client.js";
+export interface RemoteReplOptions {
+    readonly remote: RemoteSession;
+    readonly input: NodeJS.ReadableStream;
+    readonly output: NodeJS.WritableStream;
+    readonly stderr: OutputStream;
+    readonly socketPath: string;
+}
+/**
+ * The interactive loop for an attached client.
+ *
+ * It deliberately offers fewer commands than the local REPL: /clear would
+ * change a transcript this process does not own, and other clients would see
+ * it happen without asking.
+ */
+export declare function runRemoteRepl(options: RemoteReplOptions): Promise<number>;
+//# sourceMappingURL=repl.d.ts.map

package/dist/remote/repl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repl.d.ts","sourceRoot":"","sources":["../../src/remote/repl.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAEjD,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,MAAM,EAAE,aAAa,CAAC;IAC/B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC,cAAc,CAAC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC,cAAc,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,YAAY,CAAC;IAC9B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAWD;;;;;;GAMG;AACH,wBAAsB,aAAa,CACjC,OAAO,EAAE,iBAAiB,GACzB,OAAO,CAAC,MAAM,CAAC,CAsFjB"}

package/dist/remote/repl.js

@@ -0,0 +1,100 @@
+import { createInterface } from "node:readline";
+import { REPL_PROMPT } from "../repl.js";
+const HELP = `Commands:
+  /help      Show this help
+  /session   Show the served session's id, workspace and capabilities
+  /tools     List the tools the server offers
+  /exit      Leave this client (the server keeps running)
+
+Anything else is sent to the server. Ctrl+C interrupts the answer in progress.
+`;
+/**
+ * The interactive loop for an attached client.
+ *
+ * It deliberately offers fewer commands than the local REPL: /clear would
+ * change a transcript this process does not own, and other clients would see
+ * it happen without asking.
+ */
+export async function runRemoteRepl(options) {
+    const write = (text) => {
+        options.stderr.write(text);
+    };
+    const readline = createInterface({
+        input: options.input,
+        output: options.output,
+        terminal: true,
+        prompt: REPL_PROMPT,
+    });
+    let running = false;
+    readline.on("SIGINT", () => {
+        if (!running) {
+            write("Press Ctrl+D or /exit to leave.\n");
+            readline.prompt();
+            return;
+        }
+        options.remote.interrupt();
+    });
+    const summary = options.remote.session;
+    write([
+        `attached to ${summary.id}`,
+        `workspace:    ${summary.cwd}`,
+        `capabilities: ${summary.capabilities.length === 0 ? "read-only" : summary.capabilities.join(" ")}`,
+        "Type /help for commands, Ctrl+D to detach.",
+        "",
+        "",
+    ].join("\n"));
+    readline.prompt();
+    for await (const line of readline) {
+        const trimmed = line.trim();
+        if (trimmed.length === 0) {
+            readline.prompt();
+            continue;
+        }
+        if (trimmed.startsWith("/")) {
+            const command = trimmed.split(/\s+/, 1)[0];
+            if (command === "/exit" || command === "/quit") {
+                break;
+            }
+            if (command === "/help" || command === "/?") {
+                write(HELP);
+            }
+            else if (command === "/session") {
+                write([
+                    `id:           ${summary.id}`,
+                    `workspace:    ${summary.cwd}`,
+                    `socket:       ${options.socketPath}`,
+                    `capabilities: ${summary.capabilities.length === 0 ? "read-only" : summary.capabilities.join(" ")}`,
+                    "",
+                ].join("\n"));
+            }
+            else if (command === "/tools") {
+                write(`${options.remote.toolNames.map((name) => `  ${name}`).join("\n")}\n`);
+            }
+            else {
+                write(`Unknown command: ${trimmed}. Try /help.\n`);
+            }
+            readline.prompt();
+            continue;
+        }
+        running = true;
+        try {
+            await options.remote.prompt(trimmed);
+        }
+        catch (error) {
+            const message = error instanceof Error ? error.message : "Unknown error";
+            write(`${message}\n`);
+            // A dead server ends the client; a busy or agent error does not.
+            if (message.includes("closed the connection")) {
+                readline.close();
+                return 1;
+            }
+        }
+        finally {
+            running = false;
+        }
+        readline.prompt();
+    }
+    readline.close();
+    return 0;
+}
+//# sourceMappingURL=repl.js.map

package/dist/remote/repl.js.map

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

package/dist/remote/server.d.ts

@@ -0,0 +1,41 @@
+import type { AgentEvent } from "../events.js";
+import type { AgentSession } from "../session.js";
+export declare class SocketInUseError extends Error {
+    readonly socketPath: string;
+    constructor(socketPath: string);
+}
+export interface SessionServerOptions {
+    readonly session: AgentSession;
+    readonly socketPath: string;
+    /** Named in the handshake so an attaching client can see what it gets. */
+    readonly capabilities: readonly string[];
+    readonly onWarning?: (message: string) => void;
+}
+/**
+ * Exposes one session on a Unix socket.
+ *
+ * A client is just another subscriber that lives in another process, which is
+ * why this is thin: the session already fans events out and already runs one
+ * prompt at a time.
+ */
+export declare class SessionServer {
+    private readonly options;
+    private readonly connections;
+    private server;
+    private running;
+    private controller;
+    private unsubscribe;
+    constructor(options: SessionServerOptions);
+    get socketPath(): string;
+    listen(): Promise<void>;
+    close(): Promise<void>;
+    private accept;
+    private drop;
+    private handleLine;
+    private runPrompt;
+    private fail;
+    private broadcast;
+    private send;
+}
+export type { AgentEvent };
+//# sourceMappingURL=server.d.ts.map

package/dist/remote/server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server.d.ts","sourceRoot":"","sources":["../../src/remote/server.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC/C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAelD,qBAAa,gBAAiB,SAAQ,KAAK;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM;IAAvC,YAAqB,UAAU,EAAE,MAAM,EAKtC;CACF;AAED,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;IAC/B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,0EAA0E;IAC1E,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;IACzC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CAChD;AAQD;;;;;;GAMG;AACH,qBAAa,aAAa;IAOZ,OAAO,CAAC,QAAQ,CAAC,OAAO;IANpC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAyB;IACrD,OAAO,CAAC,MAAM,CAAqB;IACnC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,UAAU,CAA8B;IAChD,OAAO,CAAC,WAAW,CAA2B;IAE9C,YAA6B,OAAO,EAAE,oBAAoB,EAAI;IAE9D,IAAI,UAAU,IAAI,MAAM,CAEvB;IAEK,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC,CAkC5B;IAEK,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAe3B;IAED,OAAO,CAAC,MAAM;IA8Bd,OAAO,CAAC,IAAI;IAKZ,OAAO,CAAC,UAAU;YAsDJ,SAAS;IA+BvB,OAAO,CAAC,IAAI;IAWZ,OAAO,CAAC,SAAS;IAMjB,OAAO,CAAC,IAAI;CAYb;AAED,YAAY,EAAE,UAAU,EAAE,CAAC"}