@xenosystem/acp-core 0.1.1

package/dist/logger.js

@@ -0,0 +1,38 @@
+/**
+ * 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.)
+ */
+const ORDER = {
+    debug: 10,
+    info: 20,
+    warn: 30,
+    error: 40,
+    silent: 99,
+};
+function envLevel() {
+    const v = (process.env.XENO_ACP_LOG ?? "info").toLowerCase();
+    return ["debug", "info", "warn", "error", "silent"].includes(v)
+        ? v
+        : "info";
+}
+function emit(level, threshold, scope, args) {
+    if (ORDER[level] < ORDER[threshold])
+        return;
+    const tag = `[xeno-acp${scope ? ":" + scope : ""}] ${level.toUpperCase()}`;
+    // eslint-disable-next-line no-console
+    console.error(tag, ...args);
+}
+export function createLogger(scope = "", level = envLevel()) {
+    const self = {
+        level,
+        debug: (...a) => emit("debug", self.level, scope, a),
+        info: (...a) => emit("info", self.level, scope, a),
+        warn: (...a) => emit("warn", self.level, scope, a),
+        error: (...a) => emit("error", self.level, scope, a),
+        child: (s) => createLogger(scope ? `${scope}.${s}` : s, self.level),
+    };
+    return self;
+}
+export const log = createLogger();
+//# sourceMappingURL=logger.js.map

package/dist/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../src/logger.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH,MAAM,KAAK,GAA6B;IACtC,KAAK,EAAE,EAAE;IACT,IAAI,EAAE,EAAE;IACR,IAAI,EAAE,EAAE;IACR,KAAK,EAAE,EAAE;IACT,MAAM,EAAE,EAAE;CACX,CAAC;AAEF,SAAS,QAAQ;IACf,MAAM,CAAC,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;IAC7D,OAAQ,CAAC,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,CAAW,CAAC,QAAQ,CAAC,CAAa,CAAC;QACpF,CAAC,CAAE,CAAc;QACjB,CAAC,CAAC,MAAM,CAAC;AACb,CAAC;AAWD,SAAS,IAAI,CAAC,KAAe,EAAE,SAAmB,EAAE,KAAa,EAAE,IAAe;IAChF,IAAI,KAAK,CAAC,KAAK,CAAC,GAAG,KAAK,CAAC,SAAS,CAAC;QAAE,OAAO;IAC5C,MAAM,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,GAAG,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,KAAK,CAAC,WAAW,EAAE,EAAE,CAAC;IAC3E,sCAAsC;IACtC,OAAO,CAAC,KAAK,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,CAAC;AAC9B,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,KAAK,GAAG,EAAE,EAAE,QAAkB,QAAQ,EAAE;IACnE,MAAM,IAAI,GAAW;QACnB,KAAK;QACL,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,IAAI,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QAClD,KAAK,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;QACpD,KAAK,EAAE,CAAC,CAAS,EAAE,EAAE,CAAC,YAAY,CAAC,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,IAAI,CAAC,KAAK,CAAC;KAC5E,CAAC;IACF,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,MAAM,GAAG,GAAG,YAAY,EAAE,CAAC"}

package/dist/manager.d.ts

@@ -0,0 +1,54 @@
+/**
+ * `AcpManager` — the public engine entry point.
+ *
+ * Owns a lazy pool of `AgentProcess` (one per agent id), a per-agent concurrency
+ * semaphore, and the `prompt()` async-iterator that in-process consumers and the HTTP
+ * server both build on. Renders chat messages into an ACP prompt (SPEC §5) and yields the
+ * structured `AcpEvent` stream.
+ */
+import type { ContentBlock } from "@agentclientprotocol/sdk";
+import type { AcpEvent, AgentDef, AgentStatus, ChatMessage, PromptOptions, ResolvedConfig } from "./types.js";
+import { type Logger } from "./logger.js";
+export interface ResolvedModel {
+    id: string;
+    submodel?: string;
+}
+/** Parse an OpenAI `model` value of the form `agentId` or `agentId:submodel`. */
+export declare function resolveModel(model: string): ResolvedModel;
+export declare class AcpManager {
+    private readonly config;
+    private readonly logger;
+    private readonly defs;
+    private readonly processes;
+    private readonly semaphores;
+    constructor(config: ResolvedConfig, logger?: Logger);
+    /** Enabled agent definitions. */
+    listAgents(): AgentDef[];
+    getAgentDef(id: string): AgentDef | undefined;
+    hasAgent(id: string): boolean;
+    /** Status snapshot for every agent that has been touched (plus idle for the rest). */
+    statuses(): AgentStatus[];
+    private process;
+    private semaphore;
+    /**
+     * Drive one prompt turn against `agentId` (or `agentId:submodel`). Returns an async
+     * iterator of structured events ending in `done` (or `error`).
+     */
+    prompt(agentId: string, opts: PromptOptions): AsyncGenerator<AcpEvent>;
+    /** Convenience: run a turn and collect the full assistant text + stop reason. */
+    complete(agentId: string, opts: PromptOptions): Promise<{
+        text: string;
+        stopReason: string;
+        usage?: AcpEvent & {
+            type: "usage";
+        };
+    }>;
+    dispose(): Promise<void>;
+}
+/**
+ * Render chat messages into ACP prompt content (SPEC §5). Version 0.1.0 uses ephemeral sessions,
+ * so the conversation is flattened into the turn: a single text block carrying any system
+ * instructions plus the transcript, with the trailing user message as the active ask.
+ */
+export declare function renderMessages(messages: ChatMessage[]): ContentBlock[];
+//# sourceMappingURL=manager.d.ts.map

package/dist/manager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"manager.d.ts","sourceRoot":"","sources":["../src/manager.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,KAAK,EACV,QAAQ,EACR,QAAQ,EACR,WAAW,EACX,WAAW,EACX,aAAa,EACb,cAAc,EACf,MAAM,YAAY,CAAC;AAEpB,OAAO,EAAgB,KAAK,MAAM,EAAE,MAAM,aAAa,CAAC;AA2BxD,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,iFAAiF;AACjF,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,aAAa,CAIzD;AAED,qBAAa,UAAU;IACrB,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;IACxC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,IAAI,CAA+B;IACpD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAmC;IAC7D,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAgC;gBAE/C,MAAM,EAAE,cAAc,EAAE,MAAM,GAAE,MAAuB;IAMnE,iCAAiC;IACjC,UAAU,IAAI,QAAQ,EAAE;IAIxB,WAAW,CAAC,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,SAAS;IAI7C,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAI7B,sFAAsF;IACtF,QAAQ,IAAI,WAAW,EAAE;IAczB,OAAO,CAAC,OAAO;IAgBf,OAAO,CAAC,SAAS;IAUjB;;;OAGG;IACI,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,GAAG,cAAc,CAAC,QAAQ,CAAC;IAyB7E,iFAAiF;IAC3E,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,aAAa,GAClB,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,QAAQ,GAAG;YAAE,IAAI,EAAE,OAAO,CAAA;SAAE,CAAA;KAAE,CAAC;IAehF,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B;AAED;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,QAAQ,EAAE,WAAW,EAAE,GAAG,YAAY,EAAE,CA6BtE"}

package/dist/manager.js

@@ -0,0 +1,194 @@
+/**
+ * `AcpManager` — the public engine entry point.
+ *
+ * Owns a lazy pool of `AgentProcess` (one per agent id), a per-agent concurrency
+ * semaphore, and the `prompt()` async-iterator that in-process consumers and the HTTP
+ * server both build on. Renders chat messages into an ACP prompt (SPEC §5) and yields the
+ * structured `AcpEvent` stream.
+ */
+import { AgentProcess } from "./agent-process.js";
+import { createLogger } from "./logger.js";
+/** Counting semaphore for bounding concurrent turns per agent. */
+class Semaphore {
+    limit;
+    active = 0;
+    queue = [];
+    constructor(limit) {
+        this.limit = limit;
+    }
+    acquire() {
+        return new Promise((resolve) => {
+            const attempt = () => {
+                if (this.active < this.limit) {
+                    this.active++;
+                    resolve(() => this.release());
+                }
+                else {
+                    this.queue.push(attempt);
+                }
+            };
+            attempt();
+        });
+    }
+    release() {
+        this.active--;
+        const next = this.queue.shift();
+        if (next)
+            next();
+    }
+}
+/** Parse an OpenAI `model` value of the form `agentId` or `agentId:submodel`. */
+export function resolveModel(model) {
+    const idx = model.indexOf(":");
+    if (idx === -1)
+        return { id: model };
+    return { id: model.slice(0, idx), submodel: model.slice(idx + 1) };
+}
+export class AcpManager {
+    config;
+    logger;
+    defs = new Map();
+    processes = new Map();
+    semaphores = new Map();
+    constructor(config, logger = createLogger()) {
+        this.config = config;
+        this.logger = logger;
+        for (const def of config.agents)
+            this.defs.set(def.id, def);
+    }
+    /** Enabled agent definitions. */
+    listAgents() {
+        return [...this.defs.values()];
+    }
+    getAgentDef(id) {
+        return this.defs.get(id);
+    }
+    hasAgent(id) {
+        return this.defs.has(id);
+    }
+    /** Status snapshot for every agent that has been touched (plus idle for the rest). */
+    statuses() {
+        return this.listAgents().map((def) => {
+            const proc = this.processes.get(def.id);
+            return (proc?.status() ?? {
+                id: def.id,
+                name: def.name,
+                state: "idle",
+                activeSessions: 0,
+            });
+        });
+    }
+    process(id) {
+        let proc = this.processes.get(id);
+        if (!proc) {
+            const def = this.defs.get(id);
+            if (!def)
+                throw new Error(`unknown agent: ${id}`);
+            proc = new AgentProcess({
+                def,
+                workspaceRoot: this.config.workspaceRoot,
+                keepWorkspaces: this.config.keepWorkspaces,
+                logger: this.logger,
+            });
+            this.processes.set(id, proc);
+        }
+        return proc;
+    }
+    semaphore(id) {
+        let sem = this.semaphores.get(id);
+        if (!sem) {
+            const def = this.defs.get(id);
+            sem = new Semaphore(def?.maxConcurrentSessions ?? this.config.defaults.maxConcurrentSessions);
+            this.semaphores.set(id, sem);
+        }
+        return sem;
+    }
+    /**
+     * Drive one prompt turn against `agentId` (or `agentId:submodel`). Returns an async
+     * iterator of structured events ending in `done` (or `error`).
+     */
+    async *prompt(agentId, opts) {
+        const { id } = resolveModel(agentId);
+        if (!this.defs.has(id)) {
+            yield { type: "error", message: `unknown agent: ${id}` };
+            return;
+        }
+        const proc = this.process(id);
+        const release = await this.semaphore(id).acquire();
+        try {
+            const session = await proc.createSession(opts.workspace);
+            const prompt = renderMessages(opts.messages);
+            // Drive the turn concurrently; it ends the session, closing the event stream.
+            const turn = proc.runPrompt(session, prompt, opts.signal);
+            for await (const ev of session.events()) {
+                yield ev;
+            }
+            await turn;
+        }
+        catch (err) {
+            yield { type: "error", message: err.message ?? String(err) };
+        }
+        finally {
+            release();
+        }
+    }
+    /** Convenience: run a turn and collect the full assistant text + stop reason. */
+    async complete(agentId, opts) {
+        let text = "";
+        let stopReason = "end_turn";
+        let usage;
+        let errored;
+        for await (const ev of this.prompt(agentId, opts)) {
+            if (ev.type === "text")
+                text += ev.text;
+            else if (ev.type === "usage")
+                usage = ev;
+            else if (ev.type === "done")
+                stopReason = ev.stopReason;
+            else if (ev.type === "error")
+                errored = ev.message;
+        }
+        if (errored && !text)
+            throw new Error(errored);
+        return { text, stopReason, ...(usage ? { usage } : {}) };
+    }
+    async dispose() {
+        await Promise.all([...this.processes.values()].map((p) => p.dispose()));
+        this.processes.clear();
+    }
+}
+/**
+ * Render chat messages into ACP prompt content (SPEC §5). Version 0.1.0 uses ephemeral sessions,
+ * so the conversation is flattened into the turn: a single text block carrying any system
+ * instructions plus the transcript, with the trailing user message as the active ask.
+ */
+export function renderMessages(messages) {
+    const system = messages
+        .filter((m) => m.role === "system")
+        .map((m) => m.content)
+        .join("\n\n")
+        .trim();
+    const convo = messages.filter((m) => m.role !== "system");
+    if (convo.length === 1 && convo[0]?.role === "user") {
+        const only = convo[0].content;
+        const text = system ? `${system}\n\n${only}` : only;
+        return [{ type: "text", text }];
+    }
+    const lines = [];
+    if (system)
+        lines.push(`# Instructions\n${system}`);
+    if (convo.length > 1)
+        lines.push(`# Conversation`);
+    for (const m of convo) {
+        const who = m.role === "user"
+            ? "User"
+            : m.role === "assistant"
+                ? "Assistant"
+                : m.role === "tool"
+                    ? `Tool${m.name ? `(${m.name})` : ""}`
+                    : "Message";
+        lines.push(`\n## ${who}\n${m.content}`);
+    }
+    return [{ type: "text", text: lines.join("\n").trim() }];
+}
+//# sourceMappingURL=manager.js.map

package/dist/manager.js.map

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

package/dist/process-resolver.d.ts

@@ -0,0 +1,50 @@
+/**
+ * Cross-platform command resolution WITHOUT `shell: true`.
+ *
+ * Why: `spawn(cmd, args, { shell: true })` concatenates args into a shell string (Node
+ * DEP0190) and is an injection surface. We never want a shell. But on Windows, Node refuses
+ * to `spawn` a `.cmd`/`.bat` file with `shell:false` (post-CVE-2024-27980), and most native
+ * CLIs installed via npm ARE `.cmd` shims. So:
+ *
+ *   - POSIX            → spawn(command, args) unchanged.
+ *   - Windows .exe/bin → spawn(resolvedPath, args).
+ *   - Windows .cmd/.bat→ spawn(comspec, ["/c", resolvedPath, ...args])  (explicit cmd.exe,
+ *                        still shell:false; our args are passed as argv, never a shell line).
+ *
+ * The `command` is always treated as a SINGLE executable token — it is never split, and a
+ * raw command line containing shell metacharacters is rejected. Callers must keep `args`
+ * separate; `args` are passed literally (no shell), so metacharacters in args are inert.
+ *
+ * `resolveCommand` takes injectable `platform`/`lookup` so it is deterministically testable
+ * on any OS.
+ */
+export interface ResolveOptions {
+    platform?: NodeJS.Platform;
+    /** Returns an absolute resolved path for a bare command, or null if not found. */
+    lookup?: (command: string) => string | null;
+    /** Override for the Windows command interpreter (defaults to %ComSpec% or cmd.exe). */
+    comspec?: string;
+    /** PATH string (defaults to process.env.PATH). */
+    pathEnv?: string;
+    /** PATHEXT string (defaults to process.env.PATHEXT or a sane Windows default). */
+    pathExt?: string;
+}
+export interface ResolvedSpawn {
+    /** Executable to hand to `spawn` (with shell:false). */
+    file: string;
+    /** Arguments to hand to `spawn`. */
+    args: string[];
+    /** Always false — this module exists specifically to avoid a shell. */
+    shell: false;
+    /** True when the target was routed through cmd.exe /c (a Windows .cmd/.bat shim). */
+    viaCmd: boolean;
+}
+/** Throw if `command` looks like a shell command line rather than a single executable. */
+export declare function assertExecutableToken(command: string): void;
+/** Default Windows PATH+PATHEXT search for a bare command name. */
+export declare function windowsLookup(command: string, opts?: ResolveOptions): string | null;
+/**
+ * Resolve a command + args into a `spawn(file, args, { shell:false })` invocation.
+ */
+export declare function resolveCommand(command: string, args: string[], opts?: ResolveOptions): ResolvedSpawn;
+//# sourceMappingURL=process-resolver.d.ts.map

package/dist/process-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"process-resolver.d.ts","sourceRoot":"","sources":["../src/process-resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAQH,MAAM,WAAW,cAAc;IAC7B,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAC;IAC3B,kFAAkF;IAClF,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,MAAM,KAAK,MAAM,GAAG,IAAI,CAAC;IAC5C,uFAAuF;IACvF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kDAAkD;IAClD,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,kFAAkF;IAClF,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,wDAAwD;IACxD,IAAI,EAAE,MAAM,CAAC;IACb,oCAAoC;IACpC,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,uEAAuE;IACvE,KAAK,EAAE,KAAK,CAAC;IACb,qFAAqF;IACrF,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,0FAA0F;AAC1F,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAS3D;AAED,mEAAmE;AACnE,wBAAgB,aAAa,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,GAAE,cAAmB,GAAG,MAAM,GAAG,IAAI,CAmBvF;AAED;;GAEG;AACH,wBAAgB,cAAc,CAC5B,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,MAAM,EAAE,EACd,IAAI,GAAE,cAAmB,GACxB,aAAa,CAqBf"}

package/dist/process-resolver.js

@@ -0,0 +1,78 @@
+/**
+ * Cross-platform command resolution WITHOUT `shell: true`.
+ *
+ * Why: `spawn(cmd, args, { shell: true })` concatenates args into a shell string (Node
+ * DEP0190) and is an injection surface. We never want a shell. But on Windows, Node refuses
+ * to `spawn` a `.cmd`/`.bat` file with `shell:false` (post-CVE-2024-27980), and most native
+ * CLIs installed via npm ARE `.cmd` shims. So:
+ *
+ *   - POSIX            → spawn(command, args) unchanged.
+ *   - Windows .exe/bin → spawn(resolvedPath, args).
+ *   - Windows .cmd/.bat→ spawn(comspec, ["/c", resolvedPath, ...args])  (explicit cmd.exe,
+ *                        still shell:false; our args are passed as argv, never a shell line).
+ *
+ * The `command` is always treated as a SINGLE executable token — it is never split, and a
+ * raw command line containing shell metacharacters is rejected. Callers must keep `args`
+ * separate; `args` are passed literally (no shell), so metacharacters in args are inert.
+ *
+ * `resolveCommand` takes injectable `platform`/`lookup` so it is deterministically testable
+ * on any OS.
+ */
+import { existsSync } from "node:fs";
+import { join, isAbsolute } from "node:path";
+/** Shell metacharacters that must never appear in an executable token. */
+const SHELL_METACHARS = /[&|;<>$`\n\r]/;
+/** Throw if `command` looks like a shell command line rather than a single executable. */
+export function assertExecutableToken(command) {
+    if (!command || !command.trim()) {
+        throw new Error("empty command");
+    }
+    if (SHELL_METACHARS.test(command)) {
+        throw new Error(`refusing to spawn: command contains shell metacharacters (treated as a single executable token): ${JSON.stringify(command)}`);
+    }
+}
+/** Default Windows PATH+PATHEXT search for a bare command name. */
+export function windowsLookup(command, opts = {}) {
+    const pathEnv = opts.pathEnv ?? process.env.PATH ?? "";
+    const pathExt = (opts.pathExt ?? process.env.PATHEXT ?? ".COM;.EXE;.BAT;.CMD").split(";");
+    const dirs = pathEnv.split(";").filter(Boolean);
+    // If it already has an extension or a path separator, only check it directly.
+    const hasExt = /\.[a-z0-9]+$/i.test(command);
+    const candidates = [];
+    for (const dir of dirs) {
+        if (hasExt) {
+            candidates.push(join(dir, command));
+        }
+        else {
+            for (const ext of pathExt)
+                candidates.push(join(dir, command + ext));
+        }
+    }
+    for (const c of candidates) {
+        if (existsSync(c))
+            return c;
+    }
+    return null;
+}
+/**
+ * Resolve a command + args into a `spawn(file, args, { shell:false })` invocation.
+ */
+export function resolveCommand(command, args, opts = {}) {
+    assertExecutableToken(command);
+    const platform = opts.platform ?? process.platform;
+    if (platform !== "win32") {
+        // POSIX: spawn handles PATH lookup and direct paths fine. Command is unchanged.
+        return { file: command, args: [...args], shell: false, viaCmd: false };
+    }
+    // Windows.
+    const hasSep = command.includes("\\") || command.includes("/");
+    const resolved = hasSep || isAbsolute(command)
+        ? command
+        : (opts.lookup ? opts.lookup(command) : windowsLookup(command, opts)) ?? command;
+    if (/\.(cmd|bat)$/i.test(resolved)) {
+        const comspec = opts.comspec ?? process.env.ComSpec ?? "cmd.exe";
+        return { file: comspec, args: ["/c", resolved, ...args], shell: false, viaCmd: true };
+    }
+    return { file: resolved, args: [...args], shell: false, viaCmd: false };
+}
+//# sourceMappingURL=process-resolver.js.map

package/dist/process-resolver.js.map

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

package/dist/registry.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Built-in ACP agent definitions.
+ *
+ * These are merged with the user's config: a config `agents` entry with the same `id`
+ * overrides the matching built-in field-by-field; an entry with a new id adds an agent.
+ * Adding/changing an agent is therefore data, not code (CLAUDE.md rule 6).
+ *
+ * Launch commands reflect the current ecosystem:
+ *  - claude-code / codex: no native ACP — bridged by the official Zed ACP adapters.
+ *  - opencode / gemini / kimi: native ACP (`opencode acp`, `gemini --acp`, `kimi acp`).
+ *  - glm:                 ACP Registry package (`npx -y glm-acp-agent@latest`).
+ *
+ * Each agent authenticates with the operator's OWN provider credentials (SPEC §9).
+ */
+import type { AgentDef } from "./types.js";
+export declare const BUILTIN_AGENTS: Record<string, AgentDef>;
+/** Merge a partial config entry onto a built-in (if one exists for the id). */
+export declare function mergeAgentDef(entry: Partial<AgentDef> & {
+    id: string;
+}): AgentDef;
+//# sourceMappingURL=registry.d.ts.map

package/dist/registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAE3C,eAAO,MAAM,cAAc,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CA6CnD,CAAC;AAEF,+EAA+E;AAC/E,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,CAAC,QAAQ,CAAC,GAAG;IAAE,EAAE,EAAE,MAAM,CAAA;CAAE,GAAG,QAAQ,CAWjF"}

package/dist/registry.js

@@ -0,0 +1,74 @@
+/**
+ * Built-in ACP agent definitions.
+ *
+ * These are merged with the user's config: a config `agents` entry with the same `id`
+ * overrides the matching built-in field-by-field; an entry with a new id adds an agent.
+ * Adding/changing an agent is therefore data, not code (CLAUDE.md rule 6).
+ *
+ * Launch commands reflect the current ecosystem:
+ *  - claude-code / codex: no native ACP — bridged by the official Zed ACP adapters.
+ *  - opencode / gemini / kimi: native ACP (`opencode acp`, `gemini --acp`, `kimi acp`).
+ *  - glm:                 ACP Registry package (`npx -y glm-acp-agent@latest`).
+ *
+ * Each agent authenticates with the operator's OWN provider credentials (SPEC §9).
+ */
+export const BUILTIN_AGENTS = {
+    "claude-code": {
+        id: "claude-code",
+        name: "Claude Code",
+        cmd: "npx",
+        args: ["-y", "@zed-industries/claude-code-acp"],
+        defaultModel: null,
+        // Don't inherit a parent Claude Code session's markers (nested-session guard).
+        unsetEnv: ["CLAUDECODE", "CLAUDE_CODE_ENTRYPOINT", "CLAUDE_CODE_SSE_PORT"],
+    },
+    codex: {
+        id: "codex",
+        name: "Codex CLI",
+        cmd: "npx",
+        args: ["-y", "@zed-industries/codex-acp"],
+        defaultModel: null,
+    },
+    opencode: {
+        id: "opencode",
+        name: "OpenCode",
+        cmd: "opencode",
+        args: ["acp"],
+        defaultModel: null,
+    },
+    gemini: {
+        id: "gemini",
+        name: "Gemini CLI",
+        cmd: "gemini",
+        args: ["--acp"],
+        defaultModel: null,
+    },
+    kimi: {
+        id: "kimi",
+        name: "Kimi CLI",
+        cmd: "kimi",
+        args: ["acp"],
+        defaultModel: null,
+    },
+    glm: {
+        id: "glm",
+        name: "GLM Agent",
+        cmd: "npx",
+        args: ["-y", "glm-acp-agent@latest"],
+        defaultModel: null,
+    },
+};
+/** Merge a partial config entry onto a built-in (if one exists for the id). */
+export function mergeAgentDef(entry) {
+    const base = BUILTIN_AGENTS[entry.id];
+    const merged = { ...(base ?? {}), ...entry };
+    if (!merged.cmd) {
+        throw new Error(`Agent "${entry.id}" has no built-in default and no "cmd" in config — cannot launch it.`);
+    }
+    if (!merged.name)
+        merged.name = entry.id;
+    if (!merged.args)
+        merged.args = [];
+    return merged;
+}
+//# sourceMappingURL=registry.js.map

package/dist/registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry.js","sourceRoot":"","sources":["../src/registry.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAIH,MAAM,CAAC,MAAM,cAAc,GAA6B;IACtD,aAAa,EAAE;QACb,EAAE,EAAE,aAAa;QACjB,IAAI,EAAE,aAAa;QACnB,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,CAAC,IAAI,EAAE,iCAAiC,CAAC;QAC/C,YAAY,EAAE,IAAI;QAClB,+EAA+E;QAC/E,QAAQ,EAAE,CAAC,YAAY,EAAE,wBAAwB,EAAE,sBAAsB,CAAC;KAC3E;IACD,KAAK,EAAE;QACL,EAAE,EAAE,OAAO;QACX,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,CAAC,IAAI,EAAE,2BAA2B,CAAC;QACzC,YAAY,EAAE,IAAI;KACnB;IACD,QAAQ,EAAE;QACR,EAAE,EAAE,UAAU;QACd,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,UAAU;QACf,IAAI,EAAE,CAAC,KAAK,CAAC;QACb,YAAY,EAAE,IAAI;KACnB;IACD,MAAM,EAAE;QACN,EAAE,EAAE,QAAQ;QACZ,IAAI,EAAE,YAAY;QAClB,GAAG,EAAE,QAAQ;QACb,IAAI,EAAE,CAAC,OAAO,CAAC;QACf,YAAY,EAAE,IAAI;KACnB;IACD,IAAI,EAAE;QACJ,EAAE,EAAE,MAAM;QACV,IAAI,EAAE,UAAU;QAChB,GAAG,EAAE,MAAM;QACX,IAAI,EAAE,CAAC,KAAK,CAAC;QACb,YAAY,EAAE,IAAI;KACnB;IACD,GAAG,EAAE;QACH,EAAE,EAAE,KAAK;QACT,IAAI,EAAE,WAAW;QACjB,GAAG,EAAE,KAAK;QACV,IAAI,EAAE,CAAC,IAAI,EAAE,sBAAsB,CAAC;QACpC,YAAY,EAAE,IAAI;KACnB;CACF,CAAC;AAEF,+EAA+E;AAC/E,MAAM,UAAU,aAAa,CAAC,KAAyC;IACrE,MAAM,IAAI,GAAG,cAAc,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IACtC,MAAM,MAAM,GAAG,EAAE,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,EAAE,GAAG,KAAK,EAAc,CAAC;IACzD,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,CAAC;QAChB,MAAM,IAAI,KAAK,CACb,UAAU,KAAK,CAAC,EAAE,sEAAsE,CACzF,CAAC;IACJ,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;IACzC,IAAI,CAAC,MAAM,CAAC,IAAI;QAAE,MAAM,CAAC,IAAI,GAAG,EAAE,CAAC;IACnC,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/session.d.ts

@@ -0,0 +1,34 @@
+/**
+ * A `Session` wraps one ACP session id and an async event queue.
+ *
+ * The per-connection client handler dispatches `session/update` notifications here via
+ * `onUpdate`; the consumer (AcpManager / an embedder) drains `events()` as an async
+ * iterable. The queue closes when the prompt turn ends, so the iterator terminates
+ * naturally after the trailing `done` event.
+ */
+import type { SessionUpdate, StopReason } from "@agentclientprotocol/sdk";
+import type { AcpEvent } from "./types.js";
+import type { Workspace } from "./workspace.js";
+/** Convert a raw ACP session update into zero or more structured `AcpEvent`s. */
+export declare function updateToEvents(update: SessionUpdate): AcpEvent[];
+export declare class Session {
+    readonly id: string;
+    readonly workspace: Workspace;
+    private queue;
+    private ended;
+    private rawUpdateHandler?;
+    constructor(id: string, workspace: Workspace, rawUpdateHandler?: (update: SessionUpdate) => void);
+    /** Feed a raw ACP update (called by the connection's client handler). */
+    onUpdate(update: SessionUpdate): void;
+    /** Temporarily observe raw, SDK-validated ACP updates for an embedding host. */
+    setRawUpdateHandler(handler?: (update: SessionUpdate) => void): void;
+    /** Push a synthesized event (usage, error, etc.). */
+    push(event: AcpEvent): void;
+    /** Emit the terminal `done` event and close the stream. */
+    end(stopReason: StopReason): void;
+    /** Emit an error and close the stream. */
+    fail(message: string): void;
+    /** Async-iterate the event stream until the turn ends. */
+    events(): AsyncIterableIterator<AcpEvent>;
+}
+//# sourceMappingURL=session.d.ts.map

package/dist/session.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session.d.ts","sourceRoot":"","sources":["../src/session.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC1E,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAyChD,iFAAiF;AACjF,wBAAgB,cAAc,CAAC,MAAM,EAAE,aAAa,GAAG,QAAQ,EAAE,CA6ChE;AAED,qBAAa,OAAO;IAClB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,SAAS,EAAE,SAAS,CAAC;IAC9B,OAAO,CAAC,KAAK,CAA8B;IAC3C,OAAO,CAAC,KAAK,CAAS;IACtB,OAAO,CAAC,gBAAgB,CAAC,CAAkC;gBAE/C,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,SAAS,EAAE,gBAAgB,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI;IAMhG,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,aAAa,GAAG,IAAI;IAKrC,gFAAgF;IAChF,mBAAmB,CAAC,OAAO,CAAC,EAAE,CAAC,MAAM,EAAE,aAAa,KAAK,IAAI,GAAG,IAAI;IAIpE,qDAAqD;IACrD,IAAI,CAAC,KAAK,EAAE,QAAQ,GAAG,IAAI;IAI3B,2DAA2D;IAC3D,GAAG,CAAC,UAAU,EAAE,UAAU,GAAG,IAAI;IAOjC,0CAA0C;IAC1C,IAAI,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI;IAO3B,0DAA0D;IAC1D,MAAM,IAAI,qBAAqB,CAAC,QAAQ,CAAC;CAG1C"}