@xenosystem/acp-core 0.1.1

package/dist/agent-process.js

@@ -0,0 +1,391 @@
+/**
+ * `AgentProcess` supervises one long-lived ACP agent subprocess.
+ *
+ * This is the low-level embedding boundary used by `AcpManager` and desktop hosts such as
+ * XENO Hub. The official ACP SDK owns JSON-RPC framing and validation; embedders provide
+ * permission and extension handlers without reimplementing the protocol.
+ */
+import { spawn } from "node:child_process";
+import { Readable, Writable } from "node:stream";
+import * as acp from "@agentclientprotocol/sdk";
+import { Session } from "./session.js";
+import { createClientHandler } from "./capabilities.js";
+import { createWorkspace } from "./workspace.js";
+import { resolveCommand } from "./process-resolver.js";
+import { checkAgentVersionReadiness } from "./agent-version-policy.js";
+export class AgentProcess {
+    def;
+    workspaceRoot;
+    keepWorkspaces;
+    logger;
+    options;
+    child;
+    conn;
+    sessions = new Map();
+    state = "idle";
+    lastError;
+    startPromise;
+    initialization;
+    stderrTail = [];
+    malformedMessageCount = 0;
+    unsupportedMethodCount = 0;
+    stdoutBuffer = "";
+    exitCode;
+    exitSignal;
+    constructor(opts) {
+        this.options = opts;
+        this.def = opts.def;
+        this.workspaceRoot = opts.workspaceRoot;
+        this.keepWorkspaces = opts.keepWorkspaces;
+        this.logger = opts.logger.child(opts.def.id);
+    }
+    status() {
+        return {
+            id: this.def.id,
+            name: this.def.name,
+            state: this.state,
+            activeSessions: this.sessions.size,
+            ...(this.child?.pid != null ? { pid: this.child.pid } : {}),
+            ...(this.lastError ? { lastError: this.lastError } : {}),
+        };
+    }
+    diagnostics() {
+        return {
+            ...(this.initialization ? { initialization: this.initialization } : {}),
+            stderrTail: [...this.stderrTail],
+            malformedMessageCount: this.malformedMessageCount,
+            unsupportedMethodCount: this.unsupportedMethodCount,
+            ...(this.exitCode !== undefined ? { exitCode: this.exitCode } : {}),
+            ...(this.exitSignal !== undefined ? { signal: this.exitSignal } : {}),
+        };
+    }
+    /** Spawn + initialize on first use; idempotent and safe to call concurrently. */
+    async ensureReady() {
+        if (this.state === "ready")
+            return;
+        if (this.startPromise)
+            return this.startPromise;
+        this.startPromise = this.start().finally(() => {
+            this.startPromise = undefined;
+        });
+        return this.startPromise;
+    }
+    async start() {
+        this.state = "starting";
+        this.lastError = undefined;
+        if (!this.options.skipVersionCheck) {
+            const version = checkAgentVersionReadiness(this.def);
+            if (!version.ok) {
+                this.state = "error";
+                this.lastError = version.message;
+                throw new Error(`${version.message}${version.updateHint ? ` (${version.updateHint})` : ""}`);
+            }
+        }
+        const resolved = resolveCommand(this.def.cmd, this.def.args);
+        this.logger.info(`spawning: ${resolved.file} ${resolved.args.join(" ")}` +
+            (resolved.viaCmd ? "  (via cmd.exe /c, shell:false)" : ""));
+        const inheritedEnv = this.options.inheritEnv === false
+            ? {}
+            : this.options.inheritedEnvKeys
+                ? Object.fromEntries(this.options.inheritedEnvKeys.map((key) => [key, process.env[key]]))
+                : process.env;
+        const env = {
+            ...inheritedEnv,
+            ...(this.def.env ?? {}),
+        };
+        for (const key of this.def.unsetEnv ?? [])
+            delete env[key];
+        const child = spawn(resolved.file, resolved.args, {
+            stdio: ["pipe", "pipe", "pipe"],
+            shell: false,
+            env,
+            ...(this.def.cwd ? { cwd: this.def.cwd } : {}),
+        });
+        this.child = child;
+        this.exitCode = undefined;
+        this.exitSignal = undefined;
+        child.on("exit", (code, signal) => {
+            this.exitCode = code;
+            this.exitSignal = signal;
+            this.logger.warn(`process exited (code=${code} signal=${signal})`);
+            this.handleExit(`agent process exited (code=${code}, signal=${signal})`);
+        });
+        child.on("error", (err) => {
+            this.logger.error(`process error: ${err.message}`);
+            this.lastError = err.message;
+            this.handleExit(`agent process error: ${err.message}`);
+        });
+        if (!child.stdin || !child.stdout || !child.stderr) {
+            throw new Error("failed to open agent stdio pipes");
+        }
+        child.stderr.setEncoding("utf8");
+        child.stderr.on("data", (chunk) => {
+            const text = String(chunk);
+            this.options.onStderr?.(text);
+            for (const line of text.split(/\r?\n/)) {
+                if (!line)
+                    continue;
+                this.stderrTail.push(line.slice(0, 1000));
+                if (this.stderrTail.length > 50)
+                    this.stderrTail.shift();
+            }
+        });
+        // Observe framing only for counters. The official SDK remains the sole JSON-RPC parser.
+        child.stdout.on("data", (chunk) => this.observeStdout(String(chunk)));
+        const writable = Writable.toWeb(child.stdin);
+        const readable = Readable.toWeb(child.stdout);
+        const stream = acp.ndJsonStream(writable, readable);
+        const advertisedCapabilities = this.options.clientCapabilities;
+        const handler = createClientHandler({
+            dispatch: (n) => this.sessions.get(n.sessionId)?.onUpdate(n.update),
+            workspaceFor: (sid) => this.sessions.get(sid)?.workspace,
+            permission: this.def.permission ?? "auto",
+            terminalTimeoutMs: this.def.terminalTimeoutMs ?? 120_000,
+            logger: this.logger,
+            requestPermission: this.options.requestPermission,
+            extMethod: this.options.extMethod,
+            extNotification: this.options.extNotification,
+            onUnsupportedMethod: () => {
+                this.unsupportedMethodCount += 1;
+            },
+            allowReadFileSystem: advertisedCapabilities
+                ? advertisedCapabilities.fs?.readTextFile === true
+                : true,
+            allowWriteFileSystem: advertisedCapabilities
+                ? advertisedCapabilities.fs?.writeTextFile === true
+                : true,
+            allowTerminal: advertisedCapabilities ? advertisedCapabilities.terminal === true : true,
+        });
+        this.conn = new acp.ClientSideConnection(() => handler, stream);
+        const initTimeout = this.def.initTimeoutMs ?? 60_000;
+        try {
+            this.initialization = await withTimeout(this.conn.initialize({
+                protocolVersion: acp.PROTOCOL_VERSION,
+                clientCapabilities: this.options.clientCapabilities ?? {
+                    fs: { readTextFile: true, writeTextFile: true },
+                    terminal: true,
+                },
+                ...(this.options.clientInfo ? { clientInfo: this.options.clientInfo } : {}),
+            }), initTimeout, `initialize timed out after ${initTimeout}ms`);
+            if (this.initialization.protocolVersion !== acp.PROTOCOL_VERSION) {
+                throw new Error(`unsupported ACP protocol version: ${this.initialization.protocolVersion}`);
+            }
+            this.state = "ready";
+            this.logger.info("ready");
+        }
+        catch (err) {
+            this.lastError = err.message;
+            this.state = "error";
+            this.logger.error(`initialize failed: ${this.lastError}`);
+            try {
+                child.kill();
+            }
+            catch {
+                /* ignore */
+            }
+            throw err;
+        }
+    }
+    handleExit(reason) {
+        this.lastError = reason;
+        this.state = "stopped";
+        for (const session of this.sessions.values())
+            session.fail(reason);
+        this.sessions.clear();
+        this.conn = undefined;
+        this.child = undefined;
+    }
+    /** Create a fresh ACP session. Operator-supplied workspaces are never deleted by core. */
+    async createSession(overrideOrOptions) {
+        await this.ensureReady();
+        if (!this.conn)
+            throw new Error(`agent ${this.def.id} is not ready`);
+        const options = typeof overrideOrOptions === "string"
+            ? { workspace: overrideOrOptions }
+            : (overrideOrOptions ?? {});
+        const workspace = createWorkspace(this.workspaceRoot, this.def.id, `s-${Date.now().toString(36)}-${Math.floor(performance.now())}`, {
+            keep: this.keepWorkspaces,
+            ...(options.workspace ? { override: options.workspace } : {}),
+        });
+        let response;
+        try {
+            response = await this.conn.newSession({
+                cwd: workspace.dir,
+                mcpServers: options.mcpServers ?? [],
+                ...(options.additionalDirectories?.length && this.supportsAdditionalDirectories()
+                    ? { additionalDirectories: [...new Set(options.additionalDirectories)] }
+                    : {}),
+                ...(options._meta ? { _meta: options._meta } : {}),
+            });
+        }
+        catch (err) {
+            workspace.cleanup();
+            const message = err.message ?? String(err);
+            if (/auth/i.test(message)) {
+                this.state = "needs-auth";
+                this.lastError = message;
+                throw err;
+            }
+            throw err;
+        }
+        const session = new Session(response.sessionId, workspace);
+        this.sessions.set(response.sessionId, session);
+        return session;
+    }
+    /** Drive a prompt without closing the ACP session, for stateful embedding hosts. */
+    async promptSession(session, prompt, options = {}) {
+        if (!this.conn)
+            throw new Error(`agent ${this.def.id} is not ready`);
+        if (options.signal?.aborted)
+            return { stopReason: "cancelled" };
+        const conn = this.conn;
+        session.setRawUpdateHandler(options.onUpdate
+            ? (update) => options.onUpdate?.({ sessionId: session.id, update })
+            : undefined);
+        const cancel = () => {
+            void conn.cancel({ sessionId: session.id }).catch(() => undefined);
+        };
+        if (options.signal)
+            options.signal.addEventListener("abort", cancel, { once: true });
+        const systemPrompt = options.systemPrompt?.trim();
+        const params = {
+            sessionId: session.id,
+            prompt,
+            ...(options.model ? { model: options.model } : {}),
+            ...(systemPrompt ? { _meta: { "xeno.dev/context": { systemPrompt } } } : {}),
+        };
+        try {
+            const request = conn.prompt(params);
+            return options.timeoutMs
+                ? await withTimeout(request, options.timeoutMs, `prompt timed out after ${options.timeoutMs}ms`, cancel)
+                : await request;
+        }
+        finally {
+            if (options.signal)
+                options.signal.removeEventListener("abort", cancel);
+            session.setRawUpdateHandler(undefined);
+        }
+    }
+    async cancelSession(sessionId) {
+        if (!this.conn)
+            throw new Error(`agent ${this.def.id} is not ready`);
+        await this.conn.cancel({ sessionId });
+    }
+    /** Drive an ephemeral prompt and close its event queue/workspace. */
+    async runPrompt(session, prompt, signal) {
+        try {
+            const response = await this.promptSession(session, prompt, { signal });
+            if (response.usage) {
+                session.push({
+                    type: "usage",
+                    ...(response.usage.inputTokens != null ? { inputTokens: response.usage.inputTokens } : {}),
+                    ...(response.usage.outputTokens != null ? { outputTokens: response.usage.outputTokens } : {}),
+                    ...(response.usage.totalTokens != null ? { totalTokens: response.usage.totalTokens } : {}),
+                });
+            }
+            session.end(response.stopReason);
+        }
+        catch (err) {
+            session.fail(err.message ?? String(err));
+        }
+        finally {
+            this.sessions.delete(session.id);
+            session.workspace.cleanup();
+        }
+    }
+    async dispose() {
+        for (const session of this.sessions.values()) {
+            session.fail("shutting down");
+            session.workspace.cleanup();
+        }
+        this.sessions.clear();
+        const child = this.child;
+        if (child) {
+            await new Promise((resolve) => {
+                let settled = false;
+                let forceTimer;
+                let releaseTimer;
+                const hasExited = () => child.exitCode !== null || child.signalCode !== null;
+                const finish = () => {
+                    if (settled)
+                        return;
+                    settled = true;
+                    if (forceTimer)
+                        clearTimeout(forceTimer);
+                    if (releaseTimer)
+                        clearTimeout(releaseTimer);
+                    child.removeListener("close", finish);
+                    resolve();
+                };
+                const forceStop = () => {
+                    try {
+                        if (!hasExited())
+                            child.kill("SIGKILL");
+                    }
+                    catch {
+                        /* ignore */
+                    }
+                    if (hasExited())
+                        finish();
+                    else
+                        releaseTimer = setTimeout(finish, 1_000);
+                };
+                if (hasExited()) {
+                    finish();
+                    return;
+                }
+                child.once("close", finish);
+                forceTimer = setTimeout(forceStop, 1_000);
+                try {
+                    child.kill("SIGTERM");
+                }
+                catch {
+                    forceStop();
+                }
+            });
+        }
+        this.conn = undefined;
+        this.child = undefined;
+        this.state = "stopped";
+    }
+    supportsAdditionalDirectories() {
+        const capabilities = this.initialization?.agentCapabilities;
+        const sessionCapabilities = capabilities?.sessionCapabilities;
+        if (!sessionCapabilities || typeof sessionCapabilities !== "object" || Array.isArray(sessionCapabilities))
+            return false;
+        const value = sessionCapabilities.additionalDirectories;
+        return !!value && typeof value === "object" && !Array.isArray(value);
+    }
+    observeStdout(chunk) {
+        this.stdoutBuffer += chunk;
+        while (this.stdoutBuffer.includes("\n")) {
+            const index = this.stdoutBuffer.indexOf("\n");
+            const line = this.stdoutBuffer.slice(0, index).replace(/\r$/, "");
+            this.stdoutBuffer = this.stdoutBuffer.slice(index + 1);
+            if (!line.trim())
+                continue;
+            try {
+                JSON.parse(line);
+            }
+            catch {
+                this.malformedMessageCount += 1;
+            }
+        }
+    }
+}
+function withTimeout(promise, milliseconds, message, onTimeout) {
+    return new Promise((resolve, reject) => {
+        const timer = setTimeout(() => {
+            onTimeout?.();
+            reject(new Error(message));
+        }, milliseconds);
+        promise.then((value) => {
+            clearTimeout(timer);
+            resolve(value);
+        }, (error) => {
+            clearTimeout(timer);
+            reject(error);
+        });
+    });
+}
+//# sourceMappingURL=agent-process.js.map

package/dist/agent-process.js.map

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

package/dist/agent-version-policy.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Local ACP provider CLI version readiness.
+ *
+ * Third-party CLIs are owned by the operator/provider, not XENO. We detect known-bad versions and
+ * fail certification with an update hint; we do not silently mutate the machine.
+ */
+import type { SpawnSyncReturns } from "node:child_process";
+import type { AgentDef, AgentVersionReadiness } from "./types.js";
+export type { AgentVersionReadiness, AgentVersionReadinessStatus } from "./types.js";
+interface AgentVersionPolicy {
+    args: string[];
+    minimumVersion: string;
+    recommendedVersion?: string;
+    updateHint: string;
+}
+export declare const AGENT_VERSION_POLICIES: Record<string, AgentVersionPolicy>;
+export type VersionCommandRunner = (file: string, args: string[], options: {
+    encoding: "utf8";
+    timeout: number;
+    shell: false;
+}) => Pick<SpawnSyncReturns<string>, "stdout" | "stderr" | "status" | "error">;
+export declare function parseCliVersion(text: string): string | undefined;
+export declare function compareCliVersions(a: string, b: string): number;
+export declare function checkAgentVersionReadiness(def: AgentDef, runner?: VersionCommandRunner): AgentVersionReadiness;
+//# sourceMappingURL=agent-version-policy.d.ts.map

package/dist/agent-version-policy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-version-policy.d.ts","sourceRoot":"","sources":["../src/agent-version-policy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,QAAQ,EAAE,qBAAqB,EAAE,MAAM,YAAY,CAAC;AAGlE,YAAY,EAAE,qBAAqB,EAAE,2BAA2B,EAAE,MAAM,YAAY,CAAC;AAErF,UAAU,kBAAkB;IAC1B,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,cAAc,EAAE,MAAM,CAAC;IACvB,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAOrE,CAAC;AAEF,MAAM,MAAM,oBAAoB,GAAG,CACjC,IAAI,EAAE,MAAM,EACZ,IAAI,EAAE,MAAM,EAAE,EACd,OAAO,EAAE;IAAE,QAAQ,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,KAAK,CAAA;CAAE,KACzD,IAAI,CAAC,gBAAgB,CAAC,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,GAAG,OAAO,CAAC,CAAC;AAE9E,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAEhE;AAED,wBAAgB,kBAAkB,CAAC,CAAC,EAAE,MAAM,EAAE,CAAC,EAAE,MAAM,GAAG,MAAM,CAQ/D;AAED,wBAAgB,0BAA0B,CACxC,GAAG,EAAE,QAAQ,EACb,MAAM,GAAE,oBAA8E,GACrF,qBAAqB,CA6DvB"}

package/dist/agent-version-policy.js

@@ -0,0 +1,87 @@
+/**
+ * Local ACP provider CLI version readiness.
+ *
+ * Third-party CLIs are owned by the operator/provider, not XENO. We detect known-bad versions and
+ * fail certification with an update hint; we do not silently mutate the machine.
+ */
+import { spawnSync } from "node:child_process";
+import { resolveCommand } from "./process-resolver.js";
+export const AGENT_VERSION_POLICIES = {
+    kimi: {
+        args: ["--version"],
+        minimumVersion: "0.19.2",
+        recommendedVersion: "0.19.2",
+        updateHint: "Run `kimi upgrade`, then rerun provider certification.",
+    },
+};
+export function parseCliVersion(text) {
+    return text.match(/\bv?(\d+\.\d+\.\d+(?:[-+][0-9A-Za-z.-]+)?)\b/)?.[1];
+}
+export function compareCliVersions(a, b) {
+    const aa = a.split(/[.+-]/).slice(0, 3).map((x) => Number(x));
+    const bb = b.split(/[.+-]/).slice(0, 3).map((x) => Number(x));
+    for (let i = 0; i < 3; i++) {
+        const d = (aa[i] ?? 0) - (bb[i] ?? 0);
+        if (d !== 0)
+            return d;
+    }
+    return 0;
+}
+export function checkAgentVersionReadiness(def, runner = (file, args, options) => spawnSync(file, args, options)) {
+    const policy = AGENT_VERSION_POLICIES[def.id];
+    if (!policy) {
+        return {
+            agentId: def.id,
+            status: "not_applicable",
+            ok: true,
+            message: `agent '${def.id}' has no pinned CLI version policy`,
+        };
+    }
+    const fail = (status, message) => ({
+        agentId: def.id,
+        status,
+        ok: false,
+        minimumVersion: policy.minimumVersion,
+        ...(policy.recommendedVersion ? { recommendedVersion: policy.recommendedVersion } : {}),
+        updateHint: policy.updateHint,
+        message,
+    });
+    let result;
+    try {
+        const resolved = resolveCommand(def.cmd, policy.args);
+        result = runner(resolved.file, resolved.args, { encoding: "utf8", timeout: 10_000, shell: false });
+    }
+    catch (err) {
+        return fail("unavailable", `agent '${def.id}' version check failed: ${err.message}`);
+    }
+    if (result.error || result.status !== 0) {
+        return fail("unavailable", `agent '${def.id}' version command failed`);
+    }
+    const installedVersion = parseCliVersion(`${result.stdout ?? ""}\n${result.stderr ?? ""}`);
+    if (!installedVersion) {
+        return fail("unknown", `agent '${def.id}' version output did not contain a semantic version`);
+    }
+    if (compareCliVersions(installedVersion, policy.minimumVersion) < 0) {
+        return {
+            agentId: def.id,
+            status: "outdated",
+            ok: false,
+            installedVersion,
+            minimumVersion: policy.minimumVersion,
+            ...(policy.recommendedVersion ? { recommendedVersion: policy.recommendedVersion } : {}),
+            updateHint: policy.updateHint,
+            message: `agent '${def.id}' CLI ${installedVersion} is below required ${policy.minimumVersion}`,
+        };
+    }
+    return {
+        agentId: def.id,
+        status: "ok",
+        ok: true,
+        installedVersion,
+        minimumVersion: policy.minimumVersion,
+        ...(policy.recommendedVersion ? { recommendedVersion: policy.recommendedVersion } : {}),
+        updateHint: policy.updateHint,
+        message: `agent '${def.id}' CLI ${installedVersion} satisfies required ${policy.minimumVersion}`,
+    };
+}
+//# sourceMappingURL=agent-version-policy.js.map

package/dist/agent-version-policy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"agent-version-policy.js","sourceRoot":"","sources":["../src/agent-version-policy.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAG/C,OAAO,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAWvD,MAAM,CAAC,MAAM,sBAAsB,GAAuC;IACxE,IAAI,EAAE;QACJ,IAAI,EAAE,CAAC,WAAW,CAAC;QACnB,cAAc,EAAE,QAAQ;QACxB,kBAAkB,EAAE,QAAQ;QAC5B,UAAU,EAAE,wDAAwD;KACrE;CACF,CAAC;AAQF,MAAM,UAAU,eAAe,CAAC,IAAY;IAC1C,OAAO,IAAI,CAAC,KAAK,CAAC,8CAA8C,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;AACzE,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,CAAS,EAAE,CAAS;IACrD,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,MAAM,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;IAC9D,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC;QAC3B,MAAM,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACtC,IAAI,CAAC,KAAK,CAAC;YAAE,OAAO,CAAC,CAAC;IACxB,CAAC;IACD,OAAO,CAAC,CAAC;AACX,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,GAAa,EACb,SAA+B,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,OAAO,CAAC;IAEtF,MAAM,MAAM,GAAG,sBAAsB,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IAC9C,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,EAAE;YACf,MAAM,EAAE,gBAAgB;YACxB,EAAE,EAAE,IAAI;YACR,OAAO,EAAE,UAAU,GAAG,CAAC,EAAE,oCAAoC;SAC9D,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,GAAG,CAAC,MAAuC,EAAE,OAAe,EAAyB,EAAE,CAAC,CAAC;QACjG,OAAO,EAAE,GAAG,CAAC,EAAE;QACf,MAAM;QACN,EAAE,EAAE,KAAK;QACT,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO;KACR,CAAC,CAAC;IAEH,IAAI,MAAgF,CAAC;IACrF,IAAI,CAAC;QACH,MAAM,QAAQ,GAAG,cAAc,CAAC,GAAG,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACtD,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,IAAI,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC;IACrG,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,CAAC,EAAE,2BAA4B,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;IAClG,CAAC;IAED,IAAI,MAAM,CAAC,KAAK,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACxC,OAAO,IAAI,CAAC,aAAa,EAAE,UAAU,GAAG,CAAC,EAAE,0BAA0B,CAAC,CAAC;IACzE,CAAC;IAED,MAAM,gBAAgB,GAAG,eAAe,CAAC,GAAG,MAAM,CAAC,MAAM,IAAI,EAAE,KAAK,MAAM,CAAC,MAAM,IAAI,EAAE,EAAE,CAAC,CAAC;IAC3F,IAAI,CAAC,gBAAgB,EAAE,CAAC;QACtB,OAAO,IAAI,CAAC,SAAS,EAAE,UAAU,GAAG,CAAC,EAAE,qDAAqD,CAAC,CAAC;IAChG,CAAC;IAED,IAAI,kBAAkB,CAAC,gBAAgB,EAAE,MAAM,CAAC,cAAc,CAAC,GAAG,CAAC,EAAE,CAAC;QACpE,OAAO;YACL,OAAO,EAAE,GAAG,CAAC,EAAE;YACf,MAAM,EAAE,UAAU;YAClB,EAAE,EAAE,KAAK;YACT,gBAAgB;YAChB,cAAc,EAAE,MAAM,CAAC,cAAc;YACrC,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvF,UAAU,EAAE,MAAM,CAAC,UAAU;YAC7B,OAAO,EAAE,UAAU,GAAG,CAAC,EAAE,SAAS,gBAAgB,sBAAsB,MAAM,CAAC,cAAc,EAAE;SAChG,CAAC;IACJ,CAAC;IAED,OAAO;QACL,OAAO,EAAE,GAAG,CAAC,EAAE;QACf,MAAM,EAAE,IAAI;QACZ,EAAE,EAAE,IAAI;QACR,gBAAgB;QAChB,cAAc,EAAE,MAAM,CAAC,cAAc;QACrC,GAAG,CAAC,MAAM,CAAC,kBAAkB,CAAC,CAAC,CAAC,EAAE,kBAAkB,EAAE,MAAM,CAAC,kBAAkB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvF,UAAU,EAAE,MAAM,CAAC,UAAU;QAC7B,OAAO,EAAE,UAAU,GAAG,CAAC,EAAE,SAAS,gBAAgB,uBAAuB,MAAM,CAAC,cAAc,EAAE;KACjG,CAAC;AACJ,CAAC"}

package/dist/capabilities.d.ts

@@ -0,0 +1,41 @@
+/**
+ * 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 type { Client, RequestPermissionRequest, RequestPermissionResponse, SessionNotification } from "@agentclientprotocol/sdk";
+import type { PermissionPolicy } from "./types.js";
+import type { Workspace } from "./workspace.js";
+import type { Logger } from "./logger.js";
+export interface ClientContext {
+    /** Route a session notification to its Session (by `sessionId`). */
+    dispatch(notification: SessionNotification): void;
+    /** Look up the sandbox for a session id (undefined if unknown). */
+    workspaceFor(sessionId: string): Workspace | undefined;
+    /** Permission policy for this agent. */
+    permission: PermissionPolicy;
+    /** Kill terminal commands after this many ms. */
+    terminalTimeoutMs: number;
+    logger: Logger;
+    /** Optional interactive/embedder permission handler. */
+    requestPermission?: (request: RequestPermissionRequest) => Promise<RequestPermissionResponse>;
+    /** Optional ACP extension request handler owned by the embedding host. */
+    extMethod?: (method: string, params: Record<string, unknown>) => Promise<Record<string, unknown>>;
+    /** Optional ACP extension notification handler owned by the embedding host. */
+    extNotification?: (method: string, params: Record<string, unknown>) => Promise<void>;
+    /** Diagnostics hook for unsupported extension requests. */
+    onUnsupportedMethod?: (method: string) => void;
+    /** Fail closed when an embedder does not advertise filesystem authority. */
+    allowFileSystem?: boolean;
+    /** Fail closed when an embedder does not advertise filesystem read authority. */
+    allowReadFileSystem?: boolean;
+    /** Fail closed when an embedder does not advertise filesystem write authority. */
+    allowWriteFileSystem?: boolean;
+    /** Fail closed when an embedder does not advertise terminal authority. */
+    allowTerminal?: boolean;
+}
+export declare function createClientHandler(ctx: ClientContext): Client;
+//# sourceMappingURL=capabilities.d.ts.map

package/dist/capabilities.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capabilities.d.ts","sourceRoot":"","sources":["../src/capabilities.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EACV,MAAM,EAON,wBAAwB,EACxB,yBAAyB,EACzB,mBAAmB,EAQpB,MAAM,0BAA0B,CAAC;AAClC,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,YAAY,CAAC;AACnD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,gBAAgB,CAAC;AAEhD,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,WAAW,aAAa;IAC5B,oEAAoE;IACpE,QAAQ,CAAC,YAAY,EAAE,mBAAmB,GAAG,IAAI,CAAC;IAClD,mEAAmE;IACnE,YAAY,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,GAAG,SAAS,CAAC;IACvD,wCAAwC;IACxC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,iDAAiD;IACjD,iBAAiB,EAAE,MAAM,CAAC;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,iBAAiB,CAAC,EAAE,CAAC,OAAO,EAAE,wBAAwB,KAAK,OAAO,CAAC,yBAAyB,CAAC,CAAC;IAC9F,0EAA0E;IAC1E,SAAS,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAClG,+EAA+E;IAC/E,eAAe,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IACrF,2DAA2D;IAC3D,mBAAmB,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,KAAK,IAAI,CAAC;IAC/C,4EAA4E;IAC5E,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,iFAAiF;IACjF,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,kFAAkF;IAClF,oBAAoB,CAAC,EAAE,OAAO,CAAC;IAC/B,0EAA0E;IAC1E,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAeD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAsM9D"}