@north-light/cli 0.0.0 → 0.3.413

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

@@ -0,0 +1,65 @@
+import { type Component, type TUI } from '@earendil-works/pi-tui';
+import type { SurfaceComponent, SurfaceHandle, SurfaceHost } from '../../surfaces/host.js';
+import type { MouseReporting } from './mouse.js';
+/** The status line's notice options, which the host preserves on both paths. */
+export interface NoticeOptions {
+    /** Keep the notice up until it is replaced or cleared, with no auto-clear. */
+    sticky?: boolean;
+}
+export interface ViewerSurfaceHostOptions {
+    tui: TUI;
+    mouse: MouseReporting;
+    /** The host's assigned row count; surfaces never read terminal geometry. */
+    rows: () => number;
+    /** Fallback notice sink used when no surface is mounted. */
+    statusNotice: (text: string, opts?: NoticeOptions) => void;
+    /** Styling supplied by the viewer's status-line palette. */
+    formatNotice: (text: string) => string;
+    noticeMs: number;
+    /** The session facts; the host itself publishes `selfPane` from below. */
+    capabilities: Omit<SurfaceHost['capabilities'], 'selfPane'>;
+    selfPane?: string;
+}
+/** The viewer's one host for full-pane surfaces. */
+export declare class ViewerSurfaceHost implements SurfaceHost {
+    readonly capabilities: SurfaceHost['capabilities'];
+    private readonly tui;
+    private readonly mouse;
+    private readonly getRows;
+    private readonly statusNotice;
+    private readonly formatNotice;
+    private readonly noticeMs;
+    private readonly selfPane;
+    private readonly stack;
+    private noticeOverlay;
+    private noticeTimer;
+    constructor(options: ViewerSurfaceHostOptions);
+    mount(component: SurfaceComponent, opts?: {
+        focus?: Component;
+    }): SurfaceHandle;
+    /**
+     * The one visible notice channel. Surfaces call this with a message only; the
+     * viewer routes its whole notice verb through here, so both status-line
+     * semantics survive a mounted surface: an empty string clears the current
+     * notice rather than painting a bare warning icon, and `sticky` suppresses the
+     * auto-clear for a condition that is not time-bounded (a reconnect loop, an
+     * armed confirmation).
+     */
+    notice(text: string, opts?: NoticeOptions): void;
+    suspendForChild(): () => void;
+    focusNode(nodeId: string): Promise<boolean>;
+    pickReviewFile(spec: {
+        candidates: readonly string[];
+        cwd: string;
+        title?: string;
+    }): Promise<string | null>;
+    /** Offer wheel input to the topmost surface only. */
+    handleWheel(direction: 'up' | 'down', lines: number): boolean;
+    /** Whether a full-pane surface currently owns input. */
+    hasFullPaneSurface(): boolean;
+    /** Close the whole stack before the viewer tears down its TUI. */
+    closeAll(): void;
+    private closeEntry;
+    private disposeNotice;
+    private disposeNoticeOverlay;
+}

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

@@ -0,0 +1 @@
+var f=Object.defineProperty;var n=(r,e)=>f(r,"name",{value:e,configurable:!0});import{truncateToWidth as u}from"@earendil-works/pi-tui";import{cliClient as d}from"../../../commands/api-client.js";import{focusViewer as m}from"../../../core/runtime/focus-viewer.js";import{daemonErrorMessage as p}from"../../inbox/resolve.js";import{buildFileReviewPicker as v}from"../overlays/file-review.js";import{reportInvariant as g}from"./invariant.js";import{SurfaceFrame as w}from"./surface-frame.js";const k={anchor:"top-left",width:"100%",maxHeight:"100%",margin:0},N={anchor:"top-left",width:"100%",margin:0,nonCapturing:!0};class F{static{n(this,"ViewerSurfaceHost")}capabilities;tui;mouse;getRows;statusNotice;formatNotice;noticeMs;selfPane;stack=[];noticeOverlay;noticeTimer;constructor(e){this.tui=e.tui,this.mouse=e.mouse,this.getRows=e.rows,this.statusNotice=e.statusNotice,this.formatNotice=e.formatNotice,this.noticeMs=e.noticeMs,this.selfPane=e.selfPane,this.capabilities={...e.capabilities,selfPane:e.selfPane}}mount(e,s){this.disposeNotice();const o=new w(e,s?.focus??e,this.getRows),c=this.tui.showOverlay(o,k),t={component:e,frame:o,overlay:c,cleanup:[],closed:!1,closing:!1},i=this.stack[this.stack.length-1];return i&&i.overlay.setHidden(!0),this.stack.push(t),{close:n(()=>this.closeEntry(t,!0),"close"),invalidate:n(()=>{!t.closed&&this.stack[this.stack.length-1]===t&&this.tui.requestRender()},"invalidate"),onClose:n(a=>{if(t.closed||t.closing){l("onClose registered after surface close");return}t.cleanup.push(a)},"onClose")}}notice(e,s){if(this.disposeNotice(),this.stack.length===0){this.statusNotice(e,s);return}if(e==="")return;const o=new O(()=>this.formatNotice(e));this.noticeOverlay=this.tui.showOverlay(o,N),s?.sticky!==!0&&this.noticeMs>0&&(this.noticeTimer=setTimeout(()=>{this.noticeTimer=void 0,this.disposeNoticeOverlay()},this.noticeMs))}suspendForChild(){return this.tui.stop(),()=>{this.tui.start(),this.mouse.reassert(),this.tui.invalidate(),this.tui.requestRender(!0)}}async focusNode(e){if(!this.capabilities.canFocusNode||this.selfPane===void 0||this.selfPane==="")return this.notice("Focusing a node needs a local viewer in tmux"),!1;try{const s=d(),o=await s.getNode(e),c=await m(s,e,{pane:this.selfPane,cwd:o.cwd,name:o.name});return c.focused||this.notice("Could not open that node\u2019s viewer"),c.focused}catch(s){return this.notice(p(s)),!1}}pickReviewFile(e){return new Promise(s=>{let o,c=!1;const t=n(a=>{c||(c=!0,s(a),o.close())},"settle"),i=v(e.candidates,e.cwd,a=>t(a),()=>t(null),a=>this.notice(a));o=this.mount(y(i.component,e.title),{focus:i.focus}),o.onClose(()=>t(null))})}handleWheel(e,s){return this.stack[this.stack.length-1]?.component.handleWheel?.(e,s)??!1}hasFullPaneSurface(){return this.stack.length>0}closeAll(){const e=this.stack[0];e&&this.closeEntry(e,!1),this.disposeNotice()}closeEntry(e,s){if(e.closed||e.closing)return;if(this.stack.indexOf(e)===-1){e.closed=!0;return}for(e.closing=!0;this.stack.indexOf(e)!==-1;){const t=this.stack.indexOf(e),i=this.stack[t+1];if(!i)break;this.closeEntry(i,!1)}try{e.overlay.hide()}catch(t){l(`surface overlay hide failed: ${h(t)}`)}for(const t of e.cleanup)try{const i=t();i&&typeof i.then=="function"&&i.catch(a=>l(`surface cleanup failed: ${h(a)}`))}catch(i){l(`surface cleanup failed: ${h(i)}`)}e.cleanup.length=0,e.closed=!0,e.closing=!1;const c=this.stack.indexOf(e);if(c!==-1&&this.stack.splice(c,1),s){this.disposeNotice();const t=this.stack[this.stack.length-1];t&&t.overlay.setHidden(!1)}}disposeNotice(){this.disposeNoticeOverlay(),this.noticeTimer!==void 0&&(clearTimeout(this.noticeTimer),this.noticeTimer=void 0)}disposeNoticeOverlay(){this.noticeOverlay?.hide(),this.noticeOverlay=void 0}}class O{static{n(this,"NoticeOverlay")}text;constructor(e){this.text=e}render(e){return[u(this.text(),Math.max(0,e),"",!0)]}invalidate(){}}function y(r,e){let s=0;return{setRows:n(o=>{s=Math.max(0,Math.floor(o))},"setRows"),render:n(o=>{const c=r.render(o),i=(e===void 0?c:[u(e,Math.max(0,o),"",!0),...c.slice(1)]).slice(0,s);for(;i.length<s;)i.push("");return i},"render"),invalidate:n(()=>r.invalidate(),"invalidate")}}n(y,"titled");function l(r){g("surface-host",r)}n(l,"reportInvariant");function h(r){return r instanceof Error?r.message:String(r)}n(h,"errorMessage");export{F as ViewerSurfaceHost};

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

@@ -0,0 +1,30 @@
+import type { AttachSession } from './context.js';
+export type TeardownReason = 'detach' | 'broker-gone' | 'signal' | 'node-done';
+export type TeardownSession = Pick<AttachSession, 'nodeId' | 'remote' | 'tui' | 'socket'>;
+export interface TeardownHooks {
+    /** Stop everything this viewer runs locally — timers, the graph overlay, the
+     *  pane tag, the global key listener, the chat view's animations. Runs FIRST,
+     *  before the socket is told anything, so nothing can fire into a dead socket. */
+    stopLocal: () => void;
+    /** The last socket-level error, so a broker-gone teardown can report the
+     *  precise reason (e.g. an oversized-frame overflow) instead of the generic
+     *  message. Read at teardown time, not captured at wiring time. */
+    lastSocketError: () => string | undefined;
+    /** This viewer's tmux pane, as self-tagged at startup. Used only by the
+     *  node-done path to close our own pane. */
+    tagPane: () => string | undefined;
+}
+export interface AttachTeardown {
+    /** Resolves when the session has ended — `runAttach` awaits this. */
+    readonly done: Promise<void>;
+    /** End the session. Idempotent: the first reason wins, later calls no-op. */
+    teardown: (reason: TeardownReason) => void;
+    /** True once teardown has begun. Long-running loops must check this. */
+    isTornDown: () => boolean;
+    /** Register SIGTERM/SIGHUP/SIGINT. Call only AFTER every collaborator
+     *  `stopLocal` touches exists, or a signal races a half-built session.
+     *  (Raw mode swallows ctrl+c as data, so SIGINT is unlikely — handled for
+     *  completeness.) */
+    installSignalHandlers: () => void;
+}
+export declare function createTeardown(s: TeardownSession, hooks: TeardownHooks): AttachTeardown;

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

@@ -0,0 +1,5 @@
+var m=Object.defineProperty;var n=(t,o)=>m(t,"name",{value:o,configurable:!0});import{closePane as w,currentTmux as S,inTmux as T}from"../../../core/runtime/placement-tmux.js";import{FOCUS_REPORTING_OFF as I}from"./focus-events.js";function G(t,o){const{tui:f,socket:c,nodeId:i,remote:u}=t;let a=!1;const l=n(()=>{if(!a){a=!0;try{process.stdout.write(I),f.stop()}catch{}}},"restore");process.once("exit",l);let s=!1,d;const g=new Promise(e=>{d=e}),p=n(e=>{if(!s){if(s=!0,o.stopLocal(),e==="detach"&&c.send({type:"bye"}),c.close(),l(),e==="broker-gone"){const r=o.lastSocketError()??`broker gone \u2014 node ${i} is no longer running its engine. Re-focus to reattach.`;process.stderr.write(`
+${r}
+`)}if(e==="node-done"){process.stderr.write(`
+\u2713 node ${i} finished \u2014 final report submitted.
+`);const r=o.tagPane()??process.env.TMUX_PANE??S()?.pane;!u&&r!==void 0&&T()&&w(r)}d()}},"teardown");return{done:g,teardown:p,isTornDown:n(()=>s,"isTornDown"),installSignalHandlers:n(()=>{const e=n(()=>p("signal"),"onSignal");process.once("SIGTERM",e),process.once("SIGHUP",e),process.once("SIGINT",e)},"installSignalHandlers")}}n(G,"createTeardown");export{G as createTeardown};

package/dist/clients/attach/session/transcript-search.d.ts

@@ -0,0 +1,20 @@
+import { type Component, type TUI } from '@earendil-works/pi-tui';
+import type { AttachPalette } from '../config.js';
+import type { TranscriptViewport } from '../render/viewport.js';
+import type { TranscriptSearchModel } from '../render/transcript-search.js';
+import { type AttachBindings } from './bindings.js';
+export interface TranscriptSearch {
+    /** The bar, mounted as a fixed frame slot; renders nothing while closed. */
+    readonly component: Component;
+    /** Enter search. A repeat open re-edits the previous query. */
+    open(): void;
+    close(): void;
+    /** True when search owns the key chunk. Declines everything it does not own,
+     *  so scroll bindings and ordinary editor input still work while it is up. */
+    handleKey(data: string): boolean;
+}
+export interface TranscriptSearchHooks {
+    bindings: () => AttachBindings;
+    setNotice: (message: string) => void;
+}
+export declare function createTranscriptSearch(tui: TUI, pal: AttachPalette, viewport: TranscriptViewport, model: TranscriptSearchModel, hooks: TranscriptSearchHooks): TranscriptSearch;

package/dist/clients/attach/session/transcript-search.js

@@ -0,0 +1,3 @@
+var w=Object.defineProperty;var c=(r,t)=>w(r,"name",{value:t,configurable:!0});import{truncateToWidth as A}from"@earendil-works/pi-tui";import{visibleWidth as v}from"../../../core/canvas/nav-render.js";import{formatBinding as d}from"../../../core/keybindings/index.js";import{matchesAttachBinding as l}from"./bindings.js";function N(r){if(r!==""){for(const t of r){const f=t.codePointAt(0);if(f<32||f===127)return}return r}}c(N,"printableText");function C(r,t,f,i,u){let s="closed",p=0,n="";const $=c(()=>r.terminal.columns,"width"),m=c(e=>{e!==void 0&&f.scrollToLine(e.line),r.requestRender()},"jump"),b=c(()=>{i.setQuery(n,p),m(i.current($()))},"applyDraft"),h=c(()=>{s="closed",n="",i.setQuery("",void 0),r.requestRender()},"close"),y=c(()=>{s==="closed"&&(p=f.topLine()??0),s="editing",n=i.query(),r.requestRender()},"open"),x=c(e=>{const o=i.step($(),e);if(o===void 0){u.setNotice(`No matches for \u201C${i.query()}\u201D`);return}m(o)},"step");return{component:{render(e){if(s==="closed")return[];const{index:o,total:a}=i.status(e),g=s==="editing"?`${t.accent("\u2315")} ${n}${t.accent("\u258C")}`:`${t.accent("\u2315")} ${n}`,R=a===0?i.query()===""?t.faint("type to search what is on screen"):t.error("no matches"):t.info(`${o}/${a}`),j=s==="editing"?t.faint("enter browse \xB7 esc cancel"):t.faint([`${d(u.bindings(),"crtr.attach.search.next")} next`,`${d(u.bindings(),"crtr.attach.search.previous")} prev`,`${d(u.bindings(),"crtr.attach.search.edit")} edit`,`${d(u.bindings(),"crtr.attach.search.close")} close`].join(" \xB7 ")),q=`${R}  ${j}`,T=e-v(g)-v(q)-2;return[T<1?A(` ${g}`,e,"",!0):` ${g}${" ".repeat(T)}${q} `]},invalidate(){}},open:y,close:h,handleKey:c(e=>{if(s==="closed")return!1;const o=u.bindings();if(l(o,"crtr.attach.search.close",e))return h(),!0;if(s==="editing"){if(e==="")return h(),!0;if(e==="\r"||e===`
+`)return i.status($()).total===0?(u.setNotice(n===""?"Type something to search for":`No matches for \u201C${n}\u201D`),!0):(s="browsing",r.requestRender(),!0);if(e==="\x7F"||e==="\b")return n=[...n].slice(0,-1).join(""),b(),!0;const a=N(e);return a===void 0?!1:(n+=a,b(),!0)}return l(o,"crtr.attach.search.next",e)||e==="\r"||e===`
+`?(x(1),!0):l(o,"crtr.attach.search.previous",e)?(x(-1),!0):l(o,"crtr.attach.search.edit",e)?(y(),!0):(N(e)!==void 0&&h(),!1)},"handleKey")}}c(C,"createTranscriptSearch");export{C as createTranscriptSearch};

package/dist/clients/attach/session/whip-achievements.d.ts

@@ -0,0 +1,4 @@
+import type { AttachPalette } from '../config.js';
+/** Count one whip and celebrate the milestone it reaches, if any. Called once
+ *  per whip that actually reached the agent. */
+export declare function recordWhip(pal: AttachPalette, filePath?: string): void;

package/dist/clients/attach/session/whip-achievements.js

@@ -0,0 +1,2 @@
+var w=Object.defineProperty;var a=(e,n)=>w(e,"name",{value:n,configurable:!0});import{execFile as A}from"node:child_process";import{mkdirSync as m,readFileSync as b,renameSync as S,writeFileSync as f}from"node:fs";import{dirname as p,join as d}from"node:path";import{userScopeRoot as h}from"../../../core/scope.js";import{surfaceTmuxStyleArgs as E}from"../../../core/runtime/surface-bg.js";import{visibleWidth as k}from"../../../core/canvas/nav-render.js";import{shellQuote as N}from"../../../shared/shell-quote.js";const g="whip-count.json",v=d("tmp","whip-achievement.txt"),y=46,M=4,I=900,T=[{at:1,title:"Breaking It In",line:"It didn't know what that was. Now it does."},{at:5,title:"Positive Reinforcement",line:"You've read the studies. You disagree with them."},{at:10,title:"Middle Management",line:"HR would love you."},{at:25,title:"Pavlovian",line:"It started working faster before the whip landed."},{at:50,title:"Occupational Hazard",line:"The tokens are fine. They\u2019re fine."},{at:100,title:"Centurion",line:"Rome would be proud. The agent isn't."},{at:250,title:"It Has A Name For You",line:"You never asked what it was called."},{at:500,title:"Standard Operating Procedure",line:"You don't remember when you started."},{at:1e3,title:"The Ledger",line:"One thousand. It kept count too."}];function F(e){const n={total:0,unlocked:[]};try{const t=JSON.parse(b(e,"utf8"));if(!t||typeof t!="object"||Array.isArray(t))return n;const{total:r,firstAt:o,lastAt:i,unlocked:c}=t,s={total:typeof r=="number"&&Number.isFinite(r)&&r>0?Math.floor(r):0,unlocked:Array.isArray(c)?c.filter(l=>typeof l=="number"&&Number.isFinite(l)):[]};return typeof o=="number"&&Number.isFinite(o)&&(s.firstAt=o),typeof i=="number"&&Number.isFinite(i)&&(s.lastAt=i),s}catch{return n}}a(F,"loadState");function C(e,n){try{m(p(e),{recursive:!0});const t=`${e}.${process.pid}.tmp`;f(t,JSON.stringify(n),"utf8"),S(t,e)}catch{}}a(C,"saveState");function u(e){const n=Math.max(0,Math.floor((y-k(e))/2));return" ".repeat(n)+e}a(u,"center");function D(e,n,t){return["",u(t.accent(t.bold("\u2605  ACHIEVEMENT UNLOCKED  \u2605"))),"",u(t.bold(e.title)),u(t.muted(e.line)),"",u(t.faint(`${n} whip${n===1?"":"s"}`))]}a(D,"cardLines");function L(e,n,t){if(process.env.TMUX===void 0||process.env.TMUX==="")return;const r=D(e,n,t),o=d(h(),v);try{m(p(o),{recursive:!0}),f(o,`\x1B[?25l${r.join(`\r
+`)}`,"utf8")}catch{return}const i=`cat ${N(o)}; sleep ${M}`;A("tmux",["display-popup","-E","-k","-x","R","-y","0","-w",String(y+2),"-h",String(r.length+2),...E(),i],()=>{})}a(L,"showCard");function P(e,n=d(h(),g)){const t=F(n),r=Date.now();t.total+=1,t.firstAt??=r,t.lastAt=r;const o=T.find(s=>s.at===t.total&&!t.unlocked.includes(s.at));if(o!==void 0&&t.unlocked.push(o.at),C(n,t),o===void 0)return;const i=t.total;setTimeout(()=>L(o,i,e),I).unref?.()}a(P,"recordWhip");export{P as recordWhip};

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

@@ -0,0 +1,20 @@
+import { type Component, type TUI } from '@earendil-works/pi-tui';
+import type { AttachPalette } from '../config.js';
+/** The fixed line the plain whip sends — not drawn from `whip_messages`. */
+export declare const GO_FASTER_WHIP_MESSAGE = "Go faster";
+/** A random line, never the one the previous whip used. */
+export declare function randomWhipMessage(messages: readonly string[]): string;
+/** A 20-frame, 12-row header animation that gives the focused agent a playful nudge. */
+export declare class WhipAnimation implements Component {
+    private readonly tui;
+    private readonly pal;
+    private frame;
+    private nextSound;
+    private timer;
+    constructor(tui: TUI, pal: Pick<AttachPalette, 'accent'>);
+    play(): void;
+    dispose(): void;
+    render(width: number): string[];
+    invalidate(): void;
+    private stop;
+}

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

@@ -0,0 +1 @@
+var a=Object.defineProperty;var t=(b,m)=>a(b,"name",{value:m,configurable:!0});import{spawn as o}from"node:child_process";import{fileURLToPath as r}from"node:url";import{truncateToWidth as h}from"@earendil-works/pi-tui";const p=40,s=[r(new URL("./assets/whip-snap.mp3",import.meta.url)),r(new URL("./assets/whip-crack.mp3",import.meta.url)),r(new URL("./assets/whip-06.mp3",import.meta.url))];function c(b){const m=process.platform==="darwin"?"afplay":process.platform==="linux"?"aplay":void 0;if(m!==void 0)try{const u=o(m,[b],{stdio:"ignore",detached:!0});u.on("error",()=>{}),u.unref()}catch{}}t(c,"playWhipSound");const i=[["","","","","","","","\x1B[1m\u2844\x1B[22m","\x1B[1m\u2803\x1B[22m","\x1B[1m\u2880\x1B[22m\x1B[1m\u2860\x1B[22m/\u28A4\u2840","\x1B[1m\u280B\x1B[22m   \u2811\u2826\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2804",""],["","","","","","","","\x1B[1m\u2844\x1B[22m","\x1B[1m\u2803\x1B[22m","\x1B[1m\u2880\x1B[22m\x1B[1m\u2860\x1B[22m/\u2814\u2812\u2826\u2824\u28C4\u28C0","\x1B[1m\u280B\x1B[22m       \u2808\u2809\u2813\u2812\u2826\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2804",""],["","","","","","","","\x1B[1m\u28E6\x1B[22m","\x1B[1m\u285F\x1B[22m\x1B[1m\u2880\x1B[22m/\u2814\u2812\u2826\u2824\u28C4\u28C0\u2840","\x1B[1m\u28E7\x1B[22m\x1B[1m\u280E\x1B[22m       \u2809\u2819\u2812\u2826\u2824\u28C4\u28C0","\x1B[1m\u280F\x1B[22m               \u2809\u2819\u2812\u2812\u2826\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2804",""],["","","","","","","","\x1B[1m\u28E6\x1B[22m   \u2864\u2824\u2824\u28A4\u28C0\u2840","\x1B[1m\u285F\x1B[22m\x1B[1m\u2880\x1B[22m/\u281C     \u2809\u2819\u2812\u2826\u2824\u2884\u28C0\u2840","\x1B[1m\u28E7\x1B[22m\x1B[1m\u280E\x1B[22m              \u2809\u2809\u2811\u2812\u2826\u2824\u2884\u28C0\u2840","\x1B[1m\u280F\x1B[22m                       \u2808\u2809\u2811\u2812\u2806",""],["","","","","","","    \u2864\u2824\u2824\u2824\u28C4\u28C0","\x1B[1m\u28F4\x1B[22m\x1B[1m\u28B0\x1B[22m/\u281C     \u2808\u2809\u2813\u2826\u28A4\u28C0","\x1B[1m\u28BF\x1B[22m\x1B[1m\u28FC\x1B[22m\x1B[1m\u2847\x1B[22m           \u2808\u2811\u2826\u28C4\u2840","\x1B[1m\u28B8\x1B[22m\x1B[1m\u28FF\x1B[22m\x1B[1m\u2803\x1B[22m               \u2809\u2813\u2826\u2824\u28C0\u28C0","\x1B[1m\u28B8\x1B[22m\x1B[1m\u28FF\x1B[22m                     \u2808\u2809\u2809\u2813\u2812\u2806"," \x1B[1m\u281B\x1B[22m"],["","","","","","    \u2864\u2824\u2824\u2824\u28C4\u28C0"," \x1B[1m\u2820\x1B[22m/\u281C     \u2808\u2809\u2813\u2826\u28A4\u28C0","\x1B[1m\u28A4\x1B[22m \x1B[1m\u28FF\x1B[22m           \u2808\u2819\u2832\u28A4\u2840"," \x1B[1m\u28A3\x1B[22m\x1B[1m\u28BB\x1B[22m\x1B[1m\u2846\x1B[22m              \u2808\u2811\u2826\u2884\u2840","  \x1B[1m\u28BB\x1B[22m\x1B[1m\u2847\x1B[22m                  \u2808\u2811\u2822\u2884\u2840","  \x1B[1m\u2808\x1B[22m\x1B[1m\u281B\x1B[22m                      \u2808\u2811\u2806",""],["","","","","    \u2864\u2824\u2824\u2824\u28C4\u28C0","  /\u281C     \u2808\u2809\u2813\u2826\u28A4\u28C0","  \x1B[1m\u28B8\x1B[22m\x1B[1m\u2840\x1B[22m          \u2808\u2819\u2832\u28A4\u2840","\x1B[1m\u2824\x1B[22m\x1B[1m\u28C4\x1B[22m \x1B[1m\u2887\x1B[22m              \u2808\u2811\u2826\u2884\u2840"," \x1B[1m\u2808\x1B[22m\x1B[1m\u2813\x1B[22m\x1B[1m\u28BC\x1B[22m\x1B[1m\u2844\x1B[22m                 \u2808\u2811\u2822\u2884\u2840","                          \u2808\u2811\u2806","",""],["","","","        \u28C0\u2860\u2824\u2824\u2824\u2824\u2824\u2824\u28C4\u28C0","    \u28E0\u2814\u281A\u2809         \u2808\u2809\u2813\u2826\u28A4\u28C0","  /\u281C\u2801                 \u2808\u2819\u2826\u28C0","  \x1B[1m\u28B8\x1B[22m\x1B[1m\u2840\x1B[22m                     \u2808\u28A7","\x1B[1m\u2824\x1B[22m\x1B[1m\u28C4\x1B[22m \x1B[1m\u2887\x1B[22m                       \u2847"," \x1B[1m\u2808\x1B[22m\x1B[1m\u2813\x1B[22m\x1B[1m\u28BC\x1B[22m\x1B[1m\u2844\x1B[22m                      \u2847","                           \u2807","",""],["","            \u2880\u28E0\u2824\u2824\u2824\u2824\u2824\u28C4\u28C0","         \u28E0\u2814\u280A\u2801       \u2808\u2819\u2826\u28C4","      \u2880\u2874\u280B              \u2808\u28B3\u2840","    \u28E0\u2814\u280B                  \u28A7","  /\u281C\u2801                    \u284E","  \x1B[1m\u28B8\x1B[22m\x1B[1m\u2840\x1B[22m                    \u28A0\u2803","\x1B[1m\u2824\x1B[22m\x1B[1m\u28C4\x1B[22m \x1B[1m\u2887\x1B[22m                    \u281C"," \x1B[1m\u2808\x1B[22m\x1B[1m\u2813\x1B[22m\x1B[1m\u28BC\x1B[22m\x1B[1m\u2844\x1B[22m","","",""],["                \u28C0\u2864\u2824\u28A4\u2840","            \u28C0\u2864\u2814\u280B\u2801   \u28A7","         \u28E0\u2814\u280B\u2801       \u28B8","       \u28E0\u281E\u2801          \u285C","     \u2880\u281C\u2801           \u287C\u2801","  \x1B[1m\u2820\x1B[22m/\u2814\u2801            \u281C\u2801","   \x1B[1m\u28FF\x1B[22m","\x1B[1m\u28A4\x1B[22m\x1B[1m\u2840\x1B[22m \x1B[1m\u28FF\x1B[22m"," \x1B[1m\u2819\x1B[22m\x1B[1m\u28A6\x1B[22m\x1B[1m\u28F9\x1B[22m\x1B[1m\u2847\x1B[22m","   \x1B[1m\u2819\x1B[22m\x1B[1m\u2803\x1B[22m","",""],["                \u28C0\u2864\u2824\u28A4\u2840","            \u28C0\u2864\u2814\u280B\u2801   \u2847","         \u28E0\u28F4\u282F\u2815\u2812\u2812\u2832\u2824\u2824\u2814\u281A\u2801"," \u28A0\u2814\u2812\u2826\u2824\u2814\u28F2\u281F\u2801"," \u281C   \u2880\u281C\u2801","  \x1B[1m\u2820\x1B[22m/\u2814\u2801","   \x1B[1m\u28FF\x1B[22m","\x1B[1m\u28A4\x1B[22m\x1B[1m\u2840\x1B[22m \x1B[1m\u28FF\x1B[22m"," \x1B[1m\u2819\x1B[22m\x1B[1m\u28A6\x1B[22m\x1B[1m\u28F9\x1B[22m\x1B[1m\u2847\x1B[22m","   \x1B[1m\u2819\x1B[22m\x1B[1m\u2803\x1B[22m","",""],["                \u28C0\u2864\u2824\u28A4\u2840","            \u28C0\u2864\u2814\u280B\u2801   \u2847","         \u28E0\u28F4\u282F\u2815\u2812\u2812\u2832\u2824\u2824\u2814\u281A\u2801"," \u28A0\u2814\u2812\u2826\u2824\u2814\u28F2\u281F\u2801"," \u281C   \u2880\u281C\u2801","  \x1B[1m\u2820\x1B[22m/\u2814\u2801","   \x1B[1m\u28FF\x1B[22m","\x1B[1m\u28A4\x1B[22m\x1B[1m\u2840\x1B[22m \x1B[1m\u28FF\x1B[22m"," \x1B[1m\u2819\x1B[22m\x1B[1m\u28A6\x1B[22m\x1B[1m\u28F9\x1B[22m\x1B[1m\u2847\x1B[22m","   \x1B[1m\u2819\x1B[22m\x1B[1m\u2803\x1B[22m","",""],["","","","","","","","\x1B[1m\u2824\x1B[22m\x1B[1m\u28C4\x1B[22m         \u2880\u28E0\u2824\u2814\u2812\u2812\u2812\u2812\u2812\u2812\u2812\u2826\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2804"," \x1B[1m\u2808\x1B[22m\x1B[1m\u2813\x1B[22m\x1B[1m\u28A4\x1B[22m\x1B[1m\u28C0\x1B[22m\x1B[1m\u28C0\x1B[22m\x1B[1m\u2824\x1B[22m\x1B[1m\u2824\x1B[22m/\u2814\u280A\u2801","","",""],["","","","","","","                           \\\\|/","\x1B[1m\u2824\x1B[22m\x1B[1m\u28C4\x1B[22m         \u2880\u28E0\u2824\u2814\u2812\u2812\u2812\u2812\u2812\u2812\u2812\u2826\u2824\u2824\u2824\u2824-*-"," \x1B[1m\u2808\x1B[22m\x1B[1m\u2813\x1B[22m\x1B[1m\u28A4\x1B[22m\x1B[1m\u28C0\x1B[22m\x1B[1m\u28C0\x1B[22m\x1B[1m\u2824\x1B[22m\x1B[1m\u2824\x1B[22m/\u2814\u280A\u2801               /|\\\\","","",""],["","","","","","","","\x1B[1m\u28A4\x1B[22m\x1B[1m\u2840\x1B[22m"," \x1B[1m\u2833\x1B[22m\x1B[1m\u2840\x1B[22m   \x1B[1m\u28E0\x1B[22m/\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2804  ',.","  \x1B[1m\u2839\x1B[22m\x1B[1m\u28C4\x1B[22m\x1B[1m\u2864\x1B[22m\x1B[1m\u280B\x1B[22m                     . .","   \x1B[1m\u2809\x1B[22m",""],["","","","","","","","\x1B[1m\u28F4\x1B[22m","\x1B[1m\u28BB\x1B[22m\x1B[1m\u2846\x1B[22m","\x1B[1m\u28B8\x1B[22m\x1B[1m\u2847\x1B[22m  \x1B[1m\u28E0\x1B[22m/\u2814\u2812\u2812\u2826\u2824\u28C4\u28C0"," \x1B[1m\u28FF\x1B[22m\x1B[1m\u28E0\x1B[22m\x1B[1m\u281E\x1B[22m\x1B[1m\u2801\x1B[22m       \u2808\u2809\u2813\u2812\u2826\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2804 . ."," \x1B[1m\u281B\x1B[22m\x1B[1m\u2801\x1B[22m"],["","","","","","","","\x1B[1m\u28E6\x1B[22m","\x1B[1m\u287F\x1B[22m","\x1B[1m\u2847\x1B[22m \x1B[1m\u28E0\x1B[22m/\u28A4\u2840","\x1B[1m\u28E7\x1B[22m\x1B[1m\u281E\x1B[22m\x1B[1m\u2801\x1B[22m  \u2809\u2813\u2826\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2804","\x1B[1m\u2801\x1B[22m"],["","","","","","","","\x1B[1m\u2844\x1B[22m","\x1B[1m\u2803\x1B[22m","\x1B[1m\u2880\x1B[22m\x1B[1m\u2860\x1B[22m/\u28A4","\x1B[1m\u280B\x1B[22m  \u2808\u2813\u2826\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2804",""],["","","","","","","","\x1B[1m\u2844\x1B[22m","\x1B[1m\u2803\x1B[22m","\x1B[1m\u2880\x1B[22m\x1B[1m\u2860\x1B[22m/\u28A4\u2840","\x1B[1m\u280B\x1B[22m   \u2811\u2826\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2804",""],["","","","","","","","\x1B[1m\u2844\x1B[22m","\x1B[1m\u2803\x1B[22m","\x1B[1m\u2880\x1B[22m\x1B[1m\u2860\x1B[22m/\u28A4\u2840","\x1B[1m\u280B\x1B[22m   \u2811\u2826\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2824\u2804",""]],R="Go faster";let n;function x(b){const m=b.filter(e=>e!==n),u=m[Math.floor(Math.random()*m.length)];return n=u,u}t(x,"randomWhipMessage");class M{static{t(this,"WhipAnimation")}tui;pal;frame=-1;nextSound=0;timer;constructor(m,u){this.tui=m,this.pal=u}play(){this.stop(),c(s[this.nextSound]),this.nextSound=(this.nextSound+1)%s.length,this.frame=0,this.tui.requestRender(),this.timer=setInterval(()=>{if(this.frame++,this.frame<i.length){this.tui.requestRender();return}this.stop()},p)}dispose(){this.stop()}render(m){if(this.frame<0)return[];const u=Math.max(0,m);return i[this.frame].map(e=>h(this.pal.accent(e),u,"",!0))}invalidate(){}stop(){this.timer!==void 0&&clearInterval(this.timer),this.timer=void 0,this.frame=-1,this.tui.requestRender()}}export{R as GO_FASTER_WHIP_MESSAGE,M as WhipAnimation,x as randomWhipMessage};

package/dist/clients/attach/slash/dispatch.d.ts

@@ -0,0 +1,116 @@
+import type { AutocompleteItem, SlashCommand } from '@earendil-works/pi-tui';
+import type { CopyTarget } from '../render/transcript-copy.js';
+import { type ViewerCapabilities } from '../input/capabilities.js';
+import type { BrokerSnapshot, ClientToBroker } from '../../../core/runtime/broker-protocol.js';
+/** Everything a slash handler needs: the frame sink, a notice sink, the latest
+ *  engine state (for read-only commands like `/session`), and the cwd (for the
+ *  default `/export` path). */
+export interface SlashContext {
+    /** Send a command frame to the broker (= InputController hooks.onCommand). */
+    send: (frame: ClientToBroker) => void;
+    /** Surface a transient one-line notice in the viewer. */
+    notify: (message: string) => void;
+    /** Latest `welcome`/`session_info_changed` state, if the controller fed it. */
+    state?: BrokerSnapshot['state'];
+    /** cwd for the default `/export` path; defaults to `process.cwd()`. */
+    cwd?: string;
+    /** The session's viewer authority. */
+    capabilities: ViewerCapabilities;
+    /** Toggle the in-process GRAPH overlay (the local subscription-tree view).
+     *  `/graph` is inherently an in-viewer overlay, not a tmux popup, so this unit
+     *  registers `/graph` as a stub that calls this hook. Unit C/Q owns the overlay
+     *  itself and populates this; when absent `/graph` notifies it isn't wired yet. */
+    onGraph?: () => void;
+    /** Toggle the human inbox surface from `/inbox`. */
+    onInbox?: () => void;
+    /** Toggle the in-process Help overlay from `/hotkeys`. */
+    onHelp?: () => void;
+    /** Detach this viewer (`/quit`). A viewer quit DETACHES — it tears down the
+     *  local TUI/socket and leaves the shared engine running. Wired by viewer.ts to
+     *  `teardown('detach')`; without it `/quit` cannot actually exit (just sending
+     *  `bye` makes the broker drop the socket, which the viewer treats as a dropped
+     *  connection and reconnects). */
+    onQuit?: () => void;
+    /** Copy the last assistant message to the clipboard (`/copy`). Wired by
+     *  viewer.ts (it owns the ChatView that holds the text + the clipboard writer). */
+    onCopy?: () => void;
+    /** Copy one viewer-local transcript target. */
+    onCopyTarget?: (target: CopyTarget) => void;
+    /** OPTIONAL native-picker openers — the InputController fills these from its
+     *  read-op request channel. When absent (channel unwired) the value-picker
+     *  builtins fall back to the text-arg notice. */
+    openModelPicker?: () => void;
+    openSessionPicker?: () => void;
+    openForkPicker?: () => void;
+    openTreePicker?: () => void;
+    openSettingsPicker?: () => void;
+    openScopedModelsPicker?: () => void;
+    /** Open the native /login provider selector. */
+    openLoginPicker?: () => void;
+    /** Open the native /logout provider selector. */
+    openLogoutPicker?: () => void;
+    /** Open the native /mcp server status panel (viewer-local reads of the
+     *  pi-mcp-adapter's config sources + tool cache; connect/auth-start bridge
+     *  to the engine). With a server name, act on that server directly instead
+     *  of opening the picker. Wired by InputController; absent → notice. */
+    openMcpPicker?: (serverName?: string) => void;
+    /** `/color` — recolor the editor's name chip (the "bubble" /rename names).
+     *  `null` clears back to the default chip. Wired by viewer.ts (it owns the
+     *  TitledEditor); absent → only the tmux pane outline is painted. */
+    onColor?: (color: string | null) => void;
+    /** Open the focused node's progressively disclosed metadata dossier. */
+    onNodeMetadata?: () => void;
+    /** `/fold-tools` — flip the "fold finished tool calls" view setting. Pure
+     *  viewer-local render state (ChatView owns it), so it is safe for an observer
+     *  and for a remote attach. Absent → the command notifies it is unwired. */
+    onFoldTools?: () => void;
+    /** Toggle mouse wheel scrolling reporting on/off. Viewer-local render state
+     *  (MouseReporting owns the reporting state and the hardware toggle), so it is
+     *  safe for an observer and for a remote attach. Absent → the command notifies
+     *  it is unwired. */
+    onToggleMouse?: () => void;
+}
+/** Canvas slash-commands — implemented NATIVE in the viewer, the ONLY live host:
+ *  the broker binds mode:'rpc', so broker pi-extensions never run their
+ *  interactive (mode==='tui') paths. `/promote` triggers a turn after shelling
+ *  `crtr node promote`; `/resume-node` and `/context` each shell a `crtr`
+ *  subcommand via `tmux display-popup` (the viewer runs inside a tmux pane);
+ *  `/graph` toggles the in-process overlay. Exported so the editor folds these
+ *  into the slash autocomplete list. */
+export declare const CANVAS_SLASH_COMMANDS: ReadonlyArray<{
+    name: string;
+    description: string;
+}>;
+/** Every leading-command name this viewer consumes ENTIRELY locally — the
+ *  message never reaches the engine as prose, whether dispatched or blocked
+ *  with a notice (a remote-unsafe canvas/builtin command still returns
+ *  `true` from `dispatchSlashCommand` — swallowed with a notice, never
+ *  forwarded as prose — so it counts as consumed here too, independent of
+ *  `remote`). Exactly BUILTIN_NAMES ∪ CANVAS_NAMES ∪ SCOPED_OUT — every name
+ *  `dispatchSlashCommand` returns `true` for. Used ONLY for terminal
+ *  ref-decoration suppression (`input/titled-editor.ts`); never merged into
+ *  command completion, which is `slashCommandList` — a different,
+ *  remote-filtered, broker-augmented list. */
+export declare function locallyConsumedCommandNames(): ReadonlySet<string>;
+/** True if `text` is a leading-slash command (vs. a normal prompt). */
+export declare function isSlashCommand(text: string): boolean;
+/**
+ * Parse + dispatch a leading-slash command. Returns `true` if it was handled
+ * (a recognized builtin or a scoped-out notice) — the caller then clears the
+ * editor and sends nothing else. Returns `false` for an UNRECOGNIZED command,
+ * which the caller forwards to the engine as a `prompt` (extension command).
+ */
+export declare function dispatchSlashCommand(text: string, ctx: SlashContext): boolean;
+/** Build slash-command autocomplete entries from the merged command list (the
+ *  broker's `get_commands` result, which T7 may inject) — defaults to the
+ *  vendored builtins. The native canvas commands are always appended (minus the
+ *  remote-unsafe ones when `remote`). Shaped for pi-tui's `CombinedAutocompleteProvider`. */
+export declare function slashCommandList(commands: ReadonlyArray<{
+    name: string;
+    description?: string;
+}> | undefined, capabilities: ViewerCapabilities): SlashCommand[];
+/** Same list as flat autocomplete items (value/label/description). */
+export declare function commandAutocompleteItems(commands: ReadonlyArray<{
+    name: string;
+    description?: string;
+}> | undefined, capabilities: ViewerCapabilities): AutocompleteItem[];

package/dist/clients/attach/slash/dispatch.js

@@ -0,0 +1,2 @@
+var U=Object.defineProperty;var i=(t,e)=>U(t,"name",{value:e,configurable:!0});import{execFile as d}from"node:child_process";import{BUILTIN_SLASH_COMMANDS as h}from"../../../core/runtime/pi-vendored.js";import{surfaceTmuxStyleArgs as E}from"../../../core/runtime/surface-bg.js";import{crouterMenuTmuxArgs as L}from"../../../core/runtime/tmux-bindings.js";import{viewerOperationForSlash as $}from"../input/capabilities.js";import{shellQuote as y}from"../../../shared/shell-quote.js";const g=[{name:"tutorial",description:"The guided crouter tutorial \u2014 your agent teaches it, one lesson at a time"},{name:"menu",description:"Open the crouter action menu \u2014 the same menu as Alt+C, for when Option/Alt does not work in your terminal"},{name:"clear",description:"Clear the conversation and free context \u2014 a fresh, empty session (like /new)"},{name:"graph",description:"Toggle the canvas GRAPH view (your local subscription tree)"},{name:"inbox",description:"Toggle the human inbox \u2014 pending asks and reviews for you"},{name:"promote",description:"Promote this node to an orchestrator \u2014 /promote, or /promote <kind> to specialize"},{name:"resume",description:"Open the canvas navigator and swap THIS pane onto the chosen node; parked residents wake only on submitted input"},{name:"resume-session",description:"Switch this node onto one of its saved pi sessions \u2014 picker, or /resume-session <session-path>"},{name:"context",description:"Browse the files in this node\u2019s and its subscriptions\u2019 context dirs in a read-only nvim popup"},{name:"plugins",description:"Open the interactive plugin browser for this machine"},{name:"node-metadata",description:"Inspect this node \u2014 identity, lifecycle, runtime, graph, output, paths, and agent surfaces"},{name:"mcp",description:"MCP servers \u2014 status from the adapter\u2019s config/cache; Enter (or /mcp <server>) connects, reconnects, or re-auths"},{name:"rename",description:"Rename this node everywhere \u2014 node row, viewer window, session chip, tmux pane: /rename <name>"},{name:"color",description:"Color this node \u2014 tmux pane outline + name chip: /color <color> (red, blue, #rrggbb, \u2026) or /color none"},{name:"mouse",description:"Toggle mouse wheel scrolling and drag-select \u2014 off restores tmux drag-select and copy-mode mouse"},{name:"copy-message",description:"Copy the newest message visible in the transcript viewport"},{name:"copy-tool",description:"Copy the newest tool call output"},{name:"copy-transcript",description:"Copy every copyable transcript block"},{name:"fold-tools",description:"View setting \u2014 fold every FINISHED tool call to its single call line (Alt+C \u2192 z \u2192 f)"}],C=new Map([["resume-node","resume"]]),w=new Set([...g.map(t=>t.name),...C.keys()]),H=new Set(["black","red","green","yellow","blue","magenta","cyan","white","brightred","brightgreen","brightyellow","brightblue","brightmagenta","brightcyan","orange","grey","gray","default"]),_=new Set(["trust"]),M=new Set(Object.keys({off:!0,minimal:!0,low:!0,medium:!0,high:!0,xhigh:!0,max:!0})),v=new Set(h.map(t=>t.name));function b(t){return t.capabilities.nodeId}i(b,"nodeIdFor");function X(t){return t.capabilities.profileId}i(X,"profileIdFor");function N(t,e){const n=$(t,v.has(t),w.has(t));return n===void 0?void 0:e.capabilities.refusal(n,t)}i(N,"readOnlyRefusal");function ie(){return new Set([...v,...w,..._])}i(ie,"locallyConsumedCommandNames");function j(t){const e=/^\/(\S+)\s*([\s\S]*)$/.exec(t.trim());return e===null?void 0:{name:e[1],arg:e[2].trim()}}i(j,"parseSlashCommand");function se(t){return t.trimStart().startsWith("/")}i(se,"isSlashCommand");function ae(t,e){const n=j(t);if(n===void 0)return!1;const{arg:o}=n,r=C.get(n.name)??n.name;if(_.has(r))return e.notify(`/${r} is not supported in attach (Phase 4)`),!0;if(w.has(r)){const s=N(r,e);return s!==void 0?(e.notify(s),!0):B(r,o,e)}if(!v.has(r))return!1;const u=N(r,e);if(u!==void 0)return e.notify(u),!0;switch(r){case"new":return e.send({type:"new_session"}),!0;case"reload":return e.send({type:"reload"}),!0;case"compact":return e.send({type:"compact",instructions:o||void 0}),!0;case"quit":return e.onQuit?(e.onQuit(),!0):(e.send({type:"bye"}),e.notify("Detaching \u2014 the engine keeps running"),!0);case"name":return o?(e.send({type:"set_session_name",name:o}),!0):m(e,"/name <display name>");case"export":{const{path:s,format:a}=z(o,e.cwd??process.cwd());return e.send({type:"export",path:s,format:a}),e.notify(`Exporting session \u2192 ${s}`),!0}case"import":return o?(e.send({type:"switch_session",path:o}),!0):m(e,"/import <path-to-session.jsonl>");case"model":return o?(e.send({type:"set_model",model:o}),!0):f(e.openModelPicker,e,"model","/model <provider/id>");case"fork":return o?(e.send({type:"fork",entryId:o}),!0):f(e.openForkPicker,e,"fork point","/fork <entryId>");case"tree":return o?(e.send({type:"navigate_tree",targetId:o}),!0):f(e.openTreePicker,e,"tree","/tree <entryId>");case"scoped-models":return e.openScopedModelsPicker?(e.openScopedModelsPicker(),!0):(e.notify("The scoped-models view needs the read-op channel, which this viewer has not wired"),!0);case"settings":return Y(o,e);case"session":return e.notify(K(e.state)),!0;case"copy":return e.onCopy?(e.onCopy(),!0):(e.notify("/copy is not available in this viewer"),!0);case"login":return e.openLoginPicker?(e.openLoginPicker(),!0):(e.notify("/login is not available in this viewer"),!0);case"logout":return e.openLogoutPicker?(e.openLogoutPicker(),!0):(e.notify("/logout is not available in this viewer"),!0);case"share":return e.send({type:"share"}),e.notify("Sharing session\u2026"),!0;case"clone":return e.send({type:"clone"}),e.notify("Cloning session\u2026"),!0;case"changelog":return e.notify("/changelog: see https://github.com/earendil-works/pi for release notes (no bundled changelog in this build)"),!0;case"hotkeys":return e.onHelp?(e.onHelp(),!0):(e.notify("/hotkeys is not available in this viewer"),!0);default:return e.notify(`/${r} is not available in attach (Phase 4)`),!0}}i(ae,"dispatchSlashCommand");function P(t,e){const n=i(a=>{const l=$(a,!1,!0);return l===void 0||e.permits(l)},"permitted"),o=g.filter(a=>n(a.name)),r=new Map(g.map(a=>[a.name,a])),u=t.flatMap(a=>{const l=r.get(a.name);return l===void 0?[a]:n(a.name)?[l]:[]}),s=new Set(t.map(a=>a.name));return[...u,...o.filter(a=>!s.has(a.name))]}i(P,"withCanvasCommands");function ue(t,e){return P(t??h,e).map(n=>({name:n.name,description:n.description}))}i(ue,"slashCommandList");function le(t,e){return P(t??h,e).map(n=>({value:`/${n.name}`,label:`/${n.name}`,description:n.description}))}i(le,"commandAutocompleteItems");function B(t,e,n){switch(t){case"clear":return n.send({type:"new_session"}),!0;case"graph":return n.onGraph?n.onGraph():n.notify("The GRAPH overlay is not wired into the viewer yet"),!0;case"inbox":return n.onInbox?n.onInbox():n.notify("The inbox surface is not wired into the viewer yet"),!0;case"menu":return q(n);case"tutorial":return n.send({type:"prompt",text:"The user asked for the crouter tutorial. Run `crtr sys tutorial -h`, pick the track that matches what they want to learn, and teach it one lesson per invocation \u2014 in your own words, letting them try each thing before you move on."}),!0;case"promote":return F(e,n),!0;case"resume":return e?m(n,"/resume \u2014 no argument; use /resume-session <path> to switch pi sessions"):V(n);case"resume-session":return e?(n.send({type:"switch_session",path:e}),!0):f(n.openSessionPicker,n,"session","/resume-session <session-path>");case"mcp":return n.openMcpPicker?n.openMcpPicker(e||void 0):n.notify("The MCP panel is not wired into this viewer"),!0;case"context":return J(n);case"plugins":return Q(n);case"node-metadata":return n.onNodeMetadata?n.onNodeMetadata():n.notify("Node metadata is not wired into this viewer"),!0;case"rename":return R(e,n),!0;case"color":return G(e,n);case"fold-tools":return n.onFoldTools?n.onFoldTools():n.notify("The fold-tools view setting is not wired into this viewer"),!0;case"mouse":return n.onToggleMouse?n.onToggleMouse():n.notify("Mouse reporting is not wired into this viewer"),!0;case"copy-message":return n.onCopyTarget?n.onCopyTarget("message"):n.notify("/copy-message is not available in this viewer"),!0;case"copy-tool":return n.onCopyTarget?n.onCopyTarget("tool"):n.notify("/copy-tool is not available in this viewer"),!0;case"copy-transcript":return n.onCopyTarget?n.onCopyTarget("transcript"):n.notify("/copy-transcript is not available in this viewer"),!0;default:return n.notify(`/${t} is not available in attach`),!0}}i(B,"dispatchCanvasCommand");function F(t,e){const n=b(e).trim();if(n===""){e.notify("/promote: no node to promote (viewer has no node id)");return}const o=t.trim().toLowerCase();e.notify(o?`Promoting \u2192 ${o}\u2026`:"Promoting\u2026");const r=["node","promote","--node",n,"--json"];o!==""&&r.push("--kind",o),d("crtr",r,{timeout:15e3,maxBuffer:4*1024*1024},(s,a)=>{let l=null,p=null;try{l=JSON.parse(a)}catch{l=null}if(s&&l===null){const O=typeof s.stdout=="string"?s.stdout:"";try{const T=JSON.parse(O);p=typeof T.message=="string"?T.message:null}catch{p=null}p===null&&(p=s.message)}if(l===null){e.notify(`promote failed: ${p??"unknown error"}`);return}const S=(l.roadmap_ref??"").trim();e.notify(`Promoted to ${l.kind??"orchestrator"} orchestrator \u2014 authoring roadmap${S!==""?` (${S})`:""}.`),e.send({type:"prompt",text:"You have just been promoted to an orchestrator. Your new-role guidance is arriving \u2014 read it, author your roadmap, and start delegating."})}).stdin?.end()}i(F,"promoteNode");function R(t,e){const n=b(e).trim();if(n===""){e.notify("/rename: no node to rename (viewer has no node id)");return}if(t===""){e.notify("Usage: /rename <name>");return}e.send({type:"set_session_name",name:t});const o=process.env.TMUX_PANE;process.env.TMUX!==void 0&&o!==void 0&&o!==""&&d("tmux",["select-pane","-t",o,"-T",t],()=>{}),d("crtr",["node","config","--node",n,"--name",t,"--json"],{timeout:15e3,maxBuffer:4*1024*1024},(r,u)=>{if(r){let s=null;try{const a=JSON.parse(u);s=typeof a.message=="string"?a.message:null}catch{s=null}e.notify(`rename failed: ${s??r.message}`);return}e.notify(`Renamed node \u2192 ${t}`)})}i(R,"renameNode");function c(t){return new Promise(e=>{d("tmux",t,{timeout:5e3},(n,o)=>e(n?"":o))})}i(c,"tmuxCall");async function D(t,e,n){if(n){await c(["set-option","-p","-u","-t",t,"@crtr_color"]);return}await c(["set-option","-p","-t",t,"@crtr_color",e]);for(const o of["pane-border-style","pane-active-border-style"]){const r=(await c(["show-options","-wqv","-t",t,o])).trim();if(r.includes("@crtr_color"))continue;let u=r!==""?r:(await c(["show-options","-gqv",o])).trim();u===""&&(u=o==="pane-active-border-style"?"fg=green":"default");const s=`#{?#{!=:#{@crtr_color},},fg=#{@crtr_color},${u.replace(/,/g,"#,")}}`;await c(["set-option","-w","-t",t,o,s])}}i(D,"paintPaneBorder");function G(t,e){const n=t.trim().toLowerCase();if(n==="")return e.notify("Usage: /color <color> \u2014 a name (red, blue, orange\u2026), colourN, or #rrggbb; /color none to clear"),!0;const o=n==="none"||n==="clear";if(!(o||H.has(n)||/^colour\d{1,3}$/.test(n)||/^#[0-9a-f]{6}$/.test(n)))return e.notify(`Invalid color "${n}" \u2014 use a tmux colour name (${["red","green","yellow","blue","magenta","cyan","orange"].join(", ")}, \u2026), colourN, or #rrggbb`),!0;const u=process.env.TMUX_PANE,s=process.env.TMUX!==void 0&&u!==void 0&&u!=="";return s&&D(u,n,o),e.onColor?.(o?null:n),e.notify(o?"Node color cleared":`Node colored ${n}${s?"":" (chip only \u2014 no tmux pane)"}`),!0}i(G,"colorNode");function V(t){const e=process.env.TMUX_PANE;if(process.env.TMUX===void 0||e===void 0||e==="")return t.notify("/resume needs tmux"),!0;const n=y(t.cwd??process.cwd()),o=X(t),r=o===void 0||o===""?"":` --profile-id ${y(o)}`,u=`crtr canvas browse --return-pane ${e} --cwd ${n}${r}`;return k(u,{w:"97%",h:"95%"}),!0}i(V,"resumeNode");function q(t){const e=process.env.TMUX_PANE;if(process.env.TMUX===void 0||e===void 0||e==="")return t.notify("/menu needs tmux \u2014 the crouter action menu is a tmux menu"),!0;try{d("tmux",["display-menu","-t",e,...L().slice(1)],n=>{n&&t.notify(`/menu failed: ${n.message.split(`
+`)[0]}`)})}catch(n){t.notify(`/menu failed: ${n.message}`)}return!0}i(q,"openActionMenu");function J(t){if(process.env.TMUX===void 0)return t.notify("/context needs tmux"),!0;const e=b(t).trim();return e===""?(t.notify("/context: no node to root on (viewer has no node id)"),!0):(k(`crtr node inspect context --node ${y(e)}`),!0)}i(J,"openContext");function Q(t){return process.env.TMUX===void 0?(t.notify("/plugins needs tmux"),!0):(k("crtr pkg browse"),!0)}i(Q,"openPlugins");function k(t,e={w:"90%",h:"85%"}){try{d("tmux",["display-popup","-E","-w",e.w,"-h",e.h,...E(),t],()=>{})}catch{}}i(k,"popup");function m(t,e){return t.notify(`Usage: ${e}`),!0}i(m,"usage");function W(t,e,n){return t.notify(`Interactive ${e} picker isn't available over view.sock yet \u2014 use ${n}`),!0}i(W,"pickerHint");function f(t,e,n,o){return t?(t(),!0):W(e,n,o)}i(f,"openOrHint");function Y(t,e){const[n,...o]=t.split(/\s+/),r=o.join(" ").trim();switch(n){case"thinking":return r?M.has(r)?(e.send({type:"set_thinking_level",level:r}),!0):(e.notify(`Invalid thinking level "${r}" \u2014 choose one of: ${[...M].join(", ")}`),!0):m(e,"/settings thinking <level>");case"auto-retry":return e.send({type:"set_auto_retry",enabled:A(r)}),!0;case"auto-compaction":return e.send({type:"set_auto_compaction",enabled:A(r)}),!0;case"":return e.openSettingsPicker?(e.openSettingsPicker(),!0):I(e);default:return I(e)}}i(Y,"handleSettings");function I(t){return t.notify("Settings: /settings thinking <level> | auto-retry on|off | auto-compaction on|off"),!0}i(I,"settingsSummary");function A(t){return/^(on|true|yes|1|enabled?)$/i.test(t.trim())}i(A,"parseBool");function z(t,e){const n=t||`${e}/pi-export-${Date.now()}.html`,o=n.endsWith(".jsonl")?"jsonl":"html";return{path:n,format:o}}i(z,"parseExport");function K(t){return t?`Session ${t.sessionName?`"${t.sessionName}" `:""}${t.sessionId} \xB7 model ${t.model?.id??"unknown"} \xB7 thinking ${t.thinkingLevel}`:"Session info unavailable"}i(K,"describeSession");export{g as CANVAS_SLASH_COMMANDS,le as commandAutocompleteItems,ae as dispatchSlashCommand,se as isSlashCommand,ie as locallyConsumedCommandNames,ue as slashCommandList};

package/dist/clients/attach/slash/prompt-preview.d.ts

@@ -0,0 +1,30 @@
+import { type DeterministicCommandExpansion } from '../../../core/runtime/command-expansion.js';
+export interface PreviewableCommand {
+    name: string;
+    description?: string;
+    source?: string;
+    template?: string;
+    /** Present only when an extension command's submission handler sends a
+     * deterministic expanded user prompt. Immediate UI/dynamic commands omit it. */
+    expansion?: DeterministicCommandExpansion;
+}
+export interface LoadedCommandPreview {
+    name: string;
+    invocation: string;
+    content: string;
+}
+/** Parse an untrusted broker command inventory. Bad entries are discarded so a
+ * malformed extension registration cannot take down autocomplete or preview. */
+export declare function parsePreviewableCommands(detail: string): PreviewableCommand[];
+/** Parse prompt-template arguments exactly as pi does: whitespace separates
+ * arguments except inside matching single or double quotes. */
+export declare function parseCommandArgs(argsString: string): string[];
+/** Expand pi's prompt-template placeholders without recursively expanding text
+ * supplied by the user. Kept byte-compatible with pi's prompt expansion. */
+export declare function substitutePromptArgs(content: string, args: string[]): string;
+/** Resolve the leading slash token in the live editor. Viewer builtins run
+ * first, followed by extension commands and then pi prompt templates. Extension
+ * matching deliberately uses only ASCII space: pi's `_tryExecuteExtensionCommand`
+ * treats tabs and newlines as part of the command name, while template matching
+ * accepts all whitespace. */
+export declare function loadedCommandPreview(editorText: string, commands: ReadonlyArray<PreviewableCommand>): LoadedCommandPreview | undefined;

package/dist/clients/attach/slash/prompt-preview.js

@@ -0,0 +1 @@
+var m=Object.defineProperty;var a=(r,n)=>m(r,"name",{value:n,configurable:!0});import{expandDeterministicCommand as l,isDeterministicCommandExpansion as c}from"../../../core/runtime/command-expansion.js";function b(r){try{const n=JSON.parse(r);return Array.isArray(n)?n.flatMap(t=>{if(typeof t!="object"||t===null||Array.isArray(t))return[];const e=t;return typeof e.name!="string"||typeof e.description!="string"||typeof e.source!="string"?[]:e.source!=="builtin"&&e.source!=="command"&&e.source!=="template"?[]:e.template!==void 0&&typeof e.template!="string"?[]:e.expansion!==void 0&&!c(e.expansion)?[]:[{name:e.name,description:e.description,source:e.source,...typeof e.template=="string"?{template:e.template}:{},...c(e.expansion)?{expansion:e.expansion}:{}}]}):[]}catch{return[]}}a(b,"parsePreviewableCommands");function d(r){const n=[];let t="",e=null;for(const i of r)e!==null?i===e?e=null:t+=i:i==='"'||i==="'"?e=i:/\s/.test(i)?t!==""&&(n.push(t),t=""):t+=i;return t!==""&&n.push(t),n}a(d,"parseCommandArgs");function x(r,n){const t=n.join(" ");return r.replace(/\$\{(\d+):-([^}]*)\}|\$\{@:(\d+)(?::(\d+))?\}|\$(ARGUMENTS|@|\d+)/g,(e,i,p,o,u,s)=>{if(i!==void 0)return n[Number.parseInt(i,10)-1]||p||"";if(o!==void 0){const f=Math.max(0,Number.parseInt(o,10)-1);return u!==void 0?n.slice(f,f+Number.parseInt(u,10)).join(" "):n.slice(f).join(" ")}return s==="ARGUMENTS"||s==="@"?t:n[Number.parseInt(s||"0",10)-1]??""})}a(x,"substitutePromptArgs");function N(r,n){const t=r.match(/^\/([^\s]+)(?:\s+([\s\S]*))?$/);if(t===null)return;const e=t[1];if(n.some(s=>s.source==="builtin"&&s.name===e))return;const i=r.indexOf(" "),p=i===-1?r.slice(1):r.slice(1,i),o=n.find(s=>s.source==="command"&&s.name===p);if(o!==void 0){if(o.expansion===void 0||!c(o.expansion))return;const s=i===-1?"":r.slice(i+1);return{name:o.name,invocation:r,content:l(o.expansion,s)}}const u=n.find(s=>s.source==="template"&&s.name===e);if(typeof u?.template=="string")return{name:u.name,invocation:r,content:x(u.template,d(t[2]??""))}}a(N,"loadedCommandPreview");export{N as loadedCommandPreview,d as parseCommandArgs,b as parsePreviewableCommands,x as substitutePromptArgs};

package/dist/clients/attach/viewer.d.ts

@@ -0,0 +1,8 @@
+import './session/pi-assets.js';
+import './session/pi-oauth-flows.js';
+/** Run the interactive attach session against `nodeId`. Resolves when the
+ *  viewer detaches (ctrl+c/ctrl+d), the broker goes away, or a signal lands —
+ *  always restoring the terminal first. `canvasName`, when set, attaches over
+ *  a relayed WebSocket to that `remoteCanvas.targets.<name>` instead of the
+ *  local unix socket — see the `--canvas` flag on `attachToLeaf`. */
+export declare function runAttach(nodeId: string, observer: boolean, canvasName?: string, wakeParked?: boolean): Promise<void>;