acp-port 0.1.3 → 0.2.0

package/dist/tools/runner.js

@@ -9,12 +9,29 @@ const MAX_OUTPUT_CHARS = 64_000;
 const MAX_ARGUMENT_CHARS = 1_048_576;
 const MAX_TERMINAL_OUTPUT_BYTES = 64_000;
 const TOOL_CLEANUP_TIMEOUT_MS = 1_000;
+const MAX_PERMISSION_PREVIEW_CHARS = 16_000;
+const MAX_TOOL_TITLE_CHARS = 200;
 function truncateToolOutput(text) {
     const suffix = "\n[Output truncated]";
     return text.length <= MAX_OUTPUT_CHARS
         ? text
         : text.slice(0, MAX_OUTPUT_CHARS - suffix.length) + suffix;
 }
+function permissionTitle(text) {
+    return text.length <= MAX_TOOL_TITLE_CHARS
+        ? text
+        : `${text.slice(0, MAX_TOOL_TITLE_CHARS - 1)}…`;
+}
+function fileContentPreview(content) {
+    const preview = content.slice(0, MAX_PERMISSION_PREVIEW_CHARS);
+    // Keep embedded Markdown fences inside the displayed file contents.
+    const fenceLength = (preview.match(/`+/g) ?? []).reduce((length, run) => Math.max(length, run.length + 1), 3);
+    const fence = "`".repeat(fenceLength);
+    const label = preview.length === content.length
+        ? "Proposed complete file contents"
+        : `Proposed file contents: first ${preview.length} of ${content.length} characters (preview truncated; the entire file will be replaced)`;
+    return `${label}:\n\n${fence}text\n${preview}\n${fence}`;
+}
 /** SDK cancellation is cooperative; do not wait for an unresponsive peer. */
 function waitWithCancellation(operation, signal) {
     signal.throwIfAborted();
@@ -157,7 +174,7 @@ export class ToolRunner {
         const requestOptions = { cancellationSignal: signal };
         const args = toolCatalog.write_file.inputSchema.parse(input);
         const path = await waitWithCancellation(() => this.resolvePath(args.path), signal);
-        await this.requestPermission(call, toolCatalog.write_file.kind, { ...args, path }, signal);
+        await this.requestPermission(call, { ...args, path }, signal);
         // Recheck after user interaction, which can keep the request open for a while.
         await waitWithCancellation(() => this.resolvePath(args.path), signal);
         await this.markToolInProgress(call.id, signal);
@@ -186,7 +203,7 @@ export class ToolRunner {
         const requestOptions = { cancellationSignal: signal };
         const args = toolCatalog.run_command.inputSchema.parse(input);
         const commandCwd = await waitWithCancellation(() => this.resolvePath(args.cwd ?? "."), signal);
-        await this.requestPermission(call, toolCatalog.run_command.kind, { ...args, cwd: commandCwd }, signal);
+        await this.requestPermission(call, { ...args, cwd: commandCwd }, signal);
         await waitWithCancellation(() => this.resolvePath(args.cwd ?? "."), signal);
         await this.markToolInProgress(call.id, signal);
         signal.throwIfAborted();
@@ -229,29 +246,28 @@ export class ToolRunner {
             }
         }
     }
-    async requestPermission(call, kind, input, signal) {
+    async requestPermission(call, input, signal) {
         signal.throwIfAborted();
         if (this.mode === "full-access" ||
             (this.mode === "accept-edits" && call.name === "write_file")) {
             return;
         }
-        const grantInput = input;
-        const grantKey = JSON.stringify(call.name === "write_file"
-            ? [call.name, grantInput.path]
-            : [call.name, grantInput.command, grantInput.args, grantInput.cwd]);
+        const grantKey = JSON.stringify("path" in input
+            ? [call.name, input.path]
+            : [call.name, input.command, input.args, input.cwd]);
         if (this.mode === "auto" && this.permissionGrants.has(grantKey)) {
             return;
         }
+        const toolCall = this.permissionToolCall(call, input);
+        // Some clients render the pending tool update while their permission prompt
+        // only shows the choices. Both messages must describe the same operation.
+        await waitWithCancellation(() => this.notifyToolUpdate({
+            sessionUpdate: "tool_call_update",
+            ...toolCall,
+        }), signal);
         const response = await waitWithCancellation(() => this.options.client.request("session/request_permission", {
             sessionId: this.options.sessionId,
-            toolCall: {
-                toolCallId: call.id,
-                title: call.name,
-                name: call.name,
-                kind,
-                status: "pending",
-                rawInput: input,
-            },
+            toolCall,
             options: [
                 ...(this.mode === "auto"
                     ? [
@@ -285,6 +301,55 @@ export class ToolRunner {
         }
         signal.throwIfAborted();
     }
+    permissionToolCall(call, input) {
+        let title;
+        let details;
+        if ("path" in input) {
+            title = `Write file: ${JSON.stringify(input.path)}`;
+            details = [
+                "Permission requested: write a file.",
+                `Path: ${JSON.stringify(input.path)}`,
+                `Effect: Replace the entire file with ${input.content.length} characters, creating the file and missing parent directories if needed.`,
+                `Write through: ${this.options.capabilities.fs?.writeTextFile ? "the editor's file API" : "the agent's local filesystem"}.`,
+                "Allow once approves only this write of the proposed contents.",
+                ...(this.mode === "auto"
+                    ? [
+                        "Allow writes to this file for this session also approves future writes to this exact path, including different contents, until the permission mode changes or the session ends.",
+                    ]
+                    : []),
+                "Current file contents are not included in this preview.",
+                "",
+                fileContentPreview(input.content),
+            ].join("\n");
+        }
+        else {
+            title = `Run: ${[input.command, ...input.args].map((value) => JSON.stringify(value)).join(" ")}`;
+            details = [
+                "Permission requested: execute a program.",
+                `Executable (JSON string): ${JSON.stringify(input.command)}`,
+                `Arguments (JSON array): ${JSON.stringify(input.args)}`,
+                `Working directory: ${JSON.stringify(input.cwd)}`,
+                `Execution location: ${this.options.capabilities.terminal ? "the editor's terminal" : "a local process on the agent's host"}.`,
+                "The executable receives these arguments directly; no shell is added. It runs with the host's process permissions. The working directory does not restrict which files or services it can access.",
+                "Allow once approves one execution with this executable, argument list, and working directory.",
+                ...(this.mode === "auto"
+                    ? [
+                        "Allow this exact command for this session also approves future executions with the same executable, argument list, and working directory, until the permission mode changes or the session ends.",
+                    ]
+                    : []),
+            ].join("\n");
+        }
+        return {
+            toolCallId: call.id,
+            title: permissionTitle(title),
+            name: call.name,
+            kind: "path" in input ? "edit" : "execute",
+            status: "pending",
+            locations: [{ path: "path" in input ? input.path : input.cwd }],
+            content: [{ type: "content", content: { type: "text", text: details } }],
+            rawInput: input,
+        };
+    }
     markToolInProgress(toolCallId, signal) {
         return waitWithCancellation(() => this.notifyToolUpdate({
             sessionUpdate: "tool_call_update",

package/dist/tools/runner.js.map

@@ -1 +1 @@
-{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/tools/runner.ts"],"names":[],"mappings":"AAAA,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,QAAQ,MAAM,WAAW,CAAC;AAcjC,OAAO,EACL,qBAAqB,EACrB,kBAAkB,EAClB,WAAW,GACZ,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AACrD,OAAO,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACzE,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,MAAM,gBAAgB,GAAG,MAAM,CAAC;AAChC,MAAM,kBAAkB,GAAG,SAAS,CAAC;AACrC,MAAM,yBAAyB,GAAG,MAAM,CAAC;AACzC,MAAM,uBAAuB,GAAG,KAAK,CAAC;AAkBtC,SAAS,kBAAkB,CAAC,IAAY;IACtC,MAAM,MAAM,GAAG,sBAAsB,CAAC;IACtC,OAAO,IAAI,CAAC,MAAM,IAAI,gBAAgB;QACpC,CAAC,CAAC,IAAI;QACN,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,EAAE,gBAAgB,GAAG,MAAM,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AAC/D,CAAC;AAED,6EAA6E;AAC7E,SAAS,oBAAoB,CAC3B,SAA2B,EAC3B,MAAmB;IAEnB,MAAM,CAAC,cAAc,EAAE,CAAC;IACxB,OAAO,IAAI,OAAO,CAAI,CAAC,aAAa,EAAE,MAAM,EAAE,EAAE;QAC9C,MAAM,OAAO,GAAG,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC;QAC3E,MAAM,CAAC,gBAAgB,CAAC,OAAO,EAAE,OAAO,EAAE,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;QAC1D,OAAO,CAAC,OAAO,EAAE;aACd,IAAI,CAAC,GAAG,EAAE;YACT,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,OAAO,SAAS,EAAE,CAAC;QACrB,CAAC,CAAC;aACD,IAAI,CAAC,aAAa,EAAE,MAAM,CAAC;aAC3B,OAAO,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC;IACjE,CAAC,CAAC,CAAC;AACL,CAAC;AAED,MAAM,OAAO,UAAU;IAGQ,OAAO;IAFnB,gBAAgB,CAAc;IAE/C,YAA6B,OAA0B;uBAA1B,OAAO;QAClC,IAAI,CAAC,gBAAgB,GAAG,OAAO,CAAC,gBAAgB,IAAI,IAAI,GAAG,EAAE,CAAC;IAChE,CAAC;IAED,IAAY,IAAI;QACd,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,QAAQ,CAAC;IACvC,CAAC;IAED,WAAW;QACT,OAAO,kBAAkB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED,KAAK,CAAC,OAAO,CAAC,IAAc;QAC1B,MAAM,iBAAiB,GAAG,IAAI,eAAe,EAAE,CAAC;QAChD,MAAM,KAAK,GAAG,UAAU,CACtB,GAAG,EAAE,CACH,iBAAiB,CAAC,KAAK,CACrB,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,OAAO,CAAC,SAAS,KAAK,CAAC,CAC/D,EACH,IAAI,CAAC,OAAO,CAAC,SAAS,CACvB,CAAC;QACF,MAAM,MAAM,GAAG,WAAW,CAAC,GAAG,CAAC;YAC7B,IAAI,CAAC,OAAO,CAAC,MAAM;YACnB,iBAAiB,CAAC,MAAM;SACzB,CAAC,CAAC;QACH,IAAI,MAAkB,CAAC;QACvB,IAAI,CAAC;YACH,MAAM,CAAC,cAAc,EAAE,CAAC;YACxB,MAAM,QAAQ,GAAG,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CACpD,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,IAAI,CAAC,IAAI,CAC7B,CAAC;YACF,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACd,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;YACvD,CAAC;YACD,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,kBAAkB,EAAE,CAAC;gBAC/C,MAAM,IAAI,KAAK,CAAC,8BAA8B,CAAC,CAAC;YAClD,CAAC;YACD,MAAM,KAAK,GAAY,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YAClD,MAAM,oBAAoB,CACxB,GAAG,EAAE,CACH,IAAI,CAAC,gBAAgB,CAAC;gBACpB,aAAa,EAAE,WAAW;gBAC1B,UAAU,EAAE,IAAI,CAAC,EAAE;gBACnB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,IAAI,EAAE,WAAW,CAAC,QAAQ,CAAC,CAAC,IAAI;gBAChC,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,KAAK;aAChB,CAAC,EACJ,MAAM,CACP,CAAC;YACF,MAAM,GAAG,MAAM,IAAI,CAAC,gBAAgB,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;QAC5D,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,MAAM,GAAG;gBACP,OAAO,EAAE,kBAAkB,CACzB,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,aAAa,CACvD;gBACD,OAAO,EAAE,IAAI;aACd,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC;QACD,uFAAuF;QACvF,MAAM,oBAAoB,CACxB,GAAG,EAAE,CACH,IAAI,CAAC,gBAAgB,CAAC;YACpB,aAAa,EAAE,kBAAkB;YACjC,UAAU,EAAE,IAAI,CAAC,EAAE;YACnB,MAAM,EAAE,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,WAAW;YAC/C,OAAO,EAAE;gBACP;oBACE,IAAI,EAAE,SAAS;oBACf,OAAO,EAAE,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,OAAO,EAAE;iBAChD;aACF;YACD,SAAS,EAAE,MAAM,CAAC,OAAO;SAC1B,CAAC,EACJ,WAAW,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAC7C,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;QAClB,OAAO,MAAM,CAAC;IAChB,CAAC;IAEO,KAAK,CAAC,gBAAgB,CAC5B,IAAc,EACd,KAAc,EACd,MAAmB;QAEnB,QAAQ,IAAI,CAAC,IAAI,EAAE,CAAC;YAClB,KAAK,WAAW;gBACd,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC5C,KAAK,YAAY;gBACf,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC7C,KAAK,aAAa;gBAChB,OAAO,IAAI,CAAC,UAAU,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YAC9C,KAAK,gBAAgB,CAAC;YACtB,KAAK,cAAc;gBACjB,OAAO,IAAI,CAAC,aAAa,CAAC,IAAI,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC;YACjD;gBACE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,CAAC;IACH,CAAC;IAEO,WAAW,CAAC,KAAa;QAC/B,OAAO,IAAI,CAAC,IAAI,KAAK,aAAa;YAChC,CAAC,CAAC,OAAO,CAAC,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;YAC5D,CAAC,CAAC,oBAAoB,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC;IAEO,KAAK,CAAC,aAAa,CACzB,IAAc,EACd,KAAc,EACd,MAAmB;QAEnB,MAAM,SAAS,GAAG,KAAK,IAAI,EAAE;YAC3B,IAAI,IAAI,CAAC,IAAI,KAAK,gBAAgB,EAAE,CAAC;gBACnC,MAAM,IAAI,GAAG,WAAW,CAAC,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;gBACjE,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAC/C,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;gBAC/C,OAAO,aAAa,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YAC3C,CAAC;YACD,MAAM,IAAI,GAAG,WAAW,CAAC,YAAY,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;YAC/D,MAAM,IAAI,GAAG,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YAC/C,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;YAC/C,OAAO,WAAW,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;QACzC,CAAC,CAAC;QACF,OAAO;YACL,OAAO,EAAE,kBAAkB,CACzB,MAAM,oBAAoB,CAAC,SAAS,EAAE,MAAM,CAAC,CAC9C;SACF,CAAC;IACJ,CAAC;IAEO,KAAK,CAAC,QAAQ,CACpB,IAAc,EACd,KAAc,EACd,MAAmB;QAEnB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3C,MAAM,cAAc,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,WAAW,CAAC,SAAS,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC5D,MAAM,IAAI,GAAG,MAAM,oBAAoB,CACrC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EACjC,MAAM,CACP,CAAC;QACF,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/C,IACE,IAAI,CAAC,IAAI,KAAK,aAAa;YAC3B,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,YAAY,EAC3C,CAAC;YACD,MAAM,OAAO,GAAG,MAAM,oBAAoB,CACxC,GAAG,EAAE,CACH,iBAAiB,CACf,IAAI,EACJ,IAAI,CAAC,IAAI,IAAI,CAAC,EACd,IAAI,CAAC,KAAK,IAAI,GAAG,EACjB,gBAAgB,EAChB,MAAM,CACP,EACH,MAAM,CACP,CAAC;YACF,OAAO,EAAE,OAAO,EAAE,kBAAkB,CAAC,OAAO,CAAC,EAAE,CAAC;QAClD,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CACzC,GAAG,EAAE,CACH,MAAM,CAAC,OAAO,CACZ,mBAAmB,EACnB;YACE,SAAS;YACT,IAAI;YACJ,IAAI,EAAE,IAAI,CAAC,IAAI,IAAI,CAAC;YACpB,KAAK,EAAE,IAAI,CAAC,KAAK,IAAI,GAAG;SACzB,EACD,cAAc,CACf,EACH,MAAM,CACP,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,kBAAkB,CAAC,QAAQ,CAAC,OAAO,CAAC,EAAE,CAAC;IAC3D,CAAC;IAEO,KAAK,CAAC,SAAS,CACrB,IAAc,EACd,KAAc,EACd,MAAmB;QAEnB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3C,MAAM,cAAc,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,WAAW,CAAC,UAAU,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,IAAI,GAAG,MAAM,oBAAoB,CACrC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EACjC,MAAM,CACP,CAAC;QACF,MAAM,IAAI,CAAC,iBAAiB,CAC1B,IAAI,EACJ,WAAW,CAAC,UAAU,CAAC,IAAI,EAC3B,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,EACjB,MAAM,CACP,CAAC;QACF,+EAA+E;QAC/E,MAAM,oBAAoB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;QACtE,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/C,IACE,IAAI,CAAC,IAAI,KAAK,aAAa;YAC3B,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,EAAE,aAAa,EAC5C,CAAC;YACD,MAAM,oBAAoB,CAAC,KAAK,IAAI,EAAE;gBACpC,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClC,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACpE,MAAM,CAAC,cAAc,EAAE,CAAC;gBACxB,MAAM,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBAClC,MAAM,kBAAkB,CAAC,IAAI,EAAE,IAAI,CAAC,OAAO,EAAE,MAAM,CAAC,CAAC;YACvD,CAAC,EAAE,MAAM,CAAC,CAAC;YACX,OAAO,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC;QACtC,CAAC;QACD,MAAM,oBAAoB,CACxB,GAAG,EAAE,CACH,MAAM,CAAC,OAAO,CACZ,oBAAoB,EACpB;YACE,SAAS;YACT,IAAI;YACJ,OAAO,EAAE,IAAI,CAAC,OAAO;SACtB,EACD,cAAc,CACf,EACH,MAAM,CACP,CAAC;QACF,OAAO,EAAE,OAAO,EAAE,SAAS,IAAI,EAAE,EAAE,CAAC;IACtC,CAAC;IAEO,KAAK,CAAC,UAAU,CACtB,IAAc,EACd,KAAc,EACd,MAAmB;QAEnB,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,CAAC,OAAO,CAAC;QAC3C,MAAM,cAAc,GAAG,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAAC;QACtD,MAAM,IAAI,GAAG,WAAW,CAAC,WAAW,CAAC,WAAW,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QAC9D,MAAM,UAAU,GAAG,MAAM,oBAAoB,CAC3C,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,EACvC,MAAM,CACP,CAAC;QACF,MAAM,IAAI,CAAC,iBAAiB,CAC1B,IAAI,EACJ,WAAW,CAAC,WAAW,CAAC,IAAI,EAC5B,EAAE,GAAG,IAAI,EAAE,GAAG,EAAE,UAAU,EAAE,EAC5B,MAAM,CACP,CAAC;QACF,MAAM,oBAAoB,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,MAAM,CAAC,CAAC;QAC5E,MAAM,IAAI,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,MAAM,CAAC,CAAC;QAC/C,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,IAAI,IAAI,CAAC,IAAI,KAAK,aAAa,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,QAAQ,EAAE,CAAC;YACvE,MAAM,MAAM,GAAG,MAAM,eAAe,CAClC,IAAI,CAAC,OAAO,EACZ,IAAI,CAAC,IAAI,EACT,UAAU,EACV,gBAAgB,EAChB,MAAM,CACP,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,kBAAkB,CACzB,GAAG,MAAM,CAAC,MAAM,gBAAgB,MAAM,CAAC,QAAQ,IAAI,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAC5G;gBACD,OAAO,EAAE,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,MAAM,CAAC,QAAQ,KAAK,CAAC;aACzD,CAAC;QACJ,CAAC;QACD,gFAAgF;QAChF,MAAM,QAAQ,GAAG,MAAM,CAAC,OAAO,CAAC,iBAAiB,EAAE;YACjD,SAAS;YACT,OAAO,EAAE,IAAI,CAAC,OAAO;YACrB,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,GAAG,EAAE,UAAU;YACf,eAAe,EAAE,yBAAyB;SAC3C,CAAC,CAAC;QACH,IAAI,UAA8B,CAAC;QACnC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;YACpE,UAAU,GAAG,QAAQ,CAAC,UAAU,CAAC;YACjC,MAAM,cAAc,GAAG,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,UAAU,EAAE,CAAC;YACtE,MAAM,IAAI,GAAG,MAAM,oBAAoB,CACrC,GAAG,EAAE,CACH,MAAM,CAAC,OAAO,CACZ,wBAAwB,EACxB,cAAc,EACd,cAAc,CACf,EACH,MAAM,CACP,CAAC;YACF,MAAM,MAAM,GAAG,MAAM,oBAAoB,CACvC,GAAG,EAAE,CACH,MAAM,CAAC,OAAO,CACZ,iBAAiB,EACjB,cAAc,EACd,cAAc,CACf,EACH,MAAM,CACP,CAAC;YACF,OAAO;gBACL,OAAO,EAAE,kBAAkB,CACzB,GAAG,MAAM,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,+BAA+B,CAAC,CAAC,CAAC,EAAE,gBAAgB,IAAI,CAAC,QAAQ,IAAI,SAAS,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAChK;gBACD,OAAO,EAAE,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,IAAI,CAAC,QAAQ,KAAK,CAAC;aACrD,CAAC;QACJ,CAAC;gBAAS,CAAC;YACT,IAAI,UAAU,EAAE,CAAC;gBACf,MAAM,IAAI,CAAC,eAAe,CAAC,UAAU,CAAC,CAAC;YACzC,CAAC;iBAAM,CAAC;gBACN,kFAAkF;gBAClF,KAAK,QAAQ;qBACV,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,IAAI,CAAC,eAAe,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC;qBAC7D,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACrB,CAAC;QACH,CAAC;IACH,CAAC;IAEO,KAAK,CAAC,iBAAiB,CAC7B,IAAc,EACd,IAAc,EACd,KAAc,EACd,MAAmB;QAEnB,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,IACE,IAAI,CAAC,IAAI,KAAK,aAAa;YAC3B,CAAC,IAAI,CAAC,IAAI,KAAK,cAAc,IAAI,IAAI,CAAC,IAAI,KAAK,YAAY,CAAC,EAC5D,CAAC;YACD,OAAO;QACT,CAAC;QACD,MAAM,UAAU,GAAG,KAKlB,CAAC;QACF,MAAM,QAAQ,GAAG,IAAI,CAAC,SAAS,CAC7B,IAAI,CAAC,IAAI,KAAK,YAAY;YACxB,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC;YAC9B,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,CAAC,OAAO,EAAE,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,GAAG,CAAC,CACrE,CAAC;QACF,IAAI,IAAI,CAAC,IAAI,KAAK,MAAM,IAAI,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,EAAE,CAAC;YAChE,OAAO;QACT,CAAC;QACD,MAAM,QAAQ,GAAG,MAAM,oBAAoB,CACzC,GAAG,EAAE,CACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CACzB,4BAA4B,EAC5B;YACE,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,QAAQ,EAAE;gBACR,UAAU,EAAE,IAAI,CAAC,EAAE;gBACnB,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,IAAI;gBACJ,MAAM,EAAE,SAAS;gBACjB,QAAQ,EAAE,KAAK;aAChB;YACD,OAAO,EAAE;gBACP,GAAG,CAAC,IAAI,CAAC,IAAI,KAAK,MAAM;oBACtB,CAAC,CAAC;wBACE;4BACE,QAAQ,EAAE,eAAe;4BACzB,IAAI,EACF,IAAI,CAAC,IAAI,KAAK,YAAY;gCACxB,CAAC,CAAC,4CAA4C;gCAC9C,CAAC,CAAC,2CAA2C;4BACjD,IAAI,EAAE,cAAuB;yBAC9B;qBACF;oBACH,CAAC,CAAC,EAAE,CAAC;gBACP;oBACE,QAAQ,EAAE,YAAY;oBACtB,IAAI,EAAE,YAAY;oBAClB,IAAI,EAAE,YAAY;iBACnB;gBACD,EAAE,QAAQ,EAAE,aAAa,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE;aACjE;SACF,EACD,EAAE,kBAAkB,EAAE,MAAM,EAAE,CAC/B,EACH,MAAM,CACP,CAAC;QACF,MAAM,CAAC,cAAc,EAAE,CAAC;QACxB,IACE,IAAI,CAAC,IAAI,KAAK,MAAM;YACpB,QAAQ,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU;YACvC,QAAQ,CAAC,OAAO,CAAC,QAAQ,KAAK,eAAe,EAC7C,CAAC;YACD,IAAI,CAAC,gBAAgB,CAAC,GAAG,CAAC,QAAQ,CAAC,CAAC;YACpC,OAAO;QACT,CAAC;QACD,IACE,QAAQ,CAAC,OAAO,CAAC,OAAO,KAAK,UAAU;YACvC,QAAQ,CAAC,OAAO,CAAC,QAAQ,KAAK,YAAY,EAC1C,CAAC;YACD,MAAM,IAAI,KAAK,CAAC,mBAAmB,CAAC,CAAC;QACvC,CAAC;QACD,MAAM,CAAC,cAAc,EAAE,CAAC;IAC1B,CAAC;IAEO,kBAAkB,CACxB,UAAkB,EAClB,MAAmB;QAEnB,OAAO,oBAAoB,CACzB,GAAG,EAAE,CACH,IAAI,CAAC,gBAAgB,CAAC;YACpB,aAAa,EAAE,kBAAkB;YACjC,UAAU;YACV,MAAM,EAAE,aAAa;SACtB,CAAC,EACJ,MAAM,CACP,CAAC;IACJ,CAAC;IAEO,gBAAgB,CAAC,MAAqB;QAC5C,OAAO,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,gBAAgB,EAAE;YAClD,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,MAAM;SACP,CAAC,CAAC;IACL,CAAC;IAEO,KAAK,CAAC,eAAe,CAAC,UAAkB;QAC9C,oFAAoF;QACpF,MAAM,oBAAoB,CACxB,GAAG,EAAE,CACH,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,OAAO,CAAC,kBAAkB,EAAE;YAC9C,SAAS,EAAE,IAAI,CAAC,OAAO,CAAC,SAAS;YACjC,UAAU;SACX,CAAC,EACJ,WAAW,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAC7C,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACpB,CAAC;CACF"}
+{"version":3,"file":"runner.js","sourceRoot":"","sources":["../../src/tools/runner.ts"],"names":[],"mappings":"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"}

package/docs/architecture.md

@@ -53,7 +53,7 @@ flowchart LR
 
 The model catalog is a snapshot taken when the session is created. Start a new session to refresh it. A model change during an active turn takes effect on the next prompt. History stays in the session when switching models; there is no per-model history reset.
 
-The initial mode comes from `--mode` (default `manual`). Changing the mode aborts the active turn and clears remembered permission grants. Each session owns its mode and grants independently. There is no tool for the model to change its own mode.
+Each session starts in `manual` (Ask permission); the editor selects another mode through ACP. Changing the mode aborts the active turn and clears remembered permission grants. Each session owns its mode and grants independently. There is no tool for the model to change its own mode.
 
 There is no persisted session store, session reload/resume, image/audio processing, MCP execution, or interactive credential login. Text resource contents are embedded in the prompt. A resource link contributes its name and URI, not automatically retrieved file contents.
 

package/docs/capabilities.md

@@ -8,7 +8,7 @@ This guide describes the behavior implemented by acp-port. The available editor
 
 The editor launches the agent, initializes the ACP connection, and creates a session with an absolute workspace directory. acp-port checks that this directory exists locally and resolves its real path. The editor and agent must see the same workspace paths.
 
-During initialization, the editor advertises file-read, file-write, and terminal capabilities. Outside plan mode, all five tools are available even when those capabilities are absent: the agent can use local files and processes. Plan mode offers only reading, listing, and searching. `--no-tools` disables every tool regardless of the session mode and cannot be combined with `--mode full-access` at startup.
+During initialization, the editor advertises file-read, file-write, and terminal capabilities. Outside plan mode, all five tools are available even when those capabilities are absent: the agent can use local files and processes. Plan mode offers only reading, listing, and searching. `--no-tools` disables every tool regardless of the session mode.
 
 Outside full access, available file reads and writes prefer the corresponding ACP capability, including unsaved editor state where supported, and use saved local files when that capability is absent. An ACP error is not retried against disk. Directory listings and searches always use local files. In full access, file operations and commands all run locally; save pending editor changes first. See the [ACP file-system specification](https://agentclientprotocol.com/protocol/v1/file-system).
 
@@ -24,15 +24,15 @@ Outside full access, available file reads and writes prefer the corresponding AC
 
 ### Permission modes
 
-Use `--mode MODE` to choose the initial mode, or select a mode using the editor's ACP mode/configuration control:
+Every new session starts in **Ask permission** (`manual`). Use the editor's **Permission mode** control to choose a policy for that session. Display labels describe the policy; protocol IDs are:
 
-| Mode | File writes | Commands | File paths and command working directories |
-| --- | --- | --- | --- |
-| `manual` (default) | Ask each time | Ask each time | Session workspace |
-| `accept-edits` | Automatically allowed | Ask each time | Session workspace |
-| `plan` | Unavailable | Unavailable | Session workspace |
-| `auto` | Ask; optionally remember approval for the same path | Ask; optionally remember approval for the exact executable, arguments, and working directory | Session workspace |
-| `full-access` | Automatically allowed, locally | Automatically allowed, locally | Any path accessible to the agent process |
+| Mode ID | Editor label | File writes | Commands | File paths and command working directories |
+| --- | --- | --- | --- | --- |
+| `manual` (default) | Ask permission | Ask each time | Ask each time | Session workspace |
+| `accept-edits` | Accept edits | Automatically allowed | Ask each time | Session workspace |
+| `plan` | Plan | Unavailable | Unavailable | Session workspace |
+| `auto` | Ask and remember | Ask; optionally remember approval for the same path | Ask; optionally remember approval for the exact executable, arguments, and working directory | Session workspace |
+| `full-access` | Full access | Automatically allowed, locally | Automatically allowed, locally | Any path accessible to the agent process |
 
 Reads, directory listings, and searches do not request per-action permission. Auto mode remembers only an explicit **Allow … for this session** choice; **Allow once** stays a one-time decision. Remembered permissions belong to one session and are cleared when its mode changes or the process ends. Auto is an approval-memory policy, not an AI risk classifier. Workspace path checks do not sandbox commands: even a command with a workspace working directory can access resources elsewhere with the process's OS permissions.
 
@@ -72,7 +72,11 @@ The ACP runner requests a terminal and releases it after collecting its output.
 
 ### Permissions and failure handling
 
-Manual-mode writes and commands offer `Allow once` and `Reject` via `session/request_permission`. Auto mode additionally offers a scoped session approval. Rejection, cancellation, or an invalid response prevents execution. Accept-edits skips write approvals, and full access skips all per-action approvals. The CLI mode initializes each new session; editor mode changes affect only the selected session. OS permissions are unchanged.
+Ask permission (`manual`) writes and commands offer `Allow once` and `Reject` via `session/request_permission`. Ask and remember (`auto`) additionally offers a scoped session approval. Rejection, cancellation, or an invalid response prevents execution. Accept-edits skips write approvals, and full access skips all per-action approvals. Every session starts in Ask permission; editor mode changes affect only the selected session. OS permissions are unchanged.
+
+Permission requests carry a readable operation title, the `edit` or `execute` tool kind, and structured validated input. Writes include the absolute target path, a file location for navigation, and a bounded preview of the complete proposed contents. Commands describe the executable, separate arguments, and absolute working directory. Both identify whether execution uses the editor or the local agent process. The preview is not a diff or a merge; the full structured write input remains available to the client.
+
+Permission requests work even when the editor does not advertise file or terminal capabilities: approval happens before local fallback execution. No separate permission capability is required. The editor chooses how to render the request and may automatically allow or reject it according to its own settings, as permitted by [ACP](https://agentclientprotocol.com/protocol/v1/tool-calls#requesting-permission). Private client settings are not a policy that acp-port can discover; clients control the agent through a session mode change or a permission response.
 
 The tool timeout starts before validation and the permission exchange. Waiting for approval uses that budget. Tool failures and denials are returned to the model, which may explain the issue or choose another action. Pending, in-progress, completed, and failed tool updates are sent to the editor as appropriate.
 
@@ -94,7 +98,7 @@ The agent does not automatically index your repository, attach every file, load
 
 Each session has its own model catalog, selected model, history, and cancellation controller. Discovery runs on session creation. The catalog remains fixed for that session; start a new session to see newly available models.
 
-ACP configuration options expose `model` and `mode` through `session/set_config_option`. Compatibility handlers also accept `session/set_model` and `session/set_mode`, and session creation advertises legacy `modes` for older editors. There are no runtime temperature controls. Editors that do not render the mode selector can use the CLI's `--mode` setting.
+ACP configuration options expose `model` and the **Permission mode** option (`id: "mode"`, `category: "mode"`) through `session/set_config_option`. Compatibility handlers also accept `session/set_model` and `session/set_mode`, and session creation advertises legacy `modes` for older editors. Both mode APIs update the same policy and publish synchronized state. This follows [ACP's session configuration specification](https://agentclientprotocol.com/protocol/v1/session-config-options); exact labels and placement depend on the editor. There are no runtime temperature controls. Editors that do not render the mode selector keep the Ask permission default.
 
 Changing the selected model preserves the conversation history. If a prompt is already running, it completes with the model selected at its start; the new model applies on the next prompt. Choose a new session when you want a fresh conversation or a refreshed catalog.
 

package/docs/configuration.md

@@ -32,7 +32,7 @@ npx -y acp-port serve --base-url http://127.0.0.1:1234/v1 --default-model MODEL_
 
 ## All CLI options
 
-Connection options apply to both `serve` and `models`. `--mode` is only valid when serving an agent.
+Connection options apply to both `serve` and `models`.
 
 | Option | Default | Meaning |
 | --- | --- | --- |
@@ -42,7 +42,6 @@ Connection options apply to both `serve` and `models`. `--mode` is only valid wh
 | `--name NAME` | `endpoint` | Sets the endpoint display name used in model labels. It does not change model IDs. |
 | `--no-discovery` | Discovery enabled | Skips model-list requests. Requires `--default-model`. |
 | `--no-tools` | Tools enabled | Omits file and terminal tools from model requests. Responses remain text-only. |
-| `--mode MODE` | `manual` | Initial session mode: `manual`, `accept-edits`, `plan`, `auto`, or `full-access`. Valid only with `serve`. Full access cannot be combined with `--no-tools`. Modes do not grant OS privileges or remove resource limits. See [permission modes](capabilities.md#permission-modes). |
 | `--json` | Plain text | Outputs the model catalog as JSON. Valid only with `models`. |
 | `--help`, `-h` | — | Prints help. |
 | `--version` | — | Prints the version. |
@@ -57,6 +56,22 @@ The URL must use HTTP or HTTPS and cannot include embedded credentials, a query
 
 There are no CLI flags for timeout, system prompt, temperature, token limits, custom headers, or multiple endpoints. Unknown commands/options are rejected rather than ignored.
 
+## Permission mode selection
+
+Every new session starts in **Ask permission** (`manual`). Select permission modes through the editor's ACP controls. The **Permission mode** selector advertises these IDs and labels:
+
+| Protocol ID | Display label | Policy |
+| --- | --- | --- |
+| `manual` | Ask permission | Default; request permission for every file write and command. |
+| `accept-edits` | Accept edits | Allow workspace file writes; ask before commands. |
+| `plan` | Plan | Read, list, and search without writes or commands. |
+| `auto` | Ask and remember | Ask for new actions; optionally remember an explicitly approved file or exact command for the session. |
+| `full-access` | Full access | Run tools locally without per-action approval or workspace path restrictions. |
+
+The editor changes the `mode` configuration option using `session/set_config_option`, or legacy `session/set_mode`. Both APIs control the same policy. Changing the mode cancels the active turn and clears remembered approvals; it does not undo completed actions. Clients that do not offer a mode selector keep the Ask permission default.
+
+When a policy requires approval, acp-port sends the requested operation and its details through `session/request_permission`, even if the operation will run locally. The editor renders or answers the request according to its settings. acp-port cannot infer private editor settings that are not communicated through ACP. See [editor integration](editor-integration.md#choose-permissions-in-the-editor) for permission controls and checks.
+
 ## Credentials and environment
 
 Every CLI adapter reads **`API_KEY`** from the ACP Port process environment:
@@ -165,4 +180,6 @@ The history budget is a character guard, not a tokenizer or a model-context guar
 
 `acp-port.json`, the former default config location, and `ACP_PORT_CONFIG` are not read. Existing files are left untouched. Replace saved-provider commands with one complete editor entry per endpoint.
 
-Removed commands include `init`, `providers`, `provider`, `backends`, `backend`, and `registry`. Removed flags include `--config`, `--type`, `--backend`, `--preset`, `--model`, `--registry`, `--command`, `--arg`, `--unset-env`, and `--api-key-env`. Use `--provider`, `--base-url`, `--default-model`, and the editor's `env` instead. ACP Port does not launch or manage external agent CLIs.
+Removed commands include `init`, `providers`, `provider`, `backends`, `backend`, and `registry`. Removed flags include `--config`, `--type`, `--backend`, `--preset`, `--model`, `--registry`, `--command`, `--arg`, `--unset-env`, `--api-key-env`, and `--mode`. Use `--provider`, `--base-url`, `--default-model`, and the editor's `env` instead. ACP Port does not launch or manage external agent CLIs.
+
+Remove `--mode` and its value from existing editor launch arguments. Select the permission mode through the editor's ACP controls after creating a session.

package/docs/editor-integration.md

@@ -80,9 +80,9 @@ In the **local Air app**, open the task toolbar's agent selector and choose **Ad
 
 Air's documented format uses `command`, `args`, and `env`; Zed's `type: "custom"` field is omitted here. Add another named entry to connect an additional endpoint.
 
-acp-port authenticates with the endpoint using `API_KEY`. It does not expose a browser login, reuse the accounts of Air's built-in agents, or implement Air permission modes. Custom agents registered through local `acp.json` are unavailable in Air Teams cloud tasks; see [Air's supported agents](https://www.jetbrains.com/help/air/supported-agents.html).
+acp-port authenticates with the endpoint using `API_KEY`. It does not expose a browser login or reuse the accounts of Air's built-in agents. Its permission policy is available through standard ACP configuration options and legacy session modes, so the editor can change it per session. Air documents a permission selector that maps agents' modes to its common choices; names and presentation depend on the client version. See [Air's permission modes](https://www.jetbrains.com/help/air/permission-modes.html). Custom agents registered through local `acp.json` are unavailable in Air Teams cloud tasks; see [Air's supported agents](https://www.jetbrains.com/help/air/supported-agents.html).
 
-When Air does not advertise ACP file access, acp-port reads and writes saved files directly in the task workspace. By default, writes still request permission through Air. Use the editor-independent [full-access option](#full-access-in-any-editor) to enable local commands and skip per-action approvals. Save pending editor changes first. MCP forwarding is not required for these tools.
+When Air does not advertise ACP file or terminal access, acp-port uses saved files and local processes in the task workspace. By default, writes and commands still request permission through Air. Select [Ask permission](#choose-permissions-in-the-editor) to keep those approvals, or [full access](#full-access-in-any-editor) to skip them. Save pending editor changes before using local file tools. MCP forwarding is not required for these tools.
 
 ### JetBrains IDEs with AI Assistant
 
@@ -162,23 +162,23 @@ After editing launch options, credentials, or the pinned package version, ensure
 
 ## Files, commands, and permissions
 
-### Full access in any editor
+### Choose permissions in the editor
 
-Append the two elements `"--mode", "full-access"` to the existing acp-port `args` array and restart its process. Keep the endpoint, model, and environment settings. For example:
+Every new session starts in **Ask permission** (`manual`): file writes and commands require an ACP permission decision. Launch arguments configure the model connection; permission modes are selected through ACP.
 
-```json
-{
-  "command": "npx",
-  "args": ["-y", "acp-port", "--mode", "full-access", "--base-url", "http://127.0.0.1:1234/v1"],
-  "env": { "API_KEY": "" }
-}
-```
+Supporting editors expose a **Permission mode** selector. Choose **Ask permission**, **Accept edits**, **Plan**, **Ask and remember**, or **Full access**; see the [mode table](capabilities.md#permission-modes) for their scope. The protocol IDs are `manual`, `accept-edits`, `plan`, `auto`, and `full-access`.
 
-This is the launch object to place inside the agent registration used by your editor. It works with Air, Zed, JetBrains IDEs, and any other ACP client without checking the client name. All five tools (`read_file`, `write_file`, `list_directory`, `search_files`, `run_command`) run locally without per-action approvals or workspace path restrictions. OS permissions, timeouts, output limits, and cancellation still apply. Save editor buffers before using local file tools. Do not combine this option with `--no-tools`. It does not enable MCP support.
+acp-port advertises a `category: "mode"` configuration option and legacy session modes. Editors change the policy through `session/set_config_option` or `session/set_mode`; both stay synchronized. Changing mode cancels the active turn and clears remembered approvals. Editors that do not display these selectors keep the Ask permission default. These are standard [ACP session configuration options](https://agentclientprotocol.com/protocol/v1/session-config-options).
+
+Approval requests identify the operation in a readable title and its kind (`edit` or `execute`). File writes include the absolute target path and a bounded preview of the complete intended contents. Commands include the executable, separate arguments, and absolute working directory. The request also says whether execution will use the editor or the local agent process. The full validated input remains available as structured tool input; the client decides how much detail to show.
+
+**Allow once** authorizes that operation and **Reject** prevents it. **Ask and remember** (`auto`) additionally offers an explicit allowance for writes to that file or that exact command for the session. ACP permits editors to answer automatically according to user settings, so a request does not guarantee a visible dialog. acp-port cannot infer a client's private permission settings: the client must send a mode change or return a decision to the [ACP permission request](https://agentclientprotocol.com/protocol/v1/tool-calls#requesting-permission).
+
+### Full access in any editor
 
-Other initial modes are `manual` (the default), `accept-edits`, `plan`, and `auto`; see the [mode table](capabilities.md#permission-modes). Supporting editors display a Mode selector using ACP configuration options or legacy session modes. Selecting a different mode cancels the active turn and clears its remembered approvals. The mode is per session, and no editor-specific configuration is required.
+Select **Full access** in the editor's ACP permission mode selector. All five tools (`read_file`, `write_file`, `list_directory`, `search_files`, `run_command`) then run locally without per-action approvals or workspace path restrictions. OS permissions, timeouts, output limits, and cancellation still apply. Save editor buffers before using local file tools. `--no-tools` still disables all tools in this mode.
 
-For a source checkout, launch the built Node entry point as described in [Contributing](../CONTRIBUTING.md) and add the same flag. A published npx release does not include uncommitted local changes.
+Select **Ask permission** again to restore write and command approvals for that session. A new session always starts in Ask permission.
 
 ### Default permissions
 
@@ -193,7 +193,7 @@ The editor supplies the session's workspace directory and advertises the tools i
 
 All five tools can work without editor file or terminal capabilities. Plan mode exposes only read, listing, and search tools. Add `--no-tools` for a chat-only model or to disable every tool, including local access. A model that supports tools is still necessary for reliable file and command use.
 
-Manual mode requests permission on every write and command; accept-edits automatically allows writes; auto can remember an explicitly approved file or exact command for that session; full access skips approvals. The editor controls the presentation of permission requests. Its own permission settings are distinct from acp-port's session mode.
+Ask permission (`manual`) requests permission on every write and command; accept-edits automatically allows writes; Ask and remember (`auto`) can remember an explicitly approved file or exact command for that session; full access skips approvals. The editor controls the presentation of permission requests and may answer according to its own settings.
 
 Outside full access, file paths and the requested command working directory must stay within the workspace, including resolved symlinks. This is path validation, not an operating-system sandbox: an approved executable can access other locations permitted by the execution process's OS permissions. Commands use an executable plus arguments without an automatic shell. See [capabilities and limits](capabilities.md) for the full behavior.
 
@@ -221,7 +221,9 @@ These are requirements of the implementation, not a guarantee of remote support
 1. Start a new thread or task using your acp-port entry.
 2. Confirm that the intended model is selected, then send a short text prompt.
 3. With a tool-capable model, ask it to read a known small workspace file.
-4. In manual mode, check permissions by asking it to create a disposable file and rejecting the request. Confirm the file was not written; retry and allow it only if you want to test writing.
+4. Check that a new session starts in **Ask permission**. Select **Full access**, then switch back to **Ask permission** before sending the next prompt to verify that the editor controls the policy.
+5. Ask it to create a disposable file. Check that the request identifies its path and intended contents, reject it, and confirm the file was not written. Retry and allow it only if you want to test writing.
+6. Ask it to run a harmless command and check the executable, arguments, working directory, and execution location in the permission request. Reject it and confirm that execution did not start. If the editor answers automatically, check its permission settings or ACP logs.
 
 This separates process startup, inference, editor capabilities, and permissions. Successful `models` output alone does not verify all four.
 

package/docs/providers.md

@@ -1,6 +1,6 @@
 # Providers and endpoint setup
 
-ACP Port connects an ACP editor to an LLM HTTP API. A **provider type** selects the protocol adapter; an **endpoint** is the server URL using that protocol. For example, LM Studio, Ollama, OpenRouter, and a LiteLLM gateway all use the `openai` adapter when serving OpenAI-compatible Chat Completions.
+ACP Port connects an ACP editor to an LLM HTTP API. A **provider type** selects the protocol adapter; an **endpoint** is the server URL using that protocol. For example, llama.cpp, LM Studio, Ollama, OpenRouter, and a LiteLLM gateway all use the `openai` adapter when serving OpenAI-compatible Chat Completions.
 
 Each CLI launch uses one endpoint. Add separate entries in your editor for local models, a gateway, and hosted providers. See [Editor integration](editor-integration.md) for complete JSON examples and [Configuration](configuration.md) for every option.
 
@@ -10,6 +10,7 @@ Examples use `npx -y acp-port`; see the [README quick start](../README.md#quick-
 
 | Endpoint | Adapter | API base URL | Credential |
 | --- | --- | --- | --- |
+| llama.cpp | `openai` | `http://127.0.0.1:8080/v1` for port 8080 | None unless authentication is enabled |
 | LM Studio | `openai` | `http://127.0.0.1:1234/v1` for the usual port | None unless authentication is enabled |
 | Local Ollama | `openai` | `http://127.0.0.1:11434/v1` | None for the usual local server |
 | OpenAI | `openai` | `https://api.openai.com/v1` (default) | OpenAI API key in `API_KEY` |
@@ -31,6 +32,42 @@ These are configuration recipes, not a claim that every model or deployment has
 
 `--default-model` takes the upstream ID, including slashes, without ACP Port's `endpoint/` prefix. For example, use `vendor/model`, not `endpoint/vendor/model`. Model names and account availability change; use the endpoint's current catalog rather than assuming a model in a tutorial is available.
 
+## llama.cpp
+
+Start `llama-server` with a chat model and a stable API alias. For file and terminal tools, enable Jinja and use a model with a tool-compatible chat template. Some models require a matching `--chat-template-file`; see the official [server documentation](https://github.com/ggml-org/llama.cpp/blob/master/tools/server/README.md) and [function-calling guide](https://github.com/ggml-org/llama.cpp/blob/master/docs/function-calling.md).
+
+```sh
+llama-server -m /path/to/model.gguf --alias local-model \
+  --host 127.0.0.1 --port 8080 --jinja
+```
+
+Replace the model path, wait for loading to finish, then check discovery:
+
+```sh
+API_KEY='' npx -y acp-port models \
+  --base-url http://127.0.0.1:8080/v1 --json
+```
+
+Configure your editor's custom ACP entry with these launch fields; see the [editor guide](editor-integration.md) for the surrounding Zed or JetBrains configuration:
+
+```json
+{
+  "command": "npx",
+  "args": [
+    "-y", "acp-port",
+    "--provider", "openai",
+    "--base-url", "http://127.0.0.1:8080/v1",
+    "--default-model", "local-model",
+    "--name", "llama.cpp"
+  ],
+  "env": { "API_KEY": "" }
+}
+```
+
+Use the alias from `--alias`, or an upstream `modelId` returned by discovery. The base URL ends in `/v1`, not `/chat/completions`. If server authentication is enabled, set its token in `API_KEY`.
+
+ACP Port sends tools by default, even for a short text prompt. If llama.cpp rejects tools or the chat template, fix the server/model configuration or deliberately use `--no-tools` for text-only chat. ACP Port does not disable tools automatically. See [troubleshooting](troubleshooting.md#llamacpp-accepts-discovery-but-rejects-prompts) for the corresponding editor diagnostics.
+
 ## LM Studio
 
 Install LM Studio, download a suitable model, and make it available to the local server. Start the API server in the **Developer** tab, or run `lms server start` if its CLI is installed. LM Studio documents the OpenAI-compatible base at port `1234`; adjust the port to match your server. [Server setup](https://lmstudio.ai/docs/developer/core/server), [OpenAI compatibility](https://lmstudio.ai/docs/developer/openai-compat).

package/docs/releases.md

@@ -8,6 +8,8 @@ Both Node.js 22 and 24 jobs install with pnpm 12.8.1 and `pnpm install --frozen-
 
 Project pnpm settings live in `pnpm-workspace.yaml`. The npm release plugin invokes the npm CLI for versioning and registry publication; its CI step sets `NPM_CONFIG_PACKAGE_LOCK=false` so it does not generate an npm lockfile. The project uses only `pnpm-lock.yaml` and does not need a committed `.npmrc`.
 
+The release plugins require Node.js 22.22.2 or later in the 22.x line, or 24.15.0 or later. Keep `conventional-changelog-conventionalcommits` on 9.x while semantic-release uses `@semantic-release/release-notes-generator` 14.x and `conventional-changelog-writer` 8.x: preset 10.x replaces its templates with render functions and requires the newer writer. See the [preset's breaking changes](https://github.com/conventional-changelog/conventional-changelog/blob/master/packages/conventional-changelog-conventionalcommits/CHANGELOG.md#1000-2026-06-26).
+
 Dependabot updates the GitHub Actions pins weekly. Package dependency updates are not scheduled through Dependabot because its [pnpm 12 multi-document lockfile issue](https://github.com/dependabot/dependabot-core/issues/15904) remains open and GitHub's [supported versions](https://docs.github.com/en/code-security/reference/supply-chain-security/supported-ecosystems-and-repositories) currently list pnpm through v10. Update package dependencies with pnpm and commit both the manifest and lockfile changes until this format is supported.
 
 After both check jobs succeed, semantic-release analyzes commits since the last release tag. When those commits warrant a release, it:
@@ -68,7 +70,7 @@ For an existing package that you maintain, configure npm trusted publishing in t
 
 The filename is `ci.yml`, without `.github/workflows/`. The release job has no GitHub environment. Direct publishing must be allowed: stage-only permission would require manual promotion and does not match this automatic pipeline. OIDC publishes from a public repository generate npm provenance automatically. See [npm's trusted publishing setup](https://docs.npmjs.com/trusted-publishers/).
 
-The initial release of this project is **0.1.0**, already set in `package.json`. semantic-release does not support configuring a first release below 1.0.0. Publish 0.1.0 once from a maintainer's local checkout, then tag that published commit so subsequent automated releases have a baseline. Without that tag, the first qualifying workflow release would be **1.0.0**. See the [semantic-release initial version policy](https://semantic-release.org/support/faq/#can-i-set-the-initial-release-version-of-my-package-to-001).
+The initial release of this project is **0.2.0**, already set in `package.json`. semantic-release does not support configuring a first release below 1.0.0. Publish 0.2.0 once from a maintainer's local checkout, then tag that published commit so subsequent automated releases have a baseline. Without that tag, the first qualifying workflow release would be **1.0.0**. See the [semantic-release initial version policy](https://semantic-release.org/support/faq/#can-i-set-the-initial-release-version-of-my-package-to-001).
 
 Before the first publication, record the initial changes in `CHANGELOG.md`, review and commit the source on the default branch, and push it with `[skip ci]` in the commit message to avoid starting a release before the baseline exists. The repository currently uses `master`:
 
@@ -89,16 +91,16 @@ pnpm publish --access public
 After publication succeeds, verify the registry version, then create and push the tag on that same commit:
 
 ```sh
-npm view acp-port@0.1.0 version --registry=https://registry.npmjs.org
-git tag v0.1.0
-git push origin v0.1.0
+npm view acp-port@0.2.0 version --registry=https://registry.npmjs.org
+git tag v0.2.0
+git push origin v0.2.0
 ```
 
-Do not tag a failed publication or change the source between publishing and tagging. Create the initial GitHub Release from `v0.1.0` if desired; subsequent GitHub Releases and changelog entries are automatic.
+Do not tag a failed publication or change the source between publishing and tagging. Create the initial GitHub Release from `v0.2.0` if desired; subsequent GitHub Releases and changelog entries are automatic.
 
 Once the package exists, configure the trusted publisher above before merging another release-worthy commit. If a GitHub `NPM_TOKEN` secret was added earlier, remove it and revoke the token. Granular-token direct publication is being removed in January 2027; the workflow's optional token fallback is unnecessary for the recommended OIDC path. A stage-only token would require a different workflow and manual approval. See [npm's token deprecation notice](https://docs.npmjs.com/about-access-tokens/#direct-publishing-is-being-deprecated).
 
-With `v0.1.0` in the default branch's history, a `fix:` release becomes **0.1.1**, a `feat:` release becomes **0.2.0**, and a breaking change becomes **1.0.0** under the current rules. semantic-release does not apply special version-zero breaking-change rules. Verify a subsequent OIDC release. After it works, npm's publishing settings can disallow traditional tokens. Keep the README's initial release-status note accurate only after publication is verified.
+With `v0.2.0` in the default branch's history, a `fix:` release becomes **0.2.1**, a `feat:` release becomes **0.3.0**, and a breaking change becomes **1.0.0** under the current rules. semantic-release does not apply special version-zero breaking-change rules. Verify a subsequent OIDC release. After it works, npm's publishing settings can disallow traditional tokens. Keep the README's initial release-status note accurate only after publication is verified.
 
 ## Preview and verify a release
 

package/docs/troubleshooting.md

@@ -4,6 +4,16 @@
 
 Start by identifying the failing boundary: resolving the npm package, launching the agent, discovering models, creating an ACP session, making an inference request, or executing an editor tool. Model discovery and inference are separate operations; success at one does not prove the other works.
 
+## Where errors appear in the editor
+
+When a prompt fails, ACP Port sends an **acp-port error** message to the conversation before returning the failed request. Editors that advertise ACP session notices also receive an error notice; its placement depends on the editor. The conversation message uses the same standard ACP text updates as model responses, so notice support is optional. Cancellation does not produce a failure message.
+
+If discovery leaves no usable model, the session-creation error includes the discovery diagnosis. If `--default-model` allows the session to continue after discovery fails, the warning appears on the first prompt, as a notice when supported or a conversation message otherwise. Launch failures that occur before an ACP session exists still require the editor's agent logs or a terminal check.
+
+Provider diagnostics include HTTP status when available and specific guidance for recognized authentication, connection, timeout, model, context-size, and chat-template failures. Raw response bodies, prompts, and API keys are not copied into these messages. Unrecognized failures retain general guidance to check the server logs.
+
+If a request fails or is cancelled before any answer or tool activity, its prompt is removed from the model history so retrying does not produce consecutive user messages that strict chat templates reject. Partial answers and tool activity remain in history.
+
 ## Establish a working baseline
 
 Run these commands in a terminal with Node.js 22.12 or later and npm/npx installed. No repository checkout is needed for a published release; see the [quick start](../README.md#quick-start) for release availability.
@@ -41,7 +51,7 @@ For source development, follow [CONTRIBUTING.md](../CONTRIBUTING.md). A publishe
 
 Check the server is running, its API base URL is correct, and the runtime hosting acp-port can reach it. The base URL is the API root, such as `http://127.0.0.1:1234/v1`, not a full `/chat/completions` URL. Anthropic's default root is `https://api.anthropic.com`; use the root expected by the native Messages API adapter.
 
-For a local server, ensure a model is downloaded and available through that server's API. For a gateway, verify that the supplied key can list models and that the gateway exposes a compatible model-list route. Discovery has a maximum 10-second budget and reports a generic warning instead of a raw API response.
+For a local server, ensure a model is downloaded and available through that server's API. For a gateway, verify that the supplied key can list models and that the gateway exposes a compatible model-list route. Discovery has a maximum 10-second budget and reports a categorized diagnostic instead of a raw API response.
 
 If model listing is unavailable but you know the exact inference ID, use:
 
@@ -77,7 +87,28 @@ Check the model supports the selected adapter's streaming chat API. The catalog
 
 If ordinary text works but requests with tools fail, add `--no-tools` and restart the agent. This disables file and terminal tools; it does not add tool support to the model. Prefer a model/server combination with reliable function calling when you need edits or commands.
 
-The editor may show `Provider endpoint request failed. Check its API key, model, URL, and server logs.` This is intentionally generic: raw SDK/API error bodies can contain request data. Look at the endpoint's own logs or make a minimal request using its official API tools to distinguish authentication, access, quota, protocol, and model errors. Sanitize logs before sharing them.
+Use the diagnostic in the editor to choose the next check:
+
+| Diagnostic | What to check |
+| --- | --- |
+| Cannot connect | Start the server and verify its host/port is reachable from the agent process. |
+| HTTP 401 or 403 | Check the editor's `API_KEY` and its permissions for this endpoint/model. |
+| HTTP 404 or model not found | Check the API base path and the exact upstream model ID. |
+| HTTP 400 or 422 | Check request compatibility, including the model's chat template and tool support. |
+| Context size exceeded | Start a new session, reduce attached text, or adjust the server's supported context size. |
+| HTTP 429 | Check quota/rate limits and retry later. |
+| HTTP 503 or model still loading | Wait for the model/server to become ready, then retry. |
+| Invalid JSON or interrupted stream | Check that the URL serves the selected streaming API and inspect server logs. |
+
+These messages are safe summaries, not raw server errors. Check the endpoint's own logs when the summary does not identify the cause; sanitize logs before sharing them.
+
+### llama.cpp accepts discovery but rejects prompts
+
+Discovery only tests model listing. ACP Port normally includes function tools in every inference request, so a server can list its model successfully and reject even a simple greeting because of tool/template configuration.
+
+If the diagnostic mentions `--jinja`, restart `llama-server` with Jinja enabled and a tool-compatible model/template. A template error can require a matching `--chat-template-file`, not just enabling Jinja. For text-only use, add `--no-tools` to ACP Port's editor arguments and restart the agent; this removes file and terminal actions. Tools are never disabled automatically after a failure.
+
+Use a base such as `http://127.0.0.1:8080/v1`, and use the server's model alias or discovered upstream ID as `--default-model`. Wait for model loading to finish. If the conversation exceeds the server's context size, start a new session or adjust the server's context configuration. The [llama.cpp recipe](providers.md#llamacpp) includes complete launch fields.
 
 ### Slow model or interrupted stream
 
@@ -93,10 +124,10 @@ There is no `--timeout` flag. See the [runtime defaults](configuration.md#runtim
 | The model says it has no file tools | Check `--no-tools` is absent and use a model/server with function calling support. File tools work through ACP or directly against the local workspace. Older builds hid them when the editor did not advertise file access; rebuild or update and restart the agent process. |
 | No command tool | Check `--no-tools` is absent and the session is not in plan mode. Other modes use the editor terminal or a local process automatically. |
 | Local file reads miss recent edits | Without the editor's file API, reads use saved disk contents. Save the editor buffer before asking the agent to read or edit the file. |
-| `Path must stay inside the workspace` | Default mode restricts paths to the session workspace. `--mode full-access` permits paths outside it, subject to OS permissions. |
+| `Path must stay inside the workspace` | Default mode restricts paths to the session workspace. Selecting Full access in the editor permits paths outside it, subject to OS permissions. |
 | `Path resolves outside the workspace` or an unresolved-symlink error | The target or its ancestor is an external or dangling symlink. Use a valid in-workspace target. |
 | `Permission denied` | The editor rejected or cancelled the request, or returned something other than `allow_once`. The write or command was not executed by that call. |
-| Repeated write or command approvals | Select accept-edits to allow workspace writes, auto to remember explicit scoped session grants, or full-access to skip all approvals. Use the editor mode selector or `--mode MODE` at launch. |
+| Repeated write or command approvals | Select accept-edits to allow workspace writes, auto to remember explicit scoped session grants, or full-access to skip all approvals. Use the editor's ACP permission mode selector. |
 | A mode change stopped the response | Mode changes cancel active work and clear remembered approvals so the old policy cannot continue. Send the next prompt under the new mode. |
 | Local access reports `EACCES` or `EPERM` | The agent process's OS permissions still apply, including in full access. Check the file's permissions and the account/environment running acp-port. |
 | A tool times out while awaiting approval | The 120-second tool budget includes the permission dialog. Review a fresh request; approving an expired request does not resume it. |