@cydm/pie 2.6.8 → 2.6.9

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

@@ -35,25 +35,38 @@ tui-use daemon stop
 
 - Use `wait --text <marker>` or `wait --debounce <ms>` rather than guessing with sleeps.
 - Always pass `--session <id>` on session operations. `use <id>` is a legacy
-  single-session convenience. When multiple sessions exist, operations without
-  an explicit ID fail instead of risking another task's session.
+  single-session convenience that only matters while exactly one session
+  exists: with multiple sessions its `[current]` mark changes nothing, and
+  operations without an explicit ID fail instead of risking another task's session.
 - `--text` and `find` use literal text by default. Add `--regex` explicitly for
   regular expressions; a bounded worker prevents regex from hanging the daemon.
+  `find` searches only the current viewport rows, never the scrollback buffer:
+  `scrollup`/`scrolldown` first, then `find` again.
 - `snapshot` reports the rendered screen, cursor, title, fullscreen state, and selected spans.
 - `list`, `use <id>`, and `rename <label>` support multiple sessions.
 - `start --cwd <dir> --cols <n> --rows <n>` controls the working directory and terminal size.
+  `start` prints the bare session ID on stdout (plain text for shell capture, no
+  `--format json` option).
 - `resize <cols> <rows>` updates a live session. `keys` lists the supported
   modifiers and function keys, including Shift-Tab and F11/F12.
 - Snapshot rows are preserved. Cursor, highlights and `find` use zero-based
-  viewport rows and terminal-cell columns; `col_end` is inclusive. A cursor
-  outside the viewport while scrolling is offscreen, not a screen text index.
+  viewport rows and terminal-cell columns; spans are measured in terminal cells,
+  so a wide character (CJK, emoji) occupies two cells and `col_end` is the last
+  occupied cell, not a character count. The cursor is offscreen exactly when its
+  `y` is outside `0 <= y < rows` (scrolling reports scrollback-absolute rows, so
+  `y >= rows` means offscreen); an offscreen cursor is not a screen text index.
 - Send an explicit `press enter` after typing when reliable submission matters.
+  `press` accepts only the special key names listed by `keys`; single printable
+  characters must be sent with `type` instead.
 - `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.
+  A killed session is retained like a naturally exited one: `info`, `snapshot`
+  and `wait --exit` (reporting the observed `exit_code`) keep working for it
+  until exited-session retention prunes it.
 
 ## Bounded Polling For Long Tasks
 
@@ -117,9 +130,11 @@ node <baseDir>/tui-use-cli.js --session <id> press enter
 node <baseDir>/tui-use-cli.js --session <id> wait 3000 --text 'Error: EXPECTED_ERROR'
 ```
 
-`--stdin` reads UTF-8 literally, without expanding `\n`, `\r` or `\t`, and
-removes one trailing pipeline line terminator. `paste --stdin` supports
-multiline input and submits each line.
+Text passed as `type`/`paste` arguments expands the escape sequences `\n`, `\r`
+and `\t` (`\n` acts as Enter for most programs). `--stdin` reads UTF-8
+literally, without expanding `\n`, `\r` or `\t`, and removes one trailing
+pipeline line terminator. `paste --stdin` supports multiline input and submits
+each line.
 
 PowerShell pipelines containing Unicode must use UTF-8:
 
@@ -140,7 +155,8 @@ tui-use. `PIE_TUI_USE_STATE_DIR` can isolate a test or task.
 Windows uses a named pipe; Unix hosts use a local socket. Daemon logs are
 written to the state directory instead of inherited command output.
 Use a dedicated state directory per task when possible, even with explicit IDs.
-At most 32 sessions run concurrently; up to 16 exited sessions are retained.
+At most 32 sessions run concurrently; up to 16 exited sessions (naturally exited
+or killed) are retained, each for at most five minutes.
 An empty/exited daemon shuts down after five minutes without session activity.
 
 If startup fails, inspect `daemon status` and the state directory's

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

@@ -10320,6 +10320,48 @@ var SUPPORTED_KEYS = Object.keys(KEY_MAP);
 var import_node_fs2 = require("node:fs");
 var import_node_path3 = __toESM(require("node:path"));
 var program2 = new Command();
+function isWideCodePoint(cp) {
+  return cp >= 4352 && (cp <= 4447 || // Hangul Jamo
+  cp === 9001 || cp === 9002 || // angle brackets
+  cp >= 11904 && cp <= 12350 || // CJK radicals … CJK symbols
+  cp >= 12353 && cp <= 13311 || // Hiragana … CJK compatibility
+  cp >= 13312 && cp <= 19903 || // CJK ext A
+  cp >= 19968 && cp <= 40959 || // CJK Unified Ideographs
+  cp >= 40960 && cp <= 42191 || // Yi
+  cp >= 44032 && cp <= 55203 || // Hangul syllables
+  cp >= 63744 && cp <= 64255 || // CJK compatibility ideographs
+  cp >= 65072 && cp <= 65135 || // CJK compatibility forms
+  cp >= 65280 && cp <= 65376 || // Fullwidth forms
+  cp >= 65504 && cp <= 65510 || // Fullwidth signs
+  cp >= 127744 && cp <= 128591 || // emoji
+  cp >= 129280 && cp <= 129535 || // supplemental emoji
+  cp >= 131072 && cp <= 262141);
+}
+function charCellWidth(char) {
+  return isWideCodePoint(char.codePointAt(0) ?? 0) ? 2 : 1;
+}
+function stringCellWidth(value) {
+  let width = 0;
+  for (const char of value) width += charCellWidth(char);
+  return width;
+}
+function truncateToCells(value, maxCells) {
+  if (stringCellWidth(value) <= maxCells) return value;
+  const budget = Math.max(1, maxCells - 1);
+  let used = 0;
+  let out = "";
+  for (const char of value) {
+    const w = charCellWidth(char);
+    if (used + w > budget) break;
+    out += char;
+    used += w;
+  }
+  return out + "\u2026";
+}
+function padEndCells(value, width) {
+  const missing = width - stringCellWidth(value);
+  return missing > 0 ? value + " ".repeat(missing) : value;
+}
 function callerEnv() {
   const env = {};
   for (const [key, value] of Object.entries(process.env)) {
@@ -10356,12 +10398,12 @@ program2.command("start [args...]").description("Start an interactive program in
     }
   });
 });
-program2.command("snapshot").description("Return the current rendered screen snapshot (requires: tui-use use <id> first)").option("--format <fmt>", "Output format: pretty, json (default: pretty)", "pretty").option("--color", "Preserve ANSI color/style escape sequences in output lines").action(async (opts) => {
+program2.command("snapshot").description("Return the rendered screen snapshot (pass --session <id>; in a single-session daemon, tui-use use <id> first also works)").option("--format <fmt>", "Output format: pretty, json (default: pretty)", "pretty").option("--color", "Preserve ANSI color/style escape sequences in output lines").action(async (opts) => {
   const res = await sendRequest({ type: "snapshot", color: opts.color ?? false, session_id: program2.opts().session });
   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)\n  wait --text "pattern" --poll \u2192 exit 0 with wait_state "pending" if the deadline passes while the session is still running'
+  'Wait for screen to change or timeout.\n  wait           \u2192 wait for screen to change and become stable (default 3000ms)\n  wait 5000      \u2192 wait for 5000ms\n  wait --text "pattern"  \u2192 wait until screen contains text\n  wait --debounce 300    \u2192 return once the screen has been stable for 300ms, even if it never changed (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) {
@@ -10396,7 +10438,7 @@ program2.command("wait [duration]").description(
   });
 });
 program2.command("type [input...]").description(
-  "Type text to the current session.\n  Use \\n for Enter, \\t for Tab\n  To specify a different session: tui-use use <id> first"
+  "Type text to a session.\n  Use \\n for Enter, \\t for Tab\n  Pass --session <id> to target a session (single-session legacy: tui-use use <id> first)"
 ).option("--stdin", "Read literal UTF-8 input from stdin (safe for quotes and Unicode in PowerShell)").action(async (inputParts, opts) => {
   const input = inputText(inputParts, opts.stdin);
   const res = await sendRequest({ type: "type", input, literal: !!opts.stdin, session_id: program2.opts().session });
@@ -10416,7 +10458,7 @@ program2.command("press <key>").description(
     }
   });
 });
-program2.command("kill").description("Terminate the current session (requires: tui-use use <id> first)").action(async () => {
+program2.command("kill").description("Terminate a session (pass --session <id>; single-session legacy: tui-use use <id> first). The killed session stays inspectable like an exited one").action(async () => {
   const res = await sendRequest({ type: "kill", session_id: program2.opts().session });
   handleResponse(res, (r) => {
     if (r.type === "kill") {
@@ -10531,17 +10573,21 @@ program2.command("list").description("List all active sessions").option("--forma
           console.log("No active sessions");
           return;
         }
+        const LABEL_MAX = 24;
+        const COMMAND_MAX = 40;
+        const labels = r.sessions.map((s) => truncateToCells(s.label, LABEL_MAX));
+        const commands = r.sessions.map((s) => truncateToCells(s.command, COMMAND_MAX));
         const idWidth = Math.max(10, ...r.sessions.map((s) => s.session_id.length));
-        const labelWidth = Math.max(5, ...r.sessions.map((s) => s.label.length));
-        const cmdWidth = Math.max(7, ...r.sessions.map((s) => s.command.length));
-        const header = `${"SESSION ID".padEnd(idWidth)}  ${"LABEL".padEnd(labelWidth)}  ${"COMMAND".padEnd(cmdWidth)}  STATUS`;
+        const labelWidth = Math.min(LABEL_MAX, Math.max(5, ...labels.map((label) => stringCellWidth(label))));
+        const cmdWidth = Math.min(COMMAND_MAX, Math.max(7, ...commands.map((command) => stringCellWidth(command))));
+        const header = `${"SESSION ID".padEnd(idWidth)}  ${padEndCells("LABEL", labelWidth)}  ${padEndCells("COMMAND", cmdWidth)}  STATUS`;
         console.log(header);
         console.log("-".repeat(header.length));
-        for (const s of r.sessions) {
+        for (const [index, s] of r.sessions.entries()) {
           const currentMark = s.session_id === r.current ? " [current]" : "";
           const status = s.status + currentMark;
           console.log(
-            `${s.session_id.padEnd(idWidth)}  ${s.label.padEnd(labelWidth)}  ${s.command.padEnd(cmdWidth)}  ${status}`
+            `${s.session_id.padEnd(idWidth)}  ${padEndCells(labels[index], labelWidth)}  ${padEndCells(commands[index], cmdWidth)}  ${status}`
           );
         }
       }

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

@@ -7327,8 +7327,9 @@ var Session = class {
     }
     if (mapped === void 0) {
       const supported = Object.keys(KEY_MAP).join(", ");
+      const hint = key.length === 1 && key >= " " && key !== "\x7F" ? " Printable characters should be sent with `type`, not `press`." : "";
       throw new Error(
-        `Unknown key: "${key}". Run \`tui-use keys\` to see all supported key names.
+        `Unknown key: "${key}".${hint} Run \`tui-use keys\` to see all supported key names.
 Supported keys: ${supported}`
       );
     }
@@ -7384,7 +7385,6 @@ Supported keys: ${supported}`
   async wait(timeoutMs = 3e3, text, debounceMs = 100, options) {
     let satisfied = false;
     let timedOut = false;
-    const before = this.lastSnapshotState;
     const controller = new AbortController();
     const matches = async (screen) => text === void 0 || (await matchLines([screen], text, options?.regex, controller.signal))[0] !== null;
     if (this._status === "exited" && this.pendingWrites === 0) {
@@ -7435,7 +7435,7 @@ Supported keys: ${supported}`
               done();
               return;
             }
-          } else if (!options?.exit && this.screenIdentity() !== before) {
+          } else if (!options?.exit) {
             if (idleTimer2) clearTimeout(idleTimer2);
             idleTimer2 = setTimeout(() => {
               satisfied = true;
@@ -7787,8 +7787,7 @@ async function handleRequest(req, signal) {
         return { type: "paste", ok: true };
       case "kill":
         await session.kill();
-        sessions.delete(id);
-        exitedAt.delete(id);
+        exitedAt.set(id, Date.now());
         if (currentSession === id) currentSession = null;
         return { type: "kill", ok: true };
       case "find":

package/package.json

@@ -1,6 +1,6 @@
 {
 	"name": "@cydm/pie",
-	"version": "2.6.8",
+	"version": "2.6.9",
 	"description": "Pie AI Agent CLI",
 	"type": "module",
 	"bin": {