@north-light/cli 0.0.0 → 0.3.414

package/dist/clients/attach/render/context-message.d.ts

@@ -0,0 +1,22 @@
+import { type Component } from '@earendil-works/pi-tui';
+import { type CardPresentation } from './card-presentation.js';
+import type { GeneratedCard } from '../../../shared/generated-context.js';
+export declare class ContextMessageComponent implements Component {
+    private readonly dim;
+    private readonly label;
+    private expanded;
+    private readonly expandable;
+    private readonly labelTag;
+    private readonly summaryText;
+    private readonly collapsedHint;
+    private readonly expandedBody;
+    constructor(card: GeneratedCard, presentation: CardPresentation, expanded: boolean, dim: (s: string) => string, label: (s: string) => string);
+    /** Ctrl+O global tool-output toggle (ChatView.isExpandable duck-type). */
+    setExpanded(expanded: boolean): void;
+    /** Paint the [label] tag in the accent color and the rest dim. Truncate
+     *  BEFORE painting so the ANSI wrappers never inflate the measured width — an
+     *  over-wide line aborts the whole TUI render. */
+    private headerRow;
+    render(width: number): string[];
+    invalidate(): void;
+}

package/dist/clients/attach/render/context-message.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var i=(s,e)=>o(s,"name",{value:e,configurable:!0});import{UserMessageComponent as h}from"@earendil-works/pi-coding-agent";import{truncateToWidth as d,visibleWidth as n}from"@earendil-works/pi-tui";import{attachMarkdownTheme as m}from"../config.js";import{cardDisclosure as p,cardIsExpandable as x,cardLabel as b}from"./card-presentation.js";import{styleAttachMarkdownSource as c}from"./markdown-source.js";class M{static{i(this,"ContextMessageComponent")}dim;label;expanded;expandable;labelTag;summaryText;collapsedHint;expandedBody;constructor(e,t,a,l,r){this.dim=l,this.label=r,this.expandable=x(t,e),this.expanded=this.expandable&&a,this.labelTag=`[${b(t.subject)}]`,this.summaryText=` ${t.summary(e)}`,this.collapsedHint=`${this.summaryText}${this.expandable?" \u2014 ctrl+o to expand":""}`,this.expandedBody=new h(c(p(t,e)),m())}setExpanded(e){this.expandable&&(this.expanded=e)}headerRow(e,t){const a=n(this.labelTag);return a>=e?this.label(d(this.labelTag,e,"\u2026")):this.label(this.labelTag)+this.dim(d(t,e-a,"\u2026"))}render(e){const t=e>0?e:80;if(!this.expanded)return["",this.headerRow(t,this.collapsedHint),""];const a=this.expandedBody.render(t);return a.at(-1)!==""&&a.push(""),["",this.headerRow(t,this.summaryText),...a]}invalidate(){}}export{M as ContextMessageComponent};

package/dist/clients/attach/render/crtr-output.d.ts

@@ -0,0 +1,52 @@
+import { Box } from '@earendil-works/pi-tui';
+import { FoldedToolCallController } from './tool-calls.js';
+type Theme = {
+    fg: (name: string, text: string) => string;
+    bg: (name: string, text: string) => string;
+    bold: (text: string) => string;
+};
+export declare const CRTR_OUTPUT_CUSTOM_TYPE = "crtr-output";
+export declare function stripHeredocBodies(command: string): string;
+export declare function isCrtrBashCommand(command: unknown): boolean;
+/** True when a crtr bash invocation's OWN argv carries a bare -h/--help
+ *  token — the dispatcher renders the leaf's schema, not a result, so it is
+ *  never useful to preview like a normal command's output (see
+ *  src/core/help.ts renderLeafArgv: schema text, not agent-facing result
+ *  text). Checked against extractCrtrInvocationTokens' tokens (scoped to the
+ *  crtr segment only, quote-aware), never the raw command string — a `-h`
+ *  appearing before the crtr segment (`echo -h && crtr canvas snapshot`),
+ *  after it (`crtr canvas snapshot && echo --help`), or inside a quoted
+ *  argument (`crtr node new "write about -h flags"`) must never count. This is
+ *  structural (every leaf's -h has the same shape), so it needs no per-leaf
+ *  metadata — unlike suppressOutput below, which is command-owned. */
+export declare function isCrtrHelpInvocation(command: unknown): boolean;
+/** Per-render preview state for a crtr bash invocation. Both fields are
+ *  synchronous and structural: isHelp from the invocation's own argv (above),
+ *  suppressOutput from the bundle-safe static registry (preview-registry.ts —
+ *  a hand-maintained mirror of the leaf's own `help.preview.suppressOutput`,
+ *  kept in sync by preview-registry-sync.test.ts). Neither needs an async
+ *  cross-process command-tree lookup, so there is no cache/resolver/invalidate
+ *  machinery here, and no path from the attach bundle into the command tree.
+ *  Command-owned computed summaries (canvas read, doc lint, ...) are a
+ *  separate lookup entirely — render() below gives summarizePath
+ *  (preview-registry.ts) the private structured CLI result attached by the
+ *  canvas preview extension. Invocation tokens provide only static chrome. */
+export interface CrtrPreviewState {
+    isHelp: boolean;
+    suppressOutput: boolean;
+}
+export declare function commandPreviewMeta(command: string): CrtrPreviewState;
+export declare function renderCrtrOutputText(text: string, theme: Theme, preserveSyntax?: boolean): string;
+export declare class CrtrOutputMessageComponent extends Box {
+    private readonly content;
+    private readonly theme;
+    private body;
+    private expanded;
+    constructor(content: string, expanded: boolean, theme: Theme);
+    setExpanded(expanded: boolean): void;
+}
+export type CrtrBashToolView = {
+    definition: unknown;
+};
+export declare function createCrtrBashToolDefinition(args: unknown, fold?: FoldedToolCallController): CrtrBashToolView | undefined;
+export {};

package/dist/clients/attach/render/crtr-output.js

@@ -0,0 +1,17 @@
+var S=Object.defineProperty;var c=(n,t)=>S(n,"name",{value:t,configurable:!0});import{truncateToVisualLines as T}from"@earendil-works/pi-coding-agent";import{Box as j,Text as z,truncateToWidth as y,visibleWidth as R,wrapTextWithAnsi as B}from"@earendil-works/pi-tui";import{crtrPreviewRecords as U,HELP_ICON as D,iconForPath as V,suppressOutputForPath as G,summarizePath as Z}from"../../../core/preview-registry.js";import{FoldedToolCallController as K}from"./tool-calls.js";const Y=20,w=Y-3,P=/<<-?\s*(["']?)([A-Za-z_][A-Za-z0-9_]*)\1/g,v=/(?:^|[\n;&|()]\s*)(?:[A-Za-z_][A-Za-z0-9_]*=\S+\s+)*(?:[^\s;&|()]+\/)?(?:crtr|crouter)(?=\s|$)/,Ot="crtr-output";function E(n){const t=n.split(`
+`),e=[];let r=0;for(;r<t.length;){const i=t[r];e.push(i),r++;const s=[];P.lastIndex=0;let o;for(;(o=P.exec(i))!==null;)s.push(o[2]);for(const l of s)for(;r<t.length;){const u=t[r].replace(/^\t+/,"");if(r++,u===l)break}}return e.join(`
+`)}c(E,"stripHeredocBodies");function q(n){return typeof n=="string"&&v.test(E(n))}c(q,"isCrtrBashCommand");function $(n){const t=E(n),e=v.exec(t);if(e===null)return;const r=t.slice(e.index+e[0].length),i=r.search(/[\n;&|)]/),s=(i===-1?r:r.slice(0,i)).trim();return s===""?[]:J(Q(s))}c($,"extractCrtrInvocationTokens");const X=/^(?:\d*|&)(?:>>|<<|>|<)/;function J(n){const t=n.findIndex(e=>X.test(e));return t===-1?n:n.slice(0,t)}c(J,"dropRedirectTail");function Q(n){const t=[];let e="",r=!1,i=null;for(const s of n){if(i!==null){s===i?i=null:e+=s,r=!0;continue}if(s==='"'||s==="'"){i=s,r=!0;continue}if(/\s/.test(s)){r&&(t.push(e),e="",r=!1);continue}e+=s,r=!0}return r&&t.push(e),t}c(Q,"tokenizeShellSegment");function tt(n){if(typeof n!="string")return!1;const t=$(n);return t!==void 0&&t.some(e=>e==="-h"||e==="--help")}c(tt,"isCrtrHelpInvocation");function nt(n){const t=$(n);return{isHelp:t!==void 0&&t.some(r=>r==="-h"||r==="--help"),suppressOutput:t!==void 0&&t.length>0&&G(t)}}c(nt,"commandPreviewMeta");function O(n){if(!n||typeof n!="object")return"";const t=n.command;return typeof t=="string"?t:""}c(O,"commandFromArgs");const _=/^-{1,2}[A-Za-z0-9]/,et=/^(--?[A-Za-z0-9][^=]*)(=)(.*)$/,I=/^-?(?:\d+(?:\.\d+)?|\.\d+)$/;function rt(n,t){let e=!1;return n.map(r=>{const i=et.exec(r);if(i!==null){e=!1;const s=I.test(i[3])?"syntaxNumber":"syntaxString";return`${t.fg("syntaxKeyword",i[1])}${t.fg("syntaxOperator",i[2])}${t.fg(s,i[3])}`}return e&&!_.test(r)?(e=!1,t.fg(I.test(r)?"syntaxNumber":"syntaxString",r)):_.test(r)?(e=!0,t.fg("syntaxKeyword",r)):(e=!1,t.fg("toolTitle",t.bold(r)))}).join(" ")}c(rt,"styleFoldedCrtrTokens");function st(n){return(n.content??[]).filter(t=>t?.type==="text"||typeof t?.text=="string").map(t=>t.text??"").join(`
+`).trimEnd()}c(st,"resultText");function L(n,t,e,r,i,s){const o=t===""?"":s.fg("accent",t);return`${n}${o}${s.fg("dim",e)}${s.fg("dim",r)}${s.fg("text",i)}`}c(L,"styledLabelValue");function A(n,t,e=!1){const r=n.trim();if(r==="")return"";if(/^<\/?(?:command|subcommand|runtime-state|crtr-[^>\s]+|error)(?:\s|>|$)/.test(r)){const a=r.startsWith("<error")?"error":"accent";return t.fg(a,t.bold(n))}if(/^(Input|Output|Effects|Branches|Globals|Output \(|Effects$)/.test(r))return t.fg("toolTitle",t.bold(n));if(/^(Spawned|Created|Updated|Wrote|Deleted|Promoted|Demoted|Closed|Revived|Recycled|Configured|Registered|Removed|Subscribed|Unsubscribed|Canceled)\b/i.test(r))return t.fg("success",n);if(/^(crtr:|Command exited|Command timed out|Command aborted|unknown subcommand|error\b)/i.test(r))return t.fg("error",n);if(/^(warning|warn|blocked|attention)\b/i.test(r)||r.includes("\u26A0"))return t.fg("warning",n);if(/^[●✓]/.test(r))return t.fg("success",n);if(/^[○◌]/.test(r))return t.fg("muted",n);if(/^[✗⊘]/.test(r))return t.fg("error",n);const i=/^(\s*)-\s+([^:]+)(:\s*)(.*)$/.exec(n);if(i!==null)return L(i[1],e?"- ":"\u2022 ",i[2],i[3],i[4],t);const s=/^(\s*)\*\*([^*]+):\*\*(\s*)(.*)$/.exec(n);if(s!==null)return e?`${s[1]}${t.fg("dim","**")}${t.fg("dim",s[2])}${t.fg("dim",":**")}${s[3]}${t.fg("text",s[4])}`:L(s[1],"",s[2],`:${s[3]}`,s[4],t);if(/^\s*-\s+/.test(n)){const a=/^(\s*)-\s+(.*)$/.exec(n),d=e?"-":"\u2022";return`${a[1]}${t.fg("accent",d)} ${t.fg("text",a[2])}`}const o=/^(\s*)(\d+\s+[^:]+:)$/.exec(n);if(o!==null)return`${o[1]}${t.fg("toolTitle",t.bold(o[2]))}`;const l=/^(\s*)(Next:)(\s*)(.*)$/.exec(n);if(l!==null)return`${l[1]}${t.fg("accent",t.bold(l[2]))}${l[3]}${t.fg("text",l[4])}`;const u=/^(\s*)([├└│─┬┼┌┐┘└]+\s*)(.*)$/.exec(n);return u!==null?`${u[1]}${t.fg("border",u[2])}${t.fg("text",u[3])}`:t.fg("text",n)}c(A,"lineStyle");function W(n,t,e=!1){return(n||"(no output)").split(`
+`).map(i=>A(i,t,e)).join(`
+`)}c(W,"renderCrtrOutputText");function it(n){if(!n.startsWith("$ "))return n;const t=n.indexOf(`
+`);if(t===-1)return"";const e=n.slice(t+1);return e.startsWith(`
+`)?e.slice(1):e}c(it,"stripCrtrEchoPrefix");function ot(n){const t=/<command name="[^"]*"([^>]*)>/.exec(n);return t===null?"leaf":/\bdescription="/.test(t[1])?"branch":"root"}c(ot,"classifyHelpText");function ct(n){const t=n.indexOf('<command name="'),e=(t===-1?n:n.slice(0,t)).trim(),r=[],i=/<command name="([^"]*)">\n([^\n]*)/g;let s;for(;(s=i.exec(n))!==null;)r.push(`${s[1]} \u2014 ${s[2]}`);return[e,...r.length>0?["",...r]:[]].join(`
+`)}c(ct,"synthesizeRootPreview");function ut(n){const t=/^<command name="([^"]*)" description="([^"]*)">/.exec(n),e=t?.[1]??"",r=t?.[2]??"",i=[],s=/<subcommand name="([^"]*)" description="([^"]*)"[^>]*\/>/g;let o;for(;(o=s.exec(n))!==null;)i.push(`${o[1]} \u2014 ${o[2]}`);return[`${e} \u2014 ${r}`,...i.length>0?["",...i]:[]].join(`
+`)}c(ut,"synthesizeBranchPreview");function lt(n){const t=n.split(`
+`),e=[t[0]??""],r=t.indexOf("Input");if(r===-1)return e.join(`
+`);const i=t.findIndex(u=>u.startsWith("Output (")),s=i===-1?t.length:i,o=t.slice(r+1,s).filter(u=>u.trim()!==""),l=o.map(u=>/^\s{2}(\S+)/.exec(u)?.[1]);return o.length>0&&l.every(u=>u!==void 0)?e.push("",`Params: ${l.join(", ")}`):o.length>0&&e.push("",o[0]),e.join(`
+`)}c(lt,"synthesizeLeafPreview");function at(n){const t=it(n),e=ot(t);return e==="root"?ct(t):e==="branch"?ut(t):lt(t)}c(at,"synthesizeHelpPreviewText");function k(n,t,e=!1){if(n.text==="")return"";const r=/^(.*?)(\s*:\s{2})(.*)$/.exec(n.text);if(r!==null&&(n.tone===void 0||n.tone==="plain"))return`${t.fg("dim",r[1])}${t.fg("dim",r[2])}${t.fg("text",r[3])}`;const i=n.tone??"plain";if(i==="muted")return t.fg("muted",n.text);const s=i==="plain"?"text":i,o=t.fg(s,n.text);return e&&i==="plain"?t.bold(o):o}c(k,"renderSummaryLine");function dt(n,t){return n.isPartial?t.fg("warning","\u27F3 crtr running"):t.fg("error","\u2717 crtr failed")}c(dt,"statusLine");const H={isHelp:!1,suppressOutput:!1};function x(n,t){return t<=0?n.map(()=>""):n.map(e=>y(e,t,"\u2026"))}c(x,"clampRenderedLines");function M(n,t){return t<=0?n.map(()=>""):n.flatMap(e=>e===""?[""]:B(e,t))}c(M,"wrapRenderedLines");const ft=/^\[Showing lines \d+-\d+ of \d+ \([^)]+ limit\)\. Full output: .+\]$/;function pt(n){return ft.test(n.trim())}c(pt,"isPiTruncationMarker");function N(n){const t=n.trim();if(!t.includes("|"))return null;const e=t.replace(/^\|/,"").replace(/\|$/,""),r=[];let i="",s=0;for(;s<e.length;){const o=e[s];if(o==="\\"&&e[s+1]==="|"){i+="|",s+=2;continue}if(o==="|"){r.push(i.trim()),i="",s++;continue}i+=o,s++}return r.push(i.trim()),r.length>=2?r:null}c(N,"splitGenericTableRow");function mt(n){return n.every(t=>/^:?-{3,}:?$/.test(t))}c(mt,"isTableSeparator");function ht(n){const t=n.trim();return t.startsWith("|")||t.endsWith("|")}c(ht,"hasEdgePipe");function gt(n,t){const e=N(n[t]);if(e===null)return null;const r=[e];let i=t+1;for(;i<n.length;){const o=N(n[i]);if(o===null||o.length!==e.length)break;r.push(o),i++}if(r.length===1&&!ht(n[t]))return null;const s=r.findIndex(mt);return s===1?{next:i,rows:[r[0],...r.slice(2)],headerRows:1}:s!==-1?{next:i,rows:r.filter((o,l)=>l!==s),headerRows:0}:{next:i,rows:r,headerRows:0}}c(gt,"readGenericTableBlock");function xt(n){return n.reduce((t,e)=>t+e,0)}c(xt,"sum");function $t(n,t){const e=n[0]?.length??0;if(e===0)return[];const r=Math.max(0,e-1)*2,i=Math.max(e,t-r),s=i>=e*3?3:1,o=Array.from({length:e},(l,u)=>Math.max(1,...n.map(a=>R(a[u]??""))));for(;xt(o)>i;){let l=-1;for(let u=0;u<o.length;u++)o[u]>s&&(l===-1||o[u]>o[l])&&(l=u);if(l===-1)break;o[l]=o[l]-1}return o}c($t,"tableColumnWidths");function bt(n,t){const e=t-R(n);return e>0?`${n}${" ".repeat(e)}`:n}c(bt,"padToVisibleWidth");function wt(n,t){return n.map((e,r)=>bt(y(e,t[r]??1,"\u2026"),t[r]??1)).join("  ").trimEnd()}c(wt,"formatGenericTableRow");function Ct(n,t){const e=(n||"(no output)").split(`
+`),r=[],i=c(o=>{r.push(o)},"push");let s=0;for(;s<e.length;){const o=gt(e,s);if(o!==null){const u=$t(o.rows,t);for(let a=0;a<o.rows.length;a++)i({text:wt(o.rows[a],u),tone:a<o.headerRows?"accent":void 0});s=o.next;continue}const l=e[s];i({text:l,tone:pt(l)?"muted":void 0}),s++}return r}c(Ct,"collectGenericPreviewLines");function Tt(n,t,e,r){const i=Ct(n,e).map(o=>o.tone!==void 0?k(o,r,o.tone==="accent"):A(o.text,r)),s=M(i,e);return s.length<=t?{lines:s,skippedCount:0}:{lines:s.slice(0,t),skippedCount:s.length-t}}c(Tt,"renderGenericPreview");class C{static{c(this,"CrtrResultComponent")}text;options;context;theme;command;staticPreview;structuredPreview;constructor(t,e,r,i,s,o=H,l){this.text=t,this.options=e,this.context=r,this.theme=i,this.command=s,this.staticPreview=o,this.structuredPreview=l}currentPreview(){return this.command===void 0?this.staticPreview:nt(this.command)}render(t){const e=this.currentPreview(),r=!!this.options.isPartial,i=!!this.context.isError,o=r||i?[dt(this.options,this.theme)]:[];if(this.options.expanded){const u=W(this.text,this.theme,!0),a=this.command!==void 0?[this.theme.fg("muted",`$ ${this.command}`),""]:[];return M(["",...o,...a,...u.split(`
+`)],t)}if(!r){if(e.isHelp){const d=W(at(this.text),this.theme),m=T(d,w,t).visualLines??[],h=this.theme.fg("dim","(schema \u2014 ctrl+o to expand)");return x(["",...o,...m,h],t)}const u=this.command!==void 0?$(this.command):void 0,a=u!==void 0&&this.structuredPreview!==void 0?Z(this.structuredPreview,u):null;if(a!==null){const d=a.findIndex(g=>g.text!==""),p=a.map((g,f)=>k(g,this.theme,f===d)),h=T(p.join(`
+`),w,t).visualLines??[],b=this.theme.fg("dim","(ctrl+o to expand)");return x(["",...o,...h,b],t)}if(!i&&e.suppressOutput){const d=this.theme.fg("dim","(suppressed \u2014 ctrl+o to expand)");return x(["",...o,d],t)}}const l=Tt(this.text,w,t,this.theme);if(l.skippedCount>0){const u=this.theme.fg("dim",`\u2026 (${l.skippedCount} more lines, ctrl+o to expand)`);return x(["",...o,...l.lines,u],t)}return x(["",...o,...l.lines],t)}invalidate(){}}function F(n){const t=n.split(`
+`,1)[0];return t.startsWith("$ ")&&tt(t.slice(2))}c(F,"isHelpFromCrtrOutputContent");class _t extends j{static{c(this,"CrtrOutputMessageComponent")}content;theme;body;expanded;constructor(t,e,r){super(1,1,s=>r.bg("customMessageBg",s)),this.content=t,this.theme=r,this.expanded=e;const i={isHelp:F(t),suppressOutput:!1};this.body=new C(t,{expanded:e},{},r,void 0,i),this.addChild(this.body)}setExpanded(t){if(this.expanded===t)return;this.expanded=t;const e={isHelp:F(this.content),suppressOutput:!1};this.body=new C(this.content,{expanded:t},{},this.theme,void 0,e),this.clear(),this.addChild(this.body)}}function It(n,t=new K){const e=O(n);return q(e)?{definition:{name:"bash",label:"bash",description:"Render crtr bash output with crtr-specific chrome in the attach viewer.",parameters:{},renderCall(i,s,o){const l=O(i)||e,u=$(l),a=u!==void 0&&u.some(f=>f==="-h"||f==="--help"),d=(u??[]).filter(f=>f!=="-h"&&f!=="--help"),p=d.join(" "),m=a?D:V(d),h=a?`${m} crtr help`:`${m} crtr`,b=s.fg("accent",s.bold(h)),g=p?` ${t.folded?rt(d,s):s.fg("toolTitle",s.bold(p))}`:"";return t.capture(new z(`${b}${g}`,0,0))},renderResult(i,s,o,l){return new C(st(i),s,l,o,e,H,U(i).at(-1))}}}:void 0}c(It,"createCrtrBashToolDefinition");export{Ot as CRTR_OUTPUT_CUSTOM_TYPE,_t as CrtrOutputMessageComponent,nt as commandPreviewMeta,It as createCrtrBashToolDefinition,q as isCrtrBashCommand,tt as isCrtrHelpInvocation,W as renderCrtrOutputText,E as stripHeredocBodies};

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

@@ -0,0 +1,4 @@
+/** Cheap predicate for a fence that this viewer can turn into a diagram. */
+export declare function textHasDiagram(text: string): boolean;
+/** Replace every supported complete fence in `text` with its rendered diagram. */
+export declare function transformDiagramFences(text: string, width: number): string;

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

@@ -0,0 +1,7 @@
+var o=Object.defineProperty;var a=(n,t)=>o(n,"name",{value:t,configurable:!0});import{ensureRenderer as m,isRendererReady as u,renderMarkdown as l}from"../../../core/termrender/termrender.js";const d=/^[ \t]{0,3}```mermaid[^\n]*\n([\s\S]*?)\n[ \t]{0,3}```[ \t]*$/gm,f=/^```(?:text|plain|plaintext)?[ \t]*\n([^\n]+)\n```[ \t]*$/gim,p=/^```(?:text|plain|plaintext)?[ \t]*\n[^\n]+\n```[ \t]*$/im,R=/\s*(?:→|⟶|⇒|⟹)\s*/,_=/[=;{}\[\]`]/,g=/[\u2500-\u259F\u25A0-\u25FF]/;function h(n){const t=n.split(`
+`);let e=1/0;for(const r of t)r.trim()!==""&&(e=Math.min(e,r.length-r.replace(/^[ \t]+/,"").length));return!Number.isFinite(e)||e===0?n:t.map(r=>r.trim()===""?"":r.slice(e)).join(`
+`)}a(h,"dedent");function A(n){return n.includes("```mermaid")||p.test(n)}a(A,"textHasDiagram");function E(n){const t=n.trim().split(R).map(i=>i.trim());if(t.length<3||t.some(i=>!i||_.test(i)))return null;const e=t.map((i,s)=>`chain_${s}[${JSON.stringify(i)}]`),r=t.slice(1).map((i,s)=>`chain_${s} --> chain_${s+1}`);return["flowchart LR",...e,...r].join(`
+`)}a(E,"arrowChainToMermaid");function N(n){let t=0,e=n.length;for(;t<e&&n[t].trim()==="";)t++;for(;e>t&&n[e-1].trim()==="";)e--;return n.slice(t,e)}a(N,"stripBlankEdges");function c(n,t,e){try{const r=`\`\`\`mermaid
+${h(t)}
+\`\`\``,i=N(l(r,e).map(s=>s.replace(/\s+$/,"")));return i.length===0||!i.some(s=>g.test(s))?n:["```",...i,"```"].join(`
+`)}catch{return n}}a(c,"renderDiagram");function F(n,t){return!A(n)||(m(),!u())?n:n.replace(d,(r,i)=>c(r,i,t)).replace(f,(r,i)=>{const s=E(i);return s===null?r:c(r,s,t)})}a(F,"transformDiagramFences");export{A as textHasDiagram,F as transformDiagramFences};

package/dist/clients/attach/render/doc-links.d.ts

@@ -0,0 +1,34 @@
+/** The fragment a rendered document link carries. iTerm strips it before
+ *  invoking Semantic History; the viewer recognizes a document by its path. */
+export declare const DOC_OPEN_FRAGMENT = "crtr-doc-open";
+/** What the renderer needs from the viewer. Every call is synchronous and reads
+ *  live viewer state; a miss may schedule a fetch that re-renders later. */
+export interface DocLinkContext {
+    /** The node this viewer is attached to. */
+    selfNodeId: string;
+    /** A node's display name, when known. */
+    nodeName(nodeId: string): string | undefined;
+    /** The local materialized file for a document ref, when one exists. */
+    pathFor(ref: string): string | undefined;
+}
+/** Install (or clear) the viewer's document-link context. */
+export declare function setDocLinkContext(context: DocLinkContext | undefined): void;
+/** The node-id owner and remaining name of a ref, when its first segment is a node id. */
+export declare function splitDocRef(ref: string, context?: DocLinkContext): {
+    nodeId?: string;
+    name: string;
+};
+/** A readable name for a document ref: `name`, plus the owning node's name
+ *  when another node owns it. Plain text, for pickers and notices. */
+export declare function docLinkLabel(ref: string, context?: DocLinkContext | undefined): {
+    name: string;
+    owner?: string;
+};
+/** One-line plain-text label: `name` or `name · owner`. */
+export declare function docLinkText(ref: string, context?: DocLinkContext | undefined): string;
+/** Every `[[ref]]` in `text`, in order of appearance, without brackets. */
+export declare function extractDocRefs(text: string): string[];
+/** Rewrite each `[[ref]]` in a prose fragment (never a code span or fence —
+ *  the caller skips those) into its readable, openable display form. Without
+ *  an installed context the prose is returned unchanged. */
+export declare function rewriteProseDocLinks(prose: string, context?: DocLinkContext | undefined): string;

package/dist/clients/attach/render/doc-links.js

@@ -0,0 +1 @@
+var p=Object.defineProperty;var r=(e,n)=>p(e,"name",{value:n,configurable:!0});import{pathToFileURL as $}from"node:url";const x="crtr-doc-open",f=/\[\[([^[\]\n]+?)\]\]/g,N=/^[a-z0-9]+-[a-z0-9]+-[a-z0-9]+$/,D=r(e=>`\x1B[2m${e}\x1B[22m`,"DIM"),b=r(e=>`\x1B[4m${e}\x1B[24m`,"UNDERLINE");let c;function E(e){c=e}r(E,"setDocLinkContext");function I(e,n){const t=e.indexOf("/");if(t<=0)return{name:e};const o=e.slice(0,t);return o===n?.selfNodeId||n?.nodeName(o)!==void 0||N.test(o)?{nodeId:o,name:e.slice(t+1)}:{name:e}}r(I,"splitDocRef");function l(e,n=c){const{nodeId:t,name:o}=I(e,n);return t===void 0?{name:o}:t===n?.selfNodeId?{name:o}:{name:o,owner:n?.nodeName(t)??t.slice(t.lastIndexOf("-")+1)}}r(l,"docLinkLabel");function w(e,n=c){const t=l(e,n);return t.owner===void 0?t.name:`${t.name} \xB7 ${t.owner}`}r(w,"docLinkText");function O(e){return[...e.matchAll(f)].map(n=>n[1].trim()).filter(n=>n!=="")}r(O,"extractDocRefs");function R(e,n=c){return n===void 0||!e.includes("[[")?e:e.replace(f,(t,o)=>{const i=o.trim();if(i==="")return t;const d=l(i,n),s=n.pathFor(i),a=m(d.name),u=s===void 0?b(a):`[${a}](${$(s).href}#${x})`;return d.owner===void 0?u:`${u}${D(` \xB7 ${m(d.owner)}`)}`})}r(R,"rewriteProseDocLinks");function m(e){return e.replace(/([\\[\]*_`<>])/g,"\\$1")}r(m,"escapeLabel");export{x as DOC_OPEN_FRAGMENT,l as docLinkLabel,w as docLinkText,O as extractDocRefs,R as rewriteProseDocLinks,E as setDocLinkContext,I as splitDocRef};

package/dist/clients/attach/render/edit-diff.d.ts

@@ -0,0 +1,12 @@
+import { FoldedToolCallController, type FileLineChanges, type ToolResultObserver } from './tool-calls.js';
+export type CrtrEditToolView = {
+    definition: unknown;
+    observeResult: ToolResultObserver;
+};
+/** Count only changed rows in pi's display diff; context and ellipsis rows do
+ *  not contribute to the folded file summary. */
+export declare function countDisplayDiffLines(diff: string): FileLineChanges;
+/** Crouter owns edit presentation while the imported tool owns execution. The
+ *  card has two explicit phases: streamed argument diff, then executed result
+ *  diff. No asynchronous preview can write after settlement. */
+export declare function createCrtrEditToolDefinition(cwd: string, fold?: FoldedToolCallController): CrtrEditToolView;

package/dist/clients/attach/render/edit-diff.js

@@ -0,0 +1,5 @@
+var F=Object.defineProperty;var i=(e,t)=>F(e,"name",{value:t,configurable:!0});import{generateDiffString as _}from"@earendil-works/pi-coding-agent";import{Box as P,Container as N,Spacer as R,Text as y}from"@earendil-works/pi-tui";import{FoldedToolCallController as j,foldedFileCallLine as K}from"./tool-calls.js";const I={r:181,g:189,b:104},O={r:204,g:102,b:102},k={r:40,g:50,b:40};function M(e){if(e<16){const n=[[0,0,0],[205,0,0],[0,205,0],[205,205,0],[0,0,238],[205,0,205],[0,205,205],[229,229,229],[127,127,127],[255,0,0],[0,255,0],[255,255,0],[92,92,255],[255,0,255],[0,255,255],[255,255,255]],[r,o,d]=n[e]??[128,128,128];return{r,g:o,b:d}}if(e<232){const n=e-16,r=[0,95,135,175,215,255];return{r:r[Math.floor(n/36)%6],g:r[Math.floor(n/6)%6],b:r[n%6]}}const t=8+(e-232)*10;return{r:t,g:t,b:t}}i(M,"xterm256ToRgb");function z(e){const t=i(a=>a<48?0:a<115?1:Math.min(5,Math.floor((a-35)/40)),"toCube"),n=[0,95,135,175,215,255],r=t(e.r),o=t(e.g),d=t(e.b),f=16+36*r+6*o+d,m={r:n[r],g:n[o],b:n[d]},c=232+Math.max(0,Math.min(23,Math.round(((e.r+e.g+e.b)/3-8)/10))),p=M(c),h=i((a,w)=>(a.r-w.r)**2+(a.g-w.g)**2+(a.b-w.b)**2,"dist");return h(e,m)<=h(e,p)?f:c}i(z,"rgbTo256");function $(e){const t=e.match(/\x1b\[[34]8;2;(\d+);(\d+);(\d+)m/);if(t)return{r:Number(t[1]),g:Number(t[2]),b:Number(t[3])};const n=e.match(/\x1b\[[34]8;5;(\d+)m/);if(n)return M(Number(n[1]))}i($,"parseAnsiRgb");function D(e,t,n){return{r:Math.round(e.r*n+t.r*(1-n)),g:Math.round(e.g*n+t.g*(1-n)),b:Math.round(e.b*n+t.b*(1-n))}}i(D,"mix");function T(e,t){return t==="truecolor"?`\x1B[48;2;${e.r};${e.g};${e.b}m`:`\x1B[48;5;${z(e)}m`}i(T,"bgOpen");function v(e,t,n){try{return $(e.getFgAnsi(t))??n}catch{return n}}i(v,"themeFgRgb");function G(e,t,n){try{return $(e.getBgAnsi(t))??n}catch{return n}}i(G,"themeBgRgb");function A(e){const t=e.match(/^([+-\s])(\s*\d*)\s(.*)$/);return t?{prefix:t[1],lineNum:t[2],content:t[3]}:null}i(A,"parseDisplayDiffLine");function V(e){let t=0,n=0;for(const r of e.split(`
+`)){const o=A(r);o?.prefix==="+"&&t++,o?.prefix==="-"&&n++}return{added:t,removed:n}}i(V,"countDisplayDiffLines");function q(e){const t=e;return Array.isArray(t?.edits)?t.edits.flatMap(n=>{const r=n;return typeof r?.oldText=="string"&&typeof r?.newText=="string"?[{oldText:r.oldText,newText:r.newText}]:[]}):typeof t?.oldText=="string"&&typeof t?.newText=="string"?[{oldText:t.oldText,newText:t.newText}]:[]}i(q,"editPairs");function H(e){const t=q(e).map(({oldText:n,newText:r})=>_(n,r).diff).filter(n=>n.trim().length>0);return t.length>0?t.join(`
+`):void 0}i(H,"streamedArgumentDiff");function B(e){return e.replace(/\t/g,"   ")}i(B,"replaceTabs");function J(e,t){const n=Math.min(e.length,t.length);let r=0;for(;r<n&&e[r]===t[r];)r++;let o=0;for(;o<n-r&&e[e.length-1-o]===t[t.length-1-o];)o++;return{old:[r,e.length-o],new:[r,t.length-o]}}i(J,"changedSpans");function L(e,t,n,r){const[o,d]=t;return d<=o?e:e.slice(0,o)+n+e.slice(o,d)+r+e.slice(d)}i(L,"emphasize");function Q(e,t,n){const r=t.getColorMode(),o=G(t,"toolSuccessBg",k),d=v(t,"toolDiffAdded",I),f=v(t,"toolDiffRemoved",O),m=T(D(d,o,.24),r),b=T(D(d,o,.48),r),c=T(D(f,o,.24),r),p=T(D(f,o,.48),r),h=new N,a=i((l,u)=>{const x=u===void 0?void 0:s=>u+s+n;h.addChild(new y(l,0,0,x))},"pushLine"),w=i((l,u)=>{a(`${t.fg("toolDiffRemoved",`-${l}`)} ${u}`,c)},"pushRemoved"),E=i((l,u)=>{a(`${t.fg("toolDiffAdded",`+${l}`)} ${u}`,m)},"pushAdded"),C=e.split(`
+`);let g=0;for(;g<C.length;){const l=A(C[g]);if(!l){a(t.fg("toolDiffContext",C[g])),g++;continue}if(l.prefix==="-"){const u=[];for(;g<C.length;){const s=A(C[g]);if(!s||s.prefix!=="-")break;u.push({lineNum:s.lineNum,content:B(s.content)}),g++}const x=[];for(;g<C.length;){const s=A(C[g]);if(!s||s.prefix!=="+")break;x.push({lineNum:s.lineNum,content:B(s.content)}),g++}if(u.length===1&&x.length===1){const s=J(u[0].content,x[0].content);w(u[0].lineNum,L(u[0].content,s.old,p,c)),E(x[0].lineNum,L(x[0].content,s.new,b,m))}else{for(const s of u)w(s.lineNum,s.content);for(const s of x)E(s.lineNum,s.content)}}else l.prefix==="+"?(E(l.lineNum,B(l.content)),g++):(a(t.fg("toolDiffContext",` ${l.lineNum} ${B(l.content)}`)),g++)}return h}i(Q,"buildDiffBody");class U extends P{static{i(this,"EditCallComponent")}constructor(){super(1,1,t=>t)}update(t,n,r,o){const d=r.settled?r.isError?"toolErrorBg":"toolSuccessBg":"toolPendingBg";this.setBgFn(f=>o.bg(d,f)),this.clear(),this.addChild(new y(t,0,0)),n&&(this.addChild(new R(1)),this.addChild(Q(n,o,o.getBgAnsi(d))))}}function W(e){const t=e;return typeof t?.file_path=="string"?t.file_path:typeof t?.path=="string"?t.path:""}i(W,"editPath");function X(e){return(e.content??[]).filter(t=>t.type==="text"&&typeof t.text=="string").map(t=>t.text).join(`
+`)}i(X,"errorResultText");function et(e,t=new j){const n={settled:!1,isError:!1},r=new U;return{definition:{name:"edit",label:"edit",description:"Render streamed edit arguments and the executed full-file diff in the attach viewer.",parameters:{},renderShell:"self",renderCall(f,m,b){const c=n.settled?n.diff:H(f),p=n.settled&&!n.isError&&n.diff?V(n.diff):void 0,h=K("edit",W(f),m,b.cwd??e,p);return t.folded?t.capture(new y(h,0,0)):(r.update(h,c,n,m),t.capture(r))},renderResult(f,m,b,c){const p=c.lastComponent instanceof N?c.lastComponent:new N;if(p.clear(),!c.isError)return p;const h=X(f);return h&&(p.addChild(new R(1)),p.addChild(new y(b.fg("error",h),1,0))),p}},observeResult:i((f,m)=>{if(m)return;n.settled=!0,n.isError=f.isError===!0;const b=f.details,c=b!==null&&typeof b=="object"?b.diff:void 0;n.diff=!n.isError&&typeof c=="string"?c:void 0},"observeResult")}}i(et,"createCrtrEditToolDefinition");export{V as countDisplayDiffLines,et as createCrtrEditToolDefinition};

package/dist/clients/attach/render/glyph-codepoints.d.ts

@@ -0,0 +1,3 @@
+/** Replace every private-use `U+XXXX` reference in `text` with the character it
+ *  names. Non-PUA references and malformed digits pass through untouched. */
+export declare function expandGlyphCodepoints(text: string): string;

package/dist/clients/attach/render/glyph-codepoints.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var f=(r,n)=>i(r,"name",{value:n,configurable:!0});const t=/\bU\+([0-9A-Fa-f]{4,6})\b/g;function o(r){return r>=57344&&r<=63743||r>=983040&&r<=1048573||r>=1048576&&r<=1114109}f(o,"isPrivateUse");function d(r){return!r.includes("U+")&&!r.includes("u+")?r:r.replace(t,(n,u)=>{const e=Number.parseInt(u,16);if(!o(e))return n;try{return String.fromCodePoint(e)}catch{return n}})}f(d,"expandGlyphCodepoints");export{d as expandGlyphCodepoints};

package/dist/clients/attach/render/group-activity.d.ts

@@ -0,0 +1,84 @@
+import type { CardPresentation } from './card-presentation.js';
+import { type GeneratedCard } from '../../../shared/generated-context.js';
+export type FileActivity = {
+    key: string;
+    displayPath: string;
+    kind: 'edit' | 'write';
+    added: number;
+    removed: number;
+    hasKnownCounts: boolean;
+    countsIncomplete: boolean;
+};
+/** One canvas document this group read, wrote, edited or deleted, by its full
+ * name (`<owner-handle>/<name>`). Documents are canvas rows, not files, so the
+ * chip carries no path to hyperlink. */
+export type DocumentActivity = {
+    action: 'read' | 'write' | 'edit' | 'delete';
+    name: string;
+};
+/** One node this group started or saw finish. `name` is the spawn's display
+ * name, or the node id when the finish has no matching spawn in this session. */
+export type NodeActivity = {
+    action: 'spawned' | 'finished';
+    name: string;
+    id: string;
+};
+/** A card whose fold-time contribution is structured: its own summary line. */
+export type CardActivity = {
+    summary: string;
+};
+/** A card that folds to one terse line. Repeats compress into `count` so a run
+ * of recoveries costs one row, not one row each. */
+export type EventActivity = {
+    text: string;
+    count: number;
+};
+export type GroupActivity = {
+    files: readonly FileActivity[];
+    documents: readonly DocumentActivity[];
+    nodes: readonly NodeActivity[];
+    cards: readonly CardActivity[];
+    events: readonly EventActivity[];
+    /** Distinct events past the budget, so the recap can say what it dropped. */
+    eventsOmitted: number;
+};
+/** Per-group recorder. Calls retain only their current transcript references
+ * until they settle; the settled activity is plain immutable evidence. */
+export declare class GroupActivityRecorder {
+    private readonly cwd;
+    private readonly roster;
+    private readonly calls;
+    private readonly files;
+    private readonly documents;
+    private readonly documentSet;
+    private readonly nodes;
+    private readonly nodeSet;
+    private readonly cards;
+    private readonly cardSet;
+    private readonly events;
+    private eventsOmitted;
+    /** `roster` is the ChatView-wide node id → display name record: spawns fill
+     * it, and a later group's finish reads the name a sibling group recorded. */
+    constructor(cwd: string, roster?: Map<string, string>);
+    /** What one runtime card leaves behind when its group folds, decided entirely
+     * by the card's presentation policy. */
+    noteCard(card: GeneratedCard, presentation: CardPresentation): void;
+    noteCall(id: string, name: string, args: unknown): void;
+    settle(id: string, result: unknown, isError: boolean): void;
+    resolveWithoutResult(id: string): void;
+    activity(): GroupActivity;
+    /** The nodes an inbox digest reports finished. The spawn roster supplies the
+     * display name when it has one. A sender carrying only the person's own words
+     * is the human speaking, not a node that finished. */
+    private addFinishedSenders;
+    private addCard;
+    private addEvent;
+    private addNode;
+    /** The recorded leaf path is authoritative: which command ran and what it
+     * returned are both facts here, so a read can never be logged as a save and
+     * an inserted output field can never break a chip. A record carrying an
+     * `error` is a failed call, which is not activity. */
+    private noteCrtrInvocation;
+    private addDocument;
+    private extract;
+}

package/dist/clients/attach/render/group-activity.js

@@ -0,0 +1,2 @@
+var m=Object.defineProperty;var o=(s,t)=>m(s,"name",{value:t,configurable:!0});import{homedir as u}from"node:os";import{join as l,resolve as p}from"node:path";import{isHumanWordsEntry as v}from"../../../shared/generated-context.js";import{crtrPreviewRecords as w}from"../../../core/preview-registry.js";import{countDisplayDiffLines as g}from"./edit-diff.js";const O=3,y=Object.freeze({files:Object.freeze([]),documents:Object.freeze([]),nodes:Object.freeze([]),cards:Object.freeze([]),events:Object.freeze([]),eventsOmitted:0});function c(s){return typeof s=="object"&&s!==null?s:void 0}o(c,"object");function z(s){const t=c(s),e=t?.file_path??t?.path;return typeof e=="string"&&e!==""?e:void 0}o(z,"filePath");function b(s){return s.length===0?0:(s.match(/\n/g)?.length??0)+(s.endsWith(`
+`)?0:1)}o(b,"lineCount");function a(s){return typeof s=="string"&&s!==""?s:void 0}o(a,"text");const j={"doc write":"write","doc edit":"edit","doc delete":"delete"};function k(s){if(s.type!=="document")return;const t=c(s.object),e=t===void 0?void 0:a(t.name);if(e===void 0)return;const n=a(c(t?.owner)?.handle);return n===void 0?e:`${n}/${e}`}o(k,"readDocumentName");function S(s,t){const e=s==="~"?u():s.startsWith("~/")?l(u(),s.slice(2)):s;return p(t,e)}o(S,"canonicalPath");function C(s,t,e){if(s==="edit"){const n=c(c(e)?.details)?.diff;return typeof n=="string"?{kind:"edit",...g(n),known:!0}:{kind:"edit",added:0,removed:0,known:!1}}if(s==="write"){const n=c(t)?.content;return typeof n=="string"?{kind:"write",added:b(n),removed:0,known:!0}:{kind:"write",added:0,removed:0,known:!1}}}o(C,"fileChange");class M{static{o(this,"GroupActivityRecorder")}cwd;roster;calls=new Map;files=new Map;documents=[];documentSet=new Set;nodes=[];nodeSet=new Set;cards=[];cardSet=new Set;events=new Map;eventsOmitted=0;constructor(t,e=new Map){this.cwd=t,this.roster=e}noteCard(t,e){switch(e.groupFolded){case"omit":return;case"event":this.addEvent(e.summary(t));return;case"activity":this.addCard({summary:e.summary(t)});return;case"senders":this.addFinishedSenders(t);return}}noteCall(t,e,n){this.calls.get(t)?.settled||this.calls.set(t,{name:e,args:n,settled:!1})}settle(t,e,n){const i=this.calls.get(t);!i||i.settled||(i.settled=!0,!n&&c(e)?.isError!==!0&&this.extract(i,e),i.args=void 0)}resolveWithoutResult(t){const e=this.calls.get(t);!e||e.settled||(e.settled=!0,e.args=void 0)}activity(){if(this.files.size===0&&this.documents.length===0&&this.nodes.length===0&&this.cards.length===0&&this.events.size===0)return y;const t=[...this.files.values()].map(d=>Object.freeze({...d})),e=this.documents.map(d=>Object.freeze({...d})),n=this.nodes.map(d=>Object.freeze({...d})),i=this.cards.map(d=>Object.freeze({...d})),f=[...this.events].map(([d,r])=>Object.freeze({text:d,count:r}));return Object.freeze({files:Object.freeze(t),documents:Object.freeze(e),nodes:Object.freeze(n),cards:Object.freeze(i),events:Object.freeze(f),eventsOmitted:this.eventsOmitted})}addFinishedSenders(t){for(const e of t.senders){const n=e.entries.length>0&&e.entries.every(v);!e.finished||n||this.addNode({action:"finished",name:this.roster.get(e.id)??e.id,id:e.id})}}addCard(t){const e=t.summary;this.cardSet.has(e)||(this.cardSet.add(e),this.cards.push(t))}addEvent(t){const e=t.trim();if(e==="")return;const n=this.events.get(e);if(n!==void 0){this.events.set(e,n+1);return}if(this.events.size>=O){this.eventsOmitted+=1;return}this.events.set(e,1)}addNode(t){const e=`${t.action}:${t.id}`;this.nodeSet.has(e)||(this.nodeSet.add(e),this.nodes.push(t),t.action==="spawned"&&this.roster.set(t.id,t.name))}noteCrtrInvocation(t){if(t.error!==void 0||t.result===void 0)return;const e=t.result;switch(t.path){case"canvas read":{const n=k(e);n!==void 0&&this.addDocument({action:"read",name:n});return}case"doc write":case"doc edit":case"doc delete":{const n=a(e.name);if(n===void 0)return;this.addDocument({action:j[t.path],name:n});return}case"node new":{if(e.frozen_at!==void 0&&e.frozen_at!==null)return;const n=a(e.node_id),i=a(e.name);n!==void 0&&i!==void 0&&this.addNode({action:"spawned",name:i,id:n});return}default:return}}addDocument(t){const e=`${t.action}:${t.name}`;this.documentSet.has(e)||(this.documentSet.add(e),this.documents.push(t))}extract(t,e){if(t.name==="bash"){for(const h of w(e))this.noteCrtrInvocation(h);return}const n=z(t.args),i=C(t.name,t.args,e);if(!n||!i)return;const f=S(n,this.cwd),d=`${i.kind}:${f}`;let r=this.files.get(d);r||(r={key:f,displayPath:n,kind:i.kind,added:0,removed:0,hasKnownCounts:!1,countsIncomplete:!1},this.files.set(d,r)),r.added+=i.added,r.removed+=i.removed,r.hasKnownCounts||=i.known,r.countsIncomplete||=!i.known}}export{M as GroupActivityRecorder};

package/dist/clients/attach/render/group-recap.d.ts

@@ -0,0 +1,13 @@
+import { Container } from '@earendil-works/pi-tui';
+import type { AttachPalette } from '../config.js';
+import type { ToolGroupSummary } from '../../../shared/tool-groups.js';
+import type { GroupActivity } from './group-activity.js';
+/** Direct history child for a folded group. It is empty (zero rows) unless the
+ * group is eligible to collapse, preserving the member rows for Ctrl+O. */
+export declare class GroupRecapComponent extends Container {
+    setRecap(summary: ToolGroupSummary | undefined, toolCount: number, activity: GroupActivity, detailed: boolean, palette: AttachPalette): void;
+    /** Runtime cards the fold hid. Terse events are already compressed by count,
+     * so every card contributes exactly one row. */
+    private addCardEvidence;
+    private addFile;
+}

package/dist/clients/attach/render/group-recap.js

@@ -0,0 +1 @@
+var S=Object.defineProperty;var t=(i,n)=>S(i,"name",{value:n,configurable:!0});import{Container as b,Spacer as x,Text as f,getCapabilities as _,hyperlink as k,truncateToWidth as p,visibleWidth as O}from"@earendil-works/pi-tui";import{homedir as F}from"node:os";import{pathToFileURL as P}from"node:url";import{ICON as l}from"../../../core/inspector/model.js";import{TOOL_ICON as h}from"../../../core/preview-registry.js";const A=String.fromCodePoint(61485),v=String.fromCodePoint(61944),N=String.fromCodePoint(61530);function c(i,n,d){return`${i} ${i===1?n:d}`}t(c,"count");function L(i){const n=F();return i.startsWith(n)?`~${i.slice(n.length)}`:i}t(L,"shortened");function M(i){const n=L(i.displayPath);return _().hyperlinks?k(n,P(i.key).href):n}t(M,"filePath");function U(i,n){return i.filter(d=>d.action===n).length}t(U,"countDocuments");const T={read:A,write:h.write,edit:h.edit,delete:v},W=[["read","document read","documents read"],["write","document saved","documents saved"],["edit","document revised","documents revised"],["delete","document deleted","documents deleted"]];function K(i){return new Set(i.map(n=>n.key)).size}t(K,"distinctFileCount");function D(i,n){return i.filter(d=>d.action===n).length}t(D,"countNodes");class C{static{t(this,"RecapDetailLine")}prefix;path;suffix;constructor(n,d,o){this.prefix=n,this.path=d,this.suffix=o}invalidate(){}render(n){const d=Math.max(1,n-O(this.prefix)-O(this.suffix)),o=p(this.path,d,"\u2026");return[p(`${this.prefix}${o}${this.suffix}`,n,"")]}}class J extends b{static{t(this,"GroupRecapComponent")}setRecap(n,d,o,r,e){if(this.clear(),!n)return;if(this.addChild(new x(1)),r){for(const s of o.nodes)this.addChild(new C(`${e.accent(l.graph)} `,e.muted(s.name),e.muted(s.action==="spawned"?" spawned":" finished")));for(const s of o.documents){const m=T[s.action],a=s.action==="delete"?e.diffRemoved:e.info;this.addChild(new C(`${a(m)} `,e.muted(s.name),""))}for(const s of o.files)this.addFile(s,e)}const u=`${e.active(h.bash)} ${e.muted(c(d,"tool call","tool calls"))}`;if(r)this.addChild(new f(u,0,0));else{const s=[u],m=D(o.nodes,"spawned");m>=1&&s.push(`${e.accent(l.graph)} ${e.muted(c(m,"node spawned","nodes spawned"))}`);const a=D(o.nodes,"finished");a>=1&&s.push(`${e.accent(l.graph)} ${e.muted(c(a,"node finished","nodes finished"))}`);const w=K(o.files);w>=1&&s.push(`${e.warning(h.edit)} ${e.muted(c(w,"file changed","files changed"))}`),n.filesDeleted>=1&&s.push(`${e.diffRemoved(v)} ${e.muted(c(n.filesDeleted,"file deleted","files deleted"))}`);for(const[$,R,E]of W){const g=U(o.documents,$);if(g<1)continue;const I=$==="delete"?e.diffRemoved:e.info;s.push(`${I(T[$])} ${e.muted(c(g,R,E))}`)}this.addChild(new f(s.join(e.muted(" \xB7 ")),0,0))}this.addCardEvidence(o,e);for(const s of n.bullets)this.addChild(new f(e.muted(`  \u2022 ${s.trim()}`),0,0));this.addChild(new x(1))}addCardEvidence(n,d){for(const o of n.cards)this.addChild(new f(`${d.info(N)} ${d.muted(o.summary)}`,0,0));for(const o of n.events){const r=o.count>1?` \xD7${o.count}`:"";this.addChild(new f(`${d.info(N)} ${d.muted(`${o.text}${r}`)}`,0,0))}n.eventsOmitted>0&&this.addChild(new f(d.muted(`  ${c(n.eventsOmitted,"more runtime event","more runtime events")}`),0,0))}addFile(n,d){const o=n.hasKnownCounts?`${d.diffAdded(`+${n.added}`)}${n.kind==="edit"?` ${d.diffRemoved(`-${n.removed}`)}`:""}`:"",r=n.countsIncomplete?d.muted(n.hasKnownCounts?" \xB7 counts incomplete":"counts unavailable"):"",e=o||r?` ${o}${r}`:"",u=n.kind==="write"?h.write:h.edit;this.addChild(new C(`${d.warning(u)} `,M(n),e))}}export{J as GroupRecapComponent};

package/dist/clients/attach/render/markdown-source.d.ts

@@ -0,0 +1,16 @@
+/** Decorate a Markdown block for terminal rendering: heading hierarchy and XML
+ *  tag lines. Fenced examples remain literal Markdown, never decorated
+ *  terminal output. */
+export declare function styleAttachMarkdownSource(markdown: string): string;
+/** Every source-text transform the viewer applies to AGENT-authored Markdown,
+ *  in one place: heading and XML syntax, then glyph expansion. A human's own
+ *  message keeps `styleAttachMarkdownSource` alone — the `U+XXXX` escape hatch
+ *  exists for agents that cannot type a Nerd Font character. */
+export declare function styleAttachAgentMarkdown(markdown: string): string;
+/** Copy a pi message for terminal rendering and decorate only Markdown-bearing
+ * text/thinking blocks. The broker's source event is never mutated. */
+export declare function styleAttachMessageMarkdown<T>(message: T): T;
+/** Copy an expanded pi summary without changing its persisted source. */
+export declare function styleAttachSummaryMarkdown<T extends {
+    summary: string;
+}>(message: T): T;

package/dist/clients/attach/render/markdown-source.js

@@ -0,0 +1,5 @@
+var m=Object.defineProperty;var c=(t,i)=>m(t,"name",{value:i,configurable:!0});import{pathToFileURL as x}from"node:url";import{expandGlyphCodepoints as y}from"./glyph-codepoints.js";import{rewriteProseDocLinks as $}from"./doc-links.js";const A=/^(\s{0,3})(#{3,6})(?:[ \t]+|$)(.*?)([ \t]+#+[ \t]*)?$/,h=/^\s{0,3}(`{3,}|~{3,})/,L=/^([ \t]{0,3})(<\/?)([A-Za-z][\w.:-]*)((?:[ \t]+[^<>]*?)?)(\/?)>[ \t]*$/,b=/([^\s=]+)(?:=("[^"]*"|'[^']*'|[^\s]*))?/g,k=[[232,194,104],[207,194,145],[181,184,174],[157,170,180],[135,153,164],[116,135,147]],d=[104,112,124],M=[138,166,196],a=[124,146,164],E=[168,142,118];function f(t,i){return`\x1B[38;2;${t[0]};${t[1]};${t[2]}m${i}\x1B[39m`}c(f,"paint");function w(t){const[i,n,e]=k[t-1];return o=>`\x1B[1;38;2;${i};${n};${e}m${o}\x1B[22;39m`}c(w,"headingColor");function T(t){const i=A.exec(t);if(!i)return;const[,n,e,o]=i;if(o!=="")return`${n}${w(e.length)(o)}`}c(T,"styleHeadingLine");function _(t){return t.replace(b,(i,n,e)=>e===void 0?f(a,i):`${f(a,n)}${f(d,"=")}${f(E,e)}`)}c(_,"styleAttributes");function N(t){const i=L.exec(t);if(!i)return;const[,n,e,o,r,u]=i;return n+f(d,e)+f(M,o)+_(r)+f(d,`${u}>`)}c(N,"styleXmlTagLine");function I(t){const i=t.split(`
+`),n=[];let e;for(let o=0;o<i.length;o++){const r=i[o],u=h.exec(r);if(e!==void 0){u?.[1][0]===e&&(e=void 0),n.push(r);continue}if(u){e=u[1][0],n.push(r);continue}const l=N(r);if(l!==void 0){n.length>0&&n[n.length-1].trim()!==""&&n.push(""),n.push(l),i[o+1]!==void 0&&i[o+1].trim()!==""&&n.push("");continue}n.push(T(r)??r)}return n.join(`
+`)}c(I,"styleAttachMarkdownSource");function s(t){return y(I(X(t)))}c(s,"styleAttachAgentMarkdown");function X(t){let i;return t.split(`
+`).map(n=>{const e=h.exec(n);return i!==void 0?(e?.[1][0]===i&&(i=void 0),n):e?(i=e[1][0],n):C(n)}).join(`
+`)}c(X,"rewriteAbsoluteFileLinks");function C(t){let i="",n=t;for(;n!=="";){const e=n.match(/`+/),o=e===null?n:n.slice(0,e.index);if(i+=U($(o)),e===null)break;const r=e[0],u=n.indexOf(r,o.length+r.length);if(u===-1)return i+n.slice(o.length);i+=n.slice(o.length,u+r.length),n=n.slice(u+r.length)}return i}c(C,"rewriteInlineFileLinks");function U(t){let i="",n=0;for(;n<t.length;){const e=t.indexOf("[",n);if(e===-1)return i+t.slice(n);const o=F(t,e);if(o===void 0){i+=t.slice(n,e+1),n=e+1;continue}i+=t.slice(n,e)+`[${o.label}](${x(o.path).href}#crtr-file-open)`,n=o.end}return i}c(U,"rewriteProseFileLinks");function F(t,i){const n=p(t,i+1,"]");if(n===void 0||t[n+1]!=="(")return;const e=n+2;if(t[e]==="<"){const r=p(t,e+1,">");if(r===void 0||t[r+1]!==")")return;const u=g(t.slice(e+1,r));return u===void 0?void 0:{label:t.slice(i+1,n),path:u,end:r+2}}let o=0;for(let r=e;r<t.length;r++){if(t[r]==="\\"){r++;continue}if(t[r]==="("){o++;continue}if(t[r]!==")"||o-- >0)continue;const u=g(t.slice(e,r));return u===void 0?void 0:{label:t.slice(i+1,n),path:u,end:r+1}}}c(F,"parseLocalMarkdownLink");function p(t,i,n){for(let e=i;e<t.length;e++){if(t[e]==="\\"){e++;continue}if(t[e]===n)return e}}c(p,"closingDelimiter");function g(t){const i=t.replace(/\\([!"#$%&'()*+,./:;<=>?@[\\\]^_`{|}~-])/g,"$1");let n=i;try{n=decodeURIComponent(i)}catch{}return n.startsWith("/")?n:void 0}c(g,"localPathFromDestination");function j(t){if(typeof t!="object"||t===null||!("content"in t))return t;const i=t;return typeof i.content=="string"?{...i,content:s(i.content)}:Array.isArray(i.content)?{...i,content:i.content.map(n=>{if(typeof n!="object"||n===null)return n;const e=n;return e.type==="text"&&typeof e.text=="string"?{...e,text:s(e.text)}:e.type==="thinking"&&typeof e.thinking=="string"?{...e,thinking:s(e.thinking)}:n})}:t}c(j,"styleAttachMessageMarkdown");function G(t){return{...t,summary:s(t.summary)}}c(G,"styleAttachSummaryMarkdown");export{s as styleAttachAgentMarkdown,I as styleAttachMarkdownSource,j as styleAttachMessageMarkdown,G as styleAttachSummaryMarkdown};

package/dist/clients/attach/render/measured-container.d.ts

@@ -0,0 +1,96 @@
+import { Container, type Component } from '@earendil-works/pi-tui';
+/** The block at the viewport's top row, plus the line offset within it. */
+export interface ScrollAnchor {
+    block: Component;
+    offset: number;
+}
+/** A measurable, sliceable ordered block list. The viewport never touches
+ * components directly — it addresses blocks by flat index, and holds scroll
+ * position as a block identity. */
+export interface ViewportSource {
+    /** Visible blocks, in visual order. */
+    blockCount(): number;
+    /** Rendered line count of block `i` at `width` (renders + caches on miss). */
+    blockHeight(i: number, width: number): number;
+    /** Cached rendered lines of block `i` at `width`. */
+    blockLines(i: number, width: number): readonly string[];
+    /** Total rendered lines at `width`. */
+    totalHeight(width: number): number;
+    /** Absolute content line at which block `i` starts. */
+    blockStart(i: number, width: number): number;
+    /** The block component at flat index `i`. */
+    blockAt(i: number): Component | undefined;
+    /** The anchor for the block containing absolute line `line`. */
+    anchorAt(line: number, width: number): ScrollAnchor | undefined;
+    /** Absolute top line for `anchor` against current measurements, or undefined
+     * when the block is gone entirely. */
+    anchorLine(anchor: ScrollAnchor, width: number): number | undefined;
+    /** Clear cached measurements after a component-level invalidation. */
+    invalidate(): void;
+    /** Monotonic; bumped by every structural or content mutation. */
+    revision(): number;
+}
+/**
+ * A container whose direct children are independently rendered and measured.
+ *
+ * `children` is public on pi-tui's Container, but it must never be mutated from
+ * outside these methods: this class owns the visible-index, height, and prefix
+ * invariants that make identity anchors safe across transcript mutations.
+ */
+export declare class MeasuredContainer extends Container implements ViewportSource {
+    private readonly childCache;
+    /** Direct children hidden by a collapsed tool-group summary. Never wrap a
+     * child: the cache and pi callback paths both key on this exact identity. */
+    readonly hiddenChildren: Set<Component>;
+    /** Rendered line counts for visible children at `measureWidth`. */
+    private heights;
+    /** `prefix[i]` is the start line of visible child `i`. */
+    private prefix;
+    /** The first visible-child index whose prefix onward must be rebuilt. */
+    private prefixValidTo;
+    private visibleChildren;
+    private measureWidth;
+    private mutationRevision;
+    addChild(component: Component): void;
+    setHidden(component: Component, hidden: boolean): void;
+    markDirty(component?: Component): void;
+    removeChild(component: Component): void;
+    clear(): void;
+    invalidate(): void;
+    render(width: number): string[];
+    blockCount(): number;
+    blockHeight(index: number, width: number): number;
+    blockLines(index: number, width: number): readonly string[];
+    totalHeight(width: number): number;
+    blockStart(index: number, width: number): number;
+    blockAt(index: number): Component | undefined;
+    anchorAt(line: number, width: number): ScrollAnchor | undefined;
+    anchorLine(anchor: ScrollAnchor, width: number): number | undefined;
+    revision(): number;
+    private visible;
+    private visibleIndexOf;
+    private ensureWidth;
+    private dropMeasurements;
+    private linesFor;
+    private rawLinesFor;
+    private invalidateHeight;
+    /** Rebuild the prefix ending at `endExclusive`; `prefixValidTo` is the first
+     * child whose height/prefix may be stale, so `prefix[prefixValidTo]` is valid. */
+    private rebuildPrefixThrough;
+}
+/** Concatenates measured containers into the transcript's one flat block space. */
+export declare class CompositeViewportSource implements ViewportSource {
+    private readonly parts;
+    constructor(parts: readonly MeasuredContainer[]);
+    blockCount(): number;
+    blockHeight(index: number, width: number): number;
+    blockLines(index: number, width: number): readonly string[];
+    totalHeight(width: number): number;
+    blockStart(index: number, width: number): number;
+    blockAt(index: number): Component | undefined;
+    anchorAt(line: number, width: number): ScrollAnchor | undefined;
+    anchorLine(anchor: ScrollAnchor, width: number): number | undefined;
+    invalidate(): void;
+    revision(): number;
+    private locate;
+}

package/dist/clients/attach/render/measured-container.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var o=(l,i)=>u(l,"name",{value:i,configurable:!0});import{Container as f}from"@earendil-works/pi-tui";class v extends f{static{o(this,"MeasuredContainer")}childCache=new Map;hiddenChildren=new Set;heights=[];prefix=[0];prefixValidTo=0;visibleChildren;measureWidth;mutationRevision=0;addChild(i){const e=this.visible().length;super.addChild(i),this.visibleChildren=void 0,this.heights.push(void 0),this.prefixValidTo=Math.min(this.prefixValidTo,e),this.mutationRevision++}setHidden(i,e){const t=this.hiddenChildren.has(i),s=t?void 0:this.visibleIndexOf(i);if(e?this.hiddenChildren.add(i):this.hiddenChildren.delete(i),this.childCache.delete(i),!t&&e&&s!==void 0)this.heights.splice(s,1),this.invalidateHeight(s);else if(t&&!e){this.visibleChildren=void 0;const h=this.visibleIndexOf(i);h!==void 0&&(this.heights.splice(h,0,void 0),this.invalidateHeight(h),this.invalidateHeight(h+1))}else s!==void 0&&(this.invalidateHeight(s),this.invalidateHeight(s+1));this.visibleChildren=void 0,this.mutationRevision++}markDirty(i){if(i){const e=this.visibleIndexOf(i);this.childCache.delete(i),e!==void 0&&(this.invalidateHeight(e),this.invalidateHeight(e+1))}else this.dropMeasurements();this.mutationRevision++}removeChild(i){const e=this.visibleIndexOf(i);super.removeChild(i),this.childCache.delete(i),this.hiddenChildren.delete(i),e!==void 0&&(this.heights.splice(e,1),this.invalidateHeight(e)),this.visibleChildren=void 0,this.mutationRevision++}clear(){super.clear(),this.childCache.clear(),this.hiddenChildren.clear(),this.heights=[],this.prefix=[0],this.prefixValidTo=0,this.visibleChildren=void 0,this.mutationRevision++}invalidate(){super.invalidate(),this.dropMeasurements(),this.mutationRevision++}render(i){this.ensureWidth(i);const e=[];for(let t=0;t<this.visible().length;t++)e.push(...this.linesFor(t,i));return e}blockCount(){return this.visible().length}blockHeight(i,e){return this.ensureWidth(e),this.linesFor(i,e).length}blockLines(i,e){return this.ensureWidth(e),this.linesFor(i,e)}totalHeight(i){return this.ensureWidth(i),this.rebuildPrefixThrough(this.visible().length,i),this.prefix[this.visible().length]??0}blockStart(i,e){return this.ensureWidth(e),i<0||i>=this.visible().length?0:(this.rebuildPrefixThrough(i,e),this.prefix[i]??0)}blockAt(i){return this.visible()[i]}anchorAt(i,e){this.ensureWidth(e);const t=this.visible().length;this.rebuildPrefixThrough(t,e);const s=this.prefix[t]??0;if(i<0||i>=s)return;let h=0,n=t-1;for(;h<=n;){const r=Math.floor((h+n)/2),d=this.prefix[r]??0,a=this.prefix[r+1]??d;if(i<d)n=r-1;else if(i>=a)h=r+1;else return{block:this.visible()[r],offset:i-d}}}anchorLine(i,e){this.ensureWidth(e);const t=this.children.indexOf(i.block);if(t===-1)return;const s=this.visibleIndexOf(i.block);if(s!==void 0){const h=this.blockHeight(s,e);return h===0?this.blockStart(s,e):this.blockStart(s,e)+Math.min(i.offset,h-1)}for(let h=t-1;h>=0;h--){const n=this.children[h],r=this.visibleIndexOf(n);if(r!==void 0)return this.blockStart(r,e)}return 0}revision(){return this.mutationRevision}visible(){return this.visibleChildren||(this.visibleChildren=this.children.filter(i=>!this.hiddenChildren.has(i))),this.visibleChildren}visibleIndexOf(i){const e=this.visible().indexOf(i);return e===-1?void 0:e}ensureWidth(i){this.measureWidth!==i&&(this.measureWidth=i,this.dropMeasurements())}dropMeasurements(){this.childCache.clear(),this.heights=this.visible().map(()=>{}),this.prefix=[0],this.prefixValidTo=0}linesFor(i,e){const t=this.rawLinesFor(i,e),h=this.rawLinesFor(i-1,e).at(-1)===""&&t[0]===""?t.slice(1):t;return this.heights[i]=h.length,h}rawLinesFor(i,e){const t=this.visible()[i];if(!t)return[];let s=this.childCache.get(t);return(!s||s.width!==e)&&(s={width:e,lines:t.render(e)},this.childCache.set(t,s)),s.lines}invalidateHeight(i){i<0||(i<this.heights.length&&(this.heights[i]=void 0),this.prefix.length=this.heights.length+1,this.prefixValidTo=Math.min(this.prefixValidTo,Math.min(i,this.heights.length)))}rebuildPrefixThrough(i,e){const t=this.visible().length,s=Math.min(Math.max(i,0),t),h=Math.min(this.prefixValidTo,s);this.prefix.length===0&&(this.prefix=[0]),this.prefix[0]=0;for(let n=h;n<s;n++){const r=this.heights[n]??this.linesFor(n,e).length;this.prefix[n+1]=(this.prefix[n]??0)+r}s>this.prefixValidTo&&(this.prefixValidTo=s)}}class g{static{o(this,"CompositeViewportSource")}parts;constructor(i){this.parts=i}blockCount(){return this.parts.reduce((i,e)=>i+e.blockCount(),0)}blockHeight(i,e){const t=this.locate(i);return t?t.part.blockHeight(t.index,e):0}blockLines(i,e){const t=this.locate(i);return t?t.part.blockLines(t.index,e):[]}totalHeight(i){return this.parts.reduce((e,t)=>e+t.totalHeight(i),0)}blockStart(i,e){let t=0;for(const s of this.parts){const h=s.blockCount();if(i<h)return t+s.blockStart(i,e);i-=h,t+=s.totalHeight(e)}return 0}blockAt(i){const e=this.locate(i);return e?.part.blockAt(e.index)}anchorAt(i,e){if(!(i<0))for(const t of this.parts){const s=t.totalHeight(e);if(i<s)return t.anchorAt(i,e);i-=s}}anchorLine(i,e){let t=0;for(const s of this.parts){const h=s.anchorLine(i,e);if(h!==void 0)return t+h;t+=s.totalHeight(e)}}invalidate(){for(const i of this.parts)i.invalidate()}revision(){return this.parts.reduce((i,e)=>i+e.revision(),0)}locate(i){if(!(i<0))for(const e of this.parts){const t=e.blockCount();if(i<t)return{part:e,index:i};i-=t}}}export{g as CompositeViewportSource,v as MeasuredContainer};

package/dist/clients/attach/render/page-block.d.ts

@@ -0,0 +1,37 @@
+import type { Component } from '@earendil-works/pi-tui';
+export interface InlinePageRef {
+    pageId: string;
+}
+/**
+ * The inline page a `human send` tool result announces, or undefined for every
+ * other result. Read from the structured CLI record the canvas-preview extension
+ * attaches (`details.crtrPreview`), which is present on both live tool events and
+ * rebuilt snapshot messages — never from the rendered bash text.
+ */
+export declare function detectInlinePageResult(result: unknown): InlinePageRef | undefined;
+export declare class PageBlockComponent implements Component {
+    readonly pageId: string;
+    private readonly openHint;
+    private expanded;
+    private generation;
+    /** `revision|state` from the last successful read. A replacement selects a
+     *  new revision and a settlement moves the state, so nothing here depends on
+     *  a file timestamp or on the directory the page was first projected into. */
+    private stamp;
+    private snapshot;
+    /** `loading` until the first read returns; a failed read is never presented
+     *  as the previous content still being current. */
+    private status;
+    private cache;
+    constructor(pageId: string, openHint: () => string);
+    /** Re-read the request. Resolves true when the rendered content changed, so
+     *  the caller knows whether to mark the transcript dirty. */
+    refresh(): Promise<boolean>;
+    /** Ctrl+O global expansion (ChatView.isExpandable duck-type). */
+    setExpanded(expanded: boolean): void;
+    render(width: number): string[];
+    invalidate(): void;
+    private settle;
+    private compose;
+    private footerLine;
+}

package/dist/clients/attach/render/page-block.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var c=(i,e)=>g(i,"name",{value:e,configurable:!0});import{pageAwaitsResponse as $}from"../../../core/human/page-schema.js";import{projectPageDisplayMarkdown as w}from"../../../core/human/page-markdown.js";import{projectHtmlDocumentMarkdown as y}from"../../../core/human/page-html-markdown.js";import{cliClient as x}from"../../../commands/api-client.js";import{answerDigestOf as D}from"../../inbox/dto-adapt.js";import{pageBodyLines as b}from"../../inbox/tui/page-body.js";import{BOLD as v,CYAN as L,DIM as d,GREEN as l,RESET as a,YELLOW as M,sanitize as f,singleLine as E,truncate as p,wrap as j}from"../../inbox/tui/ansi.js";const h=16;function Y(i){if(i===null||typeof i!="object")return;const e=i.details;if(e===null||typeof e!="object")return;const t=e.crtrPreview;if(t===null||typeof t!="object")return;const n=t;if(n.path!=="human send")return;const s=n.result;if(s===null||typeof s!="object")return;const r=s,u=r.page_id;if(typeof u=="string"&&r.placement==="inline")return{pageId:u}}c(Y,"detectInlinePageResult");function I(i){return i.document_media_type==="text/html"?y(i.source_document):w(i.source_document,i.page)}c(I,"projectDisplay");class q{static{c(this,"PageBlockComponent")}pageId;openHint;expanded=!1;generation=0;stamp;snapshot;status="loading";cache;constructor(e,t){this.pageId=e,this.openHint=t}async refresh(){let e;try{e=(await x().getHumanRequest(this.pageId)).page}catch{e=void 0}if(e===void 0)return this.settle("unavailable",void 0,void 0);const t=`${e.revision}|${e.state}`;if(this.status==="ready"&&t===this.stamp)return!1;let n;try{n={manifest:e.page,displayMarkdown:I(e),state:e.state,...e.state==="resolved"?_(D(e)):{}}}catch{return this.settle("unavailable",void 0,t)}return this.settle("ready",n,t)}setExpanded(e){e!==this.expanded&&(this.expanded=e,this.cache=void 0)}render(e){const t=e>0?e:80,n=this.cache;if(n!==void 0&&n.width===t&&n.generation===this.generation&&n.expanded===this.expanded)return n.lines;const s=this.compose(t);return this.cache={width:t,generation:this.generation,expanded:this.expanded,lines:s},s}invalidate(){this.cache=void 0}settle(e,t,n){return e===this.status&&e==="unavailable"?!1:(this.status=e,this.snapshot=t,this.stamp=n,this.generation++,this.cache=void 0,!0)}compose(e){const t=this.snapshot;if(t===void 0){const o=this.status==="loading"?"[page] loading\u2026":"[page] no longer available";return["",`  ${d}${o}${a}`,""]}const n=Math.min(Math.max(20,e-4),100),s=["",`  ${v}${L}${p(f(E(t.manifest.title)),n)}${a}`];if(t.manifest.subtitle)for(const o of j(f(t.manifest.subtitle),n))s.push(`  ${d}${o}${a}`);const r=b(t.manifest,t.displayMarkdown,n,Math.max(20,e-4));if(r.length>0){s.push("");const o=this.expanded||r.length<=h?r:r.slice(0,h);for(const m of o)s.push(`  ${m}`);o.length<r.length&&s.push(`  ${d}\u2026 +${r.length-o.length} lines \u2014 ctrl+o to expand${a}`)}const u=this.footerLine(t,n);return u!==void 0&&s.push("",`  ${u}`),s.push(""),s}footerLine(e,t){switch(e.state){case"pending":return $(e.manifest)?`${M}\u25B8 awaiting your answer${a} ${d}\u2014 ${f(this.openHint())}${a}`:`${d}\u25E6 queued in your inbox \u2014 ${f(this.openHint())}${a}`;case"resolved":return e.answerDigest===void 0?`${l}\u2713 answered${a}`:`${l}\u2713 answered${a} ${d}\u2014 ${p(f(e.answerDigest),Math.max(10,t-12))}${a}`;case"canceled":return`${d}\u2298 canceled${a}`;case"passive":return}}}function _(i){return i===void 0?{}:{answerDigest:i}}c(_,"withDigest");export{q as PageBlockComponent,Y as detectInlinePageResult};

package/dist/clients/attach/render/scroll-animation.d.ts

@@ -0,0 +1,8 @@
+import type { TranscriptViewport } from './viewport.js';
+export interface ScrollAnimator {
+    /** Animate one scroll step in `direction`, coalescing with a burst in flight. */
+    page(direction: 'up' | 'down'): void;
+    /** Stop mid-flight — other scroll input took over, or the session ended. */
+    cancel(): void;
+}
+export declare function createScrollAnimator(viewport: TranscriptViewport, requestRender: () => void): ScrollAnimator;

package/dist/clients/attach/render/scroll-animation.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var r=(e,f)=>g(e,"name",{value:f,configurable:!0});import{performance as M}from"node:perf_hooks";const p=100,A=25,R=.5,S=.15;function T(e){return 1-(1-e)*(1-e)}r(T,"easeOut");function x(e,f){let t,l=0,s=0,c=0;const i=r(()=>{t!==void 0&&clearTimeout(t),t=void 0,s=0,c=0},"stop"),h=r(o=>{const n=Math.max(0,l+p-o);t=setTimeout(()=>{t=void 0,m(M.now(),!0)},Math.min(A,n))},"schedule"),m=r((o,n)=>{const a=Math.min(1,(o-l)/p),u=Math.round(s*T(a)),d=u-c;if(d!==0){if(!e.scrollBy(d))return i();c=u,f()}if(a===1)return i();n&&h(o)},"advance");return{page(o){const n=M.now();t!==void 0&&(clearTimeout(t),t=void 0,m(n,!1));const a=s-c,u=Math.max(1,Math.round(e.pageRows()*R)),d=(o==="up"?-1:1)*u;if(s=a+d,c=0,s===0)return i();l=n-p*S,m(n,!0)},cancel:i}}r(x,"createScrollAnimator");export{x as createScrollAnimator};

package/dist/clients/attach/render/tool-calls.d.ts

@@ -0,0 +1,53 @@
+import { type Component } from '@earendil-works/pi-tui';
+type Theme = {
+    fg: (name: string, text: string) => string;
+    bold: (text: string) => string;
+};
+/** Per-tool fold state owned by the attach viewer. Tool definitions capture the
+ *  call component they render while folded, so the viewer never reaches into
+ *  `ToolExecutionComponent`'s private renderer fields to recover it. */
+/** A settled tool result on its way to the transcript. `MinimizableToolComponent`
+ *  hands it to a definition's observer BEFORE the imported shell renders it, so a
+ *  definition whose folded call row states a fact from the result (an edit's
+ * *  changed-line counts) still has that fact once the fold
+ *  renders instead of the result record — on the live stream and on a rebuilt
+ *  transcript alike. */
+export type ObservedToolResult = {
+    content?: Array<{
+        type?: unknown;
+        text?: unknown;
+    }>;
+    details?: unknown;
+    isError?: boolean;
+};
+export type ToolResultObserver = (result: ObservedToolResult, isPartial: boolean) => void;
+export declare class FoldedToolCallController {
+    folded: boolean;
+    private component;
+    setFolded(folded: boolean): void;
+    capture<T extends Component>(component: T): T;
+    callComponent(): Component | undefined;
+}
+export type FileLineChanges = {
+    added: number;
+    removed: number;
+};
+/** The one-line folded form of a file tool's call: `<icon> <label> <path>`,
+ *  optionally followed by its green/red changed-line counts. */
+export declare function foldedFileCallLine(tool: 'read' | 'write' | 'edit', rawPath: string, theme: Theme, cwd: string, changes?: FileLineChanges): string;
+/** Attach-viewer `read`: an icon + the path (plus any `:offset-limit` range).
+ *  The call is a single line by construction, so a folded read shows exactly
+ *  what it read and nothing else. */
+export declare function createCrtrReadToolDefinition(cwd: string, fold?: FoldedToolCallController): unknown;
+/** Attach-viewer `write`: pi's builtin call renderer (it owns the
+ *  syntax-highlighted content preview and its expand hint) with the icon
+ *  prefixed onto its header line. Folded, only that header survives. */
+export declare function createCrtrWriteToolDefinition(cwd: string, fold?: FoldedToolCallController): unknown;
+/** The backgrounding row for a tool component's captured call — nothing unless
+ *  that call is a bash command still running past the threshold. The owning tool
+ *  component renders it after its whole block, which is what keeps the row
+ *  outside the highlighted band. */
+export declare function bashCallBackgroundHintLines(call: Component | undefined, width: number): string[];
+/** Attach-viewer `bash` for anything that is not a `crtr` invocation. */
+export declare function createCrtrPlainBashToolDefinition(cwd: string, fold?: FoldedToolCallController, backgroundHint?: () => string | null): unknown;
+export {};