@claudexor/acp-server 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 joi-lab
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,7 @@
+# @claudexor/acp-server
+
+Internal package of [Claudexor](https://github.com/razzant/claudexor) — Minimal ACP server (stdio JSON-RPC) exposing Claudexor as a meta-agent to editors. Runner injected.
+
+Published as part of the Claudexor toolchain; it follows the monorepo's
+lockstep version and has no separate semver contract. Use the `claudexor`
+CLI (or `@claudexor/cli`) as the supported entry point.

package/dist/index.d.ts

@@ -0,0 +1,76 @@
+import type { Readable, Writable } from "node:stream";
+export declare const ACP_PROTOCOL_VERSION = 1;
+export interface RunnerHooks {
+    /** Live RunEvent sink (mirrors events.jsonl) for session/update streaming. */
+    onEvent?: (event: any) => void;
+    /** Interactive question surface; resolve with answers or null to decline. */
+    onInteraction?: (ctx: any) => Promise<any | null>;
+    /** Cooperative cancellation (session/cancel aborts the underlying run). */
+    signal?: AbortSignal;
+}
+export type RunnerFn = (params: any, hooks?: RunnerHooks) => Promise<unknown>;
+export interface AcpServerOptions {
+    runner: RunnerFn;
+    transport: {
+        read: Readable;
+        write: Writable;
+    };
+    name?: string;
+    version?: string;
+}
+/**
+ * Minimal Agent Client Protocol server (JSON-RPC over stdio). Exposes Claudexor as
+ * a meta-agent: editors can talk to Claudexor instead of a single harness.
+ * Implements initialize / session/new / session/prompt / session/cancel, streams
+ * live run events as session/update notifications, and forwards interactive
+ * harness questions as session/request_permission round-trips.
+ */
+export declare class AcpServer {
+    private readonly opts;
+    private sessions;
+    /** Editor-provided project root per session (anchors runs to the user's project). */
+    private readonly sessionCwds;
+    private nextRequestId;
+    private readonly pendingRequests;
+    /** Active run per session: lets session/cancel abort and keeps prompts serial. */
+    private readonly activeRuns;
+    /** Fallback tool_call ids keyed by `${sessionId}:${toolName}` — a FIFO QUEUE of
+     * synthetic ids awaiting completion by a tool_result that arrives WITHOUT a
+     * use_id. A queue (not a single slot) so two in-flight same-name use_id-less
+     * calls don't clobber each other: each PUSHes on tool_call, the matching
+     * tool_result SHIFTs one (oldest-first). use_id-bearing calls match directly
+     * by id and never touch this. */
+    private readonly openToolCalls;
+    constructor(opts: AcpServerOptions);
+    serve(): Promise<void>;
+    private write;
+    private reply;
+    /** Spec-coded JSON-RPC error response ({code, message}) — never an ad-hoc shape. */
+    private error;
+    private notify;
+    /**
+     * Server->client JSON-RPC request (e.g. session/request_permission),
+     * bounded by a deadline: an editor that never answers must not leave the
+     * request pending forever (the engine's own interaction timeout would
+     * eventually fire, but the ACP surface owns its half of the contract —
+     * every request resolves, and the pending slot is always reclaimed).
+     * Resolves null on deadline.
+     */
+    private request;
+    handle(msg: any): Promise<void>;
+    /**
+     * JSON-RPC notifications (no `id`) get NO response. ACP `session/cancel` is a
+     * notification: it aborts the underlying run (cooperative cancellation) and the
+     * in-flight session/prompt then resolves with stopReason "cancelled".
+     */
+    private handleNotification;
+    /** Thin RunEvent -> session/update projection (no business logic). */
+    private forwardRunEvent;
+    /**
+     * Interactive question -> one session/request_permission round-trip per
+     * question (ACP's permission options carry a flat choice list). A cancelled
+     * or unanswered request resolves null and the engine declines benignly.
+     */
+    private requestAnswers;
+}
+//# 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":"AAGA,OAAO,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAKtD,eAAO,MAAM,oBAAoB,IAAI,CAAC;AAEtC,MAAM,WAAW,WAAW;IAC1B,8EAA8E;IAC9E,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,GAAG,KAAK,IAAI,CAAC;IAC/B,6EAA6E;IAC7E,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,GAAG,KAAK,OAAO,CAAC,GAAG,GAAG,IAAI,CAAC,CAAC;IAClD,2EAA2E;IAC3E,MAAM,CAAC,EAAE,WAAW,CAAC;CACtB;AAED,MAAM,MAAM,QAAQ,GAAG,CAAC,MAAM,EAAE,GAAG,EAAE,KAAK,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;AAE9E,MAAM,WAAW,gBAAgB;IAC/B,MAAM,EAAE,QAAQ,CAAC;IACjB,SAAS,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAC;QAAC,KAAK,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC/C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;;;;;GAMG;AACH,qBAAa,SAAS;IAgBR,OAAO,CAAC,QAAQ,CAAC,IAAI;IAfjC,OAAO,CAAC,QAAQ,CAAqB;IACrC,qFAAqF;IACrF,OAAO,CAAC,QAAQ,CAAC,WAAW,CAA6B;IACzD,OAAO,CAAC,aAAa,CAAK;IAC1B,OAAO,CAAC,QAAQ,CAAC,eAAe,CAA4C;IAC5E,kFAAkF;IAClF,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAsC;IACjE;;;;;qCAKiC;IACjC,OAAO,CAAC,QAAQ,CAAC,aAAa,CAA+B;gBAEhC,IAAI,EAAE,gBAAgB;IAE7C,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAwC5B,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,KAAK;IAIb,oFAAoF;IACpF,OAAO,CAAC,KAAK;IAIb,OAAO,CAAC,MAAM;IAId;;;;;;;OAOG;IACH,OAAO,CAAC,OAAO;IAkBT,MAAM,CAAC,GAAG,EAAE,GAAG,GAAG,OAAO,CAAC,IAAI,CAAC;IAwIrC;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;IAU1B,sEAAsE;IACtE,OAAO,CAAC,eAAe;IAuFvB;;;;OAIG;YACW,cAAc;CA8E7B"}

package/dist/index.js

@@ -0,0 +1,435 @@
+import { existsSync, lstatSync } from "node:fs";
+import { createInterface } from "node:readline";
+import { isAbsolute } from "node:path";
+import { extractPromptText, summarizeResult } from "./prompt.js";
+import { validateRunControls } from "./validate.js";
+export const ACP_PROTOCOL_VERSION = 1;
+/**
+ * Minimal Agent Client Protocol server (JSON-RPC over stdio). Exposes Claudexor as
+ * a meta-agent: editors can talk to Claudexor instead of a single harness.
+ * Implements initialize / session/new / session/prompt / session/cancel, streams
+ * live run events as session/update notifications, and forwards interactive
+ * harness questions as session/request_permission round-trips.
+ */
+export class AcpServer {
+    opts;
+    sessions = new Set();
+    /** Editor-provided project root per session (anchors runs to the user's project). */
+    sessionCwds = new Map();
+    nextRequestId = 1;
+    pendingRequests = new Map();
+    /** Active run per session: lets session/cancel abort and keeps prompts serial. */
+    activeRuns = new Map();
+    /** Fallback tool_call ids keyed by `${sessionId}:${toolName}` — a FIFO QUEUE of
+     * synthetic ids awaiting completion by a tool_result that arrives WITHOUT a
+     * use_id. A queue (not a single slot) so two in-flight same-name use_id-less
+     * calls don't clobber each other: each PUSHes on tool_call, the matching
+     * tool_result SHIFTs one (oldest-first). use_id-bearing calls match directly
+     * by id and never touch this. */
+    openToolCalls = new Map();
+    constructor(opts) {
+        this.opts = opts;
+    }
+    async serve() {
+        const rl = createInterface({ input: this.opts.transport.read });
+        for await (const line of rl) {
+            const trimmed = line.trim();
+            if (!trimmed)
+                continue;
+            let msg;
+            try {
+                msg = JSON.parse(trimmed);
+            }
+            catch {
+                // JSON-RPC 2.0 prescribes a Parse Error response with id null —
+                // a malformed frame must never vanish silently (fail-loud surface).
+                this.write({ jsonrpc: "2.0", id: null, error: { code: -32700, message: "parse error: invalid JSON frame" } });
+                continue;
+            }
+            // Responses to OUR outgoing requests carry an id and no method.
+            if (msg.id !== undefined && msg.method === undefined) {
+                const pending = this.pendingRequests.get(String(msg.id));
+                if (pending) {
+                    this.pendingRequests.delete(String(msg.id));
+                    pending(msg.result ?? msg.error ?? null);
+                }
+                continue;
+            }
+            // A JSON-RPC NOTIFICATION (method present, no id) must be handled WITHOUT
+            // a response — replying to a notification violates JSON-RPC. session/cancel
+            // arrives this way (id-less) and aborts the active run silently.
+            if (msg.id === undefined || msg.id === null) {
+                this.handleNotification(msg);
+                continue;
+            }
+            // NEVER block the read loop on a handler: session/prompt runs for
+            // minutes and the loop must keep consuming session/request_permission
+            // responses and session/cancel while the run is active. Handler errors
+            // are reported per-request, not thrown into the loop.
+            void this.handle(msg).catch((err) => {
+                this.write({ jsonrpc: "2.0", id: msg.id, error: { code: -32603, message: err instanceof Error ? err.message : String(err) } });
+            });
+        }
+    }
+    write(obj) {
+        this.opts.transport.write.write(JSON.stringify(obj) + "\n");
+    }
+    reply(id, result) {
+        this.write({ jsonrpc: "2.0", id, result });
+    }
+    /** Spec-coded JSON-RPC error response ({code, message}) — never an ad-hoc shape. */
+    error(id, code, message, data) {
+        this.write({ jsonrpc: "2.0", id, error: { code, message, ...(data ? { data } : {}) } });
+    }
+    notify(method, params) {
+        this.write({ jsonrpc: "2.0", method, params });
+    }
+    /**
+     * Server->client JSON-RPC request (e.g. session/request_permission),
+     * bounded by a deadline: an editor that never answers must not leave the
+     * request pending forever (the engine's own interaction timeout would
+     * eventually fire, but the ACP surface owns its half of the contract —
+     * every request resolves, and the pending slot is always reclaimed).
+     * Resolves null on deadline.
+     */
+    request(method, params, deadlineMs) {
+        const id = `srv-${this.nextRequestId++}`;
+        return new Promise((resolve) => {
+            let timer;
+            if (deadlineMs !== undefined && Number.isFinite(deadlineMs)) {
+                timer = setTimeout(() => {
+                    if (this.pendingRequests.delete(id))
+                        resolve(null);
+                }, Math.max(0, deadlineMs));
+                timer.unref?.();
+            }
+            this.pendingRequests.set(id, (result) => {
+                if (timer)
+                    clearTimeout(timer);
+                resolve(result);
+            });
+            this.write({ jsonrpc: "2.0", id, method, params });
+        });
+    }
+    async handle(msg) {
+        const { id, method, params } = msg;
+        switch (method) {
+            case "initialize":
+                this.reply(id, {
+                    protocolVersion: ACP_PROTOCOL_VERSION,
+                    agentInfo: { name: this.opts.name ?? "claudexor", version: this.opts.version ?? "dev" },
+                    agentCapabilities: { promptCapabilities: { image: false, audio: false, embeddedContext: true } },
+                    // ACP v1 InitializeResponse carries authMethods; strict clients
+                    // deserialize it. Claudexor needs no editor-side auth: empty list.
+                    authMethods: [],
+                });
+                return;
+            case "session/new": {
+                const sessionId = `acp-${Math.random().toString(36).slice(2, 10)}`;
+                // The editor's cwd anchors all of this session's runs to the project the
+                // user is actually in (previously ignored -> runs hit the server's cwd).
+                if (!params || !Object.prototype.hasOwnProperty.call(params, "cwd")) {
+                    this.error(id, -32600, "session/new cwd is required");
+                    return;
+                }
+                if (typeof params.cwd !== "string" || !params.cwd.trim()) {
+                    this.error(id, -32600, "session/new cwd must be a non-empty absolute path string");
+                    return;
+                }
+                const cwd = params.cwd.trim();
+                if (!isAbsolute(cwd)) {
+                    this.error(id, -32600, "session/new cwd must be an absolute path");
+                    return;
+                }
+                if (!existsSync(cwd) || !lstatSync(cwd).isDirectory()) {
+                    this.error(id, -32600, "session/new cwd must be an existing directory");
+                    return;
+                }
+                this.sessions.add(sessionId);
+                this.sessionCwds.set(sessionId, cwd);
+                this.reply(id, { sessionId });
+                return;
+            }
+            case "session/prompt": {
+                const sessionId = params?.sessionId;
+                const text = extractPromptText(params?.prompt);
+                if (!text.trim()) {
+                    this.error(id, -32600, "prompt must be a non-empty string");
+                    return;
+                }
+                if (!sessionId || !this.sessions.has(sessionId) || !this.sessionCwds.has(sessionId)) {
+                    this.error(id, -32600, "session/prompt requires a known session created with session/new cwd");
+                    return;
+                }
+                const runControlError = validateRunControls(params);
+                if (runControlError) {
+                    // The machine-readable class (e.g. inline_secret_rejected) rides
+                    // JSON-RPC error.data so ACP hosts can branch without parsing prose.
+                    this.error(id, -32600, runControlError.message, runControlError.code ? { code: runControlError.code } : undefined);
+                    return;
+                }
+                // One active run per session: a second prompt while one is running is
+                // a protocol misuse. ACP StopReason has no "error" member, so fail loudly
+                // as a JSON-RPC error (-32600 Invalid Request) rather than inventing one.
+                if (this.activeRuns.has(sessionId)) {
+                    this.error(id, -32600, `session ${sessionId} already has an active prompt`);
+                    return;
+                }
+                const controller = new AbortController();
+                this.activeRuns.set(sessionId, controller);
+                try {
+                    const hooks = {
+                        signal: controller.signal,
+                        onEvent: (event) => this.forwardRunEvent(sessionId, event),
+                        onInteraction: (ctx) => this.requestAnswers(sessionId, ctx),
+                    };
+                    const result = await this.opts.runner({
+                        prompt: text,
+                        mode: params?.mode ?? "agent",
+                        repoPath: this.sessionCwds.get(sessionId),
+                        ...(params?.harness !== undefined ? { harness: params.harness } : {}),
+                        ...(params?.primaryHarness !== undefined
+                            ? { primaryHarness: params.primaryHarness }
+                            : {}),
+                        ...(params?.web !== undefined ? { web: params.web } : {}),
+                        ...(params?.externalContextPolicy !== undefined
+                            ? { externalContextPolicy: params.externalContextPolicy }
+                            : {}),
+                        ...(params?.model !== undefined ? { model: params.model } : {}),
+                        ...(params?.effort !== undefined ? { effort: params.effort } : {}),
+                        ...(params?.n !== undefined ? { n: params.n } : {}),
+                        ...(params?.race === true ? { race: true } : {}),
+                        ...(params?.untilClean === true ? { untilClean: true } : {}),
+                        ...(params?.swarm === true ? { swarm: true } : {}),
+                        ...(params?.create === true ? { create: true } : {}),
+                        ...(params?.tests !== undefined ? { tests: params.tests } : {}),
+                        ...(params?.maxUsd !== undefined ? { maxUsd: params.maxUsd } : {}),
+                        ...(params?.access !== undefined ? { access: params.access } : {}),
+                        ...(params?.protectedPathApprovals !== undefined
+                            ? { protectedPathApprovals: params.protectedPathApprovals }
+                            : {}),
+                        ...(params?.reviewerPanel !== undefined ? { reviewerPanel: params.reviewerPanel } : {}),
+                        ...(params?.reviewerModels !== undefined
+                            ? { reviewerModels: params.reviewerModels }
+                            : {}),
+                        ...(params?.reviewerEfforts !== undefined
+                            ? { reviewerEfforts: params.reviewerEfforts }
+                            : {}),
+                    }, hooks);
+                    // The turn result is the human-readable summary/answer (the run's
+                    // primary output), not a raw dumped JSON object the editor can't show.
+                    const summary = summarizeResult(result);
+                    if (summary) {
+                        this.notify("session/update", {
+                            sessionId,
+                            update: { sessionUpdate: "agent_message_chunk", content: { type: "text", text: summary } },
+                        });
+                    }
+                    this.reply(id, { stopReason: controller.signal.aborted ? "cancelled" : "end_turn" });
+                }
+                catch (err) {
+                    if (controller.signal.aborted) {
+                        this.reply(id, { stopReason: "cancelled" });
+                    }
+                    else {
+                        // A failed turn is a JSON-RPC error (-32603 internal), not an invented
+                        // StopReason — the ACP StopReason enum has no "error" member.
+                        this.error(id, -32603, err instanceof Error ? err.message : String(err));
+                    }
+                }
+                finally {
+                    if (this.activeRuns.get(sessionId) === controller)
+                        this.activeRuns.delete(sessionId);
+                }
+                return;
+            }
+            default:
+                this.error(id, -32601, `method not found: ${method}`);
+        }
+    }
+    /**
+     * JSON-RPC notifications (no `id`) get NO response. ACP `session/cancel` is a
+     * notification: it aborts the underlying run (cooperative cancellation) and the
+     * in-flight session/prompt then resolves with stopReason "cancelled".
+     */
+    handleNotification(msg) {
+        const { method, params } = msg;
+        if (method === "session/cancel") {
+            const sessionId = params?.sessionId;
+            const active = sessionId ? this.activeRuns.get(sessionId) : undefined;
+            if (active)
+                active.abort();
+        }
+        // Unknown notifications are silently ignored — JSON-RPC forbids replying.
+    }
+    /** Thin RunEvent -> session/update projection (no business logic). */
+    forwardRunEvent(sessionId, event) {
+        const type = String(event?.type ?? "");
+        const p = (event?.payload ?? {});
+        if (type === "harness.event") {
+            const sub = String(p["type"] ?? "");
+            if (sub === "message" && typeof p["text"] === "string" && p["text"].trim()) {
+                this.notify("session/update", {
+                    sessionId,
+                    update: { sessionUpdate: "agent_message_chunk", content: { type: "text", text: p["text"] } },
+                });
+                return;
+            }
+            if (sub === "thinking" && typeof p["text"] === "string" && p["text"].trim()) {
+                this.notify("session/update", {
+                    sessionId,
+                    update: { sessionUpdate: "agent_thought_chunk", content: { type: "text", text: p["text"] } },
+                });
+                return;
+            }
+            if (sub === "tool_call" && p["tool"] && typeof p["tool"] === "object") {
+                const tool = p["tool"];
+                const toolCallId = String(tool["use_id"] ?? `tc-${Math.random().toString(36).slice(2, 8)}`);
+                // Fallback matching for tool_results that lack a native use_id: only those
+                // need it (a use_id-bearing result matches directly by id). Without this the
+                // synthetic tc-* call never completes and the client hangs. Key by
+                // sessionId+name (the only discriminator the result side also carries) and
+                // PUSH onto a FIFO queue so two concurrent same-name use_id-less calls each
+                // get their own slot — the matching results SHIFT them oldest-first.
+                if (typeof tool["use_id"] !== "string") {
+                    const fallbackKey = `${sessionId}:${String(tool["name"] ?? "")}`;
+                    const queue = this.openToolCalls.get(fallbackKey);
+                    if (queue)
+                        queue.push(toolCallId);
+                    else
+                        this.openToolCalls.set(fallbackKey, [toolCallId]);
+                }
+                this.notify("session/update", {
+                    sessionId,
+                    update: {
+                        sessionUpdate: "tool_call",
+                        toolCallId,
+                        title: String(tool["name"] ?? "tool"),
+                        status: "in_progress",
+                    },
+                });
+                return;
+            }
+            if (sub === "tool_result" && p["tool"] && typeof p["tool"] === "object") {
+                const tool = p["tool"];
+                // Terminal completion for the started tool_call. status: "ok"->completed,
+                // "error"->failed; an unknown/missing status still completes (never hang).
+                const hasUseId = typeof tool["use_id"] === "string" && tool["use_id"];
+                const fallbackKey = `${sessionId}:${String(tool["name"] ?? "")}`;
+                // use_id-bearing result -> match directly; otherwise SHIFT the oldest
+                // queued synthetic id (FIFO) so concurrent same-name calls each complete.
+                const queue = hasUseId ? undefined : this.openToolCalls.get(fallbackKey);
+                const toolCallId = hasUseId ? String(tool["use_id"]) : queue?.shift();
+                if (toolCallId) {
+                    // Drop the queue once drained so empty keys don't accumulate.
+                    if (queue && queue.length === 0)
+                        this.openToolCalls.delete(fallbackKey);
+                    this.notify("session/update", {
+                        sessionId,
+                        update: {
+                            sessionUpdate: "tool_call_update",
+                            toolCallId,
+                            status: tool["status"] === "error" ? "failed" : "completed",
+                        },
+                    });
+                }
+                return;
+            }
+            return;
+        }
+        if (type === "run.completed" || type === "run.failed" || type === "run.blocked") {
+            // Human sentences, not raw event ids — this text lands in the editor's
+            // chat timeline as-is.
+            const text = type === "run.completed"
+                ? "[claudexor] run completed."
+                : type === "run.failed"
+                    ? "[claudexor] run failed — inspect the run artifacts for diagnostics."
+                    : "[claudexor] run blocked — a typed operator decision is required before this result can be applied.";
+            this.notify("session/update", {
+                sessionId,
+                update: { sessionUpdate: "agent_message_chunk", content: { type: "text", text } },
+            });
+        }
+    }
+    /**
+     * Interactive question -> one session/request_permission round-trip per
+     * question (ACP's permission options carry a flat choice list). A cancelled
+     * or unanswered request resolves null and the engine declines benignly.
+     */
+    async requestAnswers(sessionId, ctx) {
+        const request = ctx?.request;
+        const questions = Array.isArray(request?.questions) ? request.questions : [];
+        if (questions.length === 0)
+            return null;
+        const answers = [];
+        let declinedFreeText = false;
+        for (const [qIdx, q] of questions.entries()) {
+            const options = (Array.isArray(q?.options) ? q.options : []).map((o, idx) => ({
+                optionId: `opt-${idx + 1}`,
+                name: String(o?.label ?? `option ${idx + 1}`),
+                kind: "allow_once",
+            }));
+            if (options.length === 0) {
+                // A free-text question has no answer channel over ACP: session/request_permission
+                // returns a chosen optionId, NOT arbitrary text. Faking an "Answer in chat"
+                // affordance would advertise a capability this surface cannot honor. Decline
+                // benignly (like the --json path) so the run continues with assumptions, and
+                // note it honestly to the client below.
+                declinedFreeText = true;
+                continue;
+            }
+            // Announce the tool_call the permission request will reference —
+            // clients that JOIN permissions to tool calls otherwise render an
+            // orphan (the id must exist in the session's tool-call timeline).
+            // UNIQUE per question: a multi-question interaction must not reuse one
+            // id across frames (joining clients would clobber/mis-associate).
+            const toolCallId = `${String(request?.interaction_id ?? "interaction")}:${String(q?.id ?? qIdx)}`;
+            this.notify("session/update", {
+                sessionId,
+                update: {
+                    sessionUpdate: "tool_call",
+                    toolCallId,
+                    title: String(q?.question ?? "Question"),
+                    kind: "other",
+                    status: "pending",
+                },
+            });
+            // Bound the wait by the interaction's own deadline (the engine stamps
+            // timeoutAt on every interaction request); a silent editor then yields
+            // a null response instead of a forever-pending server request.
+            const deadlineMs = Date.parse(String(request?.timeout_at ?? ctx?.timeoutAt ?? "")) - Date.now();
+            const response = await this.request("session/request_permission", {
+                sessionId,
+                toolCall: { toolCallId, title: String(q?.question ?? "Question") },
+                options,
+            }, Number.isFinite(deadlineMs) ? deadlineMs : 900_000);
+            const optionId = response?.outcome?.optionId ?? response?.optionId;
+            const picked = typeof optionId === "string" ? options.find((o) => o.optionId === optionId) : undefined;
+            // Terminal status for the announced call either way: completed on an
+            // answer, failed on decline/timeout — a started tool_call never hangs.
+            this.notify("session/update", {
+                sessionId,
+                update: { sessionUpdate: "tool_call_update", toolCallId, status: picked ? "completed" : "failed" },
+            });
+            if (picked) {
+                answers.push({ question_id: String(q?.id ?? ""), selected_labels: [picked.name], free_text: null });
+            }
+        }
+        if (declinedFreeText) {
+            this.notify("session/update", {
+                sessionId,
+                update: {
+                    sessionUpdate: "agent_message_chunk",
+                    content: {
+                        type: "text",
+                        text: "[claudexor] a free-text question could not be answered over ACP; the run continues with assumptions.",
+                    },
+                },
+            });
+        }
+        // Returning answers only for the choice questions; an empty set is a benign
+        // decline (orchestrator/adapter then continue with assumptions).
+        return answers.length > 0 ? { interaction_id: String(request?.interaction_id ?? ""), answers } : null;
+    }
+}
+//# 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,OAAO,EAAE,UAAU,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAChD,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAC;AAEvC,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AACjE,OAAO,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAGpD,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,CAAC;AAoBtC;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IAgBS;IAfrB,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACrC,qFAAqF;IACpE,WAAW,GAAG,IAAI,GAAG,EAAkB,CAAC;IACjD,aAAa,GAAG,CAAC,CAAC;IACT,eAAe,GAAG,IAAI,GAAG,EAAiC,CAAC;IAC5E,kFAAkF;IACjE,UAAU,GAAG,IAAI,GAAG,EAA2B,CAAC;IACjE;;;;;qCAKiC;IAChB,aAAa,GAAG,IAAI,GAAG,EAAoB,CAAC;IAE7D,YAA6B,IAAsB;QAAtB,SAAI,GAAJ,IAAI,CAAkB;IAAG,CAAC;IAEvD,KAAK,CAAC,KAAK;QACT,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC;QAChE,IAAI,KAAK,EAAE,MAAM,IAAI,IAAI,EAAE,EAAE,CAAC;YAC5B,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;YAC5B,IAAI,CAAC,OAAO;gBAAE,SAAS;YACvB,IAAI,GAAQ,CAAC;YACb,IAAI,CAAC;gBACH,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;YAC5B,CAAC;YAAC,MAAM,CAAC;gBACP,gEAAgE;gBAChE,oEAAoE;gBACpE,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,iCAAiC,EAAE,EAAE,CAAC,CAAC;gBAC9G,SAAS;YACX,CAAC;YACD,gEAAgE;YAChE,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,GAAG,CAAC,MAAM,KAAK,SAAS,EAAE,CAAC;gBACrD,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;gBACzD,IAAI,OAAO,EAAE,CAAC;oBACZ,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC;oBAC5C,OAAO,CAAC,GAAG,CAAC,MAAM,IAAI,GAAG,CAAC,KAAK,IAAI,IAAI,CAAC,CAAC;gBAC3C,CAAC;gBACD,SAAS;YACX,CAAC;YACD,0EAA0E;YAC1E,4EAA4E;YAC5E,iEAAiE;YACjE,IAAI,GAAG,CAAC,EAAE,KAAK,SAAS,IAAI,GAAG,CAAC,EAAE,KAAK,IAAI,EAAE,CAAC;gBAC5C,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC;gBAC7B,SAAS;YACX,CAAC;YACD,kEAAkE;YAClE,sEAAsE;YACtE,uEAAuE;YACvE,sDAAsD;YACtD,KAAK,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;gBAClC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;YACjI,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,GAAY;QACxB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,GAAG,IAAI,CAAC,CAAC;IAC9D,CAAC;IAEO,KAAK,CAAC,EAAW,EAAE,MAAe;QACxC,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7C,CAAC;IAED,oFAAoF;IAC5E,KAAK,CAAC,EAAW,EAAE,IAAY,EAAE,OAAe,EAAE,IAA8B;QACtF,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC;IAC1F,CAAC;IAEO,MAAM,CAAC,MAAc,EAAE,MAAe;QAC5C,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;IACjD,CAAC;IAED;;;;;;;OAOG;IACK,OAAO,CAAC,MAAc,EAAE,MAAe,EAAE,UAAmB;QAClE,MAAM,EAAE,GAAG,OAAO,IAAI,CAAC,aAAa,EAAE,EAAE,CAAC;QACzC,OAAO,IAAI,OAAO,CAAC,CAAC,OAAO,EAAE,EAAE;YAC7B,IAAI,KAAgD,CAAC;YACrD,IAAI,UAAU,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,CAAC;gBAC5D,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE;oBACtB,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,CAAC,EAAE,CAAC;wBAAE,OAAO,CAAC,IAAI,CAAC,CAAC;gBACrD,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,UAAU,CAAC,CAAC,CAAC;gBAC5B,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;YAClB,CAAC;YACD,IAAI,CAAC,eAAe,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,MAAM,EAAE,EAAE;gBACtC,IAAI,KAAK;oBAAE,YAAY,CAAC,KAAK,CAAC,CAAC;gBAC/B,OAAO,CAAC,MAAM,CAAC,CAAC;YAClB,CAAC,CAAC,CAAC;YACH,IAAI,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,CAAC;QACrD,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,MAAM,CAAC,GAAQ;QACnB,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QACnC,QAAQ,MAAM,EAAE,CAAC;YACf,KAAK,YAAY;gBACf,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE;oBACb,eAAe,EAAE,oBAAoB;oBACrC,SAAS,EAAE,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,IAAI,WAAW,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,OAAO,IAAI,KAAK,EAAE;oBACvF,iBAAiB,EAAE,EAAE,kBAAkB,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,eAAe,EAAE,IAAI,EAAE,EAAE;oBAChG,gEAAgE;oBAChE,mEAAmE;oBACnE,WAAW,EAAE,EAAE;iBAChB,CAAC,CAAC;gBACH,OAAO;YACT,KAAK,aAAa,CAAC,CAAC,CAAC;gBACnB,MAAM,SAAS,GAAG,OAAO,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC;gBACnE,yEAAyE;gBACzE,yEAAyE;gBACzE,IAAI,CAAC,MAAM,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,cAAc,CAAC,IAAI,CAAC,MAAM,EAAE,KAAK,CAAC,EAAE,CAAC;oBACpE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,6BAA6B,CAAC,CAAC;oBACtD,OAAO;gBACT,CAAC;gBACD,IAAI,OAAO,MAAM,CAAC,GAAG,KAAK,QAAQ,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,EAAE,CAAC;oBACzD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,0DAA0D,CAAC,CAAC;oBACnF,OAAO;gBACT,CAAC;gBACD,MAAM,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC;gBAC9B,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;oBACrB,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,0CAA0C,CAAC,CAAC;oBACnE,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,WAAW,EAAE,EAAE,CAAC;oBACtD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,+CAA+C,CAAC,CAAC;oBACxE,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;gBAC7B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,EAAE,GAAG,CAAC,CAAC;gBACrC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC9B,OAAO;YACT,CAAC;YACD,KAAK,gBAAgB,CAAC,CAAC,CAAC;gBACtB,MAAM,SAAS,GAAG,MAAM,EAAE,SAA+B,CAAC;gBAC1D,MAAM,IAAI,GAAG,iBAAiB,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;gBAC/C,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;oBACjB,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,mCAAmC,CAAC,CAAC;oBAC5D,OAAO;gBACT,CAAC;gBACD,IAAI,CAAC,SAAS,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBACpF,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,sEAAsE,CAAC,CAAC;oBAC/F,OAAO;gBACT,CAAC;gBACD,MAAM,eAAe,GAAG,mBAAmB,CAAC,MAAM,CAAC,CAAC;gBACpD,IAAI,eAAe,EAAE,CAAC;oBACpB,iEAAiE;oBACjE,qEAAqE;oBACrE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,eAAe,CAAC,OAAO,EAAE,eAAe,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;oBACnH,OAAO;gBACT,CAAC;gBACD,sEAAsE;gBACtE,0EAA0E;gBAC1E,0EAA0E;gBAC1E,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,CAAC;oBACnC,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,WAAW,SAAS,+BAA+B,CAAC,CAAC;oBAC5E,OAAO;gBACT,CAAC;gBACD,MAAM,UAAU,GAAG,IAAI,eAAe,EAAE,CAAC;gBACzC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;gBAC3C,IAAI,CAAC;oBACH,MAAM,KAAK,GAAgB;wBACzB,MAAM,EAAE,UAAU,CAAC,MAAM;wBACzB,OAAO,EAAE,CAAC,KAAU,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,SAAS,EAAE,KAAK,CAAC;wBAC/D,aAAa,EAAE,CAAC,GAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,cAAc,CAAC,SAAS,EAAE,GAAG,CAAC;qBACjE,CAAC;oBACF,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,MAAM,CACnC;wBACE,MAAM,EAAE,IAAI;wBACZ,IAAI,EAAE,MAAM,EAAE,IAAI,IAAI,OAAO;wBAC7B,QAAQ,EAAE,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,SAAS,CAAC;wBACzC,GAAG,CAAC,MAAM,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACrE,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,SAAS;4BACtC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE;4BAC3C,CAAC,CAAC,EAAE,CAAC;wBACP,GAAG,CAAC,MAAM,EAAE,GAAG,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,CAAC,GAAG,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACzD,GAAG,CAAC,MAAM,EAAE,qBAAqB,KAAK,SAAS;4BAC7C,CAAC,CAAC,EAAE,qBAAqB,EAAE,MAAM,CAAC,qBAAqB,EAAE;4BACzD,CAAC,CAAC,EAAE,CAAC;wBACP,GAAG,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC/D,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClE,GAAG,CAAC,MAAM,EAAE,CAAC,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACnD,GAAG,CAAC,MAAM,EAAE,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAChD,GAAG,CAAC,MAAM,EAAE,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC5D,GAAG,CAAC,MAAM,EAAE,KAAK,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClD,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACpD,GAAG,CAAC,MAAM,EAAE,KAAK,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAC/D,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClE,GAAG,CAAC,MAAM,EAAE,MAAM,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBAClE,GAAG,CAAC,MAAM,EAAE,sBAAsB,KAAK,SAAS;4BAC9C,CAAC,CAAC,EAAE,sBAAsB,EAAE,MAAM,CAAC,sBAAsB,EAAE;4BAC3D,CAAC,CAAC,EAAE,CAAC;wBACP,GAAG,CAAC,MAAM,EAAE,aAAa,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,MAAM,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;wBACvF,GAAG,CAAC,MAAM,EAAE,cAAc,KAAK,SAAS;4BACtC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,cAAc,EAAE;4BAC3C,CAAC,CAAC,EAAE,CAAC;wBACP,GAAG,CAAC,MAAM,EAAE,eAAe,KAAK,SAAS;4BACvC,CAAC,CAAC,EAAE,eAAe,EAAE,MAAM,CAAC,eAAe,EAAE;4BAC7C,CAAC,CAAC,EAAE,CAAC;qBACR,EACD,KAAK,CACN,CAAC;oBACF,kEAAkE;oBAClE,uEAAuE;oBACvE,MAAM,OAAO,GAAG,eAAe,CAAC,MAAM,CAAC,CAAC;oBACxC,IAAI,OAAO,EAAE,CAAC;wBACZ,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;4BAC5B,SAAS;4BACT,MAAM,EAAE,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE;yBAC3F,CAAC,CAAC;oBACL,CAAC;oBACD,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,UAAU,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,UAAU,EAAE,CAAC,CAAC;gBACvF,CAAC;gBAAC,OAAO,GAAG,EAAE,CAAC;oBACb,IAAI,UAAU,CAAC,MAAM,CAAC,OAAO,EAAE,CAAC;wBAC9B,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,EAAE,UAAU,EAAE,WAAW,EAAE,CAAC,CAAC;oBAC9C,CAAC;yBAAM,CAAC;wBACN,uEAAuE;wBACvE,8DAA8D;wBAC9D,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;oBAC3E,CAAC;gBACH,CAAC;wBAAS,CAAC;oBACT,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,KAAK,UAAU;wBAAE,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;gBACvF,CAAC;gBACD,OAAO;YACT,CAAC;YACD;gBACE,IAAI,CAAC,KAAK,CAAC,EAAE,EAAE,CAAC,KAAK,EAAE,qBAAqB,MAAM,EAAE,CAAC,CAAC;QAC1D,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,kBAAkB,CAAC,GAAQ;QACjC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC;QAC/B,IAAI,MAAM,KAAK,gBAAgB,EAAE,CAAC;YAChC,MAAM,SAAS,GAAG,MAAM,EAAE,SAA+B,CAAC;YAC1D,MAAM,MAAM,GAAG,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YACtE,IAAI,MAAM;gBAAE,MAAM,CAAC,KAAK,EAAE,CAAC;QAC7B,CAAC;QACD,0EAA0E;IAC5E,CAAC;IAED,sEAAsE;IAC9D,eAAe,CAAC,SAAiB,EAAE,KAAU;QACnD,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,IAAI,IAAI,EAAE,CAAC,CAAC;QACvC,MAAM,CAAC,GAAG,CAAC,KAAK,EAAE,OAAO,IAAI,EAAE,CAAwB,CAAC;QACxD,IAAI,IAAI,KAAK,eAAe,EAAE,CAAC;YAC7B,MAAM,GAAG,GAAG,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC;YACpC,IAAI,GAAG,KAAK,SAAS,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC3E,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;oBAC5B,SAAS;oBACT,MAAM,EAAE,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE;iBAC7F,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,IAAI,GAAG,KAAK,UAAU,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC;gBAC5E,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;oBAC5B,SAAS;oBACT,MAAM,EAAE,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE;iBAC7F,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,IAAI,GAAG,KAAK,WAAW,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACtE,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAwB,CAAC;gBAC9C,MAAM,UAAU,GAAG,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,MAAM,IAAI,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAAC,CAAC;gBAC5F,2EAA2E;gBAC3E,6EAA6E;gBAC7E,mEAAmE;gBACnE,2EAA2E;gBAC3E,4EAA4E;gBAC5E,qEAAqE;gBACrE,IAAI,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,EAAE,CAAC;oBACvC,MAAM,WAAW,GAAG,GAAG,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;oBACjE,MAAM,KAAK,GAAG,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;oBAClD,IAAI,KAAK;wBAAE,KAAK,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC;;wBAC7B,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC;gBACzD,CAAC;gBACD,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;oBAC5B,SAAS;oBACT,MAAM,EAAE;wBACN,aAAa,EAAE,WAAW;wBAC1B,UAAU;wBACV,KAAK,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC;wBACrC,MAAM,EAAE,aAAa;qBACtB;iBACF,CAAC,CAAC;gBACH,OAAO;YACT,CAAC;YACD,IAAI,GAAG,KAAK,aAAa,IAAI,CAAC,CAAC,MAAM,CAAC,IAAI,OAAO,CAAC,CAAC,MAAM,CAAC,KAAK,QAAQ,EAAE,CAAC;gBACxE,MAAM,IAAI,GAAG,CAAC,CAAC,MAAM,CAAwB,CAAC;gBAC9C,0EAA0E;gBAC1E,2EAA2E;gBAC3E,MAAM,QAAQ,GAAG,OAAO,IAAI,CAAC,QAAQ,CAAC,KAAK,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC;gBACtE,MAAM,WAAW,GAAG,GAAG,SAAS,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,EAAE,CAAC,EAAE,CAAC;gBACjE,sEAAsE;gBACtE,0EAA0E;gBAC1E,MAAM,KAAK,GAAG,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC;gBACzE,MAAM,UAAU,GAAG,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC;gBACtE,IAAI,UAAU,EAAE,CAAC;oBACf,8DAA8D;oBAC9D,IAAI,KAAK,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC;wBAAE,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC;oBACxE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;wBAC5B,SAAS;wBACT,MAAM,EAAE;4BACN,aAAa,EAAE,kBAAkB;4BACjC,UAAU;4BACV,MAAM,EAAE,IAAI,CAAC,QAAQ,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;yBAC5D;qBACF,CAAC,CAAC;gBACL,CAAC;gBACD,OAAO;YACT,CAAC;YACD,OAAO;QACT,CAAC;QACD,IAAI,IAAI,KAAK,eAAe,IAAI,IAAI,KAAK,YAAY,IAAI,IAAI,KAAK,aAAa,EAAE,CAAC;YAChF,uEAAuE;YACvE,uBAAuB;YACvB,MAAM,IAAI,GACR,IAAI,KAAK,eAAe;gBACtB,CAAC,CAAC,4BAA4B;gBAC9B,CAAC,CAAC,IAAI,KAAK,YAAY;oBACrB,CAAC,CAAC,qEAAqE;oBACvE,CAAC,CAAC,oGAAoG,CAAC;YAC7G,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;gBAC5B,SAAS;gBACT,MAAM,EAAE,EAAE,aAAa,EAAE,qBAAqB,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,EAAE;aAClF,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED;;;;OAIG;IACK,KAAK,CAAC,cAAc,CAAC,SAAiB,EAAE,GAAQ;QACtD,MAAM,OAAO,GAAG,GAAG,EAAE,OAAO,CAAC;QAC7B,MAAM,SAAS,GAAU,KAAK,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,IAAI,SAAS,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO,IAAI,CAAC;QACxC,MAAM,OAAO,GAAU,EAAE,CAAC;QAC1B,IAAI,gBAAgB,GAAG,KAAK,CAAC;QAC7B,KAAK,MAAM,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,SAAS,CAAC,OAAO,EAAE,EAAE,CAAC;YAC5C,MAAM,OAAO,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,CAAC,CAAM,EAAE,GAAW,EAAE,EAAE,CAAC,CAAC;gBACzF,QAAQ,EAAE,OAAO,GAAG,GAAG,CAAC,EAAE;gBAC1B,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,KAAK,IAAI,UAAU,GAAG,GAAG,CAAC,EAAE,CAAC;gBAC7C,IAAI,EAAE,YAAY;aACnB,CAAC,CAAC,CAAC;YACJ,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;gBACzB,kFAAkF;gBAClF,4EAA4E;gBAC5E,6EAA6E;gBAC7E,6EAA6E;gBAC7E,wCAAwC;gBACxC,gBAAgB,GAAG,IAAI,CAAC;gBACxB,SAAS;YACX,CAAC;YACD,iEAAiE;YACjE,kEAAkE;YAClE,kEAAkE;YAClE,uEAAuE;YACvE,kEAAkE;YAClE,MAAM,UAAU,GAAG,GAAG,MAAM,CAAC,OAAO,EAAE,cAAc,IAAI,aAAa,CAAC,IAAI,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;YAClG,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;gBAC5B,SAAS;gBACT,MAAM,EAAE;oBACN,aAAa,EAAE,WAAW;oBAC1B,UAAU;oBACV,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,IAAI,UAAU,CAAC;oBACxC,IAAI,EAAE,OAAO;oBACb,MAAM,EAAE,SAAS;iBAClB;aACF,CAAC,CAAC;YACH,sEAAsE;YACtE,uEAAuE;YACvE,+DAA+D;YAC/D,MAAM,UAAU,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,OAAO,EAAE,UAAU,IAAI,GAAG,EAAE,SAAS,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAChG,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,OAAO,CACjC,4BAA4B,EAC5B;gBACE,SAAS;gBACT,QAAQ,EAAE,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,EAAE,QAAQ,IAAI,UAAU,CAAC,EAAE;gBAClE,OAAO;aACR,EACD,MAAM,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,OAAO,CACnD,CAAC;YACF,MAAM,QAAQ,GAAG,QAAQ,EAAE,OAAO,EAAE,QAAQ,IAAI,QAAQ,EAAE,QAAQ,CAAC;YACnE,MAAM,MAAM,GAAG,OAAO,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAM,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;YAC5G,qEAAqE;YACrE,uEAAuE;YACvE,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;gBAC5B,SAAS;gBACT,MAAM,EAAE,EAAE,aAAa,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,QAAQ,EAAE;aACnG,CAAC,CAAC;YACH,IAAI,MAAM,EAAE,CAAC;gBACX,OAAO,CAAC,IAAI,CAAC,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,CAAC,EAAE,eAAe,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACtG,CAAC;QACH,CAAC;QACD,IAAI,gBAAgB,EAAE,CAAC;YACrB,IAAI,CAAC,MAAM,CAAC,gBAAgB,EAAE;gBAC5B,SAAS;gBACT,MAAM,EAAE;oBACN,aAAa,EAAE,qBAAqB;oBACpC,OAAO,EAAE;wBACP,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,sGAAsG;qBAC7G;iBACF;aACF,CAAC,CAAC;QACL,CAAC;QACD,4EAA4E;QAC5E,iEAAiE;QACjE,OAAO,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,OAAO,EAAE,cAAc,IAAI,EAAE,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACxG,CAAC;CACF"}

package/dist/prompt.d.ts

@@ -0,0 +1,19 @@
+/**
+ * ACP prompt/result projection helpers — pure functions, no server state.
+ */
+/**
+ * Flatten ACP prompt content blocks into the engine prompt. The declared
+ * `embeddedContext: true` capability is honored here: `resource` blocks
+ * (embedded file text) are inlined as fenced context sections and
+ * `resource_link` blocks surface as references — editor-supplied context is
+ * never silently dropped.
+ */
+export declare function extractPromptText(prompt: unknown): string;
+/**
+ * Reduce a run result to the human-readable text the editor should show. The
+ * orchestrator returns an OrchestratorResult whose `summary` is the primary
+ * output; prefer it over dumping the whole internal object. Falls back to a
+ * compact JSON string only when no summary/text field is present.
+ */
+export declare function summarizeResult(result: unknown): string;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../src/prompt.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;;;;GAMG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CA2BzD;AAED;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,OAAO,GAAG,MAAM,CAWvD"}

package/dist/prompt.js

@@ -0,0 +1,63 @@
+/**
+ * ACP prompt/result projection helpers — pure functions, no server state.
+ */
+/**
+ * Flatten ACP prompt content blocks into the engine prompt. The declared
+ * `embeddedContext: true` capability is honored here: `resource` blocks
+ * (embedded file text) are inlined as fenced context sections and
+ * `resource_link` blocks surface as references — editor-supplied context is
+ * never silently dropped.
+ */
+export function extractPromptText(prompt) {
+    if (typeof prompt === "string")
+        return prompt;
+    const blockText = (p) => {
+        if (typeof p === "string")
+            return p;
+        if (!p || typeof p !== "object")
+            return "";
+        if (typeof p.text === "string" && p.type !== "resource")
+            return p.text;
+        if (p.type === "resource" && p.resource && typeof p.resource === "object") {
+            const res = p.resource;
+            if (typeof res["text"] === "string" && res["text"].trim()) {
+                const uri = typeof res["uri"] === "string" ? res["uri"] : "embedded resource";
+                return `Context from ${uri}:\n\`\`\`\n${res["text"]}\n\`\`\``;
+            }
+            // Binary blobs have no text channel into a CLI prompt — reference only.
+            const uri = typeof res["uri"] === "string" ? res["uri"] : "";
+            return uri ? `Context resource (binary, not inlined): ${uri}` : "";
+        }
+        if (p.type === "resource_link") {
+            const uri = typeof p.uri === "string" ? p.uri : "";
+            const name = typeof p.name === "string" && p.name ? ` (${p.name})` : "";
+            return uri ? `Referenced resource: ${uri}${name}` : "";
+        }
+        return "";
+    };
+    if (Array.isArray(prompt)) {
+        return prompt.map(blockText).filter(Boolean).join("\n\n");
+    }
+    return blockText(prompt);
+}
+/**
+ * Reduce a run result to the human-readable text the editor should show. The
+ * orchestrator returns an OrchestratorResult whose `summary` is the primary
+ * output; prefer it over dumping the whole internal object. Falls back to a
+ * compact JSON string only when no summary/text field is present.
+ */
+export function summarizeResult(result) {
+    if (typeof result === "string")
+        return result.trim();
+    if (result && typeof result === "object") {
+        const r = result;
+        for (const key of ["summary", "answer", "text"]) {
+            const v = r[key];
+            if (typeof v === "string" && v.trim())
+                return v.trim();
+        }
+        return JSON.stringify(result);
+    }
+    return result === undefined || result === null ? "" : String(result);
+}
+//# sourceMappingURL=prompt.js.map

package/dist/prompt.js.map

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

package/dist/validate.d.ts

@@ -0,0 +1,7 @@
+/** Typed validation verdict: message for humans, optional machine code. */
+export interface RunControlError {
+    message: string;
+    code?: string;
+}
+export declare function validateRunControls(params: unknown): RunControlError | null;
+//# sourceMappingURL=validate.d.ts.map

package/dist/validate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.d.ts","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAYA,2EAA2E;AAC3E,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAID,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,OAAO,GAAG,eAAe,GAAG,IAAI,CAoD3E"}

package/dist/validate.js

@@ -0,0 +1,80 @@
+/**
+ * ACP session/prompt run-control validation — ACP-specific rules first
+ * (mode/harness/n/booleans), then the SHARED semantic run-control rules
+ * (one owner in @claudexor/schema). Pure functions, no server state.
+ */
+import { ModeKind, validateOptionalNonEmptyString, validateSurfaceRunControls } from "@claudexor/schema";
+import { assertNoInlineSecretValues, errorCode } from "@claudexor/util";
+function isPlainRecord(value) {
+    return !!value && typeof value === "object" && !Array.isArray(value);
+}
+const msg = (message) => ({ message });
+export function validateRunControls(params) {
+    if (!isPlainRecord(params))
+        return null;
+    const allowedKeys = new Set([
+        "sessionId",
+        "prompt",
+        "mode",
+        "harness",
+        "primaryHarness",
+        "web",
+        "externalContextPolicy",
+        "model",
+        "effort",
+        "n",
+        "race",
+        "untilClean",
+        "swarm",
+        "create",
+        "tests",
+        "maxUsd",
+        "access",
+        "protectedPathApprovals",
+        "reviewerPanel",
+        "reviewerModels",
+        "reviewerEfforts",
+    ]);
+    for (const key of Object.keys(params)) {
+        // `_meta` is the PROTOCOL's forward-compat envelope (other parties'
+        // standard field), not a Claudexor knob — tolerate it, reject the rest.
+        // Unknown CLAUDEXOR fields still fail loudly (typo'd knobs never no-op).
+        if (key === "_meta")
+            continue;
+        if (!allowedKeys.has(key))
+            return msg(`unknown session/prompt field: ${key}`);
+    }
+    if (params.mode !== undefined && (typeof params.mode !== "string" || !ModeKind.safeParse(params.mode).success)) {
+        return msg("mode must be a valid mode");
+    }
+    const harnessError = validateOptionalNonEmptyString(params.harness, "harness");
+    if (harnessError)
+        return msg(harnessError);
+    for (const flag of ["race", "untilClean", "swarm", "create"]) {
+        if (params[flag] !== undefined && typeof params[flag] !== "boolean") {
+            return msg(`${flag} must be a boolean`);
+        }
+    }
+    if (params.n !== undefined) {
+        // A race needs >= 2 candidates; other routes accept any positive width.
+        const min = params.race === true ? 2 : 1;
+        if (!Number.isInteger(params.n) || params.n < min) {
+            return msg(params.race === true ? "race n must be an integer >= 2" : "n must be a positive integer");
+        }
+    }
+    const shared = validateSurfaceRunControls(params);
+    if (shared)
+        return msg(shared);
+    return validateNoInlineSecrets(params, "ACP session/prompt params");
+}
+function validateNoInlineSecrets(value, context) {
+    try {
+        assertNoInlineSecretValues(value, "$", context);
+        return null;
+    }
+    catch (err) {
+        const code = errorCode(err);
+        return { message: err instanceof Error ? err.message : String(err), ...(code ? { code } : {}) };
+    }
+}
+//# sourceMappingURL=validate.js.map

package/dist/validate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate.js","sourceRoot":"","sources":["../src/validate.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,8BAA8B,EAAE,0BAA0B,EAAE,MAAM,mBAAmB,CAAC;AACzG,OAAO,EAAE,0BAA0B,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAExE,SAAS,aAAa,CAAC,KAAc;IACnC,OAAO,CAAC,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;AACvE,CAAC;AAQD,MAAM,GAAG,GAAG,CAAC,OAAe,EAAmB,EAAE,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC;AAEhE,MAAM,UAAU,mBAAmB,CAAC,MAAe;IACjD,IAAI,CAAC,aAAa,CAAC,MAAM,CAAC;QAAE,OAAO,IAAI,CAAC;IACxC,MAAM,WAAW,GAAG,IAAI,GAAG,CAAC;QAC1B,WAAW;QACX,QAAQ;QACR,MAAM;QACN,SAAS;QACT,gBAAgB;QAChB,KAAK;QACL,uBAAuB;QACvB,OAAO;QACP,QAAQ;QACR,GAAG;QACH,MAAM;QACN,YAAY;QACZ,OAAO;QACP,QAAQ;QACR,OAAO;QACP,QAAQ;QACR,QAAQ;QACR,wBAAwB;QACxB,eAAe;QACf,gBAAgB;QAChB,iBAAiB;KAClB,CAAC,CAAC;IACH,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACtC,oEAAoE;QACpE,wEAAwE;QACxE,yEAAyE;QACzE,IAAI,GAAG,KAAK,OAAO;YAAE,SAAS;QAC9B,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,GAAG,CAAC;YAAE,OAAO,GAAG,CAAC,iCAAiC,GAAG,EAAE,CAAC,CAAC;IAChF,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,CAAC,EAAE,CAAC;QAC/G,OAAO,GAAG,CAAC,2BAA2B,CAAC,CAAC;IAC1C,CAAC;IACD,MAAM,YAAY,GAAG,8BAA8B,CAAC,MAAM,CAAC,OAAO,EAAE,SAAS,CAAC,CAAC;IAC/E,IAAI,YAAY;QAAE,OAAO,GAAG,CAAC,YAAY,CAAC,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,QAAQ,CAAU,EAAE,CAAC;QACtE,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,IAAI,OAAO,MAAM,CAAC,IAAI,CAAC,KAAK,SAAS,EAAE,CAAC;YACpE,OAAO,GAAG,CAAC,GAAG,IAAI,oBAAoB,CAAC,CAAC;QAC1C,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,CAAC,KAAK,SAAS,EAAE,CAAC;QAC3B,wEAAwE;QACxE,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,IAAK,MAAM,CAAC,CAAY,GAAG,GAAG,EAAE,CAAC;YAC9D,OAAO,GAAG,CAAC,MAAM,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,gCAAgC,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC;QACvG,CAAC;IACH,CAAC;IACD,MAAM,MAAM,GAAG,0BAA0B,CAAC,MAAM,CAAC,CAAC;IAClD,IAAI,MAAM;QAAE,OAAO,GAAG,CAAC,MAAM,CAAC,CAAC;IAC/B,OAAO,uBAAuB,CAAC,MAAM,EAAE,2BAA2B,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAc,EAAE,OAAe;IAC9D,IAAI,CAAC;QACH,0BAA0B,CAAC,KAAK,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;QAChD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,MAAM,IAAI,GAAG,SAAS,CAAC,GAAG,CAAC,CAAC;QAC5B,OAAO,EAAE,OAAO,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC;IAClG,CAAC;AACH,CAAC"}

package/package.json

@@ -0,0 +1,41 @@
+{
+  "name": "@claudexor/acp-server",
+  "version": "1.0.0",
+  "license": "MIT",
+  "description": "Minimal ACP server (stdio JSON-RPC) exposing Claudexor as a meta-agent to editors. Runner injected.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@claudexor/schema": "1.0.0",
+    "@claudexor/util": "1.0.0"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/razzant/claudexor.git",
+    "directory": "packages/acp-server"
+  },
+  "homepage": "https://github.com/razzant/claudexor#readme",
+  "bugs": {
+    "url": "https://github.com/razzant/claudexor/issues"
+  },
+  "engines": {
+    "node": ">=20.19"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit"
+  }
+}