@tickernelz/paperclip-pro-adapter-utils 2026.1002.8 → 2026.1004.0

package/dist/acpx-engine/execute.test.js

@@ -79,7 +79,7 @@ function createLocalSandboxRunner(onExecute) {
         },
     };
 }
-function buildRuntime(onSetConfigOption, onEnsureSession, onStartTurn) {
+function buildRuntime(onSetConfigOption, onEnsureSession, onStartTurn, onSetMode) {
     return {
         ensureSession: async (input) => {
             onEnsureSession?.(input);
@@ -102,12 +102,16 @@ function buildRuntime(onSetConfigOption, onEnsureSession, onStartTurn) {
         setConfigOption: async (input) => {
             onSetConfigOption?.(input);
         },
+        setMode: async (input) => {
+            onSetMode?.(input.mode);
+        },
         close: async () => { },
     };
 }
 async function runExecutor(config, options = {}) {
     const runtimeOptions = [];
     const configOptions = [];
+    const sessionModes = [];
     const sessionInputs = [];
     const turnInputs = [];
     const meta = [];
@@ -119,7 +123,7 @@ async function runExecutor(config, options = {}) {
             : {}),
         createRuntime: (options) => {
             runtimeOptions.push(options);
-            return buildRuntime(({ key, value }) => configOptions.push({ key, value }), (input) => sessionInputs.push(input), (input) => turnInputs.push(input));
+            return buildRuntime(({ key, value }) => configOptions.push({ key, value }), (input) => sessionInputs.push(input), (input) => turnInputs.push(input), (mode) => sessionModes.push(mode));
         },
     });
     const result = await execute({
@@ -147,7 +151,7 @@ async function runExecutor(config, options = {}) {
         },
     });
     expect(result.exitCode).toBe(0);
-    return { logs, meta, events, runtimeOptions, configOptions, sessionInputs, turnInputs, result };
+    return { logs, meta, events, runtimeOptions, configOptions, sessionModes, sessionInputs, turnInputs, result };
 }
 // Under `vi.useFakeTimers()`, setup before `ensureSession` still performs real
 // filesystem work. Advancing the fake clock before that work reaches the
@@ -282,6 +286,31 @@ describe("shared ACPX engine runtime behavior", () => {
         const run = await runExecutor({ agent: "custom", agentCommand: "node ./fake-acp.js", cwd: root, stateDir: path.join(root, "state"), permissionMode });
         expect(run.runtimeOptions[0]?.permissionMode).toBe(expected);
     });
+    it.each([
+        ["codex", "read-only"],
+        ["claude", "default"],
+    ])("applies the read_only tool profile to a %s ACP session through mode %s and a permission hook", async (agent, mode) => {
+        const root = await makeTempRoot();
+        const config = { agent, cwd: root, stateDir: path.join(root, "state") };
+        const full = await runExecutor(config);
+        const explicitFull = await runExecutor(config, { context: { paperclipToolProfile: "full" } });
+        const readOnly = await runExecutor(config, { context: { paperclipToolProfile: "read_only" } });
+        for (const run of [full, explicitFull]) {
+            expect(run.sessionModes).toEqual([]);
+            expect(run.runtimeOptions[0]).not.toHaveProperty("onPermissionRequest");
+        }
+        expect(explicitFull.result.sessionParams?.configFingerprint).toBe(full.result.sessionParams?.configFingerprint);
+        expect(readOnly.sessionModes).toEqual([mode]);
+        expect(typeof readOnly.runtimeOptions[0]?.onPermissionRequest).toBe("function");
+        expect(readOnly.runtimeOptions[0]?.permissionMode).toBe("approve-all");
+        expect(readOnly.result.sessionParams?.configFingerprint).not.toBe(full.result.sessionParams?.configFingerprint);
+    });
+    it("leaves agents without a read-only session mode on their configured mode in a read_only run", async () => {
+        const root = await makeTempRoot();
+        const run = await runExecutor({ agent: "gemini", cwd: root, stateDir: path.join(root, "state") }, { context: { paperclipToolProfile: "read_only" } });
+        expect(run.sessionModes).toEqual([]);
+        expect(typeof run.runtimeOptions[0]?.onPermissionRequest).toBe("function");
+    });
     it("persists ACP agent process identity before prompting on each run (host lane re-creates, no warm reuse)", async () => {
         const root = await makeTempRoot();
         const startedAt = "2026-07-30T07:00:00.000Z";