@tickernelz/paperclip-pro-adapter-utils 2026.925.0

package/dist/acpx-engine/index.d.ts

@@ -0,0 +1,6 @@
+export * from "./constants.js";
+export { createAcpxEngineExecutor, execute } from "./execute.js";
+export { sessionCodec } from "./session-codec.js";
+export { printAcpxStreamEvent } from "./cli.js";
+export { parseAcpxStdoutLine } from "./ui.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/acpx-engine/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/acpx-engine/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/dist/acpx-engine/index.js

@@ -0,0 +1,6 @@
+export * from "./constants.js";
+export { createAcpxEngineExecutor, execute } from "./execute.js";
+export { sessionCodec } from "./session-codec.js";
+export { printAcpxStreamEvent } from "./cli.js";
+export { parseAcpxStdoutLine } from "./ui.js";
+//# sourceMappingURL=index.js.map

package/dist/acpx-engine/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/acpx-engine/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAC;AAC/B,OAAO,EAAE,wBAAwB,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AACjE,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,mBAAmB,EAAE,MAAM,SAAS,CAAC"}

package/dist/acpx-engine/local-process-control.d.ts

@@ -0,0 +1,5 @@
+import { ChildProcess } from "node:child_process";
+export declare function captureLocalProcess(pid: number): ChildProcess | undefined;
+export declare function capturedProcessExited(child: Pick<ChildProcess, "exitCode" | "signalCode"> | undefined): boolean;
+export declare function killCapturedLocalProcess(child: Pick<ChildProcess, "exitCode" | "signalCode" | "kill"> | undefined): boolean;
+//# sourceMappingURL=local-process-control.d.ts.map

package/dist/acpx-engine/local-process-control.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-process-control.d.ts","sourceRoot":"","sources":["../../src/acpx-engine/local-process-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAqBlD,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,YAAY,GAAG,SAAS,CAEzE;AAED,wBAAgB,qBAAqB,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,YAAY,CAAC,GAAG,SAAS,GAAG,OAAO,CAE/G;AAED,wBAAgB,wBAAwB,CAAC,KAAK,EAAE,IAAI,CAAC,YAAY,EAAE,UAAU,GAAG,YAAY,GAAG,MAAM,CAAC,GAAG,SAAS,GAAG,OAAO,CAG3H"}

package/dist/acpx-engine/local-process-control.js

@@ -0,0 +1,39 @@
+import { ChildProcess } from "node:child_process";
+import { channel } from "node:diagnostics_channel";
+// Node publishes the real ChildProcess before its spawn event. ACP's spawn
+// callback only exposes a PID, so correlate it here while retaining the handle
+// for all later control. Never resolve a numeric PID again when stopping it.
+// https://nodejs.org/api/diagnostics_channel.html#event-child_process
+const children = new Map();
+channel("child_process").subscribe((message) => {
+    const child = message.process;
+    if (!(child instanceof ChildProcess))
+        return;
+    child.once("spawn", () => {
+        if (child.pid)
+            children.set(child.pid, child);
+    });
+    const remove = () => {
+        if (child.pid && children.get(child.pid) === child)
+            children.delete(child.pid);
+    };
+    child.once("exit", remove);
+    child.once("close", remove);
+});
+export function captureLocalProcess(pid) {
+    return children.get(pid);
+}
+export function capturedProcessExited(child) {
+    return Boolean(child && (child.exitCode !== null || child.signalCode !== null));
+}
+export function killCapturedLocalProcess(child) {
+    if (!child || capturedProcessExited(child))
+        return false;
+    try {
+        return child.kill("SIGKILL");
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=local-process-control.js.map

package/dist/acpx-engine/local-process-control.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-process-control.js","sourceRoot":"","sources":["../../src/acpx-engine/local-process-control.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAClD,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAC;AAEnD,2EAA2E;AAC3E,+EAA+E;AAC/E,6EAA6E;AAC7E,sEAAsE;AACtE,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAwB,CAAC;AACjD,OAAO,CAAC,eAAe,CAAC,CAAC,SAAS,CAAC,CAAC,OAAO,EAAE,EAAE;IAC7C,MAAM,KAAK,GAAI,OAAiC,CAAC,OAAO,CAAC;IACzD,IAAI,CAAC,CAAC,KAAK,YAAY,YAAY,CAAC;QAAE,OAAO;IAC7C,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,GAAG,EAAE;QACvB,IAAI,KAAK,CAAC,GAAG;YAAE,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IAChD,CAAC,CAAC,CAAC;IACH,MAAM,MAAM,GAAG,GAAG,EAAE;QAClB,IAAI,KAAK,CAAC,GAAG,IAAI,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,KAAK,KAAK;YAAE,QAAQ,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACjF,CAAC,CAAC;IACF,KAAK,CAAC,IAAI,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC3B,KAAK,CAAC,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;AAC9B,CAAC,CAAC,CAAC;AAEH,MAAM,UAAU,mBAAmB,CAAC,GAAW;IAC7C,OAAO,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;AAC3B,CAAC;AAED,MAAM,UAAU,qBAAqB,CAAC,KAAgE;IACpG,OAAO,OAAO,CAAC,KAAK,IAAI,CAAC,KAAK,CAAC,QAAQ,KAAK,IAAI,IAAI,KAAK,CAAC,UAAU,KAAK,IAAI,CAAC,CAAC,CAAC;AAClF,CAAC;AAED,MAAM,UAAU,wBAAwB,CAAC,KAAyE;IAChH,IAAI,CAAC,KAAK,IAAI,qBAAqB,CAAC,KAAK,CAAC;QAAE,OAAO,KAAK,CAAC;IACzD,IAAI,CAAC;QAAC,OAAO,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAAC,CAAC;IAAC,MAAM,CAAC;QAAC,OAAO,KAAK,CAAC;IAAC,CAAC;AAC/D,CAAC"}

package/dist/acpx-engine/local-process-control.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=local-process-control.test.d.ts.map

package/dist/acpx-engine/local-process-control.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-process-control.test.d.ts","sourceRoot":"","sources":["../../src/acpx-engine/local-process-control.test.ts"],"names":[],"mappings":""}

package/dist/acpx-engine/local-process-control.test.js

@@ -0,0 +1,38 @@
+import { spawn } from "node:child_process";
+import { once } from "node:events";
+import { expect, it, vi } from "vitest";
+import { captureLocalProcess, capturedProcessExited, killCapturedLocalProcess } from "./local-process-control.js";
+it("captures and terminates the actual spawned child on the current platform", async () => {
+    const child = spawn(process.execPath, ["-e", "setInterval(() => {}, 1000)"], { stdio: "ignore" });
+    try {
+        await once(child, "spawn");
+        const captured = captureLocalProcess(child.pid);
+        expect(captured).toBe(child);
+        expect(capturedProcessExited(captured)).toBe(false);
+        const exited = once(child, "exit");
+        expect(killCapturedLocalProcess(captured)).toBe(true);
+        await exited;
+        expect(capturedProcessExited(captured)).toBe(true);
+        expect(captureLocalProcess(child.pid)).toBeUndefined();
+    }
+    finally {
+        if (!capturedProcessExited(child))
+            child.kill("SIGKILL");
+    }
+});
+it("never signals an exited child even if another process has reused its PID", () => {
+    const original = { pid: 123, exitCode: 0, signalCode: null, kill: vi.fn(() => true) };
+    const replacement = { pid: 123, exitCode: null, signalCode: null, kill: vi.fn(() => true) };
+    expect(killCapturedLocalProcess(original)).toBe(false);
+    expect(original.kill).not.toHaveBeenCalled();
+    expect(replacement.kill).not.toHaveBeenCalled();
+});
+it("fails closed when the spawned handle was not captured", () => {
+    expect(killCapturedLocalProcess(undefined)).toBe(false);
+    expect(capturedProcessExited(undefined)).toBe(false);
+});
+it("reports an unsuccessful signal without throwing", () => {
+    expect(killCapturedLocalProcess({ exitCode: null, signalCode: null, kill: () => false })).toBe(false);
+    expect(killCapturedLocalProcess({ exitCode: null, signalCode: null, kill: () => { throw new Error("gone"); } })).toBe(false);
+});
+//# sourceMappingURL=local-process-control.test.js.map

package/dist/acpx-engine/local-process-control.test.js.map

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

package/dist/acpx-engine/operator-stop.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=operator-stop.test.d.ts.map

package/dist/acpx-engine/operator-stop.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"operator-stop.test.d.ts","sourceRoot":"","sources":["../../src/acpx-engine/operator-stop.test.ts"],"names":[],"mappings":""}

package/dist/acpx-engine/operator-stop.test.js

@@ -0,0 +1,107 @@
+import fs from 'node:fs/promises';
+import os from 'node:os';
+import path from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { createHash } from 'node:crypto';
+import { afterEach, expect, it } from 'vitest';
+import { createAcpxEngineExecutor } from './execute.js';
+import { sessionCodec } from './session-codec.js';
+const fixture = fileURLToPath(new URL('../../../../scripts/mcp-fixtures/servers/acp-stop-agent.mjs', import.meta.url));
+const roots = [];
+afterEach(async () => { await Promise.all(roots.splice(0).map(root => fs.rm(root, { recursive: true, force: true }))); });
+async function setup(tool) {
+    const root = await fs.mkdtemp(path.join(os.tmpdir(), 'paperclip-acp-stop-'));
+    roots.push(root);
+    const abort = new AbortController();
+    let ready;
+    const started = new Promise(resolve => { ready = resolve; });
+    const ctx = {
+        runId: 'stop-test', agent: { id: 'agent', companyId: 'company' }, runtime: {},
+        config: { agent: 'custom', agentCommand: `${JSON.stringify(process.execPath)} ${JSON.stringify(fixture)}`, mode: 'persistent',
+            stateDir: path.join(root, 'state'), cwd: root, graceSec: 5,
+            env: { PAPERCLIP_STOP_FIXTURE_ROOT: root, ...(tool ? { PAPERCLIP_STOP_FIXTURE_TOOL: tool } : {}) } },
+        context: {}, signal: abort.signal,
+        onLog: async (_stream, text) => { await fs.appendFile(path.join(root, 'logs'), text); if (text.includes('Waiting for Stop.'))
+            ready(); },
+    };
+    return { root, ctx, abort, started, execute: createAcpxEngineExecutor() };
+}
+it('stops an actual ACP process and resumes its established session with the new request', async () => {
+    const { root, ctx, abort, started, execute } = await setup('read');
+    ctx.authToken = 'first-run-test-token';
+    const running = execute(ctx);
+    await started;
+    abort.abort(new Error('Operator Stop'));
+    const result = await running;
+    expect(result.resultJson?.executionCancellation).toMatchObject({ state: 'acknowledged', forced: false });
+    expect(result.executionRecovery).toMatchObject({ kind: 'interrupted', sessionPreserved: true });
+    const params = sessionCodec.serialize(result.sessionParams ?? null);
+    expect(params?.interruptedCheckpoint).toBe(true);
+    const next = await execute({ ...ctx, runId: 'follow-up', authToken: 'follow-up-test-token', signal: undefined, context: { prompt: 'List recent Drive files' },
+        runtime: { ...ctx.runtime, sessionParams: params } });
+    expect(next.exitCode, JSON.stringify(next)).toBe(0);
+    const prompts = (await fs.readFile(path.join(root, 'prompts'), 'utf8')).trim().split('\n').map(line => JSON.parse(line));
+    expect(prompts).toHaveLength(2);
+    expect(prompts[1].sessionId).toBe(prompts[0].sessionId);
+    const launches = (await fs.readFile(path.join(root, 'run-env'), 'utf8')).trim().split('\n').map(line => JSON.parse(line));
+    expect(launches.map(launch => launch.runId)).toEqual(['stop-test', 'follow-up']);
+    expect(launches[1].tokenHash).toBe(createHash('sha256').update('follow-up-test-token').digest('hex'));
+});
+it('continues after an interrupted write without replaying that write', async () => {
+    const { root, ctx, abort, started, execute } = await setup('write');
+    const running = execute(ctx);
+    await started;
+    await new Promise(resolve => setTimeout(resolve, 100));
+    abort.abort();
+    const result = await running;
+    expect(result.resultJson?.executionCancellation).toMatchObject({ state: 'acknowledged' });
+    expect(result.executionRecovery).toBeUndefined();
+    const before = await fs.readFile(path.join(root, 'writes'), 'utf8');
+    const next = await execute({ ...ctx, runId: 'follow-up', signal: undefined, context: { prompt: 'What happened?' },
+        runtime: { ...ctx.runtime, sessionParams: sessionCodec.serialize(result.sessionParams ?? null) } });
+    expect(next.exitCode, JSON.stringify(next)).toBe(0);
+    expect(await fs.readFile(path.join(root, 'writes'), 'utf8')).toBe(before);
+    expect((await fs.readFile(path.join(root, 'completed'), 'utf8')).trim()).toBe('follow-up');
+}, 15000);
+it('does not dispatch a provider when Stop precedes startup', async () => {
+    const { root, ctx, abort, execute } = await setup();
+    abort.abort(new Error('Stopped before startup'));
+    expect(await execute(ctx)).toMatchObject({ errorCode: 'cancelled', executionRecovery: { kind: 'bootstrap', providerWorkStarted: false } });
+    await expect(fs.access(path.join(root, 'prompts'))).rejects.toThrow();
+});
+it.each(['missing session', 'changed configuration'])('starts a new turn when the interrupted session cannot resume: %s', async (change) => {
+    const { root, ctx, abort, started, execute } = await setup();
+    const running = execute(ctx);
+    await started;
+    abort.abort();
+    const result = await running;
+    expect(result.executionRecovery?.kind).toBe('interrupted');
+    if (change === 'missing session')
+        await fs.rm(path.join(root, 'session'));
+    let next = await execute({ ...ctx, signal: undefined,
+        config: change === 'changed configuration' ? { ...ctx.config, env: { ...ctx.config.env, SETTING: 'changed' } } : ctx.config,
+        runtime: { ...ctx.runtime, sessionParams: sessionCodec.serialize(result.sessionParams ?? null) }, });
+    if (change === 'missing session') {
+        expect(next.clearSession, JSON.stringify(next)).toBe(true);
+        next = await execute({ ...ctx, runId: 'fresh-follow-up', signal: undefined,
+            runtime: { ...ctx.runtime, sessionParams: null } });
+    }
+    expect(next.exitCode, JSON.stringify(next)).toBe(0);
+    expect((await fs.readFile(path.join(root, 'prompts'), 'utf8')).trim().split('\n')).toHaveLength(2);
+});
+it('keeps the Stop deadline active after cancellation returns until provider exit', async () => {
+    const { ctx, abort, started, execute } = await setup();
+    ctx.config.graceSec = 1;
+    ctx.config.env = { ...ctx.config.env, PAPERCLIP_STOP_FIXTURE_HANG_ON_CLOSE: '1' };
+    let providerPid;
+    ctx.onSpawn = async ({ pid }) => { providerPid = pid; };
+    const running = execute(ctx);
+    await started;
+    abort.abort();
+    const result = await running;
+    expect(result.resultJson?.executionCancellation).toMatchObject({ state: 'acknowledged', forced: true });
+    expect(result.executionRecovery).toBeUndefined();
+    expect(providerPid).toBeTypeOf('number');
+    expect(() => process.kill(providerPid, 0)).toThrow(expect.objectContaining({ code: 'ESRCH' }));
+}, 10000);
+//# sourceMappingURL=operator-stop.test.js.map

package/dist/acpx-engine/operator-stop.test.js.map

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

package/dist/acpx-engine/remote-spawn-smoke.test.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=remote-spawn-smoke.test.d.ts.map

package/dist/acpx-engine/remote-spawn-smoke.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-spawn-smoke.test.d.ts","sourceRoot":"","sources":["../../src/acpx-engine/remote-spawn-smoke.test.ts"],"names":[],"mappings":""}

package/dist/acpx-engine/remote-spawn-smoke.test.js

@@ -0,0 +1,151 @@
+import fs from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { afterEach, expect, it } from "vitest";
+import { createAcpRuntime, createAgentRegistry, createRuntimeStore } from "acpx/runtime";
+// Load-bearing repro for the remote-ACP "process session" lane host-spawn bug.
+//
+// The engine threads ONE cwd (`sessionCwd`) into every cwd-keyed site: the ACP
+// `session/new` cwd, the session fingerprint/compat key, AND the acpx HOST
+// `spawn()` of the host-local relay proxy. On the remote lane that value is the
+// IN-SANDBOX `remoteCwd`, which does not exist on the host, so libuv's pre-`exec`
+// `chdir` fails and acpx raises `AgentSpawnError` at `ensure_session`.
+//
+// A faithful full-engine remote-lane repro is NOT possible without a live
+// sandbox: the only local stand-in for a sandbox runs its commands as host child
+// processes, so every `remoteCwd`-derived operation (workspace staging, the
+// callback bridge, the process-session bridge) executes on the HOST filesystem —
+// either materializing `remoteCwd` on the host (masking the host-spawn ENOENT)
+// or failing earlier at a different phase. So we split the proof at its two real
+// seams: (1) here — the acpx runtime's REAL host `spawn()` honoring
+// `spawnCwd ?? cwd` (real `createAcpRuntime`, real libuv `chdir`); and (2) the
+// engine → `runtimeOptions` threading (`execute.test.ts`, which asserts the
+// engine sets `spawnCwd` host-valid on the remote lane and `undefined`
+// elsewhere, with the advertised `session/new` cwd staying `remoteCwd`).
+// End-to-end validation against a real sandbox is board-run.
+const repoRoot = fileURLToPath(new URL("../../../..", import.meta.url));
+// A dedicated ACP agent fixture that reports, on stderr, the working directory
+// the host actually spawned it in (`SPAWN_CWD`) and the `cwd` advertised on
+// `session/new` (`SESSION_NEW_CWD`).
+const fixturePath = path.join(repoRoot, "scripts", "mcp-fixtures", "servers", "acp-cwd-report-agent.mjs");
+const tempRoots = [];
+afterEach(async () => {
+    await Promise.all(tempRoots.splice(0).map((root) => fs.rm(root, { recursive: true, force: true })));
+});
+async function makeTempDir(prefix) {
+    const dir = await fs.mkdtemp(path.join(os.tmpdir(), prefix));
+    tempRoots.push(dir);
+    return dir;
+}
+/**
+ * Drive a REAL acpx runtime through `ensureSession`, which performs the real
+ * host `spawn()` (and its libuv `chdir`). `cwd` is the advertised session cwd;
+ * `spawnCwd`, when set, is the host-only spawn cwd the acpx patch consumes as
+ * `spawnCwd ?? cwd`.
+ */
+async function ensureRealAcpSession(input) {
+    const stateRoot = await makeTempDir("paperclip-acpx-remote-spawn-state-");
+    const stderrChunks = [];
+    const agentCommand = `${JSON.stringify(process.execPath.replaceAll("\\", "/"))} ${JSON.stringify(fixturePath.replaceAll("\\", "/"))}`;
+    const runtimeOptions = {
+        cwd: input.cwd,
+        // `spawnCwd` is the host-only knob added by patches/acpx@0.12.0.patch; when
+        // unset acpx falls back to `cwd`, so every non-proxy lane is byte-identical.
+        ...(input.spawnCwd ? { spawnCwd: input.spawnCwd } : {}),
+        sessionStore: createRuntimeStore({ stateDir: path.join(stateRoot, "state") }),
+        agentRegistry: createAgentRegistry({ overrides: { custom: agentCommand } }),
+        permissionMode: "approve-all",
+        nonInteractivePermissions: "deny",
+        onAgentStderr: (chunk) => stderrChunks.push(chunk),
+        onAgentSpawn: input.onAgentSpawn,
+    };
+    const runtime = createAcpRuntime(runtimeOptions);
+    try {
+        const sessionInput = {
+            sessionKey: "remote-spawn-smoke",
+            agent: "custom",
+            mode: "oneshot",
+            cwd: input.cwd,
+            sessionOptions: { env: {} },
+        };
+        const handle = await runtime.ensureSession(sessionInput);
+        await runtime.close({ handle, reason: "done" }).catch(() => { });
+        return { resolved: true, stderr: stderrChunks.join("") };
+    }
+    catch (err) {
+        return { resolved: false, error: err, stderr: stderrChunks.join("") };
+    }
+}
+function isProcessAlive(pid) {
+    try {
+        process.kill(pid, 0);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+async function waitForProcessExit(pid, timeoutMs = 2_000) {
+    const deadline = Date.now() + timeoutMs;
+    while (isProcessAlive(pid)) {
+        if (Date.now() >= deadline)
+            throw new Error(`Timed out waiting for ACP agent ${pid} to exit`);
+        await new Promise((resolve) => setTimeout(resolve, 20));
+    }
+}
+it("reproduces host-spawn ENOENT when the advertised session cwd is host-nonexistent", async () => {
+    // The in-sandbox `remoteCwd` that does not exist on the host. Intentionally
+    // NOT created: this is what trips the acpx host `spawn()` `chdir`.
+    const sandboxParent = await makeTempDir("paperclip-acpx-remote-spawn-sandbox-");
+    const remoteCwd = path.join(sandboxParent, "does-not-exist-on-host", "workspace");
+    const outcome = await ensureRealAcpSession({ cwd: remoteCwd });
+    // Before the fix the engine feeds `remoteCwd` as the host spawn cwd, so acpx's
+    // real `spawn()` `chdir`s into a host-nonexistent dir and fails ENOENT. This is
+    // the exact `ensure_session` failure the remote lane hits in production.
+    expect(outcome.resolved, JSON.stringify(outcome)).toBe(false);
+    if (outcome.resolved)
+        return;
+    expect(outcome.error.name).toBe("AgentSpawnError");
+    expect(outcome.error.cause?.code).toBe("ENOENT");
+});
+it("spawnCwd redirects the host spawn to a host-valid dir while the advertised session cwd stays remoteCwd", async () => {
+    const sandboxParent = await makeTempDir("paperclip-acpx-remote-spawn-sandbox-");
+    // Host-nonexistent in-sandbox cwd — the advertised `session/new` cwd.
+    const remoteCwd = path.join(sandboxParent, "does-not-exist-on-host", "workspace");
+    // Host-valid dir the proxy actually spawns in (the engine's host `cwd`).
+    const hostSpawnCwd = await makeTempDir("paperclip-acpx-remote-spawn-host-");
+    const outcome = await ensureRealAcpSession({ cwd: remoteCwd, spawnCwd: hostSpawnCwd });
+    // With `spawnCwd` set the host `spawn()` `chdir`s into the host-valid dir, so
+    // the session comes up instead of failing at `ensure_session`.
+    expect(outcome.resolved, JSON.stringify(outcome)).toBe(true);
+    // The host process really ran in `spawnCwd`...
+    expect(outcome.stderr).toContain(`SPAWN_CWD=${await fs.realpath(hostSpawnCwd)}`);
+    // ...while the in-sandbox data path (the advertised `session/new` cwd) is
+    // unchanged — still `remoteCwd`.
+    expect(outcome.stderr).toContain(`SESSION_NEW_CWD=${remoteCwd}`);
+});
+it("kills the ACP agent when process identity persistence rejects", async () => {
+    const hostCwd = await makeTempDir("paperclip-acpx-spawn-persistence-");
+    let spawnedPid = null;
+    const outcome = await ensureRealAcpSession({
+        cwd: hostCwd,
+        onAgentSpawn: async ({ pid }) => {
+            spawnedPid = pid;
+            throw new Error("process identity persistence failed");
+        },
+    });
+    expect(outcome.resolved).toBe(false);
+    if (outcome.resolved)
+        return;
+    expect(outcome.error.message).toContain("process identity persistence failed");
+    expect(spawnedPid).not.toBeNull();
+    try {
+        await waitForProcessExit(spawnedPid);
+    }
+    finally {
+        if (isProcessAlive(spawnedPid))
+            process.kill(spawnedPid, "SIGKILL");
+    }
+});
+//# sourceMappingURL=remote-spawn-smoke.test.js.map

package/dist/acpx-engine/remote-spawn-smoke.test.js.map

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