@north-light/cli 0.0.0 → 0.3.413

package/dist/builtin-pi-packages/pi-crtr-extensions/package.json

@@ -0,0 +1,25 @@
+{
+  "name": "pi-crtr-extensions",
+  "version": "0.1.0",
+  "type": "module",
+  "description": "Silas's personal pi extensions and prompt templates.",
+  "keywords": [
+    "pi-package"
+  ],
+  "license": "MIT",
+  "dependencies": {
+    "yaml": "^2.9.0"
+  },
+  "devDependencies": {
+    "@earendil-works/pi-ai": "0.87.0"
+  },
+  "peerDependencies": {
+    "@earendil-works/pi-coding-agent": "*"
+  },
+  "pi": {
+    "extensions": [
+      "extensions/*.ts",
+      "extensions/*/index.ts"
+    ]
+  }
+}

package/dist/builtin-pi-packages/pi-crtr-extensions/tsconfig.json

@@ -0,0 +1,10 @@
+{
+  "extends": "../../../tsconfig.json",
+  "compilerOptions": {
+    "noEmit": true,
+    "rootDir": "../..",
+    "allowImportingTsExtensions": true
+  },
+  "include": ["extensions/**/*.ts", "lib/**/*.ts"],
+  "exclude": ["node_modules"]
+}

package/dist/cli.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+import './suppress-experimental-warnings.js';

package/dist/cli.js

@@ -0,0 +1,11 @@
+#!/usr/bin/env node
+var w=Object.defineProperty;var s=(r,o)=>w(r,"name",{value:o,configurable:!0});import"./suppress-experimental-warnings.js";import{mkdirSync as v,openSync as R,readFileSync as S,renameSync as E,rmSync as _,statSync as f,writeFileSync as b}from"node:fs";import{dirname as l,join as a}from"node:path";import{enableCompileCache as C}from"node:module";import{fileURLToPath as d}from"node:url";import{isDaemonControlInvocation as u,isLayoutMigrationInvocation as I,personOnlyInvocation as N,resolveDaemonControlRoot as O,resolveLayoutMigrationRoot as k,resolveRoot as x}from"./build-root.js";import{maybeBootRoot as A}from"./core/runtime/front-door.js";import{maybeAutoUpdate as $}from"./core/auto-update.js";import{ensureProjectScope as T}from"./core/bootstrap.js";import{provisionExports as F,pruneLegacyExports as M}from"./core/host-exports/export.js";import{revalidateBundlePlugins as P}from"./core/command-plugins/revalidate.js";import{renderNode as D,runCli as g,walk as L}from"./core/command.js";import{dispatchWithStaleRecovery as j}from"./core/manifest-recovery.js";import{installStdoutErrorPolicy as K}from"./core/stdout-errors.js";import{handle as U}from"./core/io.js";import{CrtrError as y,ownerOnly as B}from"./core/errors.js";import{ExitCode as J}from"./types.js";import{layoutNeedsMigration as W,runtimeRoot as q}from"./core/layout.js";import{ApiError as G}from"./api/index.js";import{mark as e}from"./core/timing.js";import{sandboxCliNodeId as V}from"./shared/env.js";import{nodeRunDir as h}from"./core/canvas/paths.js";import{installBrokerConfigSnapshot as z}from"./core/config.js";R(d(import.meta.url),"r"),K(),e("cli.entry",{cmd:process.argv[2]??"(bare)"});try{C()}catch{}e("cli.compile_cache");const H=a(l(d(import.meta.url)),".."),m=a(q(),"first-run.json");function c(r){return(r instanceof Error?r.message:String(r)).split(/\r?\n/,1)[0]??""}s(c,"errorMessage");function Q(r){const o=l(m);v(o,{recursive:!0});const t=`${m}.${process.pid}.${Date.now()}.tmp`;try{b(t,JSON.stringify({packageVersion:r,completedAt:new Date().toISOString()})+`
+`,"utf8"),E(t,m)}finally{_(t,{force:!0})}}s(Q,"writeFirstRunMarker");async function X(){if(process.env.CRTR_NO_AUTO_INIT==="1")return;try{if(f(m,{throwIfNoEntry:!1})!==void 0)return}catch(o){process.stderr.write(`crtr: first-run reconcile marker check failed: ${c(o)}
+`);return}try{if(f(a(H,".git"),{throwIfNoEntry:!1})!==void 0)return}catch(o){process.stderr.write(`crtr: first-run reconcile source check failed: ${c(o)}
+`);return}let r;try{const{reconcileFirstRun:o}=await import("./commands/sys/setup-core.js");r=await o((t,p)=>{process.stderr.write(`crtr: first-run reconcile ${t} failed: ${c(p)}
+`)})}catch(o){process.stderr.write(`crtr: first-run reconcile failed: ${c(o)}
+`)}finally{if(r!==void 0)try{Q(r)}catch(o){process.stderr.write(`crtr: first-run reconcile marker failed: ${c(o)}
+`)}}}s(X,"maybeReconcileFirstRun");async function Y(){const r=I(process.argv),o=V(),t=o!==void 0;if(o!==void 0){process.env.CRTR_API_SOCKET=a(h(o),"cli.sock");const i=N(process.argv);if(i!==null)throw B(`crtr ${i} is not available to an app's node`,"Run this command from the person's terminal.");const n=JSON.parse(S(a(h(o),"broker-launch.json"),"utf8"));if(!n.configSnapshot)throw new Error("node launch is missing its config snapshot");z(n.configSnapshot)}if(!t&&W()&&!u(process.argv)&&!r)throw new y("layout_migration_required","run crtr sys migrate while the runtime is offline",J.NETWORK,{next:"Run `crtr sys migrate` while the runtime is offline, then restart it."});if(r){const i=await k();if(process.argv.slice(4).some(n=>n==="-h"||n==="--help")){process.stdout.write(D(L(i,["sys","migrate"]).node)+`
+`);return}await g(i,process.argv);return}if(t||(M(process.argv),await X()),await A(process.argv),e("cli.front_door_passed"),u(process.argv)){await g(await O(),process.argv);return}t||await P(process.argv),e("cli.plugins_revalidated");const p=await x(process.argv[2]);e("cli.root_resolved"),t||(F(p,process.argv),T(process.argv),$(process.argv)),e("cli.dispatch_start"),await j(p,process.argv),e("cli.dispatch_done")}s(Y,"main"),Y().catch(r=>{(r instanceof Error&&r.name==="AbortError"||r instanceof Error&&/operation was aborted/i.test(r.message))&&(process.stderr.write(`crtr: Interrupted
+`),process.exit(130)),(r instanceof G||r instanceof y)&&(U(r),process.exit(typeof process.exitCode=="number"?process.exitCode:1));const t=r instanceof Error?r.message:String(r);process.stderr.write(`crtr: ${t}
+`),process.exit(1)});

package/dist/clients/attach/ansi-cells.d.ts

@@ -0,0 +1,44 @@
+/** Read one terminal control sequence so non-printing ANSI never takes a cell.
+ *  `undefined` means the sequence runs off the end of the row. */
+export declare function readEscape(line: string, start: number): {
+    text: string;
+    end: number;
+} | undefined;
+/** One printable grapheme, with the escape sequences that preceded it. */
+export type RowGlyph = {
+    /** The grapheme itself, with no ANSI attached. */
+    text: string;
+    /** 0-indexed terminal cell this grapheme starts at. */
+    cell: number;
+    /** Cells occupied — 2 for a wide grapheme, 0 for a zero-width one. */
+    width: number;
+};
+/** Walk `line` as the terminal does, calling `onGlyph` per printable grapheme
+ *  and `onEscape` per control sequence, in row order. Returns the cell count. */
+export declare function walkRow(line: string, visit: {
+    onGlyph?: (glyph: RowGlyph) => void;
+    onEscape?: (escape: string) => void;
+}): number;
+/** Cells the row occupies on screen. */
+export declare function rowCells(line: string): number;
+/** Plain text of cells `[from, to)` — every escape, link boundary, and cursor
+ *  marker dropped, exactly what a terminal copies out of that span. */
+export declare function sliceCells(line: string, from: number, to: number): string;
+/** The SGR pair `styleCells` asserts over a span. A style that paints color
+ *  sets `restore`, because its `off` cannot un-set one color without also
+ *  discarding whatever color the row had underneath it — with `restore`, the
+ *  span closes by resetting and replaying the SGRs the row had already asserted. */
+export type CellStyle = {
+    on: string;
+    off: string;
+    restore?: boolean;
+};
+export declare const INVERSE_STYLE: CellStyle;
+/** Style cells `[from, to)`, re-asserting `style.on` after any SGR inside the
+ *  span (a reset there would otherwise drop the styling mid-span). A short row
+ *  is padded with spaces so a multi-row span reads as one block, never past
+ *  `maxCells`. Escapes are non-printing, so passes compose: styling an already
+ *  styled row leaves every cell position unmoved. */
+export declare function styleCells(line: string, from: number, to: number, maxCells: number, style?: CellStyle): string;
+/** Reverse-video cells `[from, to)` — the drag-selection highlight. */
+export declare function highlightCells(line: string, from: number, to: number, maxCells: number): string;

package/dist/clients/attach/ansi-cells.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var i=(e,t)=>a(e,"name",{value:t,configurable:!0});import E from"string-width";const g=new Intl.Segmenter(void 0,{granularity:"grapheme"}),b="\x1B[7m",w="\x1B[27m";function C(e,t){const r=e[t+1];if(r!==void 0){if(r==="]"||r==="_"||r==="P"||r==="^"){const n=e.indexOf("\x07",t+2),o=e.indexOf("\x1B\\",t+2),f=n===-1?o:o===-1?n:Math.min(n,o);return f===-1?void 0:{text:e.slice(t,f+(f===n?1:2)),end:f+(f===n?1:2)}}if(r==="["){let n=t+2;for(;n<e.length&&(e.charCodeAt(n)<64||e.charCodeAt(n)>126);)n++;return n>=e.length?void 0:{text:e.slice(t,n+1),end:n+1}}return{text:e.slice(t,t+2),end:t+2}}}i(C,"readEscape");function l(e,t){let r=0,n=0;for(;n<e.length;){if(e[n]==="\x1B"){const c=C(e,n);if(c===void 0)break;t.onEscape?.(c.text),n=c.end;continue}const o=e.indexOf("\x1B",n),f=e.slice(n,o===-1?void 0:o);for(const c of g.segment(f)){const d=E(c.segment);t.onGlyph?.({text:c.segment,cell:r,width:d}),r+=d}n=o===-1?e.length:o}return r}i(l,"walkRow");function G(e){return l(e,{})}i(G,"rowCells");function I(e,t,r){let n="";return l(e,{onGlyph:i(o=>{o.cell>=t&&o.cell<r&&(n+=o.text)},"onGlyph")}),n}i(I,"sliceCells");const S={on:b,off:w};function M(e,t,r,n,o=S){const f=Math.min(r,n);if(f<=t||t<0)return e;let c="",d=!1;const s=[],m=i(()=>{d||(c+=o.on,d=!0)},"open"),h=i(()=>{d&&(c+=o.restore===!0?`\x1B[0m${s.join("")}`:o.off,d=!1)},"close"),u=l(e,{onEscape:i(x=>{c+=x,x.endsWith("m")&&(x==="\x1B[0m"||x==="\x1B[m"?s.length=0:s.push(x),d&&(c+=o.on))},"onEscape"),onGlyph:i(x=>{x.cell>=t&&x.cell<f?m():h(),c+=x.text},"onGlyph")});if(h(),u<f){const x=Math.max(0,t-u),p=f-Math.max(t,u);c+=" ".repeat(x)+o.on+" ".repeat(p)+(o.restore===!0?"\x1B[0m":o.off)}return c}i(M,"styleCells");function N(e,t,r,n){return M(e,t,r,n)}i(N,"highlightCells");export{S as INVERSE_STYLE,N as highlightCells,C as readEscape,G as rowCells,I as sliceCells,M as styleCells,l as walkRow};

package/dist/clients/attach/assets/README.md

@@ -0,0 +1,7 @@
+# Whip sounds
+
+These files are the first three results for [“whip crack” on Pixabay](https://pixabay.com/sound-effects/search/whip%20crack/), downloaded from the playable audio URLs embedded in each result page on 2026-08-04. They are available under the [Pixabay Content License](https://pixabay.com/service/license-summary/).
+
+- `whip-snap.mp3` — [“Whip Snap” by Universfield](https://pixabay.com/sound-effects/film-special-effects-whip-snap-242215/), with 100ms removed from its start to align its crack with the animation flash
+- `whip-crack.mp3` — [“Whip Crack” by Universfield](https://pixabay.com/sound-effects/film-special-effects-whip-crack-123738/)
+- `whip-06.mp3` — [“Whip 06” by Universfield](https://pixabay.com/sound-effects/film-special-effects-whip-06-487886/)

package/dist/clients/attach/chrome/bash-jobs.d.ts

@@ -0,0 +1,6 @@
+import { type BashJobStatus } from '../../../core/bash-jobs.js';
+/** Compact cockpit row: state first (matching the cron row), then the running
+ *  command. `cmdCap` is the columns the caller has left for that command, so the
+ *  cell shrinks with the pane instead of being clipped after the row's own key
+ *  hints. `undefined` for an empty list — the caller omits the row entirely. */
+export declare function bashJobsWaitSummary(jobs: readonly BashJobStatus[], nowMs?: number, cmdCap?: number): string | undefined;

package/dist/clients/attach/chrome/bash-jobs.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var s=(t,n)=>i(t,"name",{value:n,configurable:!0});import{bashJobCommandLine as m,formatBashElapsed as o}from"../../../core/bash-jobs.js";function d(t,n){const e=m(t);if(e.length<=n)return e;const a=e.slice(0,Math.max(1,n-1)),r=a.lastIndexOf(" ");return`${(r>=n-12?a.slice(0,r):a).trimEnd()}\u2026`}s(d,"cmdCell");function h(t,n=Date.now(),e=26){if(t.length===0)return;if(t.length===1){const r=t[0];return`bash job \xB7 ${o(n-r.startedAtMs)} \xB7 ${d(r.command,Math.max(12,e))}`}const a=t[0];return`${t.length} bash jobs \xB7 oldest ${o(n-a.startedAtMs)}`}s(h,"bashJobsWaitSummary");export{h as bashJobsWaitSummary};

package/dist/clients/attach/chrome/canvas-panels.d.ts

@@ -0,0 +1,38 @@
+import type { CanvasSource } from '../../../core/canvas/source.js';
+import type { CronDTO } from '../../../api/dto/crons.js';
+import type { ReviewDTO } from '../../../api/dto/reviews.js';
+import type { BashJobStatus } from '../../../core/bash-jobs.js';
+import type { AttachPalette } from '../config.js';
+export type CanvasPanelItem = {
+    key: string;
+    kind: 'node';
+    nodeId: string;
+    line: string;
+} | {
+    key: string;
+    kind: 'review';
+    companionNodeId: string;
+    line: string;
+} | {
+    key: 'bash';
+    kind: 'bash';
+    line: string;
+} | {
+    key: 'crons';
+    kind: 'crons';
+    line: string;
+};
+export interface CanvasPanelLines {
+    /** Below-editor relationship and wait rows, in render order. */
+    reports: string[];
+    /** Node ids backing relationship rows. Retained for graph/remote callers. */
+    reportIds: string[];
+    /** Actionable cockpit rows. Enter swaps nodes or opens the matching wait detail surface. */
+    items: CanvasPanelItem[];
+}
+/** Build the BASE panel line stacks for `nodeId`. `asks` is the per-node
+ *  pending human-ticket count map the caller polls (page/review); pass
+ *  `{}` to omit the ⚑ badges. `crons` are this node's armed schedules.
+ *  `palette`
+ *  drives the headers + dim cells; omit it and the panels render uncolored. */
+export declare function buildCanvasPanelLines(nodeId: string, asks: Record<string, number>, palette: AttachPalette | undefined, source: CanvasSource, crons?: readonly CronDTO[], jobs?: readonly BashJobStatus[], reviews?: readonly ReviewDTO[]): Promise<CanvasPanelLines>;

package/dist/clients/attach/chrome/canvas-panels.js

@@ -0,0 +1 @@
+var Z=Object.defineProperty;var i=(s,a)=>Z(s,"name",{value:a,configurable:!0});import{navLabel as P,nodeGlyph as j,truncate as nn,tokensCell as tn,cycleBadge as en,askBadge as on,activityCell as sn,fillWidth as H,RESET as m,DIM as an,GREEN as cn}from"../../../core/canvas/nav-render.js";const rn=34,dn=40;import{RemoteCanvasSource as ln}from"../../../core/canvas/remote-canvas-source.js";import{cronWaitSummary as un}from"./cron-wait.js";import{bashJobsWaitSummary as fn}from"./bash-jobs.js";import{reviewWaitSummary as mn}from"./review-wait.js";const hn=12,pn=6,D=22;function F(s,a){return s.length>a?`${s.slice(0,a-1)}\u2026`:s+" ".repeat(a-s.length)}i(F,"nameCell");function wn(s,a){return s.length>=a?s.slice(0,a):" ".repeat(a-s.length)+s}i(wn,"padStartVisible");async function Mn(s,a,r,f,G=[],b=[],K=[]){const R=f instanceof ln,h=await f.panelRoster?.(),p=h===void 0?null:new Map(h.nodes.map(n=>[n.node_id,n])),y=new Map,v=new Map;if(h!==void 0)for(const n of h.edges){const t=y.get(n.from_id)??[];t.push(n.to_id),y.set(n.from_id,t),v.has(n.to_id)||v.set(n.to_id,n.from_id)}const S=new Map,C=new Map,O=new Map,w=i(n=>{const t=S.get(n);if(t!==void 0)return t;const e=p===null?f.getNode(n).catch(()=>null):Promise.resolve(p.get(n)??null);return S.set(n,e),e},"node"),L=i(n=>f.getNode(n).catch(()=>null),"detail"),_=i(n=>{const t=C.get(n);if(t!==void 0)return t;const e=(async()=>{const o=p===null?(await f.subscriptionsOf(n).catch(()=>[])).map(c=>c.node_id):y.get(n)??[],u=[];for(const c of o)(await w(c))?.kind!=="human"&&u.push(c);return u})();return C.set(n,e),e},"convoChildIds"),W=i(n=>{const t=O.get(n);if(t!==void 0)return t;const e=p===null?f.subscribersOf(n).then(o=>o[0]?.node_id).catch(()=>{}):Promise.resolve(v.get(n));return O.set(n,e),e},"managerOf"),T=i(async n=>{const t=[];for(const e of await _(n)){const o=(await w(e))?.status;(o==="active"||o==="idle")&&t.push(e)}return t},"liveReports"),V=i(async n=>{let t=n;const e=new Set([t]);for(;;){const o=await W(t);if(o===void 0||e.has(o))break;e.add(o),t=o}return t},"climbRoot"),E=new Map,J=i(async n=>{const t=new Set,e=i(async o=>{const u=(await w(o))?.status==="active";if(t.has(o))return u?1:0;t.add(o);let c=0;for(const M of await _(o))c+=await e(M);return E.set(o,c),c+(u?1:0)},"visit");await e(n)},"computeActivity"),q=i(async n=>{if(n===null||n.mode!=="orchestrator")return"";const t=(await _(n.node_id)).length;return t>0?` ${an}\u2933${t}${m}`:""},"childBadgeFor"),z=i(n=>{if(n===null||n.status==="active")return"";const t=E.get(n.node_id)??0;return t>0?` ${cn}\u21E3${t}${m}`:""},"liveBelowBadgeFor"),g=r?.muted??(n=>n),Q=r?.faint??(n=>n);await J(await V(s));const d=await W(s),k=await T(s),$=[...d!==void 0?[d]:[],...k],I=await Promise.all($.map(async n=>await L(n)??await w(n))),U=$.length>0?Math.min(D,Math.max(...$.map((n,t)=>P(I[t]??null,n).length))):D,N=i(async(n,t)=>{const e=I[$.indexOf(n)]??null,o=F(P(e,n),U),u=Q(F(e?.kind??"",hn)),c=g(wn(tn(e,R),pn)),M=`${en(e)}${await q(e)}${z(e)}${on(n,a)}${sn(e,R)}`,Y=` ${t} ${j(e)} ${o}  ${u} ${c}${M}`;return nn(Y)},"row"),X=[...d!==void 0?[d]:[],...k],l=[];d!==void 0&&l.push({key:`node:${d}`,kind:"node",nodeId:d,line:await N(d,"\u2191")});for(const n of k)l.push({key:`node:${n}`,kind:"node",nodeId:n,line:await N(n,"\u2193")});for(const n of K){const t=r?r.info("\u270E"):"\u270E",e=mn(n,Math.max(8,H()-dn));l.push({key:`review:${n.review_id}`,kind:"review",companionNodeId:n.companion_node_id,line:` ${t} ${g(`${e} \xB7 \u21B5 companion`)}${m}`})}const B=b.length===1?" \xB7 x stop":"",x=fn(b,Date.now(),H()-(rn+B.length));if(x!==void 0){const n=r?r.info("\u2699"):"\u2699";l.push({key:"bash",kind:"bash",line:` ${n} ${g(`${x} \xB7 \u21B5 details${B}`)}${m}`})}const A=un(G);if(A!==void 0){const n=r?r.info("\u25F7"):"\u25F7";l.push({key:"crons",kind:"crons",line:` ${n} ${g(`${A} \xB7 \u21B5 details`)}${m}`})}return{reports:l.map(n=>n.line),reportIds:X,items:l}}i(Mn,"buildCanvasPanelLines");export{Mn as buildCanvasPanelLines};

package/dist/clients/attach/chrome/completion-bell.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Ring the completion bell once, if enabled. Picks the best available signal
+ * for the host:
+ *   macOS  → afplay a system sound (guaranteed audible, ignores terminal bell prefs)
+ *   Linux  → paplay/aplay if CRTR_BELL_SOUND is set, else the terminal BEL
+ *   other  → terminal BEL (0x07) — the terminal's own bell / tmux bell indicator
+ *
+ * Gated on the `completion_bell` config setting (default true).
+ */
+export declare function ringCompletionBell(): void;

package/dist/clients/attach/chrome/completion-bell.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var t=(r,e)=>o(r,"name",{value:e,configurable:!0});import{spawn as a}from"node:child_process";import{readConfig as s}from"../../../core/config.js";const f="/System/Library/Sounds/Glass.aiff";function c(){const r=process.env.CRTR_BELL_SOUND;if(r===void 0||r.trim()==="")return f;const e=r.trim();return e.startsWith("/")?e:`/System/Library/Sounds/${e.replace(/\.aiff$/i,"")}.aiff`}t(c,"macSoundPath");function u(){try{return s("user").completion_bell}catch{return!0}}t(u,"bellEnabled");function n(r,e){try{const i=a(r,e,{stdio:"ignore",detached:!0});return i.on("error",()=>{}),i.unref(),!0}catch{return!1}}t(n,"playDetached");function m(){if(u())try{if(process.platform==="darwin"){if(n("afplay",[c()]))return}else if(process.platform==="linux"){const r=process.env.CRTR_BELL_SOUND;if(r!==void 0&&r.trim()!==""&&(n("paplay",[r.trim()])||n("aplay",[r.trim()])))return}process.stdout.write("\x07")}catch{}}t(m,"ringCompletionBell");export{m as ringCompletionBell};

package/dist/clients/attach/chrome/cron-wait.d.ts

@@ -0,0 +1,3 @@
+import type { CronDTO } from '../../../api/dto/crons.js';
+/** Compact cockpit row: state first; the native Inspector owns details. */
+export declare function cronWaitSummary(crons: readonly CronDTO[], nowMs?: number): string | undefined;

package/dist/clients/attach/chrome/cron-wait.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var o=(e,n)=>s(e,"name",{value:n,configurable:!0});function c(e,n){const t=Date.parse(e)-n;if(t<=0)return"due now";const r=Math.ceil(t/6e4);if(r<60)return`in ${r}m`;const i=Math.floor(r/60),u=r%60;if(i<24)return`in ${i}h${u>0?` ${u}m`:""}`;const f=Math.floor(i/24),a=i%24;return`in ${f}d${a>0?` ${a}h`:""}`}o(c,"relativeTime");function $(e){return[...e].sort((n,t)=>Date.parse(n.fire_at)-Date.parse(t.fire_at))[0]}o($,"nextCron");function d(e,n=Date.now()){if(e.length===0)return;if(e.length>1){const i=$(e);return`${e.length} crons armed${i?` \xB7 next ${c(i.fire_at,n)}`:""}`}const t=e[0],r=c(t.fire_at,n);return t.cancel_on_wake?`deadline \xB7 ${r}`:t.recur!==null?`recurring cron \xB7 next ${r}`:`scheduled cron \xB7 ${r}`}o(d,"cronWaitSummary");export{d as cronWaitSummary};

package/dist/clients/attach/chrome/git-info.d.ts

@@ -0,0 +1,20 @@
+export interface GitInfo {
+    /** Last path segment of the cwd (always present). */
+    dir: string;
+    /** Current branch (or short SHA when detached); undefined outside a repo. */
+    branch?: string;
+    /** Working tree has uncommitted changes (staged, unstaged, or untracked). */
+    dirty: boolean;
+    /** Commits ahead of upstream. */
+    ahead: number;
+    /** Commits behind upstream. */
+    behind: number;
+}
+/** Parse `git status --porcelain=v1 --branch` into {@link GitInfo} flags. The
+ *  first `## ` line carries branch + `[ahead N, behind M]`; any further line is
+ *  a changed/untracked path → dirty. Exported pure for unit tests. */
+export declare function parseGitStatus(dir: string, stdout: string): GitInfo;
+/** Fetch git context for `cwd` without blocking. On any error (not a repo, git
+ *  missing, timeout) the callback still fires with dir-only info so the border
+ *  shows the folder name regardless. */
+export declare function fetchGitInfo(cwd: string, cb: (info: GitInfo) => void): void;

package/dist/clients/attach/chrome/git-info.js

@@ -0,0 +1,2 @@
+var f=Object.defineProperty;var s=(e,i)=>f(e,"name",{value:i,configurable:!0});import{execFile as h}from"node:child_process";import{basename as c}from"node:path";function d(e,i){const r=i.split(`
+`).filter(n=>n.length>0),t={dir:e,dirty:!1,ahead:0,behind:0};for(const n of r)if(n.startsWith("## ")){const a=n.slice(3);if(!a.startsWith("HEAD (no branch)")){const o=a.split(/\.\.\.| /,1)[0];o&&(t.branch=o)}t.ahead=Number(/ahead (\d+)/.exec(a)?.[1]??0),t.behind=Number(/behind (\d+)/.exec(a)?.[1]??0)}else t.dirty=!0;return t}s(d,"parseGitStatus");function m(e,i){const r=c(e)||e;h("git",["-C",e,"status","--porcelain=v1","--branch"],{timeout:2e3,maxBuffer:4*1024*1024},(t,n)=>{if(t){i({dir:r,dirty:!1,ahead:0,behind:0});return}i(d(r,n))})}s(m,"fetchGitInfo");export{m as fetchGitInfo,d as parseGitStatus};

package/dist/clients/attach/chrome/header.d.ts

@@ -0,0 +1,10 @@
+import { Container } from '@earendil-works/pi-tui';
+import type { SessionState } from '../../../core/session-model/session-state.js';
+import type { AttachSession } from '../session/context.js';
+export interface RecapHeader {
+    /** The component ViewerFrame renders as its header region. */
+    readonly component: Container;
+    /** Repaint from the live `crtr-recap` widget state. Empty widget → 0 rows. */
+    render(): void;
+}
+export declare function createRecapHeader(ctx: Pick<AttachSession, 'tui' | 'pal'>, state: () => SessionState): RecapHeader;

package/dist/clients/attach/chrome/header.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var t=(n,r)=>l(n,"name",{value:r,configurable:!0});import{Container as f,Text as m,wrapTextWithAnsi as u}from"@earendil-works/pi-tui";import{DynamicBorder as w}from"@earendil-works/pi-coding-agent";import{splitRecapLines as g}from"./recap.js";function T(n,r){const{tui:s,pal:o}=n,e=new f;return{component:e,render:t(()=>{e.clear();const i=r().display.widgets["crtr-recap"],a=i===void 0?[]:g(i.lines).goal;if(a.length>0){const c=Math.max(1,(process.stdout.columns??80)-2);for(const d of a)for(const p of u(o.faint(d),c))e.addChild(new m(p,1,0));e.addChild(new w(o.border))}s.requestRender()},"render")}}t(T,"createRecapHeader");export{T as createRecapHeader};

package/dist/clients/attach/chrome/inbox-strip.d.ts

@@ -0,0 +1,31 @@
+import { Container } from '@earendil-works/pi-tui';
+import { type InboxRow } from '../../inbox/dto-adapt.js';
+import type { AttachSession } from '../session/context.js';
+export type StripSession = Pick<AttachSession, 'nodeId' | 'remote' | 'canvasSource' | 'tui' | 'pal'>;
+export interface InboxStripHooks {
+    /** Recompute the editor's hollow-cursor state (session/pane-focus.ts). */
+    syncCursor: () => void;
+    /** Drop the below-editor roster's highlight — the two lists are mutually exclusive. */
+    exitRoster: () => void;
+    /** Open this ticket — the inline ticket panel, or its fallbacks. */
+    openTicket: (ticket: InboxRow) => void;
+    /** True while the ticket panel is open — it IS the expanded notification,
+     *  so the strip's own rows hide rather than duplicate the flag. */
+    suppressed: () => boolean;
+    setNotice: (msg: string) => void;
+}
+export interface InboxStrip {
+    /** Mounted into the frame's single header container, below the recap. */
+    readonly component: Container;
+    /** Rescan the subtree's pending tickets and repaint. */
+    refresh(): Promise<void>;
+    /** Strip key routing, called BEFORE the editor sees the key. */
+    handleKey(data: string): boolean;
+    /** The dedicated binding: enter the strip, or leave it when already held. */
+    toggle(): void;
+    /** True while the strip holds the highlight. */
+    active(): boolean;
+    /** The cached pending tickets, for the inbox surface's scan merge. */
+    pendingTickets(): InboxRow[];
+}
+export declare function createInboxStrip(s: StripSession, hooks: InboxStripHooks): InboxStrip;

package/dist/clients/attach/chrome/inbox-strip.js

@@ -0,0 +1 @@
+var v=Object.defineProperty;var o=(u,c)=>v(u,"name",{value:c,configurable:!0});import{Container as D,Text as I,decodeKittyPrintable as L,matchesKey as b}from"@earendil-works/pi-tui";import{DynamicBorder as K}from"@earendil-works/pi-coding-agent";import{byNewestFirst as O,inboxRowFromDTO as $}from"../../inbox/dto-adapt.js";import{cliClient as _}from"../../../commands/api-client.js";import{fillBar as F,fillWidth as W,navLabel as q,stripSgr as A,truncate as B,REVERSE as H,YELLOW as P,RESET as j}from"../../../core/canvas/nav-render.js";const x=3;function V(u){return u.kind==="page"?u.emittedAt:u.blockedSince}o(V,"ticketTime");function X(u){const c=Date.now()-Date.parse(u);if(!Number.isFinite(c)||c<0)return"now";const a=Math.floor(c/6e4);if(a<1)return"now";if(a<60)return`${a}m`;const m=Math.floor(a/60);return m<24?`${m}h`:`${Math.floor(m/24)}d`}o(X,"ageLabel");function ee(u,c){const{nodeId:a,remote:m,canvasSource:y,tui:k,pal:M}=u,h=new D;let i=[],g=new Map,r,l=0;const R=o(e=>{const n=e.source.nodeId,s=n!==void 0&&n!==a?` \xB7 ${q(g.get(n)??null,n)}`:"";return B(` ${P}\u2691${j} ${e.title}${M.faint(` \xB7 ${X(V(e))}${s}`)}`)},"rowLine"),p=o(()=>{if(c.syncCursor(),h.clear(),i.length>0&&!c.suppressed()){const e=r===void 0?-1:i.findIndex(s=>s.dir===r);e>=0&&(l=Math.min(Math.max(l,e-x+1),e)),l=Math.max(0,Math.min(l,Math.max(0,i.length-x)));for(const s of i.slice(l,l+x)){const t=R(s);h.addChild(new I(s.dir===r?F(A(t),W(),H):t,1,0))}const n=i.length-Math.min(x,i.length-l);n>0&&h.addChild(new I(M.faint(`   +${n} more`),1,0)),h.addChild(new K(M.border))}k.requestRender()},"paint"),S=o(async()=>{const e=new Map((await y.listNodes()).map(t=>[t.node_id,t])),n=new Map,s=o(async t=>{if(n.has(t))return;const f=e.get(t)??null;if(t!==a&&f?.kind==="human")return;n.set(t,f);const d=await y.subscriptionsOf(t).catch(()=>[]);for(const T of d)await s(T.node_id)},"visit");return await s(a),n},"subtreeNodes"),C=o(async()=>{if(m)return;g=await S();const e=_(),[n,s]=await Promise.all([e.listHumanInbox(),e.getInboxHistory()]),t=new Map;for(const f of n.tickets){const d=$(f);t.set(d.dir,d)}for(const f of s.tickets){const d=$(f);d.kind==="page"&&(d.source.nodeId===void 0||!g.has(d.source.nodeId)||d.state!=="pending"||!d.awaitsResponse||d.inbox||t.has(d.dir)||t.set(d.dir,d))}i=[...t.values()].filter(f=>f.source.nodeId!==void 0&&g.has(f.source.nodeId)).sort(O),r!==void 0&&!i.some(f=>f.dir===r)&&(r=void 0),p()},"refresh"),w=o(()=>{r!==void 0&&(r=void 0,p())},"exit"),E=o(()=>{if(!m){if(r!==void 0){w();return}if(i.length===0){c.setNotice("No pending human requests in this subtree");return}c.exitRoster(),r=i[0].dir,l=0,p()}},"toggle"),N=o(()=>{const e=i.find(n=>n.dir===r);e!==void 0&&(w(),c.openTicket(e))},"openSelected");return{component:h,refresh:C,handleKey:o(e=>{if(r===void 0)return!1;const n=i.findIndex(t=>t.dir===r),s=L(e)??(e.length===1?e:void 0);return b(e,"up")||s==="k"?(n>0&&(r=i[n-1].dir,p()),!0):b(e,"down")||s==="j"?(n>=0&&n<i.length-1?(r=i[n+1].dir,p()):w(),!0):b(e,"enter")?(N(),!0):b(e,"escape")?(w(),!0):(w(),!1)},"handleKey"),toggle:E,active:o(()=>r!==void 0,"active"),pendingTickets:o(()=>[...i],"pendingTickets")}}o(ee,"createInboxStrip");export{ee as createInboxStrip};

package/dist/clients/attach/chrome/key-hint.d.ts

@@ -0,0 +1,9 @@
+import type { BindingId, BindingResolution } from '../../../core/keybindings/index.js';
+export interface KeyHintOptions {
+    /** Include the inbox half. False when the inbox cannot open from here (remote
+     *  attach) or when the status line already shows the pending-inbox segment. */
+    inbox: boolean;
+}
+/** `Alt+C menu (or /menu) · Alt+I inbox`. `/menu` is always available, so a
+ *  disabled menu key degrades to `/menu menu`-free wording rather than "Disabled". */
+export declare function viewerKeyHint(bindings: BindingResolution<BindingId>, opts: KeyHintOptions): string;

package/dist/clients/attach/chrome/key-hint.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var o=(t,e)=>u(t,"name",{value:e,configurable:!0});import{formatBinding as n}from"../../../core/keybindings/index.js";function p(t,e){const r=[];return r.push(t.gestures("crtr.tmux.menu.open").length>0?`${n(t,"crtr.tmux.menu.open")} menu (or /menu)`:"/menu for the menu"),e.inbox&&t.gestures("crtr.tmux.inbox.toggle").length>0&&r.push(`${n(t,"crtr.tmux.inbox.toggle")} inbox`),r.join(" \xB7 ")}o(p,"viewerKeyHint");export{p as viewerKeyHint};

package/dist/clients/attach/chrome/recap.d.ts

@@ -0,0 +1,7 @@
+export interface RecapSplit {
+    /** `Goal:` lines, label stripped — the pinned header's content. */
+    goal: string[];
+    /** The remaining lines, `State:` label stripped — cockpit content. */
+    state: string[];
+}
+export declare function splitRecapLines(lines: readonly string[]): RecapSplit;

package/dist/clients/attach/chrome/recap.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var o=(n,e)=>a(n,"name",{value:e,configurable:!0});function u(n){const e=[],s=[];for(const t of n){const c=/^Goal:\s*/.exec(t);if(c!==null){e.push(t.slice(c[0].length));continue}const l=/^State:\s*/.exec(t);s.push(l===null?t:t.slice(l[0].length))}return{goal:e,state:s}}o(u,"splitRecapLines");export{u as splitRecapLines};

package/dist/clients/attach/chrome/review-wait.d.ts

@@ -0,0 +1,6 @@
+import type { ReviewDTO } from '../../../api/dto/reviews.js';
+/** Compact cockpit row for one open review: state first (matching the cron and
+ *  bash rows), then the file it is about. A review whose submit is already in
+ *  reads as off the human's hands — the daemon approves it the moment the
+ *  companion stops editing, and the origin node resumes on that approval. */
+export declare function reviewWaitSummary(review: ReviewDTO, fileCap?: number): string;

package/dist/clients/attach/chrome/review-wait.js

@@ -0,0 +1 @@
+var o=Object.defineProperty;var n=(e,t)=>o(e,"name",{value:t,configurable:!0});import{basename as a}from"node:path";function m(e,t){const i=a(e);return i.length<=t?i:`${i.slice(0,Math.max(1,t-1))}\u2026`}n(m,"fileCell");function l(e,t=28){const i=m(e.file,Math.max(8,t));return e.submit_requested_at===void 0?`review open \xB7 ${i} \xB7 waiting on you`:`review submitted \xB7 ${i} \xB7 companion still editing`}n(l,"reviewWaitSummary");export{l as reviewWaitSummary};

package/dist/clients/attach/chrome/roster.d.ts

@@ -0,0 +1,36 @@
+import type { AttachSession } from '../session/context.js';
+/** The slice of the session the roster reads. */
+export type RosterSession = Pick<AttachSession, 'nodeId' | 'remote' | 'role' | 'canvasSource' | 'tui' | 'pal' | 'editor' | 'containers'>;
+export interface RosterHooks {
+    /** Live per-node human-ticket counts — read fresh on every rebuild, since the
+     *  viewer's attention poll reassigns the map behind us. */
+    asks: () => Record<string, number>;
+    /** Transient footer notice (errors, "already fired", swap failures). A
+     *  `sticky` notice holds until it is replaced or cleared — what the `x` stop
+     *  confirmation needs, since the ordinary notice fades in three seconds and a
+     *  question that vanished must not still be armed. */
+    setNotice: (msg: string, opts?: {
+        sticky?: boolean;
+    }) => void;
+    /** Ask the viewer to re-run the full chrome refresh. Detail popups call this
+     *  on close so a wait row that resolved while the popup was open disappears. */
+    requestChromeRefresh: () => void;
+    /** Open the viewer-owned Inspector popup (`surface inspect`) on a section —
+     *  the cron wait row routes to `schedule` and the bash row to `jobs`; the
+     *  native Inspector owns details for both. */
+    openInspector: (section: 'overview' | 'schedule' | 'jobs') => void;
+    /** Recompute the editor's hollow-cursor state (session/pane-focus.ts). */
+    syncCursor: () => void;
+}
+export interface AttachRoster {
+    /** Rebuild the rows from the canvas source, reconcile the selection, repaint. */
+    refresh(): Promise<void>;
+    /** Roster key routing, called BEFORE the editor sees the key. Returns true
+     *  when the roster consumed it (the editor must not see it). */
+    handleKey(data: string): boolean;
+    /** True while the roster holds the highlight. */
+    active(): boolean;
+    /** Drop the highlight back to the editor (the inbox strip activating). */
+    exit(): void;
+}
+export declare function createRoster(s: RosterSession, hooks: RosterHooks): AttachRoster;

package/dist/clients/attach/chrome/roster.js

@@ -0,0 +1,4 @@
+var q=Object.defineProperty;var s=(y,n)=>q(y,"name",{value:n,configurable:!0});import{execFile as _}from"node:child_process";import{Text as k,decodeKittyPrintable as H,matchesKey as R}from"@earendil-works/pi-tui";import{cliClient as C}from"../../../commands/api-client.js";import{focusNode as O}from"../../../core/runtime/focus-viewer.js";import{daemonErrorMessage as U}from"../../inbox/resolve.js";import{activeBackgroundBashJobs as w}from"../../../core/bash-jobs.js";import{contextDir as T}from"../../../core/canvas/node-agent-paths.js";import{fillBar as D,fillWidth as J,stripSgr as X,REVERSE as F}from"../../../core/canvas/nav-render.js";import{buildCanvasPanelLines as L}from"./canvas-panels.js";const V=15e3;function oe(y,n){const{editor:S,tui:x,pal:E,nodeId:u,remote:a,role:h,canvasSource:K}=y,I=y.containers.reports;let c=[],r,g=process.env.CRTR_ATTACH_ROSTER;g!==void 0&&delete process.env.CRTR_ATTACH_ROSTER;let l,v;const m=s(()=>{n.syncCursor(),I.clear();for(const e of c){const t=e.key===r;I.addChild(new k(t?D(X(e.line),J(),F):e.line,1,0))}x.requestRender()},"paint"),$=s(async()=>{const e=a?[]:(await C().listCrons()).filter(i=>i.created_by===u),t=a?[]:w(T(u)),d=a?[]:(await C().listReviews({state:"open",origin_node_id:u})).reviews;if(c=(await L(u,n.asks(),E,K,e,t,d)).items,g!==void 0){const i=g;g=void 0;const p=c.find(N=>N.kind==="node"&&N.nodeId===i);p!==void 0&&(r=p.key)}r!==void 0&&!c.some(i=>i.key===r)&&(r=void 0),l!==void 0&&!t.some(i=>i.jobId===l?.jobId)&&b(!0),m()},"refresh"),b=s(e=>{v!==void 0&&(clearTimeout(v),v=void 0),l!==void 0&&(l=void 0,e&&n.setNotice(""))},"disarmKill"),f=s(()=>{b(!0),r!==void 0&&(r=void 0,m())},"exit"),j=s(e=>H(e)??(e.length===1?e:void 0),"typed"),A=s((e,t=40)=>{const d=(e.split(`
+`)[0]??"").replace(/\s+/g," ").trim();return d.length>t?`${d.slice(0,t-1)}\u2026`:d},"commandHead"),B=s(()=>{if(h!=="controller"){n.setNotice("Read-only observer attach \u2014 cannot stop background jobs");return}const e=w(T(u));if(e.length===0){n.setNotice("Background job already finished"),n.requestChromeRefresh();return}if(e.length>1){n.setNotice(`${e.length} background jobs \u2014 press \u21B5 to pick one in the Inspector`);return}const t=e[0];l={jobId:t.jobId,label:A(t.command)},n.setNotice(`Stop \u201C${l.label}\u201D? Press y to confirm.`,{sticky:!0}),v=setTimeout(()=>b(!0),V)},"armKill"),M=s(()=>{const e=l;e!==void 0&&(b(!1),n.setNotice(`Stopping \u201C${e.label}\u201D\u2026`),_("crtr",["node","bash","kill",e.jobId,"--node",u],t=>{n.setNotice(t===null?`Stopped \u201C${e.label}\u201D.`:`Could not stop the job: ${t.message.split(`
+`)[0]}`),n.requestChromeRefresh()}))},"confirmKill");S.onCursorDownAtBottom=a?void 0:()=>{r!==void 0||c.length===0||(r=c[0].key,m())};const P=s(()=>{const e=c.find(o=>o.key===r);if(e===void 0||a)return;if(e.kind==="crons"){f(),n.openInspector("schedule");return}if(e.kind==="review"){if(h!=="controller"){n.setNotice("Read-only observer attach \u2014 cannot open the review companion");return}f();const o=process.env.TMUX_PANE;if(o===void 0||o===""){n.setNotice("Could not open the companion: no tmux pane");return}(async()=>{const i=C(),p=await i.getNode(e.companionNodeId);(await O(i,p,{pane:o})).focused||n.setNotice("Could not open the companion")})().catch(i=>n.setNotice(`Could not open the companion: ${U(i).split(`
+`)[0]}`));return}if(e.kind==="bash"){if(w(T(u)).length===0){n.setNotice("Background job already finished"),n.requestChromeRefresh();return}f(),n.openInspector("jobs");return}const t=e.nodeId;if(t===u){f();return}if(h!=="controller"){n.setNotice("Read-only observer attach \u2014 cannot focus nodes");return}const d=process.env.TMUX_PANE;if(d===void 0||d===""){n.setNotice("cannot swap \u2014 no tmux pane");return}_("tmux",["run-shell","-b",`crtr surface node focus ${t} --pane ${d} --in-place >/dev/null 2>&1`],()=>{})},"openSelected");return{refresh:$,handleKey:s(e=>{if(a)return!1;const t=R(e,"down"),d=R(e,"up");if(r===void 0)return!1;const o=c.findIndex(p=>p.key===r),i=c[o];if(l!==void 0){if(j(e)==="y")return M(),!0;b(!0)}return i?.kind==="bash"&&j(e)==="x"?(B(),!0):d?(o<=0?f():(r=c[o-1].key,m()),!0):t?(o>=0&&o<c.length-1&&(r=c[o+1].key,m()),!0):R(e,"enter")?(P(),!0):R(e,"escape")?(f(),!0):(f(),!1)},"handleKey"),active:s(()=>r!==void 0,"active"),exit:f}}s(oe,"createRoster");export{oe as createRoster};

package/dist/clients/attach/chrome/status-line.d.ts

@@ -0,0 +1,38 @@
+import type { BindingId, BindingResolution } from '../../../core/keybindings/index.js';
+import type { SessionState } from '../../../core/session-model/session-state.js';
+import type { AttachSession } from '../session/context.js';
+/** Shell/bash mode: 0 = off, 1 = `!` (output goes to the agent's context),
+ *  2 = `!!` (output hidden from the agent). Drives both the editor border hue
+ *  and the leading status segment explaining what will happen. */
+export type BashMode = 0 | 1 | 2;
+export type StatusLineSession = Pick<AttachSession, 'nodeId' | 'remote' | 'tui' | 'pal' | 'containers'>;
+export interface StatusLineHooks {
+    /** The reducer-folded broker state — role, engine, context tokens, queue. */
+    state: () => SessionState;
+    /** The editor's current bash level. */
+    bashMode: () => BashMode;
+    /** Per-node human-ticket counts for this canvas. */
+    asks: () => Record<string, number>;
+    /** The live resolved keybinding snapshot (refreshed by /reload), so shortcut
+     *  hints never go stale against a rebound key. */
+    bindings: () => BindingResolution<BindingId>;
+    /** Whether to render the closed-inbox affordance at all. Meaningful only for
+     *  a LOCAL in-tmux attach: a remote attach's local inbox registry cannot open
+     *  the remote canvas's filesystem tickets. */
+    inboxAffordance: boolean;
+    /** Whether mouse reporting is currently enabled. When false, displays a
+     *  low-priority 'mouse off' indicator in the status bar. */
+    mouseEnabled: () => boolean;
+}
+export interface AttachStatusLine {
+    /** Repaint the bar from current state. */
+    render: () => void;
+    /** Show a transient notice in the right slot. `sticky` keeps it up until
+     *  explicitly replaced instead of auto-clearing. */
+    setNotice: (msg: string, opts?: {
+        sticky?: boolean;
+    }) => void;
+    /** Cancel the pending auto-clear. Part of the viewer's local shutdown. */
+    dispose: () => void;
+}
+export declare function createStatusLine(s: StatusLineSession, hooks: StatusLineHooks): AttachStatusLine;

package/dist/clients/attach/chrome/status-line.js

@@ -0,0 +1 @@
+var L=Object.defineProperty;var r=(n,i)=>L(n,"name",{value:i,configurable:!0});import{Text as N,truncateToWidth as O}from"@earendil-works/pi-tui";import{visibleWidth as g}from"../../../core/canvas/nav-render.js";import{inTmux as S}from"../../../core/runtime/placement-tmux.js";import{formatBinding as W,inboxOpenHint as _}from"../../../core/keybindings/index.js";import{viewerKeyHint as j}from"./key-hint.js";const q=3e3,F=r(n=>n>=1e3?`${(n/1e3).toFixed(n>=1e4?0:1)}k`:`${n}`,"formatTokens");function G(n,i){const{pal:e,tui:w,nodeId:H,remote:I}=n,x=n.containers.footer;let u="",d;const m=r(()=>{const o=i.state(),a=i.bashMode(),f=i.bindings(),t=[];o.role!=="controller"&&t.push(e.muted("\u25CB read-only")),a===2?t.unshift(e.bashModeAlt("\u25CF bash \u2014 output hidden from agent")):a===1&&t.unshift(e.bashMode("\u25CF bash \u2014 output added to context"));const s=o.engine;s?.model&&t.push(e.info(s.model.id)),s?.isStreaming&&t.push(e.active("\u27F3")),o.contextTokens!==void 0&&t.push(e.muted(`${F(o.contextTokens)} ctx`)),s&&s.pendingMessageCount>0&&t.push(e.muted(`queued ${s.pendingMessageCount}`));let T=!1;if(i.inboxAffordance){const v=Object.values(i.asks()).reduce((y,E)=>y+E,0);v>0&&(T=!0,t.push(e.muted(`\u2691 ${v} \xB7 ${_(f)}`)))}i.mouseEnabled()||t.push(e.muted("mouse off")),S()&&f.gestures("crtr.attach.file-review").length>0&&t.push(e.muted(`${W(f,"crtr.attach.file-review")} review file`)),i.inboxAffordance&&t.push(e.muted(j(f,{inbox:!T})));const l=t.join(e.muted(" \xB7 ")),c=u?e.warning(`\u26A0 ${u}`):"",p=Math.max(1,(process.stdout.columns??80)-2),M=g(c),$=c?Math.max(0,p-M-1):p,h=g(l)>$?O(l,$,"\u2026"):l,C=Math.max(c?1:0,p-g(h)-M),A=c?h+" ".repeat(C)+c:h;x.clear(),x.addChild(new N(A,1,0)),w.requestRender()},"render"),b=r(()=>{d!==void 0&&(clearTimeout(d),d=void 0)},"clearTimer");return{render:m,setNotice:r((o,a)=>{u=o,b(),o&&!a?.sticky&&(d=setTimeout(()=>{d=void 0,u="",m()},q)),m()},"setNotice"),dispose:b}}r(G,"createStatusLine");export{G as createStatusLine};

package/dist/clients/attach/chrome/ticket-panel.d.ts

@@ -0,0 +1,29 @@
+import type { Component } from '@earendil-works/pi-tui';
+import type { InboxRow } from '../../inbox/dto-adapt.js';
+import type { AttachSession } from '../session/context.js';
+export type PanelSession = Pick<AttachSession, 'tui' | 'pal'>;
+export interface TicketPanelHooks {
+    /** Recompute the editor's hollow-cursor state (session/pane-focus.ts). */
+    syncCursor: () => void;
+    /** Repaint the strip — its rows hide while the panel is their expansion. */
+    refreshStrip: () => void;
+    setNotice: (msg: string) => void;
+    /** Fallback: the full-pane inbox surface seated on this ticket dir. */
+    openInbox: (dir: string) => void;
+    /** Release the terminal to $EDITOR for the comment roundtrip. */
+    suspendForChild: () => () => void;
+}
+export interface TicketPanel {
+    /** Mounted once into the frame's `ticketPanel` slot; empty while closed. */
+    readonly component: Component;
+    /** Open a ticket's page inline; review/unreadable tickets fall back. */
+    open(ticket: InboxRow): Promise<void>;
+    /** Panel key routing — consumes EVERY chunk while open. */
+    handleKey(data: string): boolean;
+    close(): void;
+    /** True while a page is open (the editor's cursor hollows). */
+    active(): boolean;
+    /** The open ticket's dir, for escalating to the full inbox surface. */
+    currentDir(): string | undefined;
+}
+export declare function createTicketPanel(s: PanelSession, hooks: TicketPanelHooks): TicketPanel;

package/dist/clients/attach/chrome/ticket-panel.js

@@ -0,0 +1 @@
+var P=Object.defineProperty;var n=(o,r)=>P(o,"name",{value:r,configurable:!0});import{claimTicket as q,heartbeatClaim as E,releaseClaim as y}from"../../../core/human/claim.js";import{watchInboxActivity as $}from"../../../core/human/root.js";import{resolvePageComponents as A}from"../../../core/config.js";import{fillBar as M,stripSgr as w,truncate as S,REVERSE as K}from"../../../core/canvas/nav-render.js";import{cliClient as x}from"../../../commands/api-client.js";import{visibleWidth as D}from"../../inbox/tui/ansi.js";import{pageViewFromDTO as I,settledStatusOf as h}from"../../inbox/dto-adapt.js";import{PageAdapter as F}from"../../inbox/page-adapter.js";import{decodeInboxKey as H}from"../../inbox/tui/keys.js";import{daemonErrorMessage as b,resolveFailureKind as O,resolveTicketPage as V}from"../../inbox/resolve.js";import{editBufferInEditor as _}from"../../inbox/review/roundtrip.js";function se(o,r){const{tui:s,pal:g}=o;let c,f=!1,m=0,p=0;const v=n(()=>Math.max(3,s.terminal.rows-10),"capRows"),u=n(e=>{const t=c;t!==void 0&&(c=void 0,clearInterval(t.heartbeat),t.unwatch(),t.adapter.close(),e&&y(t.dir,t.token),r.syncCursor(),r.refreshStrip(),s.requestRender())},"closeSession"),T=n(async(e,t)=>{f=!0;try{await V(e.id,t),u(!1),r.setNotice("Response sent")}catch(a){const i=O(a);if(i==="unreachable"||i==="other"){r.setNotice(b(a));return}u(!1),r.setNotice(i==="already_settled"?await k(e.ticketId):b(a))}finally{f=!1}},"complete"),R=n(async e=>{if(c!==e||f)return;let t;try{t=await x().getHumanInboxPage(e.ticketId)}catch(a){if(c!==e)return;u(!0),r.setNotice(`Ticket could not be read: ${b(a)}`);return}if(!(c!==e||f)){if(t.state==="resolved"||t.state==="canceled"){u(!0),r.setNotice(t.state==="canceled"?"Ticket was canceled by its requester":"Ticket was resolved elsewhere");return}if(t.revision!==e.revision){e.revision=t.revision;try{e.adapter.reload(I(t))}catch{r.setNotice("Page could not be read")}s.requestRender()}}},"onActivity"),C=n(e=>{const t=e.adapter.inputBuffer();if(t===void 0)return;const a=r.suspendForChild();let i={text:t};try{i=_(t)}finally{a(),e.adapter.setInputBuffer(i.text),i.error!==void 0&&r.setNotice(i.error),s.requestRender()}},"editPageInput");return{component:{render(e){const t=c;if(t===void 0)return[];const a=Math.max(20,e-2),i=v();(a!==m||i!==p)&&(m=a,p=i,t.adapter.resize(a,i));const d=M(w(S(` \u2691 ${t.title} \xB7 Esc closes`,e)),e,K),l=z(),B=W(t.adapter.render()).map(N=>U(` ${N}`,e,l));return[d,...B,g.border("\u2500".repeat(Math.max(0,e)))]},invalidate(){}},open:n(async e=>{if(c!==void 0&&u(!0),e.kind!=="page"){r.openInbox(e.dir);return}const t=q(e.dir);if(t===null){r.setNotice("Ticket is being edited by another inbox");return}let a,i;try{const l=await x().getHumanInboxPage(e.inboxTicketId);if(l.state==="resolved"||l.state==="canceled"){y(e.dir,t.token),r.setNotice(h(l));return}a=I(l),i=l.revision}catch{y(e.dir,t.token),r.openInbox(e.dir);return}if(c!==void 0){y(e.dir,t.token);return}m=Math.max(20,s.terminal.columns-2),p=v();const d={dir:e.dir,id:e.id,ticketId:e.inboxTicketId,title:e.title,token:t.token,revision:i,adapter:new F({ticketId:e.inboxTicketId,page:a,productKinds:A(),cols:m,rows:p,onDirty:n(()=>s.requestRender(),"onDirty"),onBack:n(()=>u(!0),"onBack"),onComplete:n(l=>{T(d,l)},"onComplete"),onEditorRequest:n(()=>C(d),"onEditorRequest")}),unwatch:n(()=>{},"unwatch"),heartbeat:setInterval(()=>{c===d&&E(d.dir,d.token)},1e4)};d.unwatch=$(()=>{R(d)}),c=d,r.syncCursor(),r.refreshStrip(),s.requestRender()},"open"),handleKey:n(e=>{const t=c;if(t===void 0)return!1;const{input:a,key:i}=H(e);return t.adapter.handleKey(a,i),s.requestRender(),!0},"handleKey"),close:n(()=>u(!0),"close"),active:n(()=>c!==void 0,"active"),currentDir:n(()=>c?.dir,"currentDir")}}n(se,"createTicketPanel");async function k(o){let r;try{r=h(await x().getHumanInboxPage(o))}catch(s){return`Ticket result is unreadable: ${b(s)}`}return r.charAt(0).toUpperCase()+r.slice(1)}n(k,"resolvedElsewhereNotice");function z(){const o=globalThis[Symbol.for("@earendil-works/pi-coding-agent:theme")];try{return o?.getBgAnsi?.("customMessageBg")}catch{return}}n(z,"contextCardBg");function U(o,r,s){if(s===void 0)return o;const g=o.replaceAll("\x1B[0m",`\x1B[0m${s}`).replaceAll("\x1B[49m",s),c=" ".repeat(Math.max(0,r-D(o)));return`${s}${g}${c}\x1B[49m`}n(U,"paintBg");function W(o){let r=o.length;for(;r>0&&w(o[r-1]).trim()==="";)r--;return o.slice(0,r)}n(W,"trimTrailingBlank");export{se as createTicketPanel};

package/dist/clients/attach/chrome/widgets.d.ts

@@ -0,0 +1,9 @@
+import type { SessionState } from '../../../core/session-model/session-state.js';
+import type { AttachSession } from '../session/context.js';
+export interface ChromeWidgets {
+    /** Paint serializable extension widgets into their fixed cockpit slots. */
+    renderExtensionWidgets: () => void;
+    /** Paint the pending steering messages above the editor. */
+    renderQueued: () => void;
+}
+export declare function createChromeWidgets(ctx: Pick<AttachSession, 'tui' | 'pal' | 'containers'>, state: () => SessionState): ChromeWidgets;

package/dist/clients/attach/chrome/widgets.js

@@ -0,0 +1 @@
+var x=Object.defineProperty;var o=(n,s)=>x(n,"name",{value:s,configurable:!0});import{Text as a,truncateToWidth as W,wrapTextWithAnsi as b}from"@earendil-works/pi-tui";import{splitRecapLines as C}from"./recap.js";function M(n,s){const{tui:u,pal:r}=n,{aboveWidgets:l,belowWidgets:p,queued:d}=n.containers;return{renderExtensionWidgets:o(()=>{const e=s();l.clear(),p.clear();const i=Math.max(1,(process.stdout.columns??80)-2);for(const[c,t]of Object.entries(e.display.widgets)){const f=c==="crtr-recap",g=f?C(t.lines).state:t.lines,h=t.placement==="belowEditor"?p:l;for(const m of g){const w=f?r.faint(m):m;for(const q of b(w,i))h.addChild(new a(q,1,0))}}u.requestRender()},"renderExtensionWidgets"),renderQueued:o(()=>{const e=s();if(d.clear(),e.queued.length>0){const i=Math.max(1,(process.stdout.columns??80)-4);d.addChild(new a(r.muted(`queued (${e.queued.length}):`),1,0));for(const c of e.queued){const t=c.text.replace(/\s+/g," ").trim();d.addChild(new a(r.faint(`  \u22EF ${W(t,i,"\u2026")}`),1,0))}}u.requestRender()},"renderQueued")}}o(M,"createChromeWidgets");export{M as createChromeWidgets};

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

@@ -0,0 +1,3 @@
+import type { BranchDef } from '../../core/command.js';
+import type { SubTier } from '../../core/help.js';
+export declare function registerAttach(namespace: string, tier: SubTier): BranchDef;

package/dist/clients/attach/command.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var n=(t,e)=>c(t,"name",{value:e,configurable:!0});import{defineBranch as h,defineLeaf as l}from"../../core/command.js";import{mark as a}from"../../core/timing.js";function v(t){return l({name:"to",description:"attach an interactive terminal viewer to a node (reviving it if dormant)",whenToUse:"you want to WATCH or DRIVE a headless node live in this pane \u2014 it connects over the node's unix socket to the broker hosting the engine and renders the same chat stream. Normal local attaches are writable; use --observer for read-only, or --canvas for a remote read-only view. A DORMANT node is revived first: crtrd runs reviveNode server-side, then the viewer streams over the broker's socket. The configured detach shortcuts leave the engine running",help:{name:`${t} attach to`,summary:"attach a terminal viewer to a headless node's running broker (writable by default, --observer for read-only); configured detach shortcuts leave the engine running",params:[{kind:"positional",name:"node",required:!0,constraint:"Node id to attach to. A dormant node is revived (server-side) before the viewer connects."},{kind:"flag",name:"observer",type:"bool",required:!1,default:!1,constraint:"Attach READ-ONLY: request the observer role. Default local attaches request the writable controller role."},{kind:"flag",name:"canvas",type:"string",required:!1,constraint:"Attach against a remote canvas target configured via `crtr canvas config add` instead of the local canvas \u2014 connects over a relayed WebSocket to the target's preview endpoint using the relay token from the 0600 secrets store. Omit for local (default): connects to the node's local unix socket, which must already exist in THIS machine's canvas.db. Does NOT honor `crtr canvas use` \u2014 this flag is the only way to attach remotely."}],output:[{name:"note",type:"string",required:!1,constraint:"Only set on the non-TTY/piped path (a static notice); the interactive path returns nothing."}],outputKind:"object",effects:["Takes over the current pane in raw mode and renders the node's live engine stream until you use a configured detach shortcut or the broker exits.","As a writable controller: sends prompts/steers/dialog answers to the engine over the socket. As observer: read-only. Multiple writable local viewers may drive the same broker.","A dormant node is revived server-side (crtrd runs reviveNode) before the viewer connects; this LOCAL process NEVER spawns pi and NEVER writes the session \u2014 it holds only a socket to the broker.","Outside a TTY (piped): prints a short notice and exits 0 \u2014 attach is an interactive program, not a pipe stage."]},run:n(async e=>{const r=e.node,o=e.observer??!1,s=e.canvas,i=process.env.CRTR_ATTACH_WAKE_PARKED!=="0";if(delete process.env.CRTR_ATTACH_WAKE_PARKED,!process.stdout.isTTY)return{note:`crtr surface attach is an interactive terminal viewer \u2014 run it in a tmux pane (a TTY), not a pipe. Node: ${r}`};a("viewer.bundle_import_start");const{runAttach:d}=await import("./viewer.js");a("viewer.bundle_loaded"),await d(r,o,s,i),process.exit(0)},"run"),render:n(e=>e.note!==void 0?String(e.note):"","render")})}n(v,"attachToLeaf");function w(t,e){return h({name:"attach",description:"a terminal viewer for a headless node \u2014 connect over its socket and drive (or watch) the live engine",whenToUse:"you want to open a headless node live in this pane \u2014 watch its engine stream and drive it by typing, without the node ever running pi in your window. A dormant node is revived server-side (crtrd runs reviveNode) before the viewer connects over a unix socket; this local process never starts the engine itself. Configured detach shortcuts leave the engine running.",tier:e,rootEntry:{concept:"a terminal viewer for a headless node \u2014 connect over its socket and drive (or watch) the live engine",desc:"attach a terminal viewer to a headless node",useWhen:"you want to open a headless node live in this pane \u2014 watch its engine stream and drive it by typing, without the node ever running pi in your window. A dormant node is revived server-side (crtrd runs reviveNode) before the viewer connects over a unix socket; this local process never starts the engine itself. Configured detach shortcuts leave the engine running."},help:{name:`${t} attach`,summary:"attach a terminal viewer to a headless node's running broker",model:`The branch opens a viewer in the current pane. A TTY is required; piped invocation prints a notice and exits. Normal local attaches request the writable controller role; --observer and --canvas are read-only. Multiple local writable viewers may watch and drive one broker. Configured detach shortcuts detach cleanly and the engine runs on. A dormant node is revived server-side (crtrd runs reviveNode) before the viewer connects. If the broker exits, the viewer holds the pane and auto-reconnects \u2014 through a yield/refresh relaunch, and across dormancy until the node wakes again \u2014 reporting "broker gone" and exiting only when the node is terminal (done/dead/canceled) or deleted. This local process NEVER spawns pi or writes the session \u2014 it holds only a socket to the broker. --canvas <name> is the escape hatch for a node hosted on a different machine's canvas \u2014 see the leaf's own -h.`},children:[v(t)]})}n(w,"registerAttach");export{w as registerAttach};