@cydm/pie 2.5.1 → 2.6.0

package/dist/builtin/skills/chrome-devtools-axi/{cli-P4VG6ZZG.js → cli-GB37NZHQ.js}

@@ -1845,8 +1845,8 @@ function isProcessAlive(pid) {
   try {
     process.kill(pid, 0);
     return true;
-  } catch {
-    return false;
+  } catch (error) {
+    return error?.code !== "ESRCH";
   }
 }
 function httpGet(port, path, timeoutMs = 2e3) {
@@ -1935,6 +1935,23 @@ async function waitForProcessExit(pid, timeoutMs) {
   return !isProcessAlive(pid);
 }
 function isBridgeProcess(pid) {
+  if (process.platform === "win32") {
+    try {
+      const command = execFileSync(
+        "powershell",
+        [
+          "-NoProfile",
+          "-NonInteractive",
+          "-Command",
+          `(Get-CimInstance Win32_Process -Filter "ProcessId=${pid}").CommandLine`
+        ],
+        { encoding: "utf-8", timeout: 4e3 }
+      );
+      return command.includes("chrome-devtools-axi-bridge");
+    } catch {
+      return false;
+    }
+  }
   try {
     const command = execFileSync("ps", ["-p", String(pid), "-o", "command="], {
       encoding: "utf-8",
@@ -1949,28 +1966,43 @@ async function probeBridgeIdentity(port, sessionName) {
   try {
     const resp = await httpGet(port, "/health", HEALTH_TIMEOUT_MS);
     const data = JSON.parse(resp);
-    if (data.status !== "ok") return "unknown";
+    if (data.status !== "ok") return { identity: "unknown" };
     if (typeof data.session === "string" && data.session !== sessionName) {
-      return "other";
+      return { identity: "other" };
     }
-    return "own";
+    return {
+      identity: "own",
+      reportedPid: typeof data.pid === "number" && data.pid > 0 ? data.pid : void 0
+    };
   } catch {
-    return "unknown";
+    return { identity: "unknown" };
   }
 }
 async function judgeRecordedBridge(pidInfo, sessionName) {
-  const identity = await probeBridgeIdentity(pidInfo.port, sessionName);
-  if (identity === "own") {
-    return {
-      terminate: true,
-      killProcessGroup: isBridgeProcess(pidInfo.pid)
-    };
+  const probe = await probeBridgeIdentity(pidInfo.port, sessionName);
+  if (probe.identity === "own") {
+    if (probe.reportedPid !== void 0) {
+      if (probe.reportedPid === pidInfo.pid) {
+        return {
+          terminate: true,
+          killProcessGroup: isBridgeProcess(pidInfo.pid),
+          targetPid: pidInfo.pid
+        };
+      }
+      return {
+        terminate: true,
+        killProcessGroup: isBridgeProcess(probe.reportedPid),
+        targetPid: probe.reportedPid
+      };
+    }
+    const bridge2 = isBridgeProcess(pidInfo.pid);
+    return { terminate: bridge2, killProcessGroup: bridge2, targetPid: pidInfo.pid };
   }
-  if (identity === "other") {
+  if (probe.identity === "other") {
     return { terminate: false, killProcessGroup: false };
   }
   const bridge = isBridgeProcess(pidInfo.pid);
-  return { terminate: bridge, killProcessGroup: bridge };
+  return { terminate: bridge, killProcessGroup: bridge, targetPid: pidInfo.pid };
 }
 function removePidFile(pidFile) {
   try {
@@ -1978,13 +2010,27 @@ function removePidFile(pidFile) {
   } catch {
   }
 }
+function taskkillTree(pid) {
+  try {
+    execFileSync("taskkill", ["/PID", String(pid), "/T", "/F"], {
+      stdio: "ignore",
+      timeout: 1e4
+    });
+    return true;
+  } catch {
+    return !isProcessAlive(pid);
+  }
+}
 async function terminateBridgeProcess(pid, opts = {}) {
-  if (!isProcessAlive(pid)) return;
+  if (!isProcessAlive(pid)) return true;
   const killProcessGroup = opts.killProcessGroup === true;
+  if (process.platform === "win32") {
+    return taskkillTree(pid) && !await isProcessAlive(pid);
+  }
   try {
     process.kill(pid, "SIGTERM");
-  } catch {
-    return;
+  } catch (error) {
+    if (error.code === "ESRCH") return true;
   }
   if (await waitForProcessExit(pid, 2e3)) {
     if (killProcessGroup) {
@@ -1993,7 +2039,7 @@ async function terminateBridgeProcess(pid, opts = {}) {
       } catch {
       }
     }
-    return;
+    return true;
   }
   if (killProcessGroup) {
     try {
@@ -2010,7 +2056,7 @@ async function terminateBridgeProcess(pid, opts = {}) {
     } catch {
     }
   }
-  await waitForProcessExit(pid, 1e3);
+  return waitForProcessExit(pid, 1e3);
 }
 function spawnBridgeProcess(port, sessionName) {
   const bridgeScript = resolveBridgeScript(import.meta.dirname);
@@ -2100,7 +2146,7 @@ async function ensureBridge(spawnBridge = spawnBridgeProcess, notice) {
     }
     const verdict = await judgeRecordedBridge(pidInfo, sessionName);
     if (verdict.terminate) {
-      await terminateBridgeProcess(pidInfo.pid, {
+      await terminateBridgeProcess(verdict.targetPid ?? pidInfo.pid, {
         killProcessGroup: verdict.killProcessGroup
       });
     } else {
@@ -2374,15 +2420,15 @@ async function getSessionSnapshotIfRunning() {
 }
 async function stopBridge() {
   const pidInfo = readPidFile();
-  if (!pidInfo) return false;
-  if (!isProcessAlive(pidInfo.pid)) return false;
+  if (!pidInfo) return "noop";
+  if (!isProcessAlive(pidInfo.pid)) return "noop";
   const verdict = await judgeRecordedBridge(pidInfo, resolveSessionName());
-  if (!verdict.terminate) return false;
-  await terminateBridgeProcess(pidInfo.pid, {
+  if (!verdict.terminate) return "noop";
+  const terminated = await terminateBridgeProcess(verdict.targetPid ?? pidInfo.pid, {
     killProcessGroup: verdict.killProcessGroup
   });
   clearSelectedPageId();
-  return true;
+  return terminated ? "stopped" : "failed";
 }
 
 // vendor/chrome-devtools-axi/src/generation.ts
@@ -3931,12 +3977,15 @@ async function handleStart() {
   const port = await ensureBridge();
   return encode({ status: "ready", port });
 }
-function formatStopOutput(wasStopped) {
-  return encode({ status: wasStopped ? "stopped" : "stopped (no-op)" });
+function formatStopOutput(outcome) {
+  if (outcome === "failed") {
+    throw new Error("bridge stop failed: the target survived SIGTERM and SIGKILL escalation");
+  }
+  return encode({ status: outcome === "stopped" ? "stopped" : "stopped (no-op)" });
 }
 async function handleStop() {
-  const wasStopped = await stopBridge();
-  return formatStopOutput(wasStopped);
+  const outcome = await stopBridge();
+  return formatStopOutput(outcome);
 }
 async function handlePages() {
   const result = await callTool("list_pages");

package/dist/builtin/skills/tui-use/SKILL.md

@@ -50,10 +50,54 @@ tui-use daemon stop
 - Send an explicit `press enter` after typing when reliable submission matters.
 - `wait --text` exits non-zero if the requested pattern is absent at the deadline.
   Read the returned screen and fix the input instead of assuming the wait succeeded.
+  Do not rerun the identical failing wait; poll with `--poll` (below) or change the input.
 - Use `wait --exit` to confirm process termination. Seeing the last output or
   leaving fullscreen does not by itself mean the process has exited.
 - Kill only sessions you created. Do not restart or stop a daemon that owns another task's live sessions.
 
+## Bounded Polling For Long Tasks
+
+For work that legitimately takes longer than one wait, opt in to poll mode:
+
+```text
+tui-use --session <id> wait 20000 --text "DONE_MARKER" --poll --format json
+```
+
+- `wait_state: "satisfied"` (exit 0): the marker appeared, or `--exit` saw the exit.
+  With `--exit` this means termination was observed, not that the program
+  succeeded: read `exit_code`, which can be nonzero.
+- `wait_state: "pending"` (exit 0): the deadline passed while the process is still
+  running. This only means the PTY is alive; it is not evidence of progress.
+- `wait_state: "failed"` (exit 1): the session exited without the `--text` marker.
+  Daemon, session and argument errors also exit 1. Never treat these as pending.
+
+Set a total budget before polling (for example at most 6 polls or 10 minutes).
+After each pending poll compare the `screen` with the previous poll. If the
+screen is unchanged across two or three polls, or the budget is spent, stop and
+report the task as not progressing, with the last screen, instead of polling on.
+For programs that can emit structured output, prefer that over viewport text.
+
+## Waiting On Pie Tasks
+
+To run or supervise a Pie task, use the JSONL protocol over pipes instead of
+driving the Pie TUI through this skill and reading its viewport:
+
+```text
+pie chat --json-events     # stdin: one JSON request per line; stdout: one JSON event per line
+```
+
+- Wait for `agent.ready`, then send
+  `{"type":"turn.request","turnId":"t1","prompt":"..."}`.
+- The turn outcome is exactly one of `turn.completed`, `turn.failed`,
+  `turn.cancelled` or `turn.stalled`, followed by `turn.settled`. Decide from
+  these events, not from screen text or the process still running.
+- `tool.started`/`tool.completed` and `turn.retry.*` events are progress
+  evidence. Pie emits `turn.stalled` after `PIE_JSON_EVENTS_NO_PROGRESS_MS`
+  (default 10 minutes) without activity.
+- `turn.failed` after `turn.retry.exhausted`, or an exhausted-quota/balance
+  error, is terminal: report it instead of resubmitting the same prompt.
+- Use `{"type":"turn.interrupt"}` to cancel and `{"type":"shutdown"}` to exit.
+
 ## Host Behavior
 
 Windows defaults to native PowerShell with matching invocation arguments;

package/dist/builtin/skills/tui-use/tui-use-cli.cjs

@@ -9950,7 +9950,13 @@ var import_node_child_process = require("node:child_process");
 var import_node_crypto = require("node:crypto");
 var import_node_os = __toESM(require("node:os"));
 var import_node_path = __toESM(require("node:path"));
-var expandHome = (value) => value.replace(/^~(?=$|\/)/, () => import_node_os.default.homedir());
+var expandHome = (value) => {
+  if (value === "~") return import_node_os.default.homedir();
+  if (value.startsWith("~/") || value.startsWith("~\\")) {
+    return import_node_path.default.join(import_node_os.default.homedir(), value.slice(2).replace(/\\/g, "/"));
+  }
+  return value;
+};
 var STATE_DIR = import_node_path.default.resolve(process.env.PIE_TUI_USE_STATE_DIR ? expandHome(process.env.PIE_TUI_USE_STATE_DIR) : import_node_path.default.join(expandHome(process.env.PIE_CODING_AGENT_DIR || import_node_path.default.join(import_node_os.default.homedir(), ".pie")), "tui-use"));
 var LOG_PATH = import_node_path.default.join(STATE_DIR, "daemon.log");
 var PID_PATH = import_node_path.default.join(STATE_DIR, "daemon.pid");
@@ -10139,17 +10145,27 @@ async function startDaemon() {
       if (error.code !== "EEXIST") throw error;
       try {
         const contents = import_node_fs.default.readFileSync(LOCK_PATH, "utf8");
-        const lock = JSON.parse(contents);
-        let alive = true;
-        if (!Number.isInteger(lock.pid) || lock.pid <= 0) alive = false;
-        else {
+        let reclaim = false;
+        try {
+          const lock = JSON.parse(contents);
+          let alive = true;
+          if (!Number.isInteger(lock.pid) || lock.pid <= 0) alive = false;
+          else {
+            try {
+              process.kill(lock.pid, 0);
+            } catch (e) {
+              if (e.code === "ESRCH") alive = false;
+            }
+          }
+          if (!alive) reclaim = true;
+        } catch {
           try {
-            process.kill(lock.pid, 0);
-          } catch (e) {
-            if (e.code === "ESRCH") alive = false;
+            const mtimeMs = import_node_fs.default.statSync(LOCK_PATH).mtimeMs;
+            if (Date.now() - mtimeMs > 5e3) reclaim = true;
+          } catch {
           }
         }
-        if (!alive && import_node_fs.default.readFileSync(LOCK_PATH, "utf8") === contents) import_node_fs.default.unlinkSync(LOCK_PATH);
+        if (reclaim && import_node_fs.default.readFileSync(LOCK_PATH, "utf8") === contents) import_node_fs.default.unlinkSync(LOCK_PATH);
       } catch {
       }
       await sleep(100);
@@ -10345,8 +10361,8 @@ program2.command("snapshot").description("Return the current rendered screen sna
   handleResponse(res, (r) => printScreen(r, opts.format));
 });
 program2.command("wait [duration]").description(
-  'Wait for screen to change or timeout.\n  wait           \u2192 wait for screen to change (default 3000ms)\n  wait 5000      \u2192 wait for 5000ms\n  wait --text "pattern"  \u2192 wait until screen contains text\n  wait --debounce 300    \u2192 wait until screen is stable for 300ms (default: 100ms)'
-).option("--text <text>", "Wait until screen contains literal text").option("--regex", "Interpret --text as a regex in a bounded worker").option("--exit", "Wait for process exit instead of just a screen change").option("--debounce <ms>", "Idle time after last change before resolving, in ms (default: 100)", "100").option("--format <fmt>", "Output format: pretty, json (default: pretty)", "pretty").option("--color", "Preserve ANSI color/style escape sequences in output lines").action(async (duration, opts) => {
+  'Wait for screen to change or timeout.\n  wait           \u2192 wait for screen to change (default 3000ms)\n  wait 5000      \u2192 wait for 5000ms\n  wait --text "pattern"  \u2192 wait until screen contains text\n  wait --debounce 300    \u2192 wait until screen is stable for 300ms (default: 100ms)\n  wait --text "pattern" --poll \u2192 exit 0 with wait_state "pending" if the deadline passes while the session is still running'
+).option("--text <text>", "Wait until screen contains literal text").option("--regex", "Interpret --text as a regex in a bounded worker").option("--exit", "Wait for process exit instead of just a screen change").option("--poll", 'Bounded polling: a deadline on a still-running session reports wait_state "pending" and exits 0; an exited session that never matched --text, and errors, exit 1. With --exit, "satisfied" means termination was observed, not success: check exit_code').option("--debounce <ms>", "Idle time after last change before resolving, in ms (default: 100)", "100").option("--format <fmt>", "Output format: pretty, json (default: pretty)", "pretty").option("--color", "Preserve ANSI color/style escape sequences in output lines").action(async (duration, opts) => {
   let timeoutMs = 3e3;
   if (duration) {
     timeoutMs = Number(duration);
@@ -10364,8 +10380,15 @@ program2.command("wait [duration]").description(
   });
   handleResponse(res, (r) => {
     const screen = r;
-    printScreen(screen, opts.format);
-    if ((opts.text !== void 0 || opts.exit) && screen.wait_satisfied === false) {
+    const conditional = opts.text !== void 0 || opts.exit;
+    const unmet = conditional && screen.wait_satisfied === false;
+    const pending = !!opts.poll && screen.timed_out === true && screen.status === "running" && (unmet || !conditional);
+    const waitState = opts.poll ? pending ? "pending" : unmet ? "failed" : "satisfied" : void 0;
+    printScreen(screen, opts.format, waitState);
+    if (pending) {
+      process.stderr.write(`Wait pending: ${opts.text ?? (opts.exit ? "process exit" : "screen change")} not seen before timeout; session is still running. Liveness is not evidence of progress: compare screens across polls and stop after a bounded number of unchanged polls.
+`);
+    } else if (unmet) {
       process.stderr.write(`Wait condition was not met${screen.timed_out ? " before timeout" : " before the session exited"}: ${opts.text ?? "process exit"}
 `);
       process.exitCode = 1;
@@ -10570,7 +10593,7 @@ function inputText(parts, fromStdin) {
   if (parts.length === 0) throw new Error("Provide text arguments or --stdin.");
   return parts.join(" ");
 }
-function printScreen(r, format = "pretty") {
+function printScreen(r, format = "pretty", waitState) {
   if (format === "json") {
     console.log(
       JSON.stringify(
@@ -10586,7 +10609,8 @@ function printScreen(r, format = "pretty") {
           cols: r.cols,
           rows: r.rows,
           highlights: r.highlights,
-          ...r.type === "wait" ? { wait_satisfied: r.wait_satisfied, timed_out: r.timed_out } : {}
+          ...r.type === "wait" ? { wait_satisfied: r.wait_satisfied, timed_out: r.timed_out } : {},
+          ...waitState ? { wait_state: waitState } : {}
         },
         null,
         2
@@ -10596,7 +10620,7 @@ function printScreen(r, format = "pretty") {
   }
   const width = r.cols;
   const header = `\u2500\u2500\u2500 ${r.session_id} ${"\u2500".repeat(Math.max(0, width - r.session_id.length - 5))}`;
-  const info = `${r.status} | cursor(${r.cursor.x},${r.cursor.y}) | fullscreen:${r.is_fullscreen} | title:"${r.title || ""}"`;
+  const info = `${r.status} | cursor(${r.cursor.x},${r.cursor.y}) | fullscreen:${r.is_fullscreen} | title:"${r.title || ""}"${waitState ? ` | wait:${waitState}` : ""}`;
   const footer = `\u2500\u2500\u2500 ${info} ${"\u2500".repeat(Math.max(0, width - info.length - 5))}`;
   process.stdout.write(header + "\n");
   for (const line of r.lines) process.stdout.write(line + "\n");

package/dist/builtin/skills/tui-use/tui-use-daemon.cjs

@@ -7661,7 +7661,13 @@ function validateRequest(value) {
 var import_node_crypto = require("node:crypto");
 var import_node_os = __toESM(require("node:os"));
 var import_node_path3 = __toESM(require("node:path"));
-var expandHome = (value) => value.replace(/^~(?=$|\/)/, () => import_node_os.default.homedir());
+var expandHome = (value) => {
+  if (value === "~") return import_node_os.default.homedir();
+  if (value.startsWith("~/") || value.startsWith("~\\")) {
+    return import_node_path3.default.join(import_node_os.default.homedir(), value.slice(2).replace(/\\/g, "/"));
+  }
+  return value;
+};
 var STATE_DIR = import_node_path3.default.resolve(process.env.PIE_TUI_USE_STATE_DIR ? expandHome(process.env.PIE_TUI_USE_STATE_DIR) : import_node_path3.default.join(expandHome(process.env.PIE_CODING_AGENT_DIR || import_node_path3.default.join(import_node_os.default.homedir(), ".pie")), "tui-use"));
 var LOG_PATH = import_node_path3.default.join(STATE_DIR, "daemon.log");
 var PID_PATH = import_node_path3.default.join(STATE_DIR, "daemon.pid");