@xenosystem/acp-core 0.1.1

package/dist/capabilities.js

@@ -0,0 +1,202 @@
+/**
+ * The ACP `Client` implementation handed to `ClientSideConnection`.
+ *
+ * This is what the agent calls *back* into: permission decisions, file reads/writes, and
+ * terminal execution. Everything is scoped to the requesting session's sandboxed workspace
+ * (SPEC §8). The handler is per-connection (per AgentProcess); it routes `sessionUpdate`
+ * notifications to the right Session by `sessionId`.
+ */
+import { spawn } from "node:child_process";
+import { readFileSync, writeFileSync, mkdirSync } from "node:fs";
+import { dirname } from "node:path";
+import { resolveCommand } from "./process-resolver.js";
+let terminalSeq = 0;
+export function createClientHandler(ctx) {
+    const terminals = new Map();
+    function pickPermission(req) {
+        const opts = req.options ?? [];
+        const byKind = (k) => opts.find((o) => o.kind === k);
+        if (ctx.permission === "deny") {
+            const reject = byKind("reject_once") ?? byKind("reject_always");
+            if (reject)
+                return { outcome: { outcome: "selected", optionId: reject.optionId } };
+            return { outcome: { outcome: "cancelled" } };
+        }
+        // "auto" (and "prompt" on the headless server) → take the broadest allow available.
+        const allow = byKind("allow_always") ?? byKind("allow_once") ?? opts[0];
+        if (allow)
+            return { outcome: { outcome: "selected", optionId: allow.optionId } };
+        return { outcome: { outcome: "cancelled" } };
+    }
+    return {
+        async requestPermission(params) {
+            if (ctx.requestPermission)
+                return ctx.requestPermission(params);
+            const decision = pickPermission(params);
+            ctx.logger.debug(`permission "${params.toolCall?.title ?? "?"}" → ${JSON.stringify(decision.outcome)}`);
+            return decision;
+        },
+        async sessionUpdate(params) {
+            ctx.dispatch(params);
+        },
+        async readTextFile(params) {
+            if (ctx.allowFileSystem === false || ctx.allowReadFileSystem === false) {
+                ctx.onUnsupportedMethod?.("fs/read_text_file");
+                throw new Error("ACP filesystem capability is disabled by the embedding host");
+            }
+            const ws = ctx.workspaceFor(params.sessionId);
+            if (!ws)
+                throw new Error(`unknown session: ${params.sessionId}`);
+            const path = ws.contain(params.path);
+            let content = readFileSync(path, "utf8");
+            if (params.line != null || params.limit != null) {
+                const lines = content.split("\n");
+                const start = Math.max(0, (params.line ?? 1) - 1);
+                const end = params.limit != null ? start + params.limit : lines.length;
+                content = lines.slice(start, end).join("\n");
+            }
+            return { content };
+        },
+        async writeTextFile(params) {
+            if (ctx.allowFileSystem === false || ctx.allowWriteFileSystem === false) {
+                ctx.onUnsupportedMethod?.("fs/write_text_file");
+                throw new Error("ACP filesystem capability is disabled by the embedding host");
+            }
+            const ws = ctx.workspaceFor(params.sessionId);
+            if (!ws)
+                throw new Error(`unknown session: ${params.sessionId}`);
+            const path = ws.contain(params.path);
+            mkdirSync(dirname(path), { recursive: true });
+            writeFileSync(path, params.content, "utf8");
+            return {};
+        },
+        async createTerminal(params) {
+            if (ctx.allowTerminal === false) {
+                ctx.onUnsupportedMethod?.("terminal/create");
+                throw new Error("ACP terminal capability is disabled by the embedding host");
+            }
+            const ws = ctx.workspaceFor(params.sessionId);
+            if (!ws)
+                throw new Error(`unknown session: ${params.sessionId}`);
+            const cwd = params.cwd ? ws.contain(params.cwd) : ws.dir;
+            const env = { ...process.env };
+            for (const e of params.env ?? [])
+                env[e.name] = e.value;
+            const id = `term-${++terminalSeq}`;
+            const byteLimit = params.outputByteLimit ?? 2_000_000;
+            // Resolve the agent's command WITHOUT a shell (process-resolver.ts). The command is a
+            // single executable token (shell metacharacters in it are rejected); args are passed
+            // literally. An agent that wants shell semantics sends e.g. `bash -lc "<script>"`.
+            const resolved = resolveCommand(params.command, params.args ?? []);
+            const child = spawn(resolved.file, resolved.args, {
+                cwd,
+                env,
+                shell: false,
+                stdio: ["ignore", "pipe", "pipe"],
+            });
+            const rec = {
+                id,
+                child,
+                output: "",
+                truncated: false,
+                byteLimit,
+                exited: undefined,
+            };
+            const append = (chunk) => {
+                if (rec.truncated)
+                    return;
+                rec.output += chunk.toString("utf8");
+                if (Buffer.byteLength(rec.output, "utf8") > rec.byteLimit) {
+                    rec.output = rec.output.slice(0, rec.byteLimit);
+                    rec.truncated = true;
+                }
+            };
+            child.stdout?.on("data", append);
+            child.stderr?.on("data", append);
+            rec.exited = new Promise((res) => {
+                child.on("exit", (code, signal) => {
+                    rec.exit = { exitCode: code, signal: signal ?? null };
+                    if (rec.timeout)
+                        clearTimeout(rec.timeout);
+                    res();
+                });
+                child.on("error", (err) => {
+                    append(Buffer.from(`\n[xeno-acp] terminal error: ${err.message}\n`));
+                    rec.exit = { exitCode: null, signal: null };
+                    if (rec.timeout)
+                        clearTimeout(rec.timeout);
+                    res();
+                });
+            });
+            if (ctx.terminalTimeoutMs > 0) {
+                rec.timeout = setTimeout(() => {
+                    if (!rec.exit) {
+                        append(Buffer.from(`\n[xeno-acp] terminal killed after ${ctx.terminalTimeoutMs}ms\n`));
+                        child.kill("SIGKILL");
+                    }
+                }, ctx.terminalTimeoutMs);
+            }
+            terminals.set(id, rec);
+            return { terminalId: id };
+        },
+        async terminalOutput(params) {
+            if (ctx.allowTerminal === false) {
+                ctx.onUnsupportedMethod?.("terminal/output");
+                throw new Error("ACP terminal capability is disabled by the embedding host");
+            }
+            const rec = terminals.get(params.terminalId);
+            if (!rec)
+                throw new Error(`unknown terminal: ${params.terminalId}`);
+            const exitStatus = rec.exit
+                ? { exitCode: rec.exit.exitCode, signal: rec.exit.signal }
+                : null;
+            return { output: rec.output, truncated: rec.truncated, exitStatus };
+        },
+        async waitForTerminalExit(params) {
+            if (ctx.allowTerminal === false) {
+                ctx.onUnsupportedMethod?.("terminal/wait_for_exit");
+                throw new Error("ACP terminal capability is disabled by the embedding host");
+            }
+            const rec = terminals.get(params.terminalId);
+            if (!rec)
+                throw new Error(`unknown terminal: ${params.terminalId}`);
+            await rec.exited;
+            return { exitCode: rec.exit?.exitCode ?? null, signal: rec.exit?.signal ?? null };
+        },
+        async killTerminal(params) {
+            if (ctx.allowTerminal === false) {
+                ctx.onUnsupportedMethod?.("terminal/kill");
+                throw new Error("ACP terminal capability is disabled by the embedding host");
+            }
+            const rec = terminals.get(params.terminalId);
+            if (rec && !rec.exit)
+                rec.child.kill("SIGKILL");
+        },
+        async releaseTerminal(params) {
+            if (ctx.allowTerminal === false) {
+                ctx.onUnsupportedMethod?.("terminal/release");
+                throw new Error("ACP terminal capability is disabled by the embedding host");
+            }
+            const rec = terminals.get(params.terminalId);
+            if (rec) {
+                if (!rec.exit)
+                    rec.child.kill("SIGKILL");
+                if (rec.timeout)
+                    clearTimeout(rec.timeout);
+                terminals.delete(params.terminalId);
+            }
+        },
+        async extMethod(method, params) {
+            if (ctx.extMethod)
+                return ctx.extMethod(method, params);
+            ctx.onUnsupportedMethod?.(method);
+            throw new Error(`unsupported ACP extension method: ${method}`);
+        },
+        async extNotification(method, params) {
+            if (ctx.extNotification)
+                return ctx.extNotification(method, params);
+            ctx.onUnsupportedMethod?.(method);
+        },
+    };
+}
+//# sourceMappingURL=capabilities.js.map

package/dist/capabilities.js.map

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

package/dist/certification.d.ts

@@ -0,0 +1,3 @@
+/** Harmless bounded prompt used to prove an ACP endpoint can complete one turn. */
+export declare const ACP_ENDPOINT_CERTIFICATION_PROMPT = "Certification check. Do not inspect files, call tools, or perform work. Reply with exactly: XENO_ACP_OK";
+//# sourceMappingURL=certification.d.ts.map

package/dist/certification.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"certification.d.ts","sourceRoot":"","sources":["../src/certification.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,eAAO,MAAM,iCAAiC,4GAA4G,CAAA"}

package/dist/certification.js

@@ -0,0 +1,3 @@
+/** Harmless bounded prompt used to prove an ACP endpoint can complete one turn. */
+export const ACP_ENDPOINT_CERTIFICATION_PROMPT = 'Certification check. Do not inspect files, call tools, or perform work. Reply with exactly: XENO_ACP_OK';
+//# sourceMappingURL=certification.js.map

package/dist/certification.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"certification.js","sourceRoot":"","sources":["../src/certification.ts"],"names":[],"mappings":"AAAA,mFAAmF;AACnF,MAAM,CAAC,MAAM,iCAAiC,GAAG,yGAAyG,CAAA"}

package/dist/config.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Configuration loading, validation, env-expansion and merging with built-in agents.
+ *
+ * Resolution order (first found wins):
+ *   1. explicit `opts.path`
+ *   2. $XENO_ACP_CONFIG
+ *   3. ./xeno-acp.config.jsonc  (then .json)
+ *   4. ~/.xeno/acp/config.jsonc (then .json)
+ * If nothing is found, a sensible default is returned (all built-in agents enabled,
+ * bearer auth with no keys) — useful for embedders that configure in code.
+ */
+import type { ResolvedConfig } from "./types.js";
+export interface LoadConfigOptions {
+    /** Explicit config path. */
+    path?: string;
+    /** Base dir for resolving relative paths (default: process.cwd()). */
+    cwd?: string;
+}
+/** Synchronously load and resolve configuration. */
+export declare function loadConfig(opts?: LoadConfigOptions): ResolvedConfig;
+/** Normalize an already-parsed config object (also the path embedders use directly). */
+export declare function normalizeConfig(raw: Record<string, unknown>, cwd?: string): ResolvedConfig;
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAMH,OAAO,KAAK,EAKV,cAAc,EAEf,MAAM,YAAY,CAAC;AAiBpB,MAAM,WAAW,iBAAiB;IAChC,4BAA4B;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,sEAAsE;IACtE,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AA0CD,oDAAoD;AACpD,wBAAgB,UAAU,CAAC,IAAI,GAAE,iBAAsB,GAAG,cAAc,CAiBvE;AAED,wFAAwF;AACxF,wBAAgB,eAAe,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,GAAG,SAAgB,GAAG,cAAc,CAsDjG"}

package/dist/config.js

@@ -0,0 +1,136 @@
+/**
+ * Configuration loading, validation, env-expansion and merging with built-in agents.
+ *
+ * Resolution order (first found wins):
+ *   1. explicit `opts.path`
+ *   2. $XENO_ACP_CONFIG
+ *   3. ./xeno-acp.config.jsonc  (then .json)
+ *   4. ~/.xeno/acp/config.jsonc (then .json)
+ * If nothing is found, a sensible default is returned (all built-in agents enabled,
+ * bearer auth with no keys) — useful for embedders that configure in code.
+ */
+import { readFileSync, existsSync } from "node:fs";
+import { resolve, isAbsolute, join } from "node:path";
+import { homedir } from "node:os";
+import stripJsonComments from "strip-json-comments";
+import { BUILTIN_AGENTS, mergeAgentDef } from "./registry.js";
+import { log } from "./logger.js";
+const ENGINE_DEFAULTS = {
+    maxConcurrentSessions: 4,
+    permission: "auto",
+    terminalTimeoutMs: 120_000,
+    initTimeoutMs: 60_000,
+};
+const SERVER_DEFAULTS = {
+    host: "127.0.0.1",
+    port: 8787,
+    auth: "bearer",
+};
+function candidatePaths(cwd) {
+    const out = [];
+    if (process.env.XENO_ACP_CONFIG)
+        out.push(process.env.XENO_ACP_CONFIG);
+    out.push(join(cwd, "xeno-acp.config.jsonc"));
+    out.push(join(cwd, "xeno-acp.config.json"));
+    out.push(join(homedir(), ".xeno", "acp", "config.jsonc"));
+    out.push(join(homedir(), ".xeno", "acp", "config.json"));
+    return out;
+}
+/** Recursively expand `${VAR}` references inside string values. */
+function expandEnv(value) {
+    if (typeof value === "string") {
+        return value.replace(/\$\{([A-Z0-9_]+)\}/gi, (_m, name) => process.env[name] ?? "");
+    }
+    if (Array.isArray(value))
+        return value.map((v) => expandEnv(v));
+    if (value && typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value))
+            out[k] = expandEnv(v);
+        return out;
+    }
+    return value;
+}
+function parseJsonc(text, source) {
+    try {
+        const parsed = JSON.parse(stripJsonComments(text, { trailingCommas: true }));
+        if (!parsed || typeof parsed !== "object" || Array.isArray(parsed)) {
+            throw new Error("config root must be a JSON object");
+        }
+        return parsed;
+    }
+    catch (err) {
+        throw new Error(`Failed to parse config at ${source}: ${err.message}`);
+    }
+}
+function asPolicy(v, fallback) {
+    return v === "auto" || v === "deny" || v === "prompt" ? v : fallback;
+}
+/** Synchronously load and resolve configuration. */
+export function loadConfig(opts = {}) {
+    const cwd = opts.cwd ?? process.cwd();
+    let raw = {};
+    let foundPath;
+    const search = opts.path ? [opts.path] : candidatePaths(cwd);
+    for (const p of search) {
+        if (existsSync(p)) {
+            foundPath = p;
+            raw = expandEnv(parseJsonc(readFileSync(p, "utf8"), p));
+            break;
+        }
+    }
+    if (foundPath)
+        log.info(`loaded config from ${foundPath}`);
+    else
+        log.info("no config file found — using built-in defaults (all agents enabled)");
+    return normalizeConfig(raw, cwd);
+}
+/** Normalize an already-parsed config object (also the path embedders use directly). */
+export function normalizeConfig(raw, cwd = process.cwd()) {
+    const server = {
+        ...SERVER_DEFAULTS,
+        ...raw.server,
+    };
+    const defaults = {
+        ...ENGINE_DEFAULTS,
+        ...raw.defaults,
+    };
+    defaults.permission = asPolicy(raw.defaults?.permission, ENGINE_DEFAULTS.permission);
+    const wsRaw = raw.workspaceRoot ?? "./.xeno-acp/workspaces";
+    const workspaceRoot = isAbsolute(wsRaw) ? wsRaw : resolve(cwd, wsRaw);
+    // Agents: if `agents` is provided, use exactly those (merged onto built-ins).
+    // Otherwise enable all built-ins.
+    let agents;
+    const agentsRaw = raw.agents;
+    if (Array.isArray(agentsRaw)) {
+        agents = agentsRaw.map((entry) => mergeAgentDef(entry));
+    }
+    else {
+        agents = Object.values(BUILTIN_AGENTS).map((a) => ({ ...a }));
+    }
+    // Fold defaults into each agent so the supervisor reads one resolved object.
+    for (const a of agents) {
+        a.maxConcurrentSessions ??= defaults.maxConcurrentSessions;
+        a.permission ??= defaults.permission;
+        a.terminalTimeoutMs ??= defaults.terminalTimeoutMs;
+        a.initTimeoutMs ??= defaults.initTimeoutMs;
+    }
+    const keysRaw = raw.keys ?? [];
+    const keys = keysRaw.map((k) => ({
+        key: k.key,
+        app: k.app ?? "unknown",
+        agents: Array.isArray(k.agents) && k.agents.length ? k.agents : ["*"],
+        ...(k.maxConcurrentSessions !== undefined
+            ? { maxConcurrentSessions: k.maxConcurrentSessions }
+            : {}),
+    }));
+    return {
+        server,
+        workspaceRoot,
+        keepWorkspaces: Boolean(raw.keepWorkspaces),
+        defaults,
+        agents,
+        keys,
+    };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

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

package/dist/flatten.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Flatten the structured `AcpEvent` stream into linear text deltas + a final summary
+ * (SPEC §7). This is the projection the HTTP server uses to look like OpenAI; embedders
+ * that want full fidelity consume `AcpEvent`s directly instead.
+ *
+ * Flattening never disables tools — the agent still runs everything. `verbose` only
+ * controls how much of the tool/plan/thought activity is narrated back into the text.
+ */
+import type { AcpEvent, StopReason } from "./types.js";
+export interface FlattenOptions {
+    /** Narrate tool_call / tool_update / plan / thought into the text stream. */
+    verbose?: boolean;
+}
+export interface FlatUsage {
+    prompt?: number;
+    completion?: number;
+    total?: number;
+}
+export type FlatChunk = {
+    type: "delta";
+    text: string;
+} | {
+    type: "final";
+    finishReason: string;
+    usage?: FlatUsage;
+    error?: string;
+};
+/** Map an ACP stop reason to an OpenAI `finish_reason`. */
+export declare function stopReasonToFinish(reason: StopReason | string): string;
+export declare function flatten(events: AsyncIterable<AcpEvent>, opts?: FlattenOptions): AsyncGenerator<FlatChunk>;
+//# sourceMappingURL=flatten.d.ts.map

package/dist/flatten.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.d.ts","sourceRoot":"","sources":["../src/flatten.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC;AAEvD,MAAM,WAAW,cAAc;IAC7B,6EAA6E;IAC7E,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,MAAM,WAAW,SAAS;IACxB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAED,MAAM,MAAM,SAAS,GACjB;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAC/B;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,YAAY,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,SAAS,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC;AAE/E,2DAA2D;AAC3D,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,UAAU,GAAG,MAAM,GAAG,MAAM,CAYtE;AAED,wBAAuB,OAAO,CAC5B,MAAM,EAAE,aAAa,CAAC,QAAQ,CAAC,EAC/B,IAAI,GAAE,cAAmB,GACxB,cAAc,CAAC,SAAS,CAAC,CAyD3B"}

package/dist/flatten.js

@@ -0,0 +1,82 @@
+/**
+ * Flatten the structured `AcpEvent` stream into linear text deltas + a final summary
+ * (SPEC §7). This is the projection the HTTP server uses to look like OpenAI; embedders
+ * that want full fidelity consume `AcpEvent`s directly instead.
+ *
+ * Flattening never disables tools — the agent still runs everything. `verbose` only
+ * controls how much of the tool/plan/thought activity is narrated back into the text.
+ */
+/** Map an ACP stop reason to an OpenAI `finish_reason`. */
+export function stopReasonToFinish(reason) {
+    switch (reason) {
+        case "max_tokens":
+            return "length";
+        case "refusal":
+            return "content_filter";
+        case "end_turn":
+        case "max_turn_requests":
+        case "cancelled":
+        default:
+            return "stop";
+    }
+}
+export async function* flatten(events, opts = {}) {
+    const verbose = Boolean(opts.verbose);
+    let usage;
+    let finishReason = "stop";
+    let error;
+    for await (const ev of events) {
+        switch (ev.type) {
+            case "text":
+                if (ev.text)
+                    yield { type: "delta", text: ev.text };
+                break;
+            case "thought":
+                if (verbose && ev.text)
+                    yield { type: "delta", text: `\n> 💭 ${ev.text}\n` };
+                break;
+            case "tool_call":
+                if (verbose)
+                    yield { type: "delta", text: `\n🔧 ${ev.title} (${ev.status})\n` };
+                break;
+            case "tool_update":
+                if (verbose && ev.status)
+                    yield { type: "delta", text: `\n   ↳ ${ev.title ?? ev.id}: ${ev.status}\n` };
+                break;
+            case "plan":
+                if (verbose && ev.entries.length) {
+                    const list = ev.entries
+                        .map((e) => `   - [${e.status === "completed" ? "x" : " "}] ${e.content}`)
+                        .join("\n");
+                    yield { type: "delta", text: `\n📋 Plan:\n${list}\n` };
+                }
+                break;
+            case "usage":
+                usage = {
+                    ...(ev.inputTokens != null ? { prompt: ev.inputTokens } : {}),
+                    ...(ev.outputTokens != null ? { completion: ev.outputTokens } : {}),
+                    ...(ev.totalTokens != null ? { total: ev.totalTokens } : {}),
+                };
+                break;
+            case "done":
+                finishReason = stopReasonToFinish(ev.stopReason);
+                break;
+            case "error":
+                error = ev.message;
+                finishReason = "stop";
+                // Surface the error to the consumer as visible text too.
+                yield { type: "delta", text: `\n[xeno-acp error] ${ev.message}\n` };
+                break;
+            case "raw":
+            default:
+                break;
+        }
+    }
+    yield {
+        type: "final",
+        finishReason,
+        ...(usage ? { usage } : {}),
+        ...(error ? { error } : {}),
+    };
+}
+//# sourceMappingURL=flatten.js.map

package/dist/flatten.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"flatten.js","sourceRoot":"","sources":["../src/flatten.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAmBH,2DAA2D;AAC3D,MAAM,UAAU,kBAAkB,CAAC,MAA2B;IAC5D,QAAQ,MAAM,EAAE,CAAC;QACf,KAAK,YAAY;YACf,OAAO,QAAQ,CAAC;QAClB,KAAK,SAAS;YACZ,OAAO,gBAAgB,CAAC;QAC1B,KAAK,UAAU,CAAC;QAChB,KAAK,mBAAmB,CAAC;QACzB,KAAK,WAAW,CAAC;QACjB;YACE,OAAO,MAAM,CAAC;IAClB,CAAC;AACH,CAAC;AAED,MAAM,CAAC,KAAK,SAAS,CAAC,CAAC,OAAO,CAC5B,MAA+B,EAC/B,OAAuB,EAAE;IAEzB,MAAM,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,IAAI,KAA4B,CAAC;IACjC,IAAI,YAAY,GAAG,MAAM,CAAC;IAC1B,IAAI,KAAyB,CAAC;IAE9B,IAAI,KAAK,EAAE,MAAM,EAAE,IAAI,MAAM,EAAE,CAAC;QAC9B,QAAQ,EAAE,CAAC,IAAI,EAAE,CAAC;YAChB,KAAK,MAAM;gBACT,IAAI,EAAE,CAAC,IAAI;oBAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC,IAAI,EAAE,CAAC;gBACpD,MAAM;YACR,KAAK,SAAS;gBACZ,IAAI,OAAO,IAAI,EAAE,CAAC,IAAI;oBAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,IAAI,IAAI,EAAE,CAAC;gBAC7E,MAAM;YACR,KAAK,WAAW;gBACd,IAAI,OAAO;oBAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,KAAK,KAAK,EAAE,CAAC,MAAM,KAAK,EAAE,CAAC;gBAChF,MAAM;YACR,KAAK,aAAa;gBAChB,IAAI,OAAO,IAAI,EAAE,CAAC,MAAM;oBACtB,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC,KAAK,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,MAAM,IAAI,EAAE,CAAC;gBAC/E,MAAM;YACR,KAAK,MAAM;gBACT,IAAI,OAAO,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,CAAC;oBACjC,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO;yBACpB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,CAAC,MAAM,KAAK,WAAW,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,CAAC,OAAO,EAAE,CAAC;yBACzE,IAAI,CAAC,IAAI,CAAC,CAAC;oBACd,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,IAAI,IAAI,EAAE,CAAC;gBACzD,CAAC;gBACD,MAAM;YACR,KAAK,OAAO;gBACV,KAAK,GAAG;oBACN,GAAG,CAAC,EAAE,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAC7D,GAAG,CAAC,EAAE,CAAC,YAAY,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,EAAE,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACnE,GAAG,CAAC,EAAE,CAAC,WAAW,IAAI,IAAI,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,EAAE,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBAC7D,CAAC;gBACF,MAAM;YACR,KAAK,MAAM;gBACT,YAAY,GAAG,kBAAkB,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC;gBACjD,MAAM;YACR,KAAK,OAAO;gBACV,KAAK,GAAG,EAAE,CAAC,OAAO,CAAC;gBACnB,YAAY,GAAG,MAAM,CAAC;gBACtB,yDAAyD;gBACzD,MAAM,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,sBAAsB,EAAE,CAAC,OAAO,IAAI,EAAE,CAAC;gBACpE,MAAM;YACR,KAAK,KAAK,CAAC;YACX;gBACE,MAAM;QACV,CAAC;IACH,CAAC;IAED,MAAM;QACJ,IAAI,EAAE,OAAO;QACb,YAAY;QACZ,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC5B,CAAC;AACJ,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,33 @@
+/**
+ * @xenosystem/acp-core — embeddable ACP-client engine.
+ *
+ * Drive a configured ACP agent in-process and consume a structured event stream.
+ * Framework-free: no HTTP, no OpenAI types. The HTTP gateway
+ * (@xenosystem/acp) and any other front-end build on this.
+ *
+ * @example
+ * ```ts
+ * import { AcpManager, loadConfig } from "@xenosystem/acp-core";
+ * const acp = new AcpManager(loadConfig());
+ * for await (const ev of acp.prompt("claude-code", {
+ *   messages: [{ role: "user", content: "Summarize the workspace." }],
+ * })) {
+ *   if (ev.type === "text") process.stdout.write(ev.text);
+ * }
+ * await acp.dispose();
+ * ```
+ */
+export * from "./types.js";
+export { AcpManager, resolveModel, renderMessages, type ResolvedModel } from "./manager.js";
+export { loadConfig, normalizeConfig, type LoadConfigOptions } from "./config.js";
+export { BUILTIN_AGENTS, mergeAgentDef } from "./registry.js";
+export { AGENT_VERSION_POLICIES, checkAgentVersionReadiness, compareCliVersions, parseCliVersion, type VersionCommandRunner, } from "./agent-version-policy.js";
+export { flatten, stopReasonToFinish, type FlatChunk, type FlattenOptions, type FlatUsage } from "./flatten.js";
+export { Session, updateToEvents } from "./session.js";
+export { AgentProcess, type AgentProcessOptions, type AgentSessionOptions, type AgentPromptOptions, type AgentProcessDiagnostics, } from "./agent-process.js";
+export { createWorkspace, containPath, type Workspace } from "./workspace.js";
+export { createClientHandler, type ClientContext } from "./capabilities.js";
+export { resolveCommand, assertExecutableToken, windowsLookup, type ResolveOptions, type ResolvedSpawn, } from "./process-resolver.js";
+export { createLogger, log, type Logger, type LogLevel } from "./logger.js";
+export { ACP_ENDPOINT_CERTIFICATION_PROMPT } from "./certification.js";
+//# 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":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAE,KAAK,aAAa,EAAE,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,eAAe,EAAE,KAAK,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,EACf,KAAK,oBAAoB,GAC1B,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,KAAK,SAAS,EAAE,KAAK,cAAc,EAAE,KAAK,SAAS,EAAE,MAAM,cAAc,CAAC;AAChH,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EACL,YAAY,EACZ,KAAK,mBAAmB,EACxB,KAAK,mBAAmB,EACxB,KAAK,kBAAkB,EACvB,KAAK,uBAAuB,GAC7B,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAE,KAAK,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAE,KAAK,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,aAAa,EACb,KAAK,cAAc,EACnB,KAAK,aAAa,GACnB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,GAAG,EAAE,KAAK,MAAM,EAAE,KAAK,QAAQ,EAAE,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/index.js

@@ -0,0 +1,33 @@
+/**
+ * @xenosystem/acp-core — embeddable ACP-client engine.
+ *
+ * Drive a configured ACP agent in-process and consume a structured event stream.
+ * Framework-free: no HTTP, no OpenAI types. The HTTP gateway
+ * (@xenosystem/acp) and any other front-end build on this.
+ *
+ * @example
+ * ```ts
+ * import { AcpManager, loadConfig } from "@xenosystem/acp-core";
+ * const acp = new AcpManager(loadConfig());
+ * for await (const ev of acp.prompt("claude-code", {
+ *   messages: [{ role: "user", content: "Summarize the workspace." }],
+ * })) {
+ *   if (ev.type === "text") process.stdout.write(ev.text);
+ * }
+ * await acp.dispose();
+ * ```
+ */
+export * from "./types.js";
+export { AcpManager, resolveModel, renderMessages } from "./manager.js";
+export { loadConfig, normalizeConfig } from "./config.js";
+export { BUILTIN_AGENTS, mergeAgentDef } from "./registry.js";
+export { AGENT_VERSION_POLICIES, checkAgentVersionReadiness, compareCliVersions, parseCliVersion, } from "./agent-version-policy.js";
+export { flatten, stopReasonToFinish } from "./flatten.js";
+export { Session, updateToEvents } from "./session.js";
+export { AgentProcess, } from "./agent-process.js";
+export { createWorkspace, containPath } from "./workspace.js";
+export { createClientHandler } from "./capabilities.js";
+export { resolveCommand, assertExecutableToken, windowsLookup, } from "./process-resolver.js";
+export { createLogger, log } from "./logger.js";
+export { ACP_ENDPOINT_CERTIFICATION_PROMPT } from "./certification.js";
+//# 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;;;;;;;;;;;;;;;;;;GAkBG;AAEH,cAAc,YAAY,CAAC;AAC3B,OAAO,EAAE,UAAU,EAAE,YAAY,EAAE,cAAc,EAAsB,MAAM,cAAc,CAAC;AAC5F,OAAO,EAAE,UAAU,EAAE,eAAe,EAA0B,MAAM,aAAa,CAAC;AAClF,OAAO,EAAE,cAAc,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9D,OAAO,EACL,sBAAsB,EACtB,0BAA0B,EAC1B,kBAAkB,EAClB,eAAe,GAEhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAuD,MAAM,cAAc,CAAC;AAChH,OAAO,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AACvD,OAAO,EACL,YAAY,GAKb,MAAM,oBAAoB,CAAC;AAC5B,OAAO,EAAE,eAAe,EAAE,WAAW,EAAkB,MAAM,gBAAgB,CAAC;AAC9E,OAAO,EAAE,mBAAmB,EAAsB,MAAM,mBAAmB,CAAC;AAC5E,OAAO,EACL,cAAc,EACd,qBAAqB,EACrB,aAAa,GAGd,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,YAAY,EAAE,GAAG,EAA8B,MAAM,aAAa,CAAC;AAC5E,OAAO,EAAE,iCAAiC,EAAE,MAAM,oBAAoB,CAAC"}

package/dist/logger.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Tiny leveled logger. Writes to **stderr only** — stdout is reserved for the NDJSON
+ * channel shared with agent subprocesses, so writing logs there would corrupt the
+ * protocol stream. (See CLAUDE.md rule 2.)
+ */
+export type LogLevel = "debug" | "info" | "warn" | "error" | "silent";
+export interface Logger {
+    level: LogLevel;
+    debug(...args: unknown[]): void;
+    info(...args: unknown[]): void;
+    warn(...args: unknown[]): void;
+    error(...args: unknown[]): void;
+    child(scope: string): Logger;
+}
+export declare function createLogger(scope?: string, level?: LogLevel): Logger;
+export declare const log: Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,MAAM,MAAM,QAAQ,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;AAiBtE,MAAM,WAAW,MAAM;IACrB,KAAK,EAAE,QAAQ,CAAC;IAChB,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,IAAI,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAC/B,KAAK,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC;IAChC,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAAC;CAC9B;AASD,wBAAgB,YAAY,CAAC,KAAK,SAAK,EAAE,KAAK,GAAE,QAAqB,GAAG,MAAM,CAU7E;AAED,eAAO,MAAM,GAAG,QAAiB,CAAC"}