@north-light/crouter 0.3.317 → 0.3.319

package/dist/clients/attach/session/connection.js

@@ -1,186 +1 @@
-// session/connection.ts — how a viewer gets onto a broker: resolving the
-// local or remote attach target, dialing it, the role it claims in the hello
-// handshake, and the optional pre-wait for a socket still being bound.
-//
-// Everything here runs BEFORE the TUI takes over the terminal, which is the
-// point: a missing broker must exit non-zero with a plain CLI error, not paint
-// an alternate screen first. Nothing here launches anything — attach holds ONLY
-// a socket; the engine is started server-side by crtrd (`reviveNode`, the one
-// sanctioned launcher), never here.
-import { createConnection } from 'node:net';
-import { viewSocketPath } from '../../../core/canvas/paths.js';
-import { BrokerClient, BrokerUnavailableError, RelayTransport } from '../../../core/broker-client/index.js';
-import { resolveRemoteCanvasTarget } from '../../../core/remote-canvas-target.js';
-import { ApiCanvasSource, cliCanvasSource, cliClient, rethrowAsCliError } from '../../../commands/api-client.js';
-import { InputError } from '../../../core/io.js';
-/** The hello handshake's initial role. A REMOTE attach (`--canvas`) is a
- *  strictly VIEW-ONLY surface — it must claim observer regardless of
- *  `--observer`, never controller. Local attach claims controller unless
- *  `--observer`. Pure so the "remote is always observer" contract is testable
- *  without constructing a real hello/socket. */
-export function resolveHelloRole(remote, observer) {
-    return remote || observer ? 'observer' : 'controller';
-}
-/** bootRoot spawns the viewer BEFORE its freshly-launched broker has bound
- *  view.sock, so the viewer's own CLI boot (~0.4s of module load) overlaps the
- *  broker's ~1s startup instead of serializing after it. When that spawner set
- *  CRTR_ATTACH_WAIT_MS, poll the socket with throwaway probe connects until it
- *  accepts or the deadline passes — then fall through and let the normal
- *  one-shot connect race surface the usual BrokerUnavailableError. Without the
- *  env var this is a no-op: a plain `crtr surface attach` keeps its fail-fast
- *  "attach does NOT launch the engine" contract. */
-export async function preWaitForViewSocket(nodeId) {
-    const waitMs = Number(process.env['CRTR_ATTACH_WAIT_MS'] ?? '');
-    if (!Number.isFinite(waitMs) || waitMs <= 0)
-        return;
-    const sockPath = viewSocketPath(nodeId);
-    const deadline = Date.now() + waitMs;
-    while (Date.now() < deadline) {
-        const ok = await new Promise((resolveProbe) => {
-            const probe = createConnection(sockPath);
-            const settle = (v) => {
-                probe.destroy();
-                resolveProbe(v);
-            };
-            probe.once('connect', () => settle(true));
-            probe.once('error', () => settle(false));
-        });
-        if (ok)
-            return;
-        await new Promise((r) => setTimeout(r, 100));
-    }
-}
-/** Resolve the target, revive the node if it is dormant (server-side), and dial
- *  the broker. Rejects with a plain `InputError` — no terminal has been taken
- *  over at this point, so a failure here is an ordinary non-zero CLI exit. */
-export async function connectToNode(nodeId, canvasName, wakeParked = true) {
-    const remote = canvasName !== undefined;
-    // Attach must NOT silently honor a durable `crtr canvas use` selection: the
-    // local branch has a hard local-unix-socket assumption baked into its
-    // not-found and reconnect-give-up handling, so an implicit remote redirect
-    // (from a `canvas use cloud` some other command left active) would be
-    // surprising for a command whose whole meaning is "attach to a node on THIS
-    // canvas". Go remote ONLY when `--canvas` was passed on THIS invocation —
-    // never fall through to resolveCanvasSource's activeCanvas precedence, which
-    // is right for `node inspect`/`canvas browse` but not here.
-    const canvasSource = remote ? cliCanvasSource({ canvasName }) : new ApiCanvasSource();
-    // A remote node id never exists in THIS machine's canvas.db, so the local
-    // not-found guard is wrong for `--canvas`. Build a minimal local `meta`
-    // stand-in instead: `meta.cwd` is a legitimately viewer-local concern
-    // (theming, this pane's own git status) — not a remote-node concern — so
-    // pointing it at the CLI's own cwd is correct, not a hack. The `getRow`-based
-    // reconnect give-up is the other local-canvas dependency `--canvas` must skip;
-    // it gates on `remote` at its own use site, not here.
-    let meta;
-    let nodeIdentity;
-    let transport;
-    let initialSnapshot;
-    let initialCommands;
-    if (remote) {
-        meta = { cwd: process.cwd() };
-        transport = new RelayTransport(nodeId, resolveRemoteCanvasTarget(canvasName));
-    }
-    else {
-        const localMeta = await canvasSource.getNode(nodeId);
-        if (localMeta === null) {
-            throw new InputError({
-                error: 'not_found',
-                message: `no node: ${nodeId}`,
-                received: nodeId,
-                next: 'List nodes with `crtr node inspect list`.',
-            });
-        }
-        meta = localMeta;
-        nodeIdentity = localMeta;
-        // Attach revives a dormant node (B2 acceptance): the server-side
-        // ensureAttach runs reviveNode (the ONE sanctioned launcher) and waits for
-        // the broker's view socket, returning socket_path === viewSocketPath(nodeId).
-        // The byte relay stays a direct local view.sock hop, so we only TRIGGER the
-        // revive here and let BrokerClient(nodeId) connect over the local socket as
-        // before — this LOCAL process never launches pi or writes the session.
-        try {
-            const attach = await cliClient().ensureAttach(nodeId, { resume: true, revive: true, wakeParked });
-            if (attach.parked) {
-                const saved = await cliClient().getSnapshot(nodeId);
-                // The API DTO stays dependency-light and structural; this viewer is the
-                // consumer that knows the complete broker snapshot contract.
-                initialSnapshot = saved.snapshot;
-                initialCommands = saved.commands;
-            }
-        }
-        catch (err) {
-            rethrowAsCliError(err, 'The node may be finalized or otherwise not attachable.');
-        }
-        // Local only: remote attach reaches crtrd over WebSocket rather than a
-        // local socket file, so `--canvas` has nothing to pre-wait on. An offline
-        // parked focus has deliberately no socket to wait for.
-        if (initialSnapshot === undefined)
-            await preWaitForViewSocket(nodeId);
-    }
-    const socket = new BrokerClient(nodeId, { transport });
-    /** One error shape for a connect-time failure, whether the connect race below
-     *  caught it or the deferred `assertConnected` checkpoint did. */
-    const toAttachError = (err) => {
-        if (err instanceof BrokerUnavailableError) {
-            return new InputError({
-                error: 'no_broker',
-                message: err.message,
-                received: nodeId,
-                next: 'Focus or revive the node first — attach needs a running headless broker.',
-            });
-        }
-        return new InputError({
-            error: 'socket_error',
-            message: `could not attach to node ${nodeId}: ${String(err?.message ?? err)}`,
-            received: nodeId,
-            next: 'Check the node has a running headless broker.',
-        });
-    };
-    // A remote crtrd attach connection can close after its WebSocket upgrade when
-    // its broker socket drops. Install a listener before dialing and keep it
-    // through synchronous TUI/editor setup, so `assertConnected` can surface any
-    // terminal startup failure at its one checkpoint immediately before permanent
-    // socket wiring. Failures after that are mid-session and belong to the
-    // reconnect supervisor, as they do for a local socket.
-    let terminalStartupError;
-    socket.on('error', (err) => {
-        if (terminalStartupError === undefined)
-            terminalStartupError = err;
-    });
-    // Connect FIRST (race connect/error) so a missing broker exits non-zero
-    // cleanly, BEFORE the TUI takes over the terminal. Offline parked focus is
-    // the one intentional exception: reconnect owns its first dial after paint.
-    if (initialSnapshot === undefined) {
-        await new Promise((resolve, reject) => {
-            const onConnect = () => {
-                cleanup();
-                resolve();
-            };
-            const onErr = (err) => {
-                cleanup();
-                reject(err);
-            };
-            const cleanup = () => {
-                socket.off('connect', onConnect);
-                socket.off('error', onErr);
-            };
-            socket.on('connect', onConnect);
-            socket.on('error', onErr);
-            socket.connect();
-        }).catch((err) => {
-            throw toAttachError(err);
-        });
-    }
-    return {
-        remote,
-        canvasSource,
-        meta,
-        nodeIdentity,
-        socket,
-        ...(initialSnapshot === undefined ? {} : { initialSnapshot, initialCommands }),
-        assertConnected: () => {
-            if (initialSnapshot === undefined && terminalStartupError !== undefined)
-                throw toAttachError(terminalStartupError);
-        },
-    };
-}
+var S=Object.defineProperty;var o=(e,r)=>S(e,"name",{value:r,configurable:!0});import{createConnection as T}from"node:net";import{viewSocketPath as y}from"../../../core/canvas/paths.js";import{BrokerClient as A,BrokerUnavailableError as x,RelayTransport as E}from"../../../core/broker-client/index.js";import{resolveRemoteCanvasTarget as _}from"../../../core/remote-canvas-target.js";import{ApiCanvasSource as P,cliCanvasSource as R,cliClient as g,rethrowAsCliError as F}from"../../../commands/api-client.js";import{InputError as d}from"../../../core/io.js";function L(e,r){return e||r?"observer":"controller"}o(L,"resolveHelloRole");async function M(e){const r=Number(process.env.CRTR_ATTACH_WAIT_MS??"");if(!Number.isFinite(r)||r<=0)return;const w=y(e),c=Date.now()+r;for(;Date.now()<c;){if(await new Promise(i=>{const s=T(w),l=o(n=>{s.destroy(),i(n)},"settle");s.once("connect",()=>l(!0)),s.once("error",()=>l(!1))}))return;await new Promise(i=>setTimeout(i,100))}}o(M,"preWaitForViewSocket");async function U(e,r,w=!0){const c=r!==void 0,h=c?R({canvasName:r}):new P;let i,s,l,n,p;if(c)i={cwd:process.cwd()},l=new E(e,_(r));else{const t=await h.getNode(e);if(t===null)throw new d({error:"not_found",message:`no node: ${e}`,received:e,next:"List nodes with `crtr node inspect list`."});i=t,s=t;try{if((await g().ensureAttach(e,{resume:!0,revive:!0,wakeParked:w})).parked){const u=await g().getSnapshot(e);n=u.snapshot,p=u.commands}}catch(m){F(m,"The node may be finalized or otherwise not attachable.")}n===void 0&&await M(e)}const a=new A(e,{transport:l}),v=o(t=>t instanceof x?new d({error:"no_broker",message:t.message,received:e,next:"Focus or revive the node first \u2014 attach needs a running headless broker."}):new d({error:"socket_error",message:`could not attach to node ${e}: ${String(t?.message??t)}`,received:e,next:"Check the node has a running headless broker."}),"toAttachError");let f;return a.on("error",t=>{f===void 0&&(f=t)}),n===void 0&&await new Promise((t,m)=>{const u=o(()=>{C(),t()},"onConnect"),k=o(b=>{C(),m(b)},"onErr"),C=o(()=>{a.off("connect",u),a.off("error",k)},"cleanup");a.on("connect",u),a.on("error",k),a.connect()}).catch(t=>{throw v(t)}),{remote:c,canvasSource:h,meta:i,nodeIdentity:s,socket:a,...n===void 0?{}:{initialSnapshot:n,initialCommands:p},assertConnected:o(()=>{if(n===void 0&&f!==void 0)throw v(f)},"assertConnected")}}o(U,"connectToNode");export{U as connectToNode,M as preWaitForViewSocket,L as resolveHelloRole};

package/dist/clients/attach/session/context.js

@@ -1,16 +0,0 @@
-// session/context.ts — the named home for an attach session's STABLE facts.
-//
-// Held as closure locals inside `runAttach`, pulling any block out of it would
-// mean inventing a bespoke parameter list for that block alone.
-// `AttachSession` gives the state one declaration; each
-// collaborator then names the slice it needs as a `Pick<AttachSession, …>`
-// view, so the module's dependencies are a *projection* of one truth rather
-// than a hand-maintained bag that can drift from it.
-//
-// SCOPE — this holds only what is built once and never reassigned: the
-// identity/transport facts, the TUI, the palette, the editor, and the layout
-// containers. Reassignable session state (the folded `SessionState`, the notice
-// string, bash mode, the ask counts) deliberately stays in `runAttach` and
-// reaches collaborators through explicit getters/callbacks on their own deps
-// argument, so nothing here can be silently mutated behind a reader's back.
-export {};

package/dist/clients/attach/session/editor-frame.js

@@ -1,142 +1 @@
-// session/editor-frame.ts — the EDITOR CHROME topic: everything painted onto
-// the editor's frame itself — border + title-chip styling, the bottom-right
-// context badge, the session-title chip, and the git context in the top border.
-//
-// The frame is a cue, not chrome for its own sake: a leading `!`/`!!` recolors
-// the whole editor to say "this goes to a shell, not the agent", and otherwise
-// the border tracks the engine's thinking level.
-import { basename } from 'node:path';
-import { modeIcon, personaLabel } from '../../../core/canvas/labels.js';
-import { colorChipStyle, defaultTitleStyle, thinkingBorderColor, thinkingTitleStyle } from '../input/titled-editor.js';
-import { fetchGitInfo } from '../chrome/git-info.js';
-/** Nerd Font terminal glyph marks a one-shot node; resident nodes need no
- *  lifecycle glyph because they persist by default. */
-const TERMINAL_NODE_ICON = '\uf489';
-/** Derive the shell-mode cue from the editor contents. Leading whitespace is
- *  ignored so pasted commands and indented text still toggle correctly. */
-export function deriveBashMode(text) {
-    const lead = text.trimStart();
-    return lead.startsWith('!!') ? 2 : lead.startsWith('!') ? 1 : 0;
-}
-/** Resolve the editor border + title-chip styles for the current shell cue. */
-export function resolveEditorFrameStyles(bashMode, thinkingLevel, pal) {
-    if (bashMode === 2) {
-        return {
-            borderColor: pal.bashModeAlt,
-            titleStyle: (s) => `\x1b[102m\x1b[30m\x1b[1m ${s} \x1b[0m`,
-        };
-    }
-    if (bashMode === 1) {
-        return {
-            borderColor: pal.bashMode,
-            titleStyle: (s) => `\x1b[42m\x1b[97m\x1b[1m ${s} \x1b[0m`,
-        };
-    }
-    return {
-        borderColor: thinkingBorderColor(thinkingLevel, pal.border),
-        titleStyle: thinkingTitleStyle(thinkingLevel, defaultTitleStyle),
-    };
-}
-/** Render the generated task icon on every non-empty editor title. Session
- * names are persisted independently by pi, so this derives the icon from the
- * canvas identity again whenever a viewer attaches or reloads. */
-export function displayEditorTitle(sessionName, identity) {
-    const raw = sessionName ?? '';
-    if (raw === '' || identity === undefined)
-        return raw;
-    const modePrefix = `${modeIcon(identity.mode)} `;
-    const withoutMode = raw.startsWith(modePrefix) ? raw.slice(modePrefix.length) : raw;
-    const icon = (identity.icon ?? '').trim();
-    const iconPrefix = icon === '' ? '' : `${icon} `;
-    const withoutTaskIcon = iconPrefix !== '' && withoutMode.startsWith(iconPrefix)
-        ? withoutMode.slice(iconPrefix.length)
-        : withoutMode;
-    const withoutKind = withoutTaskIcon.endsWith(` ${identity.kind}`)
-        ? withoutTaskIcon.slice(0, -identity.kind.length - 1)
-        : withoutTaskIcon;
-    const name = withoutKind === identity.kind ? '' : withoutKind;
-    return name === '' || icon === '' ? name : `${icon} ${name}`;
-}
-/** The editor-chrome collaborator: owns the shell/bash level (`deriveBashMode`
- *  over `editor.onChange` is its ONE writer) and the `/color` chip override,
- *  and paints every frame-attached adornment — border hue, title chip, context
- *  badge, and git context. */
-export function createEditorChrome(ctx, hooks) {
-    const { meta, tui, pal, editor } = ctx;
-    // Shell/bash mode: the editor text leads with `!`. Tracks pi's interactive
-    // `isBashMode`, which recolors the editor border green as a visual cue (#7).
-    // Three levels: 0 = off, 1 = `!` (output goes to the agent's context), 2 = `!!`
-    // (output hidden from the agent). The level drives BOTH the border hue (dull vs
-    // bright green) and a status-bar segment explaining what will happen.
-    let bashMode = 0;
-    // `/color` override for the name chip — null means the default (thinking-
-    // tracking) chip. Bash mode still wins: the green frame is a live safety cue.
-    let chipColor = null;
-    const syncContextBadge = (dir = basename(meta.cwd) || meta.cwd) => {
-        const identity = hooks.nodeIdentity();
-        const lifecycle = identity?.lifecycle === 'terminal' ? `${TERMINAL_NODE_ICON} ` : '';
-        const persona = identity ? ` · ${personaLabel(identity)}` : '';
-        editor.contextBadge = `${lifecycle}${dir}${persona}`;
-    };
-    // Paint the editor border + title chip. Shell/bash mode (leading `!`) wins and
-    // forces the whole frame green (#7); otherwise the hue tracks the thinking
-    // level. One place so the onChange bash toggle and live-state updates agree.
-    const paintFrame = () => {
-        const frame = resolveEditorFrameStyles(bashMode, hooks.thinkingLevel(), pal);
-        editor.borderColor = frame.borderColor;
-        editor.titleStyle = frame.titleStyle;
-        editor.contextBadgeStyle = frame.titleStyle;
-        if (bashMode === 0 && chipColor !== null) {
-            const style = colorChipStyle(chipColor);
-            if (style !== undefined)
-                editor.titleStyle = style;
-        }
-    };
-    // Recolor the editor when `!` enters/leaves the front of the input (#7). pi's
-    // interactive mode does the same off `editor.onChange`.
-    editor.onChange = (text) => {
-        hooks.onTextChange(text);
-        const next = deriveBashMode(text);
-        if (next !== bashMode) {
-            bashMode = next;
-            paintFrame();
-            hooks.renderFooter(); // the status segment tracks the bash level
-        }
-        tui.requestRender();
-    };
-    // Git context painted into the RIGHT of the editor's top border: branch and
-    // status symbols (● dirty, ⇡ ahead, ⇣ behind). The cwd leaf lives in the
-    // editor's bottom-right node and workspace badge. Refreshed by the poll.
-    const renderGitInfo = (info) => {
-        const parts = [];
-        if (info.branch)
-            parts.push(pal.info(`⎇ ${info.branch}`));
-        const sym = [];
-        if (info.dirty)
-            sym.push(pal.warning('●'));
-        if (info.ahead > 0)
-            sym.push(pal.active(`⇡${info.ahead}`));
-        if (info.behind > 0)
-            sym.push(pal.active(`⇣${info.behind}`));
-        if (sym.length > 0)
-            parts.push(sym.join(''));
-        // A trailing space keeps the symbols off the very last border cell.
-        editor.info = parts.length > 0 ? ` ${parts.join(pal.muted(' · '))} ` : '';
-        syncContextBadge(info.dir);
-        tui.requestRender();
-    };
-    return {
-        bashMode: () => bashMode,
-        setChipColor: (color) => {
-            chipColor = color;
-            paintFrame();
-            tui.requestRender();
-        },
-        paintFrame,
-        setTitle: (sessionName) => {
-            editor.title = displayEditorTitle(sessionName, hooks.nodeIdentity());
-        },
-        syncContextBadge: () => syncContextBadge(),
-        pollGit: () => fetchGitInfo(meta.cwd, renderGitInfo),
-    };
-}
+var p=Object.defineProperty;var r=(l,e)=>p(l,"name",{value:e,configurable:!0});import{basename as x}from"node:path";import{modeIcon as y,personaLabel as C}from"../../../core/canvas/labels.js";import{colorChipStyle as $,defaultTitleStyle as g,thinkingBorderColor as S,thinkingTitleStyle as w}from"../input/titled-editor.js";import{fetchGitInfo as I}from"../chrome/git-info.js";const T="\uF489";function B(l){const e=l.trimStart();return e.startsWith("!!")?2:e.startsWith("!")?1:0}r(B,"deriveBashMode");function M(l,e,o){return l===2?{borderColor:o.bashModeAlt,titleStyle:r(s=>`\x1B[102m\x1B[30m\x1B[1m ${s} \x1B[0m`,"titleStyle")}:l===1?{borderColor:o.bashMode,titleStyle:r(s=>`\x1B[42m\x1B[97m\x1B[1m ${s} \x1B[0m`,"titleStyle")}:{borderColor:S(e,o.border),titleStyle:w(e,g)}}r(M,"resolveEditorFrameStyles");function E(l,e){const o=l??"";if(o===""||e===void 0)return o;const s=`${y(e.mode)} `,c=o.startsWith(s)?o.slice(s.length):o,i=(e.icon??"").trim(),d=i===""?"":`${i} `,a=d!==""&&c.startsWith(d)?c.slice(d.length):c,u=a.endsWith(` ${e.kind}`)?a.slice(0,-e.kind.length-1):a,h=u===e.kind?"":u;return h===""||i===""?h:`${i} ${h}`}r(E,"displayEditorTitle");function G(l,e){const{meta:o,tui:s,pal:c,editor:i}=l;let d=0,a=null;const u=r((t=x(o.cwd)||o.cwd)=>{const n=e.nodeIdentity(),m=n?.lifecycle==="terminal"?`${T} `:"",b=n?` \xB7 ${C(n)}`:"";i.contextBadge=`${m}${t}${b}`},"syncContextBadge"),h=r(()=>{const t=M(d,e.thinkingLevel(),c);if(i.borderColor=t.borderColor,i.titleStyle=t.titleStyle,i.contextBadgeStyle=t.titleStyle,d===0&&a!==null){const n=$(a);n!==void 0&&(i.titleStyle=n)}},"paintFrame");i.onChange=t=>{e.onTextChange(t);const n=B(t);n!==d&&(d=n,h(),e.renderFooter()),s.requestRender()};const f=r(t=>{const n=[];t.branch&&n.push(c.info(`\u2387 ${t.branch}`));const m=[];t.dirty&&m.push(c.warning("\u25CF")),t.ahead>0&&m.push(c.active(`\u21E1${t.ahead}`)),t.behind>0&&m.push(c.active(`\u21E3${t.behind}`)),m.length>0&&n.push(m.join("")),i.info=n.length>0?` ${n.join(c.muted(" \xB7 "))} `:"",u(t.dir),s.requestRender()},"renderGitInfo");return{bashMode:r(()=>d,"bashMode"),setChipColor:r(t=>{a=t,h(),s.requestRender()},"setChipColor"),paintFrame:h,setTitle:r(t=>{i.title=E(t,e.nodeIdentity())},"setTitle"),syncContextBadge:r(()=>u(),"syncContextBadge"),pollGit:r(()=>I(o.cwd,f),"pollGit")}}r(G,"createEditorChrome");export{G as createEditorChrome,B as deriveBashMode,E as displayEditorTitle,M as resolveEditorFrameStyles};

package/dist/clients/attach/session/editor-inventory.js

@@ -1,160 +1,6 @@
-// session/editor-inventory.ts — what the editor knows it can complete against:
-// the slash-command list, the loaded-command preview, and the broker's
-// memory-ref inventory. `createEditorInventory` OWNS that state — nothing
-// outside this module writes it.
-//
-// Both inventories arrive independently (a command reply and a ref reply race
-// each other), so neither may rebuild the editor's provider having silently
-// dropped the other — everything funnels through one `syncEditorInventories`
-// seam. The builders below stay pure so that contract is testable without a
-// socket, TUI, or broker.
-import { execFile } from 'node:child_process';
-import { mkdtempSync, rmSync, writeFileSync } from 'node:fs';
-import { tmpdir } from 'node:os';
-import { join } from 'node:path';
-import { CombinedAutocompleteProvider } from '@earendil-works/pi-tui';
-import { formatBinding } from '../../../core/keybindings/index.js';
-import { inTmux, shellQuote } from '../../../core/runtime/placement-tmux.js';
-import { surfaceTmuxStyleArgs } from '../../../core/runtime/surface-bg.js';
-import { RefAwareAutocompleteProvider } from '../input/ref-autocomplete.js';
-import { CANVAS_SLASH_COMMANDS, locallyConsumedCommandNames, slashCommandList } from '../slash/dispatch.js';
-import { loadedCommandPreview } from '../slash/prompt-preview.js';
-export function buildAttachAutocompleteProvider(cwd, fdPath, commands, capabilities, createProvider = (items, cwd, path) => new CombinedAutocompleteProvider([...items], cwd, path)) {
-    return createProvider([...slashCommandList(commands, capabilities)], cwd, fdPath);
-}
-export function createMemoryRefRefreshCoordinator(setMemoryRefs, request) {
-    let epoch = 0;
-    return {
-        reset: () => {
-            const myEpoch = ++epoch;
-            setMemoryRefs([], []);
-            void request({ type: 'list_memory_refs' })
-                .then((data) => {
-                if (myEpoch !== epoch)
-                    return; // a newer reset (reconnect/reload) superseded this one
-                if (data.kind !== 'list_memory_refs')
-                    return; // malformed/mismatched reply — stay empty
-                setMemoryRefs(data.refs, data.engineLeadingCommandNames);
-            })
-                .catch(() => {
-                // Timeout / rejected request — the immediate clear above already left
-                // the inventory empty; no retry, no local fallback.
-            });
-        },
-    };
-}
-/** Owns everything the editor can complete against — the merged slash-command
- *  list, the loaded-command preview, the broker's raw command metadata, and the
- *  memory-ref inventory — plus the popup that inspects the loaded template.
- *  Input wiring supplies the session capability before first render, seeding
- *  builtins-only autocomplete before the broker's first `get_commands` ack. */
-export function createEditorInventory(ctx, capabilities, hooks) {
-    const { meta, socket, tui, editor } = ctx;
-    let commands = [];
-    let commandPreview;
-    // The broker's RAW command metadata (`undefined` until the first get_commands
-    // ack — kept distinct from `[]`, same undefined-vs-empty contract
-    // `buildAttachAutocompleteProvider` already relies on) and the broker's raw
-    // memory-ref inventory, kept SEPARATE from each other and from the merged
-    // `commands` preview list above: a late reply to one inventory must rebuild
-    // the provider/highlight sets from the CURRENT value of the other, never
-    // drop it. `syncEditorInventories` is the single place that reads both.
-    let brokerCommands;
-    let memoryRefs = [];
-    // The broker's `engineLeadingCommandNames` from the latest `list_memory_refs`
-    // reply — leading tokens the ENGINE independently consumes, kept separate
-    // from the viewer-local
-    // `locallyConsumedCommandNames()` set and fed to the editor's untrimmed
-    // engine-suppression rule via `setEngineCommandNames`.
-    let engineLeadingCommandNames = [];
-    const commandInspectHint = () => {
-        const bindings = hooks.bindings();
-        return bindings.gestures('crtr.attach.command.inspect').length > 0
-            ? `${formatBinding(bindings, 'crtr.attach.command.inspect')} inspect`
-            : 'inspect binding disabled';
-    };
-    const syncCommandPreview = (text) => {
-        commandPreview = loadedCommandPreview(text, commands);
-        editor.loadedCommand = commandPreview === undefined
-            ? undefined
-            : { name: commandPreview.name, content: commandPreview.content, inspectHint: commandInspectHint() };
-    };
-    // Atomically rebuild the editor's provider/highlight state from whatever
-    // command + ref inventory is CURRENTLY known — the one seam `setCommands` and
-    // `setMemoryRefs` both call, so a command-only or ref-only response can never
-    // rebuild the provider having silently dropped the other inventory. This
-    // module owns command metadata, ref metadata, provider rebuild, and editor
-    // highlight sets in one place. Command-only
-    // autocomplete is unchanged: `RefAwareAutocompleteProvider` fully delegates
-    // leading-slash and every non-ref context to the wrapped command provider, so
-    // refs never enter command completion or the loaded-command preview (which
-    // reads only `commands`, never `memoryRefs`).
-    const syncEditorInventories = () => {
-        const commandProvider = buildAttachAutocompleteProvider(meta.cwd, hooks.fdPath, brokerCommands, capabilities);
-        editor.setAutocompleteProvider(new RefAwareAutocompleteProvider(memoryRefs, commandProvider, hooks.frecency));
-        editor.setResolvedRefNames(memoryRefs.map((ref) => ref.name));
-        // Two independent suppression inventories: the viewer-local
-        // set (everything `dispatchSlashCommand` handles entirely locally, trimmed
-        // rule) and the broker's own `engineLeadingCommandNames` (untrimmed rule) —
-        // never the merged display/completion list `slashCommandList` returns.
-        editor.setLocalCommandNames(locallyConsumedCommandNames());
-        editor.setEngineCommandNames(engineLeadingCommandNames);
-        syncCommandPreview(editor.getText());
-    };
-    // Slash-command autocomplete starts with builtins + native canvas commands,
-    // then incorporates engine commands and prompt templates from get_commands.
-    // Template bodies stay alongside their autocomplete metadata so the editor can
-    // reveal the exact expanded payload before the user submits it. Responsible
-    // ONLY for the command side of the inventory — always ends with
-    // `syncEditorInventories()` so a command update never rebuilds the provider
-    // without the current ref inventory.
-    const setCommands = (next) => {
-        brokerCommands = next;
-        // Viewer-owned commands are intercepted before anything reaches the broker,
-        // so they must lead preview lookup too. Their lack of expansion metadata
-        // deliberately suppresses any shadowed extension/template disclosure.
-        commands = [
-            ...CANVAS_SLASH_COMMANDS.map((command) => ({ ...command, source: 'builtin' })),
-            ...(next ?? []),
-        ];
-        syncEditorInventories();
-    };
-    // Responsible ONLY for the ref side of the inventory — mirrors `setCommands`,
-    // always ending with the same `syncEditorInventories()` seam. Ref arrival
-    // must repaint decoration on already-typed prose immediately (the design's
-    // "gains decoration immediately" contract), so this is the one place that
-    // requests a render after an inventory change.
-    const setMemoryRefs = (next, nextEngineLeadingCommandNames) => {
-        memoryRefs = next;
-        engineLeadingCommandNames = nextEngineLeadingCommandNames;
-        syncEditorInventories();
-        tui.requestRender();
-    };
-    // The correlated ref-inventory lifecycle (design: inline memory references,
-    // T3 terminal integration). `socket.request` is the same observer-safe
-    // read-op channel local and remote attach already share, so this is
-    // transport-agnostic for free. Reset from `welcome` and a successful
-    // `/reload` — see the frames wiring in `runAttach`.
-    const memoryRefRefresh = createMemoryRefRefreshCoordinator(setMemoryRefs, (f) => socket.request(f));
-    const inspectLoadedCommand = () => {
-        if (commandPreview === undefined) {
-            hooks.setNotice('No prompt-template command is loaded in the editor');
-            return;
-        }
-        if (!inTmux()) {
-            hooks.setNotice('Command inspection requires tmux');
-            return;
-        }
-        const dir = mkdtempSync(join(tmpdir(), 'crtr-command-'));
-        const path = join(dir, `${commandPreview.name.replace(/[^A-Za-z0-9_.-]/g, '-')}.md`);
-        writeFileSync(path, `# /${commandPreview.name}\n\nInvocation: \`${commandPreview.invocation.replaceAll('`', '\\`')}\`\n\n${commandPreview.content}\n`, 'utf8');
-        const cmd = `if command -v nvim >/dev/null 2>&1; then exec nvim -R -- ${shellQuote(path)}; else printf 'nvim is required to inspect loaded commands. Install Neovim and retry.\\n'; printf 'Press Enter to close.'; read _; fi`;
-        execFile('tmux', ['display-popup', '-E', '-w', '90%', '-h', '85%', ...surfaceTmuxStyleArgs(), cmd], () => rmSync(dir, { recursive: true, force: true }));
-    };
-    return {
-        setCommands,
-        resetMemoryRefs: () => memoryRefRefresh.reset(),
-        syncCommandPreview,
-        inspectLoadedCommand,
-    };
-}
+var R=Object.defineProperty;var t=(r,c)=>R(r,"name",{value:c,configurable:!0});import{execFile as P}from"node:child_process";import{mkdtempSync as w,rmSync as x,writeFileSync as b}from"node:fs";import{tmpdir as S}from"node:os";import{join as C}from"node:path";import{CombinedAutocompleteProvider as _}from"@earendil-works/pi-tui";import{formatBinding as L}from"../../../core/keybindings/index.js";import{inTmux as E,shellQuote as $}from"../../../core/runtime/placement-tmux.js";import{surfaceTmuxStyleArgs as I}from"../../../core/runtime/surface-bg.js";import{RefAwareAutocompleteProvider as M}from"../input/ref-autocomplete.js";import{CANVAS_SLASH_COMMANDS as q,locallyConsumedCommandNames as H,slashCommandList as T}from"../slash/dispatch.js";import{loadedCommandPreview as F}from"../slash/prompt-preview.js";function j(r,c,n,d,s=(p,m,a)=>new _([...p],m,a)){return s([...T(n,d)],r,c)}t(j,"buildAttachAutocompleteProvider");function z(r,c){let n=0;return{reset:t(()=>{const d=++n;r([],[]),c({type:"list_memory_refs"}).then(s=>{d===n&&s.kind==="list_memory_refs"&&r(s.refs,s.engineLeadingCommandNames)}).catch(()=>{})},"reset")}}t(z,"createMemoryRefRefreshCoordinator");function ee(r,c,n){const{meta:d,socket:s,tui:p,editor:m}=r;let a=[],o,l,f=[],u=[];const g=t(()=>{const e=n.bindings();return e.gestures("crtr.attach.command.inspect").length>0?`${L(e,"crtr.attach.command.inspect")} inspect`:"inspect binding disabled"},"commandInspectHint"),v=t(e=>{o=F(e,a),m.loadedCommand=o===void 0?void 0:{name:o.name,content:o.content,inspectHint:g()}},"syncCommandPreview"),y=t(()=>{const e=j(d.cwd,n.fdPath,l,c);m.setAutocompleteProvider(new M(f,e,n.frecency)),m.setResolvedRefNames(f.map(i=>i.name)),m.setLocalCommandNames(H()),m.setEngineCommandNames(u),v(m.getText())},"syncEditorInventories"),h=t(e=>{l=e,a=[...q.map(i=>({...i,source:"builtin"})),...e??[]],y()},"setCommands"),A=z(t((e,i)=>{f=e,u=i,y(),p.requestRender()},"setMemoryRefs"),e=>s.request(e));return{setCommands:h,resetMemoryRefs:t(()=>A.reset(),"resetMemoryRefs"),syncCommandPreview:v,inspectLoadedCommand:t(()=>{if(o===void 0){n.setNotice("No prompt-template command is loaded in the editor");return}if(!E()){n.setNotice("Command inspection requires tmux");return}const e=w(C(S(),"crtr-command-")),i=C(e,`${o.name.replace(/[^A-Za-z0-9_.-]/g,"-")}.md`);b(i,`# /${o.name}
+
+Invocation: \`${o.invocation.replaceAll("`","\\`")}\`
+
+${o.content}
+`,"utf8");const N=`if command -v nvim >/dev/null 2>&1; then exec nvim -R -- ${$(i)}; else printf 'nvim is required to inspect loaded commands. Install Neovim and retry.\\n'; printf 'Press Enter to close.'; read _; fi`;P("tmux",["display-popup","-E","-w","90%","-h","85%",...I(),N],()=>x(e,{recursive:!0,force:!0}))},"inspectLoadedCommand")}}t(ee,"createEditorInventory");export{j as buildAttachAutocompleteProvider,ee as createEditorInventory,z as createMemoryRefRefreshCoordinator};

package/dist/clients/attach/session/file-links.js

@@ -1,68 +1 @@
-// session/file-links.ts — iTerm Semantic History file-open bridge.
-//
-// iTerm sends the clicked path through a private input sequence. The viewer
-// validates it, replaces its pane with Neovim, then reattaches after exit.
-import { existsSync } from 'node:fs';
-import { respawnPaneInBackground, shellQuote, viewerSplitEnv } from '../../../core/runtime/placement-tmux.js';
-const FILE_OPEN_PREFIX = '\x1b_crtr-file-open;';
-const STRING_TERMINATOR = '\x1b\\';
-/**
- * Strip the private iTerm Semantic History input and return its local path.
- * iTerm expands `\\1` as a shell-escaped word, so decode that representation
- * without ever evaluating it as shell input.
- */
-export function extractFileOpenInput(data) {
-    const start = data.indexOf(FILE_OPEN_PREFIX);
-    if (start === -1)
-        return undefined;
-    const pathStart = start + FILE_OPEN_PREFIX.length;
-    const end = data.indexOf(STRING_TERMINATOR, pathStart);
-    if (end === -1)
-        return undefined;
-    const file = decodeShellEscapedPath(data.slice(pathStart, end));
-    return { file, remaining: data.slice(0, start) + data.slice(end + STRING_TERMINATOR.length) };
-}
-function decodeShellEscapedPath(value) {
-    const decoded = value.startsWith("'") ? decodeSingleQuotedPath(value) : decodeBackslashPath(value);
-    return decoded !== undefined && decoded.startsWith('/') && !/[\x00-\x1f\x7f]/.test(decoded) ? decoded : undefined;
-}
-function decodeSingleQuotedPath(value) {
-    let result = '';
-    let index = 1;
-    while (true) {
-        const end = value.indexOf("'", index);
-        if (end === -1)
-            return undefined;
-        result += value.slice(index, end);
-        index = end + 1;
-        if (index === value.length)
-            return result;
-        if (value.slice(index, index + 3) !== "\\''")
-            return undefined;
-        result += "'";
-        index += 3;
-    }
-}
-function decodeBackslashPath(value) {
-    let result = '';
-    for (let index = 0; index < value.length; index++) {
-        if (value[index] !== '\\') {
-            result += value[index];
-            continue;
-        }
-        const escaped = value[++index];
-        if (escaped === undefined)
-            return undefined;
-        result += escaped;
-    }
-    return result;
-}
-/** Replace this local viewer pane with Neovim, then reattach it when Neovim exits. */
-export function openLinkedFileInPane(opts) {
-    if (!existsSync(opts.file))
-        return 'missing';
-    const attach = `crtr surface attach to ${shellQuote(opts.nodeId)}${opts.observer ? ' --observer' : ''}`;
-    const command = `nvim ${shellQuote(opts.file)} || :; exec ${attach}`;
-    opts.beforeRespawn();
-    return respawnPaneInBackground({ pane: opts.pane, cwd: opts.cwd, env: viewerSplitEnv(), command }) ? 'opened' : 'failed';
-}
+var o=Object.defineProperty;var r=(e,n)=>o(e,"name",{value:n,configurable:!0});import{existsSync as s}from"node:fs";import{respawnPaneInBackground as u,shellQuote as c,viewerSplitEnv as l}from"../../../core/runtime/placement-tmux.js";const d="\x1B_crtr-file-open;",f="\x1B\\";function P(e){const n=e.indexOf(d);if(n===-1)return;const t=n+d.length,i=e.indexOf(f,t);return i===-1?void 0:{file:h(e.slice(t,i)),remaining:e.slice(0,n)+e.slice(i+f.length)}}r(P,"extractFileOpenInput");function h(e){const n=e.startsWith("'")?x(e):a(e);return n!==void 0&&n.startsWith("/")&&!/[\x00-\x1f\x7f]/.test(n)?n:void 0}r(h,"decodeShellEscapedPath");function x(e){let n="",t=1;for(;;){const i=e.indexOf("'",t);if(i===-1)return;if(n+=e.slice(t,i),t=i+1,t===e.length)return n;if(e.slice(t,t+3)!=="\\''")return;n+="'",t+=3}}r(x,"decodeSingleQuotedPath");function a(e){let n="";for(let t=0;t<e.length;t++){if(e[t]!=="\\"){n+=e[t];continue}const i=e[++t];if(i===void 0)return;n+=i}return n}r(a,"decodeBackslashPath");function w(e){if(!s(e.file))return"missing";const n=`crtr surface attach to ${c(e.nodeId)}${e.observer?" --observer":""}`,t=`nvim ${c(e.file)} || :; exec ${n}`;return e.beforeRespawn(),u({pane:e.pane,cwd:e.cwd,env:l(),command:t})?"opened":"failed"}r(w,"openLinkedFileInPane");export{P as extractFileOpenInput,w as openLinkedFileInPane};

package/dist/clients/attach/session/focus-events.js

@@ -1,12 +1 @@
-// session/focus-events.ts — terminal focus reporting (DECSET 1004).
-//
-// The terminal (or tmux, per pane, with `focus-events on`) sends FOCUS_IN /
-// FOCUS_OUT as the viewer gains and loses focus. The viewer enables reporting
-// after `tui.start()`, reads the events in its global input listener to drive
-// the editor's hollow cursor, and DISABLES reporting again during terminal
-// restore — so the enable and the disable live in different modules and share
-// these constants rather than re-spelling the escape sequences.
-export const FOCUS_REPORTING_ON = '\x1b[?1004h';
-export const FOCUS_REPORTING_OFF = '\x1b[?1004l';
-export const FOCUS_IN = '\x1b[I';
-export const FOCUS_OUT = '\x1b[O';
+const O="\x1B[?1004h",o="\x1B[?1004l",t="\x1B[I",x="\x1B[O";export{t as FOCUS_IN,x as FOCUS_OUT,o as FOCUS_REPORTING_OFF,O as FOCUS_REPORTING_ON};