@north-light/cli 0.0.0 → 0.3.413

package/dist/core/canvas/browse/app.d.ts

@@ -0,0 +1,26 @@
+import type { CanvasSource } from '../source.js';
+import { type BindingId, type BindingResolution, type RawTerminalInput } from '../../keybindings/index.js';
+declare const BROWSE_NAV_ACTIONS: readonly ["crtr.browse.quit", "crtr.browse.down", "crtr.browse.up", "crtr.browse.first", "crtr.browse.last", "crtr.browse.expand-or-child", "crtr.browse.collapse-or-parent", "crtr.browse.toggle-fold", "crtr.browse.tab-next", "crtr.browse.tab-previous", "crtr.browse.tab.1", "crtr.browse.tab.2", "crtr.browse.tab.3", "crtr.browse.tab.4", "crtr.browse.tab.5", "crtr.browse.close-subtree", "crtr.browse.sort", "crtr.browse.scope", "crtr.browse.profile", "crtr.browse.residents", "crtr.browse.preview", "crtr.browse.report", "crtr.browse.pin", "crtr.browse.search", "crtr.browse.revive-now", "crtr.browse.focus", "crtr.browse.focus-background", "crtr.browse.yank-id"];
+declare const BROWSE_SEARCH_ACTIONS: readonly ["crtr.browse.search.cancel", "crtr.browse.search.commit", "crtr.browse.search.delete", "crtr.browse.search.quit"];
+export declare function resolveBrowseNavAction(bindings: BindingResolution<BindingId>, raw: RawTerminalInput): (typeof BROWSE_NAV_ACTIONS)[number] | null;
+export declare function resolveBrowseSearchAction(bindings: BindingResolution<BindingId>, raw: RawTerminalInput): (typeof BROWSE_SEARCH_ACTIONS)[number] | null;
+export declare function runBrowse(opts: {
+    returnPane?: string;
+    cwd?: string;
+    /** Profile to show initially. Undefined means no profile is selected, so the
+     *  initial view includes all profiles and the profile toggle is unavailable. */
+    profileId?: string;
+    /** The local API-backed read source. No in-process openDb fallback exists here. */
+    source: CanvasSource;
+    /** Local viewer registry projection. Kept separate from CanvasSource because
+     *  focus rows describe this machine's screens. */
+    viewedNodeIds?: () => Promise<ReadonlySet<string>>;
+    /** Route the `x` close-out through the daemon API (the CLI injects
+     *  `cliClient().closeNode(id, { finish: true })`). Kept as a callback so this
+     *  core module never imports the openDb-reaching `runtime/close.js`. Returns the
+     *  torn-down ids (root + cascaded). */
+    closeNode: (id: string) => Promise<{
+        closed: string[];
+    }>;
+}): Promise<void>;
+export {};

package/dist/core/canvas/browse/app.js

@@ -0,0 +1,3 @@
+var Te=Object.defineProperty;var c=(a,l)=>Te(a,"name",{value:l,configurable:!0});import{envNodeId as J}from"../../../shared/env.js";import{execFileSync as S}from"node:child_process";import{resolve as Re}from"node:path";import{dashboardRowsAllFromSource as Pe,enrichRowsFromSource as X,loadPreviewFromSource as Be,loadSearchTextFromSource as Z,renderForestFromSource as Ne}from"../render-source.js";import{fullName as qe}from"../labels.js";import{setupTerminal as Me,restoreTerminal as Fe,getTerminalSize as ke,parseKeypress as Ee}from"../../tui/terminal.js";import{buildTree as _e,flatten as Ae,pruneNode as Ke,TABS as x}from"./model.js";import{loadPins as Le,savePins as He}from"./pins.js";import{matchesTerminalInput as ee,resolveUserKeybindings as We}from"../../keybindings/index.js";const $e=["crtr.browse.quit","crtr.browse.down","crtr.browse.up","crtr.browse.first","crtr.browse.last","crtr.browse.expand-or-child","crtr.browse.collapse-or-parent","crtr.browse.toggle-fold","crtr.browse.tab-next","crtr.browse.tab-previous","crtr.browse.tab.1","crtr.browse.tab.2","crtr.browse.tab.3","crtr.browse.tab.4","crtr.browse.tab.5","crtr.browse.close-subtree","crtr.browse.sort","crtr.browse.scope","crtr.browse.profile","crtr.browse.residents","crtr.browse.preview","crtr.browse.report","crtr.browse.pin","crtr.browse.search","crtr.browse.revive-now","crtr.browse.focus","crtr.browse.focus-background","crtr.browse.yank-id"],ze=["crtr.browse.search.cancel","crtr.browse.search.commit","crtr.browse.search.delete","crtr.browse.search.quit"];function re(a,l,m){return l.find(g=>ee(a,g,m))??null}c(re,"firstMatching");function Ve(a,l){return re(a,$e,l)}c(Ve,"resolveBrowseNavAction");function je(a,l){return re(a,ze,l)}c(je,"resolveBrowseSearchAction");const L=["attention","tree","relevance","recency"];import{renderFrame as Ue,detectColorCaps as Ye,headerHeight as De,previewLayout as te,PREVIEW_HEIGHT as Ge}from"./render.js";import{writeClipboardTextEverywhere as Qe}from"../../clipboard-text.js";function Je(a,l,m){const g=Math.max(8,a.rows),y=te(a.cols,m).mode==="bottom"?Ge:0;return Math.max(1,g-De(l)-1-y)}c(Je,"viewportHeight");async function fr(a){const l=a.source,m=We();if(!process.stdin.isTTY){process.stdout.write(await Ne(l)+`
+`);return}let g,y,N,H,u,W,q={};await c(async()=>{let r=new Set;if(a.viewedNodeIds!==void 0)try{r=await a.viewedNodeIds()}catch{}y=await(l.browseSnapshot?.()??l.listNodes()),g=(await Pe(l,r,!1,y)).filter(s=>s.kind!=="human"),N=y.filter(s=>s.parent===null&&s.kind!=="human").map(s=>s.node_id);const t=new Map;await Promise.all(y.map(async s=>{t.set(s.node_id,(await l.subscriptionsOf(s.node_id).catch(()=>[])).map(o=>o.node_id))})),H=t,u=_e(g,N,s=>H.get(s)??[]),W=u.nodes.size,q=await Promise.all(N.map(async s=>[s,...await l.view(s)])).then(s=>l.ticketCountsForNodes([...new Set(s.flat())])).catch(()=>({}))},"rebuildSnapshot")();const ne=a.cwd!==void 0&&a.cwd.trim()!==""?Re(a.cwd):null,M=a.profileId,e={tab:"Live",cursor:0,collapsed:new Set([...u.nodes.entries()].filter(([,r])=>r.childIds.length>0).map(([r])=>r)),query:"",search:!1,scrollOffset:0,cwdScope:null,profileScope:M,sort:"attention",preview:!0,showReport:!1,residentsOnly:!0,pendingClose:null,flash:null,pinned:Le(),help:!1,rename:!1,renameBuf:"",renameTarget:null,message:!1,messageBuf:"",messageTarget:null};let w=[];const O=c(r=>u.nodes.get(r)?.row,"rowOf"),se=Ye();let b=!1;const I=c(()=>{if(!b){b=!0;try{Fe()}catch{}}},"cleanup");process.once("exit",I);const F=c((r,t)=>{process.stderr.write(`[crtr browse] ${r}: ${String(t?.message??t)}
+`)},"logAsyncFailure"),oe=c(r=>{try{S("crtr",["node","lifecycle","revive",r,"--now"],{stdio:"ignore"})}catch{}},"reviveNow"),ie=c(r=>{I();const t=a.returnPane!==void 0&&a.returnPane!==""?a.returnPane:void 0;try{t!==void 0?S("tmux",["run-shell","-b",`crtr surface node focus ${r} --pane ${t} --in-place >/dev/null 2>&1`],{stdio:"ignore"}):S("crtr",["surface","node","focus",r],{stdio:"inherit"})}catch{}process.exit(0)},"selectAndFocus"),ce=c(r=>{const t=["surface","node","focus",r,...a.returnPane!==void 0&&a.returnPane!==""?["--pane",a.returnPane]:[]];try{S("crtr",t,{stdio:"ignore"})}catch{}},"selectAndFocusKeepOpen"),f=c(r=>{if(w=Ae(u,{collapsed:e.collapsed,tab:e.tab,query:e.query,cwdScope:e.cwdScope,profileScope:e.profileScope,residentsOnly:e.residentsOnly,sort:e.sort,pinned:e.pinned}),r!==void 0){const t=w.findIndex(s=>s.id===r);t>=0&&(e.cursor=t)}e.cursor>w.length-1&&(e.cursor=Math.max(0,w.length-1)),e.cursor<0&&(e.cursor=0)},"recompute"),$=c(async()=>{const r=ke(),t=e.preview&&w.length>0,s=e.search||e.rename||e.message,o=Je(r,s,t);e.cursor<e.scrollOffset&&(e.scrollOffset=e.cursor),e.cursor>=e.scrollOffset+o&&(e.scrollOffset=e.cursor-o+1),e.scrollOffset<0&&(e.scrollOffset=0);const n=e.scrollOffset,d=Math.min(w.length,n+o),p=[];for(let K=n;K<d;K++){const Q=O(w[K].id);Q!==void 0&&p.push(Q)}await X(l,p,q),V(t,te(r.cols,t).mode==="side");const R=Ue({tree:u,visible:w,tab:e.tab,cursor:e.cursor,scrollOffset:e.scrollOffset,query:e.query,search:e.search,totalNodes:W,cwdScope:e.cwdScope,profileScope:e.profileScope,sort:e.sort,preview:e.preview,showReport:e.showReport,residentsOnly:e.residentsOnly,pendingClose:e.pendingClose,flash:e.flash,pinned:e.pinned,help:e.help,rename:e.rename,renameBuf:e.renameBuf,message:e.message,messageBuf:e.messageBuf,readOnly:!1},r,se);process.stdout.write(R)},"flush"),ae=90;let P,k=!1,v={on:!1,transcript:!1};const z=c(r=>r.previewLoaded!==!0||v.transcript&&r.transcriptLoaded!==!0||e.search&&e.query!==""&&r.promptsLoaded!==!0,"previewPending"),V=c((r,t)=>{v={on:r,transcript:t};const s=h()?.id,o=s===void 0?void 0:O(s);!r||o===void 0||!z(o)||(P!==void 0&&clearTimeout(P),P=setTimeout(()=>{P=void 0,le()},ae))},"schedulePreview"),le=c(async()=>{if(k||b)return;const r=h()?.id,t=r===void 0?void 0:O(r);if(!(!v.on||t===void 0||!z(t))){k=!0;try{await Be(l,t,{transcript:v.transcript}),e.search&&e.query!==""&&await Z(l,t)}catch(s){F("preview load failed",s),t.previewLoaded=!0,t.transcriptLoaded=!0}finally{k=!1}b||(h()?.id===r?i():V(v.on,v.transcript))}},"runPreview"),C=c(()=>{I(),process.exit(0)},"quit"),h=c(()=>w[e.cursor],"curRow"),E=c(r=>!e.collapsed.has(r),"isExpanded"),de=c(r=>{const t=[],s=[r],o=new Set;for(;s.length>0;){const n=s.pop();if(!o.has(n)){o.add(n),t.push(n);for(const d of u.nodes.get(n)?.childIds??[])s.push(d)}}return t},"subtreeIds"),fe=c(r=>de(r).some(t=>u.nodes.get(t)?.row.streaming===!0),"anyStreaming"),j=c(async r=>{e.pendingClose=null;let t=[];try{t=(await a.closeNode(r)).closed}catch{return}for(const s of t){const o=await l.getNode(s);if(o===null){Ke(u,s);continue}const n=u.nodes.get(s);n!==void 0&&(n.row.status=o.status,n.row.streaming=!1,n.row.viewed=!1,n.row.hanging=null,n.row.asks=0)}f()},"doClose"),U=c(r=>{const t=x.indexOf(e.tab);e.tab=x[(t+r+x.length)%x.length],e.cursor=0,e.scrollOffset=0,f()},"cycleTab"),ue=c(()=>{const r=h()?.id,t=L.indexOf(e.sort);e.sort=L[(t+1)%L.length],f(r)},"cycleSort"),we=c(()=>{const r=h()?.id;e.cwdScope=e.cwdScope===null?ne:null,f(r)},"toggleScope"),pe=c(()=>{if(M===void 0)return;const r=h()?.id;e.profileScope=e.profileScope===void 0?M:void 0,f(r)},"toggleProfile"),he=c(()=>{const r=h()?.id;e.residentsOnly=!e.residentsOnly,f(r)},"toggleResidents");let _=!1,A=!1,B=!1;const i=c(()=>{B=!0,!A&&(A=!0,(async()=>{try{for(;B&&!b;)B=!1,await $()}finally{A=!1,B&&!b&&i()}})().catch(()=>{I(),process.exit(1)}))},"scheduleFlush"),Y=c(()=>{_||(_=!0,setImmediate(()=>{_=!1,f(),i()}))},"scheduleSearchRepaint"),me=c((r,t)=>{const s=je(m,{input:r,...t});if(s==="crtr.browse.search.cancel"){e.search=!1,e.query="",e.sort="tree",f(),i();return}if(s==="crtr.browse.search.commit"){e.search=!1,f();const n=w.findIndex(d=>d.matched);n>=0&&(e.cursor=n),i();return}if(s==="crtr.browse.search.delete"){e.query=e.query.slice(0,-1),Y();return}if(s==="crtr.browse.search.quit"&&C(),t.ctrl)return;const o=[...r].filter(n=>n>=" ").join("");o.length>0&&(e.query+=o,Y())},"onKeySearch"),be=c(()=>{const r=J();if(!(r===void 0||r===""||!u.nodes.has(r))){for(let t=u.nodes.get(r)?.parentId??null;t!==null;t=u.nodes.get(t)?.parentId??null)e.collapsed.delete(t);f(r)}},"recenterOnSelf"),ge=c(r=>{e.pinned.has(r)?e.pinned.delete(r):e.pinned.add(r),He(e.pinned),f(r)},"togglePin"),ye=c(()=>{const r=e.renameTarget,t=e.renameBuf.trim();if(e.rename=!1,r!==null&&t!==""){try{S("crtr",["node","config",r,"--name",t],{stdio:"ignore"})}catch{}const s=u.nodes.get(r);s!==void 0&&(s.row.handle=t,s.row.name=qe({name:t,kind:s.row.kind,description:s.row.description}))}f(e.renameTarget??void 0),i()},"commitRename"),ve=c(()=>{const r=e.messageTarget,t=e.messageBuf.trim();if(e.message=!1,r!==null&&t!=="")try{S("crtr",["node","message","send","--to",r,t],{stdio:"ignore"})}catch{}i()},"commitMessage"),D=c((r,t,s,o,n,d)=>{if(t.escape){d();return}if(t.return){n();return}if(t.backspace){o(s().slice(0,-1)),i();return}if(t.ctrl){r==="c"&&C();return}const p=[...r].filter(R=>R>=" ").join("");p.length>0&&(o(s()+p),i())},"onKeyText"),Se=c((r,t)=>D(r,t,()=>e.renameBuf,s=>{e.renameBuf=s},ye,()=>{e.rename=!1,i()}),"onKeyRename"),xe=c((r,t)=>D(r,t,()=>e.messageBuf,s=>{e.messageBuf=s},ve,()=>{e.message=!1,i()}),"onKeyMessage"),Oe=c((r,t)=>{if(t.ctrl&&r==="c"){C();return}e.help=!1,i()},"onKeyHelp"),Ie=c((r,t)=>{const s={input:r,...t},o=Ve(m,s);if(e.flash=null,t.ctrl&&o===null)return;if(e.pendingClose!==null&&o==="crtr.browse.quit"&&t.ctrl&&C(),e.pendingClose!==null){if(ee(m,"crtr.browse.confirm-close",s)){const d=e.pendingClose;j(d).then(()=>i()).catch(()=>i());return}e.pendingClose=null,i();return}const n=h();if(o==="crtr.browse.quit"&&C(),o==="crtr.browse.up"){e.cursor=Math.max(0,e.cursor-1),i();return}if(o==="crtr.browse.down"){e.cursor=Math.max(0,Math.min(w.length-1,e.cursor+1)),i();return}if(o==="crtr.browse.first"){e.cursor=0,i();return}if(o==="crtr.browse.last"){e.cursor=Math.max(0,w.length-1),i();return}if(o==="crtr.browse.expand-or-child"){n!==void 0&&n.hasChildren&&(E(n.id)?e.cursor+1<w.length&&w[e.cursor+1].depth>n.depth&&(e.cursor+=1):(e.collapsed.delete(n.id),f(n.id))),i();return}if(o==="crtr.browse.collapse-or-parent"){if(n!==void 0&&n.hasChildren&&E(n.id))e.collapsed.add(n.id),f(n.id);else if(n!==void 0){const d=u.nodes.get(n.id)?.parentId??null;if(d!==null){const p=w.findIndex(R=>R.id===d);p>=0&&(e.cursor=p)}}i();return}if(o==="crtr.browse.toggle-fold"){n!==void 0&&n.hasChildren&&(E(n.id)?e.collapsed.add(n.id):e.collapsed.delete(n.id),f(n.id)),i();return}if(o==="crtr.browse.tab-next"){U(1),i();return}if(o==="crtr.browse.tab-previous"){U(-1),i();return}if(o?.startsWith("crtr.browse.tab.")){const d=Number(o.slice(-1))-1;d<x.length&&(e.tab=x[d],e.cursor=0,e.scrollOffset=0,f()),i();return}if(o==="crtr.browse.close-subtree"){if(n===void 0){i();return}if(fe(n.id)){e.pendingClose=n.id,i();return}j(n.id).then(()=>i()).catch(()=>i());return}if(o==="crtr.browse.sort"){ue(),i();return}if(o==="crtr.browse.scope"){we(),i();return}if(o==="crtr.browse.profile"){pe(),i();return}if(o==="crtr.browse.residents"){he(),i();return}if(o==="crtr.browse.preview"){e.preview=!e.preview,i();return}if(o==="crtr.browse.report"){e.showReport=!e.showReport,i();return}if(r==="?"){e.help=!0,i();return}if(o==="crtr.browse.pin"){n!==void 0&&ge(n.id),i();return}if(r==="."){be(),i();return}if(r==="R"){n!==void 0&&(e.rename=!0,e.renameTarget=n.id,e.renameBuf=O(n.id)?.name??""),i();return}if(r==="m"){n!==void 0&&(e.message=!0,e.messageTarget=n.id,e.messageBuf=""),i();return}if(o==="crtr.browse.search"){Ce(),e.search=!0,e.query="",e.sort="relevance",e.cursor=0,e.scrollOffset=0,f(),i();return}if(o==="crtr.browse.revive-now"){n!==void 0&&O(n.id)?.hanging!=null&&oe(n.id),i();return}if(o==="crtr.browse.yank-id"){if(n!==void 0){const{system:d,tmux:p}=Qe(n.id);e.flash=d||p?`Copied ${n.id}${d?"":" to the tmux buffer"}`:"No clipboard tool available \u2014 nothing copied"}i();return}if(o==="crtr.browse.focus"){n!==void 0&&ie(n.id);return}if(o==="crtr.browse.focus-background"){n!==void 0&&ce(n.id),i();return}},"onKeyNav");f(),w.length===0&&e.residentsOnly&&(e.residentsOnly=!1,f());const T=J();if(T!==void 0&&T!==""&&u.nodes.has(T)){for(let r=u.nodes.get(T)?.parentId??null;r!==null;r=u.nodes.get(r)?.parentId??null)e.collapsed.delete(r);f(T)}Me(),await $();let G=!1;const Ce=c(()=>{if(G)return;G=!0;const r=[...u.nodes.values()].map(n=>n.row);let t=0;const s=30,o=c(async()=>{if(b)return;const n=Math.min(t+s,r.length),d=r.slice(t,n);await X(l,d,q),await Promise.all(d.map(p=>Z(l,p))),t=n,e.search&&e.query!==""&&(f(h()?.id),i()),t<r.length&&setImmediate(()=>{o().catch(p=>F("background warm failed",p))})},"warmChunk");setImmediate(()=>{o().catch(n=>F("background warm failed",n))})},"startWarm");await new Promise(()=>{const r=c(t=>{try{const{input:s,key:o}=Ee(t);e.help?Oe(s,o):e.search?me(s,o):e.rename?Se(s,o):e.message?xe(s,o):Ie(s,o)}catch{I(),process.exit(1)}},"onData");process.stdin.on("data",r),process.stdout.on("resize",i)})}c(fr,"runBrowse");export{Ve as resolveBrowseNavAction,je as resolveBrowseSearchAction,fr as runBrowse};

package/dist/core/canvas/browse/model.d.ts

@@ -0,0 +1,172 @@
+import type { DashboardRow } from '../render-source.js';
+export type Tab = 'All' | 'Live' | 'Dormant' | 'Attention' | 'Pinned';
+export declare const TABS: readonly Tab[];
+/** How the visible rows are ordered.
+ *    tree      — spanning-tree order, ancestors shown for context (the default).
+ *    attention — FLAT list, tiered by where your attention belongs (attached/
+ *                streaming/live), newest-message-first within each tier.
+ *    relevance — FLAT list, best query match first (super-search).
+ *    recency   — FLAT list, newest `created` first. */
+export type SortMode = 'tree' | 'attention' | 'relevance' | 'recency';
+export declare const SORTS: readonly SortMode[];
+/** Does a node belong to this tab's slice?
+ *    All       — every node.
+ *    Live      — what you can pick up right now: active | idle, PLUS a resident
+ *                agent that stopped without finishing (Enter opens its saved
+ *                conversation; submitted input wakes it — see `isFinishedWork`).
+ *                Finished work never appears here.
+ *    Dormant   — done | dead | canceled: literally "no engine running". A stopped
+ *                resident agent is deliberately on BOTH tabs — it is openable
+ *                (Live) and it is not running (Dormant); both are true and each
+ *                tab is the one a different search starts from.
+ *    Attention — needs a human: has pending asks OR is parked on a fault.
+ *    Pinned    — user-starred (a local, view-only preference; `isPinned`). */
+export declare function tabPredicate(tab: Tab, row: DashboardRow, isPinned?: boolean): boolean;
+export interface TreeNode {
+    row: DashboardRow;
+    depth: number;
+    parentId: string | null;
+    childIds: string[];
+}
+export interface Tree {
+    /** Ordered root ids (live-first, then stragglers). */
+    roots: string[];
+    nodes: Map<string, TreeNode>;
+}
+/**
+ * Build a spanning tree of the whole canvas.
+ *   - `rows`       — one DashboardRow per node (display text + status/asks).
+ *   - `rootIds`    — node ids whose `parent === null` (raw, unsorted).
+ *   - `childIdsOf` — a node's children = the nodes it subscribes to (its
+ *                    reports), in edge order. (= subscriptionsOf(id) node ids.)
+ *
+ * Roots are sorted live-first. The graph is walked DFS-preorder; the FIRST
+ * parent to reach a node owns it (cycle-/multi-parent-safe via `visited`). Any
+ * node never reached from a root (orphaned by a missing subscription edge) is
+ * appended as a depth-0 straggler so "All" is genuinely the whole canvas.
+ */
+export declare function buildTree(rows: DashboardRow[], rootIds: string[], childIdsOf: (id: string) => string[]): Tree;
+/** Splice a node out of an already-built tree in place (mutates `tree`). Used when
+ *  a close REAPED an empty node (row + dir hard-deleted) rather than parking it:
+ *  the node is gone from the db, so it must vanish from the in-memory tree too or
+ *  its stale row lingers on screen (the "press x, nothing happens" bug — an empty
+ *  active husk reaped by closeNode but never dropped from `tree.nodes`, so the
+ *  attention/flat view kept painting it). Surviving children are re-homed to the
+ *  reaped node's parent so a non-leaf reap never orphans them out of view. No-op
+ *  if the id is absent. */
+export declare function pruneNode(tree: Tree, id: string): void;
+/** One word-wrapped preview line: its text + the column indices WITHIN that text
+ *  to highlight (the query match). */
+export interface SnippetLine {
+    text: string;
+    hi: Set<number>;
+}
+/** The literal case-insensitive substring span in a conversation preview.
+ *  Scattered letters are not a message match and never receive a highlight. */
+export declare function highlightIndices(query: string, text: string): Set<number>;
+/**
+ * Build the preview snippet for `text` under the live `query`: up to `maxLines`
+ * word-wrapped lines (each ≤ `width` cols), WINDOWED so the best match is visible
+ * (long conversations: the match can be thousands of chars in), with the matched
+ * columns flagged for highlight. Empty query (or empty text) → a plain wrap from
+ * the start with no highlight. The snippet string itself is what carries the
+ * highlight indices, so they never drift across the windowing.
+ */
+export declare function previewSnippet(query: string, text: string, width: number, maxLines: number): SnippetLine[];
+/** The searchable conversation text for a row: EVERY user prompt across the pi
+ *  session (`prompts`) when present, else the spawn prompt (`goal`) for a
+ *  never-revived node that has no session yet. Searched by super-search and
+ *  windowed in the preview, so search matches a prompt from ANYWHERE in the
+ *  conversation, not just the first one. */
+export declare function promptText(row: DashboardRow): string;
+/** Does this row match the live query? Empty query matches everything; a
+ *  non-empty query uses the same fields and match tiers as relevance ranking. */
+export declare function queryMatch(query: string, row: DashboardRow): boolean;
+export type MatchTier = 0 | 1 | 2 | 3;
+export interface FieldMatch {
+    /** 3 = bounded word/phrase, 2 = contiguous partial, 1 = subsequence. */
+    tier: MatchTier;
+    /** Tie-break quality within one tier. */
+    quality: number;
+}
+export interface RelevanceScore {
+    tier: MatchTier;
+    strength: number;
+}
+/** One field's best match. Match class is deliberately separate from quality:
+ *  a bounded literal always outranks a contiguous partial, which always outranks
+ *  a scattered subsequence, regardless of field weights. */
+export declare function fieldMatch(query: string, text: string): FieldMatch;
+/** Rank a row by its strongest match class, then by weighted evidence only from
+ *  that class. Weaker classes cannot add up to beat one stronger literal match. */
+export declare function scoreRow(query: string, row: DashboardRow): RelevanceScore;
+/** The "most recent message" signal for the attention sort: the pi session-file
+ *  mtime (ms) the snapshot stamps on each row, falling back to the `created`
+ *  birth timestamp when no session file exists. Larger = more recent.
+ *
+ *  NOTE (phase-3 reconcile): phase 1 owns the field name on DashboardRow. We read
+ *  `mtimeMs` here as the most likely name; if phase 1 lands a different name,
+ *  update this single accessor. `created` is ISO 8601, so its epoch-ms is a
+ *  monotonic stand-in within the same tier. */
+export declare function attentionMtime(row: DashboardRow): number;
+/** Up to a 10% relevance lift for recent conversation activity, halving after a
+ *  week. Match tier remains separate, so freshness never promotes fuzzy over literal. */
+export declare function relevanceFreshness(row: DashboardRow, now: number): number;
+/** Attention tier (lower = higher priority, shown first):
+ *    T0 — attached AND streaming (`viewed && streaming`)
+ *    T1 — attached, not streaming (`viewed`)
+ *    T2 — streaming, not attached
+ *    T3 — live but neither (`status active|idle`)
+ *    T4 — everything else (dormant: done/dead/canceled). */
+export declare function attentionTier(row: DashboardRow): number;
+export interface VisibleRow {
+    id: string;
+    depth: number;
+    hasChildren: boolean;
+    collapsed: boolean;
+    matched: boolean;
+}
+export interface FlattenOpts {
+    collapsed: Set<string>;
+    tab: Tab;
+    query: string;
+    /** cwd-scope filter: only rows pinned to this dir are directly-matched. null /
+     *  undefined = All dirs (no cwd filter). Like the tab predicate, it gates the
+     *  matched set — ancestors from other dirs still render dimmed for tree context. */
+    cwdScope?: string | null;
+    /** Profile-scope filter: only rows belonging to this profile are directly-matched.
+     *  undefined = All profiles. It gates matches before ancestor context is added. */
+    profileScope?: string | undefined;
+    /** Lifecycle filter: when true, `terminal` (one-shot worker) nodes are kept out
+     *  of the TOP-LEVEL rows and the flat search results — but, in tree mode, still
+     *  appear when you manually expand their parent fold (drilling into a resident).
+     *  The resume picker defaults this ON. Undefined/false = every lifecycle. */
+    residentsOnly?: boolean;
+    /** Ordering. `tree` keeps the spanning tree + ancestor context; `relevance` /
+     *  `recency` produce a FLAT ranked list of directly-matched rows. */
+    sort?: SortMode;
+    /** User-starred node ids (local, view-only). Gates the Pinned tab, and floats
+     *  pinned rows to the top of every FLAT sort mode. undefined = none pinned. */
+    pinned?: Set<string>;
+}
+/** Is this row inside the active cwd scope? No scope (null/undefined) = All dirs. */
+export declare function cwdMatch(scope: string | null | undefined, row: DashboardRow): boolean;
+/** Is this row inside the active profile scope? Undefined = All profiles. */
+export declare function profileMatch(scope: string | undefined, row: DashboardRow): boolean;
+/** Is this row inside the active lifecycle filter? `residentsOnly` hides `terminal`
+ *  nodes; off (false/undefined) = every lifecycle. A row with an unknown lifecycle
+ *  (older snapshot field absent) is treated as resident so it is never hidden. */
+export declare function lifecycleMatch(residentsOnly: boolean | undefined, row: DashboardRow): boolean;
+/**
+ * Flatten the tree to the ordered list of currently-visible rows.
+ *
+ * Inclusion: a node is shown when it directly matches (tab predicate AND query)
+ * — flagged `matched:true` — OR it is an ANCESTOR of a directly-matched node
+ * (shown for tree context, `matched:false`, dimmed by the renderer).
+ *
+ * Collapse: children are emitted only under an EXPANDED node. A node is expanded
+ * when it is not in `collapsed` — except under a non-empty query, where every
+ * ancestor-of-a-match is force-expanded regardless of `collapsed` so matches are
+ * always reachable.
+ */
+export declare function flatten(tree: Tree, opts: FlattenOpts): VisibleRow[];

package/dist/core/canvas/browse/model.js

@@ -0,0 +1 @@
+var W=Object.defineProperty;var r=(t,e)=>W(t,"name",{value:e,configurable:!0});import{isFinishedWork as z,isLiveStatus as V,statusRank as Y}from"../node-order.js";import{matchIndices as j}from"../../tui/fuzzy.js";const dt=["All","Live","Dormant","Attention","Pinned"],at=["tree","attention","relevance","recency"];function q(t,e,o=!1){switch(t){case"All":return!0;case"Live":return V(e.status)||!z({lifecycle:e.lifecycle,finalized:e.finalized===!0});case"Dormant":return e.status==="done"||e.status==="dead"||e.status==="canceled";case"Attention":return e.asks>0||e.hanging!=null;case"Pinned":return o}}r(q,"tabPredicate");function lt(t,e,o){const c=new Map(t.map(n=>[n.node_id,n])),i=new Map,s=[],d=new Set,f=r(n=>{const g=c.get(n);return g!==void 0?Y(g.status):99},"rankOf"),u=r((n,g,p)=>{if(d.has(n))return;const M=c.get(n);if(M===void 0)return;d.add(n);const I=o(n).filter(S=>c.has(S)&&!d.has(S));i.set(n,{row:M,depth:g,parentId:p,childIds:I});for(const S of I)u(S,g+1,n)},"walk"),m=[...e].filter(n=>c.has(n)).sort((n,g)=>f(n)-f(g));for(const n of m)d.has(n)||(s.push(n),u(n,0,null));const h=t.map(n=>n.node_id).filter(n=>!d.has(n)).sort((n,g)=>f(n)-f(g));for(const n of h)d.has(n)||(s.push(n),u(n,0,null));return{roots:s,nodes:i}}r(lt,"buildTree");function ft(t,e){const o=t.nodes.get(e);if(o===void 0)return;const c=o.parentId,i=o.childIds.filter(s=>t.nodes.has(s));for(const s of i){const d=t.nodes.get(s);d!==void 0&&(d.parentId=c)}if(c!==null){const s=t.nodes.get(c);if(s!==void 0){const d=s.childIds.indexOf(e);d>=0&&s.childIds.splice(d,1,...i)}}else{const s=t.roots.indexOf(e);s>=0&&t.roots.splice(s,1,...i)}t.nodes.delete(e)}r(ft,"pruneNode");const D=12;function G(t,e){if(t==="")return new Set;const o=e.toLowerCase().indexOf(t.toLowerCase());if(o<0)return new Set;const c=new Set;for(let i=o;i<o+t.length;i++)c.add(i);return c}r(G,"highlightIndices");function K(t,e,o){const c=[];if(e<=0||o<=0)return c;const i=t.length;let s=0;for(;s<i&&c.length<o;){const d=s;let f=s,u=s;for(;u<i;){let h=u;for(;h<i&&t[h]===" ";)h++;let n=h;for(;n<i&&t[n]!==" ";)n++;if(h===n)break;if(n-d<=e||f===d)f=n,u=n;else break}let m=t.slice(d,f);m.length>e&&(m=m.slice(0,e)),c.push({text:m,start:d}),s=f,s<i&&t[s]===" "&&s++}return c}r(K,"wrapTracked");function ut(t,e,o,c){const i=e.replace(/\s+/g," ").trim();if(i===""||o<=0||c<=0)return[];const s=t===""?-1:i.toLowerCase().indexOf(t.toLowerCase());let d=0;if(s>D){let p=s-D;for(;p<s&&i[p]!==" ";)p++;d=p<s?p+1:s}const f=(d>0?"\u2026 ":"")+i.slice(d),u=G(t,f),m=K(f,o,c),h=m.map(({text:p,start:M})=>{const I=new Set;for(const S of u)S>=M&&S<M+p.length&&I.add(S-M);return{text:p,hi:I}}),n=m[m.length-1],g=h[h.length-1];if(n!==void 0&&g!==void 0&&n.start+n.text.length<f.length){const p=Math.max(0,Math.min(g.text.length,o-1)),M=g.text.slice(0,p),I=new Set;for(const S of g.hi)S<p&&I.add(S);h[h.length-1]={text:`${M}\u2026`,hi:I}}return h}r(ut,"previewSnippet");function X(t){return t.slice(0,8)}r(X,"shortId");function $(t){return t.prompts??t.goal??""}r($,"promptText");function J(t,e){return t===""||F(t,e).tier>0}r(J,"queryMatch");const R={tier:0,quality:0},Q=/[\p{L}\p{N}]/u;function A(t){return t!==void 0&&Q.test(t)}r(A,"isWordChar");function U(t,e){if(t===""||e==="")return R;const o=t.toLowerCase(),c=e.toLowerCase(),i=c.indexOf(o);if(i>=0){for(let u=i;u>=0;u=c.indexOf(o,u+1)){const m=u+o.length,h=!A(o[0])||!A(c[u-1]),n=!A(o[o.length-1])||!A(c[m]);if(h&&n)return{tier:3,quality:c===o?1:.95}}const f=Math.min(.2,i/400);return{tier:2,quality:(i===0?1:.8)-f}}const s=[...j(o,c)];if(s.length===0)return R;const d=s[s.length-1]-s[0]+1;return{tier:1,quality:o.length/d}}r(U,"fieldMatch");const T={handle:4,prompt:4,kind:2,description:1.5,id:1};function Z(t){const e=t.handle??t.name;return e===t.kind?"":e}r(Z,"explicitHandle");function F(t,e){if(t==="")return{tier:0,strength:0};const c=[{text:Z(e),weight:T.handle,minimumTier:1},{text:$(e),weight:T.prompt,minimumTier:2},{text:e.kind,weight:T.kind,minimumTier:1},{text:e.description??"",weight:T.description,minimumTier:1},{text:X(e.node_id),weight:T.id,minimumTier:1}].map(({text:d,weight:f,minimumTier:u})=>{const m=U(t,d);return{match:m.tier>=u?m:R,weight:f}}),i=Math.max(...c.map(({match:d})=>d.tier)),s=c.reduce((d,{match:f,weight:u})=>d+(f.tier===i?f.quality*u:0),0);return{tier:i,strength:s}}r(F,"scoreRow");function _(t){const e=t.mtimeMs;if(typeof e=="number"&&Number.isFinite(e))return e;const o=Date.parse(t.created);return Number.isFinite(o)?o:0}r(_,"attentionMtime");const tt=.1,et=10080*60*1e3;function P(t,e){const o=Math.max(0,e-_(t));return 1+tt/(1+o/et)}r(P,"relevanceFreshness");function H(t){const e=t.viewed===!0,o=t.streaming===!0;return e&&o?0:e?1:o?2:t.status==="active"||t.status==="idle"?3:4}r(H,"attentionTier");function nt(t,e){return t==null||e.cwd===t}r(nt,"cwdMatch");function ot(t,e){return t===void 0||e.profile_id===t}r(ot,"profileMatch");function st(t,e){return t!==!0||e.lifecycle!=="terminal"}r(st,"lifecycleMatch");function ht(t,e){const{collapsed:o,tab:c,query:i,cwdScope:s,profileScope:d,residentsOnly:f,sort:u="tree",pinned:m}=e,h=r(a=>m?.has(a)===!0,"isPinned"),n=new Set,g=new Set;for(const[a,w]of t.nodes)q(c,w.row,h(a))&&ot(d,w.row)&&nt(s,w.row)&&J(i,w.row)&&(g.add(a),st(f,w.row)&&n.add(a));if(u!=="tree"){const a=[...n],w=r(l=>t.nodes.get(l)?.row.created??"","createdOf"),k=r((l,x)=>w(x).localeCompare(w(l)),"byRecency"),E=r(l=>h(l)?0:1,"pinRank");if(u==="attention"){const l=r(x=>t.nodes.get(x).row,"rowOf");a.sort((x,O)=>E(x)-E(O)||H(l(x))-H(l(O))||_(l(O))-_(l(x))||k(x,O))}else if(u==="recency"||i==="")a.sort((l,x)=>E(l)-E(x)||k(l,x));else{const l=new Map,x=r(C=>t.nodes.get(C).row,"rowOf"),O=Date.now();for(const C of a)l.set(C,F(i,x(C)));a.sort((C,L)=>{const y=l.get(C),N=l.get(L),b=y.strength*P(x(C),O),B=N.strength*P(x(L),O);return E(C)-E(L)||N.tier-y.tier||B-b||_(x(L))-_(x(C))||k(C,L)})}return a.map(l=>({id:l,depth:0,hasChildren:!1,collapsed:!1,matched:!0}))}const p=new Set;for(const a of n){let w=t.nodes.get(a)?.parentId??null;for(;w!==null&&!p.has(w);)p.add(w),w=t.nodes.get(w)?.parentId??null}const M=r(a=>n.has(a)||p.has(a),"included"),I=r(a=>i!==""&&p.has(a)?!0:!o.has(a),"isExpanded"),S=[],v=r((a,w)=>{const k=t.nodes.get(a);if(k===void 0)return;const E=M(a)||f===!0&&w&&g.has(a);if(E){const l=k.childIds.length>0;S.push({id:a,depth:k.depth,hasChildren:l,collapsed:l&&!I(a),matched:n.has(a)})}if(I(a))for(const l of k.childIds)v(l,E)},"walk");for(const a of t.roots)v(a,!1);return S}r(ht,"flatten");export{at as SORTS,dt as TABS,_ as attentionMtime,H as attentionTier,lt as buildTree,nt as cwdMatch,U as fieldMatch,ht as flatten,G as highlightIndices,st as lifecycleMatch,ut as previewSnippet,ot as profileMatch,$ as promptText,ft as pruneNode,J as queryMatch,P as relevanceFreshness,F as scoreRow,q as tabPredicate};

package/dist/core/canvas/browse/pins.d.ts

@@ -0,0 +1,4 @@
+/** Load the pinned-id set. Missing/garbage file → empty set (never throws). */
+export declare function loadPins(): Set<string>;
+/** Persist the pinned-id set. Best-effort — a write failure never wedges the TUI. */
+export declare function savePins(pins: Set<string>): void;

package/dist/core/canvas/browse/pins.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var r=(o,t)=>i(o,"name",{value:t,configurable:!0});import{join as s}from"node:path";import{userScopeRoot as e}from"../../scope.js";import{readJsonIfExists as a,atomicWriteJson as c}from"../../fs-utils.js";const f="browse-pins.json";function n(){return s(e(),f)}r(n,"pinsPath");function P(){const o=a(n());return new Set(Array.isArray(o)?o.filter(t=>typeof t=="string"):[])}r(P,"loadPins");function w(o){try{c(n(),[...o])}catch{}}r(w,"savePins");export{P as loadPins,w as savePins};

package/dist/core/canvas/browse/render.d.ts

@@ -0,0 +1,98 @@
+import type { TranscriptTurn } from '../render-source.js';
+import type { Tab, Tree, VisibleRow, SortMode } from './model.js';
+import { detectColorCaps, type Span, type ColorCaps } from '../../tui/draw.js';
+export { detectColorCaps };
+export type { ColorCaps };
+export declare const RECAP_LINES = 2;
+export declare const REPORT_LINES = 2;
+export declare const PREVIEW_BODY = 8;
+export declare const PREVIEW_HEIGHT: number;
+export type PreviewMode = 'none' | 'bottom' | 'side';
+/** Where the preview goes at this terminal width, and how the body splits.
+ *  `rowsW` is the width the row table draws into (full width unless `side`).
+ *  Exported so app.ts's viewport math can subtract preview ROWS only in `bottom`
+ *  mode — the side column costs columns, not rows. */
+export interface PreviewLayout {
+    mode: PreviewMode;
+    panelW: number;
+    rowsW: number;
+}
+export declare function previewLayout(cols: number, previewOn: boolean): PreviewLayout;
+export declare function headerHeight(inputLine: boolean): number;
+export interface RenderState {
+    tree: Tree;
+    visible: VisibleRow[];
+    tab: Tab;
+    cursor: number;
+    scrollOffset: number;
+    query: string;
+    search: boolean;
+    totalNodes: number;
+    /** Active cwd-scope filter; null = All dirs. Shown on the status line. */
+    cwdScope: string | null;
+    /** Active profile-scope filter; undefined = All profiles. Shown on the status line. */
+    profileScope: string | undefined;
+    /** Active ordering — status line + (flat modes) row presentation. */
+    sort: SortMode;
+    /** Whether the preview panel is drawn. */
+    preview: boolean;
+    /** Side panel shows the node's newest report instead of the goal/chat/state
+     *  briefing. Ignored while a search query is live (the transcript owns the panel)
+     *  and for a node that has pushed nothing. */
+    showReport?: boolean;
+    /** Lifecycle filter: when true, `terminal` (one-shot worker) nodes are hidden
+     *  — surfaced as a status-line cue. */
+    residentsOnly: boolean;
+    /** User-starred node ids — drives the ★ row marker + the Pinned tab. */
+    pinned: Set<string>;
+    /** Inline rename input: when true, the header shows a rename prompt bound to
+     *  `renameBuf` and the footer becomes commit/cancel. */
+    rename?: boolean;
+    renameBuf?: string;
+    /** Inline message input: when true, the header shows a message prompt bound to
+     *  `messageBuf` (delivered via `crtr node message send`). */
+    message?: boolean;
+    messageBuf?: string;
+    /** When true, the whole body is replaced by the keybinding help overlay. */
+    help?: boolean;
+    /** When set, a close-out (`x`) is awaiting y/n confirmation because the node (or
+     *  a descendant) is actively streaming. Holds the node id being confirmed; the
+     *  footer becomes the y/n prompt. null/undefined = no pending confirm. */
+    pendingClose?: string | null;
+    /** One-shot footer confirmation for a keystroke whose whole effect is off-screen
+     *  (`y` yank). Replaces the nav hints for exactly one frame; the app clears it on
+     *  the next key. null/undefined = show the ordinary footer. */
+    flash?: string | null;
+    /** Set when the source is a remote canvas: mutation/focus keys (`x`/`K`/Enter)
+     *  are disabled, so the footer drops their hints instead of advertising a
+     *  dead action. undefined/false = local, byte-identical footer. */
+    readOnly?: boolean;
+}
+/** How the fixed PREVIEW_BODY budget is divided for one row: the optional blocks
+ *  take their two lines only when the node actually has them, and the remainder is
+ *  split between the ask and the reply (ask keeps the odd line). */
+export declare function previewAllocation(hasRecap: boolean, hasReport: boolean): {
+    recap: number;
+    ask: number;
+    reply: number;
+    report: number;
+};
+/** Re-style every case-insensitive occurrence of `query` inside already-rendered
+ *  spans, splitting runs at the match edges. Working on the RENDERED text is what
+ *  lets a transcript keep its markdown and still highlight: the markup is already
+ *  gone, so no column can drift out from under a highlight. */
+export declare function highlightSpans(spans: Span[], query: string): {
+    spans: Span[];
+    hits: number;
+};
+/** How many turns contain the query — the count the section rule advertises. */
+export declare function transcriptHitTurns(turns: readonly TranscriptTurn[], query: string): number;
+/**
+ * Render the whole frame. Returns a single string that, written as-is, repaints
+ * the screen in place. `caps` gates all hue (defaults to a no-color frame so
+ * existing callers / non-TTY paths stay color-free).
+ */
+export declare function renderFrame(state: RenderState, size: {
+    cols: number;
+    rows: number;
+}, caps?: ColorCaps): string;

package/dist/core/canvas/browse/render.js

@@ -0,0 +1,3 @@
+var Nt=Object.defineProperty;var f=(t,n)=>Nt(t,"name",{value:n,configurable:!0});import{STATUS_GLYPH as rt,STATUS_COLOR as It,isFrozenRow as J,resolveNodeVisual as X,faultSummary as lt}from"../status-glyph.js";import{TABS as Pt,promptText as Ht,previewSnippet as q}from"./model.js";import{matchIndices as Gt}from"../../tui/fuzzy.js";import{clip as _,assemble as w,detectColorCaps as Dt}from"../../tui/draw.js";import{renderMarkdownSpans as Q}from"../../tui/markdown.js";const Bt=2,Ft=2,ct=8,it=ct+2,Ut=100,ut=46,jt=110,Yt=.55,at=40,dt=" \u2502 ";function Vt(t,n){const e=Math.max(20,t)-1;if(!n)return{mode:"none",panelW:0,rowsW:e};if(t<Ut)return{mode:"bottom",panelW:0,rowsW:e};const s=[...dt].length;let r=Math.min(jt,Math.max(ut,Math.round(e*Yt)));return e-r-s<at&&(r=e-s-at),r<ut?{mode:"bottom",panelW:0,rowsW:e}:{mode:"side",panelW:r,rowsW:e-r-s}}f(Vt,"previewLayout");function Me(t){return 5+(t?1:0)}f(Me,"headerHeight");const ft=10,$t=22,ht=6,pt=5,gt=16,W="  ",M="\x1B[",$=`${M}0m`,U=`${M}7m`,y=`${M}2m`,C=`${M}1m`,Kt=`${M}48;5;236m`,mt="33",zt="31",H="36",N="90",xt="93",I="96",bt="35";function Z(t){return t<=0?"0k":`${Math.floor(t/1e3)}k`}f(Z,"fmtCtx");function yt(t){if(t>=1e5)return zt;if(t>=5e4)return mt}f(yt,"ctxColorCode");function G(t,n){const e=Date.parse(t);if(Number.isNaN(e))return"";const s=Math.max(0,Math.floor((n-e)/1e3));if(s<60)return`${s}s`;const r=Math.floor(s/60);if(r<60)return`${r}m`;const o=Math.floor(r/60);if(o<24)return`${o}h`;const u=Math.floor(o/24);if(u<7)return`${u}d`;const i=Math.floor(u/7);return i<5?`${i}w`:`${Math.floor(u/30)}mo`}f(G,"relAge");function j(t){const n=t.replace(/\/+$/,"").split("/");return n[n.length-1]||t}f(j,"baseDir");const vt=new WeakMap;function Jt(t){const n=vt.get(t);if(n!==void 0)return n;const e={active:0,idle:0,done:0,dead:0,canceled:0};for(const r of t.nodes.values())e[r.row.status]++;const s=[];for(const r of["active","idle","done","dead","canceled"])e[r]>0&&s.push({status:r,count:e[r]});return vt.set(t,s),s}f(Jt,"statusCounts");function Xt(t,n){return Pt.map(e=>e===t?n?`${C}${M}${H}m[ ${e} ]${$}`:`${U}[ ${e} ]${$}`:n?`${y}  ${e}  ${$}`:`  ${e}  `).join("")}f(Xt,"tabBar");const qt=new Set;function Qt(t,n,e){const s=n===""?qt:Gt(n,t);if(s.size===0)return[{text:t,style:{dim:e.dim,bold:e.bold}}];const r=[];let o="",u=!1;const i=f(()=>{o!==""&&(u?r.push({text:o,style:{fg:I,bold:!0}}):r.push({text:o,style:{dim:e.dim,bold:e.bold}}),o="")},"flush");for(let l=0;l<t.length;l++){const c=s.has(l);c!==u&&(i(),u=c),o+=t[l]}return i(),r}f(Qt,"nameSpans");function L(t){let n=0;for(const e of t)n+=[...e.text].length;return n}f(L,"spansWidth");function Zt(t){const n=X(t.status,{streaming:t.streaming===!0,frozen:J(t),hanging:t.hanging??null}),e=n.word??{active:"active",idle:"idle",done:"done",dead:"dead",canceled:"cancel"}[t.status]??t.status,s=n.color,r=`${n.glyph} ${e}`,o=Math.max(1,ft-[...r].length);return[{text:r,style:{fg:s,bold:n.bold===!0}},{text:" ".repeat(o)}]}f(Zt,"statusRail");function te(t,n,e){const s=yt(t.ctx_tokens),r=[{text:Et(`${t.kind}/${t.mode}`,$t),style:{fg:N}},{text:W},{text:Z(t.ctx_tokens).padStart(ht),style:{fg:s,dim:s===void 0}},{text:W},{text:G(t.created,n).padStart(pt),style:{dim:!0}}];return e&&r.push({text:W},{text:Et(`~${j(t.cwd)}`,gt),style:{fg:N}}),r}f(te,"metaCluster");function Et(t,n){return _(t,n).padEnd(n)}f(Et,"clipPad");function tt(t,n,e,s,r,o){const u=L(t),i=L(n);if(n.length===0||u+i+1>e)return w(t,e,s,r,o);const l=e-u-i;return w([...t,{text:" ".repeat(l)},...n],e,s,r,o)}f(tt,"assembleRow");function ee(t,n,e,s,r,o,u,i,l,c=!0,h=!1){const a=n.nodes.get(t.id);if(a===void 0)return"";const d=a.row,b="  ".repeat(t.depth),m=t.hasChildren?t.collapsed?"\u25B8":"\u25BE":" ",E=d.status==="done"||d.status==="dead"||d.status==="canceled",v=d.viewed===!0?{text:"\uF06E ",style:{fg:I,bold:!0}}:{text:"  "},p=[];d.asks>0&&p.push({text:` \u2691${d.asks}`,style:{fg:xt,bold:!0}}),d.hanging!=null&&p.push({text:` \xB7 ${lt(d.hanging,i)}`,style:{fg:mt,dim:!0}});const x=l?[{text:"\u2605 ",style:{fg:bt,bold:!0}}]:[],T=Zt(d),R=c?te(d,i,u):[],A=`${b}${m} `,D=L([v])+L(T)+[...A].length+L(x)+L(p),B=L(R),K=Math.max(4,e-D-B-1),z={dim:!s&&E,bold:s},O=[v,...T,{text:A,style:{dim:!0}},...x,...Qt(_(d.name,K),r,z),...p];let k="",P=h;return s?(k=o.color256?Kt:U,P=!0):t.matched||(k=y),tt(O,R,e,o.color,k,P)}f(ee,"rowLine");function ne(t,n,e,s=!0,r=!1){const o=[{text:"  "},{text:"STATUS".padEnd(ft),style:{dim:!0,bold:!0}},{text:"NAME",style:{dim:!0,bold:!0}}];if(!s)return w(o,t,e.color,"",r);const u=[{text:"KIND/MODE".padEnd($t),style:{dim:!0,bold:!0}},{text:W},{text:"CTX".padStart(ht),style:{dim:!0,bold:!0}},{text:W},{text:"AGE".padStart(pt),style:{dim:!0,bold:!0}}];return n&&u.push({text:W},{text:"PROJECT".padEnd(gt),style:{dim:!0,bold:!0}}),tt(o,u,t,e.color,"",!1)}f(ne,"columnHeaderLine");function oe(t){const n=f(o=>`${y}${o}${$}`,"dim"),e=t.profileScope===void 0?"all profiles":"current",s=t.cwdScope===null?"all dirs":j(t.cwdScope),r=[`${n("profile")} ${e}`,`${n("scope")} ${s}`,`${n("sort")} ${t.sort}`,`${n("lifecycle")} ${t.residentsOnly?"residents":"all"}`];return!t.search&&t.query!==""&&r.push(`${n("filter")} ${t.query}`),r.join(n("  \xB7  "))}f(oe,"statusLine");function Mt(t,n,e,s){if(t.hi.size===0)return w([{text:t.text,style:s}],n,e.color,"",!1);const r=[];let o="",u=!1;const i=f(()=>{o!==""&&(r.push(u?{text:o,style:{fg:I,bold:!0}}:{text:o,style:s}),o="")},"flush");for(let l=0;l<t.text.length;l++){const c=t.hi.has(l);c!==u&&(i(),u=c),o+=t.text[l]}return i(),w(r,n,e.color,"",!1)}f(Mt,"snippetLine");function se(t,n){const e=t?Bt:0,s=n?Ft:0,r=Math.max(2,ct-e-s),o=Math.ceil(r/2);return{recap:e,ask:o,reply:r-o,report:s}}f(se,"previewAllocation");function _t(t,n,e,s,r,o,u){if(s<=0)return[];const i=[],l=o.color?`${y}${t}${$}`:t,c=Math.max(1,r-2);if(u===""){const a=Q(n,c,s,!1);if(a.length===0)i.push(`${l}${y}${_(e,c)}${$}`);else for(const d of a)i.push(`${i.length===0?l:"  "}${w(d,c,o.color,"",!1)}`);for(;i.length<s;)i.push("");return i}const h=q(u,n,c,s);if(h.length===0)i.push(`${l}${y}${_(e,c)}${$}`);else for(const a of h)i.push(`${i.length===0?l:"  "}${Mt(a,c,o)}`);for(;i.length<s;)i.push("");return i}f(_t,"markedBlock");function Tt(t,n,e,s){const r=`${t.padEnd(6)}`,o=_(n,Math.max(1,e-r.length));return s.color?`${y}${r}${$}${C}${o}${$}`:`${r}${o}`}f(Tt,"recapLine");function re(t,n,e,s,r){const o=[`${y}${"\u2500".repeat(n)}${$}`];if(t===void 0){for(;o.length<it;)o.push("");return o}const u=X(t.status,{streaming:t.streaming===!0,frozen:J(t),hanging:t.hanging??null}),i=e.color?`${M}${u.color}m${u.glyph}${$}`:u.glyph,l=[`${t.status} ${t.kind}/${t.mode}`,j(t.cwd),G(t.created,s),`ctx ${Z(t.ctx_tokens)}`];t.asks>0&&l.push(`\u2691${t.asks}`),t.hanging!=null&&l.push(lt(t.hanging,s)),t.streaming===!0&&l.push("\u27F3"),t.viewed===!0&&l.push("\uF06E viewing");const c=_(l.filter(d=>d!=="").join("  \xB7  "),Math.max(0,n-2));o.push(e.color?`${i} ${y}${c}${$}`:`${i} ${c}`);const h=se(t.recap!==void 0,t.report!==void 0);t.recap!==void 0&&(o.push(Tt("Goal",t.recap.goal===""?"\u2014":t.recap.goal,n,e)),o.push(Tt("State",t.recap.state===""?"\u2014":t.recap.state,n,e)));const a=r!==""?Ht(t):t.goal??"";if(o.push(..._t("\u276F ",a,"(no spawn prompt)",h.ask,n,e,r)),o.push(..._t("\u21A9 ",t.lastAssistant??"","(no reply yet)",h.reply,n,e,"")),t.report!==void 0){const d=G(t.report.ts,s),b=`${d===""?"":`${d} `}${t.report.kind}`,m=t.report.heading===""?t.report.body:t.report.heading,E=e.color?`${y}\u25A3 ${$}`:"\u25A3 ",v=Math.max(1,n-2),p=e.color?`${M}${H}m${b}${$}${y} \xB7 ${$}`:`${b} \xB7 `;o.push(`${E}${p}${_(m,Math.max(1,v-b.length-3))}`);for(let x=1;x<h.report;x++){const T=t.report.heading===""?"":t.report.body,R=q("",T,v,h.report-1)[x-1];o.push(R===void 0?"":`  ${y}${_(R.text,v)}${$}`)}}return o}f(re,"previewPanel");function Y(t,n,e,s){const r=s===void 0?"":`${s.text} `,o=Math.max(0,n-4-t.length-r.length),u=s===void 0?"":e.color?`${M}${s.fg}m${s.text}${$}${y} `:`${s.text} `;return`${y}\u2500\u2500 ${C}${t}${$}${y} ${u}${"\u2500".repeat(o)}${$}`}f(Y,"sectionRule");function et(t,n,e,s,r,o,u,i,l,c){if(o<=0)return[];const h=[...t].length,a=Math.max(1,u-h),d=f((m,E)=>w([{text:m,style:E}],h,i.color,"",!0),"mk");if(l===""){const m=Q(s,a,o,!0,c);return m.length===0?r===void 0?[]:[`${d(t,e)}${y}${_(r,a)}${$}`]:m.map((E,v)=>`${d(v===0?t:n,e)}${w(E,a,i.color,"",!1)}`)}const b=q(l,s,a,o);return b.length===0?r===void 0?[]:[`${d(t,e)}${y}${_(r,a)}${$}`]:b.map((m,E)=>`${d(E===0?t:n,e)}${Mt(m,a,i,c)}`)}f(et,"blockLines");const le=400,ce=1,nt=14,wt={fg:I,bold:!0,reverse:!0};function ie(t){let n="";for(const e of t)n+=e.text;return n}f(ie,"spansText");function ue(t,n){if(n==="")return{spans:t,hits:0};const e=ie(t),s=e.toLowerCase(),r=n.toLowerCase();if(s.indexOf(r)<0)return{spans:t,hits:0};const o=new Uint8Array(e.length);let u=0;for(let c=s.indexOf(r);c>=0;c=s.indexOf(r,c+r.length)){u++;for(let h=c;h<c+r.length;h++)o[h]=1}const i=[];let l=0;for(const c of t){let h="",a=o[l]===1;for(let d=0;d<c.text.length;d++){const b=o[l]===1;b!==a&&(h!==""&&i.push({text:h,style:a?wt:c.style}),h="",a=b),h+=c.text[d],l++}h!==""&&i.push({text:h,style:a?wt:c.style})}return{spans:i,hits:u}}f(ue,"highlightSpans");const V="\u258C ";function ot(t,n,e,s,r){if(e<2)return{lines:[],hits:0,truncated:!0};const o=t.role==="user",u=o?{fg:I,bold:!0}:{fg:N},i=Math.max(1,s-V.length),l=f(()=>w([{text:V,style:u}],V.length,r.color,"",!0),"bar"),c=[w([{text:V,style:u},{text:o?"YOU":"AGENT",style:{...u,bold:!0}}],s,r.color,"",!1)],a=Q(t.text,i,le,!1,o?{}:{dim:!0}).map(x=>ue(x,n)),d=a.reduce((x,T)=>x+T.hits,0),b=e-1;let m=0;a.length>b&&d>0&&(m=Math.max(0,a.findIndex(x=>x.hits>0)-ce),m=Math.min(m,a.length-b));const E=a.slice(m,m+b);for(const x of E)c.push(`${l()}${w(x.spans,i,r.color,"",!1)}`);const v=m>0,p=m+E.length<a.length;return v&&E.length>1&&(c[1]=`${l()}${y}\u22EF${$}`),p&&E.length>(v?2:1)&&(c[c.length-1]=`${l()}${y}\u22EF${$}`),{lines:c,hits:d,truncated:v||p}}f(ot,"turnBlock");function Rt(t,n,e){return w([{text:`  \u22EF ${t} ${t===1?"turn":"turns"}`,style:{dim:!0}}],n,e.color,"",!1)}f(Rt,"elisionLine");function St(t,n){return n!==""&&t.text.toLowerCase().indexOf(n.toLowerCase())>=0}f(St,"turnMatches");function ae(t,n){return t.reduce((e,s)=>e+(St(s,n)?1:0),0)}f(ae,"transcriptHitTurns");function At(t,n,e,s,r){if(s<=0||t.length===0)return[];const o=n===""?[]:t.map((l,c)=>St(l,n)?c:-1).filter(l=>l>=0);if(o.length>0){const l=[];let c=-1;for(const a of o){const d=l.length===0?0:1,b=s-l.length-d;if(b<3)break;const{lines:m}=ot(t[a],n,Math.min(b,nt),e,r);if(m.length===0)break;const E=c<0?a:a-c-1,v=E>0&&l.length+d+m.length+1<=s;d>0&&l.push(""),v&&l.push(Rt(E,e,r)),l.push(...m),c=a}let h=c;for(let a=c+1;a<t.length;a++){const d=s-l.length-1;if(d<3)break;const{lines:b,truncated:m}=ot(t[a],n,Math.min(d,nt),e,r);if(b.length===0||m)break;l.push("",...b),h=a}return h>=0&&h<t.length-1&&l.length<s&&l.push(Rt(t.length-1-h,e,r)),l.slice(0,s)}const u=[];let i=0;for(let l=t.length-1;l>=0;l--){const c=u.length===0,h=c?0:1,a=s-i-h;if(a<3)break;const{lines:d,truncated:b}=ot(t[l],"",Math.min(a,nt),e,r);if(d.length===0||b&&!c)break;h>0&&u.push([""]),u.push(d),i+=d.length+h}return u.reverse().flat().slice(-s)}f(At,"transcriptLines");function kt(t){return t.transcriptLoaded===!0||t.previewLoaded===!0?`${y}(no conversation yet)${$}`:`${y}(loading\u2026)${$}`}f(kt,"emptyBodyNote");function Ct(t){const n=t.transcript;if(n!==void 0&&n.length>0)return n;const e=[];return t.goal!==void 0&&t.goal!==""&&e.push({role:"user",text:t.goal}),t.lastAssistant!==void 0&&t.lastAssistant!==""&&e.push({role:"assistant",text:t.lastAssistant}),e}f(Ct,"panelTurns");const de=4;function fe(t,n,e,s){const r=yt(t.ctx_tokens),o=f(()=>({text:" \xB7 ",style:{dim:!0}}),"dot"),u=[{text:`${t.kind}/${t.mode}`,style:{fg:N}},o(),{text:`~${j(t.cwd)}`,style:{fg:N}},o(),{text:G(t.created,e),style:{dim:!0}},o(),{text:`ctx ${Z(t.ctx_tokens)}`,style:{fg:r,dim:r===void 0}}];return w(u,n,s.color,"",!1)}f(fe,"panelFactsLine");function $e(t,n,e,s){if(t===void 0)return w([{text:"PREVIEW",style:{dim:!0,bold:!0}}],n,e.color,"",!1);const r=[];s&&r.push({text:"\u2605 ",style:{fg:bt,bold:!0}});const o=t.node_id.slice(0,8);return r.push({text:_(t.name,Math.max(4,n-o.length-2-L(r))),style:{bold:!0}}),tt(r,[{text:o,style:{dim:!0}}],n,e.color,"",!1)}f($e,"panelTitleLine");function he(t,n,e,s,r,o,u){if(e<=0)return[];if(t===void 0)return[`${y}(no selection)${$}`];if(o!==""){const p=Ct(t),x=ae(p,o),T=[Y("TRANSCRIPT",n,s,x>0?{text:`${x} ${x===1?"turn":"turns"}`,fg:I}:{text:"matched on name",fg:N})],R=At(p,o,n,e-1,s);return T.push(...R.length===0?[kt(t)]:R),T.slice(0,e)}const i=t.report,l=f(()=>({fg:X(t.status,{streaming:t.streaming===!0,frozen:J(t),hanging:t.hanging??null}).color}),"accentOf");if(u&&i!==void 0){const p=G(i.ts,r),x=[Y("REPORT",n,s,{text:`${p===""?"":`${p} \xB7 `}${i.kind}`,fg:H})],T=i.heading===""?i.body:i.heading;return x.push(...et("\u25A3 ","  ",{fg:H,bold:!0},T,void 0,3,n,s,"",{bold:!0})),i.heading!==""&&i.body!==""&&(x.push(""),x.push(...et("  ","  ",void 0,i.body,void 0,e-x.length,n,s,""))),x.slice(0,e)}const c=[fe(t,n,r,s),""],h=l(),a=f((p,x)=>[Y(p,n,s),...et("\u258C ","\u258C ",h,x,void 0,de,n,s,"",{bold:!0})],"briefing"),d=t.recap?.goal??"";d!==""&&c.push(...a("GOAL",d),"");const b=t.recap?.state??"",m=b===""?[]:[...a("STATE",b)],E=m.length===0?0:m.length+1,v=e-c.length-E-1;if(v>=2){c.push(Y("CHAT",n,s));const p=At(Ct(t),"",n,v,s);c.push(...p.length===0?[kt(t)]:p)}if(m.length>0){for(;c.length<e-m.length;)c.push("");c.push(...m)}return c.slice(0,e)}f(he,"sidePanelBody");const pe=[["Move","\u2191/\u2193  j/k","up / down"],["","g / G","top / bottom"],["",".","jump to this node (recenter)"],["Tree","\u2192/\u2190  h/l","expand / collapse"],["","space","toggle fold"],["Tabs","Tab / 1-5","All \xB7 Live \xB7 Dormant \xB7 Attention \xB7 Pinned"],["Find","/","fuzzy search (name \xB7 kind \xB7 id \xB7 prompts)"],["Pin","p","star / unstar \u2014 floats to top, Pinned tab"],["Open","\u23CE  o","open conversation (closes navigator)"],["","O","open, keep browsing (background)"],["Act","y","copy the node id to the clipboard"],["","m","message the node (no resume)"],["","R","rename the node"],["","x","close-out node + subtree"],["","K","revive now (a hanging node)"],["View","s","cycle sort (attention/tree/relevance/recency)"],["","c","toggle cwd scope"],["","P","toggle profile scope"],["","r","toggle residents-only"],["","v","toggle preview (goal, chat, state)"],["","V","in the preview: swap chat for the newest report"],["Quit","q / Esc",""]];function ge(t,n){const e=Math.max(20,t.cols),s=Math.max(8,t.rows),r=e-1,o=[];o.push(`${C}Canvas navigator \u2014 keys${$}`),o.push("");const u=f(l=>`${y}${l}${$}`,"dim");for(const[l,c,h]of pe){const a=l.padEnd(6),d=c.padEnd(12),b=`  ${u(a)}${C}${d}${$}${h===""?"":`  ${u(h)}`}`;o.push(_(b,r))}for(o.push(""),o.push(u("  ? or any key to close"));o.length<s-1;)o.push("");const i=o.map(l=>`${l}${M}K`).join(`\r
+`);return`${M}H${i}${M}J`}f(ge,"renderHelp");function _e(t,n,e={color:!1,color256:!1}){if(t.help===!0)return ge(n,e);const s=Math.max(20,n.cols),r=Math.max(8,n.rows),o=s-1,u=Date.now(),i=t.search||t.rename===!0||t.message===!0,l=[],c=`${C}Canvas${$} \u2014 ${t.totalNodes} nodes`,h=`Canvas \u2014 ${t.totalNodes} nodes`.length,a=Jt(t.tree),d=a.map(g=>`${rt[g.status]}${g.count}`).join(" "),b=e.color?a.map(g=>`${M}${It[g.status]}m${rt[g.status]}${$}${y}${g.count}${$}`).join(" "):`${y}${d}${$}`,m=o-h-d.length;if(l.push(m>1?`${c}${" ".repeat(m)}${b}`:c),l.push(Xt(t.tab,e.color)),l.push(oe(t)),i){const g=t.rename===!0?"rename \u25B8":t.message===!0?"msg \u25B8":"/",S=t.rename===!0?t.renameBuf??"":t.message===!0?t.messageBuf??"":t.query,F=e.color?`${M}${H}m${g}${$}`:g;l.push(`${F} ${S}\u258E`)}const E=t.preview&&t.visible.length>0,v=Vt(s,E),p=v.mode==="side",x=p?v.rowsW:o,T=`${y}${dt}${$}`,R=t.visible[t.cursor],A=R!==void 0?t.tree.nodes.get(R.id)?.row:void 0,D=t.cwdScope===null&&!p,B=ne(x,D,e,!p,p);l.push(p?`${B}${T}${$e(A,v.panelW,e,R!==void 0&&t.pinned.has(R.id))}`:B),l.push(p?`${y}${"\u2500".repeat(x)}\u2500\u253C\u2500${"\u2500".repeat(v.panelW)}${$}`:`${y}${"\u2500".repeat(o)}${$}`);const K=l.length,z=v.mode==="bottom"?it:0,O=Math.max(1,r-K-1-z),k=t.scrollOffset,P=Math.min(t.visible.length,k+O),Lt=p?he(A,v.panelW,O,e,u,t.query,t.showReport===!0):[],st=f((g,S)=>p?`${g}${T}${Lt[S]??""}`:g,"compose"),Ot=p?" ".repeat(x):"";if(t.visible.length===0){l.push(`${y}  (no nodes match this view)${$}`);for(let g=1;g<O;g++)l.push("")}else{for(let g=k;g<P;g++){const S=t.visible[g];l.push(st(ee(S,t.tree,x,g===t.cursor,t.query,e,D,u,t.pinned.has(S.id),!p,p),g-k))}for(let g=P-k;g<O;g++)l.push(st(Ot,g))}if(v.mode==="bottom")for(const g of re(A,o,e,u,t.query))l.push(g);if(t.pendingClose!==null&&t.pendingClose!==void 0){const g=t.tree.nodes.get(t.pendingClose),F=`\u26A0 ${g!==void 0?g.row.name:t.pendingClose} is \u27F3 \u2014 close it (and its subtree) anyway?  y / n`;l.push(e.color?`${C}${M}${xt}m${_(F,o)}${$}`:`${U}${_(F,o)}${$}`)}else if(t.flash!==null&&t.flash!==void 0&&t.flash!=="")l.push(e.color?`${C}${_(t.flash,o)}${$}`:`${U}${_(t.flash,o)}${$}`);else{const g=A?.hanging!=null?"K revive now  ":"",S=i?"\u23CE commit  Esc cancel  \u232B delete":t.readOnly===!0?"\u2191\u2193 move  \u2192/\u2190 tree  / search  p pin  v preview  Tab tabs  ? more  q quit  \u2014 read-only remote canvas":`${g}${A?.report!==void 0&&p&&t.query===""?t.showReport===!0?"V chat  ":"V report  ":""}\u2191\u2193 move  \u23CE open  O bg  / search  p pin  v preview  m msg  x close  ? more  q quit`;l.push(`${y}${_(S,o)}${$}`)}const Wt=l.map(g=>`${g}${M}K`).join(`\r
+`);return`${M}H${Wt}${M}J`}f(_e,"renderFrame");export{ct as PREVIEW_BODY,it as PREVIEW_HEIGHT,Bt as RECAP_LINES,Ft as REPORT_LINES,Dt as detectColorCaps,Me as headerHeight,ue as highlightSpans,se as previewAllocation,Vt as previewLayout,_e as renderFrame,ae as transcriptHitTurns};