@north-light/cli 0.3.512 → 0.3.513

package/dist/api/command-manifest/object-kinds.js

@@ -1 +1 @@
-var u=Object.defineProperty;var f=(t,e)=>u(t,"name",{value:e,configurable:!0});const m=/^[a-z][a-z0-9-]*\.[a-z][a-z0-9-]*$/,E=/^[a-z][a-z0-9-]*$/,b=["report","notice","node","job","document","person","app","repo","profile","action"],_=64,N=1,k=10,l=new Set(["description","events","read"]),y=new Set(["level","supersedes"]);function d(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}f(d,"isRecord");function $(t,e){if(!d(t))return[`${e} events must be an object`];const o=[],c=Object.entries(t);c.length>64&&o.push(`${e} declares more than 64 events`);for(const[r,s]of c){const n=`${e} event ${JSON.stringify(r)}`;if(E.test(r)||o.push(`${n} is not a valid event name`),!d(s)){o.push(`${n} must be an object { level, supersedes? }`);continue}for(const a of Object.keys(s))y.has(a)||o.push(`${n} has unknown key ${JSON.stringify(a)}`);const i=s.level;(typeof i!="number"||!Number.isInteger(i)||i<1||i>10)&&o.push(`${n} level must be an integer 1-10`),s.supersedes!==void 0&&typeof s.supersedes!="boolean"&&o.push(`${n} supersedes must be a boolean`)}return o}f($,"eventCatalogReasons");function j(t){const e=[],o=t.object_kinds;if(o!==void 0)if(!d(o))e.push("object_kinds must be an object keyed by kind name");else for(const[r,s]of Object.entries(o)){const n=`object_kinds ${JSON.stringify(r)}`;if(m.test(r)?b.includes(r.split(".")[0])&&e.push(`${n} uses a reserved first segment`):e.push(`${n} is not a valid kind name (<plugin>.<name>, lowercase)`),!d(s)){e.push(`${n} must be an object { description, events, read? }`);continue}for(const a of Object.keys(s))l.has(a)||e.push(`${n} has unknown key ${JSON.stringify(a)}`);(typeof s.description!="string"||s.description.trim()==="")&&e.push(`${n} description must be non-empty text`),e.push(...$(s.events,n));const i=s.read;if(i!==void 0){const a=d(i)?i.command:void 0;!d(i)||Object.keys(i).some(p=>p!=="command")?e.push(`${n} read must be { command: [leaf path] }`):(!Array.isArray(a)||a.length===0||a.some(p=>typeof p!="string"||p===""))&&e.push(`${n} read.command must be a non-empty array of command names`)}}const c=t.scopes;return c!==void 0&&(!Array.isArray(c)||c.some(r=>typeof r!="string"))&&e.push("scopes must be an array of scope strings"),e}f(j,"objectBlocksShapeReasons");function g(t,e,o,c,r){const s=e.read?.command;if(s===void 0)return[];const n=s.join(" ");return c.has(n)?r.has(n)?[`object_kinds ${JSON.stringify(t)} read.command "${n}" streams; a read is one {markdown} answer`]:[]:[`object_kinds ${JSON.stringify(t)} read.command "${n}" is not a leaf of plugin "${o}"`]}f(g,"objectKindReadReasons");export{m as KIND,E as LOCAL,k as MAX_EVENT_LEVEL,_ as MAX_KIND_EVENTS,N as MIN_EVENT_LEVEL,b as RESERVED_KIND_ROOTS,$ as eventCatalogReasons,j as objectBlocksShapeReasons,g as objectKindReadReasons};
+var p=Object.defineProperty;var f=(t,n)=>p(t,"name",{value:n,configurable:!0});const m=/^[a-z][a-z0-9-]*\.[a-z][a-z0-9-]*$/,E=/^[a-z][a-z0-9-]*$/,b=["report","notice","node","job","document","person","app","repo","profile","action"],h=64,N=1,k=10,l=new Set(["description","events","read"]),y=new Set(["level","supersedes","ends_wait"]);function d(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}f(d,"isRecord");function _(t,n){if(!d(t))return[`${n} events must be an object`];const o=[],c=Object.entries(t);c.length>64&&o.push(`${n} declares more than 64 events`);for(const[i,s]of c){const e=`${n} event ${JSON.stringify(i)}`;if(E.test(i)||o.push(`${e} is not a valid event name`),!d(s)){o.push(`${e} must be an object { level, supersedes?, ends_wait? }`);continue}for(const a of Object.keys(s))y.has(a)||o.push(`${e} has unknown key ${JSON.stringify(a)}`);const r=s.level;(typeof r!="number"||!Number.isInteger(r)||r<1||r>10)&&o.push(`${e} level must be an integer 1-10`),s.supersedes!==void 0&&typeof s.supersedes!="boolean"&&o.push(`${e} supersedes must be a boolean`),s.ends_wait!==void 0&&typeof s.ends_wait!="boolean"&&o.push(`${e} ends_wait must be a boolean`)}return o}f(_,"eventCatalogReasons");function j(t){const n=[],o=t.object_kinds;if(o!==void 0)if(!d(o))n.push("object_kinds must be an object keyed by kind name");else for(const[i,s]of Object.entries(o)){const e=`object_kinds ${JSON.stringify(i)}`;if(m.test(i)?b.includes(i.split(".")[0])&&n.push(`${e} uses a reserved first segment`):n.push(`${e} is not a valid kind name (<plugin>.<name>, lowercase)`),!d(s)){n.push(`${e} must be an object { description, events, read? }`);continue}for(const a of Object.keys(s))l.has(a)||n.push(`${e} has unknown key ${JSON.stringify(a)}`);(typeof s.description!="string"||s.description.trim()==="")&&n.push(`${e} description must be non-empty text`),n.push(..._(s.events,e));const r=s.read;if(r!==void 0){const a=d(r)?r.command:void 0;!d(r)||Object.keys(r).some(u=>u!=="command")?n.push(`${e} read must be { command: [leaf path] }`):(!Array.isArray(a)||a.length===0||a.some(u=>typeof u!="string"||u===""))&&n.push(`${e} read.command must be a non-empty array of command names`)}}const c=t.scopes;return c!==void 0&&(!Array.isArray(c)||c.some(i=>typeof i!="string"))&&n.push("scopes must be an array of scope strings"),n}f(j,"objectBlocksShapeReasons");function g(t,n,o,c,i){const s=n.read?.command;if(s===void 0)return[];const e=s.join(" ");return c.has(e)?i.has(e)?[`object_kinds ${JSON.stringify(t)} read.command "${e}" streams; a read is one {markdown} answer`]:[]:[`object_kinds ${JSON.stringify(t)} read.command "${e}" is not a leaf of plugin "${o}"`]}f(g,"objectKindReadReasons");export{m as KIND,E as LOCAL,k as MAX_EVENT_LEVEL,h as MAX_KIND_EVENTS,N as MIN_EVENT_LEVEL,b as RESERVED_KIND_ROOTS,_ as eventCatalogReasons,j as objectBlocksShapeReasons,g as objectKindReadReasons};

package/dist/api/contract.d.ts

@@ -1,5 +1,5 @@
 /** The contract level this build serves and requires. Written by `scripts/contract.mjs release`; never edit by hand. */
-export declare const CONTRACT_LEVEL = "1.22";
+export declare const CONTRACT_LEVEL = "1.23";
 /** Request header naming the one contract level the caller needs, e.g. `1.3`. Optional: absent means no check. */
 export declare const REQUIRED_CONTRACT_HEADER = "Crouter-Required-Contract";
 /** Response header listing the contract levels the server serves, comma-separated, one per major, e.g. `1.3`. */

package/dist/api/contract.js

@@ -1 +1 @@
-var c=Object.defineProperty;var e=(r,t)=>c(r,"name",{value:t,configurable:!0});const f="1.22",i="Crouter-Required-Contract",p="Crouter-Contract";function l(r){const t=/^(\d+)\.(\d+)$/.exec(r.trim());return t===null?null:{major:Number(t[1]),minor:Number(t[2])}}e(l,"parseContractLevel");function a(r){return r==null?[]:r.split(",").map(t=>l(t)).filter(t=>t!==null)}e(a,"parseServedContracts");function s(r,t){const n=l(r);return n===null?!1:(typeof t=="string"||t===null||t===void 0?a(t):t).some(u=>u.major===n.major&&u.minor>=n.minor)}e(s,"contractSatisfies");function C(r,t,n={}){if(r===void 0)return null;if(l(r)===null)return{status:400,code:"invalid_request",param:i,message:`${i} must be a contract level like 1.0.`};if(s(r,t))return null;const o=r.trim();return{status:426,code:"runtime_version_unsupported",message:t===null||a(t).length===0?`The runtime did not name its contract level; the caller requires contract ${o} or later. Roll the runtime forward.`:`The runtime serves contract ${t}; the caller requires contract ${o} or later within the same major. Roll the runtime forward, or pin an SDK whose crouterContract the runtime serves.`,details:{sdk_version:(n.legacyMinimum??"").trim(),runtime_version:n.runtimeVersion??null,required_contract:o,runtime_contract:t}}}e(C,"contractRefusal");export{p as CONTRACT_HEADER,f as CONTRACT_LEVEL,i as REQUIRED_CONTRACT_HEADER,C as contractRefusal,s as contractSatisfies,l as parseContractLevel,a as parseServedContracts};
+var c=Object.defineProperty;var e=(r,t)=>c(r,"name",{value:t,configurable:!0});const f="1.23",i="Crouter-Required-Contract",p="Crouter-Contract";function l(r){const t=/^(\d+)\.(\d+)$/.exec(r.trim());return t===null?null:{major:Number(t[1]),minor:Number(t[2])}}e(l,"parseContractLevel");function a(r){return r==null?[]:r.split(",").map(t=>l(t)).filter(t=>t!==null)}e(a,"parseServedContracts");function s(r,t){const n=l(r);return n===null?!1:(typeof t=="string"||t===null||t===void 0?a(t):t).some(u=>u.major===n.major&&u.minor>=n.minor)}e(s,"contractSatisfies");function C(r,t,n={}){if(r===void 0)return null;if(l(r)===null)return{status:400,code:"invalid_request",param:i,message:`${i} must be a contract level like 1.0.`};if(s(r,t))return null;const o=r.trim();return{status:426,code:"runtime_version_unsupported",message:t===null||a(t).length===0?`The runtime did not name its contract level; the caller requires contract ${o} or later. Roll the runtime forward.`:`The runtime serves contract ${t}; the caller requires contract ${o} or later within the same major. Roll the runtime forward, or pin an SDK whose crouterContract the runtime serves.`,details:{sdk_version:(n.legacyMinimum??"").trim(),runtime_version:n.runtimeVersion??null,required_contract:o,runtime_contract:t}}}e(C,"contractRefusal");export{p as CONTRACT_HEADER,f as CONTRACT_LEVEL,i as REQUIRED_CONTRACT_HEADER,C as contractRefusal,s as contractSatisfies,l as parseContractLevel,a as parseServedContracts};

package/dist/api/dto/canvas.d.ts

@@ -276,6 +276,18 @@ export interface RosterDTO {
     generated_at: IsoTime;
     nodes: RosterNodeDTO[];
     edges: RosterEdgeDTO[];
+    /** Every live wait a node holds on a watched canvas object (a workflow run until it completes), oldest
+     *  first per node. The attach viewer lists this node's below the editor beside its child and cron rows. */
+    object_waits?: RosterObjectWaitDTO[];
+}
+/** One node's live wait on a watched object: the object's kind (`github.run`) and name identify it to a
+ *  person; `crtr canvas read <object_id>` reads it. */
+export interface RosterObjectWaitDTO {
+    node_id: NodeIdDTO;
+    object_id: string;
+    object_type: string;
+    object_name: string;
+    created: IsoTime;
 }
 /** Browse's initial frame needs the dashboard fields and topology, not the full
  * node detail/list projection. Transported as gzip JSON (application/gzip) over

package/dist/api/dto/custom-objects.d.ts

@@ -2,6 +2,7 @@ import type { PrivacyName } from './objects.js';
 export interface CustomEventSpecDTO {
     level: number;
     supersedes?: boolean;
+    ends_wait?: boolean;
 }
 export type CustomReceiverDTO = 'queue' | {
     url: string;

package/dist/api/dto/objects.d.ts

@@ -13,6 +13,7 @@ export interface ObjectKindDeclDTO {
     events: Record<string, {
         level: number;
         supersedes?: boolean;
+        ends_wait?: boolean;
     }>;
     owner: {
         id: string;

package/dist/builtin-memory/crouter-sdk/release-notes.md

@@ -16,6 +16,11 @@ The runtime serves `GET /v1/ready` on its owner API and its app listener. Additi
 - `GET /v1/ready` answers 200 `{ready: true}` once the runtime can admit ordinary work, otherwise 503 `{ready: false, reason, message}` (`startup_pending`, `jwks_pending`, `grant_snapshot_missing`). It needs no credential. `GET /v1/health` and `GET /healthz` answer as before.
 - On a joined runtime that has not yet committed its first grant snapshot from the directory, creating a terminal node answers 503 `runtime_starting` (retry) instead of 403 `scope_missing`. After the first snapshot a missing terminal grant is still 403.
 
+A node that watches a canvas object whose kind declares an event with `ends_wait: true` (a workflow run's `completed`) holds a wait on that object until the event lands, the node stops watching, or the node ends. Additive: no request or response an existing app sends or reads changes.
+
+- `ObjectKindEvent.ends_wait` (optional) in a plugin's `objectKinds`; the bundle validator accepts the key.
+- `RosterDTO.object_waits` (optional) lists every live object wait with the object's id, kind and name.
+
 ## 0.3.510
 
 `providers.call` takes an optional `machine`. Additive: no request or response an existing app sends or reads changes.

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

@@ -21,6 +21,11 @@ export type CanvasPanelItem = {
     key: 'crons';
     kind: 'crons';
     line: string;
+} | {
+    key: string;
+    kind: 'object-wait';
+    objectId: string;
+    line: string;
 };
 export interface CanvasPanelLines {
     /** Below-editor relationship and wait rows, in render order. */

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

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

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

@@ -0,0 +1,4 @@
+import type { RosterObjectWaitDTO } from '../../../api/dto/canvas.js';
+/** Compact cockpit row for one object wait: the kind first (matching the other
+ *  wait rows' state-first shape), how long the node has waited, then the object. */
+export declare function objectWaitSummary(wait: RosterObjectWaitDTO, nowMs?: number, nameCap?: number): string;

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

@@ -0,0 +1 @@
+var a=Object.defineProperty;var n=(t,e)=>a(t,"name",{value:e,configurable:!0});import{formatBashElapsed as l}from"../../../core/bash-jobs.js";function c(t,e){return t.length<=e?t:`\u2026${t.slice(t.length-Math.max(1,e-1))}`}n(c,"nameCell");function s(t){const e=t.lastIndexOf(".");return e===-1?t:t.slice(e+1)}n(s,"kindCell");function f(t,e=Date.now(),o=28){const r=l(e-Date.parse(t.created));return`${s(t.object_type)} \xB7 ${r} \xB7 ${c(t.object_name,Math.max(8,o))}`}n(f,"objectWaitSummary");export{f as objectWaitSummary};

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

@@ -19,6 +19,9 @@ export interface RosterHooks {
      *  the cron wait row routes to `schedule` and the bash row to `jobs`; the
      *  native Inspector owns details for both. */
     openInspector: (section: 'overview' | 'schedule' | 'jobs') => void;
+    /** Open a watched canvas object's `crtr canvas read` in a popup — the
+     *  object-wait row's detail surface (a workflow run, a pull request). */
+    openObject: (objectId: string) => void;
     /** Recompute the editor's hollow-cursor state (session/pane-focus.ts). */
     syncCursor: () => void;
 }

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

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

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

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

package/dist/clients/attach/session/readonly-popup.d.ts

@@ -0,0 +1,15 @@
+export interface ReadonlyPopup {
+    /** The file name inside the temp dir; non-portable characters are replaced. */
+    name: string;
+    /** Page content written before the popup opens. Omit it when `produce` writes the file. */
+    content?: string;
+    /** A shell fragment run inside the popup that writes the page to `$PAGE` (e.g. `crtr canvas read x > "$PAGE"`). */
+    produce?: (page: string) => string;
+    /** Popup title; omitted leaves tmux's default. */
+    title?: string;
+    /** What the person sees when nvim is not installed. */
+    noNvim: string;
+    onClose?: () => void;
+}
+/** Open the page in a read-only nvim popup (90% × 85%). Requires tmux — callers gate on `inTmux()` first. */
+export declare function openReadonlyPopup(spec: ReadonlyPopup): void;

package/dist/clients/attach/session/readonly-popup.js

@@ -0,0 +1 @@
+var f=Object.defineProperty;var n=(e,o)=>f(e,"name",{value:o,configurable:!0});import{execFile as l}from"node:child_process";import{mkdtempSync as u,rmSync as c,writeFileSync as p}from"node:fs";import{tmpdir as a}from"node:os";import{join as i}from"node:path";import{nvimShellCommand as s}from"../../../core/nvim-launch.js";import{shellQuote as r}from"../../../core/runtime/placement-tmux.js";import{surfaceTmuxStyleArgs as y}from"../../../core/runtime/surface-bg.js";function E(e){const o=u(i(a(),"crtr-page-")),t=i(o,`${e.name.replace(/[^A-Za-z0-9_.-]/g,"-")}.md`);e.content!==void 0&&p(t,e.content,"utf8");const m=`${e.produce===void 0?"":`${e.produce(r(t))}; `}if command -v nvim >/dev/null 2>&1; then exec ${s("readonly",[t])}; else cat ${r(t)}; printf '%s\\n' ${r(e.noNvim)}; printf 'Press Enter to close.'; read _; fi`,d=e.title===void 0?[]:["-T",` ${e.title} `];l("tmux",["display-popup","-E",...d,"-w","90%","-h","85%",...y(),m],()=>{c(o,{recursive:!0,force:!0}),e.onClose?.()})}n(E,"openReadonlyPopup");export{E as openReadonlyPopup};