@north-light/cli 0.0.0-stage → 0.3.413

package/dist/clients/attach/session/frame.d.ts

@@ -0,0 +1,46 @@
+import { type Component, type Terminal } from '@earendil-works/pi-tui';
+import type { TranscriptViewport } from '../render/viewport.js';
+export declare const MIN_TRANSCRIPT_ROWS = 3;
+export declare const HEADER_MAX_ROWS = 12;
+export declare const EDITOR_MIN_ROWS = 1;
+export declare const STATUS_ROWS = 1;
+export declare const SEARCH_ROWS = 1;
+export type BottomSlot = 'queued' | 'aboveWidgets' | 'activity' | 'cockpitPadding' | 'editor' | 'pickerPanel' | 'belowWidgets' | 'reports' | 'search' | 'footer';
+/** Crop `lines` to `alloc` rows, guaranteeing the CURSOR_MARKER row survives
+ * (§2.1). No marker → the tail is kept. */
+export declare function cropAroundCursor(lines: readonly string[], alloc: number): string[];
+export interface ViewerFrameParts {
+    /** Rendered above the transcript; 0 rows when empty. */
+    header: Component;
+    /** The inline ticket page, directly beneath the header — the expanded form
+     *  of the strip's notification row. It grows downward to whatever the page
+     *  needs, squeezing the transcript to zero before the cockpit gives a row. */
+    ticket: Component;
+    viewport: TranscriptViewport;
+    /** The bottom slots, in VISUAL order, tagged with their allocation identity
+     * so the allocator can apply the §2.1 priority table. */
+    bottom: readonly {
+        slot: BottomSlot;
+        component: Component;
+    }[];
+}
+/** The TUI's ONE child. Renders exactly `terminal.rows` lines, every frame. */
+export declare class ViewerFrame implements Component {
+    private readonly terminal;
+    private readonly parts;
+    private viewportRows;
+    private lastFrame;
+    private overlay;
+    constructor(terminal: Terminal, parts: ViewerFrameParts);
+    render(width: number): string[];
+    /** Paint attributes over the composed frame — mouse selection highlight. The
+     *  overlay may restyle rows but must return the same number of them. */
+    setOverlay(overlay: (frame: readonly string[]) => string[]): void;
+    /** The physical rows returned by the most recent render, before any overlay. */
+    lastRenderedFrame(): readonly string[];
+    invalidate(): void;
+    /** Rows the transcript viewport got in the last frame — the page size. */
+    lastViewportRows(): number;
+    /** Retain exactly one editor marker if the focused editor rendered one. */
+    private ensureCursorMarker;
+}

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

@@ -0,0 +1 @@
+var P=Object.defineProperty;var c=(t,e)=>P(t,"name",{value:e,configurable:!0});import{CURSOR_MARKER as f}from"@earendil-works/pi-tui";import{reportInvariant as U}from"./invariant.js";const T=3,K=12,O=1,W=1,q=1;function D(t,e){const r=Math.max(0,Math.floor(e));if(t.length<=r)return t.slice();if(r===0)return[];const l=t.findIndex(s=>s.includes(f));if(l===-1)return t.slice(-r);const h=b(l-Math.floor((r-1)/2),0,t.length-r),i=t.slice(h,h+r);return i.some(s=>s.includes(f))?i:(A("cursor crop discarded CURSOR_MARKER"),[t[l]])}c(D,"cropAroundCursor");const N=["activity","queued","aboveWidgets","belowWidgets","reports","cockpitPadding"],L=["cockpitPadding","activity","aboveWidgets","queued","editor","pickerPanel","belowWidgets","reports","search","footer"];class G{static{c(this,"ViewerFrame")}terminal;parts;viewportRows=0;lastFrame=[];overlay;constructor(e,r){this.terminal=e,this.parts=r}render(e){const r=Math.max(0,this.terminal.rows),l=new Map;for(const{slot:o,component:d}of this.parts.bottom)l.set(o,d.render(e));const h=new Map,i=c(o=>l.get(o)??[],"linesFor"),s=c((o,d)=>{h.set(o,d)},"allocate");let n=Math.min(r,Math.max(O+W,r-T));const u=i("footer"),a=u.length>0&&n>O?W:0;s("footer",a===0?[]:u.slice(-a)),n-=a;const R=i("search"),p=R.length>0&&n>O?q:0;s("search",p===0?[]:R.slice(-p)),n-=p;const m=i("pickerPanel"),w=m.length===0?0:Math.min(m.length,Math.floor(n/2)),g=i("editor"),$=b(g.length,O,Math.max(O,n-w)),y=D(g,$);s("editor",y),n-=$;const E=Math.min(m.length,n);s("pickerPanel",m.slice(0,E)),n-=E;for(const o of N){const d=i(o);d.length<=n?(s(o,d),n-=d.length):s(o,[])}const M=L.flatMap(o=>h.get(o)??[]),F=L.slice(0,L.indexOf("editor")).reduce((o,d)=>o+(h.get(d)?.length??0),0);let v=this.parts.header.render(e).slice(0,K);r-M.length-v.length<T&&(v=[]);const _=this.parts.ticket.render(e).slice(0,Math.max(0,r-v.length-M.length)),C=Math.max(0,r-v.length-_.length-M.length);this.viewportRows=C;let S=this.parts.viewport.renderSlice(e,C),x=[...v,..._,...S,...M];x.length!==r&&(A(`frame rendered ${x.length} rows; expected ${r}`),S=V(S,C),x=[...v,..._,...S,...M]),x.length!==r&&A(`frame correction rendered ${x.length} rows; expected ${r}`);const k=this.ensureCursorMarker(x,g,y,F,M.length,r);if(this.lastFrame=k.slice(),this.overlay===void 0)return k;const I=this.overlay(k);return I.length!==k.length?(A(`frame overlay returned ${I.length} rows; expected ${k.length}`),k):I}setOverlay(e){this.overlay=e}lastRenderedFrame(){return this.lastFrame}invalidate(){this.parts.header.invalidate(),this.parts.ticket.invalidate();for(const{component:e}of this.parts.bottom)e.invalidate();this.parts.viewport.invalidate()}lastViewportRows(){return this.viewportRows}ensureCursorMarker(e,r,l,h,i,s){const n=r.find(g=>g.includes(f)),u=H(e);if(n===void 0?u<=1:u===1)return e;A(n===void 0?`frame contains ${u} CURSOR_MARKER sequences without one from the editor`:`frame contains ${u} CURSOR_MARKER sequences; expected exactly one`);const a=e.map(j);if(n===void 0)return a;const R=l.findIndex(g=>g.includes(f)),p=s-i+h+R;if(R===-1||p<0||p>=a.length)return A("unable to restore editor CURSOR_MARKER in composed frame"),a;const m=l[R].indexOf(f),w=a[p];return a[p]=`${w.slice(0,m)}${f}${w.slice(m)}`,a}}function b(t,e,r){return Math.min(r,Math.max(e,t))}c(b,"clamp");function V(t,e){return e===0?[]:t.length===e?t.slice():t.length>e?t.slice(-e):[...Array(e-t.length).fill(""),...t]}c(V,"fitTranscript");function H(t){return t.reduce((e,r)=>e+r.split(f).length-1,0)}c(H,"countMarkers");function j(t){return t.split(f).join("")}c(j,"stripCursorMarkers");function A(t){U("attach-frame",t)}c(A,"reportInvariant");export{O as EDITOR_MIN_ROWS,K as HEADER_MAX_ROWS,T as MIN_TRANSCRIPT_ROWS,q as SEARCH_ROWS,W as STATUS_ROWS,G as ViewerFrame,D as cropAroundCursor};

package/dist/clients/attach/session/frames.d.ts

@@ -0,0 +1,49 @@
+import type { AgentSessionEvent } from '@earendil-works/pi-coding-agent';
+import type { BrokerToClient, RpcExtensionUIRequest } from '../../../core/runtime/broker-protocol.js';
+import { type PreviewableCommand } from '../slash/prompt-preview.js';
+import type { AttachSession } from './context.js';
+import type { ToolGroupSummary } from '../../../shared/tool-groups.js';
+export interface FrameEffects {
+    /** Fold the frame through the shared reducer and repaint whatever slice of
+     *  chrome changed. Runs FIRST for every frame, before any case below. */
+    foldState: (frame: BrokerToClient) => void;
+    /** The transcript. Only the writes this switch performs are listed, so a
+     *  reader can see the whole render coupling from the type. */
+    chat: {
+        applySnapshot: (snapshot: Extract<BrokerToClient, {
+            type: 'welcome';
+        }>['snapshot']) => Promise<void> | void;
+        handleEvent: (event: AgentSessionEvent) => void;
+        setWorkingActivity: (activity: string) => void;
+        bashStart: (command: string, excludeFromContext?: boolean) => void;
+        bashOutput: (chunk: string) => void;
+        bashEnd: (frame: Extract<BrokerToClient, {
+            type: 'bash_end';
+        }>) => void;
+        applyToolGroupSummary: (key: string, summary: ToolGroupSummary) => void;
+        showError: (message: string) => void;
+    };
+    setNotice: (message: string) => void;
+    /** Repaint the status line — for the frames whose footer effect is NOT
+     *  derivable from session state (the on-disk bash-job scan). */
+    renderFooter: () => void;
+    /** Put the editor's text back (tree navigation restores it for re-editing). */
+    setEditorText: (text: string) => void;
+    /** Show/dismiss a blocking extension dialog. */
+    attachDialog: (req: RpcExtensionUIRequest) => void;
+    dismissDialog: (id: string) => void;
+    /** Replace the command inventory (`undefined` clears it pending a fresh ack). */
+    setCommands: (next?: ReadonlyArray<PreviewableCommand>) => void;
+    /** Clear + refetch the memory-ref inventory, superseding anything in flight. */
+    resetMemoryRefs: () => void;
+    /** Re-read the node's persona/lifecycle/icon from the canvas. */
+    refreshNodeIdentity: () => void;
+    /** Re-resolve user keybindings after a `/reload` (and re-install the tmux side). */
+    reloadBindings: () => void;
+    /** Schedule tmux binding reconciliation after a welcome has been handled. */
+    onWelcome?: () => void;
+    /** "sonnet medium" — the label a model or thinking change announces. */
+    modelThinkingLabel: () => string | undefined;
+}
+/** Build the single `frame` handler the socket is wired to. */
+export declare function createFrameHandler(ctx: Pick<AttachSession, 'socket'>, fx: FrameEffects): (frame: BrokerToClient) => void;

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

@@ -0,0 +1 @@
+var r=Object.defineProperty;var o=(i,t)=>r(i,"name",{value:t,configurable:!0});import{writeClipboardText as h}from"../../../core/clipboard-text.js";import{parsePreviewableCommands as k}from"../slash/prompt-preview.js";import{mark as u}from"../../../core/timing.js";function y(i,t){const{socket:d}=i,s=o(()=>{d.send({type:"get_commands"}),t.resetMemoryRefs()},"refetchInventories"),l=o(e=>{if(e.for==="get_commands"&&e.ok&&e.detail){try{t.setCommands(k(e.detail))}catch{}return}if(e.for==="navigate_tree"&&e.ok){e.detail&&t.setEditorText(e.detail);return}if(e.for==="share"){e.ok&&e.detail?(t.setNotice(`Shared: ${e.detail}`),h(e.detail)):e.ok||t.setNotice(`share failed: ${e.detail??"unknown error"}`);return}if(e.for==="clone"&&!e.ok){t.setNotice(`clone failed: ${e.detail??"unknown error"}`);return}if(!e.ok){t.setNotice(`command failed: ${e.for}${e.detail?` \u2014 ${e.detail}`:""}`);return}e.for==="reload"&&(t.reloadBindings(),t.setCommands(),s(),t.setNotice("Reloaded keybindings, extensions, skills, prompts, and themes"))},"handleAck"),c=o(e=>{t.chat.handleEvent(e),e.type==="session_info_changed"?t.refreshNodeIdentity():e.type==="thinking_level_changed"?t.setNotice(t.modelThinkingLabel()??`Thinking level: ${e.level}`):(e.type==="tool_execution_start"||e.type==="tool_execution_end")&&t.renderFooter()},"handleSessionEvent");let n=!1;return e=>{switch(t.foldState(e),e.type){case"welcome":{n||(n=!0,u("viewer.welcome")),t.chat.applySnapshot(e.snapshot),t.refreshNodeIdentity(),s(),e.pending_dialog!=null&&t.attachDialog(e.pending_dialog),t.onWelcome?.();break}case"tool_group_summary":t.chat.applyToolGroupSummary(e.key,e.summary);break;case"working_activity":t.chat.setWorkingActivity(e.activity);break;case"model_changed":{const a=t.modelThinkingLabel();a&&t.setNotice(a);break}case"error":e.code==="read_only"?t.setNotice("read-only"):t.chat.showError(e.message);break;case"node_named":break;case"ack":l(e);break;case"extension_ui_request":e.method!=="setStatus"&&e.method!=="setWidget"&&e.method!=="setTitle"&&t.attachDialog(e);break;case"extension_ui_dismiss":t.dismissDialog(e.id);break;case"bash_start":t.chat.bashStart(e.command,e.excludeFromContext);break;case"bash_output":t.chat.bashOutput(e.chunk);break;case"bash_end":t.chat.bashEnd(e);break;default:c(e);break}}}o(y,"createFrameHandler");export{y as createFrameHandler};

package/dist/clients/attach/session/identity.d.ts

@@ -0,0 +1,16 @@
+import type { NodeMeta } from '../../../core/canvas/types.js';
+import type { AttachSession } from './context.js';
+export type NodeIdentity = Pick<NodeMeta, 'kind' | 'mode' | 'lifecycle' | 'icon'> | undefined;
+export interface IdentityHooks {
+    /** Drop a late refresh that lands after the viewer is gone. */
+    isTornDown: () => boolean;
+    /** Repaint the badge/chip the identity feeds. */
+    onChanged: () => void;
+}
+export interface NodeIdentityOwner {
+    current: () => NodeIdentity;
+    /** Re-read from the canvas source. Fire-and-forget; failures are ignored
+     *  (the badge simply keeps its last known value). */
+    refresh: () => void;
+}
+export declare function createNodeIdentity(ctx: Pick<AttachSession, 'nodeId' | 'canvasSource'>, initial: NodeIdentity, hooks: IdentityHooks): NodeIdentityOwner;

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

@@ -0,0 +1 @@
+var o=Object.defineProperty;var n=(e,t)=>o(e,"name",{value:t,configurable:!0});function c(e,t,r){let d=t;return{current:n(()=>d,"current"),refresh:n(()=>{e.canvasSource.getNode(e.nodeId).then(i=>{r.isTornDown()||i===null||(d=i,r.onChanged())}).catch(()=>{})},"refresh")}}n(c,"createNodeIdentity");export{c as createNodeIdentity};

package/dist/clients/attach/session/input-wiring.d.ts

@@ -0,0 +1,50 @@
+import { InputController } from '../input/controller.js';
+import type { FrecencyStore } from '../input/completion-frecency.js';
+import { type ViewerCapabilities } from '../input/capabilities.js';
+import type { ToolDisplayToggle } from '../render/chat-view.js';
+import type { KeybindingsManager } from '@earendil-works/pi-tui';
+import type { CopyTarget } from '../render/transcript-copy.js';
+import type { AttachSession } from './context.js';
+/** What the input layer needs from the rest of the session. Everything here is
+ *  a getter or a command — never a value — so nothing can go stale. */
+export interface InputWiringHooks {
+    /** Transient footer message. */
+    setNotice: (message: string) => void;
+    /** pi's agent dir from the live `welcome` state, for the auth pickers.
+     *  `undefined` before the first welcome → they fall back to the local default. */
+    agentDir: () => string | undefined;
+    /** True while the reconnect supervisor has classified the node as dormant. */
+    isDormant: () => boolean;
+    /** Copy a viewer-local transcript target and surface its confirmation. */
+    copyTarget: (target: CopyTarget) => void;
+    /** Ctrl+O — toggles either collapsed summaries or tool-output expansion. */
+    toggleToolsExpanded: () => ToolDisplayToggle;
+    /** `/fold-tools` — flip the fold-finished-tool-calls view setting; returns the
+     *  new state. */
+    toggleFoldTools: () => boolean;
+    /** Ctrl+T — flip thinking-block visibility; returns true when now HIDDEN. */
+    toggleThinking: () => boolean;
+    /** `/graph` and the graph keybinding. */
+    toggleGraph: () => void;
+    /** `/inbox` and the inbox attach control. */
+    toggleInbox: () => void;
+    /** `/hotkeys` and the help keybinding. */
+    toggleHelp: () => void;
+    /** `/mouse` — flip mouse wheel reporting and return the new state. */
+    toggleMouse: () => boolean;
+    /** `/node-metadata` — open the viewer-owned Inspector dossier popup. */
+    openNodeMetadata: () => void;
+    /** `/quit` — detach this viewer; the engine keeps running. Must tear down
+     *  locally, since a bare `bye` would just trigger the reconnect loop. */
+    quit: () => void;
+    /** `/color` — recolor the editor's name chip (`null` clears to default). */
+    setChipColor: (color: string | null) => void;
+    /** A prompt or steer was accepted from the editor. */
+    onPromptSent: () => void;
+    /** Per-user completion frecency store, shared with the editor inventory. */
+    frecency: FrecencyStore;
+}
+/** Construct the viewer's one capability authority. */
+export declare function createViewerCapabilitiesForInput(ctx: Pick<AttachSession, 'nodeId' | 'remote' | 'role' | 'meta'>, isBrokerOffline: () => boolean): ViewerCapabilities;
+/** Build the viewer's InputController with every hook answered. */
+export declare function createInputController(ctx: Pick<AttachSession, 'nodeId' | 'remote' | 'role' | 'meta' | 'socket' | 'tui' | 'editor' | 'containers'>, km: KeybindingsManager, capabilities: ViewerCapabilities, hooks: InputWiringHooks): InputController;

package/dist/clients/attach/session/input-wiring.js

@@ -0,0 +1 @@
+var w=Object.defineProperty;var n=(i,d)=>w(i,"name",{value:d,configurable:!0});import{InputController as P}from"../input/controller.js";import{createViewerCapabilities as C}from"../input/capabilities.js";import{cliClient as y}from"../../../commands/api-client.js";import{buildLoginPicker as v,buildLogoutPicker as I}from"../overlays/auth.js";import{defaultAgentDir as m}from"../config.js";function h(i,d){return C({nodeId:i.nodeId,profileId:i.meta.profile_id??void 0,remote:i.remote,role:i.role,isBrokerOffline:d})}n(h,"createViewerCapabilitiesForInput");function N(i,d,l,o){const{nodeId:f,socket:a,tui:s,editor:u,containers:g}=i,{setNotice:r}=o,p=n(()=>a.send({type:"reload_auth"}),"reloadAuth"),T=l.permits("auth")?{openLoginPicker:n(()=>{const e=o.agentDir()??m();c.openAuthPicker(()=>v(s,e,p,t=>r(t)))},"openLoginPicker"),openLogoutPicker:n(()=>{const e=o.agentDir()??m();c.openAuthPicker(()=>I(e,p,t=>r(t)))},"openLogoutPicker")}:{},c=new P(s,u,d,{onCommand:n(e=>a.send(e),"onCommand"),onDialogResponse:n(e=>a.send(e),"onDialogResponse"),onNotice:n(e=>r(e),"onNotice"),onGraph:o.toggleGraph,onInbox:o.toggleInbox,onHelp:o.toggleHelp,onNodeMetadata:o.openNodeMetadata,onQuit:o.quit,onCopy:n(()=>o.copyTarget("last-assistant"),"onCopy"),onCopyTarget:o.copyTarget,onToggleMouse:n(()=>{const e=o.toggleMouse();r(e?"Mouse: wheel scrolling on, drag to select and copy":"Mouse: off \u2014 tmux drag-select and copy-mode restored")},"onToggleMouse"),onColor:o.setChipColor,onPromptSent:o.onPromptSent,frecency:o.frecency,knownRefNames:n(()=>u.getResolvedRefNames(),"knownRefNames"),onToggleToolsExpand:n(()=>{const e=o.toggleToolsExpanded();r(e.kind==="summaries"?e.shown?"Tool calls: summarized":"Tool calls: shown":e.expanded?"Tool output: expanded":"Tool output: collapsed")},"onToggleToolsExpand"),onFoldTools:n(()=>r(o.toggleFoldTools()?"Finished tool calls: folded to one line":"Finished tool calls: shown in full"),"onFoldTools"),onToggleThinking:n(()=>r(o.toggleThinking()?"Thinking blocks: hidden":"Thinking blocks: visible"),"onToggleThinking"),onRequest:n(e=>{const t=l.refusal("engine-drive");return t===void 0?a.request(e):Promise.reject(new Error(t))},"onRequest"),onMountPicker:n(e=>{g.pickerPanel.addChild(e),s.requestRender()},"onMountPicker"),onUnmountPicker:n(()=>{g.pickerPanel.clear(),s.requestRender()},"onUnmountPicker"),isDormant:o.isDormant,onDormantSubmit:l.permits("wake-dormant")?e=>{(async()=>{try{const t=await y().sendMessage(f,{body:e,from:"human"});r(t.revived?"\u21BB waking node\u2026":"\u2709 delivered \u2014 node reads on next wake")}catch(t){r(`Couldn't wake node: ${t instanceof Error?t.message:String(t)}`)}})()}:void 0,...T},l);return c}n(N,"createInputController");export{N as createInputController,h as createViewerCapabilitiesForInput};

package/dist/clients/attach/session/invariant.d.ts

@@ -0,0 +1,9 @@
+/**
+ * The viewer owns the whole pane, so an invariant must never be written to the
+ * terminal: console output lands in the middle of the rendered frame, and a
+ * violation that repeats every render pushes real content into tmux scrollback
+ * — the exact corruption these invariants exist to catch. Records go to a
+ * rotating log beside the daemon's, one line per report:
+ * `~/.crouter/canvas/attach-invariants.log` (`CRTR_HOME`-relative).
+ */
+export declare function reportInvariant(scope: string, message: string): void;

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

@@ -0,0 +1 @@
+var i=Object.defineProperty;var o=(r,t)=>i(r,"name",{value:t,configurable:!0});import{join as a}from"node:path";import{crtrHome as e}from"../../../core/canvas/paths.js";import{appendRotatingRecord as p}from"../../../core/log.js";function g(r,t){const n=`${new Date().toISOString()} ${r} ${t}`.replaceAll(/[\r\n]/g," ");p(a(e(),"attach-invariants.log"),n)}o(g,"reportInvariant");export{g as reportInvariant};

package/dist/clients/attach/session/keys.d.ts

@@ -0,0 +1,46 @@
+import { type AttachBindings, type AttachViewportActions } from './bindings.js';
+import type { AttachSession } from './context.js';
+export interface KeyHooks {
+    /** The live binding snapshot — re-resolved by `/reload`, so read per key. */
+    bindings: () => AttachBindings;
+    /** How the user would spell the detach binding, for the clear-first hint. */
+    detachHint: () => string | undefined;
+    /** Terminal focus in/out — the roster owns the editor's cursor styling. */
+    setPaneFocused: (focused: boolean) => void;
+    /** Whether a full-pane surface should receive all non-control input. */
+    hasExclusiveSurface: () => boolean;
+    /** Scroll actions for this session's transcript viewport. */
+    viewportActions: () => AttachViewportActions;
+    /** Transcript search's chance at a chunk; true when it consumed it. It owns
+     *  typed characters while editing a query, so it runs ahead of the editor. */
+    searchHandleKey: (data: string) => boolean;
+    /** The inline ticket panel: while open it consumes EVERY chunk — pages
+     *  carry text inputs — so it runs ahead of search, scroll, and the lists. */
+    panelHandleKey: (data: string) => boolean;
+    /** The inbox strip's chance at a chunk; true when it consumed it. */
+    stripHandleKey: (data: string) => boolean;
+    /** The roster's chance at a chunk; true when it consumed it. */
+    rosterHandleKey: (data: string) => boolean;
+    setNotice: (message: string) => void;
+    detach: () => void;
+    /** Cancel the running turn (the second ctrl+c). Detach lives on its own binding. */
+    cancelTurn: () => void;
+    toggleGraph: () => void;
+    toggleHelp: () => void;
+    /** Toggle the mounted inbox surface. */
+    toggleInbox: () => void;
+    /** Enter or leave the top-of-pane pending-request strip. */
+    toggleInboxStrip: () => void;
+    cycleModelLadder: (direction: 'forward' | 'backward') => void;
+    inspectLoadedCommand: () => void;
+    /** The file-review chord — pick a transcript file and open its review window. */
+    openFileReview: () => void;
+    /** Search the current node's local profile project files. */
+    openProfileFiles: () => void;
+    /** Open incremental search over the displayed transcript. */
+    openSearch: () => void;
+    /** Play the whip animation and interrupt the focused agent with a command. */
+    whip: () => void;
+}
+/** Install the listener; returns the remover, which teardown MUST call. */
+export declare function installGlobalKeys(ctx: Pick<AttachSession, 'tui' | 'editor'>, hooks: KeyHooks): () => void;

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

@@ -0,0 +1 @@
+var f=Object.defineProperty;var r=(c,e)=>f(c,"name",{value:e,configurable:!0});import{extractAttachControlInput as g}from"../../../core/keybindings/index.js";import{dispatchAttachAction as m,dispatchAttachBinding as o,dispatchAttachViewportBinding as h}from"./bindings.js";import{FOCUS_IN as l,FOCUS_OUT as d}from"./focus-events.js";const x=1e3;function y(c,e){const{tui:i,editor:u}=c;let a=0;const p={"crtr.attach.detach":e.detach,"crtr.attach.clear-or-detach":r(()=>{const t=Date.now();if(t-a<x){a=0,e.cancelTurn();return}a=t,u.setText(""),e.setNotice(`Editor cleared \u2014 press ${e.detachHint()} again to cancel the agent`),i.requestRender()},"crtr.attach.clear-or-detach"),"crtr.attach.graph.toggle":e.toggleGraph,"crtr.attach.help.toggle":e.toggleHelp,"crtr.attach.inbox.toggle":e.toggleInbox,"crtr.attach.inbox-strip":e.toggleInboxStrip,"crtr.attach.model-ladder.next":r(()=>e.cycleModelLadder("forward"),"crtr.attach.model-ladder.next"),"crtr.attach.model-ladder.previous":r(()=>e.cycleModelLadder("backward"),"crtr.attach.model-ladder.previous"),"crtr.attach.command.inspect":e.inspectLoadedCommand,"crtr.attach.file-review":e.openFileReview,"crtr.attach.profile-files":e.openProfileFiles,"crtr.attach.search":e.openSearch,"crtr.attach.whip":e.whip};return i.addInputListener(t=>{if(t.includes(l)||t.includes(d)){e.setPaneFocused(t.lastIndexOf(l)>t.lastIndexOf(d)),i.requestRender();const s=t.replaceAll(l,"").replaceAll(d,"");return s.length>0?{data:s}:{consume:!0}}const n=g(t);if(n!==void 0)return m(n.actionId,p),n.remaining.length>0?{data:n.remaining}:{consume:!0};if(!e.hasExclusiveSurface())return e.panelHandleKey(t)?{consume:!0}:e.searchHandleKey(t)?{consume:!0}:u.focused&&h(e.bindings(),t,e.viewportActions())?{consume:!0}:e.stripHandleKey(t)?{consume:!0}:e.rosterHandleKey(t)?{consume:!0}:o(e.bindings(),t,p)?{consume:!0}:void 0})}r(y,"installGlobalKeys");export{y as installGlobalKeys};

package/dist/clients/attach/session/layout.d.ts

@@ -0,0 +1,22 @@
+import { Container, type Component, type KeybindingsManager, type ProcessTerminal, type TUI } from '@earendil-works/pi-tui';
+import type { AttachPalette } from '../config.js';
+import { TitledEditor } from '../input/titled-editor.js';
+import type { TranscriptViewport } from '../render/viewport.js';
+import type { AttachContainers } from './context.js';
+import { ViewerFrame } from './frame.js';
+export interface AttachLayout {
+    /** The process terminal behind the TUI — also the owner of the window title
+     *  and the negotiated keyboard protocol, both of which the orchestrator uses. */
+    readonly procTerminal: ProcessTerminal;
+    readonly tui: TUI;
+    readonly containers: AttachContainers;
+    readonly editor: TitledEditor;
+    readonly frame: ViewerFrame;
+    /** Attach the single frame to the TUI and focus the editor. Deferred to just
+     *  before `tui.start()` so a signal landing mid-construction cannot leave a
+     *  half-mounted tree on screen. */
+    mount(): void;
+}
+/** Build the layout around the transcript viewport. The viewer creates the
+ * terminal and chat first because the viewport measures that chat source. */
+export declare function createLayout(procTerminal: ProcessTerminal, tui: TUI, chat: Container, activity: Container, pal: AttachPalette, km: KeybindingsManager, viewport: TranscriptViewport, searchBar: Component): AttachLayout;

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

@@ -0,0 +1 @@
+var b=Object.defineProperty;var c=(n,t)=>b(n,"name",{value:t,configurable:!0});import{Container as o,Spacer as f}from"@earendil-works/pi-tui";import{getSelectListTheme as g}from"@earendil-works/pi-coding-agent";import{TitledEditor as u}from"../input/titled-editor.js";import{ViewerFrame as h}from"./frame.js";function C(n,t,s,d,m,a,p,l){const e={chat:s,header:new o,aboveWidgets:new o,activity:d,reports:new o,queued:new o,pickerPanel:new o,ticketPanel:new o,belowWidgets:new o,footer:new o},w={borderColor:m.border,selectList:g()},r=new u(t,w,a,{paddingX:1}),i=new h(n,{header:e.header,ticket:e.ticketPanel,viewport:p,bottom:[{slot:"cockpitPadding",component:new f(1)},{slot:"activity",component:e.activity},{slot:"aboveWidgets",component:e.aboveWidgets},{slot:"queued",component:e.queued},{slot:"editor",component:r},{slot:"pickerPanel",component:e.pickerPanel},{slot:"belowWidgets",component:e.belowWidgets},{slot:"reports",component:e.reports},{slot:"search",component:l},{slot:"footer",component:e.footer}]});return{procTerminal:n,tui:t,containers:e,editor:r,frame:i,mount:c(()=>{t.addChild(i),t.setFocus(r)},"mount")}}c(C,"createLayout");export{C as createLayout};

package/dist/clients/attach/session/mouse.d.ts

@@ -0,0 +1,27 @@
+import type { TUI } from '@earendil-works/pi-tui';
+import type { MouseModeDefault } from '../../../types.js';
+/** Lines moved for one terminal wheel notch. */
+export declare const WHEEL_LINES = 3;
+export interface MouseReporting {
+    /** Reporting currently on. */
+    enabled(): boolean;
+    /** Flip, write the DECSET/DECRST, return the new state. */
+    toggle(): boolean;
+    /** Re-emit the current setting after another terminal program returned. */
+    reassert(): void;
+    /** Turn off unconditionally — teardown and process exit. */
+    disable(): void;
+    /** Install the SGR listener; returns the remover. */
+    install(tui: TUI, handlers: MouseHandlers): () => void;
+}
+export interface MouseHandlers {
+    onWheel(direction: 'up' | 'down', lines: number, column: number): void;
+    /** A primary-button press with no Shift, Alt, or Control modifier. */
+    onPrimaryPress(column: number, row: number): void;
+    /** Pointer motion with the primary button held. */
+    onPrimaryDrag(column: number, row: number): void;
+    /** The primary button came back up, wherever the pointer ended. */
+    onPrimaryRelease(column: number, row: number): void;
+}
+/** Create per-viewer mouse reporting from the user's saved starting mode. */
+export declare function createMouseReporting(write: (data: string) => void, defaultMode: MouseModeDefault): MouseReporting;

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

@@ -0,0 +1 @@
+var E=Object.defineProperty;var e=(t,u)=>E(t,"name",{value:u,configurable:!0});import{spawnSync as M}from"node:child_process";import{inTmux as h}from"../../../core/runtime/placement-tmux.js";const S="\x1B[?1002h\x1B[?1006h",N="\x1B[?1002l\x1B[?1006l",p=3;function O(){if(!h())return!1;const t=M("tmux",["show-options","-gv","mouse"],{encoding:"utf8"});return t.status===0&&t.stdout?.trim()==="on"}e(O,"detectMouseDefault");function w(t,u){let r=u==="on"||u==="tmux"&&O();const b=e(()=>{t(r?S:N)},"reassert"),a=e(()=>{r=!1;try{t(N)}catch{}},"disable");return process.once("exit",a),{enabled:e(()=>r,"enabled"),toggle:e(()=>(r=!r,b(),r),"toggle"),reassert:b,disable:a,install:e((x,n)=>x.addInputListener(d=>{let i=!1;const f=d.replace(/\x1b\[<(\d+);(\d+);(\d+)([Mm])/g,(R,g,s,m,c)=>{i=!0;const l=Number(g),o=l&-29;return o===64?n.onWheel("up",p,Number(s)):o===65?n.onWheel("down",p,Number(s)):o===32&&c==="M"?n.onPrimaryDrag(Number(s),Number(m)):o===0&&c==="m"?n.onPrimaryRelease(Number(s),Number(m)):l===0&&c==="M"&&n.onPrimaryPress(Number(s),Number(m)),""}).replace(/\x1b\[M[\s\S]{3}/g,()=>(i=!0,""));if(i)return f.length>0?{data:f}:{consume:!0}}),"install")}}e(w,"createMouseReporting");export{p as WHEEL_LINES,w as createMouseReporting};

package/dist/clients/attach/session/pane-focus.d.ts

@@ -0,0 +1,8 @@
+import type { TitledEditor } from '../input/titled-editor.js';
+export interface PaneFocus {
+    /** Recompute the editor's cursor style from pane focus + the holders. */
+    sync(): void;
+    /** Report real tmux-pane focus (DECSET 1004). Repaints the editor cursor. */
+    setPaneFocused(focused: boolean): void;
+}
+export declare function createPaneFocus(editor: TitledEditor, holders: ReadonlyArray<() => boolean>): PaneFocus;

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

@@ -0,0 +1 @@
+var u=Object.defineProperty;var t=(e,n)=>u(e,"name",{value:n,configurable:!0});import{execFileSync as s}from"node:child_process";function i(){const e=process.env.TMUX_PANE;if(e===void 0||e==="")return!0;try{return s("tmux",["display-message","-p","-t",e,"#{pane_active}"],{encoding:"utf8"}).trim()!=="0"}catch{return!0}}t(i,"initialPaneActive");function d(e,n){let r=i();const c=t(()=>{e.paneFocused=r&&!n.some(o=>o())},"sync");return c(),{sync:c,setPaneFocused:t(o=>{r=o,c()},"setPaneFocused")}}t(d,"createPaneFocus");export{d as createPaneFocus};

package/dist/clients/attach/session/pane-tag.d.ts

@@ -0,0 +1,44 @@
+/** The tag's lifecycle for one viewer: `set()` once the startup checkpoint has
+ *  cleared, `clear()` on teardown so a stray tag can't outlive the pane.
+ *  `pane()` is the id teardown reports as this viewer's home.
+ *
+ *  Split into a claim + a clear because ordering matters: a remote relay's "no
+ *  node"/"no running broker" close can still throw AFTER the socket is up, so
+ *  the tag is claimed only past that checkpoint — while `clear()` must be safe
+ *  to call from a teardown that runs before it was ever claimed.
+ *
+ *  `clear()` also has to survive a SUCCESSOR already owning the pane. tmux
+ *  `respawn-pane -k` only SIGHUPs the old viewer — it does not wait for it, and
+ *  the replacement is running ~50ms later. A departing viewer whose event loop
+ *  was busy when the signal arrived therefore runs its teardown after the
+ *  replacement has claimed the pane, and an unconditional clear then wipes the
+ *  LIVE viewer's identity: `nodeInPane()` returns nothing, so `surface reload`
+ *  and viewer focus refuse the pane until someone re-tags it by hand. So the
+ *  clear is conditional on still owning the pane, decided by `@crtr_viewer_pid`:
+ *  a pane carrying someone else's pid has a successor, and its tags are not
+ *  ours to remove. Skipping leaves at worst a stale tag on a dead pane, which
+ *  `liveViewerPanes` and `surface reload` already validate against the live
+ *  process; wiping a live viewer's tag has no such defense. */
+/** The tmux reads and writes the tag lifecycle makes, injectable so the
+ *  successor race is testable without a live tmux server. */
+export interface PaneTagIo {
+    readOption: (pane: string, name: string) => string | undefined;
+    writeOption: (pane: string, name: string, value: string) => void;
+    stampAsync: (pane: string) => void;
+    currentPane: () => string | undefined;
+    /** This viewer process's identity — the pid, unique per viewer by construction. */
+    ownerId: () => string;
+}
+export declare function createPaneTag(remote: boolean, nodeId: string, io?: PaneTagIo): {
+    set: () => void;
+    stamp: () => void;
+    clear: () => void;
+    pane: () => string | undefined;
+};
+/** Which viewer process owns this pane's tags. Read only by `clear()`, so a
+ *  departing viewer never removes a successor's identity. */
+export declare const VIEWER_OWNER_OPTION = "@crtr_viewer_pid";
+export declare function tagAttachPane(remote: boolean, pane: string | undefined, nodeId: string, setOpt?: (pane: string, name: string, value: string) => void): void;
+export declare function untagAttachPane(remote: boolean, pane: string | undefined, setOpt?: (pane: string, name: string, value: string) => void): void;
+export declare function tagAttachViewerPane(pane: string | undefined, setOpt?: (pane: string, name: string, value: string) => void): void;
+export declare function untagAttachViewerPane(pane: string | undefined, setOpt?: (pane: string, name: string, value: string) => void): void;

package/dist/clients/attach/session/pane-tag.js

@@ -0,0 +1 @@
+var P=Object.defineProperty;var c=(t,n)=>P(t,"name",{value:n,configurable:!0});import{currentTmux as p,getPaneOption as O,setPaneOption as i,stampViewerPaneAsync as w,VIEWER_STAMP_OPTION as d}from"../../../core/runtime/placement-tmux.js";const h={readOption:O,writeOption:c((t,n,r)=>{i(t,n,r)},"writeOption"),stampAsync:w,currentPane:c(()=>process.env.TMUX_PANE??p()?.pane,"currentPane"),ownerId:c(()=>String(process.pid),"ownerId")};function T(t,n,r=h){let e;const u=r.ownerId(),s=c(()=>{if(e===void 0||e==="")return!0;const a=r.readOption(e,f);return a===void 0||a===""?!0:a===u},"stillOwnsPane");return{set:c(()=>{e=r.currentPane(),o(e,u,r.writeOption),y(t,e,n,r.writeOption),l(e,r.writeOption),A(t,e,r.writeOption)},"set"),stamp:c(()=>{t||e===void 0||e===""||r.stampAsync(e)},"stamp"),clear:c(()=>{s()&&(g(t,e,r.writeOption),m(e,r.writeOption),_(t,e,r.writeOption),o(e,"",r.writeOption))},"clear"),pane:c(()=>e,"pane")}}c(T,"createPaneTag");const f="@crtr_viewer_pid";function o(t,n,r){if(!(t===void 0||t===""))try{r(t,f,n)}catch{}}c(o,"claimAttachPane");function A(t,n,r){if(!(t||n===void 0||n===""))try{r(n,d,String(Date.now()))}catch{}}c(A,"stampAttachPane");function _(t,n,r=i){if(!(t||n===void 0||n===""))try{r(n,d,"")}catch{}}c(_,"unstampAttachPane");function y(t,n,r,e=i){if(!(t||n===void 0||n===""))try{e(n,"@crtr_node",r)}catch{}}c(y,"tagAttachPane");function g(t,n,r=i){if(!(t||n===void 0||n===""))try{r(n,"@crtr_node","")}catch{}}c(g,"untagAttachPane");function l(t,n=i){if(!(t===void 0||t===""))try{n(t,"@crtr_attach","1")}catch{}}c(l,"tagAttachViewerPane");function m(t,n=i){if(!(t===void 0||t===""))try{n(t,"@crtr_attach","")}catch{}}c(m,"untagAttachViewerPane");export{f as VIEWER_OWNER_OPTION,T as createPaneTag,y as tagAttachPane,l as tagAttachViewerPane,g as untagAttachPane,m as untagAttachViewerPane};

package/dist/clients/attach/session/pi-assets.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clients/attach/session/pi-assets.js

@@ -0,0 +1 @@
+import{resolveBundledPiPackageDir as e}from"../../../core/runtime/pi-cli.js";try{process.env.PI_PACKAGE_DIR=e()}catch{}

package/dist/clients/attach/session/pi-oauth-flows.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/clients/attach/session/pi-oauth-flows.js

@@ -0,0 +1 @@
+import{registerBunOAuthFlows as r}from"@earendil-works/pi-ai/bun-oauth";r();

package/dist/clients/attach/session/profile-files.d.ts

@@ -0,0 +1,17 @@
+import type { NodeRow } from '../../../core/canvas/types.js';
+interface ProfileFileSearchOptions {
+    cwd: string;
+    nodeDirs: readonly string[];
+    nodeIds: readonly string[];
+    profileId: string | null;
+    fdPath: string | null;
+    onNotice: (message: string) => void;
+}
+/** Return the ids of this node, its complete parent chain, and its full
+ *  descendant subtree. The `parent` hierarchy, rather than the subscription
+ *  graph, is the user-visible child/parent relationship. */
+export declare function relatedNodeIds(nodes: readonly Pick<NodeRow, 'node_id' | 'parent'>[], nodeId: string): string[];
+/** Return the working directories of the same node family. */
+export declare function relatedNodeDirs(nodes: readonly Pick<NodeRow, 'node_id' | 'cwd' | 'parent'>[], nodeId: string): string[];
+export declare function launchProfileFileSearch(opts: ProfileFileSearchOptions): void;
+export {};

package/dist/clients/attach/session/profile-files.js

@@ -0,0 +1 @@
+var N=Object.defineProperty;var l=(e,t)=>N(e,"name",{value:t,configurable:!0});import{constants as _,accessSync as j,existsSync as P,mkdtempSync as k,readFileSync as E,rmSync as d,statSync as z}from"node:fs";import{tmpdir as C}from"node:os";import{delimiter as F,join as p,resolve as I,sep as $}from"node:path";import{execFile as v,spawnSync as T}from"node:child_process";import{loadProfileManifest as q,profileMemoryDir as M}from"../../../core/profiles/manifest.js";import{contextDir as O}from"../../../core/canvas/node-agent-paths.js";import{shellQuote as c}from"../../../core/runtime/placement-tmux.js";import{nvimShellCommand as A}from"../../../core/nvim-launch.js";import{surfaceTmuxStyleArgs as S}from"../../../core/runtime/surface-bg.js";function H(e,t){const n=new Map(e.map(i=>[i.node_id,i])),r=new Set([t]);for(let i=n.get(t);i?.parent!==null&&i?.parent!==void 0;){const f=i.parent;if(r.has(f))break;r.add(f),i=n.get(f)}const s=[t];for(;s.length>0;){const i=s.pop();for(const f of e)f.parent!==i||r.has(f.node_id)||(r.add(f.node_id),s.push(f.node_id))}return e.filter(i=>r.has(i.node_id)).map(i=>i.node_id)}l(H,"relatedNodeIds");function ce(e,t){const n=new Set(H(e,t));return e.filter(r=>n.has(r.node_id)).map(r=>r.cwd)}l(ce,"relatedNodeDirs");function L(e){const t=[];for(const n of e)try{t.push(O(n))}catch{continue}return y(t)}l(L,"familyDocumentDirs");function R(e){try{return z(e).isDirectory()}catch{return!1}}l(R,"isDirectory");function W(e,t){const n=[...t==null?[]:[t],...(process.env.PATH??"").split(F).filter(Boolean).map(r=>p(r,e))];return[...new Set(n)]}l(W,"executableCandidates");function h(e,t){for(const n of W(e,t)){try{j(n,_.X_OK)}catch{continue}if(T(n,["--version"],{stdio:"ignore"}).status===0)return n}return null}l(h,"workingExecutable");function B(e){if(e===null||e==="")return{projects:[],memory:null};try{const{profileId:t,manifest:n}=q(e);return{projects:n.projects.map(r=>r.path),memory:M(t)}}catch{return{projects:[],memory:null}}}l(B,"profileSearchRoots");function y(e){const t=new Set,n=[];for(const r of e){const s=I(r);t.has(s)||!R(s)||(t.add(s),n.push(s))}return n}l(y,"dedupeExistingDirs");function K(e){return e.filter(t=>!e.some(n=>n!==t&&t.startsWith(n+$)))}l(K,"outermostDirs");const Q=20;function X(e){try{const t=E(e);if(t.length===0)return null;const n=t[t.length-1]===0?t.length-1:t.length;return t.subarray(0,n).toString("utf8")||null}catch{return null}}l(X,"selectionPath");function se(e){const t=h("fd",e.fdPath);if(t===null){e.onNotice("fd is required for profile file search");return}const n=h("fzf");if(n===null){e.onNotice("fzf is required for profile file search");return}const r=h("nvim");if(r===null){e.onNotice("Neovim is required for profile file search");return}const s=B(e.profileId),i=y([e.cwd,...e.nodeDirs,...s.projects]);if(i.length===0){e.onNotice("No profile file-search directories exist");return}const f=K(i),w=y([...s.memory===null?[]:[s.memory]]),u=k(p(C(),"crtr-profile-files-")),g=p(u,"selection"),x=p(u,"candidates"),b=L(e.nodeIds).filter(o=>!f.some(a=>o===a||o.startsWith(a+$))),D=`{ ${[...f.map(o=>`${c(t)} --type f --hidden --exclude .git . ${c(o)}`),...b.map(o=>`${c(t)} --type f --hidden --exclude .git --exclude ${c("/jobs")} . ${c(o)}`),...w.map(o=>`${c(t)} --type f --hidden --exclude .git --no-ignore . ${c(o)}`)].map(o=>`${o} &`).join(" ")} wait; } > ${c(x)} && ${c(n)} --print0 --scheme=path --hscroll-off=${Q} --header ${c("fuzzy path \u2022 ctrl-y yank file path")} --bind ${c("ctrl-y:execute-silent(printf '%s' {} | { if command -v pbcopy >/dev/null 2>&1; then pbcopy; elif command -v wl-copy >/dev/null 2>&1; then wl-copy; elif command -v xclip >/dev/null 2>&1; then xclip -selection clipboard; else cat >/dev/null; fi; }; printf '%s' {} | tmux load-buffer -w -)+abort")} --preview ${c("head -100 -- {}")} < ${c(x)} > ${c(g)}`;try{v("tmux",["display-popup","-E","-T"," profile files ","-w","80%","-h","60%",...S(),D],()=>{const o=X(g);if(o===null||!P(o)){d(u,{recursive:!0,force:!0});return}const a=`exec ${A("edit",[o],r)}`;try{v("tmux",["display-popup","-E","-T"," profile file ","-w","90%","-h","90%",...S(),a],()=>d(u,{recursive:!0,force:!0}))}catch(m){d(u,{recursive:!0,force:!0}),e.onNotice(`Could not open profile file: ${m instanceof Error?m.message:String(m)}`)}})}catch(o){d(u,{recursive:!0,force:!0}),e.onNotice(`Could not open profile file search: ${o instanceof Error?o.message:String(o)}`)}}l(se,"launchProfileFileSearch");export{se as launchProfileFileSearch,ce as relatedNodeDirs,H as relatedNodeIds};

package/dist/clients/attach/session/reconnect.d.ts

@@ -0,0 +1,44 @@
+import type { ClientRole } from '../../../core/runtime/broker-protocol.js';
+import type { BrokerToClient } from '../../../core/runtime/broker-protocol.js';
+import type { AttachSession } from './context.js';
+export interface ReconnectHooks {
+    /** This viewer's fixed role, resolved from the original attach flags. */
+    role: ClientRole;
+    /** This viewer's stable client id, echoed by the broker in the hello. */
+    clientId: string;
+    /** Every broker frame, in wire order. */
+    onFrame: (frame: BrokerToClient) => void;
+    setNotice: (msg: string, opts?: {
+        sticky?: boolean;
+    }) => void;
+    /** True once teardown has begun — the supervisor loop's exit condition. */
+    isTornDown: () => boolean;
+    /** End the session. `node-done` is a clean finalize (the node pushed its
+     *  final report) and closes the pane; `broker-gone` freezes the corpse. */
+    teardown: (reason: 'node-done' | 'broker-gone') => void;
+    /** The viewer was bootstrapped from a saved parked snapshot before any socket
+     * connection. */
+    initialDormant?: boolean;
+    /** Called once each time the node is first seen as dormant. A stopped broker
+     * will relay no final session event, so the viewer clears live-only display. */
+    onEnterDormancy: () => void;
+}
+export interface ReconnectSupervisor {
+    /** Send the hello handshake. Called once after `tui.start()`, then again on
+     *  every successful redial. */
+    sendHello: () => void;
+    /** Begin redialing an offline parked viewer after its saved snapshot paints. */
+    startDormant: () => void;
+    /** True while the node has no live broker — the input layer routes a
+     *  submitted prompt through a wake message rather than a dead socket. */
+    isDormant: () => boolean;
+    /** The last socket-level error, for a broker-gone teardown message. */
+    lastSocketError: () => string | undefined;
+    /** Install the permanent frame/error/close handlers. Call once, AFTER the
+     *  connect race is settled and its temporary listeners are gone. */
+    install: () => void;
+    /** Cancel the current delay/redial wait. Ordinary attach never calls this;
+     *  bounded companion surfaces call it before closing their socket. */
+    stop: () => void;
+}
+export declare function createReconnect(ctx: Pick<AttachSession, 'nodeId' | 'socket' | 'canvasSource'>, hooks: ReconnectHooks): ReconnectSupervisor;

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

@@ -0,0 +1 @@
+var N=Object.defineProperty;var n=(d,e)=>N(d,"name",{value:e,configurable:!0});import{reconnectShouldGiveUp as R}from"../../../core/broker-client/index.js";const S=1e3,C=3e3;function I(d,e){const{nodeId:E,socket:s,canvasSource:T}=d;let m,a=!1,l=e.initialDormant===!0,p=!1,o=!1,w=n(()=>{},"resolveStopped"),c,f;const _=new Promise(i=>{w=i}),g=n(i=>o?Promise.resolve(!1):new Promise(t=>{const r=n(u=>{c=void 0,f=void 0,t(u)},"settle");c=setTimeout(()=>r(!0),i),f=n(()=>{c!==void 0&&clearTimeout(c),r(!1)},"cancelRetry")}),"waitForRetry"),y=n(()=>{s.send({type:"hello",role:e.role,client_id:e.clientId,term:{cols:process.stdout.columns??80,rows:process.stdout.rows??24}})},"sendHello"),D=n(async()=>{a=!0,e.setNotice("\u21BB node refreshing \u2014 reconnecting\u2026",{sticky:!0});let i=200;try{for(;!o&&!e.isTornDown();){let t;try{t=await T.getRow(E)}catch{t=void 0}if(t!==void 0&&R(t)){p=t?.status==="done";break}const r=t?.status==="idle"||t?.intent==="idle-release"||t?.lifecycle==="resident"&&t.status==="done"&&t.intent==="parked"&&t.final_report==null,u=r&&!l;l=r,u&&e.onEnterDormancy(),e.setNotice(r?"":"\u21BB node refreshing \u2014 reconnecting\u2026",{sticky:!r});try{if(!await Promise.race([s.redial({brokerUnavailableIsExpected:r}).then(()=>!0),_.then(()=>!1)])||o||e.isTornDown())return;y(),l=!1,e.setNotice("");return}catch{if(!await g(r?C:Math.min(i,S)))return;i*=2}}}finally{a=!1}!o&&!e.isTornDown()&&e.teardown(p?"node-done":"broker-gone")},"attemptReconnect");return{sendHello:y,startDormant:n(()=>{a||o||e.isTornDown()||(e.onEnterDormancy(),D())},"startDormant"),isDormant:n(()=>l,"isDormant"),lastSocketError:n(()=>m,"lastSocketError"),install:n(()=>{s.on("frame",e.onFrame),s.on("error",i=>{m=i.message}),s.on("close",()=>{e.isTornDown()||a||D()})},"install"),stop:n(()=>{o||(o=!0,f?.(),w())},"stop")}}n(I,"createReconnect");export{I as createReconnect};

package/dist/clients/attach/session/selection.d.ts

@@ -0,0 +1,28 @@
+export type SelectionRelease = {
+    kind: 'click';
+    column: number;
+    row: number;
+} | {
+    kind: 'selection';
+    notice: string;
+};
+export interface FrameSelection {
+    /** Primary button pressed: anchor here and drop any previous highlight. */
+    begin(column: number, row: number): void;
+    /** Drag to a new cell. Returns true when the highlight changed. */
+    extend(column: number, row: number): boolean;
+    /** Primary button released. `click` means the press never moved, so the
+     *  caller's click handling (file links) still owns the gesture. */
+    release(): SelectionRelease | undefined;
+    /** Drop the highlight. Returns true when something was showing. */
+    clear(): boolean;
+    /** A highlight is on screen. */
+    active(): boolean;
+    /** Paint the highlight onto a composed frame; identity when nothing is selected. */
+    apply(frame: readonly string[]): string[];
+}
+export declare function createFrameSelection(deps: {
+    /** The physical rows of the last render, unhighlighted. */
+    frame: () => readonly string[];
+    width: () => number;
+}): FrameSelection;

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

@@ -0,0 +1,3 @@
+var w=Object.defineProperty;var s=(d,t)=>w(d,"name",{value:t,configurable:!0});import{highlightCells as a,sliceCells as p}from"../ansi-cells.js";import{writeClipboardTextEverywhere as h}from"../../../core/clipboard-text.js";function g(d,t){return d.row<t.row||d.row===t.row&&d.column<=t.column}s(g,"before");function m(d,t,o){const[u,l]=g(d,t)?[d,t]:[t,d],e=[];for(let n=u.row;n<=l.row;n++){const r=n===u.row?u.column-1:0,i=n===l.row?l.column:o;i>r&&e.push({row:n,from:r,to:i})}return e}s(m,"spans");function C(d){let t,o;const u=s(()=>t!==void 0&&o!==void 0?{anchor:t,head:o}:void 0,"selected"),l=s(()=>{const e=u();if(!e)return"";const n=d.frame(),r=m(e.anchor,e.head,d.width()).map(i=>p(n[i.row-1]??"",i.from,i.to).trimEnd());for(;r.length>0&&r[r.length-1]==="";)r.pop();return r.join(`
+`)},"selectionText");return{begin(e,n){t={row:n,column:e},o=void 0},extend(e,n){return t===void 0||o!==void 0&&o.row===n&&o.column===e?!1:(o={row:n,column:e},!0)},release(){const e=t;if(e===void 0)return;if(o===void 0)return t=void 0,{kind:"click",column:e.column,row:e.row};const n=l();if(n==="")return t=void 0,o=void 0,{kind:"selection",notice:"Nothing to copy \u2014 selection is empty"};const{system:r,tmux:i}=h(n),f=r&&i?"clipboard + tmux buffer":r?"clipboard":i?"tmux buffer":void 0,c=n.split(`
+`).length;return{kind:"selection",notice:f===void 0?"Copy failed \u2014 no clipboard tool found":`Copied selection (${c} ${c===1?"line":"lines"}) \u2014 ${f}`}},clear(){const e=o!==void 0;return t=void 0,o=void 0,e},active(){return o!==void 0},apply(e){const n=u();if(!n)return e.slice();const r=d.width(),i=e.slice();for(const f of m(n.anchor,n.head,r)){const c=f.row-1;c<0||c>=i.length||(i[c]=a(i[c],f.from,f.to,r))}return i}}}s(C,"createFrameSelection");export{C as createFrameSelection};

package/dist/clients/attach/session/state-sync.d.ts

@@ -0,0 +1,38 @@
+import { type SessionState } from '../../../core/session-model/session-state.js';
+import type { BrokerToClient, ClientRole } from '../../../core/runtime/broker-protocol.js';
+/** The repaints a state delta can trigger. Each is a lazy closure so the
+ *  collaborators that answer them may be built after this owner. */
+export interface StateSyncEffects {
+    /** Feed engine state to the input controller — steer-vs-prompt routing reads
+     *  `isStreaming`, so it must stay current. */
+    setEngineState: (engine: NonNullable<SessionState['engine']>) => void;
+    /** The task name lives in the editor's top border; the border color tracks
+     *  the agent's thinking level. Both follow live state. */
+    setEditorTitle: (name: string | undefined) => void;
+    paintEditorFrame: () => void;
+    renderExtensionWidgets: () => void;
+    renderQueued: () => void;
+    renderFooter: () => void;
+    setTerminalTitle: (title: string) => void;
+    /** Panel liveness rides the relayed event stream (agent_start/agent_end/
+     *  queue_update/session_info_changed all move engine state) plus the viewer's
+     *  low-rate poll for changes that emit no event (child status flips). */
+    refreshChrome: () => void;
+}
+export interface SessionStateSync {
+    /** The live folded state. Read it; never hold it across an await. */
+    state: () => SessionState;
+    /** Fold one broker frame through the shared reducer and repaint the slices
+     *  that actually changed. */
+    fold: (frame: BrokerToClient) => void;
+    /** The ONE place this viewer writes session state without a broker frame: an
+     *  idle-released broker has settled its turn and will relay no final event,
+     *  so the viewer must clear the live-only spinner itself. Everything else
+     *  must go through `fold`. */
+    patchLocal: (patch: Partial<NonNullable<SessionState['engine']>>) => void;
+    /** The combined model + thinking-level label a model/thinking change
+     *  announces (e.g. "sonnet medium", "fable x high"). Reads live state, so
+     *  callers fold first, then notice. `off` collapses to the bare model name. */
+    modelThinkingLabel: () => string | undefined;
+}
+export declare function createSessionStateSync(role: ClientRole, fx: StateSyncEffects): SessionStateSync;

package/dist/clients/attach/session/state-sync.js

@@ -0,0 +1 @@
+var r=Object.defineProperty;var s=(o,t)=>r(o,"name",{value:t,configurable:!0});import{initialSessionState as a,reduce as u}from"../../../core/session-model/session-state.js";function f(o,t){let i=a(o);const l=s(n=>{const e=i;if(e===n)return;const d=e.engine!==n.engine;d&&e.engine!==void 0&&(t.setEngineState(e.engine),t.setEditorTitle(e.engine.sessionName)),d&&t.paintEditorFrame(),e.display.widgets!==n.display.widgets&&t.renderExtensionWidgets(),e.display.title!==n.display.title&&e.display.title!==void 0&&t.setTerminalTitle(e.display.title),e.queued!==n.queued&&t.renderQueued(),(d||e.role!==n.role||e.contextTokens!==n.contextTokens||e.display.statuses!==n.display.statuses)&&t.renderFooter(),d&&t.refreshChrome()},"renderDelta");return{state:s(()=>i,"state"),fold:s(n=>{const e=i;i=u(i,n),l(e)},"fold"),patchLocal:s(n=>{const e=i.engine;if(e===void 0)return;const d=i;i={...i,engine:{...e,...n}},l(d)},"patchLocal"),modelThinkingLabel:s(()=>{const n=i.engine?.model?.id;if(n===void 0)return;const e=i.engine?.thinkingLevel;return e!==void 0&&e!=="off"?`${n} ${e}`:n},"modelThinkingLabel")}}s(f,"createSessionStateSync");export{f as createSessionStateSync};

package/dist/clients/attach/session/surface-frame.d.ts

@@ -0,0 +1,20 @@
+import { type Component } from '@earendil-works/pi-tui';
+import type { SurfaceComponent } from '../../surfaces/host.js';
+/**
+ * The opaque rectangle wrapper used for every viewer surface. Rows are read
+ * and pushed inside the render pass: a surface hidden beneath another surface
+ * is not rendered, and therefore never observes a stale height when restored.
+ */
+export declare class SurfaceFrame implements Component {
+    private readonly surface;
+    private readonly focusTarget;
+    private readonly getRows;
+    private _focused;
+    constructor(surface: SurfaceComponent, focusTarget: Component, getRows: () => number);
+    get focused(): boolean;
+    set focused(value: boolean);
+    get wantsKeyRelease(): boolean;
+    render(width: number): string[];
+    handleInput(data: string): void;
+    invalidate(): void;
+}

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

@@ -0,0 +1 @@
+var l=Object.defineProperty;var a=(t,e)=>l(t,"name",{value:e,configurable:!0});import{CURSOR_MARKER as f,isFocusable as p,sliceByColumn as g,truncateToWidth as m,visibleWidth as h}from"@earendil-works/pi-tui";import{reportInvariant as R}from"./invariant.js";class C{static{a(this,"SurfaceFrame")}surface;focusTarget;getRows;_focused=!1;constructor(e,s,r){this.surface=e,this.focusTarget=s,this.getRows=r}get focused(){return this._focused}set focused(e){this._focused=e,p(this.focusTarget)&&(this.focusTarget.focused=e)}get wantsKeyRelease(){return this.focusTarget.wantsKeyRelease??this.surface.wantsKeyRelease??!1}render(e){const s=Math.max(0,Math.floor(this.getRows())),r=Math.max(0,Math.floor(e));this.surface.setRows(s);const u=this.surface.render(r);u.length!==s&&c(`surface rendered ${u.length} rows; expected ${s}`);const n=u.slice(0,s).map(o=>h(o)>r?(c(`surface row is ${h(o)} cells wide; expected at most ${r}`),d(g(o,0,r,!0),r)):d(o,r));for(;n.length<s;)n.push(" ".repeat(r));const i=w(n);return i>1?(c(`surface frame contains ${i} CURSOR_MARKER sequences; expected at most one`),n.map(T)):n}handleInput(e){(this.focusTarget.handleInput??this.surface.handleInput)?.call(this.focusTarget.handleInput===void 0?this.surface:this.focusTarget,e)}invalidate(){this.surface.invalidate()}}function d(t,e){return m(t,e,"",!0)}a(d,"padToWidth");function w(t){return t.reduce((e,s)=>e+s.split(f).length-1,0)}a(w,"countMarkers");function T(t){return t.split(f).join("")}a(T,"stripCursorMarkers");function c(t){R("surface-frame",t)}a(c,"reportInvariant");export{C as SurfaceFrame};