@nifrajs/coding-agent 3.2.0

package/dist/rpc.js

@@ -0,0 +1,412 @@
+import { resumeFromCursor, } from "@nifrajs/agent-protocol";
+import { readProjectDiff } from "./diff.js";
+import { publicErrorDetails } from "./errors.js";
+import { CodingAgentHost } from "./host.js";
+import { readBoundedText } from "./process.js";
+import { runNifraVerification } from "./verification.js";
+/**
+ * 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 class CodingAgentRpcServer {
+    host;
+    options;
+    token;
+    maxBodyBytes;
+    listener;
+    constructor(options) {
+        this.options = Object.freeze({ ...options });
+        this.host = new CodingAgentHost({
+            backend: options.backend,
+            ...(options.sessionStore === undefined ? {} : { sessionStore: options.sessionStore }),
+            ...(options.contextWindow === undefined ? {} : { contextWindow: options.contextWindow }),
+            ...(options.extensions === undefined ? {} : { extensions: options.extensions }),
+            ...(options.verifyAfterTurn === undefined
+                ? {}
+                : { verifyAfterTurn: options.verifyAfterTurn }),
+            ...(options.maxRepairAttempts === undefined
+                ? {}
+                : { maxRepairAttempts: options.maxRepairAttempts }),
+            exposeErrorStacks: options.exposeErrorStacks === true,
+            ...(options.verification === undefined ? {} : { verification: options.verification }),
+        });
+        this.token = options.authToken ?? crypto.randomUUID().replaceAll("-", "");
+        if (!/^[A-Za-z0-9._~-]{16,256}$/.test(this.token))
+            throw new TypeError("agent rpc: authToken must be a bounded token");
+        this.maxBodyBytes = options.maxBodyBytes ?? 1_048_576;
+        if (!Number.isSafeInteger(this.maxBodyBytes) || this.maxBodyBytes < 1024)
+            throw new RangeError("agent rpc: maxBodyBytes must be at least 1024");
+    }
+    async start() {
+        if (this.listener !== undefined)
+            throw new Error("agent rpc: server is already running");
+        const hostname = this.options.hostname ?? "127.0.0.1";
+        if (!this.options.allowRemote && !isLoopbackHost(hostname))
+            throw new Error("agent rpc: remote binding requires allowRemote: true");
+        if (this.options.exposeErrorStacks === true && this.options.allowRemote === true)
+            throw new Error("agent rpc: exposeErrorStacks is only allowed for local-only binding");
+        this.listener = Bun.serve({
+            hostname,
+            port: this.options.port ?? 0,
+            fetch: (request) => this.fetch(request),
+        });
+        const listener = this.listener;
+        return {
+            url: listener.url.toString().replace(/\/$/, ""),
+            token: this.token,
+            stop: async () => {
+                await this.stop();
+            },
+        };
+    }
+    async stop() {
+        const listener = this.listener;
+        this.listener = undefined;
+        await this.host.stop("rpc server stopped");
+        listener?.stop(true);
+    }
+    async fetch(request) {
+        const cors = corsHeaders(request);
+        if (request.method === "OPTIONS")
+            return new Response(null, { status: 204, headers: cors });
+        const url = new URL(request.url);
+        if (url.pathname === "/health" && request.method === "GET")
+            return json({ ok: true, protocol: 1 }, 200, cors);
+        if (!authorized(request, this.token))
+            return json({ error: { code: "unauthorized", message: "agent RPC authorization required" } }, 401, cors);
+        if (url.pathname !== "/rpc" || request.method !== "POST")
+            return json({ error: { code: "not_found", message: "unknown agent RPC endpoint" } }, 404, cors);
+        const body = await this.readRequest(request);
+        if (!body.ok)
+            return json({ error: { code: "invalid_request", message: body.error } }, body.status, cors);
+        let rpc;
+        try {
+            rpc = parseRpcRequest(body.text);
+        }
+        catch (error) {
+            return json({ error: this.protocolError("invalid_request", error, "request body is invalid") }, 400, cors, this.options.exposeErrorStacks === true);
+        }
+        try {
+            return await this.dispatch(rpc, request, cors);
+        }
+        catch (error) {
+            return json({ error: this.protocolError("rpc_failed", error, "request could not be completed") }, 500, cors, this.options.exposeErrorStacks === true);
+        }
+    }
+    async dispatch(request, httpRequest, cors) {
+        switch (request.method) {
+            case "session.create": {
+                const params = record(request.params);
+                const snapshot = this.host.snapshot ??
+                    (await this.host.start({
+                        cwd: this.options.cwd,
+                        backend: this.options.backend.info.name,
+                        ...(typeof params.sessionId === "string" ? { sessionId: params.sessionId } : {}),
+                    }));
+                return json(snapshot, 200, cors);
+            }
+            case "session.snapshot": {
+                const snapshot = this.requireSnapshot();
+                return json(snapshot, 200, cors);
+            }
+            case "session.resume": {
+                const params = record(request.params);
+                if (typeof params.sessionId !== "string" ||
+                    !/^[A-Za-z0-9._:-]{1,128}$/.test(params.sessionId))
+                    return json({ error: { code: "invalid_session", message: "sessionId is required" } }, 422, cors);
+                const snapshot = this.host.snapshot ??
+                    (await this.host.start({
+                        cwd: this.options.cwd,
+                        backend: this.options.backend.info.name,
+                        sessionId: params.sessionId,
+                    }));
+                return json(snapshot, 200, cors);
+            }
+            case "session.events": {
+                const snapshot = this.requireSnapshot();
+                const params = record(request.params);
+                const limit = params.limit === undefined ? 512 : Number(params.limit);
+                if (!Number.isSafeInteger(limit) || limit < 1 || limit > 4096)
+                    return json({
+                        error: { code: "invalid_history_limit", message: "limit must be between 1 and 4096" },
+                    }, 422, cors);
+                const window = await this.host.history(limit);
+                // Legacy shape when no cursor is requested; a cursor opts into bounded snapshot + resume.
+                if (params.cursor === undefined)
+                    return json({ entries: window }, 200, cors);
+                const cursor = Number(params.cursor);
+                if (!Number.isSafeInteger(cursor) || cursor < -1)
+                    return json({ error: { code: "invalid_cursor", message: "cursor must be a safe integer >= -1" } }, 422, cors);
+                return json({ snapshot, resume: resumeFromCursor(window, cursor) }, 200, cors);
+            }
+            case "session.checkpoint": {
+                this.requireSnapshot();
+                const params = record(request.params);
+                await this.host.checkpoint(params.payload);
+                return json({ ok: true }, 200, cors);
+            }
+            case "session.fork": {
+                this.requireSnapshot();
+                const params = record(request.params);
+                if (params.targetSessionId !== undefined && typeof params.targetSessionId !== "string")
+                    return json({ error: { code: "invalid_session", message: "targetSessionId must be a string" } }, 422, cors);
+                return json(await this.host.fork(params.targetSessionId), 201, cors);
+            }
+            case "turn.send": {
+                const params = record(request.params);
+                if (typeof params.message !== "string" ||
+                    params.message.trim().length === 0 ||
+                    params.message.length > this.maxBodyBytes)
+                    return json({
+                        error: {
+                            code: "invalid_message",
+                            message: "message must be a non-empty bounded string",
+                        },
+                    }, 422, cors);
+                const stream = this.host.prompt(params.message, httpRequest.signal);
+                const encoder = new TextEncoder();
+                const includeErrorStacks = this.options.exposeErrorStacks === true;
+                const turnError = (error) => ({
+                    code: "turn_failed",
+                    ...publicErrorDetails(error, "turn could not be completed", includeErrorStacks),
+                });
+                const body = new ReadableStream({
+                    async start(controller) {
+                        try {
+                            for await (const event of stream)
+                                controller.enqueue(encoder.encode(`data: ${serializeRpcValue(event, includeErrorStacks)}\n\n`));
+                            controller.close();
+                        }
+                        catch (error) {
+                            controller.enqueue(encoder.encode(`event: error\ndata: ${JSON.stringify(turnError(error))}\n\n`));
+                            controller.close();
+                        }
+                    },
+                });
+                return new Response(body, {
+                    status: 200,
+                    headers: new Headers({
+                        ...Object.fromEntries(cors),
+                        "content-type": "text/event-stream; charset=utf-8",
+                        "cache-control": "no-cache, no-transform",
+                        connection: "keep-alive",
+                    }),
+                });
+            }
+            case "session.reload": {
+                const result = await this.host.reload();
+                return json(result, 200, cors);
+            }
+            case "session.compact": {
+                this.requireSnapshot();
+                return json(await this.host.compact("manual"), 200, cors);
+            }
+            case "approval.list": {
+                this.requireSnapshot();
+                return json({ pending: this.host.pendingApprovals }, 200, cors);
+            }
+            case "approval.request": {
+                const params = record(request.params);
+                if (typeof params.action !== "string" || typeof params.capability !== "string")
+                    return json({ error: { code: "invalid_approval", message: "action and capability are required" } }, 422, cors);
+                this.requireSnapshot();
+                const approval = await this.host.offerApproval({
+                    ...(typeof params.approvalId === "string"
+                        ? { id: params.approvalId }
+                        : { id: crypto.randomUUID().replaceAll("-", "") }),
+                    action: params.action,
+                    capability: params.capability,
+                    ...(typeof params.turnId === "string" ? { turnId: params.turnId } : {}),
+                    ...(typeof params.reason === "string" ? { reason: params.reason } : {}),
+                });
+                if (approval === undefined)
+                    return json({ error: { code: "approval_limit", message: "too many pending approvals" } }, 429, cors);
+                return json(approval, 201, cors);
+            }
+            case "approval.resolve": {
+                const params = record(request.params);
+                if (typeof params.approvalId !== "string" || typeof params.approved !== "boolean")
+                    return json({
+                        error: { code: "invalid_approval", message: "approvalId and approved are required" },
+                    }, 422, cors);
+                this.requireSnapshot();
+                const decision = await this.host.resolveApproval(params.approvalId, params.approved, typeof params.reason === "string" ? params.reason : undefined);
+                if (decision === undefined)
+                    return json({ error: { code: "approval_not_found", message: "approval is not pending" } }, 404, cors);
+                return json(decision, 200, cors);
+            }
+            case "ui.snapshot": {
+                this.requireSnapshot();
+                return json(this.options.ui === undefined
+                    ? { revision: "0", active: [] }
+                    : { revision: this.options.ui.currentRevision, active: this.options.ui.extensions }, 200, cors);
+            }
+            case "ui.reload": {
+                this.requireSnapshot();
+                if (this.options.ui === undefined)
+                    return json({ error: { code: "ui_unavailable", message: "UI extension host is not configured" } }, 409, cors);
+                const params = record(request.params);
+                if (!Array.isArray(params.manifests))
+                    return json({ error: { code: "invalid_ui", message: "manifests must be an array" } }, 422, cors);
+                return json(this.options.ui.reload(params.manifests), 200, cors);
+            }
+            case "ui.preview": {
+                this.requireSnapshot();
+                if (this.options.ui === undefined)
+                    return json({ error: { code: "ui_unavailable", message: "UI extension host is not configured" } }, 409, cors);
+                const params = record(request.params);
+                if (!Array.isArray(params.manifests))
+                    return json({ error: { code: "invalid_ui", message: "manifests must be an array" } }, 422, cors);
+                return json(this.options.ui.preview(params.manifests), 200, cors);
+            }
+            case "workflow.list": {
+                this.requireSnapshot();
+                return json({ workflows: this.options.extensions?.availableWorkflows ?? [] }, 200, cors);
+            }
+            case "subagent.list": {
+                this.requireSnapshot();
+                return json({ subagents: this.options.extensions?.availableSubagents ?? [] }, 200, cors);
+            }
+            case "provider.list": {
+                this.requireSnapshot();
+                return json({ providers: this.options.extensions?.availableProviders ?? [] }, 200, cors);
+            }
+            case "workflow.run": {
+                this.requireSnapshot();
+                if (this.options.extensions === undefined)
+                    return json({ error: { code: "workflow_unavailable", message: "workflow host is not configured" } }, 409, cors);
+                const params = record(request.params);
+                if (typeof params.name !== "string" || !/^[a-z][a-z0-9._-]{0,63}$/.test(params.name))
+                    return json({ error: { code: "invalid_workflow", message: "name must be a bounded workflow id" } }, 422, cors);
+                const result = await this.options.extensions.runWorkflow(params.name, {
+                    ...(httpRequest.signal === undefined ? {} : { signal: httpRequest.signal }),
+                    ...(typeof params.maxSteps === "number" &&
+                        Number.isSafeInteger(params.maxSteps) &&
+                        params.maxSteps > 0
+                        ? { maxSteps: Math.min(params.maxSteps, 512) }
+                        : {}),
+                    ...(typeof params.maxDepth === "number" &&
+                        Number.isSafeInteger(params.maxDepth) &&
+                        params.maxDepth > 0
+                        ? { maxDepth: Math.min(params.maxDepth, 16) }
+                        : {}),
+                    exposeErrorStacks: this.options.exposeErrorStacks === true,
+                });
+                return json(result, result.ok ? 200 : 422, cors, this.options.exposeErrorStacks === true);
+            }
+            case "verification.run": {
+                const params = record(request.params);
+                const name = params.name;
+                if (name !== "check" && name !== "assure" && name !== "test")
+                    return json({
+                        error: {
+                            code: "invalid_verification",
+                            message: "name must be check, assure, or test",
+                        },
+                    }, 422, cors);
+                this.requireSnapshot();
+                return json(await runNifraVerification(name, {
+                    cwd: this.options.cwd,
+                    exposeErrorStacks: this.options.exposeErrorStacks === true,
+                }), 200, cors, this.options.exposeErrorStacks === true);
+            }
+            case "project.diff": {
+                this.requireSnapshot();
+                return json(await readProjectDiff({
+                    cwd: this.options.cwd,
+                    exposeErrorStacks: this.options.exposeErrorStacks === true,
+                }), 200, cors, this.options.exposeErrorStacks === true);
+            }
+            case "session.stop": {
+                await this.host.stop("rpc request");
+                return json({ ok: true }, 200, cors);
+            }
+            default:
+                return json({ error: { code: "method_not_found", message: `unknown method: ${request.method}` } }, 404, cors);
+        }
+    }
+    requireSnapshot() {
+        if (this.host.snapshot === undefined)
+            throw new Error("agent RPC session has not been created");
+        return this.host.snapshot;
+    }
+    protocolError(code, error, fallback) {
+        return { code, ...publicErrorDetails(error, fallback, this.options.exposeErrorStacks === true) };
+    }
+    async readRequest(request) {
+        const length = Number(request.headers.get("content-length") ?? "0");
+        if (Number.isFinite(length) && length > this.maxBodyBytes)
+            return { ok: false, status: 413, error: "request body is too large" };
+        const result = await readBoundedText(request.body, this.maxBodyBytes);
+        if (result.truncated)
+            return { ok: false, status: 413, error: "request body is too large" };
+        return { ok: true, text: result.text };
+    }
+}
+function parseRpcRequest(text) {
+    let value;
+    try {
+        value = JSON.parse(text);
+    }
+    catch {
+        throw new Error("request body must be JSON");
+    }
+    const object = record(value);
+    if (typeof object.method !== "string" || !/^[a-z][a-z0-9._-]{1,63}$/.test(object.method))
+        throw new Error("request method is invalid");
+    return {
+        method: object.method,
+        ...(Object.hasOwn(object, "params") ? { params: object.params } : {}),
+    };
+}
+function record(value) {
+    if (value === null || typeof value !== "object" || Array.isArray(value))
+        return {};
+    return value;
+}
+function authorized(request, token) {
+    const header = request.headers.get("authorization");
+    if (header === null || !header.startsWith("Bearer "))
+        return false;
+    return constantTimeEqual(header.slice(7), token);
+}
+function constantTimeEqual(left, right) {
+    const a = new TextEncoder().encode(left);
+    const b = new TextEncoder().encode(right);
+    let difference = a.length ^ b.length;
+    const length = Math.max(a.length, b.length);
+    for (let index = 0; index < length; index++)
+        difference |= (a[index] ?? 0) ^ (b[index] ?? 0);
+    return difference === 0;
+}
+function corsHeaders(request) {
+    const headers = new Headers({
+        vary: "Origin",
+        "access-control-allow-headers": "authorization, content-type",
+        "access-control-allow-methods": "GET, POST, OPTIONS",
+    });
+    const origin = request.headers.get("origin");
+    if (origin !== null && /^https?:\/\/(?:127\.0\.0\.1|localhost)(?::\d+)?$/.test(origin))
+        headers.set("access-control-allow-origin", origin);
+    return headers;
+}
+function isLoopbackHost(hostname) {
+    return (hostname === "localhost" ||
+        hostname === "127.0.0.1" ||
+        hostname === "::1" ||
+        hostname === "[::1]");
+}
+function json(value, status, inherited, includeErrorStacks = false) {
+    const headers = new Headers(inherited);
+    headers.set("content-type", "application/json; charset=utf-8");
+    // lgtm [js/stack-trace-exposure] the default replacer removes stack fields from protocol data;
+    // stacks are serialized only in explicitly opt-in, loopback-only diagnostics mode.
+    return new Response(serializeRpcValue(value, includeErrorStacks), { status, headers });
+}
+function serializeRpcValue(value, includeErrorStacks) {
+    return JSON.stringify(value, includeErrorStacks
+        ? undefined
+        : (key, nested) => (key === "stack" ? undefined : nested));
+}
+//# sourceMappingURL=rpc.js.map

package/dist/rpc.js.map

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

package/dist/session-migration.d.ts

@@ -0,0 +1,59 @@
+/** Version of the evidence-only legacy session file format. */
+export declare const SESSION_EVIDENCE_VERSION: 1;
+/**
+ * A single legacy session record after content has been removed.
+ *
+ * `digest` covers this record without the digest field. It is an integrity identifier, not a
+ * digest of the legacy payload. The payload is never written to the migration target.
+ */
+export interface SessionEvidenceRecord {
+    readonly version: typeof SESSION_EVIDENCE_VERSION;
+    readonly sessionId: string;
+    readonly seq: number;
+    readonly at: number;
+    readonly code: string;
+    readonly count: 1;
+    readonly digest: string;
+    readonly pinned?: boolean;
+}
+/** Counts and integrity metadata emitted after a target has been fully validated. */
+export interface SessionMigrationReport {
+    readonly version: typeof SESSION_EVIDENCE_VERSION;
+    readonly sessionId: string;
+    readonly records: number;
+    /** Number of source event types replaced by the stable unknown-event code. */
+    readonly skipped: number;
+    readonly skippedByCode: Readonly<Record<string, number>>;
+    readonly counts: Readonly<Record<string, number>>;
+    readonly firstSeq?: number;
+    readonly lastSeq?: number;
+    /** Digest of the complete evidence-only target file, including line separators. */
+    readonly digest: string;
+}
+export interface MigrateLegacySessionOptions {
+    readonly sourceRoot: string;
+    readonly targetRoot: string;
+    readonly sessionId: string;
+    /** Abort before any target commit. The legacy source is never modified. */
+    readonly signal?: AbortSignal;
+    /** Bound the amount of legacy data read into transient memory. */
+    readonly maxSourceBytes?: number;
+}
+export declare class SessionMigrationError extends Error {
+    readonly code: string;
+    constructor(code: string, message: string);
+}
+/**
+ * Convert a legacy event type into a stable, content-free evidence code.
+ * Unknown event names are intentionally not copied to the target: their SHA-256 prefix gives a
+ * repeatable grouping key without disclosing an arbitrary source string.
+ */
+export declare function stableSessionEventCode(type: string): Promise<{
+    readonly code: string;
+    readonly replaced: boolean;
+}>;
+/** Parse one evidence record strictly. Payload-bearing or unknown fields are rejected. */
+export declare function parseSessionEvidenceRecord(value: unknown): SessionEvidenceRecord;
+/** Read, project, validate, and atomically commit one legacy local session. */
+export declare function migrateLegacySession(options: MigrateLegacySessionOptions): Promise<SessionMigrationReport>;
+//# sourceMappingURL=session-migration.d.ts.map

package/dist/session-migration.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-migration.d.ts","sourceRoot":"","sources":["../src/session-migration.ts"],"names":[],"mappings":"AAGA,+DAA+D;AAC/D,eAAO,MAAM,wBAAwB,EAAG,CAAU,CAAA;AAOlD;;;;;GAKG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,OAAO,EAAE,OAAO,wBAAwB,CAAA;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAA;IACpB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,CAAC,CAAA;IACjB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;IACvB,QAAQ,CAAC,MAAM,CAAC,EAAE,OAAO,CAAA;CAC1B;AAED,qFAAqF;AACrF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,OAAO,wBAAwB,CAAA;IACjD,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,8EAA8E;IAC9E,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAA;IACxB,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACxD,QAAQ,CAAC,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IACjD,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;IAC1B,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAA;IACzB,mFAAmF;IACnF,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CACxB;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAA;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAA;IAC1B,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,CAAC,EAAE,WAAW,CAAA;IAC7B,kEAAkE;IAClE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CACjC;AAED,qBAAa,qBAAsB,SAAQ,KAAK;IAE5C,QAAQ,CAAC,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM,EACrB,OAAO,EAAE,MAAM;CAKlB;AAED;;;;GAIG;AACH,wBAAsB,sBAAsB,CAC1C,IAAI,EAAE,MAAM,GACX,OAAO,CAAC;IAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAAE,CAAC,CAIhE;AAED,0FAA0F;AAC1F,wBAAgB,0BAA0B,CAAC,KAAK,EAAE,OAAO,GAAG,qBAAqB,CA6BhF;AAED,+EAA+E;AAC/E,wBAAsB,oBAAoB,CACxC,OAAO,EAAE,2BAA2B,GACnC,OAAO,CAAC,sBAAsB,CAAC,CA2EjC"}