@north-light/cli 0.0.0 → 0.3.413

package/dist/commands/canvas-analytics/overview.js

@@ -0,0 +1 @@
+var C=Object.defineProperty;var m=(t,e)=>C(t,"name",{value:e,configurable:!0});import{matchesKey as l,visibleWidth as W}from"@earendil-works/pi-tui";import{theme as f,wrapText as D}from"../../core/tui/panel.js";import{hbar as G}from"./chart.js";import{formatCount as x,formatDuration as H,formatPrice as P,formatTokens as L,padLeft as g,padRight as w,unavailable as T}from"./format.js";import{byEstimate as O,fullNameLine as j,graphLabel as $}from"./graphs.js";import{NARROW_BAR_CELLS as K,isNarrow as V,markRow as S,moreRow as Y,textWidth as B}from"./view.js";const q=10;function b(t,e){return t.ok?e(t.value):"unavailable"}m(b,"measured");function R(t){return[{label:"GRAPHS",short:"GRAPHS",value:b(t.graphs,e=>x(e.count)),landing:{tab:"graphs",at:"size-chart"}},{label:"AGENTS SPAWNED",short:"SPAWNED",value:b(t.graphs,e=>x(e.spawned)),landing:{tab:"graphs",at:"kind-chart"}},{label:"MEDIAN AGENT TIME",short:"MEDIAN TIME",value:b(t.time,e=>e.all===null?"none finished":H(e.all.median_ms)),landing:{tab:"time",at:"all-agents"}},{label:"API-PRICE EST.",short:"API-PRICE EST.",value:b(t.usage,e=>P(e.api_price_estimate)),landing:{tab:"usage",at:"top-model"}},{label:"MEMORY READS",short:"MEMORY READS",value:b(t.memory,e=>x(e.read.entries)),landing:{tab:"memory",at:"top-read-document"}}]}m(R,"headlines");function y(t){const e=[t.graphs,t.time,t.usage,t.memory].flatMap(n=>n.ok?[]:[n.reason]);return[...new Set(e)]}m(y,"failures");class F{static{m(this,"OverviewView")}ctx;zone="headline";headline=0;row=0;shown=0;constructor(e){this.ctx=e}ranked(){const e=this.ctx.data.graphs;return e.ok?[...e.value.graphs].sort(O):[]}rowCount(){const e=this.ranked().length;return this.shown+(e>this.shown?1:0)}handleKey(e){if(l(e,"escape"))return"back";if(l(e,"left")||l(e,"h"))return this.zone==="headline"&&(this.headline=Math.max(0,this.headline-1)),"handled";if(l(e,"right")||l(e,"l"))return this.zone==="headline"&&(this.headline=Math.min(4,this.headline+1)),"handled";if(l(e,"down")||l(e,"j"))return this.zone==="headline"?this.rowCount()>0&&(this.zone="list",this.row=0):this.row=Math.min(this.rowCount()-1,this.row+1),"handled";if(l(e,"up")||l(e,"k"))return this.zone==="list"&&(this.row===0?this.zone="headline":this.row-=1),"handled";if(l(e,"enter")){if(this.zone==="headline")return this.ctx.nav.openTab(R(this.ctx.data)[this.headline].landing),"handled";const n=this.row<this.shown?this.ranked()[this.row]:void 0;return n!==void 0?this.ctx.nav.openGraphDetail(n.graph_id):this.ctx.nav.openTab({tab:"graphs",at:"list-by-estimate"}),"handled"}return"unhandled"}keyLine(e){return e?"\u2190\u2192\u2191\u2193 \xB7 Enter":"\u2190\u2192\u2191\u2193 select \xB7 Enter open"}render(e,n,a){const s=V(e),i=s?this.narrowHeadlines(e,a):this.wideHeadlines(e,a);for(const o of y(a))i.push(...D(T(o),e).map(h=>f.fg("warning",h)));return i.push(""),i.push(...this.topGraphs(e,Math.max(3,n-i.length),a,s)),i}mark(e){const n=this.zone==="headline"&&this.headline===e;return{selected:n,prefix:n?"> ":"  "}}wideHeadlines(e,n){const a=Math.floor(e/5);let s="",i="";return R(n).forEach((o,h)=>{const{selected:r,prefix:c}=this.mark(h),d=w(`${c}${o.label}`,a);s+=r?f.bold(d):f.fg("dim",d);const E=w(`  ${o.value}`,a);i+=r?f.bold(E):E}),[s,i]}narrowHeadlines(e,n){const a=R(n).map((s,i)=>{const{selected:o,prefix:h}=this.mark(i),r=`${h}${s.short} ${s.value}`;return o?f.bold(r):r});return[a.slice(0,3).join("  "),a.slice(3).join("  ")].map(s=>w(s,e))}topGraphs(e,n,a,s){const[i,o,h]=s?[7,9,7]:[7,9,8],r=a.graphs.ok?this.ranked():[];let c,d;if(s)c=K,d=Math.max(8,e-2-i-1-c-o-h-1);else{const u=e-2-i-1-o-h-3,p=Math.max(0,...r.map(A=>W($(A))));d=B(u,p,30),c=Math.max(10,u-d)}const M=`${w(s?"Top graphs, API est.":"Top graphs, by API-price estimate",2+d)}${g("agents",i)} ${" ".repeat(c)}${g("est.",o)}${g("tokens",h)}`;if(!a.graphs.ok)return[M,`  ${T(a.graphs.reason)}`];if(r.length===0)return this.shown=0,[M,"  None in this window."];const I=Math.max(1,n-3);this.shown=Math.min(s?q:r.length,r.length,I),this.zone==="list"&&(this.row=Math.min(this.row,this.rowCount()-1));const N=r[0].api_price_estimate,v=[f.fg("dim",M)];for(let u=0;u<this.shown;u+=1){const p=r[u],A=`${w($(p),d)}${g(x(p.active_agents),i)} ${G(p.api_price_estimate,N,c)}${g(P(p.api_price_estimate),o)}${g(L(p.tokens),h)}`;v.push(S(A,this.zone==="list"&&this.row===u))}const z=r.length-this.shown;if(z>0){const u=Y(z,"graphs").slice(2);v.push(S(u,this.zone==="list"&&this.row===this.shown))}const _=this.zone==="list"?r[this.row]:void 0,k=_!==void 0&&this.row<this.shown?j($(_),d):void 0;return k!==void 0&&v.push(k),v}}const ne=m(t=>new F(t),"createOverviewView");export{ne as createOverviewView};

package/dist/commands/canvas-analytics/shell.d.ts

@@ -0,0 +1,60 @@
+import { type Component, type Focusable, type TUI } from '@earendil-works/pi-tui';
+import { type TuiPageControl } from '../../core/tui/page-host.js';
+type PageResult = {
+    open: string;
+};
+export declare class AnalyticsShell implements Component, Focusable {
+    private readonly tui;
+    private readonly rows;
+    private readonly suspendForChild;
+    private readonly control;
+    focused: boolean;
+    private readonly client;
+    private asOf;
+    private window;
+    private project;
+    private tab;
+    /** Detail views opened over the current tab, innermost last. */
+    private stack;
+    private load;
+    private overlay;
+    /** Identifies the newest request; an answer carrying an older number is dropped. */
+    private seq;
+    /** Picker choices from the newest successful answer. */
+    private projects;
+    constructor(tui: TUI, rows: () => number, suspendForChild: () => () => void, control: TuiPageControl<PageResult>);
+    /** Issue a request for the current T, window, and scope. */
+    request(): void;
+    private ready;
+    private nav;
+    /** Nothing is cached: every render draws from state. */
+    invalidate(): void;
+    dispose(): void;
+    private get shownTab();
+    private get topView();
+    handleInput(data: string): void;
+    private handleKey;
+    private cycleTab;
+    private pickerKey;
+    private sourcesKey;
+    render(width: number): string[];
+    private renderPage;
+    private fit;
+    private scopeLabel;
+    private controlsRow;
+    private tabRow;
+    private coverageLine;
+    private keyParts;
+    /** The longest spelling that fits: wide keys with the wide tail, then with the
+     *  short tail, then the narrow keys. */
+    private keyLine;
+    private body;
+    private pickerBody;
+    private sourcesBody;
+    /** The transcript scan's failure reason, which every scan-based measure carries. */
+    private scanFailure;
+}
+/** `pane` is the tmux pane the page was opened from (the prefix menu passes it);
+ *  without it, `o` opens beside this process's own pane. */
+export declare function runAnalytics(pane: string | undefined): Promise<void>;
+export {};

package/dist/commands/canvas-analytics/shell.js

@@ -0,0 +1,2 @@
+var C=Object.defineProperty;var l=(c,e)=>C(c,"name",{value:e,configurable:!0});import{spawnSync as O}from"node:child_process";import{basename as R}from"node:path";import{matchesKey as o,truncateToWidth as D,visibleWidth as b}from"@earendil-works/pi-tui";import{localClient as W}from"../../api/node-transport.js";import{runShellInBackground as N}from"../../core/runtime/placement-tmux.js";import{runTuiPage as V}from"../../core/tui/page-host.js";import{rule as _,theme as d,wrapText as k}from"../../core/tui/panel.js";import{shellQuote as q}from"../../shared/shell-quote.js";import{ExitCode as B}from"../../types.js";import{formatClock as F,formatCount as f,formatDateTime as y,formatPrice as G,formatTimezone as H,padRight as v,unavailable as x}from"./format.js";import{createGraphDetailView as K}from"./graph-detail.js";import{createGraphsView as U}from"./graphs.js";import{createMemoryView as z}from"./memory.js";import{createOverviewView as X}from"./overview.js";import{createTimeView as Y}from"./time.js";import{createUsageView as Q}from"./usage.js";import{MAX_PAGE_WIDTH as J,TABS as m,isNarrow as Z,listWindow as ee,moreRow as te}from"./view.js";const $=50,j=20,A=36e5,se={"24h":24*A,"7d":168*A},T={"24h":"Last 24h","7d":"Last 7d"},L=16;function E(c){return c.graphs.ok&&c.memory.ok&&c.agents.length===0&&c.memory.value.read.entries===0&&c.memory.value.loaded.entries===0}l(E,"isEmpty");function re(c){return(c instanceof Error?c.message:String(c)).trim().replace(/\.$/,"")||"unknown error"}l(re,"errorReason");class ne{static{l(this,"AnalyticsShell")}tui;rows;suspendForChild;control;focused=!1;client=W({autostart:!1});asOf=new Date;window="24h";project=null;tab="overview";stack=[];load={kind:"loading"};overlay;seq=0;projects=[];constructor(e,t,s,n){this.tui=e,this.rows=t,this.suspendForChild=s,this.control=n}request(){const e=++this.seq;this.load={kind:"loading"},this.stack=[];const t={as_of:this.asOf.toISOString(),window:this.window,...this.project!==null?{project:this.project}:{}};this.client.analytics(t).then(s=>{e===this.seq&&(this.projects=s.projects,this.load=this.ready(s),this.tui.requestRender())},s=>{e===this.seq&&(this.load={kind:"error",reason:re(s)},this.tui.requestRender())}),this.tui.requestRender()}ready(e){const t={data:e,nav:this.nav()};return{kind:"ready",data:e,ctx:t,views:{overview:X(t),graphs:U(t),time:Y(t),memory:z(t),usage:Q(t)}}}nav(){return{openTab:l(e=>{this.load.kind==="ready"&&(this.stack=[],this.tab=e.tab,this.load.views[e.tab].land?.(e),this.tui.requestRender())},"openTab"),openGraphDetail:l((e,t)=>{this.load.kind==="ready"&&(this.stack.push({view:K(this.load.ctx,e,t),tab:"graphs"}),this.tui.requestRender())},"openGraphDetail"),openInspector:l(e=>{const t=this.suspendForChild();try{O("crtr",["surface","inspect",e,"--read-only"],{stdio:"inherit"})}finally{t()}},"openInspector"),openConversation:l(e=>this.control.submit({open:e}),"openConversation"),readFinalReport:l(async e=>(await this.client.historyRead({ref:e})).content,"readFinalReport"),requestRender:l(()=>this.tui.requestRender(),"requestRender")}}invalidate(){}dispose(){this.seq+=1}get shownTab(){return this.stack.at(-1)?.tab??this.tab}get topView(){if(!(this.load.kind!=="ready"||E(this.load.data)))return this.stack.at(-1)?.view??this.load.views[this.tab]}handleInput(e){this.handleKey(e),this.tui.requestRender()}handleKey(e){if(o(e,"ctrl+c")||o(e,"q"))return this.control.cancel();if(this.rows()<j||this.tui.terminal.columns<$){o(e,"escape")&&this.control.cancel();return}if(this.overlay?.kind==="picker")return this.pickerKey(e,this.overlay);if(this.overlay?.kind==="sources")return this.sourcesKey(e,this.overlay);if(o(e,"shift+tab"))return this.cycleTab(-1);if(o(e,"tab"))return this.cycleTab(1);if(o(e,"w"))return this.window=this.window==="24h"?"7d":"24h",this.request();if(o(e,"shift+r"))return this.asOf=new Date,this.request();if(o(e,"p")){const n=this.projects.findIndex(r=>r.cwd===this.project);this.overlay={kind:"picker",cursor:n+1};return}if(o(e,"s")){this.overlay={kind:"sources",scroll:0};return}const t=this.topView,s=t===void 0?"unhandled":t.handleKey(e);(s==="back"||s==="unhandled"&&o(e,"escape"))&&(this.stack.length>0?this.stack.pop():this.control.cancel())}cycleTab(e){const t=m.findIndex(s=>s.id===this.shownTab);this.tab=m[(t+e+m.length)%m.length].id,this.stack=[]}pickerKey(e,t){const s=this.projects.length+1;if(o(e,"escape")||o(e,"p"))this.overlay=void 0;else if(o(e,"down")||o(e,"j"))t.cursor=Math.min(s-1,t.cursor+1);else if(o(e,"up")||o(e,"k"))t.cursor=Math.max(0,t.cursor-1);else if(o(e,"enter")){this.overlay=void 0;const n=t.cursor===0?null:this.projects[t.cursor-1].cwd;n!==this.project&&(this.project=n,this.request())}}sourcesKey(e,t){o(e,"escape")||o(e,"s")?this.overlay=void 0:o(e,"down")||o(e,"j")?t.scroll+=1:(o(e,"up")||o(e,"k"))&&(t.scroll=Math.max(0,t.scroll-1))}render(e){const t=this.rows();if(e<$||t<j){const r=k(`Analytics needs at least ${$} \xD7 ${j}; this window is ${e} \xD7 ${t}.`,e);return this.fit(r,t,e)}const s=Math.min(e,J);if(s===e)return this.renderPage(e,t);const n=" ".repeat(Math.floor((e-s)/2));return this.renderPage(s,t).map(r=>r===""?"":`${n}${r}`)}renderPage(e,t){const s=Z(e),n=[this.controlsRow(e,s),this.tabRow(s),_(e)],r=this.coverageLine(),i=[...r!==void 0?[r]:[],_(e),this.keyLine(e,s)],a=Math.max(1,t-n.length-i.length);return this.fit([...n,...this.fit(this.body(e,a),a,e),...i],t,e)}fit(e,t,s){const n=e.slice(0,t).map(r=>D(r,s,"\u2026"));for(;n.length<t;)n.push("");return n}scopeLabel(){return this.project===null?"All projects":R(this.project)||this.project}controlsRow(e,t){const s=`${this.scopeLabel()} \u25BE`,n=`as of ${F(this.asOf)}`,r=this.window==="24h",i=t?`${r?"[24h] 7d":"24h [7d]"} \xB7 ${s}`:`${v(s,34)}${r?"[ Last 24h ]   Last 7d  ":"  Last 24h   [ Last 7d ]"}`,a=e-b(i)-b(n)-(t?0:3);return a>=2?`${i}${" ".repeat(a)}${d.fg("dim",n)}`:`${i}  ${d.fg("dim",n)}`}tabRow(e){const t=this.shownTab;return m.map(({id:s,label:n})=>{const r=s===t?`[${n}]`:e?n:` ${n}`,i=e?r:v(r,12);return s===t?d.fg("accent",d.bold(i)):i}).join(e?" ":"")}coverageLine(){if(this.load.kind!=="ready")return;const e=this.load.data.transcripts;if(!(e===null||e.unreadable.length===0))return d.fg("warning",`Sources: ${f(e.unreadable.length)} of ${f(e.total)} transcripts unreadable (s)`)}keyParts(e){if(this.overlay?.kind==="picker")return[e?"\u2191\u2193 Enter":"\u2191\u2193 project \xB7 Enter choose",e?"Esc":"Esc close picker"];if(this.overlay?.kind==="sources")return[e?"\u2191\u2193":"\u2191\u2193 scroll",e?"Esc":"Esc close sources"];const t=this.topView,s=t?.keyLine(e)??"",n=t?.escapeLabel?.()??(this.stack.length>0?"back":"close");return[...s!==""?[s]:[],e?"Esc":`Esc ${n}`]}keyLine(e,t){const s="Tab tab \xB7 w 24h/7d \xB7 p project \xB7 R refresh \xB7 s sources \xB7 q close",n="Tab w p R s q",r=[...this.keyParts(!0),n].join(" \xB7 "),a=(t?[]:[[...this.keyParts(!1),s].join(" \xB7 "),[...this.keyParts(!1),n].join(" \xB7 ")]).find(h=>b(h)<=e)??r;return d.fg("dim",a)}body(e,t){if(this.overlay?.kind==="sources")return this.sourcesBody(e,t,this.overlay);if(this.overlay?.kind==="picker")return this.pickerBody(t,this.overlay);switch(this.load.kind){case"loading":return["Computing\u2026"];case"error":return k(`Could not load analytics: ${this.load.reason}. R retries.`,e);case"ready":return E(this.load.data)?[`No recorded activity in ${this.scopeLabel()}, ${T[this.window]}.`]:this.topView.render(e,t,this.load.data)}}pickerBody(e,t){const s=[{label:"All projects",detail:"",path:""},...this.projects.map(a=>({label:R(a.cwd)||a.cwd,detail:G(a.api_price_estimate),path:a.cwd}))],n=[d.bold("Project"),d.fg("dim","Projects with at least one active agent in the window, by API-price estimate."),""],r=ee(s.length,t.cursor,Math.max(1,e-n.length)),i=[...n];for(let a=r.start;a<r.end;a+=1){const h=s[a],w=a===t.cursor,u=(a===0?null:h.path)===this.project?" (current)":"",p=`${v(h.label,32)} ${h.detail.padStart(6)}${u}${w&&h.path!==""?`  ${h.path}`:""}`;i.push(w?d.bold(`> ${p}`):`  ${p}`)}return r.more>0&&i.push(te(r.more,"projects")),i}sourcesBody(e,t,s){const n=this.load,r=n.kind==="ready"?n.data:void 0,i=n.kind==="loading"?"Computing\u2026":"Could not load analytics.",a=r!==void 0?new Date(r.window_start):new Date(this.asOf.getTime()-se[this.window]),h=[["Window",`${T[this.window]}, rolling: ${y(a)} \u2192 ${y(this.asOf)} ${H(this.asOf)}, frozen until R.`],["Scope",this.project===null?"All projects.":this.project],["Graph","A root agent and every agent whose parent chain leads to it. Every agent is in exactly one graph, so graph rows add up to page totals. An agent whose parent was deleted joins the graph of its topmost surviving ancestor, marked (root deleted)."],["Graph view","The canvas graph view follows report subscriptions and can group agents differently."],["Active","An agent with at least one model response inside the window."],["Spawned","A non-root agent created inside the window."],["Finished","An agent whose final report landed inside the window. Its agent time is created \u2192 final report, full length, not clipped to the window."],["Model response","An assistant message in any transcript bound to the agent whose stop reason is not error, at its recorded time. Responses copied into a forked agent count once, for the agent that produced them; one provider response id counts once."],["Model","The provider and model recorded on each response, not the current setting."],["Tokens","Per response: input + output + cache read + cache write."],["Context size","Per response: input + cache read + cache write."],["API-price est.","The price pi recorded for each response at published API rates when it was made; never recomputed. It is not what your subscriptions charged."],["Transcripts",r===void 0?i:r.transcripts===null?x(this.scanFailure(r)):`${f(r.transcripts.read)} of ${f(r.transcripts.total)} transcripts read.`],["Unknown",r===void 0?i:r.unknown_responses===null?x(this.scanFailure(r)):`${f(r.unknown_responses)} responses with no model or usage recorded.`],["Memory reads",`Read on purpose: an agent ran crtr canvas read and got the document back. Loaded automatically: a document's full body entered an agent's context another way \u2014 at launch, by a delivery rule, as a companion of a read, or by a document slash command. ${r===void 0?i:r.memory_log_started_at===null?"No recording start time is stored.":`Recorded since ${y(r.memory_log_started_at)}.`} Reads made while crtrd was unreachable are not recorded.`],["Time split","Running and waiting time are not recorded."],["History",`${r===void 0?i:r.oldest_agent_created===null?"No surviving agents.":`Oldest surviving agent created ${y(r.oldest_agent_created)}.`} Deleted agents and their transcripts are not counted.`]],w=Math.max(10,e-L-2),u=[d.bold(`Sources \xB7 ${T[this.window]} \xB7 ${this.scopeLabel()}`),""];for(const[g,I]of h)k(I,w).forEach((P,S)=>{u.push(`${v(S===0?g:"",L)}  ${P}`)});const p=r?.transcripts?.unreadable??[];if(p.length>0){u.push("","Unreadable transcripts:");for(const g of p)u.push(`  ${g.node_id} (${g.reason})`)}const M=Math.max(0,u.length-t);return s.scroll=Math.min(s.scroll,M),u.slice(s.scroll,s.scroll+t)}scanFailure(e){return e.graphs.ok?"the transcript scan failed":e.graphs.reason}}async function je(c){if(!process.stdin.isTTY||!process.stdout.isTTY){process.stderr.write(`crtr canvas analytics needs an interactive terminal; open it from the prefix menu (shift+a) or run it in a terminal.
+`),process.exitCode=B.GENERAL;return}const e=await V(({tui:t,terminal:s,suspendForChild:n},r)=>{const i=new ne(t,()=>s.rows,n,r);return i.request(),i});if(e!==void 0){const t=c??process.env.TMUX_PANE,s=t!==void 0&&t!==""?` --pane ${q(t)}`:"";N(`crtr surface node focus ${q(e.open)}${s} >/dev/null 2>&1`)}process.exit(0)}l(je,"runAnalytics");export{ne as AnalyticsShell,je as runAnalytics};

package/dist/commands/canvas-analytics/time.d.ts

@@ -0,0 +1,2 @@
+import { type AnalyticsViewFactory } from './view.js';
+export declare const createTimeView: AnalyticsViewFactory;

package/dist/commands/canvas-analytics/time.js

@@ -0,0 +1 @@
+var H=Object.defineProperty;var T=(w,t)=>H(w,"name",{value:t,configurable:!0});import{matchesKey as y}from"@earendil-works/pi-tui";import{theme as _,wrapText as V}from"../../core/tui/panel.js";import{columnChart as j,logAxisLabels as G,percentileLine as q}from"./chart.js";import{AgentDrilldown as z,graphName as B}from"./drilldown.js";import{formatCount as D,formatDuration as $,formatTimeOfDay as F,padLeft as M,padRight as A,plural as J,truncate as I,unavailable as P}from"./format.js";import{MAX_COLUMN_CHART_ROWS as S,isNarrow as K,listWindow as Q,markRow as E,moreRow as Y}from"./view.js";const v=6e4,b=60*v,Z=v,tt=4*b,nt=[{ms:v,label:"1m"},{ms:5*v,label:"5m"},{ms:15*v,label:"15m"},{ms:b,label:"1h"},{ms:4*b,label:"4h"}],O="Created \u2192 final report, by kind",U="\u2500\u2500 10th\u201390th percentile  \u25CF median";class et{static{T(this,"TimeView")}ctx;cursor=0;layers=[];narrow=!1;constructor(t){this.ctx=t}get time(){return this.ctx.data.time.ok?this.ctx.data.time.value:void 0}items(t){const n=this.time;if(n===void 0)return[];const a=n.all===null?[]:[{kind:"all",stats:n.all},...n.by_kind.map(e=>({kind:"kind",name:e.kind,stats:e}))];return t?[...a,{kind:"activity"}]:a}render(t,n,a){if(!a.time.ok)return[`Time: ${P(a.time.reason)}`];const e=a.time.value,s=K(t);this.narrow=s,s||(this.layers=this.layers.filter(r=>r.kind!=="activity"));const o=this.items(s);this.cursor=Math.min(this.cursor,Math.max(0,o.length-1));const i=V(this.summary(e),t),l=this.layers.at(-1);if(l?.kind==="drill")return[...i,"",...l.list.render(t,n-i.length-1)];if(l?.kind==="activity")return[...i,"",...this.activity(e,t,Math.max(2,Math.min(8,n-i.length-4)))];const u=[...i,"",...s?[O,_.fg("dim",U)]:[`${A(O,38)}${_.fg("dim",U)}`]];if(e.all===null){const r=[...u,"None in this window."];return s?[...r,"",E(I(`${this.activityTitle(e)} \u2192`,t-2),!0)]:[...r,"",...this.activity(e,t,Math.max(4,Math.min(S,n-r.length-4)))]}const h=this.layout(t,s),f=o.filter(r=>r.kind==="kind"),c=[...u,_.fg("dim",`${" ".repeat(2+h.label+h.count+2)}${G(nt,h.axis)}${M("median",h.num)}${M("p90",h.num)}`)];c.push(this.row(o[0],h,this.cursor===0),"");const m=T(r=>s?2:r+3,"tail"),g=n-c.length;let k=Math.max(4,Math.min(S,g-f.length-m(0)));!s&&g-m(k)<Math.min(f.length,3)&&(k=2);const p=Q(f.length,this.cursor-1,Math.max(1,g-m(k)));for(let r=p.start;r<p.end;r+=1)c.push(this.row(f[r],h,this.cursor===r+1));return p.more>0&&c.push(Y(p.more,"kinds")),c.push(""),s?c.push(E(I(`${this.activityTitle(e)} \u2192`,t-2),this.cursor===o.length-1)):c.push(...this.activity(e,t,k)),c}summary(t){const n=t.all;return n===null?"No agents finished in this window.":`${J(n.count,"agent","agents")} finished \xB7 median ${$(n.median_ms)} \xB7 p90 ${$(n.p90_ms)} \xB7 longest ${$(n.max_ms)}`}layout(t,n){const a=n?12:14,e=n?4:5,s=n?7:8,o=t-2-a-e-2-2*s-1,i=Math.max(10,n?Math.min(60,o):o);return{label:a,count:e,num:s,axis:{minMs:Z,maxMs:tt,cells:i}}}row(t,n,a){if(t.kind==="activity")return"";const e=t.kind==="all"?"all agents":t.name,{stats:s}=t,o=`${A(e,n.label)}${M(D(s.count),n.count)}  ${q(s,n.axis)}${M($(s.median_ms),n.num)}${M($(s.p90_ms),n.num)}`;return E(o,a)}activityTitle(t){return`Agents with at least one model response, per ${t.activity.bucket_ms>=24*b?"day":"hour"}`}activity(t,n,a){const{buckets:e,max:s,bucket_ms:o}=t.activity,i=o>=24*b,l=this.activityTitle(t);if(s===0||e.length===0)return[l,"None in this window."];const u=`most in one ${i?"day":"hour"}: ${D(s)}`,h=n-2-4,f=K(n),c=Math.floor((h+1)/e.length),m=!f&&c>=6?2:1,g=Math.max(1,f?Math.min(i?6:2,c-1):c-m),k=2+e.length*(g+m)-m,p=f?Math.min(n-u.length,60):k-u.length,r=n-2>=l.length+u.length+4&&p>=l.length+2?[`${A(l,p)}${_.fg("dim",u)}`]:[l,_.fg("dim",u)],X=j(e.map(x=>x.agents),a,g,m).map(x=>`  ${x}`),L=g+m;let d="";e.forEach((x,C)=>{if(!i&&C%6!==0)return;const R=C*L,W=i?new Date(x.start).toLocaleDateString("en-US",{weekday:"short"}):F(x.start);R<d.length+(d===""?0:1)||(d=d.padEnd(R)+W)});const N=e.length*L-m;return d=N>=d.length+1?`${d.padEnd(N)}now`:d,[...r,...X,_.fg("dim",`  ${d}`)]}handleKey(t){const n=this.layers.at(-1);if(n?.kind==="drill")return n.list.handleKey(t)==="close"&&this.layers.pop(),"handled";if(n?.kind==="activity")return y(t,"escape")?(this.layers.pop(),"handled"):"unhandled";if(y(t,"escape"))return"back";if(!this.ctx.data.time.ok)return"unhandled";const a=this.items(this.narrow);if(y(t,"down")||y(t,"j"))this.cursor=Math.min(a.length-1,this.cursor+1);else if(y(t,"up")||y(t,"k"))this.cursor=Math.max(0,this.cursor-1);else if(y(t,"enter")){const e=a[this.cursor];e?.kind==="activity"?this.layers.push({kind:"activity"}):e!==void 0&&this.layers.push({kind:"drill",list:this.drill(e.kind==="kind"?e.name:void 0)})}else return"unhandled";return"handled"}drill(t){const n=this.ctx.data,a=n.agents.filter(i=>i.finished_in_window&&i.agent_time_ms!==null&&(t===void 0||i.kind===t)).sort((i,l)=>l.agent_time_ms-i.agent_time_ms||i.name.localeCompare(l.name)),e=[...t===void 0?[{header:"kind",kind:"text",max:18}]:[],{header:"agent",kind:"text"},{header:"graph",kind:"text"},{header:"created\u2192final",kind:"number"}],s=a.map(i=>({node_id:i.node_id,graph_id:i.graph_id,cells:[...t===void 0?[i.kind]:[],i.name,B(n,i.graph_id),$(i.agent_time_ms)]})),o=t===void 0?"All finished agents, longest first":`${t} \xB7 finished agents, longest first`;return new z(o,e,s,this.ctx.nav)}keyLine(t){const n=this.layers.at(-1);return n?.kind==="drill"?n.list.keyLine(t):n?.kind==="activity"||this.items(t).length===0?"":t?"\u2191\u2193 Enter":"\u2191\u2193 kind \xB7 Enter: that kind's agents, longest first"}escapeLabel(){const t=this.layers.at(-1);if(t?.kind==="drill")return"back to kinds";if(t?.kind==="activity")return"back"}land(){this.layers=[],this.cursor=0}}const mt=T(w=>new et(w),"createTimeView");export{mt as createTimeView};

package/dist/commands/canvas-analytics/usage.d.ts

@@ -0,0 +1,2 @@
+import { type AnalyticsViewFactory } from './view.js';
+export declare const createUsageView: AnalyticsViewFactory;

package/dist/commands/canvas-analytics/usage.js

@@ -0,0 +1 @@
+var V=Object.defineProperty;var R=(b,e)=>V(b,"name",{value:e,configurable:!0});import{matchesKey as y,visibleWidth as z}from"@earendil-works/pi-tui";import{columns as H,rule as S,theme as M,wrapText as P}from"../../core/tui/panel.js";import{OTHER_FILL as X,STACK_FILLS as q,hbar as N,stackLegend as G,stackedBar as J}from"./chart.js";import{AgentDrilldown as Q,graphName as Y}from"./drilldown.js";import{formatCount as Z,formatPrice as E,formatShare as ee,formatTokens as f,padLeft as h,padRight as x,plural as te,truncate as K,unavailable as ne}from"./format.js";import{NARROW_BAR_CELLS as T,isNarrow as se,listWindow as W,markRow as B,moreRow as U,textWidth as F}from"./view.js";const oe="API-price est. = the price pi recorded for each response at published API rates. It is not what your subscriptions charged.",O="Which models each kind used",re=["< 50k","50\u2013100k","100\u2013150k","150\u2013200k","200k+"],v=R(b=>`${b.provider}/${b.model}`,"key");class ie{static{R(this,"UsageView")}ctx;cursor=0;layers=[];narrow=!1;labels=new Map;constructor(e){if(this.ctx=e,!e.data.usage.ok)return;const{models:t,legend:s}=e.data.usage.value,o=new Map([...t,...s].map(r=>[v(r),r])),i=new Map;for(const r of o.values())i.set(r.model,(i.get(r.model)??0)+1);for(const[r,n]of o)this.labels.set(r,i.get(n.model)>1?r:n.model)}label(e){return this.labels.get(v(e))??e.model}get usage(){return this.ctx.data.usage.ok?this.ctx.data.usage.value:void 0}count(){const e=this.usage;return e===void 0?0:this.layers.at(-1)?.kind==="detail"?e.models.length:e.models.length+(this.narrow?e.kinds.length>0?1:0:e.kinds.length)}render(e,t,s){if(!s.usage.ok)return[`Usage: ${ne(s.usage.reason)}`];const o=s.usage.value,i=se(e);this.narrow=i,i||(this.layers=this.layers.filter(_=>_.kind!=="kinds")),this.cursor=Math.min(this.cursor,Math.max(0,this.count()-1));const r=P(this.summary(o),e),n=P(oe,e).map(_=>M.fg("dim",_)),a=this.layers.at(-1);if(a?.kind==="drill")return[...r,"",...a.list.render(e,t-r.length-1)];if(a?.kind==="kinds")return[...r,"",...this.kindsChart(o,e,t-r.length-1-n.length-1,a.cursor),"",...n];if(i&&a?.kind==="detail")return[...r,"",...this.detail(o.models[a.model],e,i)];const k=s.unknown_responses!==null&&s.unknown_responses>0?s.unknown_responses:0,d=[...r,""];if(o.models.length===0)return[...d,"By model","None in this window.",...k>0?[this.unknownRow(k,e,12)]:[],"",...n];const m=this.widths(o,e,i),u=i?2:a?.kind==="detail"?12:4+Math.min(o.kinds.length,8),l=Math.max(1,t-d.length-1-(k>0?1:0)-u-n.length),p=this.modelsChart(o,m,e,Math.min(o.models.length+1,l),i),g=[...d,...p,...k>0?[this.unknownRow(k,e,m.label)]:[]];if(i){const _=o.kinds.length>0?[B(K(`${O} \u2192`,e-2),this.cursor===o.models.length)]:[];return[...g,"",..._,"",...n]}return g.push(S(e)),a?.kind==="detail"?g.push(...this.detail(o.models[a.model],e,!1)):g.push(...this.kindsChart(o,e,t-g.length-n.length-1,this.cursor-o.models.length)),[...g,S(e),...n]}summary(e){const t=[`${E(e.api_price_estimate)} API-price estimate`,`${f(e.tokens)} tokens`];return e.median_context!==null&&t.push(`median context ${f(e.median_context)} per response`),t.join(" \xB7 ")}widths(e,t,s){const o=Math.max(7,...e.models.map(n=>this.label(n).length));if(s)return{label:Math.max(8,Math.min(o,t-2-1-T-8-7-8)),bar:T,est:8,tokens:7,context:8};const i=t-2-2-15-9-16,r=F(i,o,7);return{label:r,bar:Math.max(6,i-r),est:15,tokens:9,context:16}}modelsChart(e,t,s,o,i){const r=2+t.label+(i?1:2)+t.bar,n=i?`${x("By model",r)}${h("est.",t.est)}${h("tokens",t.tokens)}${h("context",t.context)}`:`${x("By model",r)}${h("API-price est.",t.est)}${h("tokens",t.tokens)}${h("median context",t.context)}`,a=[M.fg("dim",K(n,s))],k=Math.max(0,...e.models.map(u=>u.api_price_estimate)),d=this.cursor<e.models.length?this.cursor:-1,m=W(e.models.length,Math.max(0,d),Math.max(1,o-1));for(let u=m.start;u<m.end;u+=1){const l=e.models[u],p=`${x(this.label(l),t.label)}${i?" ":"  "}${N(l.api_price_estimate,k,t.bar)}${h(E(l.api_price_estimate),t.est)}${h(f(l.tokens),t.tokens)}${h(f(l.context.median),t.context)}`;a.push(B(p,u===d))}return m.more>0&&a.push(U(m.more,"models")),a}unknownRow(e,t,s){return M.fg("dim",K(`  ${x("unknown",s)}  ${te(e,"response","responses")} with no model or usage recorded`,t))}kindsChart(e,t,s,o){const i=e.legend.map(v),r=[...e.legend.map((c,$)=>q[$]),X],n=e.kinds.map(c=>{const $=i.map(C=>c.responses_by_model.find(I=>v(I)===C)?.responses??0),w=c.responses_by_model.reduce((C,I)=>C+I.responses,0);return[...$,w-$.reduce((C,I)=>C+I,0)]}),a=n.some(c=>c.at(-1)>0),k=[...e.legend.map(c=>this.label(c)),...a?["other"]:[]],d=this.narrow,m=d?8:15,u=d?7:9,l=Math.max(...e.kinds.map(c=>c.kind.length),4),p=t-2-2-m-u,g=d?Math.max(6,Math.min(12,l)):F(p,l,6),_=d?T:Math.max(6,p-g),j=2+g+2+_,D=d?"":`${O} \xB7 share of its responses`,L=[...d?[O]:[],M.fg("dim",K(`${x(D,j)}${h(d?"est.":"API-price est.",m)}${h("tokens",u)}`,t)),...this.legendLines(G(k,r),t-2).map(c=>`  ${c}`)];if(e.kinds.length===0)return[...L,"None in this window."];const A=W(e.kinds.length,Math.max(0,o),Math.max(1,s-L.length));for(let c=A.start;c<A.end;c+=1){const $=e.kinds[c],w=`${x($.kind,g)}  ${J(n[c],_,r)}${h(E($.api_price_estimate),m)}${h(f($.tokens),u)}`;L.push(B(w,c===o))}return A.more>0&&L.push(U(A.more,"kinds")),L}legendLines(e,t){return z(e)<=t?[e]:P(e,t)}detail(e,t,s){const o=s?t:Math.floor((t-3)/2),i=s?t:t-3-o,r=8,n=R((l,p)=>s?T:Math.max(4,l-2-p-r),"cells"),a=[["cache read",e.tokens_by_type.cache_read],["cache write",e.tokens_by_type.cache_write],["input, not cached",e.tokens_by_type.input],["output",e.tokens_by_type.output]],k=Math.max(0,...a.map(([,l])=>l)),d=[M.bold(`${x(`${this.label(e)} \xB7 tokens by type`,o-r)}${h(f(e.tokens),r)}`),...a.map(([l,p])=>`  ${x(l,18)}${N(p,k,n(o,18))}${h(f(p),r)}`),"",`  Cache reads were ${ee(e.cache_read_share)} of input tokens`],m=Math.max(0,...e.context.buckets),u=[M.bold(`${x("Context size per response",i-10)}${h("responses",10)}`),...e.context.buckets.map((l,p)=>`  ${x(re[p],10)}${N(l,m,n(i,10))}${h(Z(l),r)}`),"",`  median ${f(e.context.median)} \xB7 p90 ${f(e.context.p90)} \xB7 max ${f(e.context.max)}`];return s?[...d,"",...u]:H(d,o,u,i)}handleKey(e){const t=this.usage,s=this.layers.at(-1);if(s?.kind==="drill")return s.list.handleKey(e)==="close"&&this.layers.pop(),"handled";if(y(e,"escape"))return s===void 0?"back":(this.layers.pop(),"handled");if(t===void 0)return"unhandled";const o=y(e,"down")||y(e,"j"),i=y(e,"up")||y(e,"k"),r=y(e,"enter");if(s?.kind==="kinds"){if(o)s.cursor=Math.min(t.kinds.length-1,s.cursor+1);else if(i)s.cursor=Math.max(0,s.cursor-1);else if(r)this.openKind(t,s.cursor);else return"unhandled";return"handled"}if(s?.kind==="detail")return this.narrow||!(o||i)?"unhandled":(this.cursor=o?Math.min(t.models.length-1,this.cursor+1):Math.max(0,this.cursor-1),s.model=this.cursor,"handled");if(o)this.cursor=Math.min(this.count()-1,this.cursor+1);else if(i)this.cursor=Math.max(0,this.cursor-1);else if(r){const n=t.models.length;this.cursor<n?this.layers.push({kind:"detail",model:this.cursor}):this.narrow?this.layers.push({kind:"kinds",cursor:0}):this.openKind(t,this.cursor-n)}else return"unhandled";return"handled"}openKind(e,t){const s=e.kinds[t];if(s===void 0)return;const o=this.ctx.data,i=o.agents.filter(n=>n.kind===s.kind&&n.active).sort((n,a)=>a.api_price_estimate-n.api_price_estimate||a.tokens-n.tokens||n.name.localeCompare(a.name)),r=new Q(`${s.kind} \xB7 agents by API-price estimate`,[{header:"agent",kind:"text"},{header:"graph",kind:"text"},{header:"API-price est.",kind:"number"},{header:"tokens",kind:"number"}],i.map(n=>({node_id:n.node_id,graph_id:n.graph_id,cells:[n.name,Y(o,n.graph_id),E(n.api_price_estimate),f(n.tokens)]})),this.ctx.nav);this.layers.push({kind:"drill",list:r})}keyLine(e){const t=this.layers.at(-1);return t?.kind==="drill"?t.list.keyLine(e):t?.kind==="detail"?e?"":"\u2191\u2193 model":t?.kind==="kinds"?e?"\u2191\u2193 Enter":"\u2191\u2193 kind \xB7 Enter: its agents":this.count()===0?"":e?"\u2191\u2193 Enter":"\u2191\u2193 row \xB7 Enter: model \u2192 token and context detail, kind \u2192 its agents"}escapeLabel(){const e=this.layers.at(-1);if(e?.kind==="drill")return"back to kinds";if(e?.kind==="detail")return this.narrow?"back to models":"back to models by kind";if(e?.kind==="kinds")return"back to models"}land(){this.layers=[],this.cursor=0}}const pe=R(b=>new ie(b),"createUsageView");export{pe as createUsageView};

package/dist/commands/canvas-analytics/view.d.ts

@@ -0,0 +1,85 @@
+import type { AnalyticsDTO } from '../../api/dto/analytics.js';
+export type TabId = 'overview' | 'graphs' | 'time' | 'memory' | 'usage';
+export declare const TABS: ReadonlyArray<{
+    id: TabId;
+    label: string;
+}>;
+/** Where `Enter` on an Overview headline (or its "<n> more graphs" row) lands. */
+export type TabLanding = {
+    tab: 'overview';
+} | {
+    tab: 'graphs';
+    at: 'size-chart' | 'kind-chart' | 'list-by-estimate';
+} | {
+    tab: 'time';
+    at: 'all-agents';
+} | {
+    tab: 'memory';
+    at: 'top-read-document';
+} | {
+    tab: 'usage';
+    at: 'top-model';
+};
+export interface AnalyticsNav {
+    openTab(landing: TabLanding): void;
+    openGraphDetail(graphId: string, selectAgentId?: string): void;
+    openInspector(nodeId: string): void;
+    openConversation(nodeId: string): void;
+    readFinalReport(ref: string): Promise<string>;
+    requestRender(): void;
+}
+export interface AnalyticsViewContext {
+    /** The model this view was built for; the same object `render` receives. */
+    data: AnalyticsDTO;
+    nav: AnalyticsNav;
+}
+export interface AnalyticsTabView {
+    /** Exactly `height` rows (the shell pads or cuts), each at most `width`
+     *  columns. `isNarrow(width)` picks the 50–95 column layout. */
+    render(width: number, height: number, data: AnalyticsDTO): string[];
+    /** `key` is raw terminal input; match it with pi-tui's `matchesKey`. The
+     *  shell takes Tab, Shift+Tab, q, w, R, p, s, and Ctrl+C before the view.
+     *  Return 'back' on Esc when the view has nothing of its own to close; the
+     *  shell then closes this detail view, or the page at a tab's top level.
+     *  An 'unhandled' Esc is treated the same as 'back'. */
+    handleKey(key: string): 'handled' | 'back' | 'unhandled';
+    /** The view's own keys for the bottom row ("↑↓ agent · r final report · …").
+     *  Narrow: key characters only. The shell appends Esc and the page keys. */
+    keyLine(narrow: boolean): string;
+    /** What Esc does inside the view right now ("clear filter", "close report"),
+     *  or undefined when Esc would return 'back' — the shell then labels it. */
+    escapeLabel?(): string | undefined;
+    /** Move the cursor to an Overview landing target on this tab. */
+    land?(landing: TabLanding): void;
+}
+export type AnalyticsViewFactory = (ctx: AnalyticsViewContext) => AnalyticsTabView;
+export type GraphDetailViewFactory = (ctx: AnalyticsViewContext, graphId: string, selectAgentId?: string) => AnalyticsTabView;
+/** Content width at or above which the wide (v3) layout applies. */
+export declare const WIDE_MIN_WIDTH = 96;
+export declare const isNarrow: (width: number) => boolean;
+/** Bar cells in the narrow layout. */
+export declare const NARROW_BAR_CELLS = 6;
+/** Widest the page draws; a wider window centers it. */
+export declare const MAX_PAGE_WIDTH = 160;
+/** Tallest a column chart grows in a tall window. */
+export declare const MAX_COLUMN_CHART_ROWS = 16;
+/** A text column's width in the wide layout: its natural width, at least
+ *  `min` and at most half of `free` (the columns left once number columns are
+ *  placed). The chart element beside it gets `free − textWidth`. */
+export declare function textWidth(free: number, natural: number, min: number): number;
+/** Row prefix: "> " on the cursor row, two spaces elsewhere. */
+export declare function cursorPrefix(selected: boolean): string;
+/** A row on the cursor, marked by the "> " prefix and, where color exists, bold. */
+export declare function markRow(text: string, selected: boolean): string;
+/** Which rows of a `count`-long list fit in `capacity` rows with the cursor
+ *  visible. When the list does not fit, the last visible row is spent on a
+ *  "<n> more <things> ↓" line (`more` is the count below the window). */
+export declare function listWindow(count: number, cursor: number, capacity: number): {
+    start: number;
+    end: number;
+    more: number;
+};
+/** The "<n> more <things> ↓" row. */
+export declare function moreRow(more: number, things: string): string;
+/** A view that only names its tab — what each tab shows until its task builds it. */
+export declare function placeholderView(title: string): AnalyticsTabView;

package/dist/commands/canvas-analytics/view.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var e=(r,t)=>a(r,"name",{value:t,configurable:!0});import{theme as m}from"../../core/tui/panel.js";import{formatCount as s}from"./format.js";const u=[{id:"overview",label:"Overview"},{id:"graphs",label:"Graphs"},{id:"time",label:"Time"},{id:"memory",label:"Memory"},{id:"usage",label:"Usage"}],l=96,f=e(r=>r<l,"isNarrow"),h=6,M=160,_=16;function w(r,t,o){return Math.max(o,Math.min(t,Math.floor(r/2)))}e(w,"textWidth");function b(r){return r?"> ":"  "}e(b,"cursorPrefix");function c(r,t){return t?m.bold(`> ${r}`):`  ${r}`}e(c,"markRow");function A(r,t,o){if(r<=o)return{start:0,end:r,more:0};const n=Math.max(1,o-1),i=Math.max(0,t-n+1);return i+n>=r?{start:Math.max(0,r-o),end:r,more:0}:{start:i,end:i+n,more:r-i-n}}e(A,"listWindow");function R(r,t){return`  ${s(r)} more ${t} \u2193`}e(R,"moreRow");function W(r){return{render:e(()=>[`${r}: not built yet.`],"render"),handleKey:e(()=>"unhandled","handleKey"),keyLine:e(()=>"","keyLine")}}e(W,"placeholderView");export{_ as MAX_COLUMN_CHART_ROWS,M as MAX_PAGE_WIDTH,h as NARROW_BAR_CELLS,u as TABS,l as WIDE_MIN_WIDTH,b as cursorPrefix,f as isNarrow,A as listWindow,c as markRow,R as moreRow,W as placeholderView,w as textWidth};

package/dist/commands/canvas-analytics.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const analyticsLeaf: LeafDef;

package/dist/commands/canvas-analytics.js

@@ -0,0 +1 @@
+var n=Object.defineProperty;var a=(e,t)=>n(e,"name",{value:t,configurable:!0});import{defineLeaf as s}from"../core/command.js";const o=s({name:"analytics",description:"open the interactive Analytics page",whenToUse:"the user wants to see how agents worked in the last 24 hours or 7 days \u2014 graph sizes and spawned kinds, created \u2192 final report times, memory documents read, and where the API-price estimate and tokens went. It is a person-facing page for the tmux popup (prefix menu, shift+a); it has no non-interactive output for agents",help:{name:"canvas analytics",summary:"open the read-only Analytics page \u2014 Overview, Graphs, Time, Memory, and Usage tabs over the last 24h or 7d",params:[{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane id that `o` opens a conversation beside (the prefix menu passes the pane it was opened from). Default: $TMUX_PANE."}],output:[],outputKind:"object",effects:["Opens a pi-tui page; crtrd computes every number (`GET /v1/canvas/analytics`). The page opens no database or transcript file.","Read-only. The one exception is `o` in graph detail, which closes the page and opens that agent\u2019s conversation and may wake it.","Does not start crtrd: with the daemon unreachable the page shows the error and `R` retries.","Requires an interactive terminal. Without one it prints one line to stderr and exits 1."]},run:a(async e=>{await(await import("./canvas-analytics/shell.js")).runAnalytics(e.pane)},"run"),render:a(()=>"","render")});export{o as analyticsLeaf};

package/dist/commands/canvas-browse.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const browseLeaf: LeafDef;

package/dist/commands/canvas-browse.js

@@ -0,0 +1 @@
+var d=Object.defineProperty;var t=(e,n)=>d(e,"name",{value:n,configurable:!0});import{envProfileId as c}from"../shared/env.js";import{defineLeaf as l}from"../core/command.js";import{runBrowse as p}from"../core/canvas/browse/app.js";import{ApiCanvasSource as u,cliClient as o}from"./api-client.js";import{getDefaultProfileId as f}from"../core/profiles/default-binding.js";const b=l({name:"browse",description:"open the interactive canvas navigator (tabs/tree/search)",whenToUse:"you want to VIEW and NAVIGATE the whole canvas interactively \u2014 a full-screen TUI with tabs (All/Live/Dormant/Attention/Pinned), an expandable tree (children auto-collapsed; \u2192 to expand), `/` fuzzy search, `f` to pin, `y` to copy a node id, `m` to message and `R` to rename a node in place, and `?` for the full keymap; it opens on Live (active/idle) and Enter resumes the chosen node. Use this to find your way around a large canvas. Use `canvas dashboard` instead for a one-shot ASCII tree you can pipe, and `node inspect list` for a flat machine-readable roster",help:{name:"canvas browse",summary:"interactive full-screen canvas navigator \u2014 tabs, an auto-collapsed tree, and `/` fuzzy search; Enter resumes the chosen node via `crtr surface node focus`. Outside a TTY it prints the static forest and exits",params:[{kind:"flag",name:"return-pane",type:"string",required:!1,constraint:"tmux pane id the chosen node REPLACES on Enter \u2014 that pane is respawned onto its viewer (set by the /resume popup, so resuming swaps the pane you invoked it from). Default: focus into this pane without replacing it."},{kind:"flag",name:"cwd",type:"string",required:!1,constraint:"directory used when you toggle the optional cwd filter (c). The navigator opens with All dirs; /resume passes the launching node's cwd. Default: the invocation cwd."},{kind:"flag",name:"profile-id",type:"string",required:!1,constraint:"Exact profile id for the initial profile filter (on by default; P toggles All profiles). Default: the launching node's profile via CRTR_PROFILE_ID, then this cwd's pinned default profile; absent means All profiles."}],output:[],outputKind:"object",effects:["Takes over the terminal in raw mode (alt-screen) until you quit (q/Esc) or pick a node.","On Enter: resumes the selected node via `crtr surface node focus` (reviveNode \u2014 the only sanctioned open).","Read-only on the canvas db; mutates nothing but the chosen node's placement on resume."]},run:t(async e=>{const n=e.cwd??process.cwd(),s=e.profileId??c()??f(n)??void 0,r=new u;await p({returnPane:e.returnPane,cwd:n,profileId:s,source:r,viewedNodeIds:t(async()=>new Set((await o().listFocuses()).map(a=>a.node_id)),"viewedNodeIds"),closeNode:t(a=>o().closeNode(a,process.ppid>0?{finish:!0,caller_pid:process.ppid}:{finish:!0}).then(i=>({closed:i.closed})),"closeNode")})},"run")});export{b as browseLeaf};

package/dist/commands/canvas-config.d.ts

@@ -0,0 +1,2 @@
+import type { BranchDef } from '../core/command.js';
+export declare const canvasConfigBranch: BranchDef;

package/dist/commands/canvas-config.js

@@ -0,0 +1,2 @@
+var v=Object.defineProperty;var a=(n,e)=>v(n,"name",{value:e,configurable:!0});import{defineBranch as h,defineLeaf as i}from"../core/command.js";import{InputError as c,readStdinRaw as k}from"../core/io.js";import{readConfig as d,updateConfig as m}from"../core/config.js";import{readSecrets as p,setRelayToken as w,deleteRelayToken as y,fingerprint as T}from"../core/secrets.js";const o="user";function f(n,e,r){const t=r.relayTokens[e.relayTokenRef];return{name:n,previewEndpoint:e.previewEndpoint,relayTokenRef:e.relayTokenRef,...e.cpOrigin?{cpOrigin:e.cpOrigin}:{},tokenStored:t!==void 0&&t!=="",...t!==void 0&&t!==""?{fingerprint:T(t)}:{}}}a(f,"maskedTarget");const R=i({name:"add",description:"register a remote canvas target (preview endpoint + relay token)",whenToUse:"wiring up a remote canvas so `node inspect` or `surface attach --canvas` can reach it \u2014 stores the preview endpoint in config.json and the raw relay token in the 0600 secrets store (never together, never persisted to config.json or logged). Re-running with the same name overwrites both.",help:{name:"canvas config add",summary:"register (or overwrite) a named remote canvas target",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name \u2014 the id every other `canvas config`/`canvas use`/`--canvas` reference uses."},{kind:"flag",name:"preview",type:"string",required:!0,constraint:"The Blaxel preview endpoint base URL (e.g. https://<hash>.preview.bl.run)."},{kind:"flag",name:"relay-token",type:"string",required:!0,constraint:"Must be exactly `-` \u2014 the raw token is read from stdin, never argv (keeps it out of shell history). Any other value is rejected."},{kind:"flag",name:"cp",type:"string",required:!1,constraint:"Optional control-plane origin, when this target has one distinct from the preview endpoint."}],output:[],outputKind:"object",effects:["Writes remoteCanvas.targets.<name> to config.json (previewEndpoint, relayTokenRef, cpOrigin).","Writes the raw token to the 0600 secrets store under relayTokenRef \u2014 never to config.json or stdout."]},run:a(async n=>{const e=n.name,r=n.preview,t=n.relayToken,s=n.cp;if(t!=="-")throw new c({error:"invalid_relay_token_arg",message:"relay token must be piped on stdin \u2014 pass `--relay-token -`",field:"relay-token",next:'Re-run with `--relay-token -` and pipe the raw token on stdin (e.g. `echo "$TOKEN" | crtr canvas config add <name> --preview <url> --relay-token -`).'});const g=(await k()).trim();if(g==="")throw new c({error:"empty_token",message:"relay token is empty",field:"relay-token",next:"Pass a non-empty token, or `--relay-token -` and pipe it on stdin."});const u={previewEndpoint:r,relayTokenRef:e,...s?{cpOrigin:s}:{}};return m(o,l=>{l.remoteCanvas.targets[e]=u}),w(e,g,o),{}},"run"),render:a(()=>"Registered remote canvas target (token stored).","render")}),b=i({name:"list",description:"list registered remote canvas targets",whenToUse:"checking which remote canvas targets exist before `canvas use`/`--canvas <name>` \u2014 never prints a raw token, only a non-reversible fingerprint.",help:{name:"canvas config list",summary:"list every registered remote canvas target (masked \u2014 no raw tokens)",output:[{name:"targets",type:"object[]",required:!0,constraint:"Each: {name, previewEndpoint, relayTokenRef, cpOrigin?, tokenStored, fingerprint?}. fingerprint is a non-reversible sha256 prefix, present only when a token is stored."}],outputKind:"object",effects:["Read-only: reads config.json and the secrets-store token presence/fingerprint (never the raw token)."]},run:a(async()=>{const n=d(o),e=p(o);return{targets:Object.entries(n.remoteCanvas.targets).map(([t,s])=>f(t,s,e))}},"run"),render:a(n=>{const e=n.targets;return e.length===0?"No remote canvas targets configured.":e.map(r=>`${r.name} \u2014 ${r.previewEndpoint} (${r.tokenStored?`token ${r.fingerprint}`:"no token stored"})`).join(`
+`)},"render")}),j=i({name:"show",description:"show one registered remote canvas target",whenToUse:"inspecting a single remote canvas target\u2019s config \u2014 masked the same way as `list`.",help:{name:"canvas config show",summary:"show one remote canvas target (masked \u2014 no raw token)",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name."}],output:[{name:"name",type:"string",required:!0,constraint:"The target name."},{name:"previewEndpoint",type:"string",required:!0,constraint:"The stored preview endpoint."},{name:"relayTokenRef",type:"string",required:!0,constraint:"The secrets-store key holding the token."},{name:"cpOrigin",type:"string",required:!1,constraint:"The stored control-plane origin, when this target has one distinct from the preview endpoint."},{name:"tokenStored",type:"boolean",required:!0,constraint:"Whether a token is currently stored under relayTokenRef."}],outputKind:"object",effects:["Read-only."]},run:a(async n=>{const e=n.name,t=d(o).remoteCanvas.targets[e];if(t===void 0)throw new c({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`."});return f(e,t,p(o))},"run"),render:a(n=>`${n.name} \u2014 ${n.previewEndpoint} (${n.tokenStored?`token ${n.fingerprint}`:"no token stored"})`,"render")}),C=i({name:"remove",description:"remove a registered remote canvas target and its stored token",whenToUse:"decommissioning a remote canvas target \u2014 drops it from config.json and deletes its raw token from the secrets store.",help:{name:"canvas config remove",summary:"remove a remote canvas target and its stored token",params:[{kind:"positional",name:"name",required:!0,constraint:"Target name."}],output:[],outputKind:"object",effects:["Deletes remoteCanvas.targets.<name> from config.json.","Deletes the stored token under relayTokenRef from the secrets store."]},run:a(async n=>{const e=n.name,t=d(o).remoteCanvas.targets[e];if(t===void 0)throw new c({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`."});return m(o,s=>{delete s.remoteCanvas.targets[e]}),y(t.relayTokenRef,o),{}},"run"),render:a(()=>"Removed remote canvas target.","render")}),x=h({name:"config",description:"register/list/inspect/remove remote canvas targets",whenToUse:"setting up or auditing a remote canvas target (preview endpoint + relay token) before selecting one with `crtr canvas use`.",help:{name:"canvas config",summary:"manage named remote canvas targets",model:"A remote canvas target is a preview endpoint + a relay token registered under a name. `add` registers one (token goes to the 0600 secrets store, never config.json); `list`/`show` display masked entries (fingerprint only, never the raw token); `remove` deletes both the config entry and the stored token. Select a target for read commands with `crtr canvas use <name>`, or back to local with `crtr canvas use --local`."},children:[R,b,j,C]});export{x as canvasConfigBranch};

package/dist/commands/canvas-history/grep.d.ts

@@ -0,0 +1 @@
+export declare const grepLeaf: import("../../core/command.js").LeafDef;

package/dist/commands/canvas-history/grep.js

@@ -0,0 +1,7 @@
+var u=Object.defineProperty;var o=(e,t)=>u(e,"name",{value:t,configurable:!0});import{defineLeaf as m}from"../../core/command.js";import{usage as c}from"../../core/errors.js";import{cliClient as f,rethrowAsCliError as g}from"../api-client.js";import{applyFilters as y,filterParams as w,parseFilters as x}from"./shared.js";const j=m({name:"grep",description:"exact regex line search across the cwd's node history",whenToUse:"you know the exact string or pattern you're looking for \u2014 an error message, a literal identifier, a code fragment \u2014 and want every matching body LINE across every node that ran in this cwd, not a relevance ranking. The pattern is required (an ECMAScript regex, case-insensitive). Narrow with --type/--kind/--status/--since, scope elsewhere with --cwd/--all-cwds/--under/--node. Want ranked/browse search instead? Use `canvas history search` \u2014 a distinct leaf, not a flag here. Use `canvas history read <ref>` to read a hit's full body. Reports and documents are `crtr canvas search --grep`, not this.",help:{name:"canvas history grep",summary:"required-pattern regex line search over past inboxes (default) and conversation transcripts in a cwd",params:[{kind:"positional",name:"pattern",required:!0,constraint:"An ECMAScript regex, matched case-insensitively against each body line. One hit per matching line."},...w,{kind:"flag",name:"limit",type:"int",required:!1,default:20,constraint:"Page size. Default 20, hard max 100."},{kind:"flag",name:"cursor",type:"string",required:!1,constraint:"Opaque token from a prior next_cursor; omit on the first call."}],output:[{name:"hits",type:"object[]",required:!0,constraint:"{ref, node, ts, line, text} per matching body line, sorted by ref then line. ref is the <node-id>:<relpath> handle passed verbatim to `canvas history read`."},{name:"next_cursor",type:"string|null",required:!0,constraint:"Token for the next page; null is the only end-of-list signal."},{name:"total",type:"int",required:!0,constraint:"Total matching lines (exact)."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next commands."}],outputKind:"object",effects:["None. Read-only."]},run:o(async e=>{const t=(e.pattern??"").trim(),s=Math.min(100,Math.max(1,e.limit??20)),i=e.cursor;if(t==="")throw c("pattern is required \u2014 the regex to match against body lines.");try{const r=new RegExp(t)}catch{throw c(`invalid regex pattern: ${t}`)}const n=x(e),a={pattern:t,limit:s};y(a,n),i!==void 0&&(a.cursor=i);try{const r=await f().historyGrep(a);return{hits:r.hits,next_cursor:r.next_cursor,total:r.total,follow_up:"Read a hit with `crtr canvas history read <ref>`; narrow with `crtr canvas history grep -h`."}}catch(r){g(r)}},"run"),render:o(e=>v(e),"render")});function v(e){const t=e.hits,s=e.total,i=e.next_cursor,n=[];if(t.length===0)n.push("0 hits.");else{n.push(`${t.length} of ${s} hits:`);const a=Object.keys(t[0]),r=`| ${a.join(" | ")} |`,l=`| ${a.map(()=>"---").join(" | ")} |`,h=t.map(d=>`| ${a.map(p=>String(d[p]??"").replace(/\|/g,"\\|").replace(/\n/g," ")).join(" | ")} |`).join(`
+`);n.push(`${r}
+${l}
+${h}`)}return n.push(`- next_cursor: ${i??"null"}
+- total: ${s}`),n.push(String(e.follow_up)),n.join(`
+
+`)}o(v,"renderGrep");export{j as grepLeaf};

package/dist/commands/canvas-history/read.d.ts

@@ -0,0 +1 @@
+export declare const readLeaf: import("../../core/command.js").LeafDef;

package/dist/commands/canvas-history/read.js

@@ -0,0 +1,3 @@
+var s=Object.defineProperty;var t=(e,r)=>s(e,"name",{value:r,configurable:!0});import{defineLeaf as a}from"../../core/command.js";import{usage as i}from"../../core/errors.js";import{cliClient as d,rethrowAsCliError as c}from"../api-client.js";const y=a({name:"read",description:"read one inbox entry or conversation message in full by its ref",whenToUse:"you picked a hit from `canvas history search` or `grep` and want its full content \u2014 pass the ref verbatim. Reports and documents are `crtr canvas read <name>`, not this.",help:{name:"canvas history read",summary:"resolve an inbox or conversation ref to its full body",params:[{kind:"positional",name:"ref",required:!0,constraint:"A ref from `canvas history search`: <node-id>:inbox/<n> for one inbox entry, <node-id>:session for a node's whole conversation, <node-id>:session/<n> for one message in it."},{kind:"flag",name:"format",type:"enum",choices:["rendered","raw"],required:!1,default:"rendered",constraint:"raw returns the verbatim bytes behind a conversation ref \u2014 the session .jsonl for <node-id>:session, the single persisted jsonl entry for one message. Use it when the rendered view may be hiding what you are chasing."}],output:[{name:"ref",type:"string",required:!0,constraint:"Echo of the resolved ref."},{name:"node",type:"string",required:!0,constraint:"Node name + id."},{name:"source",type:"string",required:!0,constraint:"inbox | transcript."},{name:"ts",type:"string",required:!0,constraint:"Entry or message timestamp."},{name:"content",type:"string",required:!0,constraint:"Full body."}],outputKind:"object",effects:["None. Read-only."]},run:t(async e=>{const r=e.ref.trim(),o=e.format??"rendered";if(!r.includes(":"))throw i(`ref must be <node-id>:inbox/<n>, <node-id>:session, or <node-id>:session/<n>; received: ${r}`,{received:r,next:"Get a valid ref from `crtr canvas history search`. Reports and documents are `crtr canvas read <name>`."});try{const n=await d().historyRead({ref:r,format:o});return{ref:n.ref,node:n.node,source:n.source,ts:n.ts,content:n.content}}catch(n){c(n)}},"run"),render:t(e=>`${`${e.node}  |  source: ${e.source}  |  ts: ${e.ts}  |  ref: ${e.ref}`}
+
+${String(e.content).trim()}`,"render")});export{y as readLeaf};

package/dist/commands/canvas-history/search.d.ts

@@ -0,0 +1 @@
+export declare const searchLeaf: import("../../core/command.js").LeafDef;

package/dist/commands/canvas-history/search.js

@@ -0,0 +1,10 @@
+var f=Object.defineProperty;var c=(e,t)=>f(e,"name",{value:t,configurable:!0});import{defineLeaf as p}from"../../core/command.js";import{cliClient as y,rethrowAsCliError as m}from"../api-client.js";import{applyFilters as g,filterParams as w,parseFilters as b}from"./shared.js";const k=["relevance","recency","oldest"],j=p({name:"search",description:"ranked search over past inboxes and conversations in a cwd",whenToUse:"you want to find what was SAID to or by nodes that ran in this cwd \u2014 a message a node received, a turn in its conversation \u2014 ranked by relevance. Omit the query to browse by recency. Narrow with --type/--kind/--status/--since, scope elsewhere with --cwd/--all-cwds/--under/--node. Need an exact regex over bodies instead? Use `canvas history grep`. Reports and documents are `crtr canvas search`, not this.",help:{name:"canvas history search",summary:"ranked/filtered/sorted search over past inboxes (default) and conversation transcripts in a cwd",params:[{kind:"positional",name:"query",required:!1,constraint:"Whitespace-separated terms, matched case-insensitively and weighted across node name/description and each entry's or message's lead line (and full bodies with --body); artifacts matching more/stronger fields rank higher. Omit to browse by recency (no relevance ranking; --sort still applies)."},...w,{kind:"flag",name:"body",type:"bool",required:!1,constraint:"Also weigh full body text in the ranking (default weighs node name/description and the lead line only)."},{kind:"flag",name:"sort",type:"enum",choices:k,required:!1,constraint:"relevance (default with a query) ranks by score; recency (default without a query) / oldest order by artifact timestamp."},{kind:"flag",name:"snippet-lines",type:"int",required:!1,default:1,constraint:"Context lines per hit. Default 1."},{kind:"flag",name:"full",type:"bool",required:!1,constraint:"Inline each hit's full body. Off by default; pair with a small --limit."},{kind:"flag",name:"limit",type:"int",required:!1,default:20,constraint:"Page size. Default 20, hard max 100."},{kind:"flag",name:"cursor",type:"string",required:!1,constraint:"Opaque token from a prior next_cursor; omit on the first call."}],output:[{name:"hits",type:"object[]",required:!0,constraint:"Ranked/sorted hits, each: {ref, node, kind, source, ts, score?, snippet}. ref is the <node-id>:inbox/<n> or <node-id>:session/<n> handle passed verbatim to `canvas history read`."},{name:"next_cursor",type:"string|null",required:!0,constraint:"Token for the next page; null is the only end-of-list signal."},{name:"total",type:"int",required:!0,constraint:"Total matching entries and messages (exact)."},{name:"follow_up",type:"string",required:!0,constraint:"Concrete next commands."}],outputKind:"object",effects:["None. Read-only."]},run:c(async e=>{const t=(e.query??"").trim(),o=e.body===!0,l=e.full===!0,d=Math.max(1,e.snippetLines??1),r=Math.min(100,Math.max(1,e.limit??20)),n=e.cursor,i=b(e),h=t.toLowerCase().split(/\s+/).filter(a=>a.length>0),u=e.sort??(h.length>0?"relevance":"recency"),s={snippet_lines:d,limit:r,sort:u};t!==""&&(s.query=t),g(s,i),o&&(s.weigh_body=!0),l&&(s.full=!0),n!==void 0&&(s.cursor=n);try{const a=await y().historySearch(s);return{hits:a.hits,next_cursor:a.next_cursor,total:a.total,follow_up:"Read a hit with `crtr canvas history read <ref>`; narrow with `crtr canvas history search -h`."}}catch(a){m(a)}},"run"),render:c(e=>x(e),"render")});function x(e){const t=e.hits,o=e.total,l=e.next_cursor,d=t.length>0&&Object.prototype.hasOwnProperty.call(t[0],"body"),r=[];if(t.length===0)r.push("0 hits.");else if(d){r.push(`${t.length} of ${o} hits:`);for(const n of t){const i=`### ${n.ref}
+- node: ${n.node}  |  kind: ${n.kind}  |  source: ${n.source}  |  ts: ${n.ts}`;r.push(`${i}
+
+${String(n.body??"").trim()}`)}}else{r.push(`${t.length} of ${o} hits:`);const n=Object.keys(t[0]).filter(s=>s!=="body"),i=`| ${n.join(" | ")} |`,h=`| ${n.map(()=>"---").join(" | ")} |`,u=t.map(s=>`| ${n.map(a=>String(s[a]??"").replace(/\|/g,"\\|").replace(/\n/g," ")).join(" | ")} |`).join(`
+`);r.push(`${i}
+${h}
+${u}`)}return r.push(`- next_cursor: ${l??"null"}
+- total: ${o}`),r.push(String(e.follow_up)),r.join(`
+
+`)}c(x,"renderSearch");export{j as searchLeaf};

package/dist/commands/canvas-history/shared.d.ts

@@ -0,0 +1,34 @@
+import type { InputParam } from '../../core/help.js';
+export declare const TYPES: string[];
+export declare const ORIGINS: string[];
+export declare const ROLES: string[];
+export declare const NODE_KINDS: string[];
+export declare const STATUSES: string[];
+/** ISO 8601 (`2026-06-01`) \u2192 epoch ms (absolute); relative (`7d`, `2w`, `1mo`)
+ *  \u2192 now minus the duration. Throws usage on an unparseable value. */
+export declare function parseWhen(field: string, raw: string): number;
+export declare function splitCsv(v: string | undefined): string[] | undefined;
+/** The scope/filter param schema shared by search and grep help \u2014 everything
+ *  except the query/pattern positional and each leaf's own result-shaping
+ *  flags (search: --body/--sort/--snippet-lines/--full; grep: none). */
+export declare const filterParams: InputParam[];
+export interface ParsedFilters {
+    cwd: string | undefined;
+    allCwds: boolean;
+    under: string | undefined;
+    nodes: string[] | undefined;
+    types: string[] | undefined;
+    kinds: string[] | undefined;
+    statuses: string[] | undefined;
+    sinceMs: number | undefined;
+    untilMs: number | undefined;
+    origins: string[] | undefined;
+    roles: string[] | undefined;
+    from: string | undefined;
+}
+/** Parse + validate the shared scope/filter flags from a leaf's raw input.
+ *  Pure and client-side; the corpus scan itself runs server-side in crtrd. */
+export declare function parseFilters(input: Record<string, unknown>): ParsedFilters;
+/** Copy every parsed filter onto a wire query. search, grep, and stats share
+ *  the whole filter vocabulary, so the mapping lives once. */
+export declare function applyFilters(q: Record<string, unknown>, f: ParsedFilters): void;

package/dist/commands/canvas-history/shared.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var d=(e,n)=>g(e,"name",{value:n,configurable:!0});import{usage as t}from"../../core/errors.js";const u=["transcript","inbox"],f=["human","inbox","wake","revive","restart-continuation","stop-guard","park","recovery","context-nudge","kickoff","unknown"],m=["user","assistant","toolResult"],w=["advisor","developer","spec","design","review","explore","plan","general"],y=["active","idle","done","dead","canceled"],v={s:1e3,m:6e4,h:36e5,d:864e5,w:6048e5,mo:2592e6,y:31536e6};function p(e,n){const r=n.match(/^(\d+)(mo|[smhdwy])$/);if(r!==null)return Date.now()-Number(r[1])*v[r[2]];const s=Date.parse(n);if(!Number.isNaN(s))return s;throw t(`--${e} must be ISO 8601 (2026-06-01) or relative (7d, 2w, 1mo); received: ${n}`)}d(p,"parseWhen");function a(e){if(!(e===void 0||e===""))return e.split(",").map(n=>n.trim()).filter(n=>n!=="")}d(a,"splitCsv");const k=[{kind:"flag",name:"cwd",type:"path",required:!1,constraint:"Search another project's record. Default: the calling node's cwd (process cwd when not a node). Mutually exclusive with --all-cwds."},{kind:"flag",name:"all-cwds",type:"bool",required:!1,constraint:"Search every cwd on the canvas. Mutually exclusive with --cwd."},{kind:"flag",name:"under",type:"string",required:!1,constraint:"Restrict to a node and its subscription descendants (one initiative / sub-DAG)."},{kind:"flag",name:"node",type:"string",required:!1,constraint:"Restrict to specific node ids. Comma-separated for several."},{kind:"flag",name:"type",type:"string",required:!1,constraint:`Corpus to search; comma-separated for both. One of: ${u.join(", ")}. inbox = every delivery a node received, with un-clipped message bodies; transcript = the conversation itself, message by message. Default: inbox.`},{kind:"flag",name:"kind",type:"string",required:!1,constraint:`Node kind; comma-separated for several. One of: ${w.join(", ")}.`},{kind:"flag",name:"status",type:"string",required:!1,constraint:`Node lifecycle status; comma-separated for several. One of: ${y.join(", ")} (e.g. done = completed work only).`},{kind:"flag",name:"since",type:"string",required:!1,constraint:"Lower bound on artifact timestamp. ISO 8601 (2026-06-01) or relative (7d, 2w, 1mo)."},{kind:"flag",name:"until",type:"string",required:!1,constraint:"Upper bound on artifact timestamp. ISO 8601 or relative."},{kind:"flag",name:"origin",type:"string",required:!1,constraint:`What drove a message to arrive; comma-separated for several. One of: ${f.join(", ")}. Applies to transcript + inbox artifacts, which are the only ones that arrive \u2014 passing it therefore excludes every generated turn on its own. \`unknown\` is a message carrying no stamp, and is its own bucket rather than a fallback.`},{kind:"flag",name:"role",type:"string",required:!1,constraint:`Transcript message role; comma-separated for several. One of: ${m.join(", ")}.`},{kind:"flag",name:"from",type:"string",required:!1,constraint:"Case-insensitive substring against sender attribution \u2014 the node that sent a delivery. Applies to transcript + inbox artifacts."}];function x(e){const n=e.cwd,r=e.allCwds===!0;if(n!==void 0&&r)throw t("--cwd and --all-cwds are mutually exclusive.");const s=a(e.type);if(s!==void 0){const i=s.find(o=>!u.includes(o));if(i!==void 0)throw t(`--type must be one of: ${u.join(", ")}; received: ${i}`)}const c=a(e.origin);if(c!==void 0){const i=c.find(o=>!f.includes(o));if(i!==void 0)throw t(`--origin must be one of: ${f.join(", ")}; received: ${i}`)}const l=a(e.role);if(l!==void 0){const i=l.find(o=>!m.includes(o));if(i!==void 0)throw t(`--role must be one of: ${m.join(", ")}; received: ${i}`)}if(s!==void 0&&s.includes("transcript")&&!(e.node!==void 0||e.under!==void 0||e.since!==void 0))throw t("--type transcript needs a narrowing flag: pass --node, --under, or --since.",{next:"Transcripts are the full conversation corpus \u2014 scanning every node in a cwd reads every session file. Narrow first."});return{cwd:n,allCwds:r,under:e.under,nodes:a(e.node),types:s,kinds:a(e.kind),statuses:a(e.status),sinceMs:e.since!==void 0?p("since",e.since):void 0,untilMs:e.until!==void 0?p("until",e.until):void 0,origins:c,roles:l,from:e.from}}d(x,"parseFilters");function _(e,n){n.cwd!==void 0&&(e.cwd=n.cwd),n.allCwds&&(e.all_cwds=!0),n.under!==void 0&&(e.under=n.under),n.nodes!==void 0&&(e.nodes=n.nodes),n.types!==void 0&&(e.types=n.types),n.kinds!==void 0&&(e.kinds=n.kinds),n.statuses!==void 0&&(e.statuses=n.statuses),n.sinceMs!==void 0&&(e.since_ms=n.sinceMs),n.untilMs!==void 0&&(e.until_ms=n.untilMs),n.origins!==void 0&&(e.origins=n.origins),n.roles!==void 0&&(e.roles=n.roles),n.from!==void 0&&(e.from=n.from)}d(_,"applyFilters");export{w as NODE_KINDS,f as ORIGINS,m as ROLES,y as STATUSES,u as TYPES,_ as applyFilters,k as filterParams,x as parseFilters,p as parseWhen,a as splitCsv};

package/dist/commands/canvas-history/stats.d.ts

@@ -0,0 +1 @@
+export declare const statsLeaf: import("../../core/command.js").LeafDef;

package/dist/commands/canvas-history/stats.js

@@ -0,0 +1,6 @@
+var h=Object.defineProperty;var s=(o,e)=>h(o,"name",{value:e,configurable:!0});import{defineLeaf as m}from"../../core/command.js";import{usage as g}from"../../core/errors.js";import{cliClient as l,rethrowAsCliError as f}from"../api-client.js";import{applyFilters as b,filterParams as v,parseFilters as w}from"./shared.js";const i=["origin","node","kind","day","type","role"],_=m({name:"stats",description:"grouped counts over the cwd's node history \u2014 the projection view",whenToUse:"you want the SHAPE of the record rather than individual hits \u2014 how much of it came from where, who produced it, or when it happened. Group by origin to census what drove agents to run (cron wakes, inbox deliveries, recovery re-drives, people), by node/kind to see who produced the work, by day for volume over time, by type for corpus composition. Takes every scope and filter `canvas history search` takes, so any query you can search you can also count. Want the matching artifacts themselves? Use `canvas history search` or `canvas history grep`.",help:{name:"canvas history stats",summary:"counts by one dimension over past inboxes and conversations \u2014 origin census, per-node volume, activity by day",params:[{kind:"flag",name:"group-by",type:"enum",choices:i,required:!1,default:"type",constraint:"The dimension to count by. origin = what drove an inbound message (transcript + inbox only); role = transcript message role; node / kind = who produced it; day = artifact date; type = corpus composition."},...v],output:[{name:"group_by",type:"string",required:!0,constraint:"The dimension counted."},{name:"groups",type:"object[]",required:!0,constraint:"{key, count}, descending by count then key."},{name:"total",type:"int",required:!0,constraint:"Artifacts that carried the grouped dimension. Lower than `scanned` when grouping by one not every artifact has (origin, role)."},{name:"scanned",type:"int",required:!0,constraint:"Artifacts matched by the filters before grouping."}],outputKind:"object",effects:["None. Read-only."]},run:s(async o=>{const e=o.groupBy??"type";if(!i.includes(e))throw g(`--group-by must be one of: ${i.join(", ")}; received: ${e}`);const r=w(o),n={group_by:e};b(n,r);try{const t=await l().historyStats(n);return{group_by:t.group_by,groups:t.groups,total:t.total,scanned:t.scanned}}catch(t){f(t)}},"run"),render:s(o=>{const e=o.groups,r=String(o.group_by),n=o.total,t=o.scanned;if(e.length===0)return`0 artifacts carried \`${r}\` (${t} scanned).`;const c=Math.max(...e.map(a=>a.key.length)),d=e[0].count,u=e.map(a=>{const y="\u2588".repeat(Math.max(1,Math.round(a.count/d*24)));return`  ${a.key.padEnd(c)}  ${String(a.count).padStart(6)}  ${y}`}).join(`
+`),p=n===t?`${n} artifacts`:`${n} of ${t} scanned carried \`${r}\``;return`by ${r}:
+
+${u}
+
+- ${p}`},"render")});export{_ as statsLeaf};

package/dist/commands/canvas-history.d.ts

@@ -0,0 +1,2 @@
+import type { BranchDef } from '../core/command.js';
+export declare const historyBranch: BranchDef;

package/dist/commands/canvas-history.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var r=(e,a)=>s(e,"name",{value:a,configurable:!0});import{envNodeCwd as n}from"../shared/env.js";import{defineBranch as o}from"../core/command.js";import{searchLeaf as t}from"./canvas-history/search.js";import{grepLeaf as i}from"./canvas-history/grep.js";import{readLeaf as c}from"./canvas-history/read.js";import{statsLeaf as d}from"./canvas-history/stats.js";function h(){return`<corpus cwd="${n()??process.cwd()}"/>`}r(h,"corpusBlock");const g=o({name:"history",description:"past conversations and inboxes \u2014 search, grep, count, and read what nodes were told and said",whenToUse:"you want what was SAID in a cwd's past runs \u2014 a message a node received, a turn of its conversation, what drove it to wake \u2014 without already knowing which node. Reports and documents are `crtr canvas search` / `crtr canvas read`, not this.",help:{name:"canvas history",summary:"past conversations and inboxes; reports and documents are `crtr canvas search`/`read`",model:"Two corpora, selected with `--type`: `inbox` (default) is every delivery a node received, with un-clipped message bodies; `transcript` is the conversation itself, message by message, each inbound turn carrying the origin that drove it (`--origin`, `--role`, `--from`, and `stats --group-by origin` for the census). Transcripts require a narrowing flag because there is no index. `search` ranks or browses; `grep` matches an exact ECMAScript regex per body line; `read` pulls one hit by its ref (`<node-id>:inbox/<n>`, `<node-id>:session`, `<node-id>:session/<n>`); `stats` counts the same filtered corpus by one dimension. Every leaf takes the same scope and filters. Reports and documents are graph objects: find them with `crtr canvas search`, read them with `crtr canvas read`.",dynamicState:h},children:[t,i,c,d]});export{g as historyBranch};

package/dist/commands/canvas-issue.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const issueNewLeaf: LeafDef;

package/dist/commands/canvas-issue.js

@@ -0,0 +1,14 @@
+var C=Object.defineProperty;var a=(t,e)=>C(t,"name",{value:e,configurable:!0});import{spawnSync as g}from"node:child_process";import{mkdirSync as S,writeFileSync as k}from"node:fs";import{join as w}from"node:path";import{defineLeaf as q}from"../core/command.js";import{InputError as y}from"../core/io.js";import{generateIssueTitle as v,titleSlug as b}from"../core/runtime/naming.js";import{displayMessage as c,paneCurrentPath as x}from"../core/runtime/tmux-chrome.js";const l={idea:{color:"a2eeef",description:"Captured idea / enhancement"},bug:{color:"d73a4a",description:"Captured bug report"}};function O(){return new Promise(t=>{const e=[];process.stdin.on("data",r=>e.push(r)),process.stdin.on("end",()=>t(Buffer.concat(e).toString("utf8"))),process.stdin.on("error",()=>t(Buffer.concat(e).toString("utf8"))),process.stdin.resume()})}a(O,"readNote");function p(t,e,r){try{const s=g(t,e,{cwd:r,encoding:"utf8"});return s.status!==0||typeof s.stdout!="string"?null:s.stdout.trim()}catch{return null}}a(p,"run");function j(t){const e=p("gh",["repo","view","--json","nameWithOwner","-q",".nameWithOwner"],t);return e!==null&&e!==""?e:null}a(j,"ghRepo");function D(t,e){const{color:r,description:s}=l[e];g("gh",["label","create",e,"--color",r,"--description",s],{cwd:t,encoding:"utf8"})}a(D,"ensureLabel");const E=q({name:"new",description:"capture a todo/idea/bug note into a GitHub issue (or a .todos/ markdown note)",whenToUse:"the alt+c \u2192 i chord runs this inside a tmux popup; rarely run by hand",tier:"hidden",help:{name:"canvas issue new",summary:"Capture a free-text note as a GitHub issue labeled with its type (idea|bug). Reads the note from the popup TTY, auto-generates the title via a headless pi call, and files it with `gh issue create` when the cwd is a GitHub repo, else writes `<git-root>/.todos/<slug>.md`. Bound to the alt+c \u2192 i prefix chord.",params:[{kind:"flag",name:"type",type:"enum",choices:["idea","bug"],required:!0,constraint:"Issue type / label."},{kind:"flag",name:"body",type:"string",required:!1,constraint:"The note text. Omit to read it from stdin/the popup TTY (type, Ctrl-D to submit)."},{kind:"flag",name:"cwd",type:"string",required:!1,constraint:"Directory whose repo the issue targets. Defaults to --pane\u2019s path, then process.cwd()."},{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane whose cwd/client to use for repo resolution and the confirmation toast."}],output:[{name:"created",type:"boolean",required:!0,constraint:"True when a note was filed."},{name:"target",type:"string",required:!1,constraint:'Where it landed: "github" or "file".'},{name:"type",type:"string",required:!1,constraint:"The issue type/label."},{name:"title",type:"string",required:!1,constraint:"The generated issue title."},{name:"url",type:"string",required:!1,constraint:"Issue URL when target is github."},{name:"path",type:"string",required:!1,constraint:"File path when target is file."}],outputKind:"object",effects:["Creates a GitHub issue via `gh issue create` (and the label if missing), OR writes a markdown note under `<git-root>/.todos/`.","Flashes a tmux status-line toast confirming the capture."]},run:a(async t=>{const e=t.type?.trim();if(e===void 0||!(e in l))throw new y({error:"bad_type",message:`unknown issue type: ${String(t.type)}`,field:"type",next:`Valid types: ${Object.keys(l).join(" | ")}.`});const r=t.pane??process.env.TMUX_PANE,s=r!==void 0&&r!==""?x(r):null,u=t.cwd??s??process.cwd();let n=t.body??"";if(n===""&&(process.stderr.write(`New ${e} \u2014 type your note, then Ctrl-D to submit (Ctrl-C to cancel):
+
+`),n=await O()),n=n.trim(),n==="")return c("crtr: nothing captured \u2014 empty note",r),{created:!1};process.stderr.write(`
+Creating\u2026
+`);const i=await v(n);if(j(u)!==null){D(u,e);const o=p("gh",["issue","create","--title",i,"--body",n,"--label",e],u);if(o!==null&&o!=="")return c(`crtr: \u2713 ${e} filed \u2192 ${o}`,r,5e3),{created:!0,target:"github",type:e,title:i,url:o};process.stderr.write(`gh issue create failed; saving a local .todos note instead
+`)}const $=p("git",["rev-parse","--show-toplevel"],u)??u,f=w($,".todos"),m=new Date().toISOString(),h=m.replace(/[:.]/g,"-").replace("T","_").slice(0,19),d=w(f,`${h}-${b(i)}.md`),T=`---
+type: ${e}
+title: ${JSON.stringify(i)}
+created: ${m}
+status: open
+---
+
+${n}
+`;try{S(f,{recursive:!0}),k(d,T,"utf8")}catch(o){throw c(`crtr: failed to save note: ${o.message}`,r,5e3),new y({error:"write_failed",message:`could not write ${d}`,next:"Check directory permissions."})}return c(`crtr: \u2713 ${e} saved \u2192 .todos/${h}-${b(i)}.md`,r,5e3),{created:!0,target:"file",type:e,title:i,path:d}},"run")});export{E as issueNewLeaf};

package/dist/commands/canvas-prune.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const canvasPruneLeaf: LeafDef;

package/dist/commands/canvas-prune.js

@@ -0,0 +1 @@
+var u=Object.defineProperty;var o=(e,a)=>u(e,"name",{value:a,configurable:!0});import{defineLeaf as p}from"../core/command.js";import{cliClient as h,rethrowAsCliError as m}from"./api-client.js";const r=14,v=p({name:"prune",description:"remove terminal nodes (dead/done/canceled) last active more than a TTL ago",whenToUse:"you want to bound the canvas\u2019s on-disk growth \u2014 sweep away nodes that are finished (done), crashed (dead), or closed (canceled) and last active more than a retention window ago, reclaiming their rows, edges (cascade-deleted by the schema), and `nodes/<id>/` dirs. crtrd already runs the default 14-day sweep of terminal nodes every 5 minutes, so run this by hand for a shorter window, a count cap, --include-stale, or --empty; live nodes (active/idle) and nodes with an open managed worktree are never touched, and you can preview the sweep before it deletes anything",help:{name:"canvas prune",summary:"delete terminal nodes last active more than a TTL ago (edges cascade, dirs removed); --max N for a count cap; --dry-run to preview",params:[{kind:"flag",name:"max",type:"int",required:!1,constraint:"COUNT mode (instead of the TTL sweep): keep every protected node, plus the most recently active terminal nodes up to N in total, deleting the rest. Active/idle nodes regardless of process state and every node listed under effects as kept are NEVER deleted, so the real floor is max(N, protectedCount). Recency = the latest lifecycle timestamp or telemetry.json mtime. Combine with --dry-run to preview."},{kind:"flag",name:"ttl",type:"int",required:!1,default:r,constraint:`Retention window in days: only dead/done/canceled nodes last active more than this many days ago are pruned (last active = the latest lifecycle timestamp or telemetry.json mtime), except the nodes listed under effects as kept. Default: ${r}.`},{kind:"flag",name:"include-stale",type:"bool",required:!1,default:!1,constraint:"ALSO prune stale active/idle nodes last active before the TTL whose process is gone (pi_pid null or dead) \u2014 reaps abandoned roots the daemon never reconciled. Skipped: a live pi_pid, a node sleeping until it is woken, a node with unseen wake mail, a frozen node, a node in respawn backoff, and every node listed under effects as kept."},{kind:"flag",name:"empty",type:"bool",required:!1,default:!1,constraint:"Instead of the TTL sweep, reap EMPTY nodes \u2014 nodes (of any age or status) whose engine never produced an assistant message, the useless shells that just take up graph + disk space. A node mid-first-turn, the caller, and a node with an open managed worktree are spared. Combine with --dry-run to preview."},{kind:"flag",name:"dry-run",type:"bool",required:!1,default:!1,constraint:"Report what WOULD be pruned without deleting anything."}],output:[{name:"pruned",type:"integer",required:!0,constraint:"How many nodes were pruned (0 under --dry-run since nothing is deleted; the candidate count is in `nodes`)."},{name:"dryRun",type:"boolean",required:!0,constraint:"True when nothing was deleted (preview only)."},{name:"ttlDays",type:"integer",required:!0,constraint:"The retention window used."},{name:"nodes",type:"object[]",required:!0,constraint:"One per pruned (or, under --dry-run, prunable) node: {node_id,status,created}."}],outputKind:"object",effects:["With --max N: COUNT mode \u2014 keep every protected node plus the most recently active terminal nodes up to N in total, deleting the rest; active/idle nodes regardless of process state are never deleted. Takes precedence over the TTL/--empty sweeps.","Deletes matching `nodes` rows; their edges cascade-delete via the FK; each node\u2019s `nodes/<id>/` dir is removed.","Always kept, in every mode except --empty: the caller, a node with a live or launching engine, a node with durable work that must wake it (subscription, message wait, cron wake, open ticket, output request), a node a person is viewing, a frozen node, an app run (deleted only through the runs API), and a node with an open managed worktree.","No-op on live nodes (active/idle) and terminal nodes active within the TTL. With --include-stale: also deletes active/idle nodes last active before the TTL whose process is gone and that nothing will wake.","crtrd runs the default sweep (terminal nodes, 14 days, no --include-stale) automatically every 5 minutes.","Under --dry-run: read-only, deletes nothing."]},run:o(async e=>{const a=e.ttl??r,i=e.dryRun??!1,l=e.includeStale??!1,c=e.empty??!1,s=e.max,n={dry_run:i,ttl_days:a};s!==void 0?n.limit=s:c?n.empty=!0:n.include_stale=l;try{const t=await h().prune(n);return{pruned:t.dry_run?0:t.pruned.length,dryRun:t.dry_run,ttlDays:t.ttl_days,nodes:t.pruned.map(d=>({node_id:d.node_id,status:d.status,created:d.created}))}}catch(t){m(t)}},"run")});export{v as canvasPruneLeaf};

package/dist/commands/canvas-roster.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const canvasRosterLeaf: LeafDef;

package/dist/commands/canvas-roster.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var a=(t,o)=>c(t,"name",{value:o,configurable:!0});import{defineLeaf as u}from"../core/command.js";import{cliClient as i,rethrowAsCliError as p}from"./api-client.js";const h=u({name:"roster",description:"emit the lean canvas topology roster as structured data",whenToUse:"you need a fast, set-based roster of every canvas node + subscription edges (`subscribes_to`) for a browser or viewer poll loop; use `canvas snapshot` for the enriched on-demand view (ctx tokens, streaming, hanging, last activity)",tier:"hidden",help:{name:"canvas roster",summary:"lean, set-based canvas topology roster (recurring poll target)",params:[],output:[{name:"generated_at",type:"string",required:!0,constraint:"ISO timestamp when the roster was generated."},{name:"nodes",type:"object[]",required:!0,constraint:"Lean node rows plus attention_count for the returned node set."},{name:"subscriptions",type:"object",required:!0,constraint:"Authoritative subscribes_to adjacency map: each node id maps to its publisher/child node ids in edge order."},{name:"edges",type:"object[]",required:!0,constraint:"Subscription edges with from_id, to_id, active, and created fields."}],outputKind:"object",effects:["Read-only: two indexed canvas.db scans server-side (nodes, subscription watches) plus a bounded attention-count read for the returned node ids."],preview:{suppressOutput:!0}},run:a(async()=>{const t=await i().canvasRoster().catch(e=>p(e)),o=t.nodes.map(e=>e.node_id);let n={};try{n=o.length>0?(await i().attentionCounts(o)).counts:{}}catch{}const d=t.nodes.map(e=>({...e,attention_count:n[e.node_id]??0})),s={};for(const e of t.nodes)s[e.node_id]=[];for(const e of t.edges){const r=s[e.from_id];r!==void 0?r.push(e.to_id):s[e.from_id]=[e.to_id]}return{generated_at:t.generated_at,nodes:d,subscriptions:s,edges:t.edges}},"run")});export{h as canvasRosterLeaf};

package/dist/commands/canvas-snapshot.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const canvasSnapshotLeaf: LeafDef;

package/dist/commands/canvas-snapshot.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var r=(e,t)=>a(e,"name",{value:t,configurable:!0});import{defineLeaf as s}from"../core/command.js";import{cliClient as n,rethrowAsCliError as o}from"./api-client.js";const u=s({name:"snapshot",description:"emit the browser canvas roster as structured data",whenToUse:"you need a machine-readable roster of every canvas node for a browser or local tool; use dashboard for the human-readable tree",tier:"hidden",help:{name:"canvas snapshot",summary:"machine-readable snapshot of the whole canvas roster",params:[],output:[{name:"generated_at",type:"string",required:!0,constraint:"ISO timestamp when the snapshot was generated."},{name:"nodes",type:"object[]",required:!0,constraint:"NodeSummary rows for browser canvas rendering."},{name:"subscriptions",type:"object",required:!0,constraint:"Authoritative subscribes_to adjacency map: each node id maps to its publisher/child node ids in edge order."}],outputKind:"object",effects:["Read-only: queries canvas.db, focus rows, telemetry files, and pending human-reply counts."],preview:{suppressOutput:!0}},run:r(async()=>{try{const e=await n().canvasSnapshot();return{generated_at:e.generated_at,nodes:e.nodes,subscriptions:e.subscriptions}}catch(e){o(e)}},"run")});export{u as canvasSnapshotLeaf};

package/dist/commands/canvas-use.d.ts

@@ -0,0 +1 @@
+export declare const canvasUseLeaf: import("../core/command.js").LeafDef;

package/dist/commands/canvas-use.js

@@ -0,0 +1 @@
+var i=Object.defineProperty;var r=(a,e)=>i(a,"name",{value:e,configurable:!0});import{defineLeaf as l}from"../core/command.js";import{InputError as n}from"../core/io.js";import{updateState as c}from"../core/config.js";import{getRemoteCanvasTarget as m}from"../core/remote-canvas-target.js";const s="user",h=l({name:"use",description:"select the durable default canvas for read commands (a remote target, or local)",whenToUse:"switching what remote-capable read commands such as `node inspect list/show` read from by default, without passing `--canvas <name>` on every invocation \u2014 select a remote target registered via `crtr canvas config add`, or switch back to local. A command\u2019s own `--canvas <name>` flag always overrides this for that one call.",help:{name:"canvas use",summary:"select the durable default canvas (a registered remote target, or local) for read commands",params:[{kind:"positional",name:"name",required:!1,constraint:"A remote canvas target registered via `crtr canvas config add`. Mutually exclusive with --local; exactly one of the two is required."},{kind:"flag",name:"local",type:"bool",required:!1,constraint:"Switch back to the local canvas. Mutually exclusive with <name>."}],output:[],outputKind:"object",effects:["Writes state.json\u2019s activeCanvas (user scope)."]},run:r(async a=>{const e=a.name,t=a.local===!0;if(e!==void 0&&t)throw new n({error:"ambiguous_scope",message:"<name> and --local are mutually exclusive",next:"Pass a target name to go remote, or --local to go local \u2014 not both."});if(e===void 0&&!t)throw new n({error:"missing_target",message:"nothing to select \u2014 pass a target name or --local",next:"Pass a target name (see `crtr canvas config list`) to go remote, or --local to go local."});if(t)return c(s,o=>{o.activeCanvas=null}),{};if(m(e,s)===void 0)throw new n({error:"not_found",message:`no remote canvas target named '${e}'`,next:"List configured targets with `crtr canvas config list`, or register one with `crtr canvas config add`."});return c(s,o=>{o.activeCanvas=e}),{}},"run"),render:r(()=>"Canvas selection updated.","render")});export{h as canvasUseLeaf};

package/dist/commands/canvas.d.ts

@@ -0,0 +1,3 @@
+import type { BranchDef } from '../core/command.js';
+export declare const issueBranch: BranchDef;
+export declare function registerCanvas(): BranchDef;

package/dist/commands/canvas.js

@@ -0,0 +1 @@
+var r=Object.defineProperty;var e=(o,t)=>r(o,"name",{value:t,configurable:!0});import{defineBranch as a}from"../core/command.js";import{dashboardLeaf as n}from"./dashboard.js";import{canvasSnapshotLeaf as s}from"./canvas-snapshot.js";import{canvasRosterLeaf as i}from"./canvas-roster.js";import{browseLeaf as d}from"./canvas-browse.js";import{reviveLeaf as c}from"./revive.js";import{attentionBranch as h}from"./attention.js";import{chordLeaf as m}from"./chord.js";import{canvasPruneLeaf as p}from"./canvas-prune.js";import{historyBranch as u}from"./canvas-history.js";import{issueNewLeaf as f}from"./canvas-issue.js";import{canvasConfigBranch as l}from"./canvas-config.js";import{canvasUseLeaf as g}from"./canvas-use.js";import{readLeaf as w}from"./canvas/read.js";import{listLeaf as v}from"./canvas/list.js";import{searchLeaf as b}from"./canvas/search.js";import{watchLeaf as y}from"./canvas/watch.js";import{unwatchLeaf as L}from"./canvas/unwatch.js";import{edgesLeaf as k}from"./canvas/edges.js";import{analyticsLeaf as j}from"./canvas-analytics.js";const x=a({name:"issue",description:"capture a quick todo/idea/bug into a GitHub issue (or a .todos/ note)",whenToUse:"the alt+c \u2192 i chord uses this; capture a passing thought without leaving your pane",tier:"hidden",help:{name:"canvas issue",summary:"capture a quick todo/idea/bug into a GitHub issue",model:"Quick brain-dump capture, bound to the alt+c \u2192 i \u2192 (idea|bug) prefix chord. `new` reads a free-text note, auto-generates the title via a headless pi call, and files it with `gh issue create --label <type>` when the pane\u2019s cwd is a GitHub repo, else writes `<git-root>/.todos/<slug>.md`. Meant for the chord/popup, not hand-running."},children:[f]});function J(){return a({name:"canvas",rootEntry:{concept:"every object in the agent graph \u2014 documents, nodes, jobs and their owners \u2014 read, listed, searched and watched by name, plus the whole-graph views: render it, see who is blocked, mass-revive disconnected nodes",desc:"read, list, search and watch objects; whole-graph views and supervision",useWhen:"reading a document, node or job by name, finding one you cannot name, watching an object for changes, surveying the full graph, finding blocked agents, or mass-reviving every disconnected node; documents are written with `crtr doc`; run `crtr canvas -h`"},help:{name:"canvas",summary:"read, find and watch objects; observe and supervise the whole agent graph",model:"Every document, node, bash job and owner (person, app, repo, plugin, profile) is an object with an id and a name, and the same verbs work on all of them. `read` returns one object by name or id and makes you a watcher of it; `list` filters objects by type, kind, owner, privacy or name prefix; `search` finds them by text; `edges` shows what an object links to, who acted on it and who watches it; `watch`/`unwatch` add or remove your watch without reading. `list`, `search` and `edges` record nothing. Documents are written, edited and moved with `crtr doc`, and pointed at as `[[name]]`. Canvas-wide views, distinct from per-node work (`node`) and a node's own spine write verb (`push`): `dashboard` renders the subscription forest as a tree; `browse` opens an interactive full-screen navigator over the whole canvas and resumes the chosen node; `attention` aggregates pending replies from the user across the graph; `revive --all` mass-reconnects every disconnected node (bringing back ONE named node is `node lifecycle revive <id>` instead); `history` searches past node conversations; `prune` bounds growth by deleting terminal nodes past a TTL; `analytics` opens the read-only Analytics page (graph sizes, agent time, document reads, API-price estimate) for a person. `config` registers/lists remote canvas targets (preview endpoint + relay token); `use` switches remote-capable read commands such as `node inspect` onto a configured target or back to local."},children:[w,v,b,y,L,k,n,s,i,d,h,c,u,m,x,p,l,g,j]})}e(J,"registerCanvas");export{x as issueBranch,J as registerCanvas};

package/dist/commands/chord.d.ts

@@ -0,0 +1,2 @@
+import type { LeafDef } from '../core/command.js';
+export declare const chordLeaf: LeafDef;

package/dist/commands/chord.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var u=(e,r)=>f(e,"name",{value:r,configurable:!0});import{spawn as l,execFile as p}from"node:child_process";import{promisify as m}from"node:util";import{defineLeaf as h}from"../core/command.js";import{InputError as d}from"../core/io.js";import{cliCanvasSource as g,getNodeOrNull as w}from"./api-client.js";import{fullName as b}from"../core/canvas/labels.js";import{getPaneOption as y}from"../core/runtime/tmux-chrome.js";const v=m(p);async function x(e){if(e===void 0||e==="")return;const r=y(e,"@crtr_node");if(r===void 0||r==="")return;const n=await w(r);if(n!==null&&(n.status==="active"||n.status==="idle"))return r}u(x,"nodeInPane");async function _(e,r){const n=g(),[i,o,t]=await Promise.all([n.getNode(e),n.subscribersOf(e),n.view(e)]),s=o[0]?.node_id??"";return{id:e,self:e,pane:r,lane:e,name:i!==null?b(i):e,manager:s,subtree:t.join(" ")}}u(_,"buildVars");function q(e){const r=[];let n="",i=null,o=!1,t=!1;const s=u(()=>{t&&(r.push(n),n="",t=!1)},"push");for(let c=0;c<e.length;c++){const a=e[c];if(o){n+=a,t=!0,o=!1;continue}if(i==="single"){a==="'"?i=null:(n+=a,t=!0);continue}if(i==="double"){a==='"'?i=null:a==="\\"?o=!0:(n+=a,t=!0);continue}if(/\s/.test(a)){s();continue}if(a==="'"){i="single",t=!0;continue}if(a==='"'){i="double",t=!0;continue}if(a==="\\"){o=!0,t=!0;continue}n+=a,t=!0}if(o&&(n+="\\",t=!0),i!==null)throw new d({error:"bad_run",message:"invalid canvas run string: unterminated quote",next:"Fix the bind in config.json and try again."});return s(),r}u(q,"parseRun");function P(e,r){const n=[];for(const i of q(e)){if(i==="{subtree}"){for(const o of(r.subtree??"").split(/\s+/).filter(t=>t!==""))n.push(o);continue}n.push(i.replace(/\{(\w+)\}/g,(o,t)=>r[t]??""))}return n}u(P,"interpolateArgv");async function T(e,r){if(e.length!==0){if(r){await new Promise(n=>{try{const i=l("crtr",e,{stdio:"inherit"});i.once("error",()=>n()),i.once("close",()=>n())}catch{n()}});return}try{await v("crtr",e,{timeout:15e3})}catch{}}}u(T,"dispatch");const F=h({name:"chord",description:"tmux prefix-menu dispatcher (bound by alt+c; not run by hand)",whenToUse:"never directly \u2014 the alt+c menu routes node-relative actions through it",tier:"hidden",help:{name:"canvas chord",summary:"tmux prefix-menu dispatcher \u2014 resolve the node in --pane, interpolate --run against it, and exec `crtr <argv>`. Bound by the alt+c menu; not meant to be run by hand.",params:[{kind:"flag",name:"pane",type:"string",required:!1,constraint:"tmux pane id whose node the chord acts on. Defaults to $TMUX_PANE / your current pane."},{kind:"flag",name:"run",type:"string",required:!0,constraint:"The argv string to run as crtr, after node vars resolve."},{kind:"flag",name:"interactive",type:"bool",required:!1,constraint:"When true, inherit stdio so popup forms can read from the popup tty."}],output:[{name:"ran",type:"boolean",required:!0,constraint:"True when an action was dispatched."},{name:"node_id",type:"string",required:!1,constraint:"The node the chord resolved against."},{name:"action",type:"string",required:!1,constraint:'What ran: a crtr argv string or "noop".'}],outputKind:"object",effects:["Runs a `crtr` subcommand per the resolved bind."]},run:u(async e=>{const r=e.pane,n=r!==void 0&&r!==""?r:process.env.TMUX_PANE,i=e.run?.trim(),o=e.interactive===!0;if(i===void 0||i==="")throw new d({error:"missing_run",message:"no run string provided",next:"Pass --run <argv-string> from the menu renderer."});const t=await x(n);if(t===void 0)throw new d({error:"no_node",message:"no node found in this pane",next:"Run from inside an agent's pane, or pass --pane <pane-id>."});const s=P(i,await _(t,n??""));return s.length===0?{ran:!1,node_id:t,action:"noop"}:(await T(s,o),{ran:!0,node_id:t,action:`crtr ${s.join(" ")}`})},"run")});export{F as chordLeaf};

package/dist/commands/cron.d.ts

@@ -0,0 +1,2 @@
+import type { BranchDef } from '../core/command.js';
+export declare function registerCron(): BranchDef;