@cydm/pie 2.7.11 → 2.7.13

package/README.md

@@ -211,11 +211,14 @@ Main key bindings:
 - `Enter` submit message
 - `Shift+Enter` insert a new line
 - `\` + `Enter` insert a new line in terminals without modified-enter support
-- `Ctrl+C` exit
-- `Ctrl+D` exit
+- `Ctrl+C` clear the editor; press twice within 500 ms to exit
+- `Ctrl+D` exit when the editor is empty; forward-delete otherwise
+- `Ctrl+V` / `Alt+V` / `Cmd+V` paste an image from the clipboard when the main chat editor owns focus (terminal clipboard first, OS helper fallback). Plan refinement, extension input/editor/custom UI, visible overlays, and the mention picker retain their own paste keys.
 - `Ctrl+O` expand or collapse tool output
 - `/` open the slash command menu
 
+OS clipboard images are staged in per-read private temporary directories (0700 directories and exclusively reserved 0600 files on POSIX), including subprocess output, and removed after staging or on failure. Windows uses the user's temporary directory and inherited OS access controls. Terminal OSC 5522 frames and CSI 5522 support replies are incrementally framed, size-bounded, and never flushed as keyboard input while recognized: the default inter-chunk deadline is 1s, with a 10s absolute frame deadline. Failed frames discard their tails through the terminator or until 1s of idle recovery. An ambiguous lone Escape keeps its normal keyboard timeout unless a clipboard request is active; even then it is eventually delivered as Escape. After idle recovery, arbitrarily late bare payload bytes cannot be distinguished from new typing.
+
 Direct shell mode:
 
 ```text
@@ -333,17 +336,13 @@ Run `pie doctor` to check whether chrome-devtools-axi and a Chrome browser are d
 
 ## Terminal UI Automation
 
-The built-in `tui-use` skill drives interactive terminal programs - REPLs, pdb/gdb debugger sessions, and full-screen TUI apps - through Pie's packaged PTY runtime. Run `node <skill-baseDir>/tui-use-cli.js --help`; no first-use dependency download or global CLI is required. Windows uses native PowerShell and ConPTY. State lives in `~/.pie/tui-use`, or a dedicated `PIE_TUI_USE_STATE_DIR`. Always target sessions with `--session <id>`, confirm termination with `wait --exit`, and clean up only sessions and daemons you own. Use plain `bash` for non-interactive commands.
+The built-in `tui-use` skill drives interactive terminal programs - REPLs, pdb/gdb debugger sessions, and full-screen TUI apps - through Pie's packaged PTY runtime. Run `node <skill-baseDir>/tui-use-cli.js --help`; no first-use dependency download or global CLI is required. Windows uses native PowerShell and ConPTY. State lives in `~/.pie/tui-use`, or a dedicated `PIE_TUI_USE_STATE_DIR`. Always target sessions with `--session <id>`, confirm termination with `wait --exit`, and clean up only sessions and daemons you own. Use the `shell` tool for non-interactive commands.
 
 ## Desktop Control (computer-use)
 
-The built-in `computer-use` extension (vendored from `@injaneity/pi-computer-use@0.5.1`, frozen and self-maintained by Pie) controls real desktop applications on macOS, Windows, and Linux through a native accessibility helper. Desktop control is a last resort - prefer API, CLI, or web tools whenever they can accomplish the task.
-
-Tools are tiered:
+The built-in `computer-use-axi` skill controls real desktop applications on macOS, Windows, and Linux through a native accessibility helper. Desktop control is a last resort - prefer API, CLI, or web tools whenever they can accomplish the task. Invoke the skill's CLI through the `shell` tool (`node <skill-baseDir>/computer-use-axi-cli.js <command>`); observation commands read UI state, while `act` synthesizes real input. These are CLI operations, not a separate model-visible extension tool tier, so normal shell confirmation policy applies.
 
-- **Observe tier (default)** - `find_roots`, `observe_ui`, `search_ui`, `expand_ui`, `inspect_ui`, `read_text`, `wait_for` read screen/UI state.
-- **Browser tier (default)** - `launch_browser`, `navigate_browser`, `evaluate_browser` control a managed CDP context. Navigation and JavaScript evaluation can have side effects; these are not read-only tools.
-- **Act tier (first-use confirmation)** - `act_ui` synthesizes real input (click, type, scroll, keypress, drag). The first `act_ui` call in each session asks for confirmation (class `computer_use_act`); YOLO mode bypasses it, and non-interactive hosts block it deterministically.
+Read `builtin/skills/computer-use-axi/SKILL.md` for `roots`, bounded observation, checked actions and browser workflows. On macOS, run the CLI's `permissions setup` and then `permissions recheck` after granting Accessibility and Screen Recording; starting Pie interactively is not a substitute for that setup flow.
 
 Platform notes:
 
@@ -351,7 +350,7 @@ Platform notes:
 - **Windows**: the helper installs to `~/.pie/helpers/computer-use/windows-bridge.exe` and needs an interactive desktop session.
 - **Linux**: the helper installs to `~/.pie/helpers/computer-use/linux-bridge` and needs an AT-SPI2 bus (a running desktop session; headless servers are not supported).
 
-Config: `~/.pie/extensions/computer-use.json` (user) or `.pie/computer-use.json` (project) with `browser_use`, `headless`, `cursor_overlay`, `managed_browser`; env overrides `PIE_COMPUTER_USE_BROWSER_USE` / `PIE_COMPUTER_USE_HEADLESS` / `PIE_COMPUTER_USE_CURSOR_OVERLAY` / `PIE_COMPUTER_USE_MANAGED_BROWSER`. The engine ships as the `computer-use-axi` skill: invoke it through bash (`node <skill baseDir>/computer-use-axi-cli.js <command>`) per its SKILL.md, and run `pie doctor` for helper install status.
+Config: `~/.pie/extensions/computer-use.json` (user) or `.pie/computer-use.json` (project) with `browser_use`, `headless`, `cursor_overlay`, `managed_browser`; env overrides `PIE_COMPUTER_USE_BROWSER_USE` / `PIE_COMPUTER_USE_HEADLESS` / `PIE_COMPUTER_USE_CURSOR_OVERLAY` / `PIE_COMPUTER_USE_MANAGED_BROWSER`. Run `pie doctor` for helper install status.
 
 ## Web Research
 
@@ -363,13 +362,13 @@ Pie exposes one default model-visible web tool: `web_research`. Use it for publi
 
 ## Permissions
 
-Pie's default tools operate from the current workspace. File tools are workspace-scoped, `~/.pie` is allowlisted for Pie configuration/session support, and shell commands return structured timeout/truncation/error details. The canonical shell tool is still named `bash` for compatibility; on Windows `shell:auto` uses PowerShell, and callers can explicitly request `bash`, `powershell`, or `cmd`. High-risk shell commands require confirmation outside YOLO mode; the confirmation dialog also offers a time-boxed `Yolo (5 min)` option that suppresses further high-risk prompts for five minutes without enabling full YOLO mode. `/settings/yolo` relaxes filesystem sandbox directory restrictions and should only be used in trusted workspaces. `pie permissions` prints the current policy-derived safety summary.
+Pie's default tools operate from the current workspace. File tools are workspace-scoped, `~/.pie` is allowlisted for Pie configuration/session support, and shell commands return structured timeout/truncation/error details. The canonical executable tool is named `shell`; `bash` remains only a historical replay/rendering and policy identifier, not a second executable alias. On Windows `shell:auto` uses PowerShell, and callers can explicitly request the `bash`, `powershell`, or `cmd` dialect. High-risk shell commands require confirmation outside YOLO mode; the confirmation dialog also offers a time-boxed `Yolo (5 min)` option that suppresses further high-risk prompts for five minutes without enabling full YOLO mode. Explicitly turning `/settings/yolo off` revokes both persistent YOLO and any live temporary grant; status reports a remaining grant separately. `/settings/yolo` relaxes filesystem sandbox directory restrictions and should only be used in trusted workspaces. `pie permissions` prints the current policy-derived safety summary.
 
-In interactive Plan mode (`/tools/plan`), workspace editing tools are unavailable. The `bash` guard accepts simple read commands and read-only pipelines such as `rg 'TODO' . | head -20`; it blocks redirects, command substitution, and write-capable subcommands. Use `plan_scratch` to write, read, or list temporary text drafts in a directory dedicated to the current session. Shell redirection to `/tmp` remains blocked in Plan mode. When the plan is ready, the agent submits the ordered steps with `plan_submit` and you choose to execute immediately (progress is tracked through `[DONE:n]` markers in responses), keep planning, or refine the plan in a prefilled editor; a plan written as plain text under a `Plan:`/`计划：` heading is still detected as a fallback. Leave Plan mode before changing workspace files.
+In interactive Plan mode (`/tools/plan`), workspace editing tools are unavailable. The Plan-mode `shell` guard accepts simple read commands and read-only pipelines such as `rg 'TODO' . | head -20`; it blocks redirects, command substitution, and write-capable subcommands. Use `plan_scratch` to write, read, or list temporary text drafts in a directory dedicated to the current session. Shell redirection to `/tmp` remains blocked in Plan mode. When the plan is ready, the agent submits the ordered steps with `plan_submit` and you choose to execute immediately (progress is tracked through `[DONE:n]` markers in responses), keep planning, or refine the plan in a prefilled editor; a plan written as plain text under a `Plan:`/`计划：` heading is still detected as a fallback. Leave Plan mode before changing workspace files.
 
 ## Code Intelligence
 
-`code_intel` provides read-only JS/TS diagnostics, definition, references, symbols, and hover. CLI uses an isolated TypeScript worker by default and falls back to bounded lightweight text analysis on worker startup/OOM/crash/timeout failures; aborts, permission errors, and path escapes do not fallback. Unity uses a Node sidecar contract for TypeScript intelligence so the PuerTS bundle does not import Node-only parser dependencies.
+The CLI's former TypeScript-service `code_intel` tool has been retired. Unity currently exposes a lightweight provider for read-only JS/TS diagnostics, definition, references, symbols, and hover; do not infer a CLI TypeScript worker or a Unity Node sidecar from the old documentation.
 
 ## Diagnostics
 
@@ -405,7 +404,7 @@ Every management command (`sessions`, `doctor`, `models`, `extensions`, `permiss
 - Errors are structured on stdout: `{"v":1,"ok":false,"kind":"...","error":{"code":"session_not_found","message":"...","hint":"..."}}`.
 - Exit codes: `0` success, `1` business failure, `2` usage error. Unknown flags fail loudly; every subcommand supports `--help`.
 - `sessions list --json` defaults to the current project (`--all` lists every project). Rows are minimal (`id`, `name`, `updatedAt`, `count`) with `--fields` and `--full` opt-ins; `sessions read` truncates content by default with the same opt-ins.
-- JSONL protocol mode (`--json-events`) identifies entries by `entryId` only (the legacy `checkpointId` alias is gone) and caps large tool results and turn summaries by default; pass `--event-detail full` for untruncated payloads. Truncation always carries `truncated`/`fullLength` markers.
+- JSONL protocol mode (`--json-events`) identifies entries by `entryId` only (the legacy `checkpointId` alias is gone) and caps large tool results and turn summaries by default; pass `--event-detail full` for larger but still bounded payloads (including a 4,000-character string cap, depth/item/key limits). Affected tool-result strings carry `truncated`/`fullLength`; other bounded structures may use only `truncated`.
 
 Run `pie capabilities --json` to discover the full command surface, flags, and exit-code contract programmatically.
 

package/dist/builtin/extensions/ask-user/index.js

@@ -1,9 +1,9 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
   createAskUserCapability
-} from "../../../chunks/chunk-XIRBNP2S.js";
-import "../../../chunks/chunk-XVF6V6Q5.js";
-import "../../../chunks/chunk-3VEIP2VY.js";
+} from "../../../chunks/chunk-CIFC6QVB.js";
+import "../../../chunks/chunk-HGUYS5SF.js";
+import "../../../chunks/chunk-R46YPPTU.js";
 import "../../../chunks/chunk-XXGYUYXI.js";
 import "../../../chunks/chunk-LZQXQOPJ.js";
 

package/dist/builtin/extensions/plan-mode/index.js

@@ -6,9 +6,9 @@ import {
   extractPlanTodoItems,
   markCompletedPlanSteps,
   restoreExecutionState
-} from "../../../chunks/chunk-XIRBNP2S.js";
-import "../../../chunks/chunk-XVF6V6Q5.js";
-import "../../../chunks/chunk-3VEIP2VY.js";
+} from "../../../chunks/chunk-CIFC6QVB.js";
+import "../../../chunks/chunk-HGUYS5SF.js";
+import "../../../chunks/chunk-R46YPPTU.js";
 import {
   Type
 } from "../../../chunks/chunk-XXGYUYXI.js";
@@ -121,6 +121,30 @@ function planModeExtension(ctx) {
     return items.map((item, index) => `${index + 1}. ${item.text}${item.detail ? `
    ${item.detail}` : ""}`).join("\n");
   }
+  async function planSelect(prompt, options, leftShortcut) {
+    const response = await ctx.interactions.request({
+      type: "select_one",
+      id: `plan-mode:${Date.now()}`,
+      prompt,
+      options,
+      // No timeoutMs: plan approval must wait for the user indefinitely,
+      // matching the pre-protocol ctx.ui.select behavior.
+      ...leftShortcut ? { leftShortcut } : {}
+    });
+    return response.type === "select_one" ? response.selection : void 0;
+  }
+  function planNotify(message, level = "info") {
+    void ctx.interactions.request({ type: "notify", message, level, markdown: true }).catch(() => void 0);
+  }
+  async function planRefine(items) {
+    const response = await ctx.interactions.request({
+      type: "multiline_input",
+      id: `plan-mode:refine:${Date.now()}`,
+      prompt: "Refine the plan (edit the plan or add feedback):",
+      prefill: formatPlanText(items)
+    });
+    return response.type === "multiline_input" ? response.value : void 0;
+  }
   function renderPlanMarkdown(goal, items) {
     const heading = goal ? `## \u{1F4CB} ${goal} \u2014 ${items.length} steps` : `## \u{1F4CB} Plan \u2014 ${items.length} steps`;
     const steps = items.map((item, index) => {
@@ -208,15 +232,15 @@ Execute the steps in order, starting with step 1. After completing a step, inclu
       lastOfferedPlanKey = JSON.stringify(items);
       const rendered = items.map((item) => `${item.step}. \u2610 ${item.text}${item.detail ? `
    ${item.detail}` : ""}`).join("\n");
-      if (!ctx.hasUI) {
+      if (!ctx.interactions.isAvailable()) {
         return reply(`Plan submitted (${items.length} steps) in headless mode; interactive approval is unavailable, so nothing will be executed:
 
 ${rendered}`);
       }
       const goal = typeof args.goal === "string" && args.goal.trim() ? args.goal.trim() : void 0;
-      ctx.ui.notify(renderPlanMarkdown(goal, items), "info", { markdown: true });
+      planNotify(renderPlanMarkdown(goal, items));
       const yoloOption = typeof ctx.setYoloMode === "function" && !ctx.yoloMode ? ["Execute in YOLO mode (auto-approve everything)"] : [];
-      const choice = await ctx.ui.select(`\u{1F4CB} Plan (${items.length} steps) \u2014 what next?`, [
+      const choice = await planSelect(`\u{1F4CB} Plan (${items.length} steps) \u2014 what next?`, [
         "Execute the plan (track progress)",
         ...yoloOption,
         "Stay in plan mode",
@@ -230,7 +254,7 @@ ${rendered}`);
         return reply(startPlanExecution(items));
       }
       if (choice === "Refine the plan") {
-        const refinement = await ctx.ui.editor("Refine the plan (edit the plan or add feedback):", formatPlanText(items));
+        const refinement = await planRefine(items);
         if (refinement?.trim()) {
           return reply(`The user refined the plan:
 
@@ -298,7 +322,8 @@ ${completedList}`, "info", { markdown: true });
       }
       return;
     }
-    if (!planModeEnabled || !ctx.hasUI) return;
+    if (!planModeEnabled) return;
+    if (!ctx.interactions.isAvailable()) return;
     if (approvalOfferedThisTurn) return;
     const messages = event.messages || [];
     const lastAssistant = [...messages].reverse().find(
@@ -316,10 +341,10 @@ ${completedList}`, "info", { markdown: true });
     approvalOfferedThisTurn = true;
     const todoListText = extracted.map((item, index) => `${index + 1}. \u2610 ${item.text}${item.detail ? `
    - \u21B3 ${item.detail}` : ""}`).join("\n");
-    ctx.ui.notify(`## \u{1F4CB} Plan \u2014 ${extracted.length} steps
+    planNotify(`## \u{1F4CB} Plan \u2014 ${extracted.length} steps
 
-${todoListText}`, "info", { markdown: true });
-    const choice = await ctx.ui.select(`\u{1F4CB} Plan (${extracted.length} steps) \u2014 what next?`, [
+${todoListText}`);
+    const choice = await planSelect(`\u{1F4CB} Plan (${extracted.length} steps) \u2014 what next?`, [
       "Execute the plan (track progress)",
       "Stay in plan mode",
       "Refine the plan"
@@ -329,7 +354,7 @@ ${todoListText}`, "info", { markdown: true });
       return;
     }
     if (choice === "Refine the plan") {
-      const refinement = await ctx.ui.editor("Refine the plan (edit the plan or add feedback):", formatPlanText(extracted));
+      const refinement = await planRefine(extracted);
       if (refinement?.trim()) {
         ctx.sendUserMessage(refinement.trim());
       }

package/dist/builtin/extensions/subagent/index.js

@@ -1,18 +1,20 @@
 import { createRequire as __createRequire } from "node:module"; const require = __createRequire(import.meta.url);
 import {
+  classifyCliFailure,
   createCliHostCapabilities,
+  createCliRetryPolicy,
   formatTransportLifecycle,
   getConfigDir,
   logTransportLifecycle
-} from "../../../chunks/chunk-3NFKVBGY.js";
+} from "../../../chunks/chunk-D7RMNFVM.js";
 import {
   SUBAGENT_SESSION_RECORD_VERSION,
   createPolicyEnforcedTools,
   createSharedFileSystemTools,
   createSubagentCapability
-} from "../../../chunks/chunk-XIRBNP2S.js";
-import "../../../chunks/chunk-XVF6V6Q5.js";
-import "../../../chunks/chunk-3VEIP2VY.js";
+} from "../../../chunks/chunk-CIFC6QVB.js";
+import "../../../chunks/chunk-HGUYS5SF.js";
+import "../../../chunks/chunk-R46YPPTU.js";
 import "../../../chunks/chunk-XXGYUYXI.js";
 import "../../../chunks/chunk-LZQXQOPJ.js";
 
@@ -398,6 +400,10 @@ function subagentExtension(ctx) {
     },
     skills,
     yoloMode: ctx.yoloMode,
+    recovery: {
+      policy: createCliRetryPolicy(),
+      classifyFailure: (context) => classifyCliFailure(context)
+    },
     getParentTools: () => ctx.getAllTools(),
     log: (message) => ctx.log(message),
     notify: ctx.hasUI ? (message, type) => ctx.ui.notify(message, type === "success" ? "info" : type) : void 0,

package/dist/builtin/extensions/todo/index.js

@@ -8,9 +8,9 @@ import {
   executeManageTodoList,
   executionStateToTodos,
   restoreExecutionState
-} from "../../../chunks/chunk-XIRBNP2S.js";
-import "../../../chunks/chunk-XVF6V6Q5.js";
-import "../../../chunks/chunk-3VEIP2VY.js";
+} from "../../../chunks/chunk-CIFC6QVB.js";
+import "../../../chunks/chunk-HGUYS5SF.js";
+import "../../../chunks/chunk-R46YPPTU.js";
 import "../../../chunks/chunk-XXGYUYXI.js";
 import "../../../chunks/chunk-LZQXQOPJ.js";
 

package/dist/builtin/skills/computer-use-axi/computer-use-axi-broker.js

@@ -5022,17 +5022,19 @@ function validateRequest(value) {
   const params = validateCommandParams(command, value.params);
   const cwd = value.cwd === void 0 ? process.cwd() : boundedString(value.cwd, "cwd", 4096);
   if (!path3.isAbsolute(cwd)) throw new BrokerProtocolError("invalid_request", "cwd must be absolute.");
-  const rawEnvironment = value.environment ?? {};
-  assertPlainRecord(rawEnvironment, "environment");
-  assertKeys(rawEnvironment, "environment", REQUEST_ENV_KEYS);
-  for (const entry of Object.values(rawEnvironment)) {
-    if (typeof entry !== "string") throw new BrokerProtocolError("invalid_request", "environment values must be strings.");
-  }
-  let environment;
-  try {
-    environment = captureComputerUseEnvironment(rawEnvironment);
-  } catch (error) {
-    throw new BrokerProtocolError("invalid_request", String(error));
+  let environment = {};
+  if (command !== "stop") {
+    const rawEnvironment = value.environment ?? {};
+    assertPlainRecord(rawEnvironment, "environment");
+    assertKeys(rawEnvironment, "environment", REQUEST_ENV_KEYS);
+    for (const entry of Object.values(rawEnvironment)) {
+      if (typeof entry !== "string") throw new BrokerProtocolError("invalid_request", "environment values must be strings.");
+    }
+    try {
+      environment = captureComputerUseEnvironment(rawEnvironment);
+    } catch (error) {
+      throw new BrokerProtocolError("invalid_request", String(error));
+    }
   }
   const budgetMs = value.budgetMs === void 0 ? BROKER_DEFAULT_REQUEST_BUDGET_MS : Math.trunc(boundedNumber(value.budgetMs, "budgetMs", BROKER_MIN_REQUEST_BUDGET_MS, BROKER_MAX_REQUEST_BUDGET_MS));
   return {

package/dist/builtin/skills/computer-use-axi/computer-use-axi-runtime.js

@@ -378,7 +378,7 @@ function isBrokerResponse(value) {
 }
 async function callBroker(options) {
   if (options.command !== "stop") resolveTestOnlyBackend();
-  const environment = captureComputerUseEnvironment();
+  const environment = options.command === "stop" ? {} : captureComputerUseEnvironment();
   const endpoint = resolveBrokerEndpoint();
   const budgetMs = Math.min(Math.max(options.budgetMs ?? BROKER_DEFAULT_REQUEST_BUDGET_MS, 100), 15 * 6e4);
   const spawnState = { spawned: false };