@north-light/cli 0.0.0 → 0.3.413

package/dist/clients/attach/input/titled-editor.d.ts

@@ -0,0 +1,225 @@
+import { CustomEditor } from '@earendil-works/pi-coding-agent';
+import { type EditorOptions, type EditorTheme, type TUI } from '@earendil-works/pi-tui';
+/** Keep inline command disclosure compact and bounded before wrapping; the
+ * inspector remains the unbounded, exact-prompt surface. */
+export declare function compactLoadedCommandPreview(content: string, width: number): string[];
+/** Thinking levels pi cycles through (shift+tab), lowest → highest budget. */
+export type ThinkingLevel = 'off' | 'minimal' | 'low' | 'medium' | 'high' | 'xhigh' | 'max';
+/** Build a title-chip styler for a `/color` token (a tmux colour name, `#rrggbb`,
+ *  or `colourN`): the colour as the chip BACKGROUND with contrast-picked bold
+ *  text, matching the thinking-chip treatment. `undefined` for an unrenderable
+ *  token (e.g. `default`) — the caller keeps its fallback style. */
+export declare function colorChipStyle(token: string): ((s: string) => string) | undefined;
+/** The default (thinking `off`) title chip: reverse video + a space of padding
+ *  each side, so the name reads as a label sitting on the border rule. Used as
+ *  the fallback when no thinking color applies. */
+export declare const defaultTitleStyle: (s: string) => string;
+/** Resolve the editor border colorizer for a thinking level. Unknown / `off` →
+ *  the supplied `fallback` (the theme's default border color). */
+export declare function thinkingBorderColor(level: string | undefined, fallback: (s: string) => string): (s: string) => string;
+/** Resolve the title-chip styler for a thinking level: the level's color as the
+ *  chip BACKGROUND with bold white text (a space of padding each side), so the
+ *  session name reads as a solid label in the same hue as the border. Unknown /
+ *  `off` → the supplied `fallback` (the reverse-video default chip). */
+export declare function thinkingTitleStyle(level: string | undefined, fallback: (s: string) => string): (s: string) => string;
+/** Compose the replacement top-border line: solid title chip + border rule +
+ *  info chip, never wider than `width` (pi-tui hard-crashes on an over-wide
+ *  line). The info chip yields entirely when the chip leaves it almost no room,
+ *  and truncates when it only partially fits. Exported pure for the overflow
+ *  regression test. */
+export declare function composeTopBorder(width: number, title: string, info: string, titleStyle: (s: string) => string, borderColor: (s: string) => string): string;
+export declare function outlineCursorLine(line: string): string | undefined;
+/** Recognize a single input chunk as a filesystem path to an image file — how a
+ *  terminal delivers a file DRAGGED into the pane (the escaped path pasted in
+ *  bulk, optionally wrapped in bracketed-paste markers). Returns the resolved
+ *  path, or null when the chunk isn't a lone image path (normal typing, multi-
+ *  line text, a non-image path, or a path that doesn't point at a real file).
+ *  Conservative on purpose: it must never transform ordinary typed input. */
+export declare function detectDroppedImagePath(data: string): string | null;
+/** One projected layout entry — a faithful port of pi-tui's private
+ *  `Editor.prototype.layoutText`, extended with the logical line each entry
+ *  came from (the base algorithm processes one editor at a time and never
+ *  needs to report this, since it already owns `this.state.lines`). */
+export interface RefLayoutChunk {
+    logicalLine: number;
+    startIndex: number;
+    endIndex: number;
+    text: string;
+    hasCursor: boolean;
+    cursorPos: number;
+}
+/** Recompute the exact layout pi-tui's `Editor.render` will produce for
+ *  `lines` at `layoutWidth`, faithfully porting the private `layoutText`
+ *  algorithm (empty-editor special case; per-line whole-fit vs `wordWrapLine`
+ *  branch; cursor-in-chunk assignment for wrapped lines). `wordWrapLine` here
+ *  is called WITHOUT the base editor's private paste-marker-aware
+ *  presegmentation, so a wrapped line containing a paste marker can
+ *  theoretically diverge from the real render's chunk boundaries — harmless,
+ *  because `decorateRow`'s verify-before-splice check means any divergence
+ *  simply drops that row's decoration rather than corrupting it. */
+export declare function buildRefLayoutChunks(lines: readonly string[], layoutWidth: number, cursorLine: number, cursorCol: number): RefLayoutChunk[];
+/** Splice underline/dim styling around every resolved-ref span that survives
+ *  chrome-safety verification. `rowStr` is one already-rendered content row
+ *  (plain, or carrying exactly the cursor's own cell markup); `chunk` is the
+ *  layout entry it was built from; `spans` are candidate resolved-ref spans
+ *  already filtered to lie within `chunk`'s logical range; `line` is the full
+ *  logical line text (used only to verify a span's characters still match at
+ *  the row offset we computed — never spliced in directly). Exported pure for
+ *  direct testing. */
+export declare function decorateRow(rowStr: string, chunk: RefLayoutChunk, spans: ReadonlyArray<{
+    start: number;
+    end: number;
+}>, line: string, paddingX: number): string;
+export declare class TitledEditor extends CustomEditor {
+    /** crtr's OWN keybindings manager — the same one CustomEditor matches `app.*`
+     *  against. We keep a reference so `handleInput` can resolve the newline chord
+     *  here, independent of the editor's (possibly separate) pi-tui module global. */
+    private readonly km;
+    /** The raw (untrimmed) text `submitValue()` is ABOUT to trim away, captured by
+     *  the `submitValue` monkeypatch just below it runs, and consumed exactly once
+     *  by the `onSubmit` accessor wrapper. See the constructor for why. */
+    private pendingRawSubmitText;
+    /** The REAL caller-supplied `onSubmit` handler (what `InputController` wires
+     *  via `this.editor.onSubmit = ...`) — stored here because `onSubmit` itself is
+     *  converted to an accessor below whose getter always returns our substitution
+     *  wrapper, not this value directly. */
+    private realOnSubmit;
+    /** A line ending held back to learn whether more input follows it within
+     *  `PASTE_BURST_MS` — see `handleInput`'s unbracketed-paste rescue. More input
+     *  means it was a line break inside a paste (insert a newline); silence means
+     *  a human pressed Enter (submit). */
+    private pendingReturn;
+    /** How long a line ending is held before it counts as a real Enter. An
+     *  unbracketed paste floods `handleInput` within one event-loop tick, so its
+     *  next character always lands far inside this window; a human's next
+     *  keystroke after Enter is ~30ms+ away at the very fastest. Short enough that
+     *  the added submit latency is imperceptible. */
+    private static readonly PASTE_BURST_MS;
+    constructor(tui: TUI, theme: EditorTheme, keybindings: ConstructorParameters<typeof CustomEditor>[2], options?: EditorOptions);
+    /** Insert a newline on the newLine chord (Alt+Enter / Shift+Enter) using crtr's
+     *  OWN keybindings manager, then defer everything else to the stock editor.
+     *
+     *  The base `Editor` resolves newLine against `getKeybindings()` on ITS pi-tui
+     *  instance, which in a non-deduped install is a DIFFERENT module than the one
+     *  carrying crtr's `alt+enter` override — so the override can silently never
+     *  reach it and Alt+Enter falls through to submit. crtr's `km` (the
+     *  same manager CustomEditor matches `app.*` against) always carries the
+     *  override, so matching the chord here makes the newline behavior independent
+     *  of cross-instance keybinding mirroring. Skipped while the autocomplete popup
+     *  is open so Enter-to-confirm keeps working. */
+    /** Set by the input controller: called when a bulk input chunk is recognized
+     *  as a filesystem path to an image file (a file DRAGGED into the pane, which
+     *  the terminal delivers as bracketed-paste TEXT, not an image event). Returns
+     *  true when it consumed the drop, so the raw path is never inserted as text. */
+    onPasteImagePath?: (path: string) => boolean;
+    /** Settle a line ending held by the unbracketed-paste rescue. `'newline'` (more
+     *  input arrived, so it was a paste's own line break) inserts it in place;
+     *  `'submit'` (the hold window expired in silence, so a human pressed Enter)
+     *  replays it through the stock editor and repaints, because this runs outside
+     *  the TUI's own post-`handleInput` render request. No-op when nothing is
+     *  held. */
+    private settleHeldReturn;
+    /** Width of an `[Image #N]` token sitting immediately before the cursor on the
+     *  current line, or 0 when the cursor isn't at the end of such a token — used to
+     *  delete/skip the token atomically. The token's separating space is a normal,
+     *  reachable character, deliberately NOT part of the atom. */
+    private imageTokenWidthBeforeCursor;
+    /** Width of an `[Image #N]` token sitting immediately after the cursor on the
+     *  current line, or 0 when the cursor isn't at the start of such a token — used
+     *  to skip the token with the right arrow. */
+    private imageTokenWidthAfterCursor;
+    handleInput(data: string): void;
+    /** The base editor auto-triggers autocomplete for a LEADING slash context
+     *  (`isInSlashCommandContext`, `insertCharacter`) whenever the text before
+     *  the cursor — from the very start of the line — begins with `/`. A
+     *  non-leading ref elsewhere in ordinary text (`hey check /dev`) never
+     *  satisfies that check, so it would otherwise require an explicit Tab.
+     *  This bridges exactly that gap: after an ordinary single-character
+     *  insertion, if the caret now sits in a non-leading ref token
+     *  (`findRefCompletionContext` — T1's shared caret classifier, not
+     *  reimplemented here), nudge the same private trigger the base editor uses
+     *  for its own leading case. Detected purely by before/after cursor and
+     *  text-length diffing, so it's mechanism-agnostic (typed key or decoded
+     *  printable key alike) and naturally excludes multi-character paste
+     *  (`handlePaste` already suppresses autocomplete itself, and the exact +1
+     *  length-delta check here would reject it anyway). Leading context is
+     *  deliberately left untouched — triggering it again here would double the
+     *  base editor's own native trigger for that case. */
+    private maybeTriggerNonLeadingRefAutocomplete;
+    /** Called after native ↓ navigation proves the editor and prompt history are
+     * both exhausted. Attach uses this boundary handoff to enter its node roster. */
+    onCursorDownAtBottom?: () => void;
+    /** Fully-expanded prompt template currently loaded by the editor's leading
+     * slash token. It renders inside the editor outline before submission, so the
+     * user can inspect the exact payload while arguments are still editable. */
+    loadedCommand: {
+        name: string;
+        content: string;
+        inspectHint: string;
+    } | undefined;
+    /** Session-name chip painted into the LEFT of the top border. Empty → plain. */
+    title: string;
+    /** Pre-styled context string painted into the RIGHT of the top border (cwd /
+     *  branch / git status). Already colorized by the caller; empty → omitted. */
+    info: string;
+    /** Node and workspace badge painted at the far bottom-right of the outline. */
+    contextBadge: string;
+    /** Paint the chip solid so the name reads as a label sitting on the border
+     *  rule. Defaults to the reverse-video chip; viewer.ts swaps in a
+     *  thinking-colored background (bold white text) on each state update. */
+    titleStyle: (s: string) => string;
+    /** Node and workspace badge colorizer, matched to the editor frame. */
+    contextBadgeStyle: (s: string) => string;
+    /** Whether the hosting tmux pane / terminal window has FOCUS (terminal focus
+     *  reporting, DECSET 1004 — viewer.ts flips this on `\x1b[I` / `\x1b[O`).
+     *  Distinct from TUI component focus: the editor keeps component focus while
+     *  its pane is blurred. False → the fake cursor renders as an outline. */
+    paneFocused: boolean;
+    /** Canonical names the broker currently resolves — the exact-membership set
+     *  a candidate ref token must be in to render as a resolved highlight.
+     *  Empty by default (no decoration) until the caller supplies the
+     *  broker-supplied inventory. */
+    private resolvedRefNames;
+    /** Command names the VIEWER dispatches ENTIRELY locally (never reach the
+     *  engine as prose) — checked against the TRIMMED leading-name rule
+     *  (`extractLeadingCommandName`, which mirrors `slash/dispatch.ts`'s own
+     *  `text.trim()`-based dispatch parse). Exactly
+     *  `locallyConsumedCommandNames()` from `slash/dispatch.ts` — independent
+     *  of `remote` and of the broker's `get_commands` reply (see that
+     *  function's doc comment). Deliberately NEVER the merged display/
+     *  completion list (`slashCommandList` is a different, remote-filtered,
+     *  broker-augmented list, not a dispatch predicate). */
+    private localCommandNames;
+    /** Leading tokens the ENGINE (broker) independently consumes as a leading
+     *  command/skill/template dispatch — the broker's own
+     *  `engineLeadingCommandNames`, checked against the UNTRIMMED leading-name
+     *  rule (`matchesEngineLeadingCommand`, mirroring the broker's own
+     *  `isLeadingEngineCommand`). Populated from each
+     *  `list_memory_refs` reply, alongside `resolvedRefNames`. */
+    private engineCommandNames;
+    setResolvedRefNames(names: Iterable<string>): void;
+    /** The canonical names of memory refs currently resolvable in this session —
+     *  used to record ref usage on submit without counting non-ref slash tokens. */
+    getResolvedRefNames(): ReadonlySet<string>;
+    setLocalCommandNames(names: Iterable<string>): void;
+    setEngineCommandNames(names: Iterable<string>): void;
+    /** Render-only decoration pass: underlines every resolved-ref span visible
+     *  in the already-rendered content rows, using a from-scratch layout
+     *  recompute (`buildRefLayoutChunks`) that mirrors the base editor's own
+     *  private `layoutText`/`scrollOffset`/`maxVisibleLines` math so row/column
+     *  offsets line up. Never mutates stored text; a span whose recomputed
+     *  offset doesn't verify against the real rendered row (see `decorateRow`)
+     *  is simply left undecorated. Suppressed entirely (command-wide) whenever
+     *  the composer's own leading token dispatches — as a LOCAL viewer command
+     *  (`localCommandNames`, TRIMMED rule) or as an ENGINE-consumed leading
+     *  command/skill/template (`engineCommandNames`, UNTRIMMED rule) — the ref
+     *  grammar and slash-dispatch's name charset differ, so
+     *  highlighting a ref inside a command that's about to dispatch would be
+     *  misleading chrome for text the command, not memory resolution, is about
+     *  to consume. The two rules are kept deliberately SEPARATE rather than
+     *  collapsed into one set/predicate: they classify against
+     *  different text (trimmed vs. raw) and different authorities (this
+     *  viewer's own dispatch vs. the broker's). */
+    private decorateResolvedRefs;
+    render(width: number): string[];
+}

package/dist/clients/attach/input/titled-editor.js

@@ -0,0 +1,4 @@
+var w=Object.defineProperty;var d=(s,e)=>w(s,"name",{value:e,configurable:!0});import{statSync as D}from"node:fs";import{CustomEditor as B}from"@earendil-works/pi-coding-agent";import{CURSOR_MARKER as E,truncateToWidth as C,visibleWidth as b,wrapTextWithAnsi as v}from"@earendil-works/pi-tui";import{wordWrapLine as H}from"@earendil-works/pi-tui/dist/components/editor.js";import{findRefTokens as F}from"../../../shared/inline-ref-grammar.js";import{findRefCompletionContext as G}from"./ref-autocomplete.js";const M=8,U=24,V=8192;function K(s,e){const t=s.slice(0,e),n=s.length>e;return{text:t.replace(/\x1b\](?:[^\x07\x1b]*)(?:\x07|\x1b\\)?/g,"").replace(/\x1b\[[0-?]*[ -/]*[@-~]/g,"").replace(/[\x00-\x09\x0b-\x1f\x7f-\x9f]/g,""),truncated:n}}d(K,"sanitizeLoadedCommandPreview");function j(s,e){if(e<U)return[];const t=Math.min(V,Math.max(256,e*M*4)),n=K(s,t),r=v(n.text,e);if(!n.truncated&&r.length<=M)return r;const c=r.slice(0,M-1);return c.push(C("\u2026 truncated \xB7 inspect for full prompt",e)),c}d(j,"compactLoadedCommandPreview");const S=[46,92,190],R=[166,98,24],z=[0,145,170];function L(s,e,t){return[Math.round(s[0]+(e[0]-s[0])*t),Math.round(s[1]+(e[1]-s[1])*t),Math.round(s[2]+(e[2]-s[2])*t)]}d(L,"interpolateRgb");const P={off:void 0,minimal:L(S,R,0/4),low:L(S,R,1/4),medium:L(S,R,2/4),high:L(S,R,3/4),xhigh:L(S,R,4/4),max:z},X={black:[0,0,0],red:[205,49,49],green:[13,188,121],yellow:[229,229,16],blue:[36,114,200],magenta:[188,63,188],cyan:[17,168,205],white:[229,229,229],orange:[228,152,68],grey:[128,128,128],gray:[128,128,128],brightred:[241,76,76],brightgreen:[35,209,139],brightyellow:[245,245,67],brightblue:[59,142,234],brightmagenta:[214,112,214],brightcyan:[41,184,219]};function xe(s){const e=s.trim().toLowerCase(),t=/^colour(\d{1,3})$/.exec(e);if(t!==null)return a=>`\x1B[48;5;${t[1]}m\x1B[97m\x1B[1m ${a} \x1B[0m`;let n;const r=/^#([0-9a-f]{6})$/.exec(e);if(r!==null){const a=r[1];n=[parseInt(a.slice(0,2),16),parseInt(a.slice(2,4),16),parseInt(a.slice(4,6),16)]}else n=X[e];if(n===void 0)return;const[c,i,o]=n,u=.299*c+.587*i+.114*o>160?"\x1B[30m":"\x1B[97m";return a=>`\x1B[48;2;${c};${i};${o}m${u}\x1B[1m ${a} \x1B[0m`}d(xe,"colorChipStyle");const k=d(s=>`\x1B[7m ${s} \x1B[27m`,"defaultTitleStyle");function pe(s,e){const t=s===void 0?void 0:P[s];if(t===void 0)return e;const[n,r,c]=t;return i=>`\x1B[38;2;${n};${r};${c}m${i}\x1B[39m`}d(pe,"thinkingBorderColor");function be(s,e){const t=s===void 0?void 0:P[s];if(t===void 0)return e;const[n,r,c]=t;return i=>`\x1B[48;2;${n};${r};${c}m\x1B[97m\x1B[1m ${i} \x1B[0m`}d(be,"thinkingTitleStyle");function Y(s,e,t,n,r){const c=e?n(C(e,Math.max(1,s-4),"\u2026")):"",i=b(c),o=s-i;let l="";t&&o>4&&(l=b(t)<=o?t:C(t,o,"\u2026"));const u=Math.max(0,s-i-b(l));return c+r("\u2500".repeat(u))+l}d(Y,"composeTopBorder");const N="\x1B[7m",A="\x1B[0m",_="\x1B[48;5;240m";function q(s){const e=s.indexOf(E);if(e===-1)return;const t=e+E.length;if(!s.startsWith(N,t))return;const n=t+N.length,r=s.indexOf(A,n);if(r===-1)return;const c=s.slice(n,r),i=`${_}${c}\x1B[0m`;return s.slice(0,t)+i+s.slice(r+A.length)}d(q,"outlineCursorLine");const Z=/\.(png|jpe?g|gif|webp|bmp)$/i;function J(s){const e=s.match(/\x1b\[200~([\s\S]*?)\x1b\[201~/);let t=(e?e[1]:s).trim();if(t.length<2||/[\u0000-\u0008\u000e-\u001f]/.test(t))return null;(t.startsWith("'")&&t.endsWith("'")||t.startsWith('"')&&t.endsWith('"'))&&(t=t.slice(1,-1));const n=t.replace(/\\(.)/g,"$1");if(/\n/.test(n)||!Z.test(n))return null;try{if(!D(n).isFile())return null}catch{return null}return n}d(J,"detectDroppedImagePath");function Q(s,e,t,n){const r=[];if(s.length===0||s.length===1&&s[0]==="")return r.push({logicalLine:0,startIndex:0,endIndex:0,text:"",hasCursor:!0,cursorPos:0}),r;for(let c=0;c<s.length;c++){const i=s[c]??"",o=c===t;if(b(i)<=e){r.push({logicalLine:c,startIndex:0,endIndex:i.length,text:i,hasCursor:o,cursorPos:o?n:0});continue}const l=H(i,e);for(let u=0;u<l.length;u++){const a=l[u];if(!a)continue;const h=u===l.length-1;let m=!1,f=0;o&&(h?(m=n>=a.startIndex,f=n-a.startIndex):(m=n>=a.startIndex&&n<a.endIndex,m&&(f=n-a.startIndex,f>a.text.length&&(f=a.text.length)))),r.push({logicalLine:c,startIndex:a.startIndex,endIndex:a.endIndex,text:a.text,hasCursor:m,cursorPos:f})}}return r}d(Q,"buildRefLayoutChunks");function ee(s,e){return F(s).filter(t=>e.has(t.candidate)).map(t=>({start:t.start,end:t.end}))}d(ee,"resolvedSpansForLine");const te="\x1B[4m\x1B[2m",ne="\x1B[24m\x1B[22m",se=new Intl.Segmenter(void 0,{granularity:"grapheme"});function re(s){for(const e of se.segment(s))return e.segment.length;return 0}d(re,"firstGraphemeLength");function ie(s){const e=s.indexOf(E),t=e===-1?0:e+E.length;let n=s.indexOf(N,t),r=N.length;if(n===-1&&(n=s.indexOf(_,t),r=_.length),n===-1)return null;const c=s.indexOf(A,n+r);return c===-1?null:{start:e!==-1?e:n,end:c+A.length}}d(ie,"locateCursorCell");function oe(s,e,t,n,r){const c=[];if(e.hasCursor){const o=ie(s);if(o===null)return s;const l=e.text.slice(e.cursorPos),u=l.length===0?0:re(l),a=e.cursorPos+u;for(const h of t){const m=h.start-e.startIndex,f=h.end-e.startIndex;if(f<=e.cursorPos){const g=r+m,x=r+f;x<=o.start&&s.slice(g,x)===n.slice(h.start,h.end)&&c.push({absStart:g,absEnd:x})}else if(m>=a){const g=o.end+(m-a),x=o.end+(f-a);g>=o.end&&s.slice(g,x)===n.slice(h.start,h.end)&&c.push({absStart:g,absEnd:x})}}}else for(const o of t){const l=r+(o.start-e.startIndex),u=r+(o.end-e.startIndex);s.slice(l,u)===n.slice(o.start,o.end)&&c.push({absStart:l,absEnd:u})}if(c.length===0)return s;c.sort((o,l)=>l.absStart-o.absStart);let i=s;for(const o of c)i=i.slice(0,o.absStart)+te+i.slice(o.absStart,o.absEnd)+ne+i.slice(o.absEnd);return i}d(oe,"decorateRow");function ce(s){const e=/^\/(\S+)\s*([\s\S]*)$/.exec(s.trim());return e?e[1]:null}d(ce,"extractLeadingCommandName");function ae(s,e){if(!s.startsWith("/"))return!1;const t=s.indexOf(" "),n=t===-1?s.slice(1):s.slice(1,t);if(e.has(n))return!0;if(s.startsWith("/skill:")){const r=t===-1?s.slice(7):s.slice(7,t);if(e.has(`skill:${r}`))return!0}return!1}d(ae,"matchesEngineLeadingCommand");class W extends B{static{d(this,"TitledEditor")}km;pendingRawSubmitText;realOnSubmit;pendingReturn;static PASTE_BURST_MS=10;constructor(e,t,n,r){super(e,t,n,r),this.km=n;const c=this.submitValue.bind(this);this.submitValue=()=>{const i=this;this.pendingRawSubmitText=i.getExpandedText(),c()},Object.defineProperty(this,"onSubmit",{configurable:!0,get:d(()=>i=>{const o=this.pendingRawSubmitText??i;this.pendingRawSubmitText=void 0,this.realOnSubmit?.(o)},"get"),set:d(i=>{this.realOnSubmit=i},"set")})}onPasteImagePath;settleHeldReturn(e){const t=this.pendingReturn;if(t!==void 0){if(clearTimeout(t.timer),this.pendingReturn=void 0,e==="newline"){this.insertTextAtCursor(`
+`);return}super.handleInput(t.data),this.tui.requestRender()}}imageTokenWidthBeforeCursor(){const{line:e,col:t}=this.getCursor(),n=this.getLines()[e];if(n===void 0)return 0;const r=n.slice(0,t).match(/\[Image #\d+\]$/);return r?r[0].length:0}imageTokenWidthAfterCursor(){const{line:e,col:t}=this.getCursor(),n=this.getLines()[e];if(n===void 0)return 0;const r=n.slice(t).match(/^\[Image #\d+\]/);return r?r[0].length:0}handleInput(e){if(this.settleHeldReturn("newline"),!this.isShowingAutocomplete()&&this.km.matches(e,"tui.editor.cursorDown")){const i=this,o=this.getCursor(),l=i.historyIndex;super.handleInput(e);const u=this.getCursor();i.historyIndex===l&&u.line===o.line&&u.col===o.col&&this.onCursorDownAtBottom?.();return}if(!this.isShowingAutocomplete()&&this.km.matches(e,"tui.input.newLine")){this.insertTextAtCursor(`
+`);return}if(!this.isShowingAutocomplete()&&this.km.matches(e,"tui.editor.deleteCharBackward")){const i=this.imageTokenWidthBeforeCursor();if(i>1){for(let o=0;o<i;o++)super.handleInput(e);return}}if(!this.isShowingAutocomplete()&&this.km.matches(e,"tui.editor.cursorLeft")){const i=this.imageTokenWidthBeforeCursor();if(i>1){for(let o=0;o<i;o++)super.handleInput(e);return}}if(!this.isShowingAutocomplete()&&this.km.matches(e,"tui.editor.cursorRight")){const i=this.imageTokenWidthAfterCursor();if(i>1){for(let o=0;o<i;o++)super.handleInput(e);return}}const t=J(e);if(t&&this.onPasteImagePath?.(t))return;if((e==="\r"||e===`
+`)&&!this.isShowingAutocomplete()){this.pendingReturn={data:e,timer:setTimeout(()=>this.settleHeldReturn("submit"),W.PASTE_BURST_MS)};return}const{line:n,col:r}=this.getCursor(),c=this.getLines()[n]??"";super.handleInput(e),this.maybeTriggerNonLeadingRefAutocomplete(n,r,c)}maybeTriggerNonLeadingRefAutocomplete(e,t,n){if(this.isShowingAutocomplete())return;const r=this.getCursor();if(r.line!==e||r.col!==t+1)return;const c=this.getLines()[r.line]??"";if(c.length!==n.length+1)return;const i=c[t];if(i===void 0||i!=="/"&&!/[A-Za-z0-9_:-]/.test(i))return;const o=G(this.getLines(),r.line,r.col);!o||o.kind!=="ref"||this.tryTriggerAutocomplete()}onCursorDownAtBottom;loadedCommand;title="";info="";contextBadge="";titleStyle=k;contextBadgeStyle=k;paneFocused=!0;resolvedRefNames=new Set;localCommandNames=new Set;engineCommandNames=new Set;setResolvedRefNames(e){this.resolvedRefNames=new Set(e)}getResolvedRefNames(){return this.resolvedRefNames}setLocalCommandNames(e){this.localCommandNames=new Set(e)}setEngineCommandNames(e){this.engineCommandNames=new Set(e)}decorateResolvedRefs(e,t){if(this.resolvedRefNames.size===0)return;const n=this.getText(),r=ce(n);if(r!==null&&this.localCommandNames.has(r)||ae(n,this.engineCommandNames))return;const c=Math.max(0,Math.floor((t-1)/2)),i=Math.min(this.getPaddingX(),c),o=Math.max(1,t-i*2),l=Math.max(1,o-(i?0:1)),u=this.getLines(),a=this.getCursor(),h=Q(u,l,a.line,a.col),m=this.scrollOffset,f=Math.max(5,Math.floor(this.tui.terminal.rows*.3)),g=Math.min(Math.max(0,h.length-m),f);if(g<=0||e.length<1+g)return;const x=new Map;for(let I=0;I<g;I++){const p=h[m+I];if(!p)continue;let T=x.get(p.logicalLine);T===void 0&&(T=ee(u[p.logicalLine]??"",this.resolvedRefNames),x.set(p.logicalLine,T));const $=T.filter(y=>y.start>=p.startIndex&&y.end<=p.endIndex);if($.length===0)continue;const O=e[1+I];O!==void 0&&(e[1+I]=oe(O,p,$,u[p.logicalLine]??"",i))}}render(e){const t=super.render(e);if(!this.paneFocused)for(let n=0;n<t.length;n++){const r=q(t[n]);if(r!==void 0){t[n]=r;break}}if(this.decorateResolvedRefs(t,e),this.loadedCommand!==void 0&&t.length>=2&&e>=8){const n=e-4,r=j(this.loadedCommand.content,n);if(r.length===0)return t;const c=` ${this.loadedCommand.inspectHint} \xB7 /${this.loadedCommand.name} loaded `,i=r.map(a=>{const h=C(a,n);return`${this.borderColor("\u2502")} ${h}${" ".repeat(Math.max(0,n-b(h)))} ${this.borderColor("\u2502")}`}),o=C(c,e-2),l=Math.max(0,e-2-b(o)),u=this.borderColor(`\u251C${o}${"\u2500".repeat(l)}\u2524`);t.splice(1,0,u,...i,this.borderColor(`\u251C${"\u2500".repeat(e-2)}\u2524`))}if((this.title||this.info)&&t.length>0&&(t[0]=Y(e,this.title,this.info,this.titleStyle,n=>this.borderColor(n))),this.contextBadge&&t.length>0){const n=this.contextBadgeStyle(this.contextBadge),r=b(n);if(r+2<e){const c=t.length-1;t[c]=C(t[c],e-r,"")+n}}return t}}export{W as TitledEditor,Q as buildRefLayoutChunks,xe as colorChipStyle,j as compactLoadedCommandPreview,Y as composeTopBorder,oe as decorateRow,k as defaultTitleStyle,J as detectDroppedImagePath,q as outlineCursorLine,pe as thinkingBorderColor,be as thinkingTitleStyle};

package/dist/clients/attach/overlays/auth.d.ts

@@ -0,0 +1,13 @@
+import type { TUI } from '@earendil-works/pi-tui';
+import type { Picker, PickerControls } from './pickers.js';
+/** `/login` — show the provider selector, then run pi's native login flow in
+ *  the viewer. On success, notifies the broker to reload auth via reload_auth.
+ *
+ *  Two-stage: composing the ModelRuntime and reading each provider's auth status
+ *  is async (pi 0.82), while the picker itself must be built synchronously from
+ *  the controls the overlay host hands out. So this resolves the runtime first and
+ *  returns the sync picker factory. */
+export declare function buildLoginPicker(tui: TUI, agentDir: string, onAuthReloaded: () => void, notify: (msg: string) => void): Promise<(controls: PickerControls) => Picker>;
+/** `/logout` — show the provider selector in logout mode. On select, deletes the
+ *  provider's credential directly, then notifies the broker to reload. */
+export declare function buildLogoutPicker(agentDir: string, onAuthReloaded: () => void, notify: (msg: string) => void): Promise<(controls: PickerControls) => Picker>;

package/dist/clients/attach/overlays/auth.js

@@ -0,0 +1,2 @@
+var v=Object.defineProperty;var t=(i,n)=>v(i,"name",{value:n,configurable:!0});import{join as C}from"node:path";import{execFile as E}from"node:child_process";import{CredentialSynchronizationError as D,ModelRuntime as N,OAuthSelectorComponent as x,LoginDialogComponent as _}from"@earendil-works/pi-coding-agent";import{deleteAuthCredential as B,setAuthCredential as T}from"../../../core/auth-file.js";import{PoolCredentialStore as z}from"../../../core/pool-credential-store.js";import{secretsDir as F}from"../../../core/layout.js";import{dialogAuthInteraction as O}from"../../../core/auth-interaction.js";import{isManagedProvider as S,removeManagedProvider as U}from"../../../core/subscription-state.js";import{daemonManagedLogin as q}from"../../../core/model-auth/daemon-login.js";import{cliClient as G}from"../../../commands/api-client.js";async function A(i){const n=C(F(),"auth.json"),r=C(i,"models.json"),e=new z(n);let l;const w={read:t(a=>e.read(a),"read"),list:t(()=>e.list(),"list"),modify:t((a,m)=>{const u=l;return l=void 0,u!==void 0&&!u()?Promise.reject(new Error("Login cancelled")):e.modify(a,m)},"modify"),delete:t(a=>e.delete(a),"delete")};return{runtime:await N.create({credentials:w,modelsPath:r}),authPath:n,beforeNextCredentialMutation:t(a=>{l=a},"beforeNextCredentialMutation")}}t(A,"buildLocalAuth");async function M(i){const n=i.getProviders(),r=[...n.filter(e=>e.auth.oauth!==void 0),...n.filter(e=>e.auth.oauth===void 0)];return Promise.all(r.map(async e=>({id:e.id,name:e.name,authType:e.auth.oauth!==void 0?"oauth":"api_key",status:await i.checkAuth(e.id)})))}t(M,"buildProviderList");function H(i){const n=process.platform==="darwin"?"open":process.platform==="win32"?"start":"xdg-open";E(n,[i],{timeout:5e3},()=>{})}t(H,"openBrowser");async function te(i,n,r,e){const{runtime:l,authPath:w,beforeNextCredentialMutation:h}=await A(n),a=await M(l);return({close:m,replace:u})=>{const P=t(f=>{const s=a.find(o=>o.id===f);if(s===void 0){e(`Unknown provider: ${f}`),m();return}let g=!1,$=!1;const p=t(()=>{g||(g=!0,m())},"finish"),c=new _(i,f,(o,L)=>{g||(o?(e(`Logged in to ${s.name}`),r()):e(L?`Login failed: ${L}`:`Login to ${s.name} was cancelled`),p())},s.name);u(c,c);const j=c.handleInput.bind(c);c.handleInput=o=>{$||j(o)};const b=t(()=>g||c.signal.aborted?!1:($=!0,c.showDetails(["Saving credentials\u2026"]),!0),"beginCommit"),y=O(c,{openBrowser:H,isActive:t(()=>!g&&!c.signal.aborted,"isActive")}),k=t(o=>{if(o instanceof D){e(`Logged in to ${s.name}; provider refresh failed: ${o.message}`),r(),p();return}const L=o;L?.name!=="AbortError"&&L?.message!=="Login cancelled"&&e(`Login error: ${String(L?.message??o)}`),p()},"fail");if(S(f)){q(G(),f,y).then(()=>{g||(e(`Logged in to ${s.name}`),r(),p())}).catch(k);return}if(s.authType==="oauth"){if(l.getProvider(f)?.auth.oauth===void 0){c.showInfo([`Provider "${s.name}" is extension-registered and cannot be logged in`,"from the viewer (the extension runs in the broker, not here).","Run /login directly in the node's terminal, or log in via the pi CLI."].join(`
+`));return}h(b),l.login(f,"oauth",y).then(()=>{g||(e(`Logged in to ${s.name}`),r(),p())}).catch(k).finally(()=>h(void 0))}else c.showPrompt(`Enter API key for ${s.name}:`,"sk-...").then(async o=>{if(!g){if(o.trim()){if(!b())return;await T(f,{type:"api_key",key:o.trim()},w),e(`API key saved for ${s.name}`),r()}else e("No key entered \u2014 login cancelled");p()}}).catch(()=>p())},"onSelect"),d=new x("login",a,P,()=>m());return{component:d,focus:d}}}t(te,"buildLoginPicker");async function ne(i,n,r){const{runtime:e,authPath:l}=await A(i),w=await M(e);return({close:h})=>{const a=t(u=>{const P=w.find(d=>d.id===u);(async()=>{try{S(u)?await U(u):await B(u,l),h(),r(`Logged out of ${P?.name??u}`),n()}catch(d){h(),r(`Logout error: ${d instanceof Error?d.message:String(d)}`)}})()},"onSelect"),m=new x("logout",w,a,()=>h());return{component:m,focus:m}}}t(ne,"buildLogoutPicker");export{te as buildLoginPicker,ne as buildLogoutPicker};

package/dist/clients/attach/overlays/dialogs.d.ts

@@ -0,0 +1,27 @@
+import { KeybindingsManager, type TUI } from '@earendil-works/pi-tui';
+import type { RpcExtensionUIRequest, RpcExtensionUIResponse } from '../../../core/runtime/broker-protocol.js';
+/** Handle for a rendered dialog: tear it down (without responding) when the
+ *  request is superseded, answered, or dismissed by the broker. */
+export interface DialogHandle {
+    dismiss(): void;
+}
+/** The 4 user-blocking dialog methods. Other RpcExtensionUIRequest methods are
+ *  non-blocking display ops; callers handle them before rendering a dialog. */
+export declare function isBlockingDialog(req: RpcExtensionUIRequest): boolean;
+/**
+ * Render a blocking extension dialog as a focused overlay over `tui`, and resolve
+ * by invoking `onRespond` with the matching `extension_ui_response` (or a
+ * `cancelled` response on user-cancel/timeout). Returns a {@link DialogHandle}
+ * whose `dismiss()` removes the overlay without responding (idempotent; safe to
+ * call after the dialog already resolved).
+ *
+ * @param keybindings - used only by the `editor` dialog, which calls
+ *   `keybindings.matches(key, "app.editor.external")` for the Ctrl+G external-editor
+ *   shortcut. Defaults to a fresh `KeybindingsManager(TUI_KEYBINDINGS)` — that
+ *   knows the base TUI bindings but not pi's app-level `app.editor.external`, so
+ *   Ctrl+G is inert until the input controller passes the app keybindings
+ *   manager. `ExtensionEditorComponent` is typed against pi's CORE
+ *   KeybindingsManager (a subclass of pi-tui's), so we widen via the constructor's
+ *   own parameter type rather than importing the core class (type-only export).
+ */
+export declare function renderDialog(tui: TUI, req: RpcExtensionUIRequest, onRespond: (resp: RpcExtensionUIResponse) => void, keybindings?: KeybindingsManager): DialogHandle;

package/dist/clients/attach/overlays/dialogs.js

@@ -0,0 +1,2 @@
+var h=Object.defineProperty;var o=(t,e)=>h(t,"name",{value:e,configurable:!0});import{KeybindingsManager as f,TUI_KEYBINDINGS as _}from"@earendil-works/pi-tui";import{ExtensionEditorComponent as x,ExtensionInputComponent as w,ExtensionSelectorComponent as a}from"@earendil-works/pi-coding-agent";function y(t){return t.method==="select"||t.method==="confirm"||t.method==="input"||t.method==="editor"}o(y,"isBlockingDialog");const l={dismiss:o(()=>{},"dismiss")},g={anchor:"center",width:"70%",maxHeight:"80%"};function k(t,e,m,u){if(!y(e))return l;let d=!1,r,i;const p=o(()=>{r?.hide();const n=i;try{n?.dispose?.()}catch{}},"teardown"),s=o(n=>{d||(d=!0,p(),m(n))},"respond"),c=o(()=>s({type:"extension_ui_response",id:e.id,cancelled:!0}),"cancel");switch(e.method){case"select":i=new a(e.title,e.options,n=>s({type:"extension_ui_response",id:e.id,value:n}),c,{tui:t,timeout:e.timeout});break;case"confirm":i=new a(`${e.title}
+${e.message}`,["Yes","No"],n=>s({type:"extension_ui_response",id:e.id,confirmed:n==="Yes"}),c,{tui:t,timeout:e.timeout});break;case"input":i=new w(e.title,e.placeholder,n=>s({type:"extension_ui_response",id:e.id,value:n}),c,{tui:t,timeout:e.timeout});break;case"editor":i=new x(t,u??new f(_),e.title,e.prefill,n=>s({type:"extension_ui_response",id:e.id,value:n}),c);break;default:return l}return r=t.showOverlay(i,g),{dismiss:o(()=>{d||(d=!0,p())},"dismiss")}}o(k,"renderDialog");export{y as isBlockingDialog,k as renderDialog};

package/dist/clients/attach/overlays/file-review.d.ts

@@ -0,0 +1,10 @@
+import type { SurfaceHost } from '../../surfaces/host.js';
+import type { Picker } from './pickers.js';
+import { extractFilePaths } from '#core/human/visible-paths';
+export declare function buildFileReviewPicker(candidates: readonly string[], cwd: string, onChoose: (file: string) => void, close: () => void, notify: (message: string) => void): Picker;
+/** Open an inline review of a file path, or of a document given as `[[ref]]`. */
+export declare function launchFileReview(host: SurfaceHost, file: string, opts: {
+    originNodeId: string;
+    onNotice: (message: string) => void;
+}): Promise<void>;
+export { extractFilePaths };

package/dist/clients/attach/overlays/file-review.js

@@ -0,0 +1,2 @@
+var v=Object.defineProperty;var c=(n,e)=>v(n,"name",{value:e,configurable:!0});import{homedir as a}from"node:os";import{isAbsolute as g,join as b,relative as S,resolve as y}from"node:path";import{Input as I,SelectList as d,getKeybindings as R}from"@earendil-works/pi-tui";import{getSelectListTheme as u}from"@earendil-works/pi-coding-agent";import{openReviewWindow as C}from"../../inbox/review/launch.js";import{createReviewClient as L,ReviewTerminalError as k,terminalRefusalNotice as x}from"../../inbox/review/review-client.js";import{checkReviewableFile as N,extractFilePaths as P}from"#core/human/visible-paths";import{docLinkText as F}from"../render/doc-links.js";const l=12;function h(n){const e=/^\[\[([^[\]\n]+)\]\]$/.exec(n.trim());return e===null?void 0:e[1].trim()}c(h,"documentRef");function m(n,e){const t=h(n);if(t!==void 0)return`${F(t)}  (document)`;const i=S(e,n);if(i!==""&&!i.startsWith("..")&&!g(i))return i;const s=a();return n===s||n.startsWith(`${s}/`)?`~${n.slice(s.length)}`:n}c(m,"labelForPath");function f(n,e){const t=n==="~"?a():n.startsWith("~/")?b(a(),n.slice(2)):n;return y(e,t)}c(f,"resolveTypedPath");class W{static{c(this,"FileReviewPicker")}candidates;cwd;onChoose;close;notify;focused=!1;input=new I;list=new d([],l,u());constructor(e,t,i,s,o){this.candidates=e,this.cwd=t,this.onChoose=i,this.close=s,this.notify=o,this.input.onEscape=s,this.input.onSubmit=()=>this.chooseSelected(),this.refreshList()}render(e){this.input.focused=this.focused;const t=Math.max(1,e-8);return["Review a file or document named in this transcript",...this.input.render(t).map(i=>`Path: ${i}`),...this.list.render(e)]}handleInput(e){const t=R();if(t.matches(e,"tui.select.up")||t.matches(e,"tui.select.down")){this.list.handleInput(e);return}if(t.matches(e,"tui.select.confirm")||e===`
+`){this.chooseSelected();return}const i=this.input.getValue();this.input.handleInput(e),this.input.getValue()!==i&&this.refreshList()}invalidate(){this.input.invalidate(),this.list.invalidate()}refreshList(){const e=this.input.getValue(),t=e.toLowerCase(),i=this.candidates.filter(r=>{const w=m(r,this.cwd).toLowerCase();return t===""||w.includes(t)||r.toLowerCase().includes(t)}),s=e===""?void 0:h(e)!==void 0?e.trim():f(e,this.cwd),o=s!==void 0&&this.candidates.some(r=>r===s),p=[...i.map(r=>({value:r,label:m(r,this.cwd)})),...s!==void 0&&!o?[{value:s,label:`use ${JSON.stringify(e)}`,description:s}]:[]];this.list=new d(p,l,u()),this.list.onSelect=()=>this.chooseSelected(),this.list.onCancel=this.close}chooseSelected(){const e=this.input.getValue(),i=this.list.getSelectedItem()?.value??e;if(i==="")return;if(h(i)!==void 0){this.onChoose(i),this.close();return}const s=f(i,this.cwd),o=N(s);if(!o.ok){this.notify(o.reason);return}this.onChoose(s),this.close()}}function q(n,e,t,i,s){const o=new W(n,e,t,i,s);return{component:o,focus:o}}c(q,"buildFileReviewPicker");async function B(n,e,t){if(n.capabilities.remote){t.onNotice("The review is unavailable in a remote attach \u2014 the file and companion live on the host.");return}const i=h(e);let s;try{s=await L().createInline(i===void 0?{originNodeId:t.originNodeId,file:e}:{originNodeId:t.originNodeId,document:i})}catch(o){t.onNotice(o instanceof k?x(o):o instanceof Error?o.message:String(o));return}C(n,s)}c(B,"launchFileReview");export{q as buildFileReviewPicker,P as extractFilePaths,B as launchFileReview};

package/dist/clients/attach/overlays/graph.d.ts

@@ -0,0 +1,83 @@
+import { type Component, type TUI } from '@earendil-works/pi-tui';
+import { type BindingResolution, type BindingId } from '../../../core/keybindings/index.js';
+import type { CanvasSource } from '../../../core/canvas/source.js';
+import type { ClientRole } from '../../../core/runtime/broker-protocol.js';
+import type { AttachPalette } from '../config.js';
+export declare class GraphOverlay implements Component {
+    private readonly tui;
+    private readonly self;
+    private readonly getAsks;
+    private readonly palette;
+    private bindings;
+    private readonly source;
+    private readonly role;
+    private readonly onRefreshFailure;
+    private readonly onNotice;
+    private handle;
+    /** Manual fold OVERRIDES (h collapses → userCollapsed, l expands → userExpanded);
+     *  both override the default activity-driven policy and survive open/close. */
+    private readonly userExpanded;
+    private readonly userCollapsed;
+    private readonly folds;
+    /** Cursor as a node id (indices shift as topology changes). */
+    private cursorId;
+    /** Viewport scroll offset (row index of the top visible tree row). */
+    private scrollTop;
+    /** Transient close confirmation gate. */
+    private pendingConfirm;
+    private snapshot;
+    private snapshotSeq;
+    /** True when `source` is a `RemoteCanvasSource` — gates every local disk/
+     *  SQLite adornment (tokens, activity, fault, attach, focus) to a safe
+     *  default and makes Enter/r/m/x no-op instead of shelling local lifecycle
+     *  commands against a remote graph row. See the file header. */
+    private readonly remote;
+    constructor(tui: TUI, self: string, getAsks: () => Record<string, number>, palette: AttachPalette, bindings: BindingResolution<BindingId>, source: CanvasSource, role?: ClientRole, onRefreshFailure?: (cause?: unknown) => void, onNotice?: (message: string) => void);
+    setBindings(bindings: BindingResolution<BindingId>): void;
+    private matches;
+    private hint;
+    /** Compose footer hints in priority order, dropping WHOLE entries that would
+     *  overflow `budget` visible columns rather than letting the border mid-clip
+     *  the tail — so the prioritized head (dismiss + remapped local actions) stays
+     *  discoverable even in a narrow overlay. */
+    private fitHints;
+    isOpen(): boolean;
+    open(): void;
+    close(): void;
+    toggle(): void;
+    /** Repaint if shown (the low-rate ask poll calls this). */
+    refresh(): void;
+    invalidate(): void;
+    /** Local: ONE `/v1/canvas/graph` read supplies the display rows, both edge
+     *  directions, and the focus set — no enriched node list, no roster call, no
+     *  separate focus query. Remote: unchanged — a remote canvas exposes only the
+     *  per-node `CanvasSource` reads, and its focus set stays empty (a remote node
+     *  id may collide with a local focus row). */
+    private fetchInput;
+    private buildSnapshot;
+    /** Fold state is presentation-only. Reproject the visible DFS from the fully
+     * fetched topology so h/l never cross the daemon boundary. The explicit stack
+     * also keeps a deep graph from consuming the JavaScript call stack. */
+    private projectRows;
+    private repaintFolds;
+    private renderSnapshotRow;
+    render(width: number): string[];
+    /** A top/bottom border row: `<lc>─ <label> ────<rc>`, frame in the theme border
+     *  color, the label keeping its own styling. The label is visible-truncated to
+     *  the available span so a long label (a narrow pane, or a long `kill <name>?`
+     *  confirm) never spills past the corner. */
+    private borderRow;
+    handleInput(data: string): void;
+    private dispatch;
+    /** Focus node `id` from the overlay, in-process: the same decision
+     *  `crtr surface node focus <id> --pane <here>` makes (core/runtime/focus-viewer.ts),
+     *  without paying a cold `crtr` boot before the target's viewer pane even
+     *  spawns. THIS pane is the ANCHOR: if `id` has no viewer yet a fresh one
+     *  splits beside it; if it already has one, that viewer is navigated in place
+     *  (this pane is left as-is). Finished work opens its saved-transcript popup. */
+    private focusTarget;
+    /** Revive is deliberate and separate from Enter's inspect-or-focus behavior.
+     * After the broker reports ready, focus opens its live attach viewer. */
+    private reviveTarget;
+    private shellCrtr;
+}

package/dist/clients/attach/overlays/graph.js

@@ -0,0 +1 @@
+var q=Object.defineProperty;var m=(u,t)=>q(u,"name",{value:t,configurable:!0});import{execFile as P}from"node:child_process";import{matchesKey as H,truncateToWidth as T}from"@earendil-works/pi-tui";import{formatBinding as L,matchesPiTuiInput as B}from"../../../core/keybindings/index.js";import{fullName as G}from"../../../core/canvas/labels.js";import{faultSummary as F,resolveNodeVisual as C}from"../../../core/canvas/status-glyph.js";import{RemoteCanvasSource as W}from"../../../core/canvas/remote-canvas-source.js";import{cliClient as M}from"../../../commands/api-client.js";import{focusNode as K}from"../../../core/runtime/focus-viewer.js";import{daemonErrorMessage as j}from"../../inbox/resolve.js";import{statusRank as E}from"../../../core/canvas/node-order.js";import{navLabel as D,nodeGlyph as V,tokensCell as Y,cycleBadge as z,askBadge as U,activityCell as X,shortId as N,visibleWidth as k,fillBar as A,fillWidth as O,truncate as J,isAttached as Q,VIEWPORT_FALLBACK_ROWS as Z,ESC as ee,DIM as R,RESET as g,BOLD as S,YELLOW as te,REVERSE as se,BG_ATTACHED as ie,GREEN as ne}from"../../../core/canvas/nav-render.js";const re=.72,oe={anchor:"center",width:"72%",minWidth:48,maxHeight:"72%",margin:1},ce=[["crtr.graph.dismiss","dismiss"],["crtr.graph.focus","focus"],["crtr.graph.revive","revive"],["crtr.graph.close-subtree","close"],["crtr.graph.focus-manager","manager"]],ae=[["crtr.graph.dismiss","dismiss"]],he=[["crtr.graph.down","down"],["crtr.graph.up","up"],["crtr.graph.first","first"],["crtr.graph.last","last"],["crtr.graph.collapse-or-manager","fold/manager"],["crtr.graph.expand-or-child","expand/child"]],de=[...["active","idle","done","dead","canceled"].map(u=>[C(u,{}),u]),[C("active",{streaming:!0}),"live"],[C("active",{frozen:!0}),"frozen"],[C("active",{hanging:{kind:"wedged"}}),"fault"]].map(([u,t])=>`${ee}${u.color}m${u.glyph}${g} ${R}${t}${g}`).join("  ");function le(u){return{node_id:u.node_id,name:u.name,kind:u.kind,description:u.description??void 0,cycles:u.cycles??void 0,status:u.status,frozen_at:u.frozen_at,pi_pid:u.pi_pid,telemetry_context_tokens:u.telemetry_context_tokens,telemetry_last_activity:u.telemetry_last_activity,fault:u.fault??null,streaming:u.streaming}}m(le,"graphRow");class Ie{static{m(this,"GraphOverlay")}tui;self;getAsks;palette;bindings;source;role;onRefreshFailure;onNotice;handle;userExpanded=new Set;userCollapsed=new Set;folds={userExpanded:this.userExpanded,userCollapsed:this.userCollapsed};cursorId;scrollTop=0;pendingConfirm;snapshot;snapshotSeq=0;remote;constructor(t,s,i,e,n,o,f="controller",p=()=>{},r=()=>{}){this.tui=t,this.self=s,this.getAsks=i,this.palette=e,this.bindings=n,this.source=o,this.role=f,this.onRefreshFailure=p,this.onNotice=r,this.remote=o instanceof W}setBindings(t){this.bindings=t,this.handle!==void 0&&this.tui.requestRender()}matches(t,s){return B(this.bindings,t,s,(i,e)=>H(i,e))}hint(t){return t.flatMap(([s,i])=>this.bindings.gestures(s).length===0?[]:[`${L(this.bindings,s)} ${i}`])}fitHints(t,s){const e=[];let n=0;for(const o of this.hint(t)){const f=(e.length===0?0:3)+k(o);if(n+f>s)break;e.push(o),n+=f}return e.join(" \xB7 ")}isOpen(){return this.handle!==void 0}open(){this.handle===void 0&&(this.scrollTop=0,this.pendingConfirm=void 0,this.cursorId=this.self,this.handle=this.tui.showOverlay(this,oe),this.refresh())}close(){this.handle!==void 0&&(this.pendingConfirm=void 0,this.handle.hide(),this.handle=void 0,this.tui.requestRender())}toggle(){this.handle===void 0?this.open():this.close()}refresh(){if(this.handle===void 0)return;const t=++this.snapshotSeq;this.buildSnapshot().then(s=>{t===this.snapshotSeq&&(this.snapshot=s,this.tui.requestRender())}).catch(s=>{this.onRefreshFailure(s),this.tui.requestRender()})}invalidate(){this.refresh()}async fetchInput(){if(this.remote){const e=await this.source.listNodes().catch(()=>[]);return{nodes:new Map(e.map(n=>[n.node_id,n])),subscriptions:m(async n=>(await this.source.subscriptionsOf(n)).map(o=>o.node_id),"subscriptions"),subscribers:m(async n=>(await this.source.subscribersOf(n)).map(o=>o.node_id),"subscribers"),focused:new Set}}const t=await M().canvasGraph(),s=new Map,i=new Map;for(const e of t.edges){const n=s.get(e.from_id);n===void 0?s.set(e.from_id,[e.to_id]):n.push(e.to_id);const o=i.get(e.to_id);o===void 0?i.set(e.to_id,[e.from_id]):o.push(e.from_id)}return{nodes:new Map(t.nodes.map(e=>[e.node_id,le(e)])),subscriptions:m(e=>Promise.resolve(s.get(e)??[]),"subscriptions"),subscribers:m(e=>Promise.resolve(i.get(e)??[]),"subscribers"),focused:new Set(t.focused_node_ids)}}async buildSnapshot(){const t=await this.fetchInput(),{nodes:s,focused:i}=t,e=new Map,n=new Map,o=new Map,f=new Map,p=m(async c=>{const l=e.get(c);if(l!==void 0)return l;let a;try{a=await t.subscriptions(c)}catch{a=[]}const $=a.filter(b=>s.get(b)?.kind!=="human");return e.set(c,$),$},"children"),r=m(async c=>{if(o.has(c))return o.get(c);let l;try{l=(await t.subscribers(c))[0]}catch{l=void 0}return o.set(c,l),l},"manager"),h=m(async()=>{let c=this.self;const l=new Set([c]);for(;;){const a=await r(c);if(a===void 0||l.has(a))break;l.add(a),c=a}return c},"climbRoot"),d=m(async c=>{const l=n.get(c);if(l!==void 0)return l;const a=[...await p(c)];return a.sort(($,b)=>E(s.get($)?.status)-E(s.get(b)?.status)),n.set(c,a),a},"sortedChildren"),w=new Set,v=new Set,I=m(async c=>{const l=s.get(c)?.status==="active";if(v.has(c))return{active:l?1:0,reveal:l||c===this.self};v.add(c);let a=0,$=!1;for(const b of await p(c)){const x=await I(b);a+=x.active,x.reveal&&($=!0)}return f.set(c,a),$&&w.add(c),{active:a+(l?1:0),reveal:$||l||c===this.self}},"visitActivity"),y=await h();await I(y),await Promise.all([...e.keys()].map(c=>d(c)));const _={root:y,rows:[],autoExpanded:w,activeBelow:f,nodes:s,childIds:e,sortedChildIds:n,managerOf:o,focused:i};return _.rows=this.projectRows(_),_}projectRows(t){const s=[],i=new Set,e=[{id:t.root,prefix:"",isRoot:!0,isLast:!0}];for(;e.length>0;){const{id:n,prefix:o,isRoot:f,isLast:p}=e.pop(),r=f?"":p?"\u2514\u2500 ":"\u251C\u2500 ";if(i.has(n)){s.push({id:n,hasKids:!1,isSelf:n===this.self,branch:o+r,cycle:!0,collapsed:!1});continue}i.add(n);const h=t.sortedChildIds.get(n)??[],d=this.folds.userExpanded.has(n)?!1:this.folds.userCollapsed.has(n)?!0:!t.autoExpanded.has(n);if(s.push({id:n,hasKids:h.length>0,isSelf:n===this.self,branch:o+r,cycle:!1,collapsed:d}),d)continue;const w=f?"":o+(p?"   ":"\u2502  ");for(let v=h.length-1;v>=0;v--)e.push({id:h[v],prefix:w,isRoot:!1,isLast:v===h.length-1})}return s}repaintFolds(){this.snapshot!==void 0&&(this.snapshot.rows=this.projectRows(this.snapshot)),this.tui.requestRender()}renderSnapshotRow(t,s,i,e){const n=m((b,x)=>i?A(b,O(),se):x?A(b,O(),ie):J(b),"wrap");if(s.cycle){const b=`${s.branch}  ${R}\u21BA ${N(s.id)}${g}`;return n(b,!1)}const o=t.nodes.get(s.id)??null,f=V(o),p=D(o,s.id),r=s.isSelf?`${S}${p}${g}`:p,h=`${R}${o?.kind??""}${g}`,d=`${R}${Y(o,this.remote)}${g}`,w=s.hasKids&&s.collapsed,v=!i&&w?`${R}\u25B8${g} `:"  ",I=z(o),y=t.childIds.get(s.id)?.length??0,_=o!==null&&y>0?` ${R}\u2933${y}${g}`:"",c=o!==null&&o.status!=="active"&&(t.activeBelow.get(o.node_id)??0)>0?` ${ne}\u21E3${t.activeBelow.get(o.node_id)??0}${g}`:"",l=o?.fault??null,a=l!==null?` \xB7 ${F(l)}`:"",$=`${s.branch}${v}${f} ${r} ${h} ${d}${I}${_}${c}${U(s.id,e)}${X(o,this.remote)}${a}`;return n($,Q(s.id,o,t.focused,this.remote))}render(t){const s=this.getAsks(),i=this.snapshot?.rows??[];let e=i.findIndex(a=>a.id===this.cursorId);e<0&&(e=i.findIndex(a=>a.id===this.self),e<0&&(e=0)),this.cursorId=i[e]?.id??this.self;const n=process.stdout.rows??Z,o=Math.max(3,Math.min(Math.floor(n*re),n-2)),f=Math.min(o-2,1+Math.max(1,i.length)),p=f-1,r=p>=3;let h=p;for(let a=0;p>0&&a<4;a++){e<this.scrollTop&&(this.scrollTop=e),e>=this.scrollTop+h&&(this.scrollTop=e-h+1),this.scrollTop=Math.max(0,Math.min(this.scrollTop,Math.max(0,i.length-h)));const $=p-(r&&this.scrollTop>0?1:0)-(r&&this.scrollTop+h<i.length?1:0);if($===h)break;h=Math.max(1,$)}const d=Math.min(i.length,this.scrollTop+h),w=[];r&&this.scrollTop>0&&w.push(`${R}  \u2191 ${this.scrollTop} more${g}`);for(let a=this.scrollTop;a<d;a++){const $=this.snapshot;w.push($!==void 0?this.renderSnapshotRow($,i[a],a===e,s):"")}for(r&&d<i.length&&w.push(`${R}  \u2193 ${i.length-d} more${g}`),w.unshift(de);w.length<f;)w.push("");const v=i.length>0?`${S}\u2317 canvas graph${g} ${R}(${e+1}/${i.length})${g}`:`${S}\u2317 canvas graph${g} ${R}(loading)${g}`,I=this.pendingConfirm!==void 0?`${te}${this.pendingConfirm.label} ${S}${this.hint([["crtr.graph.confirm.accept","accept"],["crtr.graph.confirm.cancel","cancel"]]).join(" \xB7 ")}${g}`:`${R}${this.fitHints([...this.remote||this.role!=="controller"?ae:ce,...he],Math.max(1,t-5))}${g}`,y=this.palette.border,_=Math.max(1,t-4),c=w.map(a=>`${y("\u2502")} ${T(a,_,"",!0)} ${y("\u2502")}`),l=this.palette.surface;return[this.borderRow("\u256D","\u256E",v,t),...c,this.borderRow("\u2570","\u256F",I,t)].map(l)}borderRow(t,s,i,e){const n=this.palette.border,o=Math.max(1,e-5),f=T(i,o,"\u2026"),p=Math.max(0,e-5-k(f));return`${n(`${t}\u2500`)} ${f} ${n("\u2500".repeat(p)+s)}`}handleInput(t){try{this.dispatch(t)}catch{}}dispatch(t){if(this.pendingConfirm!==void 0){if(this.matches("crtr.graph.confirm.accept",t)){const r=this.pendingConfirm.action;this.pendingConfirm=void 0,r()}else this.pendingConfirm=void 0;this.tui.requestRender();return}if(this.matches("crtr.graph.dismiss",t)){this.close();return}const s=this.snapshot,i=s?.rows??[];let e=i.findIndex(r=>r.id===this.cursorId);e<0&&(e=Math.max(0,i.findIndex(r=>r.id===this.self)));const n=i[e],o=m(r=>r!==void 0&&!r.cycle,"isSelectable"),f=m((r,h)=>{for(let d=r+h;d>=0&&d<i.length;d+=h)if(o(i[d]))return d;return r},"step"),p=m(r=>{const h=r===1?0:i.length-1;for(let d=h;d>=0&&d<i.length;d+=r)if(o(i[d]))return d;return e},"edge");if(this.matches("crtr.graph.down",t)){e=f(e,1),this.cursorId=i[e]?.id??this.cursorId,this.tui.requestRender();return}if(this.matches("crtr.graph.up",t)){e=f(e,-1),this.cursorId=i[e]?.id??this.cursorId,this.tui.requestRender();return}if(this.matches("crtr.graph.first",t)){this.cursorId=i[p(1)]?.id??this.cursorId,this.tui.requestRender();return}if(this.matches("crtr.graph.last",t)){this.cursorId=i[p(-1)]?.id??this.cursorId,this.tui.requestRender();return}if(this.matches("crtr.graph.collapse-or-manager",t)){if(n!==void 0&&n.hasKids&&!n.collapsed)this.userCollapsed.add(n.id),this.userExpanded.delete(n.id),this.repaintFolds();else{const r=s?.managerOf.get(this.cursorId??this.self);r!==void 0&&i.some(h=>h.id===r)&&(this.cursorId=r),this.tui.requestRender()}return}if(this.matches("crtr.graph.expand-or-child",t)){if(n!==void 0&&n.collapsed&&n.hasKids)this.userExpanded.add(n.id),this.userCollapsed.delete(n.id),this.repaintFolds();else if(n!==void 0&&n.hasKids){const r=s?.sortedChildIds.get(n.id)?.[0];r!==void 0&&(this.cursorId=r),this.tui.requestRender()}return}if(this.matches("crtr.graph.focus",t)){if(this.remote)return;if(this.role!=="controller"){this.onNotice("Read-only observer attach \u2014 cannot focus nodes");return}this.cursorId!==void 0&&this.focusTarget(this.cursorId),this.close();return}if(this.matches("crtr.graph.revive",t)){if(this.remote)return;if(this.role!=="controller"){this.onNotice("Read-only observer attach \u2014 cannot revive nodes");return}const r=this.cursorId,h=r===void 0?null:s?.nodes.get(r)??null;r!==void 0&&h!==null&&h.status!=="active"&&h.status!=="idle"&&(this.reviveTarget(r),this.close());return}if(this.matches("crtr.graph.focus-manager",t)){if(this.remote)return;if(this.role!=="controller"){this.onNotice("Read-only observer attach \u2014 cannot focus nodes");return}const r=s?.managerOf.get(this.self);r!==void 0&&(this.focusTarget(r),this.close());return}if(this.matches("crtr.graph.close-subtree",t)){if(this.remote)return;if(this.role!=="controller"){this.onNotice("Read-only observer attach \u2014 cannot close nodes");return}const r=this.cursorId??this.self,h=s?.nodes.get(r)??null,d=h!==null?G(h):N(r);this.pendingConfirm={label:`kill ${d}?`,action:m(()=>this.shellCrtr(["node","lifecycle","close","--node",r]),"action")},this.tui.requestRender();return}}focusTarget(t){const s=process.env.TMUX_PANE;if(s===void 0||s===""){this.onNotice("Focusing a node needs a local viewer in tmux");return}(async()=>{const i=M(),e=await i.getNode(t);(await K(i,e,{pane:s})).focused||this.onNotice("Could not open that node\u2019s viewer")})().catch(i=>this.onNotice(j(i)))}reviveTarget(t){this.shellCrtr(["node","lifecycle","revive",t],()=>this.focusTarget(t))}shellCrtr(t,s){try{P("crtr",t,e=>{e==null&&s?.()}).stdin?.end()}catch{}}}export{Ie as GraphOverlay};

package/dist/clients/attach/overlays/help.d.ts

@@ -0,0 +1,33 @@
+import { type Component, type TUI } from '@earendil-works/pi-tui';
+import type { AttachPalette } from '../config.js';
+import type { AttachBindings } from '../session/bindings.js';
+/** A bounded, focused reference for the attach viewer's viewport controls. */
+export declare class HelpOverlay implements Component {
+    private readonly tui;
+    private readonly pal;
+    private handle;
+    private bindings;
+    private scrollTop;
+    private lastContentRows;
+    constructor(tui: TUI, pal: AttachPalette);
+    /** Re-resolve key spellings after `/reload` (mirrors GraphOverlay.setBindings). */
+    setBindings(bindings: AttachBindings): void;
+    toggle(): void;
+    close(): void;
+    isOpen(): boolean;
+    invalidate(): void;
+    render(width: number): string[];
+    handleInput(data: string): boolean;
+    private open;
+    private matchesBinding;
+    private scrollBy;
+    private pageSize;
+    private body;
+    private lines;
+    private binding;
+    private wrap;
+    private style;
+    private boxRow;
+    private borderRow;
+    private renderNarrow;
+}

package/dist/clients/attach/overlays/help.js

@@ -0,0 +1 @@
+var w=Object.defineProperty;var d=(g,t)=>w(g,"name",{value:t,configurable:!0});import{matchesKey as h,truncateToWidth as c,visibleWidth as m}from"@earendil-works/pi-tui";import{ATTACH_CONTROL_BINDINGS as x,BINDING_CATALOG as T,formatBinding as $,matchesPiTuiInput as M}from"../../../core/keybindings/index.js";const R=.72,v={anchor:"center",width:"72%",minWidth:48,maxHeight:"72%",margin:1};class C{static{d(this,"HelpOverlay")}tui;pal;handle;bindings;scrollTop=0;lastContentRows=1;constructor(t,e){this.tui=t,this.pal=e}setBindings(t){this.bindings=t,this.handle!==void 0&&this.tui.requestRender()}toggle(){this.handle===void 0?this.open():this.close()}close(){this.handle!==void 0&&(this.handle.hide(),this.handle=void 0,this.tui.requestRender())}isOpen(){return this.handle!==void 0}invalidate(){this.handle!==void 0&&this.tui.requestRender()}render(t){const e=Math.max(1,t);if(e<5)return this.renderNarrow(e);const i=e-4,s=this.body(i),o=Math.max(1,this.tui.terminal.rows),n=Math.max(3,Math.min(Math.floor(o*R),Math.max(3,o-2))),r=Math.max(1,n-2),l=s.length>r,u=l&&r>=3?r-2:1;this.lastContentRows=u,this.scrollTop=Math.max(0,Math.min(this.scrollTop,Math.max(0,s.length-u)));const p=Math.min(s.length,this.scrollTop+u),a=[];for(l&&r>=3&&a.push(this.scrollTop>0?this.pal.muted(`\u2191 ${this.scrollTop} more`):""),a.push(...s.slice(this.scrollTop,p)),l&&r>=3?a.push(p<s.length?this.pal.muted(`\u2193 ${s.length-p} more`):""):l&&r===2&&a.push(p<s.length?this.pal.muted(`\u2193 ${s.length-p} more`):"");a.length<r;)a.push("");const y=this.pal.bold(this.pal.accent("\u2328 attach help")),b=this.pal.muted("esc dismiss \xB7 \u2191\u2193 scroll");return[this.borderRow("\u256D","\u256E",y,e),...a.map(f=>this.boxRow(f,e)),this.borderRow("\u2570","\u256F",b,e)].map(this.pal.surface)}handleInput(t){return h(t,"escape")||h(t,"q")?(this.close(),!0):h(t,"up")||this.matchesBinding("crtr.attach.scroll.up",t)?this.scrollBy(-1):h(t,"down")||this.matchesBinding("crtr.attach.scroll.down",t)?this.scrollBy(1):h(t,"pageUp")||this.matchesBinding("crtr.attach.scroll.page-up",t)?this.scrollBy(-this.pageSize()):h(t,"pageDown")||this.matchesBinding("crtr.attach.scroll.page-down",t)?this.scrollBy(this.pageSize()):!0}open(){this.scrollTop=0,this.handle=this.tui.showOverlay(this,v)}matchesBinding(t,e){return this.bindings!==void 0&&M(this.bindings,t,e,(i,s)=>h(i,s))}scrollBy(t){const e=this.body(Math.max(1,this.tui.terminal.columns-4)).length,i=Math.max(0,e-this.lastContentRows),s=Math.max(0,Math.min(i,this.scrollTop+t));return s!==this.scrollTop&&(this.scrollTop=s,this.tui.requestRender()),!0}pageSize(){return Math.max(1,this.lastContentRows-1)}body(t){return this.lines().flatMap(e=>this.wrap(e.text,t).map(i=>this.style(i,e.style)))}lines(){const t=d((n,r)=>({text:`${this.binding(n)}  ${r}`,style:"plain"}),"binding"),e=d(n=>({text:n,style:"heading"}),"heading"),i=d(n=>({text:n,style:"muted"}),"muted"),s={text:"",style:"plain"},o=x.map(({actionId:n})=>{const r=T.find(l=>l.id===n)?.name??n;return t(n,r)});return[e("Learning crouter"),{text:"/tutorial  the guided crouter tutorial \u2014 your agent teaches it, one lesson at a time",style:"plain"},s,e("Scrolling"),t("crtr.attach.scroll.up","scroll one line up"),t("crtr.attach.scroll.down","scroll one line down"),t("crtr.attach.scroll.page-up","scroll one page up"),t("crtr.attach.scroll.page-down","scroll one page down"),t("crtr.attach.scroll.live","return to the live bottom"),i("mouse wheel (when reporting is on)"),s,e("Searching the transcript"),{text:`${this.binding("crtr.attach.search")}  search what the transcript is currently showing. Type to jump as you go, enter to browse the matches.`,style:"plain"},{text:`${this.binding("crtr.attach.search.next")} / ${this.binding("crtr.attach.search.previous")}  next and previous match \xB7 ${this.binding("crtr.attach.search.edit")}  edit the query \xB7 ${this.binding("crtr.attach.search.close")}  close. Typing anything else closes search and returns to the editor.`,style:"plain"},{text:"A lowercase query ignores case; any uppercase letter makes it case-sensitive.",style:"plain"},{text:"Folded tool output is not on screen, so it is not searched \u2014 unfold it to include it.",style:"muted"},s,e("Selection and copy"),{text:"Drag with the mouse to select; releasing copies the selection to the clipboard (and the tmux buffer). Any key clears the highlight.",style:"plain"},{text:"prefix + [  tmux copy-mode selects and copies the visible screenful; it works even while mouse reporting is on.",style:"plain"},{text:"Option-drag (iTerm2, Terminal.app) or Shift-drag (Ghostty, Alacritty, xterm) makes a true terminal selection that bypasses mouse reporting.",style:"plain"},{text:"Block-copy commands copy transcript content and are not capped at one screenful.",style:"plain"},s,e("Copy commands"),{text:"/copy  last assistant message.",style:"plain"},{text:`/copy-message (${this.binding("crtr.attach.copy.message")})  newest copyable block entirely visible in the viewport; otherwise the newest one that intersects it.`,style:"plain"},{text:"/copy-tool  newest tool call's result text.",style:"plain"},{text:"/copy-transcript  every copyable block's text, oldest to newest, joined by blank lines.",style:"plain"},s,e("Mouse"),{text:`/mouse or ${this.binding("crtr.attach.mouse.toggle")}  toggle mouse reporting \u2014 wheel scrolling and viewer drag-select. Turning it off restores tmux drag-select and copy-mode mouse.`,style:"plain"},s,e("Other attach keys"),...o]}binding(t){return this.bindings===void 0?"Loading\u2026":$(this.bindings,t)}wrap(t,e){if(t==="")return[""];const i=Math.max(1,e),s=t.split(/\s+/),o=[];let n="";for(const r of s){const l=n===""?r:`${n} ${r}`;n!==""&&m(l)>i?(o.push(c(n,i,"",!0)),n=`  ${r}`):n=l}return n!==""&&o.push(c(n,i,"",!0)),o}style(t,e){switch(e){case"heading":return this.pal.bold(this.pal.accent(t));case"muted":return this.pal.muted(t);case"plain":return t}}boxRow(t,e){const i=e-4,s=c(t,i,"",!0),o=" ".repeat(Math.max(0,i-m(s)));return`${this.pal.border("\u2502")} ${s}${o} ${this.pal.border("\u2502")}`}borderRow(t,e,i,s){if(s<6)return c(`${this.pal.border(t)}${i}${this.pal.border(e)}`,s,"",!0);const o=s-5,n=c(i,o,"\u2026"),r=Math.max(0,s-5-m(n));return`${this.pal.border(`${t}\u2500`)} ${n} ${this.pal.border("\u2500".repeat(r)+e)}`}renderNarrow(t){const e=c(this.pal.bold(this.pal.accent("help")),t,"",!0);return[this.pal.surface(e)]}}export{C as HelpOverlay};

package/dist/clients/attach/overlays/mcp.d.ts

@@ -0,0 +1,32 @@
+import type { ClientToBroker } from '../../../core/runtime/broker-protocol.js';
+import type { Picker } from './pickers.js';
+/** One configured MCP server, joined against the adapter's tool cache. */
+export interface McpServerRow {
+    name: string;
+    /** 'http' | 'sse' | 'stdio' — the config's `type`, or inferred (url → http, command → stdio). */
+    transport: string;
+    /** The connection target: the url (http) or the command line (stdio). */
+    target: string;
+    /** Cached tool count, or null when the server has no cache entry (never connected). */
+    toolCount: number | null;
+    /** True when a cache entry exists but its configHash no longer matches the
+     *  current config — the adapter treats that cache as a miss, so the tool
+     *  count is stale. Always false when toolCount is null. */
+    stale: boolean;
+}
+/** Read + merge the adapter's config sources (see file header) and join the
+ *  tool cache into display rows. Returns [] when nothing is configured. */
+export declare function readMcpServers(home?: string, cwd?: string): McpServerRow[];
+/** The hint shown when no source configures any server — lists the same
+ *  sources readMcpServers actually reads (mirroring the adapter). */
+export declare const MCP_EMPTY_STATE_HINT = "No MCP servers configured \u2014 add one to ~/.config/mcp/mcp.json, ~/.pi/agent/mcp.json, <cwd>/.mcp.json, or <cwd>/.pi/mcp.json";
+/** Enter on a row: bridge the right adapter action to the engine via a
+ *  `prompt` frame. Never connected → OAuth kick-off; connected before →
+ *  reconnect, falling back to auth-start (the re-auth path — expired OAuth
+ *  still shows as cached, so reconnect must always be reachable). */
+export declare function startMcpServerAction(row: McpServerRow, send: (frame: ClientToBroker) => void, notify: (message: string) => void): void;
+/** Build the /mcp status panel as an inline picker. Enter on any row acts:
+ *  never-connected → OAuth kick-off, cached → reconnect/re-auth (see
+ *  startMcpServerAction). Status reflects the CACHE — "cached" means the
+ *  server connected before under this config, not that it is connected now. */
+export declare function buildMcpPicker(rows: McpServerRow[], send: (frame: ClientToBroker) => void, close: () => void, notify: (message: string) => void): Picker;

package/dist/clients/attach/overlays/mcp.js

@@ -0,0 +1 @@
+var $=Object.defineProperty;var s=(e,t)=>$(e,"name",{value:t,configurable:!0});import{createHash as k}from"node:crypto";import{existsSync as C}from"node:fs";import{homedir as m}from"node:os";import{join as a,resolve as h}from"node:path";import{piAgentDir as x}from"../../../core/runtime/package-health.js";import{SelectList as T,visibleWidth as w}from"@earendil-works/pi-tui";import{getSelectListTheme as E}from"@earendil-works/pi-coding-agent";import{readJsonOrNull as v}from"../../../core/fs-utils.js";const O=10080*60*1e3;function _(e,t){switch(e){case"cursor":return[a(t,".cursor","mcp.json")];case"claude-code":return[a(t,".claude","mcp.json"),a(t,".claude.json"),a(t,".claude","claude_desktop_config.json")];case"claude-desktop":return[a(t,"Library","Application Support","Claude","claude_desktop_config.json")];case"codex":return[a(t,".codex","config.json")];case"windsurf":return[a(t,".windsurf","mcp.json")];case"vscode":return[".vscode/mcp.json"];default:return[]}}s(_,"importPathCandidates");function M(e){const t=e.mcpServers??e["mcp-servers"]??{};return typeof t!="object"||t===null||Array.isArray(t)?{servers:{},imports:[]}:{servers:t,imports:Array.isArray(e.imports)?e.imports:[]}}s(M,"validateConfigSource");function P(e,t){if(!e||typeof e!="object")return{};const o=e;let n;switch(t){case"claude-desktop":case"claude-code":case"codex":n=o.mcpServers;break;case"cursor":case"windsurf":case"vscode":n=o.mcpServers??o["mcp-servers"];break;default:return{}}return!n||typeof n!="object"||Array.isArray(n)?{}:n}s(P,"extractImportedServers");function b(e,t){const o={...e};for(const[n,u]of Object.entries(t))o[n]={...o[n]??{},...u};return o}s(b,"mergeServerMaps");function R(e,t,o){const n=v(e);if(n===null)return{};const{servers:u,imports:f}=M(n),c={};for(const r of f){const d=_(r,o).map(i=>i.startsWith(".")?h(t,i):i).find(i=>C(i));if(d===void 0)continue;const l=v(d);if(l!==null)for(const[i,p]of Object.entries(P(l,r)))i in c||(c[i]=p)}return b(c,u)}s(R,"readConfigSource");function g(e){return e.replace(/\$\{(\w+)\}/g,(t,o)=>process.env[o]??"").replace(/\$env:(\w+)/g,(t,o)=>process.env[o]??"")}s(g,"interpolateEnvVars");function A(e){if(!e)return;const t={};for(const[o,n]of Object.entries(e))t[o]=g(n);return t}s(A,"interpolateEnvRecord");function N(e){if(e===void 0)return;const t=g(e);return t==="~"?m():t.startsWith("~/")||t.startsWith("~\\")?a(m(),t.slice(2)):t}s(N,"resolveConfigPath");function W(e){return e.bearerToken!==void 0?g(e.bearerToken):e.bearerTokenEnv?process.env[e.bearerTokenEnv]:void 0}s(W,"resolveBearerToken");function j(e){if(e==null||typeof e!="object"){const n=JSON.stringify(e);return n===void 0?"undefined":n}if(Array.isArray(e))return`[${e.map(n=>j(n)).join(",")}]`;const t=e;return`{${Object.keys(t).sort().map(n=>`${JSON.stringify(n)}:${j(t[n])}`).join(",")}}`}s(j,"stableStringify");function H(e){const t={command:e.command,args:e.args,env:A(e.env),cwd:N(e.cwd),url:e.url,headers:A(e.headers),auth:e.auth,bearerToken:W(e),bearerTokenEnv:e.bearerTokenEnv,exposeResources:e.exposeResources,excludeTools:e.excludeTools};return k("sha256").update(j(t)).digest("hex")}s(H,"computeServerHash");function Y(e=m(),t=process.cwd()){const o=x(e),n=[...new Set([a(e,".config","mcp","mcp.json"),a(o,"mcp.json"),h(t,".mcp.json"),h(t,".pi","mcp.json")])];let u={};for(const c of n)u=b(u,R(c,t,e));const f=v(a(o,"mcp-cache.json"));return Object.entries(u).map(([c,r])=>{const d=r.type??(r.url!==void 0?"http":"stdio"),l=r.url??[r.command,...r.args??[]].filter(Boolean).join(" "),i=f?.servers?.[c],p=i?.tools,y=Array.isArray(p)?p.length:null,S=y!==null&&i!==void 0&&!J(i,r);return{name:c,transport:d,target:l,toolCount:y,stale:S}})}s(Y,"readMcpServers");function J(e,t){return!(e.configHash!==H(t)||!e.cachedAt||typeof e.cachedAt!="number"||Date.now()-e.cachedAt>O)}s(J,"isCacheEntryFresh");const q="No MCP servers configured \u2014 add one to ~/.config/mcp/mcp.json, ~/.pi/agent/mcp.json, <cwd>/.mcp.json, or <cwd>/.pi/mcp.json";function L(e,t,o){const n=JSON.stringify(e.name);e.toolCount===null?(t({type:"prompt",text:`Run mcp({ action: "auth-start", server: ${n} }) and show me the returned OAuth URL verbatim (with any instructions). If the server does not need OAuth, run mcp({ connect: ${n} }) instead and report the result.`}),o(`Asking the engine to start OAuth for ${e.name}\u2026`)):(t({type:"prompt",text:`Run mcp({ connect: ${n} }) to reconnect that MCP server and report the result. If it fails with an authentication or authorization error, run mcp({ action: "auth-start", server: ${n} }) and show me the returned OAuth URL verbatim (with any instructions).`}),o(`Asking the engine to reconnect ${e.name}\u2026`))}s(L,"startMcpServerAction");function K(e,t,o,n){const u=e.map(r=>({value:r.name,label:r.toolCount===null?`\u25CB ${r.name} \u2014 ${r.transport} \xB7 never connected (Enter to connect/OAuth)`:r.stale?`\u25B3 ${r.name} \u2014 ${r.transport} \xB7 config changed \u2014 ${r.toolCount} tool${r.toolCount===1?"":"s"} cached, stale (Enter to reconnect)`:`\u2713 ${r.name} \u2014 ${r.transport} \xB7 ${r.toolCount} tool${r.toolCount===1?"":"s"} cached (Enter to reconnect)`,description:r.target})),f=Math.max(0,...u.map(r=>w(r.label)))+2,c=new T(u,12,E(),{minPrimaryColumnWidth:f,maxPrimaryColumnWidth:f});return c.onSelect=r=>{const d=e.find(l=>l.name===r.value);d!==void 0&&(o(),L(d,t,n))},c.onCancel=()=>o(),{component:c,focus:c}}s(K,"buildMcpPicker");export{q as MCP_EMPTY_STATE_HINT,K as buildMcpPicker,Y as readMcpServers,L as startMcpServerAction};