@north-light/cli 0.0.0-stage → 0.3.413

package/dist/clients/attach/render/tool-calls.js

@@ -0,0 +1,3 @@
+var _=Object.defineProperty;var l=(t,e)=>_(t,"name",{value:e,configurable:!0});import{createBashToolDefinition as B,createReadToolDefinition as F,createWriteToolDefinition as S}from"@earendil-works/pi-coding-agent";import{Text as A,getCapabilities as E,hyperlink as H,truncateToWidth as m,visibleWidth as g,wrapTextWithAnsi as M}from"@earendil-works/pi-tui";import{homedir as j}from"node:os";import{isAbsolute as I,resolve as N}from"node:path";import{pathToFileURL as z}from"node:url";import{normalizeBashJobPurpose as P}from"../../../core/bash-jobs.js";import{TOOL_ICON as x}from"../../../core/preview-registry.js";import{stripCdPrefix as U}from"../../../shared/strip-cd-prefix.js";function C(t){return typeof t=="string"?t:""}l(C,"str");const G=5e3;function J(t,e,n,i){if(e===void 0||Date.now()-e<G)return[];const s=n?.()??null;return s===null?[]:[m(`  ${t.fg("muted",`\u29D7 ${s}`)}`,i,"\u2026")]}l(J,"backgroundHintLines");class b{static{l(this,"FoldedToolCallController")}folded=!1;component;setFolded(e){this.folded=e}capture(e){return this.component=e,e}callComponent(){return this.component}}function K(t){return t.length===0?0:(t.match(/\n/g)?.length??0)+(t.endsWith(`
+`)?0:1)}l(K,"countFileLines");function k(t,e){if(!t)return"";const n=[];return t.added>0&&n.push(e.fg("toolDiffAdded",`+${t.added}`)),t.removed>0&&n.push(e.fg("toolDiffRemoved",`-${t.removed}`)),n.length>0?` ${n.join(" ")}`:""}l(k,"lineChangesDisplay");function q(t,e){return t===void 0?"":` ${e.fg("toolDiffAdded",`+${t}`)}`}l(q,"lineCountDisplay");function Q(t,e,n,i,s){return`${O(x[t],t,n)} ${D(e,n,i)}${k(s,n)}`}l(Q,"foldedFileCallLine");function V(t){const e=j();return t.startsWith(e)?`~${t.slice(e.length)}`:t}l(V,"shortenPath");function D(t,e,n){if(!t)return e.fg("toolOutput","...");const i=V(t);if(!E().hyperlinks)return i;const s=I(t)?t:N(n,t);return H(i,z(s).href)}l(D,"pathDisplay");function O(t,e,n){return`${n.fg("accent",t)} ${n.fg("toolTitle",n.bold(e))}`}l(O,"header");class X{static{l(this,"IconPrefixedToolCall")}child;prefix;constructor(e,n){this.child=e,this.prefix=n}update(e,n){this.child=e,this.prefix=n}invalidate(){this.child.invalidate()}render(e){const n=g(this.prefix),i=this.child.render(Math.max(1,e-n));return i.length===0?[m(this.prefix.trimEnd(),e,"")]:i.map((s,r)=>r===0?m(`${this.prefix}${s}`,e,""):s)}}function le(t,e=new b){const n=F(t);return{name:"read",label:"read",description:"Render read calls with a crtr icon header in the attach viewer.",parameters:{},renderCall(i,s,r){const o=i,d=C(o?.file_path??o?.path);let a="";if(o?.offset!==void 0||o?.limit!==void 0){const h=typeof o?.offset=="number"?o.offset:1,c=typeof o?.limit=="number"?h+o.limit-1:void 0;a=s.fg("warning",`:${h}${c!==void 0?`-${c}`:""}`)}const u=`${O(x.read,"read",s)} ${D(d,s,r.cwd??t)}${a}`,f=r.lastComponent??new A("",0,0);return f.setText(u),e.capture(f)},renderResult(i,s,r,o){return n.renderResult(i,s,r,o)}}}l(le,"createCrtrReadToolDefinition");function ue(t,e=new b){const n=S(t);let i,s;return{name:"write",label:"write",description:"Render write calls with a crtr icon header in the attach viewer.",parameters:{},renderCall(r,o,d){if(e.folded){const u=r,f=d.isError?void 0:K(C(u?.content)),h=Q("write",C(u?.file_path??u?.path),o,d.cwd??t)+q(f,o);return e.capture(new A(h,0,0))}i=n.renderCall(r,o,{...d,lastComponent:i});const a=`${o.fg("accent",x.write)} `;return s?s.update(i,a):s=new X(i,a),e.capture(s)},renderResult(r,o,d,a){return n.renderResult(r,o,d,a)}}}l(ue,"createCrtrWriteToolDefinition");const Y=/^(&&|\|\||\||;|>>|>|<|2>&1|&)$/;function Z(t){return t.match(/"(?:[^"\\]|\\.)*"|'(?:[^'\\]|\\.)*'|\S+/g)??[]}l(Z,"tokenize");function v(t,e){const n=Z(t);let i=!0;return n.map(r=>Y.test(r)?(i=!0,e.fg("syntaxOperator",r)):i&&!r.includes("=")?(i=!1,e.fg("syntaxFunction",e.bold(r))):(i=!1,r.startsWith("-")?e.fg("muted",r):/^["']/.test(r)?e.fg("syntaxString",r):e.fg("toolOutput",r))).join(" ")}l(v,"styleCommandLine");class y{static{l(this,"BashCallComponent")}command="";purpose;expanded=!1;folded=!1;timeout;theme;startedAt;hint;invalidate(){}update(e,n,i,s,r,o,d,a){this.theme=e,this.command=n,this.purpose=i,this.expanded=s,this.folded=r,this.timeout=o,this.startedAt=d,this.hint=a}backgroundHintLines(e){const n=this.theme;return n===void 0?[]:J(n,this.startedAt,this.hint,e)}render(e){const n=this.theme;if(!n)return[];const i=n.fg("accent",x.bash);if(this.purpose!==void 0)return[m(`${i} ${n.fg("toolOutput",this.purpose)}`,e,"\u2026")];const s=this.command.split(`
+`).map(c=>c.trim()).filter(c=>c.length>0),r=this.folded?s.map(U):s,o=this.timeout?n.fg("muted",` (timeout ${this.timeout}s)`):"";if(r.length===0)return[`${i} ${n.fg("toolOutput","...")}`];if(this.expanded){const c=g(`${i} `),W=" ".repeat(c),L=Math.max(1,e-c),R=[];for(let p=0;p<r.length;p++){let T=v(r[p],n);p===r.length-1&&(T+=o);const w=M(T,L);for(let $=0;$<w.length;$++)R.push(`${p===0&&$===0?`${i} `:W}${w[$]}`)}return R.map(p=>m(p,e,""))}const d=r.length>1?n.fg("muted",` +${r.length-1} lines`):"",a=g(`${i} `)+g(d)+g(o),u=Math.max(8,e-a),f=r[0],h=f.length>u?`${f.slice(0,Math.max(1,u-1))}\u2026`:f;return[m(`${i} ${v(h,n)}${d}${o}`,e)]}}function fe(t,e){return t instanceof y?t.backgroundHintLines(e):[]}l(fe,"bashCallBackgroundHintLines");function ce(t,e=new b,n){const i=B(t);return{name:"bash",label:"bash",description:"Render plain bash calls as a compact styled command line in the attach viewer.",parameters:{},renderCall(s,r,o){const d=s,a=o.state;a&&o.executionStarted&&a.startedAt===void 0&&(a.startedAt=Date.now(),a.endedAt=void 0);const u=o.lastComponent instanceof y?o.lastComponent:new y,f=a?.startedAt!==void 0&&a.endedAt===void 0;return u.update(r,C(d?.command),e.folded?P(d?.purpose)??void 0:void 0,!!o.expanded&&!e.folded,e.folded,typeof d?.timeout=="number"?d.timeout:void 0,f?a?.startedAt:void 0,n),e.capture(u)},renderResult(s,r,o,d){return i.renderResult(s,r,o,d)}}}l(ce,"createCrtrPlainBashToolDefinition");export{b as FoldedToolCallController,fe as bashCallBackgroundHintLines,ce as createCrtrPlainBashToolDefinition,le as createCrtrReadToolDefinition,ue as createCrtrWriteToolDefinition,Q as foldedFileCallLine};

package/dist/clients/attach/render/transcript-copy.d.ts

@@ -0,0 +1,9 @@
+import type { ChatView } from './chat-view.js';
+import type { ViewportSource } from './measured-container.js';
+import type { TranscriptViewport } from './viewport.js';
+export type CopyTarget = 'message' | 'last-assistant' | 'tool' | 'transcript';
+export interface TranscriptCopy {
+    /** Copy `target`; returns the status-region confirmation to show. */
+    copy(target: CopyTarget): string;
+}
+export declare function createTranscriptCopy(chat: ChatView, viewport: TranscriptViewport, source: ViewportSource): TranscriptCopy;

package/dist/clients/attach/render/transcript-copy.js

@@ -0,0 +1,2 @@
+var p=Object.defineProperty;var a=(t,s)=>p(t,"name",{value:s,configurable:!0});import{writeClipboardTextEverywhere as b}from"../../../core/clipboard-text.js";function l(t){return t!==void 0&&t.trim()!==""}a(l,"hasText");function d(t){return t.split(`
+`).length}a(d,"lineCount");function x(t,s){if(t&&s)return"clipboard + tmux buffer";if(t)return"clipboard";if(s)return"tmux buffer"}a(x,"copiedTo");function g(t,s,f){const{first:c,last:e,lastFullyVisible:r}=s.visibleBlocks(),u=a(n=>{const o=f.blockAt(n);return o?t.blockText(o):void 0},"textAt");for(let n=Math.min(e,r);n>=c;n--){const o=u(n);if(l(o))return o}for(let n=e;n>=c;n--){const o=u(n);if(l(o))return o}}a(g,"visibleMessageText");function T(t,s,f){return{copy(c){let e,r;switch(c){case"message":{const i=g(t,s,f);l(i)&&(e={text:i,label:"message"}),r="Nothing to copy \u2014 no visible message";break}case"last-assistant":{const i=t.getLastAssistantText();l(i)&&(e={text:i,label:"last assistant message"}),r="Nothing to copy \u2014 no assistant message yet";break}case"tool":{const i=t.getLastToolOutputText();l(i)&&(e={text:i,label:"tool output"}),r="Nothing to copy \u2014 no tool output yet";break}case"transcript":{const i=t.getTranscriptPlainText();l(i)&&(e={text:i,label:"transcript"}),r="Nothing to copy \u2014 transcript is empty";break}}if(!e)return r;const{system:u,tmux:n}=b(e.text),o=x(u,n);return o?`Copied ${e.label} (${d(e.text)} lines) \u2014 ${o}`:"Copy failed \u2014 no clipboard tool found"}}}a(T,"createTranscriptCopy");export{T as createTranscriptCopy};

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

@@ -0,0 +1,28 @@
+import type { ViewportSource } from './measured-container.js';
+/** One hit: an absolute content line and the cells it covers on that line. */
+export interface SearchMatch {
+    line: number;
+    from: number;
+    to: number;
+}
+export interface TranscriptSearchModel {
+    /** Replace the query; matches and the current hit are recomputed lazily. */
+    setQuery(query: string, near: number | undefined): void;
+    query(): string;
+    /** Every hit, oldest to newest, against the current content. */
+    matches(width: number): readonly SearchMatch[];
+    /** The selected hit, or undefined when the query finds nothing. */
+    current(width: number): SearchMatch | undefined;
+    /** Number of hits and the 1-indexed position of the selected one. */
+    status(width: number): {
+        index: number;
+        total: number;
+    };
+    /** Step the selection; wraps at both ends. Returns the new selection. */
+    step(width: number, direction: 1 | -1): SearchMatch | undefined;
+    /** Re-select the first hit at or after `line`, else the last one. */
+    selectNear(width: number, line: number): SearchMatch | undefined;
+    /** Paint hits onto one rendered transcript row. Identity without a query. */
+    decorate(line: number, rendered: string, width: number): string;
+}
+export declare function createTranscriptSearchModel(source: ViewportSource): TranscriptSearchModel;

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

@@ -0,0 +1 @@
+var k=Object.defineProperty;var g=(o,c)=>k(o,"name",{value:c,configurable:!0});import{styleCells as C,walkRow as M}from"../ansi-cells.js";const w={on:"\x1B[107m\x1B[30m",off:"",restore:!0},y={on:"\x1B[48;5;214m\x1B[30m",off:"",restore:!0};function S(o){let c="";const s=[],x=M(o,{onGlyph:g(d=>{for(let f=0;f<d.text.length;f++)s.push(d.cell);c+=d.text},"onGlyph")});return{text:c,cells:s,width:x}}g(S,"plainRow");function T(o){return o!==o.toLowerCase()}g(T,"caseSensitive");function E(o,c,s,x,d){const f=s?o.text:o.text.toLowerCase(),u=s?c:c.toLowerCase();let r=f.indexOf(u);for(;r!==-1;){const t=r+u.length,n=o.cells[r]??0,e=t<o.cells.length?o.cells[t]:o.width;e>n&&d.push({line:x,from:n,to:e}),r=f.indexOf(u,r+Math.max(1,u.length))}}g(E,"rowMatches");function $(o){let c="",s=0,x=[],d=new Map,f,u;function r(t){const n=`${t}:${o.revision()}:${c}`;if(f===n)return x;const e=[];if(c!==""){const l=T(c),a=o.blockCount();for(let i=0;i<a;i++){const m=o.blockStart(i,t),p=o.blockLines(i,t);for(let b=0;b<p.length;b++){const L=p[b];L.toLowerCase().includes(c.toLowerCase())&&E(S(L),c,l,m+b,e)}}}const h=new Map;for(const l of e){const a=h.get(l.line);a?a.push(l):h.set(l.line,[l])}if(x=e,d=h,f=n,u!==void 0){const l=u;u=void 0;const a=e.findIndex(i=>i.line>=l);s=a===-1?Math.max(0,e.length-1):a}else s>=e.length&&(s=Math.max(0,e.length-1));return x}return g(r,"ensure"),{setQuery(t,n){t!==c&&(c=t,u=n,f=void 0)},query(){return c},matches(t){return r(t)},current(t){return r(t)[s]},status(t){const n=r(t);return{index:n.length===0?0:s+1,total:n.length}},step(t,n){const e=r(t);if(e.length!==0)return s=(s+n+e.length)%e.length,e[s]},selectNear(t,n){const e=r(t);if(e.length===0)return;const h=e.findIndex(l=>l.line>=n);return s=h===-1?e.length-1:h,e[s]},decorate(t,n,e){if(c==="")return n;const h=r(e),l=d.get(t);if(l===void 0)return n;const a=h[s];let i=n;for(const m of l)i=C(i,m.from,m.to,e,m===a?y:w);return i}}}g($,"createTranscriptSearchModel");export{$ as createTranscriptSearchModel};

package/dist/clients/attach/render/viewport.d.ts

@@ -0,0 +1,38 @@
+import type { ViewportSource } from './measured-container.js';
+/** The flat block range occupied by the most recently rendered viewport. */
+type VisibleBlocks = {
+    first: number;
+    last: number;
+    lastFullyVisible: number;
+};
+/**
+ * A virtualized, identity-anchored transcript viewport. It owns only scroll
+ * state; all measurement and line caching remain with its ViewportSource.
+ */
+export interface TranscriptViewport {
+    /** Exactly `rows` lines, bottom-aligned and top-padded with empty rows. */
+    renderSlice(width: number, rows: number): string[];
+    /** Scroll by `lines` (negative = toward older content). */
+    scrollBy(lines: number): boolean;
+    /** Lines in one page jump — the viewport height less one overlap row. */
+    pageRows(): number;
+    /** Pin back to the live bottom. */
+    goLive(): void;
+    /** Bring absolute content `line` into view, seated a third of the way down
+     *  so the context around it reads. */
+    scrollToLine(line: number): void;
+    /** Absolute content line at the viewport's top row, or undefined before the
+     *  first render. */
+    topLine(): number | undefined;
+    /** True while the viewport is pinned to the bottom. */
+    isLive(): boolean;
+    /** Flat blocks intersecting the visible slice and its last whole block. */
+    visibleBlocks(): VisibleBlocks;
+    /** Forward frame invalidation without exposing the source to the frame. */
+    invalidate(): void;
+}
+/** Restyle one rendered transcript row, addressed by its absolute content
+ *  line — how transcript search paints its hits. */
+export type RowDecorator = (line: number, rendered: string, width: number) => string;
+export declare function createTranscriptViewport(source: ViewportSource, decorate?: RowDecorator): TranscriptViewport;
+export {};

package/dist/clients/attach/render/viewport.js

@@ -0,0 +1 @@
+var B=Object.defineProperty;var k=(n,u)=>B(n,"name",{value:u,configurable:!0});const C="\x1B[2m\u2338 image \u2014 scroll to view\x1B[22m",M={first:-1,last:-1,lastFullyVisible:-1};function I(n){return n.some(u=>u.includes("\x1B_G")||u.includes("\x1B]1337;File="))}k(I,"isInlineImageBlock");function R(n,u,t){let l=0,a=n.blockCount();for(;l<a;){const h=Math.floor((l+a)/2);n.blockStart(h,t)+n.blockHeight(h,t)>u?a=h:l=h+1}return l}k(R,"firstBlockAfter");function _(n,u){const t={follow:!0,anchor:void 0};let l,a=0,h=M,g;function v(o,c,i){const e=Math.max(0,i-c);if(t.follow)return e;if(!t.anchor)return t.follow=!0,e;const s=n.anchorLine(t.anchor,o);return s===void 0?(t.follow=!0,t.anchor=void 0,e):Math.min(Math.max(0,s),e)}k(v,"resolveTop");function y(o,c,i,e){const s=Math.min(i,e+c);if(e>=s)return{top:e,bottom:s,total:i,blocks:M};const f=n.blockCount();let r=R(n,e,o),p=-1,d=-1,b=-1;for(;r<f;){const m=n.blockStart(r,o);if(m>=s)break;const w=n.blockHeight(r,o),x=m+w;x>e&&(p===-1&&(p=r),d=r,m>=e&&x<=s&&(b=r)),r++}return{top:e,bottom:s,total:i,blocks:p===-1?M:{first:p,last:d,lastFullyVisible:b}}}k(y,"visibleRange");function A(){if(l===void 0||a<=0)return;const o=n.totalHeight(l),c=v(l,a,o);return y(l,a,o,c)}return k(A,"currentSlice"),{renderSlice(o,c){const i=Math.max(0,c);if(l=o,a=i,i===0)return h=M,g=n.revision(),[];const e=n.totalHeight(o),s=v(o,i,e),f=y(o,i,e,s),r=[];for(let d=f.blocks.first;d!==-1&&d<=f.blocks.last;d++){const b=n.blockStart(d,o),m=n.blockLines(d,o),w=n.blockHeight(d,o),x=b+w,L=Math.max(0,f.top-b),H=Math.min(w,f.bottom-b);if(L>=H)continue;if((b<f.top||x>f.bottom)&&I(m))r.push(...Array(H-L).fill(C));else if(u===void 0)r.push(...m.slice(L,H));else for(let S=L;S<H;S++)r.push(u(b+S,m[S],o))}const p=r.length>=i?r.slice(0,i):[...Array(i-r.length).fill(""),...r];return h=f.blocks,g=n.revision(),p},scrollBy(o){if(l===void 0||a<=0||o===0)return!1;const c=t.follow,i=t.anchor,e=n.totalHeight(l),s=v(l,a,e),f=Math.max(0,e-a),r=Math.min(Math.max(0,s+o),f);return r>=f?(t.follow=!0,t.anchor=void 0):(t.follow=!1,t.anchor=n.anchorAt(r,l),t.anchor||(t.follow=!0)),t.follow!==c||t.anchor!==i},pageRows(){return Math.max(0,a-1)},goLive(){t.follow=!0,t.anchor=void 0},scrollToLine(o){if(l===void 0||a<=0)return;const c=n.totalHeight(l),i=Math.max(0,c-a),e=Math.min(Math.max(0,o-Math.floor(a/3)),i);if(e>=i){t.follow=!0,t.anchor=void 0;return}t.follow=!1,t.anchor=n.anchorAt(e,l),t.anchor||(t.follow=!0)},topLine(){if(!(l===void 0||a<=0))return v(l,a,n.totalHeight(l))},isLive(){return t.follow},visibleBlocks(){const o=n.revision();return g===o||(h=A()?.blocks??M,g=o),h},invalidate(){n.invalidate()}}}k(_,"createTranscriptViewport");export{_ as createTranscriptViewport};

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

@@ -0,0 +1,13 @@
+export interface BannerInfo {
+    version?: string;
+    profile?: string;
+    cwd?: string;
+    hint?: string;
+}
+/** Shown only when crouter itself started tmux for this person (the front door's
+ *  tmux handoff sets the env var), since only then can they not know the keys. */
+export declare const TMUX_SURVIVAL_HINT = "Ctrl+B d leaves \u2014 the agent keeps running \u00B7 Ctrl+B n / p switches windows";
+export declare function buildBannerInfo(meta: {
+    cwd?: string;
+    profile_id?: string | null;
+}): BannerInfo;

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

@@ -0,0 +1 @@
+var f=Object.defineProperty;var s=(i,n)=>f(i,"name",{value:n,configurable:!0});import{homedir as l}from"node:os";import{loadProfileManifest as c}from"../../../core/profiles/manifest.js";import{currentVersion as d}from"../../../core/self-update.js";const p="Ctrl+B d leaves \u2014 the agent keeps running \xB7 Ctrl+B n / p switches windows";function T(i){let n;try{n=d()}catch{}let r;try{i.profile_id&&(r=c(i.profile_id).manifest.name)}catch{}let e=i.cwd;if(e){const t=l();e===t?e="~":e.startsWith(t+"/")&&(e="~"+e.slice(t.length))}const o=process.env.CRTR_TMUX_STARTED==="1"?p:void 0;return{version:n,profile:r,cwd:e,...o!==void 0?{hint:o}:{}}}s(T,"buildBannerInfo");export{p as TMUX_SURVIVAL_HINT,T as buildBannerInfo};

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

@@ -0,0 +1,20 @@
+import { type AttachBindingId, type BindingId, type BindingResolution, type UserKeybindingSettings } from '../../../core/keybindings/index.js';
+export type { AttachBindingId } from '../../../core/keybindings/index.js';
+export type AttachBindings = BindingResolution<BindingId>;
+export type AttachActions = Record<AttachBindingId, () => void>;
+export declare const ATTACH_VIEWPORT_BINDINGS: readonly ["crtr.attach.scroll.up", "crtr.attach.scroll.down", "crtr.attach.scroll.page-up", "crtr.attach.scroll.page-down", "crtr.attach.scroll.live", "crtr.attach.mouse.toggle", "crtr.attach.copy.message"];
+export type AttachViewportBindingId = typeof ATTACH_VIEWPORT_BINDINGS[number];
+export type AttachViewportActions = Record<AttachViewportBindingId, () => void>;
+export { backgroundBashHint, inboxOpenHint } from '../../../core/keybindings/index.js';
+export declare function matchesAttachBinding(bindings: AttachBindings, id: BindingId, data: string): boolean;
+export declare function dispatchAttachAction(id: AttachBindingId, actions: AttachActions): void;
+export declare function dispatchAttachBinding(bindings: AttachBindings, data: string, actions: AttachActions): boolean;
+export declare function dispatchAttachViewportBinding(bindings: AttachBindings, data: string, actions: AttachViewportActions): boolean;
+export declare function detachHint(bindings: AttachBindings): string | undefined;
+/** The dedicated detach binding's spelling (ctrl+d), for pointing the user at
+ *  detach now that a second ctrl+c cancels the running turn instead. */
+export declare function detachBindingHint(bindings: AttachBindings): string | undefined;
+/** Re-resolve the user's binding settings once and republish the same snapshot
+ *  to every consumer: attach dispatch, the graph overlay, and tmux. Binding
+ *  diagnostics must never fail an attach, so an install error is swallowed. */
+export declare function refreshAttachBindingSnapshot(resolve: () => UserKeybindingSettings, setGraphBindings: (bindings: AttachBindings) => void, inTmuxNow: () => boolean, install: (bindings: AttachBindings, tmuxPassthrough: readonly BindingId[]) => void): UserKeybindingSettings;

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

@@ -0,0 +1 @@
+var h=Object.defineProperty;var n=(t,r)=>h(t,"name",{value:r,configurable:!0});import{matchesKey as s}from"@earendil-works/pi-tui";import{ATTACH_CONTROL_BINDINGS as u,formatBinding as o,matchesPiTuiInput as f,normalizeShiftedMeta as d}from"../../../core/keybindings/index.js";const p=["crtr.attach.scroll.up","crtr.attach.scroll.down","crtr.attach.scroll.page-up","crtr.attach.scroll.page-down","crtr.attach.scroll.live","crtr.attach.mouse.toggle","crtr.attach.copy.message"];import{backgroundBashHint as S,inboxOpenHint as _}from"../../../core/keybindings/index.js";function i(t,r,e){return f(t,r,d(e),(c,a)=>s(c,a))}n(i,"matchesAttachBinding");function g(t,r){r[t]()}n(g,"dispatchAttachAction");function A(t,r,e){for(const{actionId:c}of u)if(i(t,c,r))return g(c,e),!0;return!1}n(A,"dispatchAttachBinding");function B(t,r,e){for(const c of p)if(i(t,c,r))return e[c](),!0;return!1}n(B,"dispatchAttachViewportBinding");function I(t){for(const r of["crtr.attach.clear-or-detach","crtr.attach.detach"])if(t.gestures(r).length>0)return o(t,r)}n(I,"detachHint");function T(t){return t.gestures("crtr.attach.detach").length>0?o(t,"crtr.attach.detach"):void 0}n(T,"detachBindingHint");function H(t,r,e,c){const a=t();if(r(a.bindings),e())try{c(a.bindings,a.tmuxPassthrough)}catch{}return a}n(H,"refreshAttachBindingSnapshot");export{p as ATTACH_VIEWPORT_BINDINGS,S as backgroundBashHint,T as detachBindingHint,I as detachHint,g as dispatchAttachAction,A as dispatchAttachBinding,B as dispatchAttachViewportBinding,_ as inboxOpenHint,i as matchesAttachBinding,H as refreshAttachBindingSnapshot};

package/dist/clients/attach/session/chrome-refresh.d.ts

@@ -0,0 +1,40 @@
+import type { AttachSession } from './context.js';
+export interface ChromeRefreshHooks {
+    /** True once teardown has begun — stops both the loop and a re-arm. */
+    isTornDown: () => boolean;
+    /** The viewer's transient notice slot — the ONLY failure channel here. */
+    setNotice: (msg: string) => void;
+    /** Repaint the relationship roster (chrome/roster.ts refresh). */
+    refreshRoster: () => Promise<void>;
+    /** Repaint the graph overlay if open. */
+    refreshGraph: () => void;
+    /** Re-read the node's persona/lifecycle/icon from canvas — a runtime
+     *  promote/reshape changes it with no broker event, so the poll catches it. */
+    refreshIdentity: () => void;
+    renderFooter: () => void;
+    renderExtensionWidgets: () => void;
+    /** Re-measure the tool calls still in flight, so a silent long-running bash
+     *  call still reaches its backgrounding hint with no per-call timer. */
+    refreshInFlightTools: () => void;
+    /** Re-poll this pane's own git context (owned by the editor chrome). */
+    pollGit: () => void;
+}
+export interface ChromeRefresh {
+    /** Refresh all canvas chrome (panels + overlay if open). Coalescing: an
+     *  overlapping request collapses into one queued re-run instead of stacking. */
+    refresh: () => void;
+    /** The live ask-count map, keyed by node id. */
+    asks: () => Record<string, number>;
+    /** Report an async chrome failure through the notice slot — NEVER stderr:
+     *  this process owns an alternate-screen TUI, and a stray stderr write paints
+     *  raw bytes through the current frame and corrupts it. The last good chrome
+     *  snapshot is simply kept; the trimmed cause rides along so a persistent
+     *  failure (e.g. a stale viewer generation talking to a newer crtrd) is
+     *  diagnosable from the pane. */
+    reportFailure: (label: string, cause?: unknown) => void;
+    /** Run the initial poll and arm the interval. Call once, after `tui.start()`. */
+    start: () => void;
+    /** Clear the interval. Called from teardown's `stopLocal`. */
+    stop: () => void;
+}
+export declare function createChromeRefresh(ctx: Pick<AttachSession, 'nodeId' | 'canvasSource'>, hooks: ChromeRefreshHooks): ChromeRefresh;

package/dist/clients/attach/session/chrome-refresh.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var n=(l,e)=>p(l,"name",{value:e,configurable:!0});const w=5e3;function v(l,e){const{nodeId:S,canvasSource:h}=l;let d={},s;const i=n((r,t)=>{const a=(t instanceof Error?t.message:t===void 0?"":String(t)).replace(/\s+/g," ").trim().slice(0,120);e.setNotice(a===""?`${r} delayed`:`${r} delayed \u2014 ${a}`)},"reportFailure");let u=!1,c=!1;const f=n(()=>{c=!0,!u&&(u=!0,(async()=>{try{for(;c&&!e.isTornDown();){c=!1;try{await e.refreshRoster()}catch(r){i("canvas panel refresh",r)}e.refreshGraph()}}finally{u=!1,c&&!e.isTornDown()&&f()}})().catch(r=>i("canvas chrome refresh",r)))},"refresh"),m=n(async r=>{let t=r;const a=new Set([t]);for(;;){const o=(await h.subscribersOf(t).catch(()=>[]))[0]?.node_id;if(o===void 0||a.has(o))break;a.add(o),t=o}return t},"climbRootFromSource"),y=n(()=>{f(),e.refreshIdentity(),e.renderExtensionWidgets(),e.pollGit(),e.refreshInFlightTools(),e.renderFooter(),(async()=>{const r=await m(S),t=await h.ticketCountsForView(r);JSON.stringify(t)!==JSON.stringify(d)&&(d=t,f(),e.renderFooter())})().catch(r=>i("canvas attention refresh",r))},"pollChrome");return{refresh:f,asks:n(()=>d,"asks"),reportFailure:i,start:n(()=>{y(),s=setInterval(y,5e3),typeof s.unref=="function"&&s.unref()},"start"),stop:n(()=>{s!==void 0&&clearInterval(s)},"stop")}}n(v,"createChromeRefresh");export{v as createChromeRefresh};

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

@@ -0,0 +1,53 @@
+import type { BrokerSnapshot, ClientRole } from '../../../core/runtime/broker-protocol.js';
+import type { CanvasSource } from '../../../core/canvas/source.js';
+import type { NodeMeta } from '../../../core/canvas/types.js';
+import { BrokerClient } from '../../../core/broker-client/index.js';
+/** The hello handshake's initial role. A REMOTE attach (`--canvas`) is a
+ *  strictly VIEW-ONLY surface — it must claim observer regardless of
+ *  `--observer`, never controller. Local attach claims controller unless
+ *  `--observer`. Pure so the "remote is always observer" contract is testable
+ *  without constructing a real hello/socket. */
+export declare function resolveHelloRole(remote: boolean, observer: boolean): ClientRole;
+/** bootRoot spawns the viewer BEFORE its freshly-launched broker has bound
+ *  view.sock, so the viewer's own CLI boot (~0.4s of module load) overlaps the
+ *  broker's ~1s startup instead of serializing after it. When that spawner set
+ *  CRTR_ATTACH_WAIT_MS, poll the socket with throwaway probe connects until it
+ *  accepts or the deadline passes — then fall through and let the normal
+ *  one-shot connect race surface the usual BrokerUnavailableError. Without the
+ *  env var this is a no-op: a plain `crtr surface attach` keeps its fail-fast
+ *  "attach does NOT launch the engine" contract. */
+export declare function preWaitForViewSocket(nodeId: string): Promise<void>;
+/** A connected viewer's transport facts, established before any UI exists. */
+export interface AttachConnection {
+    /** THE single remote/read-only fact for the whole session, derived ONCE here
+     *  from `--canvas`. Every local disk/SQLite read or write keyed on the node id
+     *  gates on this one flag; no collaborator re-derives "is this remote". */
+    readonly remote: boolean;
+    /** Canvas read authority: an API source locally, a relayed source remotely. */
+    readonly canvasSource: CanvasSource;
+    /** Viewer-LOCAL concerns only — `cwd` drives theming and this pane's own git
+     *  status, and is the CLI's own cwd under `--canvas`. */
+    readonly meta: Pick<NodeMeta, 'cwd' | 'profile_id'>;
+    /** The attached node's persona/lifecycle, when this canvas can tell us —
+     *  `undefined` for a remote attach until the viewer refetches it. */
+    readonly nodeIdentity: Pick<NodeMeta, 'kind' | 'mode' | 'lifecycle' | 'icon'> | undefined;
+    /** The one socket target for the node's headless broker. It is intentionally
+     * disconnected only when focus opened an exact parked resident offline. */
+    readonly socket: BrokerClient;
+    /** Saved snapshot used to seed an offline parked viewer. Absent for direct
+     * attach and for focus paths whose broker was live or legitimately woke. */
+    readonly initialSnapshot?: BrokerSnapshot;
+    readonly initialCommands?: ReadonlyArray<{
+        name: string;
+        description: string;
+        source: string;
+    }>;
+    /** Re-throw a connect-adjacent failure that landed AFTER `connect` resolved.
+     *  Call once, synchronously, just before permanent socket wiring takes over;
+     *  a no-op if nothing failed. See the never-removed error listener below. */
+    assertConnected(): void;
+}
+/** Resolve the target, revive the node if it is dormant (server-side), and dial
+ *  the broker. Rejects with a plain `InputError` — no terminal has been taken
+ *  over at this point, so a failure here is an ordinary non-zero CLI exit. */
+export declare function connectToNode(nodeId: string, canvasName?: string, wakeParked?: boolean): Promise<AttachConnection>;

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

@@ -0,0 +1 @@
+var T=Object.defineProperty;var o=(e,r)=>T(e,"name",{value:r,configurable:!0});import{createConnection as y}from"node:net";import{apiSocketPath as A,viewSocketPath as P}from"../../../core/canvas/paths.js";import{BrokerClient as x,BrokerUnavailableError as E,RelayTransport as g}from"../../../core/broker-client/index.js";import{resolveRemoteCanvasTarget as _}from"../../../core/remote-canvas-target.js";import{ApiCanvasSource as R,cliCanvasSource as F,cliClient as S,rethrowAsCliError as M}from"../../../commands/api-client.js";import{InputError as p}from"../../../core/io.js";function U(e,r){return e||r?"observer":"controller"}o(U,"resolveHelloRole");async function $(e){const r=Number(process.env.CRTR_ATTACH_WAIT_MS??"");if(!Number.isFinite(r)||r<=0)return;const w=P(e),l=Date.now()+r;for(;Date.now()<l;){if(await new Promise(a=>{const s=y(w),c=o(n=>{s.destroy(),a(n)},"settle");s.once("connect",()=>c(!0)),s.once("error",()=>c(!1))}))return;await new Promise(a=>setTimeout(a,100))}}o($,"preWaitForViewSocket");async function V(e,r,w=!0){const l=r!==void 0,h=l?F({canvasName:r}):new R;let a,s,c,n,d;if(l)a={cwd:process.cwd()},c=new g(e,_(r));else{const t=await h.getNode(e);if(t===null)throw new p({error:"not_found",message:`no node: ${e}`,received:e,next:"List nodes with `crtr node inspect list`."});a=t,s=t;try{if((await S().ensureAttach(e,{resume:!0,revive:!0,wakeParked:w})).parked){const u=await S().getSnapshot(e);n=u.snapshot,d=u.commands}}catch(m){M(m,"The node may be finalized or otherwise not attachable.")}n===void 0&&await $(e),c=new g(e,{socketPath:A()})}const i=new x(e,{transport:c}),k=o(t=>t instanceof E?new p({error:"no_broker",message:t.message,received:e,next:"Focus or revive the node first \u2014 attach needs a running headless broker."}):new p({error:"socket_error",message:`could not attach to node ${e}: ${String(t?.message??t)}`,received:e,next:"Check the node has a running headless broker."}),"toAttachError");let f;return i.on("error",t=>{f===void 0&&(f=t)}),n===void 0&&await new Promise((t,m)=>{const u=o(()=>{C(),t()},"onConnect"),v=o(b=>{C(),m(b)},"onErr"),C=o(()=>{i.off("connect",u),i.off("error",v)},"cleanup");i.on("connect",u),i.on("error",v),i.connect()}).catch(t=>{throw k(t)}),{remote:l,canvasSource:h,meta:a,nodeIdentity:s,socket:i,...n===void 0?{}:{initialSnapshot:n,initialCommands:d},assertConnected:o(()=>{if(n===void 0&&f!==void 0)throw k(f)},"assertConnected")}}o(V,"connectToNode");export{V as connectToNode,$ as preWaitForViewSocket,U as resolveHelloRole};

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

@@ -0,0 +1,59 @@
+import type { Container, TUI } from '@earendil-works/pi-tui';
+import type { ClientRole } from '../../../core/runtime/broker-protocol.js';
+import type { CanvasSource } from '../../../core/canvas/source.js';
+import type { NodeMeta } from '../../../core/canvas/types.js';
+import type { BrokerClient } from '../../../core/broker-client/index.js';
+import type { AttachPalette } from '../config.js';
+import type { TitledEditor } from '../input/titled-editor.js';
+/** The pinned cockpit plus transcript/header regions, in frame render order.
+ *  Owned by the layout step; every painter writes into exactly one of these. */
+export interface AttachContainers {
+    /** Scrolling transcript source, rendered by the virtualized viewport. */
+    readonly chat: Container;
+    /** Pinned recap above the transcript; empty when no recap widget exists. */
+    readonly header: Container;
+    /** Extension widgets placed `aboveEditor`, including the inactivity brief. */
+    readonly aboveWidgets: Container;
+    /** Live activity loader, fixed at the top of the bottom region. */
+    readonly activity: Container;
+    /** Relationship roster / wait rows, below the editor. */
+    readonly reports: Container;
+    /** Pending steering messages, above the editor. */
+    readonly queued: Container;
+    /** Native pickers (/model etc.), inline directly under the editor. */
+    readonly pickerPanel: Container;
+    /** The inline ticket page (chrome/ticket-panel.ts), below the recap header
+     *  — the expanded form of the strip's notification row. */
+    readonly ticketPanel: Container;
+    /** Extension widgets placed `belowEditor`. */
+    readonly belowWidgets: Container;
+    /** The status line. */
+    readonly footer: Container;
+}
+export interface AttachSession {
+    /** The node this viewer drives. On a remote attach this id is meaningful only
+     *  to the remote canvas — never to local disk. */
+    readonly nodeId: string;
+    /** THE single remote/read-only fact, derived once in `runAttach` from
+     *  `--canvas` and threaded from here. No collaborator may re-derive it. */
+    readonly remote: boolean;
+    /** THE single capability fact, resolved once in `runAttach` by
+     *  `resolveHelloRole(remote, observer)` and claimed in every hello (including
+     *  reconnects), so it can never be renegotiated mid-session. `'observer'`
+     *  makes this viewer read-only: no collaborator may emit a mutating frame or
+     *  drive the node out of band. */
+    readonly role: ClientRole;
+    /** Viewer-LOCAL concerns only: `cwd` drives theming and this pane's own git
+     *  status, and is the CLI's own cwd for a remote attach — never the remote
+     *  node's directory. */
+    readonly meta: Pick<NodeMeta, 'cwd' | 'profile_id'>;
+    /** Canvas read authority for chrome and the graph overlay: an API source
+     *  locally, a relayed source under `--canvas`. */
+    readonly canvasSource: CanvasSource;
+    /** The one socket to the node's headless broker. Attach owns no engine. */
+    readonly socket: BrokerClient;
+    readonly tui: TUI;
+    readonly pal: AttachPalette;
+    readonly editor: TitledEditor;
+    readonly containers: AttachContainers;
+}

package/dist/clients/attach/session/doc-materialize.d.ts

@@ -0,0 +1,53 @@
+/** Environment variable carrying the edited document path to the reattached viewer. */
+export declare const DOC_SAVEBACK_ENV = "CRTR_ATTACH_DOC_SAVEBACK";
+/** The document a materialized file was read from. */
+export interface MaterializedDoc {
+    /** The ref as the transcript wrote it (no brackets). */
+    ref: string;
+    id: string;
+    /** Canonical `<owner>/<name>` (or the ref when no owner). */
+    name: string;
+    revision: number;
+    /** The heads the body was read at — the base a save-back is made from. */
+    heads_key: string;
+    /** sha256 of the body as written. */
+    sha256: string;
+}
+/** The subset of a document read this module needs. */
+export interface DocumentSnapshot {
+    id: string;
+    name: string;
+    revision: number;
+    heads_key: string;
+    body: string;
+}
+export declare function docMaterializeRoot(): string;
+/** Write the snapshot's body to its stable path (idempotent) and return the path.
+ *  An existing file at that path is kept: it may hold the person's unsaved edit. */
+export declare function materializeDocument(ref: string, snap: DocumentSnapshot, root?: string): string;
+/** The document a local path was materialized from, or undefined for a plain file. */
+export declare function documentForPath(path: string, root?: string): MaterializedDoc | undefined;
+/** Save a person's edit of a materialized document. */
+export type DocSaveOutcome = {
+    outcome: 'unchanged';
+} | {
+    outcome: 'saved';
+    revision: number;
+} | {
+    outcome: 'stale';
+    path: string;
+} | {
+    outcome: 'missing';
+} | {
+    outcome: 'failed';
+    message: string;
+};
+/** The document write the save-back uses: `crtr doc edit`'s body replacement,
+ *  made from an explicit base. Resolves `stale` rather than throwing on a
+ *  moved document. */
+export type DocEditFn = (id: string, body: string, base: string) => Promise<{
+    revision: number;
+} | 'stale'>;
+export declare function saveDocumentEdit(path: string, edit: DocEditFn, root?: string): Promise<DocSaveOutcome>;
+/** The notice a save-back outcome shows, or undefined for none. */
+export declare function saveOutcomeNotice(name: string, outcome: DocSaveOutcome): string | undefined;

package/dist/clients/attach/session/doc-materialize.js

@@ -0,0 +1,3 @@
+var l=Object.defineProperty;var o=(e,t)=>l(e,"name",{value:t,configurable:!0});import{createHash as S}from"node:crypto";import{existsSync as d,mkdirSync as $,readFileSync as y,renameSync as _,writeFileSync as p}from"node:fs";import{tmpdir as x}from"node:os";import{basename as A,dirname as g,join as c}from"node:path";const N="CRTR_ATTACH_DOC_SAVEBACK",a=".crtr-doc.json";function u(){return c(x(),"crtr-docs")}o(u,"docMaterializeRoot");const f=o(e=>S("sha256").update(e).digest("hex"),"sha");function h(e){return e.replace(/[^A-Za-z0-9._-]/g,"_").slice(0,120)||"doc"}o(h,"safeSegment");function b(e,t,r=u()){const n=c(r,h(t.id),`r${t.revision}`),s=c(n,`${h(A(t.name))}.md`),i=c(n,a);if(d(s)&&d(i))return s;$(n,{recursive:!0});const v={ref:e,id:t.id,name:t.name,revision:t.revision,heads_key:t.heads_key,sha256:f(t.body)};return m(s,t.body),m(i,`${JSON.stringify(v)}
+`),s}o(b,"materializeDocument");function m(e,t){const r=`${e}.${process.pid}.tmp`;p(r,t),_(r,e)}o(m,"writeAtomic");function C(e,t=u()){if(e.startsWith(`${t}/`))try{const r=JSON.parse(y(c(g(e),a),"utf8"));return typeof r.id=="string"&&typeof r.heads_key=="string"?r:void 0}catch{return}}o(C,"documentForPath");async function R(e,t,r=u()){const n=C(e,r);if(n===void 0||!d(e))return{outcome:"missing"};const s=y(e,"utf8");if(f(s)===n.sha256)return{outcome:"unchanged"};try{const i=await t(n.id,s,n.heads_key);return i==="stale"?{outcome:"stale",path:e}:(m(c(g(e),a),`${JSON.stringify({...n,sha256:f(s)})}
+`),{outcome:"saved",revision:i.revision})}catch(i){return{outcome:"failed",message:i instanceof Error?i.message:String(i)}}}o(R,"saveDocumentEdit");function z(e,t){switch(t.outcome){case"unchanged":return;case"saved":return`Saved ${e} as revision ${t.revision}`;case"stale":return`${e} changed while you edited it \u2014 not saved; your text is kept at ${t.path}`;case"missing":return`Could not find the edited copy of ${e}`;case"failed":return`Could not save ${e}: ${t.message}`}}o(z,"saveOutcomeNotice");export{N as DOC_SAVEBACK_ENV,u as docMaterializeRoot,C as documentForPath,b as materializeDocument,R as saveDocumentEdit,z as saveOutcomeNotice};

package/dist/clients/attach/session/document-links.d.ts

@@ -0,0 +1,21 @@
+import type { CanvasSource } from '../../../core/canvas/source.js';
+export interface DocumentLinks {
+    /** Whether a clicked local path is a materialized document. */
+    isDocumentPath(path: string): boolean;
+    /** Re-read a clicked document and return the path to open (its current revision). */
+    prepareOpen(path: string): Promise<{
+        path: string;
+    } | {
+        notice: string;
+    }>;
+    /** The save-back a reattaching viewer was handed, if any. */
+    consumeSaveBack(notify: (message: string) => void): Promise<void>;
+    dispose(): void;
+}
+export declare function createDocumentLinks(opts: {
+    selfNodeId: string;
+    remote: boolean;
+    canvasSource: CanvasSource;
+    /** Re-render the transcript's Markdown after a name or path lands. */
+    refresh: () => void;
+}): DocumentLinks;

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

@@ -0,0 +1 @@
+var k=Object.defineProperty;var i=(n,o)=>k(n,"name",{value:o,configurable:!0});import{APIError as C}from"../../../api/errors.js";import{cliClient as v}from"../../../commands/api-client.js";import{setDocLinkContext as y}from"../render/doc-links.js";import{DOC_SAVEBACK_ENV as g,documentForPath as h,materializeDocument as b,saveDocumentEdit as E,saveOutcomeNotice as L}from"./doc-materialize.js";async function w(n){const o=await v().objects.read(n);if(o.state!=="object"||o.type!=="document")return`${n} is not a readable document`;const a=o.data;if(a.needs_merge||a.bodies.length!==1)return`${n} has ${a.heads.length} heads and needs a merge`;const s=o.object.owner?.handle;return{id:o.object.id,name:s===void 0?o.object.name:`${s}/${o.object.name}`,revision:a.revision,heads_key:a.heads.map(d=>d.rev_id).sort().join(","),body:a.bodies[0]}}i(w,"readSnapshot");function z(n){const o=new Map,a=new Map,s=new Set,d=new Set;let m=!1,f=!1,l=!1;const j=i(()=>{m||f||(f=!0,n.canvasSource.listNodes().then(t=>{for(const e of t)o.set(e.node_id,e.name);m=!0,l||n.refresh()}).catch(()=>{m=!0}).finally(()=>{f=!1}))},"loadRoster"),N=i(t=>{n.remote||s.has(t)||d.has(t)||(s.add(t),w(t).then(e=>{if(typeof e=="string"){d.add(t);return}a.set(t,b(t,e)),l||n.refresh()}).catch(()=>{d.add(t)}).finally(()=>{s.delete(t)}))},"materialize"),S={selfNodeId:n.selfNodeId,nodeName:i(t=>{const e=o.get(t);return e===void 0&&j(),e},"nodeName"),pathFor:i(t=>{const e=a.get(t);return e===void 0&&N(t),e},"pathFor")};return y(S),{isDocumentPath:i(t=>h(t)!==void 0,"isDocumentPath"),async prepareOpen(t){if(n.remote)return{notice:"Opening a document is unavailable in a remote attach"};const e=h(t);if(e===void 0)return{notice:"Not a document link"};try{const r=await w(e.id);if(typeof r=="string")return{notice:r};const c=b(e.ref,r);return a.set(e.ref,c),{path:c}}catch(r){return{notice:`Could not read ${e.name}: ${r instanceof Error?r.message:String(r)}`}}},async consumeSaveBack(t){const e=process.env[g];if(e===void 0||e==="")return;delete process.env[g];const r=h(e),c=await E(e,async(_,$,D)=>{try{return{revision:(await v().docs.edit(_,{body:$,base:D,rationale:"edited by the person in the attach viewer"})).revision}}catch(u){if(u instanceof C&&u.code==="stale_revision")return"stale";throw u}}),p=L(r?.name??e,c);p!==void 0&&t(p)},dispose(){l=!0,y(void 0)}}}i(z,"createDocumentLinks");export{z as createDocumentLinks};

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

@@ -0,0 +1,47 @@
+import type { NodeMeta } from '../../../core/canvas/types.js';
+import type { BrokerSnapshot } from '../../../core/runtime/broker-protocol.js';
+import type { AttachPalette } from '../config.js';
+import type { BashMode } from '../chrome/status-line.js';
+import type { AttachSession } from './context.js';
+/** Derive the shell-mode cue from the editor contents. Leading whitespace is
+ *  ignored so pasted commands and indented text still toggle correctly. */
+export declare function deriveBashMode(text: string): 0 | 1 | 2;
+/** Resolve the editor border + title-chip styles for the current shell cue. */
+export declare function resolveEditorFrameStyles(bashMode: 0 | 1 | 2, thinkingLevel: BrokerSnapshot['state']['thinkingLevel'] | undefined, pal: Pick<AttachPalette, 'bashMode' | 'bashModeAlt' | 'border'>): {
+    borderColor: (s: string) => string;
+    titleStyle: (s: string) => string;
+};
+export interface EditorChromeHooks {
+    /** The viewer's live node identity — a `let` runAttach owns and refreshes
+     *  (remote attach starts without one), so it MUST stay a getter. */
+    nodeIdentity: () => Pick<NodeMeta, 'kind' | 'mode' | 'lifecycle' | 'icon'> | undefined;
+    /** The engine's current thinking level, from live session state. */
+    thinkingLevel: () => BrokerSnapshot['state']['thinkingLevel'] | undefined;
+    /** Repaint the status line — the bash-level segment tracks `bashMode`. */
+    renderFooter: () => void;
+    /** Editor text changed — lets the command-preview inventory stay in sync. */
+    onTextChange: (text: string) => void;
+}
+export interface EditorChrome {
+    /** Current shell/bash level, for the status line's segment. */
+    bashMode: () => BashMode;
+    /** The `/color` override for the name chip — null restores the default. */
+    setChipColor: (color: string | null) => void;
+    /** Repaint the editor border + title chip from current bash/thinking state. */
+    paintFrame: () => void;
+    /** Normalize pi's session name into the title chip. */
+    setTitle: (sessionName: string | undefined) => void;
+    /** Repaint the bottom-right cwd + persona badge. */
+    syncContextBadge: () => void;
+    /** Kick an async git-status fetch that repaints the top border. */
+    pollGit: () => void;
+}
+/** Render the generated task icon on every non-empty editor title. Session
+ * names are persisted independently by pi, so this derives the icon from the
+ * canvas identity again whenever a viewer attaches or reloads. */
+export declare function displayEditorTitle(sessionName: string | undefined, identity: Pick<NodeMeta, 'kind' | 'mode' | 'icon'> | undefined): string;
+/** The editor-chrome collaborator: owns the shell/bash level (`deriveBashMode`
+ *  over `editor.onChange` is its ONE writer) and the `/color` chip override,
+ *  and paints every frame-attached adornment — border hue, title chip, context
+ *  badge, and git context. */
+export declare function createEditorChrome(ctx: Pick<AttachSession, 'meta' | 'tui' | 'pal' | 'editor'>, hooks: EditorChromeHooks): EditorChrome;

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

@@ -0,0 +1 @@
+var p=Object.defineProperty;var r=(l,e)=>p(l,"name",{value:e,configurable:!0});import{basename as x}from"node:path";import{modeIcon as y,personaLabel as C}from"../../../core/canvas/labels.js";import{colorChipStyle as $,defaultTitleStyle as g,thinkingBorderColor as S,thinkingTitleStyle as w}from"../input/titled-editor.js";import{fetchGitInfo as I}from"../chrome/git-info.js";const T="\uF489";function B(l){const e=l.trimStart();return e.startsWith("!!")?2:e.startsWith("!")?1:0}r(B,"deriveBashMode");function M(l,e,o){return l===2?{borderColor:o.bashModeAlt,titleStyle:r(s=>`\x1B[102m\x1B[30m\x1B[1m ${s} \x1B[0m`,"titleStyle")}:l===1?{borderColor:o.bashMode,titleStyle:r(s=>`\x1B[42m\x1B[97m\x1B[1m ${s} \x1B[0m`,"titleStyle")}:{borderColor:S(e,o.border),titleStyle:w(e,g)}}r(M,"resolveEditorFrameStyles");function E(l,e){const o=l??"";if(o===""||e===void 0)return o;const s=`${y(e.mode)} `,c=o.startsWith(s)?o.slice(s.length):o,i=(e.icon??"").trim(),d=i===""?"":`${i} `,a=d!==""&&c.startsWith(d)?c.slice(d.length):c,u=a.endsWith(` ${e.kind}`)?a.slice(0,-e.kind.length-1):a,h=u===e.kind?"":u;return h===""||i===""?h:`${i} ${h}`}r(E,"displayEditorTitle");function G(l,e){const{meta:o,tui:s,pal:c,editor:i}=l;let d=0,a=null;const u=r((t=x(o.cwd)||o.cwd)=>{const n=e.nodeIdentity(),m=n?.lifecycle==="terminal"?`${T} `:"",b=n?` \xB7 ${C(n)}`:"";i.contextBadge=`${m}${t}${b}`},"syncContextBadge"),h=r(()=>{const t=M(d,e.thinkingLevel(),c);if(i.borderColor=t.borderColor,i.titleStyle=t.titleStyle,i.contextBadgeStyle=t.titleStyle,d===0&&a!==null){const n=$(a);n!==void 0&&(i.titleStyle=n)}},"paintFrame");i.onChange=t=>{e.onTextChange(t);const n=B(t);n!==d&&(d=n,h(),e.renderFooter()),s.requestRender()};const f=r(t=>{const n=[];t.branch&&n.push(c.info(`\u2387 ${t.branch}`));const m=[];t.dirty&&m.push(c.warning("\u25CF")),t.ahead>0&&m.push(c.active(`\u21E1${t.ahead}`)),t.behind>0&&m.push(c.active(`\u21E3${t.behind}`)),m.length>0&&n.push(m.join("")),i.info=n.length>0?` ${n.join(c.muted(" \xB7 "))} `:"",u(t.dir),s.requestRender()},"renderGitInfo");return{bashMode:r(()=>d,"bashMode"),setChipColor:r(t=>{a=t,h(),s.requestRender()},"setChipColor"),paintFrame:h,setTitle:r(t=>{i.title=E(t,e.nodeIdentity())},"setTitle"),syncContextBadge:r(()=>u(),"syncContextBadge"),pollGit:r(()=>I(o.cwd,f),"pollGit")}}r(G,"createEditorChrome");export{G as createEditorChrome,B as deriveBashMode,E as displayEditorTitle,M as resolveEditorFrameStyles};

package/dist/clients/attach/session/editor-inventory.d.ts

@@ -0,0 +1,63 @@
+import { CombinedAutocompleteProvider } from '@earendil-works/pi-tui';
+import type { BrokerDataFrame, RefMeta } from '../../../core/runtime/broker-protocol.js';
+import type { FrecencyStore } from '../input/completion-frecency.js';
+import type { ViewerCapabilities } from '../input/capabilities.js';
+import { type PreviewableCommand } from '../slash/prompt-preview.js';
+import type { AttachBindings } from './bindings.js';
+import type { AttachSession } from './context.js';
+export declare function buildAttachAutocompleteProvider(cwd: string, fdPath: string | null, commands: ReadonlyArray<{
+    name: string;
+    description?: string;
+}> | undefined, capabilities: ViewerCapabilities, createProvider?: (items: ReadonlyArray<{
+    name: string;
+    description?: string;
+}>, cwd: string, fdPath: string | null) => CombinedAutocompleteProvider): CombinedAutocompleteProvider;
+/** Requests the broker's memory-ref inventory (`request({type:'list_memory_refs'})`)
+ *  and drives `setMemoryRefs` — the epoch-guarded lifecycle behind inline memory
+ *  references. Every `reset()` call:
+ *  1. bumps a monotonic epoch, immediately superseding any still-in-flight
+ *     request from a prior `reset()` (a stale welcome/reload/reconnect);
+ *  2. clears the inventory synchronously via `setMemoryRefs([])`, so a
+ *     partially-typed ref never keeps highlighting/completing against a
+ *     dead broker's stale names;
+ *  3. issues one correlated request and installs its `refs` ONLY if the reply
+ *     both belongs to the latest epoch AND is a well-formed
+ *     `list_memory_refs` data frame.
+ *  A timeout, rejection, or malformed/mismatched `kind` degrades silently to
+ *  the already-empty inventory — no retry, no local fallback. Command and ref
+ *  arrival are independent: this coordinator never touches command state. */
+export interface MemoryRefRefreshCoordinator {
+    reset: () => void;
+}
+export declare function createMemoryRefRefreshCoordinator(setMemoryRefs: (refs: ReadonlyArray<RefMeta>, engineLeadingCommandNames: ReadonlyArray<string>) => void, request: (frame: {
+    type: 'list_memory_refs';
+}) => Promise<BrokerDataFrame>): MemoryRefRefreshCoordinator;
+/** The verbs `runAttach` still needs from the inventory owner. Nothing outside
+ *  this module writes the command/ref state — the orchestrator only feeds
+ *  arrivals in (`setCommands`, `resetMemoryRefs`) and mirrors editor text
+ *  (`syncCommandPreview`). */
+export interface EditorInventory {
+    /** Install the broker's command metadata (frames wiring: `get_commands`). */
+    setCommands: (next?: ReadonlyArray<PreviewableCommand>) => void;
+    /** Restart the epoch-guarded ref-inventory lifecycle (welcome / `/reload`). */
+    resetMemoryRefs: () => void;
+    /** Recompute the loaded-command preview from the current editor text. */
+    syncCommandPreview: (text: string) => void;
+    /** tmux/nvim popup showing the loaded prompt template's exact payload. */
+    inspectLoadedCommand: () => void;
+}
+export interface EditorInventoryHooks {
+    setNotice: (msg: string) => void;
+    /** Live binding snapshot — read at call time so a `/reload` is honored. */
+    bindings: () => AttachBindings;
+    /** Resolved once in `runAttach`; never changes for the session. */
+    fdPath: string | null;
+    /** Per-user frecency store — biases command/ref completion order by usage. */
+    frecency: FrecencyStore;
+}
+/** Owns everything the editor can complete against — the merged slash-command
+ *  list, the loaded-command preview, the broker's raw command metadata, and the
+ *  memory-ref inventory — plus the popup that inspects the loaded template.
+ *  Input wiring supplies the session capability before first render, seeding
+ *  builtins-only autocomplete before the broker's first `get_commands` ack. */
+export declare function createEditorInventory(ctx: Pick<AttachSession, 'meta' | 'socket' | 'tui' | 'editor'>, capabilities: ViewerCapabilities, hooks: EditorInventoryHooks): EditorInventory;

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

@@ -0,0 +1,6 @@
+var R=Object.defineProperty;var n=(m,c)=>R(m,"name",{value:c,configurable:!0});import{execFile as P}from"node:child_process";import{mkdtempSync as w,rmSync as x,writeFileSync as S}from"node:fs";import{tmpdir as b}from"node:os";import{join as C}from"node:path";import{CombinedAutocompleteProvider as _}from"@earendil-works/pi-tui";import{formatBinding as L}from"../../../core/keybindings/index.js";import{inTmux as E}from"../../../core/runtime/placement-tmux.js";import{surfaceTmuxStyleArgs as $}from"../../../core/runtime/surface-bg.js";import{RefAwareAutocompleteProvider as I}from"../input/ref-autocomplete.js";import{CANVAS_SLASH_COMMANDS as M,locallyConsumedCommandNames as q,slashCommandList as H}from"../slash/dispatch.js";import{loadedCommandPreview as T}from"../slash/prompt-preview.js";import{nvimShellCommand as F}from"../../../core/nvim-launch.js";function j(m,c,t,d,s=(p,r,a)=>new _([...p],r,a)){return s([...H(t,d)],m,c)}n(j,"buildAttachAutocompleteProvider");function z(m,c){let t=0;return{reset:n(()=>{const d=++t;m([],[]),c({type:"list_memory_refs"}).then(s=>{d===t&&s.kind==="list_memory_refs"&&m(s.refs,s.engineLeadingCommandNames)}).catch(()=>{})},"reset")}}n(z,"createMemoryRefRefreshCoordinator");function ne(m,c,t){const{meta:d,socket:s,tui:p,editor:r}=m;let a=[],o,l,f=[],u=[];const g=n(()=>{const e=t.bindings();return e.gestures("crtr.attach.command.inspect").length>0?`${L(e,"crtr.attach.command.inspect")} inspect`:"inspect binding disabled"},"commandInspectHint"),v=n(e=>{o=T(e,a),r.loadedCommand=o===void 0?void 0:{name:o.name,content:o.content,inspectHint:g()}},"syncCommandPreview"),y=n(()=>{const e=j(d.cwd,t.fdPath,l,c);r.setAutocompleteProvider(new I(f,e,t.frecency)),r.setResolvedRefNames(f.map(i=>i.name)),r.setLocalCommandNames(q()),r.setEngineCommandNames(u),v(r.getText())},"syncEditorInventories"),h=n(e=>{l=e,a=[...M.map(i=>({...i,source:"builtin"})),...e??[]],y()},"setCommands"),A=z(n((e,i)=>{f=e,u=i,y(),p.requestRender()},"setMemoryRefs"),e=>s.request(e));return{setCommands:h,resetMemoryRefs:n(()=>A.reset(),"resetMemoryRefs"),syncCommandPreview:v,inspectLoadedCommand:n(()=>{if(o===void 0){t.setNotice("No prompt-template command is loaded in the editor");return}if(!E()){t.setNotice("Command inspection requires tmux");return}const e=w(C(b(),"crtr-command-")),i=C(e,`${o.name.replace(/[^A-Za-z0-9_.-]/g,"-")}.md`);S(i,`# /${o.name}
+
+Invocation: \`${o.invocation.replaceAll("`","\\`")}\`
+
+${o.content}
+`,"utf8");const N=`if command -v nvim >/dev/null 2>&1; then exec ${F("readonly",[i])}; else printf 'nvim is required to inspect loaded commands. Install Neovim and retry.\\n'; printf 'Press Enter to close.'; read _; fi`;P("tmux",["display-popup","-E","-w","90%","-h","85%",...$(),N],()=>x(e,{recursive:!0,force:!0}))},"inspectLoadedCommand")}}n(ne,"createEditorInventory");export{j as buildAttachAutocompleteProvider,ne as createEditorInventory,z as createMemoryRefRefreshCoordinator};

package/dist/clients/attach/session/file-links.d.ts

@@ -0,0 +1,24 @@
+/** A local file requested through iTerm Semantic History. */
+export interface FileOpenInput {
+    file: string | undefined;
+    remaining: string;
+}
+/**
+ * Strip the private iTerm Semantic History input and return its local path.
+ * iTerm expands `\\1` as a shell-escaped word, so decode that representation
+ * without ever evaluating it as shell input.
+ */
+export declare function extractFileOpenInput(data: string): FileOpenInput | undefined;
+export type LinkedFileOpenResult = 'opened' | 'missing' | 'no_nvim' | 'failed';
+/** Replace this local viewer pane with Neovim, then reattach it when Neovim exits. */
+export declare function openLinkedFileInPane(opts: {
+    file: string;
+    pane: string;
+    cwd: string;
+    nodeId: string;
+    observer: boolean;
+    /** A materialized canvas document: the reattaching viewer saves its edit back. */
+    saveBackEnv?: string;
+    /** Clear viewer-local pane identity immediately before the pane runs Neovim. */
+    beforeRespawn: () => void;
+}): LinkedFileOpenResult;

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

@@ -0,0 +1 @@
+var o=Object.defineProperty;var r=(e,n)=>o(e,"name",{value:n,configurable:!0});import{existsSync as s}from"node:fs";import{nvimAvailable as l,nvimShellCommand as u}from"../../../core/nvim-launch.js";import{respawnPaneInBackground as a,shellQuote as c,viewerSplitEnv as h}from"../../../core/runtime/placement-tmux.js";const d="\x1B_crtr-file-open;",f="\x1B\\";function S(e){const n=e.indexOf(d);if(n===-1)return;const t=n+d.length,i=e.indexOf(f,t);return i===-1?void 0:{file:m(e.slice(t,i)),remaining:e.slice(0,n)+e.slice(i+f.length)}}r(S,"extractFileOpenInput");function m(e){const n=e.startsWith("'")?x(e):p(e);return n!==void 0&&n.startsWith("/")&&!/[\x00-\x1f\x7f]/.test(n)?n:void 0}r(m,"decodeShellEscapedPath");function x(e){let n="",t=1;for(;;){const i=e.indexOf("'",t);if(i===-1)return;if(n+=e.slice(t,i),t=i+1,t===e.length)return n;if(e.slice(t,t+3)!=="\\''")return;n+="'",t+=3}}r(x,"decodeSingleQuotedPath");function p(e){let n="";for(let t=0;t<e.length;t++){if(e[t]!=="\\"){n+=e[t];continue}const i=e[++t];if(i===void 0)return;n+=i}return n}r(p,"decodeBackslashPath");function $(e){if(!s(e.file))return"missing";if(!l())return"no_nvim";const n=`crtr surface attach to ${c(e.nodeId)}${e.observer?" --observer":""}`,t=e.saveBackEnv===void 0?"":`env ${e.saveBackEnv}=${c(e.file)} `,i=`${u("edit",[e.file])} || :; exec ${t}${n}`;return e.beforeRespawn(),a({pane:e.pane,cwd:e.cwd,env:h(),command:i})?"opened":"failed"}r($,"openLinkedFileInPane");export{S as extractFileOpenInput,$ as openLinkedFileInPane};

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

@@ -0,0 +1,4 @@
+export declare const FOCUS_REPORTING_ON = "\u001B[?1004h";
+export declare const FOCUS_REPORTING_OFF = "\u001B[?1004l";
+export declare const FOCUS_IN = "\u001B[I";
+export declare const FOCUS_OUT = "\u001B[O";

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

@@ -0,0 +1 @@
+const O="\x1B[?1004h",o="\x1B[?1004l",t="\x1B[I",x="\x1B[O";export{t as FOCUS_IN,x as FOCUS_OUT,o as FOCUS_REPORTING_OFF,O as FOCUS_REPORTING_ON};