@namzu/cli 29.1.0 → 32.0.0

package/dist/tui/hypermode.d.ts

@@ -0,0 +1,37 @@
+/**
+ * How the TUI names its multi-agent session mode, in one place.
+ *
+ * Hypermode was called "orchestrate" until the rename; `/orchestrate` still
+ * works as a deprecated alias of `/hypermode` (see `slashCommands.ts`). The
+ * mode pins reasoning effort to `xhigh` — or, on a model whose menu has no
+ * `xhigh`, the level nearest below it (see {@link hypermodeEffort}) — and
+ * strengthens the delegation doctrine toward delegating by default
+ * (`CODING_AGENT_HYPERMODE_DOCTRINE` in `@namzu/sdk`). "Workflows" is this
+ * terminal's word for that phased multi-agent work.
+ */
+import type { ReasoningEffort } from '@namzu/sdk';
+/** The mode's name wherever the operator reads it: footer, border tag, picker. */
+export declare const HYPERMODE = "hypermode";
+/** The one-line description the effort picker shows for the hypermode stop. */
+export declare const HYPERMODE_SUMMARY = "delegates to parallel agents by default";
+/** The level hypermode pins wherever the model publishes it. */
+export declare const HYPERMODE_EFFORT: ReasoningEffort;
+/**
+ * The level hypermode pins on a model that publishes `levels`: `xhigh`, or
+ * the highest published level below it when the menu has no `xhigh`
+ * (`high` on a menu that stops there). `max` and `ultra` are never chosen
+ * over a lower level; only a menu made entirely of levels above `xhigh`
+ * gets its lowest one, the nearest there is. `undefined` when the model
+ * publishes no menu, or an empty one: nothing is pinned.
+ */
+export declare function hypermodeEffort(levels: readonly ReasoningEffort[] | undefined): ReasoningEffort | undefined;
+/**
+ * The effort picker's last stop: the level the mode pins, then the mode —
+ * `xhigh + hypermode (workflows)`, or `high + hypermode (workflows)` on a
+ * model whose menu stops at `high`. Without a published menu there is no
+ * level to name.
+ */
+export declare function hypermodeStopLabel(pinned: string | undefined): string;
+/** The deprecation line `/orchestrate` prints before it does what `/hypermode` does. */
+export declare const ORCHESTRATE_ALIAS_NOTICE = "/orchestrate is deprecated: the mode is now called hypermode. Use /hypermode; /orchestrate will be removed in a later major version.";
+//# sourceMappingURL=hypermode.d.ts.map

package/dist/tui/hypermode.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypermode.d.ts","sourceRoot":"","sources":["../../src/tui/hypermode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAA;AAEjD,kFAAkF;AAClF,eAAO,MAAM,SAAS,cAAc,CAAA;AAEpC,+EAA+E;AAC/E,eAAO,MAAM,iBAAiB,4CAA4C,CAAA;AAE1E,gEAAgE;AAChE,eAAO,MAAM,gBAAgB,EAAE,eAAyB,CAAA;AAcxD;;;;;;;GAOG;AACH,wBAAgB,eAAe,CAC9B,MAAM,EAAE,SAAS,eAAe,EAAE,GAAG,SAAS,GAC5C,eAAe,GAAG,SAAS,CAQ7B;AAED;;;;;GAKG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAErE;AAED,wFAAwF;AACxF,eAAO,MAAM,wBAAwB,yIACkG,CAAA"}

package/dist/tui/hypermode.js

@@ -0,0 +1,58 @@
+/**
+ * How the TUI names its multi-agent session mode, in one place.
+ *
+ * Hypermode was called "orchestrate" until the rename; `/orchestrate` still
+ * works as a deprecated alias of `/hypermode` (see `slashCommands.ts`). The
+ * mode pins reasoning effort to `xhigh` — or, on a model whose menu has no
+ * `xhigh`, the level nearest below it (see {@link hypermodeEffort}) — and
+ * strengthens the delegation doctrine toward delegating by default
+ * (`CODING_AGENT_HYPERMODE_DOCTRINE` in `@namzu/sdk`). "Workflows" is this
+ * terminal's word for that phased multi-agent work.
+ */
+/** The mode's name wherever the operator reads it: footer, border tag, picker. */
+export const HYPERMODE = 'hypermode';
+/** The one-line description the effort picker shows for the hypermode stop. */
+export const HYPERMODE_SUMMARY = 'delegates to parallel agents by default';
+/** The level hypermode pins wherever the model publishes it. */
+export const HYPERMODE_EFFORT = 'xhigh';
+/** Every effort level, low to high: the order of the SDK's `ReasoningEffort` union. */
+const EFFORT_ORDER = [
+    'none',
+    'minimal',
+    'low',
+    'medium',
+    'high',
+    'xhigh',
+    'max',
+    'ultra',
+];
+/**
+ * The level hypermode pins on a model that publishes `levels`: `xhigh`, or
+ * the highest published level below it when the menu has no `xhigh`
+ * (`high` on a menu that stops there). `max` and `ultra` are never chosen
+ * over a lower level; only a menu made entirely of levels above `xhigh`
+ * gets its lowest one, the nearest there is. `undefined` when the model
+ * publishes no menu, or an empty one: nothing is pinned.
+ */
+export function hypermodeEffort(levels) {
+    if (!levels || levels.length === 0)
+        return undefined;
+    const ceiling = EFFORT_ORDER.indexOf(HYPERMODE_EFFORT);
+    const rank = (level) => EFFORT_ORDER.indexOf(level);
+    const atOrBelow = levels.filter((level) => rank(level) >= 0 && rank(level) <= ceiling);
+    if (atOrBelow.length > 0)
+        return atOrBelow.reduce((best, level) => (rank(level) > rank(best) ? level : best));
+    return levels.reduce((best, level) => (rank(level) < rank(best) ? level : best));
+}
+/**
+ * The effort picker's last stop: the level the mode pins, then the mode —
+ * `xhigh + hypermode (workflows)`, or `high + hypermode (workflows)` on a
+ * model whose menu stops at `high`. Without a published menu there is no
+ * level to name.
+ */
+export function hypermodeStopLabel(pinned) {
+    return pinned ? `${pinned} + ${HYPERMODE} (workflows)` : `${HYPERMODE} (workflows)`;
+}
+/** The deprecation line `/orchestrate` prints before it does what `/hypermode` does. */
+export const ORCHESTRATE_ALIAS_NOTICE = '/orchestrate is deprecated: the mode is now called hypermode. Use /hypermode; /orchestrate will be removed in a later major version.';
+//# sourceMappingURL=hypermode.js.map

package/dist/tui/hypermode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypermode.js","sourceRoot":"","sources":["../../src/tui/hypermode.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAIH,kFAAkF;AAClF,MAAM,CAAC,MAAM,SAAS,GAAG,WAAW,CAAA;AAEpC,+EAA+E;AAC/E,MAAM,CAAC,MAAM,iBAAiB,GAAG,yCAAyC,CAAA;AAE1E,gEAAgE;AAChE,MAAM,CAAC,MAAM,gBAAgB,GAAoB,OAAO,CAAA;AAExD,uFAAuF;AACvF,MAAM,YAAY,GAA+B;IAChD,MAAM;IACN,SAAS;IACT,KAAK;IACL,QAAQ;IACR,MAAM;IACN,OAAO;IACP,KAAK;IACL,OAAO;CACP,CAAA;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAC9B,MAA8C;IAE9C,IAAI,CAAC,MAAM,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,SAAS,CAAA;IACpD,MAAM,OAAO,GAAG,YAAY,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAA;IACtD,MAAM,IAAI,GAAG,CAAC,KAAsB,EAAE,EAAE,CAAC,YAAY,CAAC,OAAO,CAAC,KAAK,CAAC,CAAA;IACpE,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,IAAI,IAAI,CAAC,KAAK,CAAC,IAAI,OAAO,CAAC,CAAA;IACtF,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QACvB,OAAO,SAAS,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;IACpF,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAA;AACjF,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAA0B;IAC5D,OAAO,MAAM,CAAC,CAAC,CAAC,GAAG,MAAM,MAAM,SAAS,cAAc,CAAC,CAAC,CAAC,GAAG,SAAS,cAAc,CAAA;AACpF,CAAC;AAED,wFAAwF;AACxF,MAAM,CAAC,MAAM,wBAAwB,GACpC,sIAAsI,CAAA"}

package/dist/tui/open-browser.d.ts

@@ -12,6 +12,20 @@
  * path under the system directory so a same-named executable earlier on `PATH`
  * cannot answer instead.
  *
+ * ## WSL: the Windows browser
+ *
+ * Under WSL the desktop the user looks at is Windows', and `xdg-open` reaches
+ * a Linux browser at best (usually nothing). With interop on, the address goes
+ * to Windows' own protocol handler through `powershell.exe`, named by absolute
+ * path, running a CONSTANT script (`Start-Process -FilePath
+ * $env:NAMZU_OPEN_URL`) sent as `-EncodedCommand`: the address reaches it only
+ * as an environment variable named in `WSLENV`, so nothing parses it as code
+ * — the same shape as the WSL toast in `notifications/desktop/windows-toast.ts`.
+ * This is what the `open` package does on WSL too, minus its six dependencies
+ * and its quoting of the address into the script text. `cmd.exe /c start` is
+ * not used, for the reason above; `explorer.exe` is not used because it exits
+ * 1 even when it opened the page.
+ *
  * ## Best effort, reported honestly
  *
  * Returns whether a launcher was even STARTED, not whether a browser appeared
@@ -20,5 +34,19 @@
  * stop reading". On a machine with no graphical session there is nothing to
  * start and this says so, which is the case the paste path exists for.
  */
-export declare function openInBrowser(url: string): boolean;
+/** Where Windows keeps PowerShell, under a WSL mount root (`/mnt/` by default). */
+export declare function wslPowershell(mountRoot?: string): string;
+/** PowerShell under the default mount root. */
+export declare const WSL_POWERSHELL: string;
+/** The whole WSL script. The address is data in the environment, never text here. */
+export declare const WSL_OPEN_SCRIPT: string;
+/** The machine, injectable so a test can describe one it is not running on. */
+export interface BrowserHost {
+    readonly platform?: NodeJS.Platform;
+    readonly env?: NodeJS.ProcessEnv;
+    readonly exists?: (path: string) => boolean;
+    /** Reads `/etc/wsl.conf`, for where the Windows drives are mounted. */
+    readonly readFile?: (path: string) => string | undefined;
+}
+export declare function openInBrowser(url: string, host?: BrowserHost): boolean;
 //# sourceMappingURL=open-browser.d.ts.map

package/dist/tui/open-browser.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../../src/tui/open-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAwBH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CA6BlD"}
+{"version":3,"file":"open-browser.d.ts","sourceRoot":"","sources":["../../src/tui/open-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AA+BH,mFAAmF;AACnF,wBAAgB,aAAa,CAAC,SAAS,GAAE,MAA+B,GAAG,MAAM,CAEhF;AAED,+CAA+C;AAC/C,eAAO,MAAM,cAAc,QAAkB,CAAA;AAE7C,qFAAqF;AACrF,eAAO,MAAM,eAAe,QAGhB,CAAA;AAEZ,+EAA+E;AAC/E,MAAM,WAAW,WAAW;IAC3B,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,QAAQ,CAAA;IACnC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,CAAA;IAChC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,OAAO,CAAA;IAC3C,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CACxD;AAwDD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,GAAE,WAAgB,GAAG,OAAO,CA0B1E"}

package/dist/tui/open-browser.js

@@ -12,6 +12,20 @@
  * path under the system directory so a same-named executable earlier on `PATH`
  * cannot answer instead.
  *
+ * ## WSL: the Windows browser
+ *
+ * Under WSL the desktop the user looks at is Windows', and `xdg-open` reaches
+ * a Linux browser at best (usually nothing). With interop on, the address goes
+ * to Windows' own protocol handler through `powershell.exe`, named by absolute
+ * path, running a CONSTANT script (`Start-Process -FilePath
+ * $env:NAMZU_OPEN_URL`) sent as `-EncodedCommand`: the address reaches it only
+ * as an environment variable named in `WSLENV`, so nothing parses it as code
+ * — the same shape as the WSL toast in `notifications/desktop/windows-toast.ts`.
+ * This is what the `open` package does on WSL too, minus its six dependencies
+ * and its quoting of the address into the script text. `cmd.exe /c start` is
+ * not used, for the reason above; `explorer.exe` is not used because it exits
+ * 1 even when it opened the page.
+ *
  * ## Best effort, reported honestly
  *
  * Returns whether a launcher was even STARTED, not whether a browser appeared
@@ -21,12 +35,13 @@
  * start and this says so, which is the case the paste path exists for.
  */
 import { spawn } from 'node:child_process';
-import { constants, accessSync } from 'node:fs';
+import { constants, accessSync, existsSync } from 'node:fs';
 import { platform } from 'node:os';
 import { delimiter, isAbsolute, join } from 'node:path';
+import { DEFAULT_WSL_MOUNT_ROOT, detectWsl, readWslMountRoot, wslSystem32, } from '../context/environment.js';
 /** Resolve a launcher before claiming that one started. */
-function executableOnPath(name) {
-    for (const directory of (process.env.PATH ?? '').split(delimiter)) {
+function executableOnPath(name, env) {
+    for (const directory of (env.PATH ?? '').split(delimiter)) {
         // An empty or relative PATH member delegates executable authority to the
         // project cwd. Opening an OAuth URL must never run a project-owned helper.
         if (!directory || !isAbsolute(directory))
@@ -42,23 +57,80 @@ function executableOnPath(name) {
     }
     return null;
 }
-export function openInBrowser(url) {
+/** Where Windows keeps PowerShell, under a WSL mount root (`/mnt/` by default). */
+export function wslPowershell(mountRoot = DEFAULT_WSL_MOUNT_ROOT) {
+    return `${wslSystem32(mountRoot)}/WindowsPowerShell/v1.0/powershell.exe`;
+}
+/** PowerShell under the default mount root. */
+export const WSL_POWERSHELL = wslPowershell();
+/** The whole WSL script. The address is data in the environment, never text here. */
+export const WSL_OPEN_SCRIPT = [
+    "$ErrorActionPreference = 'Stop'",
+    'Start-Process -FilePath $env:NAMZU_OPEN_URL',
+].join('\n');
+/** Windows' protocol handler through interop, or `null` when this is not a WSL that can reach it. */
+function wslLaunch(url, env, host) {
+    const exists = host.exists ?? existsSync;
+    // `/etc/wsl.conf` can move the drives (`[automount] root = /win/`), and
+    // PowerShell and the directory it starts in move with them.
+    const mountRoot = host.readFile ? readWslMountRoot(host.readFile) : readWslMountRoot();
+    const wsl = detectWsl(env, { exists, list: () => [], mountRoot });
+    if (!wsl?.interop)
+        return null;
+    const powershell = wslPowershell(mountRoot);
+    if (!exists(powershell))
+        return null;
+    const passed = (env.WSLENV ?? '')
+        .split(':')
+        .filter((name) => name && !name.startsWith('NAMZU_OPEN_URL'));
+    return {
+        command: powershell,
+        args: [
+            '-NoProfile',
+            '-NonInteractive',
+            '-ExecutionPolicy',
+            'Bypass',
+            '-EncodedCommand',
+            Buffer.from(WSL_OPEN_SCRIPT, 'utf16le').toString('base64'),
+        ],
+        env: { ...env, NAMZU_OPEN_URL: url, WSLENV: [...passed, 'NAMZU_OPEN_URL'].join(':') },
+        // A Windows program started from a Linux directory warns about UNC
+        // paths; the drive PowerShell lives on is a Windows directory.
+        cwd: `${mountRoot}c`,
+    };
+}
+function launchFor(url, host) {
+    const currentPlatform = host.platform ?? platform();
+    const env = host.env ?? process.env;
+    if (currentPlatform === 'win32') {
+        return {
+            command: join(env.SystemRoot ?? 'C:\\Windows', 'System32', 'rundll32.exe'),
+            args: ['url.dll,FileProtocolHandler', url],
+        };
+    }
+    if (currentPlatform === 'linux') {
+        const wsl = wslLaunch(url, env, host);
+        if (wsl)
+            return wsl;
+    }
+    const command = executableOnPath(currentPlatform === 'darwin' ? 'open' : 'xdg-open', env);
+    return command ? { command, args: [url] } : null;
+}
+export function openInBrowser(url, host = {}) {
     // Refuse anything that is not a web address. This is handed to the
     // machine's protocol handler, and `file:` or a custom scheme reaching it
     // would be this function opening something nobody named.
     if (!/^https?:\/\//i.test(url))
         return false;
-    const currentPlatform = platform();
-    const command = currentPlatform === 'win32'
-        ? join(process.env.SystemRoot ?? 'C:\\Windows', 'System32', 'rundll32.exe')
-        : executableOnPath(currentPlatform === 'darwin' ? 'open' : 'xdg-open');
-    if (!command)
+    const launch = launchFor(url, host);
+    if (!launch)
         return false;
-    const args = currentPlatform === 'win32' ? ['url.dll,FileProtocolHandler', url] : [url];
     try {
-        const child = spawn(command, args, {
+        const child = spawn(launch.command, [...launch.args], {
             stdio: 'ignore',
             detached: true,
+            ...(launch.env ? { env: launch.env } : {}),
+            ...(launch.cwd ? { cwd: launch.cwd } : {}),
         });
         // A missing launcher — no `xdg-open` in a container — arrives as an
         // async error event, long after this function returned. Swallowing it

package/dist/tui/open-browser.js.map

@@ -1 +1 @@
-{"version":3,"file":"open-browser.js","sourceRoot":"","sources":["../../src/tui/open-browser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,EAAE,KAAK,EAAE,MAAM,oBAAoB,CAAA;AAC1C,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,SAAS,CAAA;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAA;AAClC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM,WAAW,CAAA;AAEvD,2DAA2D;AAC3D,SAAS,gBAAgB,CAAC,IAAY;IACrC,KAAK,MAAM,SAAS,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,EAAE,CAAC;QACnE,yEAAyE;QACzE,2EAA2E;QAC3E,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC;YAAE,SAAQ;QAClD,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,IAAI,CAAC,CAAA;QACvC,IAAI,CAAC;YACJ,UAAU,CAAC,SAAS,EAAE,SAAS,CAAC,IAAI,CAAC,CAAA;YACrC,OAAO,SAAS,CAAA;QACjB,CAAC;QAAC,MAAM,CAAC;YACR,+DAA+D;QAChE,CAAC;IACF,CAAC;IACD,OAAO,IAAI,CAAA;AACZ,CAAC;AAED,MAAM,UAAU,aAAa,CAAC,GAAW;IACxC,mEAAmE;IACnE,yEAAyE;IACzE,yDAAyD;IACzD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,OAAO,KAAK,CAAA;IAE5C,MAAM,eAAe,GAAG,QAAQ,EAAE,CAAA;IAClC,MAAM,OAAO,GACZ,eAAe,KAAK,OAAO;QAC1B,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,aAAa,EAAE,UAAU,EAAE,cAAc,CAAC;QAC3E,CAAC,CAAC,gBAAgB,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU,CAAC,CAAA;IACxE,IAAI,CAAC,OAAO;QAAE,OAAO,KAAK,CAAA;IAC1B,MAAM,IAAI,GAAG,eAAe,KAAK,OAAO,CAAC,CAAC,CAAC,CAAC,6BAA6B,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAA;IAEvF,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,KAAK,CAAC,OAAO,EAAE,IAAI,EAAE;YAClC,KAAK,EAAE,QAAQ;YACf,QAAQ,EAAE,IAAI;SACd,CAAC,CAAA;QACF,oEAAoE;QACpE,sEAAsE;QACtE,uEAAuE;QACvE,+DAA+D;QAC/D,KAAK,CAAC,EAAE,CAAC,OAAO,EAAE,GAAG,EAAE,GAAE,CAAC,CAAC,CAAA;QAC3B,KAAK,CAAC,KAAK,EAAE,CAAA;QACb,OAAO,IAAI,CAAA;IACZ,CAAC;IAAC,MAAM,CAAC;QACR,OAAO,KAAK,CAAA;IACb,CAAC;AACF,CAAC"}
+{"version":3,"file":"open-browser.js","sourceRoot":"","sources":["../../src/tui/open-browser.ts"],"names":[],"mappings":"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"}

package/dist/tui/permission-review.d.ts

@@ -66,7 +66,7 @@ export interface PermissionReviewRow {
 /**
  * Serialize the exact executable batch without invoking getters or `toJSON`.
  *
- * `ToolRegistry.prepareExecution()` already publishes detached JSON values,
+ * `ToolManager.prepareExecution()` already publishes detached JSON values,
  * but this is a host boundary and structural SDK implementations can still
  * supply `unknown`. Ordinary `JSON.stringify` would execute an accessor and
  * could silently turn a Date/Map/custom object into something other than the
@@ -89,7 +89,16 @@ export declare function buildPermissionReview(calls: readonly PermissionReviewCa
  * is the one case that opens exact-first: the formatter is stale, and a
  * reader should see that rather than a projection that happens to be right.
  */
-export declare function buildPermissionSummary(review: string): PermissionReviewSummary;
+/** What the screen can learn, beyond the envelope, to make a call readable. */
+export interface PermissionSummaryContext {
+    /**
+     * The control a `computer_use` `ui_act` ref names in the latest UI
+     * snapshot (`Button "Beş" (e30)`), from the session's tool. Absent, the
+     * ref alone is shown.
+     */
+    readonly describeUiRef?: (ref: string) => string | undefined;
+}
+export declare function buildPermissionSummary(review: string, context?: PermissionSummaryContext): PermissionReviewSummary;
 /**
  * Project and wrap exact review text into PHYSICAL terminal rows.
  *

package/dist/tui/permission-review.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"permission-review.d.ts","sourceRoot":"","sources":["../../src/tui/permission-review.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,OAAQ,CAAA;AAEhD,qEAAqE;AACrE,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAE5C;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,SAAS;IACnB,QAAQ,CAAC,UAAU,CAAC,EAAE;QACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;QAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KACzC,CAAA;CACD,EAAE,GACD,OAAO,CAKT;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,MAAM,sBAAsB,GAC/B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAAA;CAAE,CAAA;AAE3E,MAAM,WAAW,uBAAuB;IACvC,sFAAsF;IACtF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC1B;AASD,6EAA6E;AAC7E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,MAAM,CAIvF;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IACnC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;CAC9B;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,SAAS,oBAAoB,EAAE,EACtC,QAAQ,SAA8B,GACpC,sBAAsB,CAqJxB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CA+E9E;AAyZD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GAAG,SAAS,GACjC,SAAS,mBAAmB,EAAE,CA6BhC"}
+{"version":3,"file":"permission-review.d.ts","sourceRoot":"","sources":["../../src/tui/permission-review.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,eAAO,MAAM,2BAA2B,OAAQ,CAAA;AAEhD,qEAAqE;AACrE,eAAO,MAAM,2BAA2B,IAAI,CAAA;AAE5C;;;;GAIG;AACH,wBAAgB,wBAAwB,CAAC,YAAY,EAAE,MAAM,GAAG,SAAS,GAAG,MAAM,CAGjF;AAED;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CACnC,SAAS,EAAE,SAAS;IACnB,QAAQ,CAAC,UAAU,CAAC,EAAE;QACrB,QAAQ,CAAC,aAAa,CAAC,EAAE,IAAI,CAAA;QAC7B,QAAQ,CAAC,YAAY,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;KACzC,CAAA;CACD,EAAE,GACD,OAAO,CAKT;AAED,MAAM,WAAW,oBAAoB;IACpC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAA;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,QAAQ,CAAC,KAAK,EAAE,OAAO,CAAA;IACvB,QAAQ,CAAC,aAAa,EAAE,OAAO,CAAA;CAC/B;AAED,MAAM,MAAM,sBAAsB,GAC/B;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;CAAE,GACpE;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,CAAA;CAAE,CAAA;AAE3E,MAAM,WAAW,uBAAuB;IACvC,sFAAsF;IACtF,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAA;IAC7B,6DAA6D;IAC7D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,uEAAuE;IACvE,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAA;CAC1B;AASD,6EAA6E;AAC7E,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,WAAW,GAAG,iBAAiB,GAAG,MAAM,CAIvF;AAED,uEAAuE;AACvE,MAAM,WAAW,mBAAmB;IACnC,wDAAwD;IACxD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAA;IACrB,8DAA8D;IAC9D,QAAQ,CAAC,YAAY,EAAE,OAAO,CAAA;CAC9B;AAKD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CACpC,KAAK,EAAE,SAAS,oBAAoB,EAAE,EACtC,QAAQ,SAA8B,GACpC,sBAAsB,CAqJxB;AAED;;;;;;;;;;;;;GAaG;AACH,+EAA+E;AAC/E,MAAM,WAAW,wBAAwB;IACxC;;;;OAIG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAA;CAC5D;AAED,wBAAgB,sBAAsB,CACrC,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,wBAA6B,GACpC,uBAAuB,CA+EzB;AA+kBD;;;;;;;;;GASG;AACH,wBAAgB,oBAAoB,CACnC,MAAM,EAAE,MAAM,EACd,eAAe,EAAE,MAAM,GAAG,SAAS,GACjC,SAAS,mBAAmB,EAAE,CA6BhC"}

package/dist/tui/permission-review.js

@@ -45,7 +45,7 @@ class ReviewShapeError extends Error {
 /**
  * Serialize the exact executable batch without invoking getters or `toJSON`.
  *
- * `ToolRegistry.prepareExecution()` already publishes detached JSON values,
+ * `ToolManager.prepareExecution()` already publishes detached JSON values,
  * but this is a host boundary and structural SDK implementations can still
  * supply `unknown`. Ordinary `JSON.stringify` would execute an accessor and
  * could silently turn a Date/Map/custom object into something other than the
@@ -200,21 +200,7 @@ export function buildPermissionReview(calls, maxBytes = MAX_PERMISSION_REVIEW_BY
         };
     }
 }
-/**
- * Derive a readable review from the immutable exact envelope.
- *
- * This never reads the original tool objects: `buildPermissionReview` has
- * already rejected getters, prototypes and non-JSON values. A summary is
- * `complete` when it shows every key of every call, and callers open the
- * readable view by default only then — so a friendly label can never hide a
- * suffix. Two ways to be complete: a formatter below whose key set and value
- * types are exhaustive, or, for a tool no formatter here knows (`read`,
- * `grep`, a connected server's tool), every key with its full JSON-escaped
- * value. A tool that HAS a formatter but arrives in a shape it does not know
- * is the one case that opens exact-first: the formatter is stale, and a
- * reader should see that rather than a projection that happens to be right.
- */
-export function buildPermissionSummary(review) {
+export function buildPermissionSummary(review, context = {}) {
     let parsed;
     try {
         parsed = JSON.parse(review);
@@ -235,7 +221,7 @@ export function buildPermissionSummary(review) {
             !Object.hasOwn(call, 'input')) {
             return { text: review, complete: false };
         }
-        const readable = summarizeKnownCall(call.name, call.input);
+        const readable = summarizeKnownCall(call.name, call.input, context);
         complete &&= readable.complete;
         calls.push({
             name: call.name,
@@ -289,7 +275,7 @@ function commandLines(command) {
     const [first = '', ...rest] = command.replace(/\r/g, '\\u{000d}').split('\n');
     return [`$ ${first}`, ...rest.map((line) => `  ${line}`)];
 }
-function summarizeKnownCall(name, input) {
+function summarizeKnownCall(name, input, context = {}) {
     if (name === 'bash' && isRecord(input)) {
         const allowed = new Set([
             'command',
@@ -415,6 +401,11 @@ function summarizeKnownCall(name, input) {
         if (summary)
             return summary;
     }
+    if (name === 'computer_use' && isRecord(input)) {
+        const summary = summarizeComputerUse(input, context);
+        if (summary)
+            return summary;
+    }
     if (FORMATTED_TOOLS.has(name)) {
         // A shape this file formats, in a form it does not know: the formatter
         // is stale. Exact-first, so nobody reads a projection that merely
@@ -471,9 +462,175 @@ function summarizeBrowserOpen(input) {
         complete: true,
     };
 }
+/**
+ * A desktop action, or a batch of them, one numbered line per action in the
+ * order they will run: `3 desktop actions, in order` over `1. Click left at
+ * (812, 403)`, `2. Type "Bahadır Arda"`, `3. Press ENTER`. Text to be typed is
+ * shown whole — it is what lands in whichever window has focus — and the
+ * screenshot the coordinates belong to is named, since they are its pixels,
+ * not the screen's. An action or field this does not know returns null and
+ * the call opens exact-first.
+ */
+function summarizeComputerUse(input, context) {
+    if (input.screenshot_id !== undefined && typeof input.screenshot_id !== 'string')
+        return null;
+    const space = typeof input.screenshot_id === 'string'
+        ? `Coordinates: pixels of screenshot ${input.screenshot_id}`
+        : 'Coordinates: pixels of the latest screenshot';
+    if (input.type === 'batch') {
+        if (!Object.keys(input).every((key) => ['type', 'actions', 'screenshot_id'].includes(key)))
+            return null;
+        if (!Array.isArray(input.actions) || input.actions.length === 0)
+            return null;
+        const lines = [];
+        let coordinates = false;
+        for (const [index, item] of input.actions.entries()) {
+            if (!isRecord(item) || item.type === 'batch' || Object.hasOwn(item, 'screenshot_id'))
+                return null;
+            const action = computerUseAction(item, [], context);
+            if (!action)
+                return null;
+            coordinates ||= action.coordinates;
+            lines.push(`${index + 1}. ${action.line}`);
+        }
+        const count = input.actions.length;
+        return {
+            lines: [
+                `${count} desktop action${count === 1 ? '' : 's'}, in order; stops at the first that fails`,
+                ...lines,
+                ...(coordinates ? [space] : []),
+            ],
+            complete: true,
+        };
+    }
+    if (input.actions !== undefined)
+        return null;
+    const action = computerUseAction(input, ['screenshot_id'], context);
+    if (!action)
+        return null;
+    return { lines: [action.line, ...(action.coordinates ? [space] : [])], complete: true };
+}
+/** How a person reads each `ui_act` action, before the control it acts on. */
+const UI_ACT_VERBS = {
+    invoke: 'Press',
+    toggle: 'Toggle',
+    select: 'Select',
+    expand: 'Expand',
+    collapse: 'Collapse',
+    focus: 'Focus',
+    scroll_into_view: 'Scroll to',
+};
+function computerUseAction(item, extra = [], context = {}) {
+    const point = (value) => isRecord(value) &&
+        Object.keys(value).every((key) => key === 'x' || key === 'y') &&
+        Number.isInteger(value.x) &&
+        Number.isInteger(value.y)
+        ? `(${value.x}, ${value.y})`
+        : null;
+    const fields = (...names) => Object.keys(item).every((key) => key === 'type' || names.includes(key) || extra.includes(key));
+    const text = (value) => typeof value === 'string';
+    switch (item.type) {
+        case 'screenshot':
+            return fields() ? { line: 'Take a screenshot', coordinates: false } : null;
+        case 'cursor_position':
+            return fields() ? { line: 'Read the cursor position', coordinates: false } : null;
+        case 'list_windows':
+            return fields() ? { line: 'List the open windows', coordinates: false } : null;
+        case 'wait':
+            return fields('ms') && Number.isInteger(item.ms)
+                ? { line: `Wait ${item.ms} ms`, coordinates: false }
+                : null;
+        case 'focus_window':
+            return fields('window_id') && text(item.window_id)
+                ? {
+                    line: `Bring window ${JSON.stringify(item.window_id)} to the front`,
+                    coordinates: false,
+                }
+                : null;
+        case 'type_text':
+            return fields('text') && text(item.text)
+                ? { line: `Type ${JSON.stringify(item.text)}`, coordinates: false }
+                : null;
+        case 'key':
+            return fields('keys') && text(item.keys)
+                ? { line: `Press ${JSON.stringify(item.keys)}`, coordinates: false }
+                : null;
+        case 'mouse_move': {
+            const to = point(item.to);
+            return fields('to') && to ? { line: `Move the pointer to ${to}`, coordinates: true } : null;
+        }
+        case 'mouse_click': {
+            const at = point(item.at);
+            return fields('at', 'button') && at && text(item.button)
+                ? { line: `Click ${item.button} at ${at}`, coordinates: true }
+                : null;
+        }
+        case 'mouse_drag': {
+            const from = point(item.from);
+            const to = point(item.to);
+            return fields('from', 'to', 'button') && from && to && text(item.button)
+                ? { line: `Drag ${item.button} from ${from} to ${to}`, coordinates: true }
+                : null;
+        }
+        case 'scroll': {
+            const at = point(item.at);
+            return fields('at', 'direction', 'amount') &&
+                at &&
+                text(item.direction) &&
+                Number.isInteger(item.amount)
+                ? { line: `Scroll ${item.direction} ${item.amount} at ${at}`, coordinates: true }
+                : null;
+        }
+        case 'ui_snapshot':
+            return fields('window_id') && (item.window_id === undefined || text(item.window_id))
+                ? {
+                    line: item.window_id === undefined
+                        ? 'Read the controls of the window in front'
+                        : `Read the controls of window ${JSON.stringify(item.window_id)}`,
+                    coordinates: false,
+                }
+                : null;
+        case 'ui_act': {
+            if (!fields('ref', 'action', 'value') || !text(item.ref) || !text(item.action))
+                return null;
+            if (item.value !== undefined && !text(item.value))
+                return null;
+            // The application's own words for the control, as the session's tool
+            // last read them; the ref stays, since that is what runs.
+            const target = context.describeUiRef?.(item.ref) ?? `control ${item.ref}`;
+            if (item.action === 'set_value')
+                return {
+                    line: `Set ${target} to ${JSON.stringify(item.value ?? '')}`,
+                    coordinates: false,
+                };
+            const verb = UI_ACT_VERBS[item.action];
+            return verb ? { line: `${verb} ${target}`, coordinates: false } : null;
+        }
+        case 'zoom': {
+            const region = item.region;
+            return fields('region') &&
+                isRecord(region) &&
+                Object.keys(region).every((key) => ['x', 'y', 'width', 'height'].includes(key)) &&
+                ['x', 'y', 'width', 'height'].every((key) => Number.isInteger(region[key]))
+                ? {
+                    line: `Zoom into ${region.width}x${region.height} at (${region.x}, ${region.y})`,
+                    coordinates: true,
+                }
+                : null;
+        }
+        default:
+            return null;
+    }
+}
 const PLAIN_TOOL_NAME = /^[\w.:-]+$/u;
 /** The tools with a formatter above; an evolved shape of one opens exact-first. */
-const FORMATTED_TOOLS = new Set(['bash', 'edit', 'write', 'Agent']);
+const FORMATTED_TOOLS = new Set([
+    'bash',
+    'edit',
+    'write',
+    'Agent',
+    'computer_use',
+]);
 /** Labels group only the calls in this approval; they never invent execution phases. */
 function compactAgentPlan(calls) {
     const lines = [];