@nifrajs/coding-agent 3.2.0

package/dist/process.js

@@ -0,0 +1,42 @@
+export async function readBoundedText(stream, maxBytes) {
+    if (stream === null || stream === undefined || typeof stream === "number")
+        return { text: "", truncated: false };
+    if (!Number.isSafeInteger(maxBytes) || maxBytes < 1)
+        throw new RangeError("bounded process output: maxBytes must be positive");
+    const reader = stream.getReader();
+    const decoder = new TextDecoder();
+    const chunks = [];
+    let total = 0;
+    let truncated = false;
+    try {
+        for (;;) {
+            const { done, value } = await reader.read();
+            if (done) {
+                chunks.push(decoder.decode());
+                break;
+            }
+            if (value === undefined)
+                continue;
+            const remaining = maxBytes - total;
+            if (remaining <= 0) {
+                truncated = true;
+                await reader.cancel();
+                break;
+            }
+            if (value.byteLength > remaining) {
+                chunks.push(decoder.decode(value.subarray(0, remaining), { stream: true }));
+                chunks.push(decoder.decode());
+                truncated = true;
+                await reader.cancel();
+                break;
+            }
+            total += value.byteLength;
+            chunks.push(decoder.decode(value, { stream: true }));
+        }
+    }
+    finally {
+        reader.releaseLock();
+    }
+    return { text: chunks.join(""), truncated };
+}
+//# sourceMappingURL=process.js.map

package/dist/process.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"process.js","sourceRoot":"","sources":["../src/process.ts"],"names":[],"mappings":"AAKA,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,MAA8D,EAC9D,QAAgB;IAEhB,IAAI,MAAM,KAAK,IAAI,IAAI,MAAM,KAAK,SAAS,IAAI,OAAO,MAAM,KAAK,QAAQ;QACvE,OAAO,EAAE,IAAI,EAAE,EAAE,EAAE,SAAS,EAAE,KAAK,EAAE,CAAA;IACvC,IAAI,CAAC,MAAM,CAAC,aAAa,CAAC,QAAQ,CAAC,IAAI,QAAQ,GAAG,CAAC;QACjD,MAAM,IAAI,UAAU,CAAC,mDAAmD,CAAC,CAAA;IAC3E,MAAM,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAA;IACjC,MAAM,OAAO,GAAG,IAAI,WAAW,EAAE,CAAA;IACjC,MAAM,MAAM,GAAa,EAAE,CAAA;IAC3B,IAAI,KAAK,GAAG,CAAC,CAAA;IACb,IAAI,SAAS,GAAG,KAAK,CAAA;IACrB,IAAI,CAAC;QACH,SAAS,CAAC;YACR,MAAM,EAAE,IAAI,EAAE,KAAK,EAAE,GAAG,MAAM,MAAM,CAAC,IAAI,EAAE,CAAA;YAC3C,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;gBAC7B,MAAK;YACP,CAAC;YACD,IAAI,KAAK,KAAK,SAAS;gBAAE,SAAQ;YACjC,MAAM,SAAS,GAAG,QAAQ,GAAG,KAAK,CAAA;YAClC,IAAI,SAAS,IAAI,CAAC,EAAE,CAAC;gBACnB,SAAS,GAAG,IAAI,CAAA;gBAChB,MAAM,MAAM,CAAC,MAAM,EAAE,CAAA;gBACrB,MAAK;YACP,CAAC;YACD,IAAI,KAAK,CAAC,UAAU,GAAG,SAAS,EAAE,CAAC;gBACjC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,EAAE,SAAS,CAAC,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;gBAC3E,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;gBAC7B,SAAS,GAAG,IAAI,CAAA;gBAChB,MAAM,MAAM,CAAC,MAAM,EAAE,CAAA;gBACrB,MAAK;YACP,CAAC;YACD,KAAK,IAAI,KAAK,CAAC,UAAU,CAAA;YACzB,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,KAAK,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAA;QACtD,CAAC;IACH,CAAC;YAAS,CAAC;QACT,MAAM,CAAC,WAAW,EAAE,CAAA;IACtB,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,EAAE,SAAS,EAAE,CAAA;AAC7C,CAAC"}

package/dist/registry.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Capability-descriptor adapter for coding-agent extensions.
+ *
+ * An extension is host-supplied code that runs with granted capabilities, so its descriptor is
+ * projected under the `extension` kind and, unlike a typed tool, admits an opaque input. The adapter
+ * fails closed on capability escalation: an extension must declare its capabilities explicitly (an
+ * empty array asserts "none"), and every declared capability must appear in the host's trusted
+ * allowlist. An omitted declaration or any capability outside the allowlist raises
+ * `capability_escalation` rather than silently narrowing or widening the grant.
+ *
+ * This module is the only place `@nifrajs/coding-agent` reaches `@nifrajs/agent`; the edge is
+ * `coding-agent -> agent`, never the reverse, so the agent package stays free of coding-agent code.
+ */
+import { type ApprovalClass, type CapabilityDescriptor, type IsolationClass } from "@nifrajs/agent/registry";
+/** The minimal shape an extension exposes for projection: an identity and an explicit capability grant. */
+export interface ExtensionDescriptorSource {
+    readonly name: string;
+    readonly capabilities?: readonly string[];
+}
+export interface ExtensionDescriptorOptions {
+    /** The host's trusted capability allowlist. A declared capability outside it fails closed. */
+    readonly trustedCapabilities: readonly string[];
+    readonly version?: string;
+    readonly approval?: ApprovalClass;
+    readonly isolation?: IsolationClass;
+}
+/**
+ * Project one extension into an `extension` capability descriptor, enforcing the grant. The declared
+ * capabilities become the descriptor's required capabilities only after every one is confirmed
+ * trusted; an undeclared grant or an escalated capability throws before any descriptor is built.
+ * Approval defaults to required and isolation to process, matching how untyped host code is admitted.
+ */
+export declare function extensionDescriptor(extension: ExtensionDescriptorSource, options: ExtensionDescriptorOptions): Promise<CapabilityDescriptor>;
+/** Project a set of extensions under a single trusted allowlist, preserving order. */
+export declare function extensionDescriptors(extensions: readonly ExtensionDescriptorSource[], options: ExtensionDescriptorOptions): Promise<readonly CapabilityDescriptor[]>;
+export type { CapabilityDescriptor };
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EACL,KAAK,aAAa,EAClB,KAAK,oBAAoB,EAEzB,KAAK,cAAc,EAEpB,MAAM,yBAAyB,CAAA;AAQhC,2GAA2G;AAC3G,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAC1C;AAED,MAAM,WAAW,0BAA0B;IACzC,8FAA8F;IAC9F,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAA;IAC/C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,QAAQ,CAAC,QAAQ,CAAC,EAAE,aAAa,CAAA;IACjC,QAAQ,CAAC,SAAS,CAAC,EAAE,cAAc,CAAA;CACpC;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CACjC,SAAS,EAAE,yBAAyB,EACpC,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,oBAAoB,CAAC,CAkB/B;AAED,sFAAsF;AACtF,wBAAgB,oBAAoB,CAClC,UAAU,EAAE,SAAS,yBAAyB,EAAE,EAChD,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,SAAS,oBAAoB,EAAE,CAAC,CAE1C;AAED,YAAY,EAAE,oBAAoB,EAAE,CAAA"}

package/dist/registry.js

@@ -0,0 +1,51 @@
+/**
+ * Capability-descriptor adapter for coding-agent extensions.
+ *
+ * An extension is host-supplied code that runs with granted capabilities, so its descriptor is
+ * projected under the `extension` kind and, unlike a typed tool, admits an opaque input. The adapter
+ * fails closed on capability escalation: an extension must declare its capabilities explicitly (an
+ * empty array asserts "none"), and every declared capability must appear in the host's trusted
+ * allowlist. An omitted declaration or any capability outside the allowlist raises
+ * `capability_escalation` rather than silently narrowing or widening the grant.
+ *
+ * This module is the only place `@nifrajs/coding-agent` reaches `@nifrajs/agent`; the edge is
+ * `coding-agent -> agent`, never the reverse, so the agent package stays free of coding-agent code.
+ */
+import { composeDescriptor, RegistryError, } from "@nifrajs/agent/registry";
+/** Opaque extension input. Extensions do not publish a typed schema, so identity rests on name and grant. */
+const EXTENSION_INPUT_SCHEMA = Object.freeze({
+    type: "object",
+    additionalProperties: true,
+});
+/**
+ * Project one extension into an `extension` capability descriptor, enforcing the grant. The declared
+ * capabilities become the descriptor's required capabilities only after every one is confirmed
+ * trusted; an undeclared grant or an escalated capability throws before any descriptor is built.
+ * Approval defaults to required and isolation to process, matching how untyped host code is admitted.
+ */
+export function extensionDescriptor(extension, options) {
+    const requested = extension.capabilities;
+    if (requested === undefined)
+        throw new RegistryError("capability_escalation");
+    const trusted = new Set(options.trustedCapabilities);
+    for (const capability of requested) {
+        if (!trusted.has(capability))
+            throw new RegistryError("capability_escalation");
+    }
+    return composeDescriptor({
+        kind: "extension",
+        name: extension.name,
+        ...(options.version === undefined ? {} : { version: options.version }),
+        inputSchema: EXTENSION_INPUT_SCHEMA,
+        requiredCapabilities: requested,
+        approval: options.approval ?? { kind: "required" },
+        retry: "none",
+        idempotency: "none",
+        isolation: options.isolation ?? "process",
+    });
+}
+/** Project a set of extensions under a single trusted allowlist, preserving order. */
+export function extensionDescriptors(extensions, options) {
+    return Promise.all(extensions.map((extension) => extensionDescriptor(extension, options)));
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,EAGL,iBAAiB,EAEjB,aAAa,GACd,MAAM,yBAAyB,CAAA;AAEhC,6GAA6G;AAC7G,MAAM,sBAAsB,GAA4B,MAAM,CAAC,MAAM,CAAC;IACpE,IAAI,EAAE,QAAQ;IACd,oBAAoB,EAAE,IAAI;CAC3B,CAAC,CAAA;AAgBF;;;;;GAKG;AACH,MAAM,UAAU,mBAAmB,CACjC,SAAoC,EACpC,OAAmC;IAEnC,MAAM,SAAS,GAAG,SAAS,CAAC,YAAY,CAAA;IACxC,IAAI,SAAS,KAAK,SAAS;QAAE,MAAM,IAAI,aAAa,CAAC,uBAAuB,CAAC,CAAA;IAC7E,MAAM,OAAO,GAAG,IAAI,GAAG,CAAC,OAAO,CAAC,mBAAmB,CAAC,CAAA;IACpD,KAAK,MAAM,UAAU,IAAI,SAAS,EAAE,CAAC;QACnC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC;YAAE,MAAM,IAAI,aAAa,CAAC,uBAAuB,CAAC,CAAA;IAChF,CAAC;IACD,OAAO,iBAAiB,CAAC;QACvB,IAAI,EAAE,WAAW;QACjB,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,OAAO,CAAC,OAAO,EAAE,CAAC;QACtE,WAAW,EAAE,sBAAsB;QACnC,oBAAoB,EAAE,SAAS;QAC/B,QAAQ,EAAE,OAAO,CAAC,QAAQ,IAAI,EAAE,IAAI,EAAE,UAAU,EAAE;QAClD,KAAK,EAAE,MAAM;QACb,WAAW,EAAE,MAAM;QACnB,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,SAAS;KAC1C,CAAC,CAAA;AACJ,CAAC;AAED,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAClC,UAAgD,EAChD,OAAmC;IAEnC,OAAO,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,mBAAmB,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;AAC5F,CAAC"}

package/dist/replay.d.ts

@@ -0,0 +1,24 @@
+import { type AgentBackend, type AgentBackendInfo, type AgentEvent, type AgentSessionSnapshot, type CreateSessionInput, type ReloadResult, type SendMessageInput } from "@nifrajs/agent-protocol";
+export interface ReplayBackendOptions {
+    readonly events: readonly AgentEvent[];
+    readonly delayMs?: number;
+}
+/** Deterministic protocol backend for demos, CI, and UI regression tests. */
+export declare class ReplayBackend implements AgentBackend {
+    readonly info: AgentBackendInfo;
+    private readonly events;
+    private readonly delayMs;
+    private readonly sessions;
+    constructor(options: ReplayBackendOptions);
+    createSession(input: CreateSessionInput): Promise<AgentSessionSnapshot>;
+    send(input: SendMessageInput): AsyncIterable<AgentEvent>;
+    cancel(sessionId: string, reason?: string): Promise<void>;
+    snapshot(sessionId: string): Promise<AgentSessionSnapshot>;
+    reload(sessionId: string): Promise<ReloadResult>;
+    close(sessionId: string): Promise<void>;
+    private replay;
+    private push;
+    private requireSession;
+}
+export declare function readReplayEvents(path: string): Promise<readonly AgentEvent[]>;
+//# sourceMappingURL=replay.d.ts.map

package/dist/replay.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"replay.d.ts","sourceRoot":"","sources":["../src/replay.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,KAAK,UAAU,EAEf,KAAK,oBAAoB,EAEzB,KAAK,kBAAkB,EAEvB,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACtB,MAAM,yBAAyB,CAAA;AAEhC,MAAM,WAAW,oBAAoB;IACnC,QAAQ,CAAC,MAAM,EAAE,SAAS,UAAU,EAAE,CAAA;IACtC,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;CAC1B;AAUD,6EAA6E;AAC7E,qBAAa,aAAc,YAAW,YAAY;IAChD,QAAQ,CAAC,IAAI,EAAE,gBAAgB,CAG7B;IACF,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAuB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAmC;gBAEhD,OAAO,EAAE,oBAAoB;IAOnC,aAAa,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAqB7E,IAAI,CAAC,KAAK,EAAE,gBAAgB,GAAG,aAAa,CAAC,UAAU,CAAC;IAYlD,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,SAAc,GAAG,OAAO,CAAC,IAAI,CAAC;IAY9D,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,oBAAoB,CAAC;IAI1D,MAAM,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC;IAWhD,KAAK,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAQ/B,MAAM;IA6BpB,OAAO,CAAC,IAAI;IAaZ,OAAO,CAAC,cAAc;CAKvB;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,UAAU,EAAE,CAAC,CAUnF"}

package/dist/replay.js

@@ -0,0 +1,154 @@
+import { agentError, createAgentEventStream, } from "@nifrajs/agent-protocol";
+/** Deterministic protocol backend for demos, CI, and UI regression tests. */
+export class ReplayBackend {
+    info = Object.freeze({
+        name: "replay",
+        capabilities: Object.freeze(["sessions", "streaming", "replay"]),
+    });
+    events;
+    delayMs;
+    sessions = new Map();
+    constructor(options) {
+        this.events = Object.freeze(options.events.map((event) => Object.freeze({ ...event })));
+        this.delayMs = options.delayMs ?? 0;
+        if (!Number.isSafeInteger(this.delayMs) || this.delayMs < 0 || this.delayMs > 60_000)
+            throw new RangeError("replay backend: delayMs must be between 0 and 60000");
+    }
+    async createSession(input) {
+        const id = input.sessionId ?? crypto.randomUUID();
+        if (!/^[a-zA-Z0-9._:-]{1,128}$/.test(id))
+            throw new TypeError("replay backend: invalid sessionId");
+        if (this.sessions.has(id))
+            throw new Error(`replay backend: session already exists: ${id}`);
+        const now = Date.now();
+        const snapshot = {
+            version: 1,
+            id,
+            backend: this.info.name,
+            cwd: input.cwd,
+            status: "idle",
+            createdAt: now,
+            updatedAt: now,
+            lastSeq: 0,
+            capabilities: Object.freeze([...(input.capabilities ?? this.info.capabilities)]),
+        };
+        this.sessions.set(id, { id, snapshot, active: undefined, closed: false, seq: 0 });
+        return snapshot;
+    }
+    send(input) {
+        const session = this.requireSession(input.sessionId);
+        if (session.closed)
+            return failedStream(agentError("SESSION_CLOSED", "replay session is closed"));
+        if (session.active !== undefined)
+            return failedStream(agentError("SESSION_BUSY", "replay session is busy"));
+        const stream = createAgentEventStream();
+        session.active = stream;
+        void this.replay(session, stream);
+        return stream;
+    }
+    async cancel(sessionId, reason = "cancelled") {
+        const session = this.requireSession(sessionId);
+        session.active?.complete();
+        session.active = undefined;
+        session.snapshot = Object.freeze({
+            ...session.snapshot,
+            status: "stopped",
+            updatedAt: Date.now(),
+        });
+        if (session.seq === 0)
+            this.push(session, { type: "session.stopped", reason });
+    }
+    async snapshot(sessionId) {
+        return this.requireSession(sessionId).snapshot;
+    }
+    async reload(sessionId) {
+        const session = this.requireSession(sessionId);
+        const revision = `replay:${this.events.length}`;
+        session.snapshot = Object.freeze({
+            ...session.snapshot,
+            extensionRevision: revision,
+            updatedAt: Date.now(),
+        });
+        return { revision, loaded: [], disabled: [], rolledBack: false };
+    }
+    async close(sessionId) {
+        const session = this.requireSession(sessionId);
+        session.closed = true;
+        session.active?.complete();
+        session.active = undefined;
+        this.sessions.delete(sessionId);
+    }
+    async replay(session, stream) {
+        session.snapshot = Object.freeze({
+            ...session.snapshot,
+            status: "running",
+            updatedAt: Date.now(),
+        });
+        try {
+            for (const source of this.events) {
+                if (this.delayMs > 0)
+                    await new Promise((resolve) => setTimeout(resolve, this.delayMs));
+                this.push(session, remap(source, session.id, session.seq));
+            }
+            session.snapshot = Object.freeze({
+                ...session.snapshot,
+                status: "idle",
+                updatedAt: Date.now(),
+            });
+            this.push(session, { type: "session.completed", snapshot: session.snapshot });
+        }
+        catch (error) {
+            this.push(session, {
+                type: "session.failed",
+                error: agentError("REPLAY_FAILED", error instanceof Error ? error.message : String(error)),
+                recoverable: true,
+            });
+        }
+        finally {
+            stream.complete();
+            session.active = undefined;
+        }
+    }
+    push(session, event) {
+        const next = "version" in event && "sessionId" in event
+            ? event
+            : { version: 1, sessionId: session.id, seq: session.seq, at: Date.now(), ...event };
+        session.seq = next.seq + 1;
+        session.snapshot = Object.freeze({ ...session.snapshot, lastSeq: next.seq, updatedAt: next.at });
+        session.active?.push(next);
+    }
+    requireSession(id) {
+        const session = this.sessions.get(id);
+        if (session === undefined)
+            throw new Error(`replay backend: unknown session: ${id}`);
+        return session;
+    }
+}
+export async function readReplayEvents(path) {
+    const text = await Bun.file(path).text();
+    const events = [];
+    for (const line of text.split("\n")) {
+        if (line.trim().length === 0)
+            continue;
+        const value = JSON.parse(line);
+        if (!isAgentEvent(value))
+            throw new Error(`replay: invalid event in ${path}`);
+        events.push(value);
+    }
+    return Object.freeze(events);
+}
+function remap(event, sessionId, seq) {
+    return Object.freeze({ ...event, sessionId, seq, at: Date.now() });
+}
+function isAgentEvent(value) {
+    return (value !== null &&
+        typeof value === "object" &&
+        value.version === 1 &&
+        typeof value.type === "string");
+}
+function failedStream(error) {
+    const stream = createAgentEventStream();
+    stream.fail(error);
+    return stream;
+}
+//# sourceMappingURL=replay.js.map

package/dist/replay.js.map

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

package/dist/rpc.d.ts

@@ -0,0 +1,51 @@
+import { type AgentBackend } from "@nifrajs/agent-protocol";
+import type { ExtensionHost } from "./extensions.js";
+import { CodingAgentHost, type CodingAgentHostOptions } from "./host.js";
+import type { ContextWindowOptions, SessionStore } from "./sessions.js";
+import type { UiExtensionHost } from "./ui.js";
+export interface CodingAgentRpcServerOptions {
+    readonly backend: AgentBackend;
+    readonly cwd: string;
+    readonly hostname?: string;
+    /** Remote binding is opt-in; the default only permits loopback hosts. */
+    readonly allowRemote?: boolean;
+    readonly port?: number;
+    /** A random token is generated when omitted. Use an explicit token only for managed local launchers. */
+    readonly authToken?: string;
+    /** Include bounded exception stacks in RPC failures only for trusted loopback debugging. */
+    readonly exposeErrorStacks?: boolean;
+    readonly maxBodyBytes?: number;
+    readonly sessionStore?: SessionStore;
+    readonly contextWindow?: ContextWindowOptions;
+    readonly extensions?: ExtensionHost;
+    readonly ui?: UiExtensionHost;
+    readonly verifyAfterTurn?: readonly ("check" | "assure" | "test")[];
+    readonly maxRepairAttempts?: number;
+    readonly verification?: CodingAgentHostOptions["verification"];
+}
+export interface CodingAgentRpcServerHandle {
+    readonly url: string;
+    readonly token: string;
+    stop(): Promise<void>;
+}
+/**
+ * Minimal loopback RPC surface for the CLI, Workbench, CI clients, and a future mobile companion.
+ * Turn output is SSE so clients do not need a WebSocket dependency; every event is still a versioned
+ * protocol event from the backend.
+ */
+export declare class CodingAgentRpcServer {
+    readonly host: CodingAgentHost;
+    private readonly options;
+    private readonly token;
+    private readonly maxBodyBytes;
+    private listener;
+    constructor(options: CodingAgentRpcServerOptions);
+    start(): Promise<CodingAgentRpcServerHandle>;
+    stop(): Promise<void>;
+    private fetch;
+    private dispatch;
+    private requireSnapshot;
+    private protocolError;
+    private readRequest;
+}
+//# sourceMappingURL=rpc.d.ts.map

package/dist/rpc.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"rpc.d.ts","sourceRoot":"","sources":["../src/rpc.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,KAAK,YAAY,EAIlB,MAAM,yBAAyB,CAAA;AAGhC,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AACpD,OAAO,EAAE,eAAe,EAAE,KAAK,sBAAsB,EAAE,MAAM,WAAW,CAAA;AAExE,OAAO,KAAK,EAAE,oBAAoB,EAAE,YAAY,EAAE,MAAM,eAAe,CAAA;AACvE,OAAO,KAAK,EAAE,eAAe,EAAuB,MAAM,SAAS,CAAA;AAGnE,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAA;IAC9B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,yEAAyE;IACzE,QAAQ,CAAC,WAAW,CAAC,EAAE,OAAO,CAAA;IAC9B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAA;IACtB,wGAAwG;IACxG,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAA;IAC3B,4FAA4F;IAC5F,QAAQ,CAAC,iBAAiB,CAAC,EAAE,OAAO,CAAA;IACpC,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAA;IAC9B,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAA;IACpC,QAAQ,CAAC,aAAa,CAAC,EAAE,oBAAoB,CAAA;IAC7C,QAAQ,CAAC,UAAU,CAAC,EAAE,aAAa,CAAA;IACnC,QAAQ,CAAC,EAAE,CAAC,EAAE,eAAe,CAAA;IAC7B,QAAQ,CAAC,eAAe,CAAC,EAAE,SAAS,CAAC,OAAO,GAAG,QAAQ,GAAG,MAAM,CAAC,EAAE,CAAA;IACnE,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAA;IACnC,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC,cAAc,CAAC,CAAA;CAC/D;AAED,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;CACtB;AAYD;;;;GAIG;AACH,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,IAAI,EAAE,eAAe,CAAA;IAC9B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAA6B;IACrD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAQ;IAC9B,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAQ;IACrC,OAAO,CAAC,QAAQ,CAA2B;gBAE/B,OAAO,EAAE,2BAA2B;IAwB1C,KAAK,IAAI,OAAO,CAAC,0BAA0B,CAAC;IAsB5C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;YAOb,KAAK;YA4CL,QAAQ;IA2UtB,OAAO,CAAC,eAAe;IAKvB,OAAO,CAAC,aAAa;YAQP,WAAW;CAa1B"}