@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/runtime/pi-cli.js

@@ -1,65 +1 @@
-import { existsSync, readFileSync } from 'node:fs';
-import { dirname, join, parse } from 'node:path';
-import { fileURLToPath } from 'node:url';
-function findPackageRootFromEntry(entryPath, expectedName) {
-    let dir = dirname(entryPath);
-    const root = parse(dir).root;
-    while (true) {
-        const pkgPath = join(dir, 'package.json');
-        if (existsSync(pkgPath)) {
-            try {
-                const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-                if (pkg.name === expectedName)
-                    return dir;
-            }
-            catch {
-                return null;
-            }
-        }
-        if (dir === root)
-            return null;
-        dir = dirname(dir);
-    }
-}
-export function resolveBundledPiPackageDir() {
-    const packageName = '@earendil-works/pi-coding-agent';
-    let entryPath;
-    try {
-        entryPath = fileURLToPath(import.meta.resolve(packageName));
-    }
-    catch (error) {
-        throw new Error(`crouter install is missing bundled ${packageName}; reinstall @north-light/crouter. ${error.message}`);
-    }
-    const packageRoot = findPackageRootFromEntry(entryPath, packageName);
-    if (packageRoot === null) {
-        throw new Error(`could not locate bundled ${packageName} package root from ${entryPath}`);
-    }
-    return packageRoot;
-}
-/** Environment for a bundled pi subprocess. pi resolves theme assets relative
- *  to its package root; pnpm/npm mixed layouts can make its own module URL point
- *  through `.pnpm` at a package copy without those JSON assets, so explicitly
- *  pin the real bundled package directory (the same contract attach uses). */
-export function bundledPiSubprocessEnv() {
-    return {
-        ...process.env,
-        PI_PACKAGE_DIR: resolveBundledPiPackageDir(),
-    };
-}
-export function resolveBundledPiCliPath() {
-    const packageRoot = resolveBundledPiPackageDir();
-    const pkgPath = join(packageRoot, 'package.json');
-    const pkg = JSON.parse(readFileSync(pkgPath, 'utf8'));
-    const bin = pkg.bin && typeof pkg.bin === 'object' ? pkg.bin.pi : undefined;
-    if (typeof bin !== 'string' || bin.trim() === '') {
-        throw new Error(`bundled @earendil-works/pi-coding-agent does not declare a pi binary in ${pkgPath}`);
-    }
-    const cliPath = join(packageRoot, bin);
-    if (!existsSync(cliPath)) {
-        throw new Error(`bundled pi binary is missing at ${cliPath}`);
-    }
-    return cliPath;
-}
-export function bundledPiCommandForShell(quote) {
-    return `${quote(process.execPath)} ${quote(resolveBundledPiCliPath())}`;
-}
+var d=Object.defineProperty;var i=(r,n)=>d(r,"name",{value:n,configurable:!0});import{existsSync as c,readFileSync as s}from"node:fs";import{dirname as l,join as a,parse as u}from"node:path";import{fileURLToPath as f}from"node:url";function g(r,n){let e=l(r);const t=u(e).root;for(;;){const o=a(e,"package.json");if(c(o))try{if(JSON.parse(s(o,"utf8")).name===n)return e}catch{return null}if(e===t)return null;e=l(e)}}i(g,"findPackageRootFromEntry");function p(){const r="@earendil-works/pi-coding-agent";let n;try{n=f(import.meta.resolve(r))}catch(t){throw new Error(`crouter install is missing bundled ${r}; reinstall @north-light/crouter. ${t.message}`)}const e=g(n,r);if(e===null)throw new Error(`could not locate bundled ${r} package root from ${n}`);return e}i(p,"resolveBundledPiPackageDir");function y(){return{...process.env,PI_PACKAGE_DIR:p()}}i(y,"bundledPiSubprocessEnv");function m(){const r=p(),n=a(r,"package.json"),e=JSON.parse(s(n,"utf8")),t=e.bin&&typeof e.bin=="object"?e.bin.pi:void 0;if(typeof t!="string"||t.trim()==="")throw new Error(`bundled @earendil-works/pi-coding-agent does not declare a pi binary in ${n}`);const o=a(r,t);if(!c(o))throw new Error(`bundled pi binary is missing at ${o}`);return o}i(m,"resolveBundledPiCliPath");function $(r){return`${r(process.execPath)} ${r(m())}`}i($,"bundledPiCommandForShell");export{$ as bundledPiCommandForShell,y as bundledPiSubprocessEnv,m as resolveBundledPiCliPath,p as resolveBundledPiPackageDir};

package/dist/core/runtime/pi-vendored.js

@@ -1,66 +1 @@
-// pi-vendored.ts — symbols copied verbatim from pi that pi does NOT re-export.
-//
-// VENDORED, not imported, because pi's `exports` map is `.`-only (+`./hooks`):
-// a deep import like `@earendil-works/pi-coding-agent/dist/core/slash-commands`
-// fails with ERR_PACKAGE_PATH_NOT_EXPORTED, and the symbol is absent from the
-// package-root `index.d.ts` at BOTH 0.78.1 and 0.79.0 — so there is no pin at
-// which it becomes importable (review C1). The only safe access is to copy it.
-//
-// MAINTENANCE: re-sync on EVERY pi SDK bump. The source of truth is
-// `node_modules/@earendil-works/pi-coding-agent/dist/core/slash-commands.js`.
-// If the upstream list changes (entries added/removed/reworded), update the copy
-// below to match and adjust the count note.
-import { homedir } from 'node:os';
-import { join } from 'node:path';
-import { expandTilde } from '../fs-utils.js';
-/** pi's sessions root, VENDORED from pi `config.getSessionsDir()` (= `<agentDir>/
- *  sessions`). pi's package `exports` map is `.`-only, so config.js can't be
- *  deep-imported, and a ROOT import of `getAgentDir` would eager-load the entire
- *  heavy pi SDK index on crtr's front-door hot path (the reason broker-sdk.ts
- *  dynamic-imports the engine). Mirrors pi: `PI_CODING_AGENT_DIR` env, else
- *  `~/.pi/agent` (APP_NAME defaults to 'pi'). Re-sync on a pi SDK bump that moves
- *  the sessions dir — same vendoring rationale as the slash-command list below.
- *  `PI_CODING_AGENT_DIR` goes through the same tilde expansion pi's
- *  `getAgentDir()` applies, or `~/custom-pi` yields a broken relative path. */
-export function piSessionsRoot() {
-    const env = process.env['PI_CODING_AGENT_DIR'];
-    const agentDir = env !== undefined && env !== '' ? expandTilde(env) : join(homedir(), '.pi', 'agent');
-    return join(agentDir, 'sessions');
-}
-/**
- * pi's builtin slash commands — vendored verbatim from pi `core/slash-commands.js`
- * `BUILTIN_SLASH_COMMANDS` (review C1). **21 entries at 0.78.1** (review n1 — NOT 23).
- *
- * Builtins are NOT engine-interpreted (`session.prompt('/model')` ships `/model`
- * to the LLM as literal text), so the broker's `get_commands` op MERGES this list
- * with the engine's registered commands/templates/skills, and the viewer
- * autocomplete parses these locally. Both the broker and the viewer
- * import this single copy.
- *
- * Upstream interpolates `${APP_NAME}` into the `quit` description; `APP_NAME`
- * defaults to "pi" (overridable via pi config), so the vendored copy hardcodes
- * "Quit pi".
- */
-export const BUILTIN_SLASH_COMMANDS = [
-    { name: 'settings', description: 'Open settings menu' },
-    { name: 'model', description: 'Select model (opens selector UI)' },
-    { name: 'scoped-models', description: 'Enable/disable models for Ctrl+P cycling' },
-    { name: 'export', description: 'Export session (HTML default, or specify path: .html/.jsonl)' },
-    { name: 'import', description: 'Import and resume a session from a JSONL file' },
-    { name: 'share', description: 'Share session as a secret GitHub gist' },
-    { name: 'copy', description: 'Copy last agent message to clipboard' },
-    { name: 'name', description: 'Set session display name' },
-    { name: 'session', description: 'Show session info and stats' },
-    { name: 'changelog', description: 'Show changelog entries' },
-    { name: 'hotkeys', description: 'Show all keyboard shortcuts' },
-    { name: 'fork', description: 'Create a new fork from a previous user message' },
-    { name: 'clone', description: 'Duplicate the current session at the current position' },
-    { name: 'tree', description: 'Navigate session tree (switch branches)' },
-    { name: 'login', description: 'Configure provider authentication' },
-    { name: 'logout', description: 'Remove provider authentication' },
-    { name: 'new', description: 'Start a new session' },
-    { name: 'compact', description: 'Manually compact the session context' },
-    { name: 'resume', description: 'Resume a different session' },
-    { name: 'reload', description: 'Reload keybindings, extensions, skills, prompts, and themes' },
-    { name: 'quit', description: 'Quit pi' },
-];
+var i=Object.defineProperty;var n=(e,s)=>i(e,"name",{value:s,configurable:!0});import{homedir as t}from"node:os";import{join as o}from"node:path";import{expandTilde as r}from"../fs-utils.js";function d(){const e=process.env.PI_CODING_AGENT_DIR,s=e!==void 0&&e!==""?r(e):o(t(),".pi","agent");return o(s,"sessions")}n(d,"piSessionsRoot");const l=[{name:"settings",description:"Open settings menu"},{name:"model",description:"Select model (opens selector UI)"},{name:"scoped-models",description:"Enable/disable models for Ctrl+P cycling"},{name:"export",description:"Export session (HTML default, or specify path: .html/.jsonl)"},{name:"import",description:"Import and resume a session from a JSONL file"},{name:"share",description:"Share session as a secret GitHub gist"},{name:"copy",description:"Copy last agent message to clipboard"},{name:"name",description:"Set session display name"},{name:"session",description:"Show session info and stats"},{name:"changelog",description:"Show changelog entries"},{name:"hotkeys",description:"Show all keyboard shortcuts"},{name:"fork",description:"Create a new fork from a previous user message"},{name:"clone",description:"Duplicate the current session at the current position"},{name:"tree",description:"Navigate session tree (switch branches)"},{name:"login",description:"Configure provider authentication"},{name:"logout",description:"Remove provider authentication"},{name:"new",description:"Start a new session"},{name:"compact",description:"Manually compact the session context"},{name:"resume",description:"Resume a different session"},{name:"reload",description:"Reload keybindings, extensions, skills, prompts, and themes"},{name:"quit",description:"Quit pi"}];export{l as BUILTIN_SLASH_COMMANDS,d as piSessionsRoot};

package/dist/core/runtime/placement-tmux.js

@@ -1,81 +1 @@
-// placement-tmux.ts — the PURE tmux + broker-socket half of placement.
-//
-// After the broker-is-the-host cut, the on-screen surface for a node is a
-// `crtr surface attach` VIEWER pane. Opening/sizing that pane and waiting for the
-// broker's view.sock are pure tmux + net operations — no canvas-db read. They
-// live here so CLI/viewer consumers (workspace, surface-tmux-spread, sysprompt,
-// viewer.ts) can reach the tmux front door WITHOUT dragging placement.ts's
-// canvas state-store (the focuses table) into their bundle.
-//
-// placement.ts RE-EXPORTS viewerSplitEnv + waitForBrokerViewSocket from here so
-// its existing importers (daemon runtime, handlers) are unchanged, and its
-// openViewerWindow composes openViewerPane (here) + registerViewerFocus (the db
-// write, which stays in placement.ts).
-//
-// §5.1 import-lint: placement-tmux.ts is an allowed direct importer of
-// tmux-driver.ts — it is the sanctioned pure-tmux seam, re-exporting the driver
-// verbs other modules need so they never import the driver directly.
-import { envHomeOverride } from '../../shared/env.js';
-import { paneLocation, ensureSession, openNodeWindow, splitWindow, selectLayout, } from './tmux-driver.js';
-import { BROKER_VIEW_SOCKET_WAIT_MS } from './view-socket.js';
-// Re-export the pure tmux driver verbs the CLI/viewer consumers need without
-// exposing the canvas focuses table or sending command modules to the raw driver.
-export { paneExists, paneLocation, paneOfNode, paneCurrentPath, paneSize, paneRunning, ensureSession, openNodeWindow, splitWindow, closePane, currentTmux, switchClient, selectWindow, selectLayout, selectPane, getPaneOption, setPaneOption, breakPane, inTmux, piCommand, shellQuote, renameWindow, displayPopup, windowOfPane, respawnPaneSync, respawnPaneInBackground, respawnPaneInPlace, paneStartCommand, panePid, windowAlive, listLivePanes, VIEWER_STAMP_OPTION, stampViewerPaneAsync, liveViewerPanes, sendAttachControl, displayClientMessage, } from './tmux-driver.js';
-export { installTmuxBindings } from './tmux-bindings.js';
-// view.sock readiness — the one shared broker-cold-start primitive
-export { BROKER_VIEW_SOCKET_WAIT_MS, waitForBrokerViewSocket } from './view-socket.js';
-// Viewer pane opener (tmux half, NO focus-row write)
-/** Env for a `crtr surface attach` VIEWER pane (the focus split, the spawn viewer
- *  window, AND recycle's re-attach respawn): propagate CRTR_HOME so the viewer
- *  resolves the SAME canvas home — and thus the right view.sock — under a
- *  non-default override; otherwise an empty env (the pane inherits the tmux
- *  server env, like every other crtr chrome pane). One helper so the viewer-pane
- *  sites can't drift. */
-export function viewerSplitEnv() {
-    const crtrHome = envHomeOverride();
-    return crtrHome !== undefined ? { CRTR_HOME: crtrHome } : {};
-}
-/** Open a `crtr surface attach` VIEWER pane for `nodeId` — the PURE tmux half of
- *  placement's openViewerWindow (no focus-row write). Wraps `ensureSession` +
- *  `openNodeWindow`/`splitWindow`. The attach client connects to the node's
- *  `view.sock` and renders/drives the live broker engine — it NEVER launches the
- *  engine (the one-writer invariant; the caller ensures the broker is alive
- *  first). Returns the opened pane's coordinates, or null if tmux refused.
- *    - default → a fresh WINDOW in `session` (the --root spawn-viewer path).
- *    - `besidePane` → a SPLIT beside that pane in its own session (the focus
- *      open-beside-the-caller path); `session` is then only a fallback. */
-export function openViewerPane(nodeId, session, opts = {}) {
-    const command = `crtr surface attach to ${nodeId}`;
-    // When the broker may not have bound view.sock yet (a viewer opened right after
-    // a fresh spawn), hand the attach pane CRTR_ATTACH_WAIT_MS so it POLLS the
-    // socket until it accepts instead of failing fast on a cold socket and closing
-    // the pane instantly — the same self-polling bootRoot/resume rely on. The
-    // deadline is the shared BROKER_VIEW_SOCKET_WAIT_MS (one source of truth), not
-    // a literal duplicated at the call site.
-    const env = {
-        ...viewerSplitEnv(),
-        ...(opts.waitForBroker === true ? { CRTR_ATTACH_WAIT_MS: String(BROKER_VIEW_SOCKET_WAIT_MS) } : {}),
-        ...(opts.initialWhip === true ? { CRTR_ATTACH_INITIAL_WHIP: '1' } : {}),
-    };
-    const cwd = opts.cwd ?? process.cwd();
-    if (opts.besidePane !== undefined) {
-        const pane = splitWindow(opts.besidePane, { cwd, env, command });
-        if (pane === null)
-            return null;
-        const loc = paneLocation(pane);
-        const sess = loc?.session ?? session;
-        const window = loc?.window ?? null;
-        // Rebalance the window to even side-by-side widths. Without this each split
-        // halves the pane it split from, so repeated spawns beside the same pane keep
-        // shrinking (¼, ⅛, …); an even-horizontal relayout gives every viewer in the
-        // window equal width instead. Best-effort — sizing never fails the open.
-        if (window !== null)
-            selectLayout(window, 'even-horizontal');
-        return { pane, session: sess, window };
-    }
-    ensureSession(session, cwd);
-    const opened = openNodeWindow({ session, name: opts.name ?? nodeId, cwd, env, command });
-    if (opened === null)
-        return null;
-    return { pane: opened.pane, session, window: opened.window };
-}
+var w=Object.defineProperty;var s=(e,n)=>w(e,"name",{value:n,configurable:!0});import{envHomeOverride as u}from"../../shared/env.js";import{paneLocation as m,ensureSession as P,openNodeWindow as T,splitWindow as f,selectLayout as _}from"./tmux-driver.js";import{BROKER_VIEW_SOCKET_WAIT_MS as S}from"./view-socket.js";import{paneExists as x,paneLocation as h,paneOfNode as V,paneCurrentPath as g,paneSize as y,paneRunning as B,ensureSession as H,openNodeWindow as L,splitWindow as M,closePane as k,currentTmux as N,switchClient as K,selectWindow as b,selectLayout as z,selectPane as F,getPaneOption as Q,setPaneOption as $,breakPane as j,inTmux as q,piCommand as D,shellQuote as G,renameWindow as J,displayPopup as U,windowOfPane as X,respawnPaneSync as Y,respawnPaneInBackground as Z,respawnPaneInPlace as ee,paneStartCommand as ne,panePid as oe,windowAlive as ie,listLivePanes as te,VIEWER_STAMP_OPTION as re,stampViewerPaneAsync as ae,liveViewerPanes as se,sendAttachControl as ce,displayClientMessage as le}from"./tmux-driver.js";import{installTmuxBindings as de}from"./tmux-bindings.js";import{BROKER_VIEW_SOCKET_WAIT_MS as ue,waitForBrokerViewSocket as me}from"./view-socket.js";function W(){const e=u();return e!==void 0?{CRTR_HOME:e}:{}}s(W,"viewerSplitEnv");function R(e,n,o={}){const c=`crtr surface attach to ${e}`,l={...W(),...o.waitForBroker===!0?{CRTR_ATTACH_WAIT_MS:String(S)}:{},...o.initialWhip===!0?{CRTR_ATTACH_INITIAL_WHIP:"1"}:{}},i=o.cwd??process.cwd();if(o.besidePane!==void 0){const r=f(o.besidePane,{cwd:i,env:l,command:c});if(r===null)return null;const p=m(r),d=p?.session??n,a=p?.window??null;return a!==null&&_(a,"even-horizontal"),{pane:r,session:d,window:a}}P(n,i);const t=T({session:n,name:o.name??e,cwd:i,env:l,command:c});return t===null?null:{pane:t.pane,session:n,window:t.window}}s(R,"openViewerPane");export{ue as BROKER_VIEW_SOCKET_WAIT_MS,re as VIEWER_STAMP_OPTION,j as breakPane,k as closePane,N as currentTmux,le as displayClientMessage,U as displayPopup,H as ensureSession,Q as getPaneOption,q as inTmux,de as installTmuxBindings,te as listLivePanes,se as liveViewerPanes,L as openNodeWindow,R as openViewerPane,g as paneCurrentPath,x as paneExists,h as paneLocation,V as paneOfNode,oe as panePid,B as paneRunning,y as paneSize,ne as paneStartCommand,D as piCommand,J as renameWindow,Z as respawnPaneInBackground,ee as respawnPaneInPlace,Y as respawnPaneSync,z as selectLayout,F as selectPane,b as selectWindow,ce as sendAttachControl,$ as setPaneOption,G as shellQuote,M as splitWindow,ae as stampViewerPaneAsync,K as switchClient,W as viewerSplitEnv,me as waitForBrokerViewSocket,ie as windowAlive,X as windowOfPane};

package/dist/core/runtime/placement.js

@@ -1,386 +1 @@
-// placement.ts — the VIEWER REGISTRY + the model-over-driver tmux front door.
-//
-// After the broker-is-the-host cut the engine NEVER lives in a tmux pane: every
-// node is a detached `headlessBrokerHost` process that binds `view.sock`. A tmux
-// pane is only a surface-attach viewer of that broker, exactly like a web tab. So
-// the whole engine-in-pane placement machinery (hot-swap, resume-into-focus,
-// backstage relocation, remain-on-exit freeze, spread, node-row reconcile) is
-// gone. What remains is:
-//
-//   • The VIEWER REGISTRY — the `focuses` table, schema unchanged, now read as
-//     "node_id -> the node's one viewer %pane in `session`" (UNIQUE(node_id) =
-//     one viewer per node). focusOf/isFocused/focusByPane/focusedNodes/
-//     listFocuses read it (lazily GC'ing rows whose pane is gone or no longer
-//     carries this node's `@crtr_node` tag); registerViewerFocus writes it.
-//   • focus(nodeId) — ensure the broker engine is alive (injected reviver) +
-//     wait view.sock, then ensure the node's ONE viewer pane is forefront: reuse
-//     it wherever it already lives (switching sessions when needed), else open
-//     one beside the caller.
-//   • openViewerWindow / registerViewerFocus — the shared viewer-pane opener +
-//     row registrar used by BOTH spawn (a background viewer window) and focus.
-//   • tearDownNode / detachToBackground — close a node's viewer pane + row.
-//   • The chrome/viewer tmux re-exports (§2.1): placement stays the sanctioned
-//     model-over-driver. Raw driver access is confined to placement, its pure
-//     tmux half, the bindings owner, and tmux chrome.
-import { envNodeId } from '../../shared/env.js';
-import { getNode, fullName, deleteNode, listNodes, subscribersOf, openFocusRow, closeFocusRow, getFocusByNode, getFocusByPane, getFocusById, listFocuses as listFocusRows, } from '../canvas/index.js';
-import { nodeHasAssistantMessage } from '../canvas/render-source.js';
-import { headlessBrokerHost } from './host.js';
-import { fanDoctrineWake } from './close.js';
-import { paneExists, paneLocation, closePane, currentTmux, switchClient, selectWindow, selectLayout, selectPane, getPaneOption, setPaneOption, respawnPaneSync, windowOfPane, renameWindow, } from './tmux-driver.js';
-// The PURE tmux + broker-socket half now lives in placement-tmux.ts. placement
-// composes the viewer OPENER over openViewerPane (tmux) + registerViewerFocus
-// (the db write). viewerSplitEnv + waitForBrokerViewSocket are re-exported here
-// (below) so placement's existing importers (daemon runtime, handlers) are
-// unchanged.
-import { openViewerPane, viewerSplitEnv, waitForBrokerViewSocket } from './placement-tmux.js';
-import { newJobId } from './nodes.js';
-import { isPidAlive } from '../canvas/pid.js';
-// Placement is the sanctioned model-over-driver (§2.1): non-placement runtime /
-// command modules that legitimately need a raw driver verb get it from here.
-// These are the chrome + viewer verbs that survive the cut (the engine-in-pane
-// verbs — respawnPane, respawnPaneDetached, swapPaneInPlace, breakPaneToSession,
-// joinPane, setWindowOption, setRemainOnExit — are deleted). `breakPane` +
-// `selectLayout` are FRESH minimal viewer-chrome helpers (not the deleted
-// engine-in-pane `breakPaneToSession`): `surface tmux-spread` breaks the caller's
-// viewer pane into its own window and tiles sibling viewers beside it.
-// `piCommand`, `paneCurrentPath`, and `shellQuote` remain available to command
-// modules that need to build or inspect tmux pane commands without importing
-// tmux-driver.ts directly.
-export { splitWindow, breakPane, selectLayout, selectPane, focusWindow, selectWindow, switchClient, openNodeWindow, ensureSession, paneLocation, paneExists, paneRunning, paneCurrentPath, currentTmux, inTmux, paneOfNode, setPaneOption, getPaneOption, piCommand, shellQuote, respawnPaneSync, closePane, displayPopup, windowOfPane, renameWindow, paneOfWindow, windowAlive, listLivePanes, listLivePanesAsync, } from './tmux-driver.js';
-export { installTmuxBindings } from './tmux-bindings.js';
-// Viewer registry reads — COMPOSE over the canvas focuses table (§2.3/§4).
-//
-// placement is the front door for "which nodes have a viewer on screen"; the SQL
-// lives in the canvas layer (canvas/focuses.ts) and placement just reads it. A
-// node has at most one viewer (UNIQUE node_id), so focusOf returns a single row.
-//
-// GC is lazy on read: a row whose viewer pane no longer exists (the user closed
-// the window, the attach client died) is pruned the next time it is read, so the
-// registry self-heals without a sweeper.
-/** Prune a viewer row whose pane is gone; return it iff its pane is still live. */
-function liveOrPrune(f) {
-    if (f === null)
-        return null;
-    if (f.pane !== null && !paneExists(f.pane)) {
-        closeFocusRow(f.focus_id);
-        return null;
-    }
-    return f;
-}
-/** The viewer a node has on screen, or null. UNIQUE(node_id) ⇒ at most one. */
-export function focusOf(nodeId) {
-    return liveOrPrune(getFocusByNode(nodeId));
-}
-/** Does this node have a live viewer on screen? */
-export function isFocused(nodeId) {
-    return focusOf(nodeId) !== null;
-}
-/** The viewer realized by a given pane (`%id`), or null. */
-export function focusByPane(pane) {
-    return liveOrPrune(getFocusByPane(pane));
-}
-/** The set of node ids that currently have a live viewer. */
-export function focusedNodes() {
-    return new Set(listFocuses().map((f) => f.node_id));
-}
-/** Every live viewer row (GC'ing any whose pane has gone). */
-export function listFocuses() {
-    const live = [];
-    for (const f of listFocusRows()) {
-        if (liveOrPrune(f) !== null)
-            live.push(f);
-    }
-    return live;
-}
-function newFocusId() {
-    return `f-${newJobId()}`;
-}
-/** Register a `crtr surface attach` VIEWER pane as the node's one viewer focus row.
- *  UNIQUE(node_id) ⇒ one viewer per node: returns
- *  the existing row (no insert) when the pane or the node is already registered.
- *  `window` is accepted for the call contract (spawn passes it) but not stored —
- *  the focuses table keys on pane + session only. The attach client self-tags the
- *  pane `@crtr_node` on connect, so `nodeInPane` resolves it either way. */
-export function registerViewerFocus(nodeId, pane, session, window) {
-    void window;
-    const byPane = getFocusByPane(pane);
-    if (byPane !== null)
-        return byPane;
-    const byNode = getFocusByNode(nodeId);
-    if (byNode !== null)
-        return byNode;
-    const focusId = newFocusId();
-    openFocusRow(focusId, pane, session, nodeId);
-    return getFocusById(focusId);
-}
-/** Open a surface-attach viewer for `nodeId` and register its viewer focus row —
- *  the shared opener used by `focus` (a split beside the caller) and by a --root
- *  spawn (a fresh window in the caller's current session). Wraps `ensureSession`
- *  + `openNodeWindow`/`splitWindow` + `registerViewerFocus`. The attach client
- *  connects to the node's `view.sock` and renders/drives the live broker engine
- *  — it NEVER launches the engine (the one-writer invariant; the caller ensures
- *  the broker is alive first). Returns the registered viewer row, or null if tmux
- *  refused.
- *    - default → a fresh WINDOW in `session` (the --root spawn-viewer path).
- *    - `besidePane` → a SPLIT beside that pane in its own session (the focus
- *      open-beside-the-caller path); `session` is then only a fallback. */
-export function openViewerWindow(nodeId, session, opts = {}) {
-    const opened = openViewerPane(nodeId, session, opts);
-    if (opened === null)
-        return null;
-    return registerViewerFocus(nodeId, opened.pane, opened.session, opened.window);
-}
-// focus — the front door for `surface node focus` / `surface node cycle` / nav (§A.4)
-/** Bring a node's ONE viewer pane forefront (§A.4). Every node is a detached
- *  broker, so there is no engine pane to swap into the caller's viewport — focus
- *  instead ensures the node's single surface-attach viewer is on screen beside (or
- *  navigated to) the caller:
- *    (a) ensure the broker ENGINE is alive (idempotent injected reviver) and its
- *        view.sock is ACCEPTING (closes the cold-start race against attach's
- *        single connect) — without this the freshly-opened viewer would exit
- *        "no broker".
- *    (b) `--new-pane` → always a fresh viewer beside the caller (e.g. two
- *        different nodes side by side); drop any prior viewer first (UNIQUE).
- *    (c) the node already has a live viewer ⇒ navigate to it in place
- *        (switchClient+selectWindow+selectPane), including when it lives in a
- *        different session. The viewer's established spatial home wins over
- *        opening or moving a duplicate beside the caller.
- *    (d) no live viewer ⇒ open one beside the caller and register the row.
- *
- *  crtr is tmux-only: with no caller pane there is no viewport to open and no
- *  non-tmux fallback — report not-focused. */
-/** After a viewer pane is opened/moved beside the caller, make it the ACTIVE
- *  pane and rebalance its window's panes to an even side-by-side layout — so
- *  picking a node (e.g. from the alt+g graph) lands the keyboard on the fresh
- *  viewer and the panes are evenly sized again, not halved. Best-effort. */
-function surfaceNewPane(pane) {
-    const win = paneLocation(pane)?.window ?? null;
-    if (win !== null)
-        selectLayout(win, 'even-horizontal');
-    selectPane(pane);
-}
-export async function focus(nodeId, opts) {
-    const meta = getNode(nodeId);
-    if (meta === null)
-        return { focused: false, session: null, inPlace: false, revived: false };
-    const callerPane = opts.pane ?? process.env['TMUX_PANE'] ?? currentTmux()?.pane;
-    if (callerPane === undefined || callerPane === '') {
-        return { focused: false, session: null, inPlace: false, revived: false };
-    }
-    // (a) Ensure the broker engine is alive + its view.sock accepts. Capture prior
-    //     liveness so the result reports whether THIS focus had to launch it.
-    const wasAlive = isPidAlive(meta.pi_pid ?? null);
-    const revivedLaunch = opts.revive(nodeId);
-    const revived = !wasAlive;
-    if (!(await waitForBrokerViewSocket(nodeId, revivedLaunch?.launch?.exited))) {
-        return { focused: false, session: null, inPlace: false, revived };
-    }
-    // focus always opens BESIDE the caller pane, so `fallbackSession` is only the
-    // session name openViewerWindow falls back to if it cannot read the freshly
-    // split pane's location — the caller's own session.
-    const callerSession = paneLocation(callerPane)?.session ?? null;
-    const fallbackSession = callerSession ?? '';
-    // (b0) --in-place → the CALLER pane BECOMES this node's viewer, replacing
-    //      whatever it showed (the attach subagent scroll+swap: ↓ into the reports
-    //      roster, Enter dives into that child right here, no new split). This
-    //      re-execs the caller pane via `respawn-pane -k`, so it MUST be driven
-    //      from OUTSIDE that pane's process tree (the viewer shells this through
-    //      `tmux run-shell`, never a direct child) — else the respawn kills its own
-    //      driver mid-call. Move the child's viewer here if it had one elsewhere
-    //      (UNIQUE one-viewer-per-node) and drop the caller pane's prior viewer row
-    //      (that node's broker keeps running headless, reconnectable by a later
-    //      focus). The respawned `crtr surface attach` replays scrollback from the
-    //      welcome snapshot and self-tags the pane `@crtr_node`.
-    if (opts.inPlace === true) {
-        const prior = focusOf(nodeId);
-        if (prior !== null) {
-            if (prior.pane !== null && prior.pane !== callerPane && paneExists(prior.pane))
-                closePane(prior.pane);
-            closeFocusRow(prior.focus_id);
-        }
-        const here = getFocusByPane(callerPane);
-        if (here !== null && here.node_id !== nodeId)
-            closeFocusRow(here.focus_id);
-        // Clear the stale tag before respawn so it never names the wrong node during
-        // the gap before the fresh attach re-tags on connect.
-        try {
-            setPaneOption(callerPane, '@crtr_node', '');
-        }
-        catch { /* best-effort */ }
-        const window = windowOfPane(callerPane);
-        // Continuity: the fresh viewer highlights the previously open node, which
-        // becomes visible in its self-excluding roster after the swap.
-        const priorNodeId = here?.node_id;
-        const env = priorNodeId === undefined
-            ? viewerSplitEnv()
-            : { ...viewerSplitEnv(), CRTR_ATTACH_ROSTER: priorNodeId };
-        const ok = respawnPaneSync({ pane: callerPane, cwd: meta.cwd, env, command: `crtr surface attach to ${nodeId}` });
-        if (ok) {
-            if (window !== null)
-                renameWindow(window, fullName(meta));
-            registerViewerFocus(nodeId, callerPane, callerSession, window);
-        }
-        return { focused: ok, session: callerSession, inPlace: true, revived };
-    }
-    // (b) --new-pane → always a fresh viewer beside the caller. Drop any prior
-    //     viewer this node holds elsewhere (UNIQUE(node_id): one viewer per node).
-    if (opts.newPane === true) {
-        const prior = focusOf(nodeId);
-        if (prior !== null) {
-            if (prior.pane !== null && paneExists(prior.pane))
-                closePane(prior.pane);
-            closeFocusRow(prior.focus_id);
-        }
-        const opened = openViewerWindow(nodeId, fallbackSession, { cwd: meta.cwd, besidePane: callerPane });
-        if (opened === null)
-            return { focused: false, session: null, inPlace: false, revived };
-        if (opened.pane !== null)
-            surfaceNewPane(opened.pane);
-        return { focused: true, session: opened.session, inPlace: false, revived };
-    }
-    // (c) Reuse / move the node's one live viewer — but ONLY a pane that still
-    //     carries THIS node's `@crtr_node` tag. `paneExists` is not enough: the
-    //     front-door root registers the user's own terminal as its viewer pane and
-    //     runs `crtr surface attach` inline; on a clean detach the pane returns to the
-    //     user's shell (attach clears the tag) yet the pane — and the row — survive,
-    //     and a reused pane carries some OTHER node's tag. Navigating to / closing
-    //     such a pane would strand the user on (or kill) their shell. So verify the
-    //     tag names this node; on mismatch the row is stale → prune it and fall
-    //     through to open a fresh viewer beside the caller.
-    const existing = focusOf(nodeId);
-    if (existing !== null && existing.pane !== null) {
-        if (getPaneOption(existing.pane, '@crtr_node') === nodeId) {
-            const loc = paneLocation(existing.pane);
-            if (loc !== null) {
-                // Navigate to the viewer wherever it already lives. For a cross-session
-                // target, switch-client carries this tmux client to that session; for a
-                // same-session target it is an idempotent no-op. Never destroy and reopen
-                // a viewer merely because its established pane lives in another session.
-                switchClient(loc.session);
-                selectWindow(loc.session, loc.window);
-                selectPane(existing.pane);
-                return { focused: true, session: loc.session, inPlace: true, revived };
-            }
-            // The row names a pane that vanished between focusOf() and paneLocation().
-            // Prune it and fall through to opening the node's one viewer beside caller.
-            closeFocusRow(existing.focus_id);
-        }
-        else {
-            // Pane survived but no longer hosts this node's viewer (clean detach left
-            // the user's shell, or the pane was reused) — drop the stale row only; do
-            // NOT closePane (it is the user's shell / another node's viewer).
-            closeFocusRow(existing.focus_id);
-        }
-    }
-    // (d) No live viewer → open one beside the caller and register the row.
-    const opened = openViewerWindow(nodeId, fallbackSession, { cwd: meta.cwd, besidePane: callerPane });
-    if (opened === null)
-        return { focused: false, session: null, inPlace: false, revived };
-    if (opened.pane !== null)
-        surfaceNewPane(opened.pane);
-    return { focused: true, session: opened.session, inPlace: false, revived };
-}
-// Teardown / detach — close a node's viewer pane + row
-/** Tear a node off its viewer (close/reset/cancel teardown). The broker engine
- *  is killed by its own host teardown over view.sock — this only closes the
- *  on-screen viewer: kill its pane (the window collapses once its last pane goes)
- *  and drop its registry row. Best-effort tmux; the DB write always lands. No-op
- *  when the node has no viewer. */
-export function tearDownNode(nodeId, keepPane) {
-    const f = focusOf(nodeId);
-    if (f === null)
-        return; // no viewer (focusOf already GC'd a gone one)
-    // `keepPane` is a BORROWED pane crtr did not create — the front-door root's
-    // viewer runs inside the user's own pre-existing shell pane (bootRoot registers
-    // that shell pane as the viewer focus). Killing it here would take the user's
-    // shell down with the node, closing the whole tmux pane on a plain ctrl+c
-    // detach. crtr must never kill a pane it merely borrowed: drop the row, let the
-    // pane fall back to its shell when the viewer process exits.
-    if (f.pane !== null && f.pane !== keepPane && paneExists(f.pane))
-        closePane(f.pane);
-    closeFocusRow(f.focus_id);
-}
-/** Detach a node from the foreground (the `node lifecycle demote --detach` / Alt+C → D
- *  half). Every node is a headless broker — the only thing on screen is its
- *  surface-attach viewer pane — so "detach" means STOP FOREGROUNDING it: close the
- *  viewer pane (and drop its row) and leave the broker engine running untouched,
- *  reconnectable by a later `focus`. `pane` is the authoritative pane the caller
- *  acts on (the Alt+C menu's `#{pane_id}`); falls back to the node's registered
- *  viewer pane. No-op (false) when there is no live viewer pane to close. */
-export function detachToBackground(nodeId, pane) {
-    const viewer = pane ?? focusOf(nodeId)?.pane ?? null;
-    if (viewer === null || !paneExists(viewer))
-        return false;
-    const f = focusByPane(viewer);
-    if (f !== null)
-        closeFocusRow(f.focus_id);
-    const closed = closePane(viewer);
-    // A node the user detached from that never produced any AI output is a useless
-    // shell taking up graph + disk space — reap it (engine + row + dir) outright
-    // rather than leaving an empty broker running headless off-screen.
-    reapIfEmpty(nodeId);
-    return closed;
-}
-// Reaping empty nodes (no AI output) on close / detach
-/** Is this node an EMPTY SHELL right now — a node whose engine never produced an
- *  assistant message? Such nodes are pure dead weight on the graph. A node
- *  actively generating its FIRST turn is NOT empty (its output just hasn't landed
- *  on disk yet), so streaming nodes are spared. */
-function isEmptyNode(nodeId) {
-    const m = getNode(nodeId);
-    if (m === null)
-        return false;
-    if (m.streaming === true)
-        return false;
-    return !nodeHasAssistantMessage(m.pi_session_file);
-}
-/** Reap `nodeId` IFF it is an empty shell (see {@link isEmptyNode}): tear down its
- *  broker engine, close any viewer, and hard-delete its row (edges cascade) + dir.
- *  The user closing or detaching from a node that never said anything wants it
- *  GONE, not parked as a canceled husk — except an OPEN managed worktree keeps
- *  its node identity so the worktree remains owned and can later be closed.
- *  Returns true when it reaped. No-op (false) on a node that produced output,
- *  is mid-first-turn, owns an open managed worktree, or no longer exists. */
-export function reapIfEmpty(nodeId, keepPane, teardown = true) {
-    const meta = getNode(nodeId);
-    if (meta?.managed_worktree?.state === 'open' || !isEmptyNode(nodeId))
-        return false;
-    if (teardown)
-        void headlessBrokerHost.teardown(nodeId);
-    tearDownNode(nodeId, keepPane);
-    return deleteNode(nodeId).deleted;
-}
-/** Sweep the whole canvas for empty shells and reap them — the bulk cleanup
- *  behind `crtr canvas prune --empty`, for the husks that accumulated before
- *  close/detach learned to reap. Skips: the caller ($CRTR_NODE_ID), dead rows,
- *  nodes mid-first-turn, and any node with a LIVE broker (pi_pid alive) — a
- *  running engine is the daemon's domain and may have output not yet persisted,
- *  so bulk GC never kills one (the per-action {@link reapIfEmpty} does, since
- *  the user explicitly closed/detached that node). `dryRun` reports candidates
- *  without deleting. Returns the reaped (or, under dryRun, reapable) node ids. */
-export function reapEmptyNodes(opts = {}) {
-    const dryRun = opts.dryRun ?? false;
-    const selfId = envNodeId() ?? '';
-    const reaped = [];
-    for (const row of listNodes()) {
-        const id = row.node_id;
-        const meta = getNode(id);
-        if (id === selfId
-            || row.status === 'dead'
-            || isPidAlive(row.pi_pid)
-            || meta?.managed_worktree?.state === 'open'
-            || !isEmptyNode(id))
-            continue;
-        const subscribers = subscribersOf(id);
-        if (!dryRun) {
-            fanDoctrineWake(id, subscribers, `Child closed — ${meta?.name ?? id} (${id}) was closed from the canvas and is no longer running.`, { reason: 'child-closed', child: id });
-            headlessBrokerHost.teardown(id);
-            tearDownNode(id);
-            if (!deleteNode(id).deleted)
-                continue;
-        }
-        reaped.push(id);
-    }
-    return reaped;
-}
+var V=Object.defineProperty;var r=(e,n)=>V(e,"name",{value:n,configurable:!0});import{envNodeId as $}from"../../shared/env.js";import{getNode as P,fullName as H,deleteNode as O,listNodes as D,subscribersOf as M,openFocusRow as z,closeFocusRow as a,getFocusByNode as b,getFocusByPane as x,getFocusById as J,listFocuses as Q}from"../canvas/index.js";import{nodeHasAssistantMessage as U}from"../canvas/render-source.js";import{headlessBrokerHost as k}from"./host.js";import{fanDoctrineWake as X}from"./close.js";import{paneExists as w,paneLocation as y,closePane as v,currentTmux as j,switchClient as q,selectWindow as G,selectLayout as K,selectPane as R,getPaneOption as Y,setPaneOption as Z,respawnPaneSync as I,windowOfPane as ee,renameWindow as ne}from"./tmux-driver.js";import{openViewerPane as se,viewerSplitEnv as T,waitForBrokerViewSocket as oe}from"./placement-tmux.js";import{newJobId as ie}from"./nodes.js";import{isPidAlive as W}from"../canvas/pid.js";import{splitWindow as be,breakPane as ke,selectLayout as Re,selectPane as Te,focusWindow as We,selectWindow as Se,switchClient as Ae,openNodeWindow as Be,ensureSession as Ee,paneLocation as Ce,paneExists as Le,paneRunning as Ve,paneCurrentPath as $e,currentTmux as He,inTmux as De,paneOfNode as Me,setPaneOption as ze,getPaneOption as Je,piCommand as Qe,shellQuote as Ue,respawnPaneSync as Xe,closePane as je,displayPopup as qe,windowOfPane as Ge,renameWindow as Ke,paneOfWindow as Ye,windowAlive as Ze,listLivePanes as Ie,listLivePanesAsync as en}from"./tmux-driver.js";import{installTmuxBindings as sn}from"./tmux-bindings.js";function h(e){return e===null?null:e.pane!==null&&!w(e.pane)?(a(e.focus_id),null):e}r(h,"liveOrPrune");function p(e){return h(b(e))}r(p,"focusOf");function xe(e){return p(e)!==null}r(xe,"isFocused");function te(e){return h(x(e))}r(te,"focusByPane");function ye(){return new Set(re().map(e=>e.node_id))}r(ye,"focusedNodes");function re(){const e=[];for(const n of Q())h(n)!==null&&e.push(n);return e}r(re,"listFocuses");function le(){return`f-${ie()}`}r(le,"newFocusId");function S(e,n,s,o){const u=x(n);if(u!==null)return u;const t=b(e);if(t!==null)return t;const l=le();return z(l,n,s,e),J(l)}r(S,"registerViewerFocus");function A(e,n,s={}){const o=se(e,n,s);return o===null?null:S(e,o.pane,o.session,o.window)}r(A,"openViewerWindow");function B(e){const n=y(e)?.window??null;n!==null&&K(n,"even-horizontal"),R(e)}r(B,"surfaceNewPane");async function he(e,n){const s=P(e);if(s===null)return{focused:!1,session:null,inPlace:!1,revived:!1};const o=n.pane??process.env.TMUX_PANE??j()?.pane;if(o===void 0||o==="")return{focused:!1,session:null,inPlace:!1,revived:!1};const u=W(s.pi_pid??null),t=n.revive(e),l=!u;if(!await oe(e,t?.launch?.exited))return{focused:!1,session:null,inPlace:!1,revived:l};const d=y(o)?.session??null,g=d??"";if(n.inPlace===!0){const i=p(e);i!==null&&(i.pane!==null&&i.pane!==o&&w(i.pane)&&v(i.pane),a(i.focus_id));const c=x(o);c!==null&&c.node_id!==e&&a(c.focus_id);try{Z(o,"@crtr_node","")}catch{}const _=ee(o),N=c?.node_id,L=N===void 0?T():{...T(),CRTR_ATTACH_ROSTER:N},F=I({pane:o,cwd:s.cwd,env:L,command:`crtr surface attach to ${e}`});return F&&(_!==null&&ne(_,H(s)),S(e,o,d,_)),{focused:F,session:d,inPlace:!0,revived:l}}if(n.newPane===!0){const i=p(e);i!==null&&(i.pane!==null&&w(i.pane)&&v(i.pane),a(i.focus_id));const c=A(e,g,{cwd:s.cwd,besidePane:o});return c===null?{focused:!1,session:null,inPlace:!1,revived:l}:(c.pane!==null&&B(c.pane),{focused:!0,session:c.session,inPlace:!1,revived:l})}const f=p(e);if(f!==null&&f.pane!==null)if(Y(f.pane,"@crtr_node")===e){const i=y(f.pane);if(i!==null)return q(i.session),G(i.session,i.window),R(f.pane),{focused:!0,session:i.session,inPlace:!0,revived:l};a(f.focus_id)}else a(f.focus_id);const m=A(e,g,{cwd:s.cwd,besidePane:o});return m===null?{focused:!1,session:null,inPlace:!1,revived:l}:(m.pane!==null&&B(m.pane),{focused:!0,session:m.session,inPlace:!1,revived:l})}r(he,"focus");function E(e,n){const s=p(e);s!==null&&(s.pane!==null&&s.pane!==n&&w(s.pane)&&v(s.pane),a(s.focus_id))}r(E,"tearDownNode");function ge(e,n){const s=n??p(e)?.pane??null;if(s===null||!w(s))return!1;const o=te(s);o!==null&&a(o.focus_id);const u=v(s);return ue(e),u}r(ge,"detachToBackground");function C(e){const n=P(e);return n===null||n.streaming===!0?!1:!U(n.pi_session_file)}r(C,"isEmptyNode");function ue(e,n,s=!0){return P(e)?.managed_worktree?.state==="open"||!C(e)?!1:(s&&k.teardown(e),E(e,n),O(e).deleted)}r(ue,"reapIfEmpty");function Ne(e={}){const n=e.dryRun??!1,s=$()??"",o=[];for(const u of D()){const t=u.node_id,l=P(t);if(t===s||u.status==="dead"||W(u.pi_pid)||l?.managed_worktree?.state==="open"||!C(t))continue;const d=M(t);!n&&(X(t,d,`Child closed \u2014 ${l?.name??t} (${t}) was closed from the canvas and is no longer running.`,{reason:"child-closed",child:t}),k.teardown(t),E(t),!O(t).deleted)||o.push(t)}return o}r(Ne,"reapEmptyNodes");export{ke as breakPane,je as closePane,He as currentTmux,ge as detachToBackground,qe as displayPopup,Ee as ensureSession,he as focus,te as focusByPane,p as focusOf,We as focusWindow,ye as focusedNodes,Je as getPaneOption,De as inTmux,sn as installTmuxBindings,xe as isFocused,re as listFocuses,Ie as listLivePanes,en as listLivePanesAsync,Be as openNodeWindow,A as openViewerWindow,$e as paneCurrentPath,Le as paneExists,Ce as paneLocation,Me as paneOfNode,Ye as paneOfWindow,Ve as paneRunning,Qe as piCommand,Ne as reapEmptyNodes,ue as reapIfEmpty,S as registerViewerFocus,Ke as renameWindow,Xe as respawnPaneSync,Re as selectLayout,Te as selectPane,Se as selectWindow,ze as setPaneOption,Ue as shellQuote,be as splitWindow,Ae as switchClient,E as tearDownNode,Ze as windowAlive,Ge as windowOfPane};