@north-light/crouter 0.3.318 → 0.3.319

package/dist/clients/inbox/tui.js

@@ -1,86 +1 @@
-import { RESET, BOLD, DIM, ITALIC, CYAN, RED, GRAY, YELLOW, truncateRow } from './tui/ansi.js';
-function ansiColor(text, color) {
-    switch (color) {
-        case 'gray': return `${GRAY}${text}${RESET}`;
-        case 'cyan': return `${CYAN}${text}${RESET}`;
-        case 'red': return `${RED}${text}${RESET}`;
-        case 'yellow': return `${YELLOW}${text}${RESET}`;
-        default: return text;
-    }
-}
-export const KIND_ICON = { notify: '✉', decision: '◆', context: '✎', error: '⚠', review: '▤', display: '✉', rich: '▣', interactive: '◆' };
-export const KIND_COLOR = { notify: 'gray', decision: 'cyan', context: 'cyan', error: 'red', review: 'yellow', display: 'gray', rich: 'cyan', interactive: 'cyan' };
-export function formatTimeAgo(iso) {
-    const minutes = Math.floor((Date.now() - new Date(iso).getTime()) / 60000);
-    if (minutes >= 60)
-        return `${Math.floor(minutes / 60)}h ago`;
-    if (minutes > 0)
-        return `${minutes}m ago`;
-    return 'just now';
-}
-/** Pure inbox rows; selection and terminal ownership belong to InboxController. */
-export function buildInboxLines(items, width, selectedIndex, height = Number.MAX_SAFE_INTEGER) {
-    if (items.length === 0)
-        return [`  ${DIM}${ITALIC}No pending interactions${RESET}`];
-    const contentWidth = width - 4;
-    const itemLines = items.map((item, index) => buildItemLines(item, index, selectedIndex, contentWidth));
-    const window = visibleWindow(itemLines, selectedIndex, Math.max(1, height - 2));
-    const lines = [`  ${BOLD}${items.length} pending${RESET}`, ''];
-    if (window.start > 0)
-        lines.push(`  ${DIM}↑ ${window.start} above${RESET}`);
-    for (let index = window.start; index < window.end; index++)
-        lines.push(...itemLines[index]);
-    if (window.end < items.length)
-        lines.push(`  ${DIM}↓ ${items.length - window.end} below${RESET}`);
-    return lines;
-}
-function buildItemLines(item, index, selectedIndex, contentWidth) {
-    const kind = item.kind === 'page'
-        ? item.awaitsResponse === false ? 'display' : 'rich'
-        : item.kind;
-    const icon = KIND_ICON[kind] ?? '·';
-    // The inbox is a title-first triage surface. Origin details remain available
-    // after opening a ticket, rather than consuming the list's scarce row width.
-    const age = formatTimeAgo(item.kind === 'page' ? item.emittedAt : item.blockedSince);
-    const cursor = index === selectedIndex ? `${CYAN}▸${RESET} ` : '  ';
-    const titleWidth = Math.max(1, contentWidth - age.length - 6);
-    const row = `${cursor}${ansiColor(icon, KIND_COLOR[kind] ?? 'cyan')} ${BOLD}${truncateRow(item.title || `(${item.id.slice(0, 8)})`, titleWidth)}${RESET}  ${DIM}${age}${RESET}`;
-    const subtitle = item.claim ? `claimed by ${item.claim.owner} · ${item.subtitle}` : item.subtitle;
-    const lines = [row, `      ${DIM}${truncateRow(subtitle, contentWidth - 6)}${RESET}`];
-    const recommended = recommendedLabel(item);
-    if (recommended !== undefined)
-        lines.push(`      ${DIM}Recommended: ${truncateRow(recommended, Math.max(1, contentWidth - 19))}${RESET}`);
-    return lines;
-}
-/** What the agent suggests, for a row that says so without opening the page. */
-export function recommendedLabel(item) {
-    if (item.kind !== 'page' || item.recommendedOptions.length === 0)
-        return undefined;
-    return item.recommendedOptions.map((option) => option.label).join(' · ');
-}
-/** Select a contiguous row window that always contains the selected ticket. */
-function visibleWindow(rows, selectedIndex, capacity) {
-    let start = Math.max(0, Math.min(selectedIndex, rows.length - 1));
-    let end = start + 1;
-    let preferBelow = true;
-    while (true) {
-        const below = end < rows.length ? { start, end: end + 1 } : undefined;
-        const above = start > 0 ? { start: start - 1, end } : undefined;
-        const preferred = preferBelow ? [below, above] : [above, below];
-        const next = preferred.find((candidate) => candidate !== undefined && windowHeight(rows, candidate.start, candidate.end) <= capacity);
-        if (next === undefined)
-            break;
-        start = next.start;
-        end = next.end;
-        preferBelow = !preferBelow;
-    }
-    return { start, end };
-}
-function windowHeight(rows, start, end) {
-    let height = start > 0 ? 1 : 0;
-    for (let index = start; index < end; index++)
-        height += rows[index].length;
-    if (end < rows.length)
-        height++;
-    return height;
-}
+var y=Object.defineProperty;var l=(n,e)=>y(n,"name",{value:e,configurable:!0});import{RESET as o,BOLD as w,DIM as $,ITALIC as m,CYAN as b,RED as x,GRAY as L,YELLOW as M,truncateRow as h}from"./tui/ansi.js";function I(n,e){switch(e){case"gray":return`${L}${n}${o}`;case"cyan":return`${b}${n}${o}`;case"red":return`${x}${n}${o}`;case"yellow":return`${M}${n}${o}`;default:return n}}l(I,"ansiColor");const R={notify:"\u2709",decision:"\u25C6",context:"\u270E",error:"\u26A0",review:"\u25A4",display:"\u2709",rich:"\u25A3",interactive:"\u25C6"},k={notify:"gray",decision:"cyan",context:"cyan",error:"red",review:"yellow",display:"gray",rich:"cyan",interactive:"cyan"};function v(n){const e=Math.floor((Date.now()-new Date(n).getTime())/6e4);return e>=60?`${Math.floor(e/60)}h ago`:e>0?`${e}m ago`:"just now"}l(v,"formatTimeAgo");function T(n,e,c,t=Number.MAX_SAFE_INTEGER){if(n.length===0)return[`  ${$}${m}No pending interactions${o}`];const r=e-4,s=n.map((d,u)=>A(d,u,c,r)),i=E(s,c,Math.max(1,t-2)),a=[`  ${w}${n.length} pending${o}`,""];i.start>0&&a.push(`  ${$}\u2191 ${i.start} above${o}`);for(let d=i.start;d<i.end;d++)a.push(...s[d]);return i.end<n.length&&a.push(`  ${$}\u2193 ${n.length-i.end} below${o}`),a}l(T,"buildInboxLines");function A(n,e,c,t){const r=n.kind==="page"?n.awaitsResponse===!1?"display":"rich":n.kind,s=R[r]??"\xB7",i=v(n.kind==="page"?n.emittedAt:n.blockedSince),a=e===c?`${b}\u25B8${o} `:"  ",d=Math.max(1,t-i.length-6),u=`${a}${I(s,k[r]??"cyan")} ${w}${h(n.title||`(${n.id.slice(0,8)})`,d)}${o}  ${$}${i}${o}`,f=n.claim?`claimed by ${n.claim.owner} \xB7 ${n.subtitle}`:n.subtitle,p=[u,`      ${$}${h(f,t-6)}${o}`],g=D(n);return g!==void 0&&p.push(`      ${$}Recommended: ${h(g,Math.max(1,t-19))}${o}`),p}l(A,"buildItemLines");function D(n){if(!(n.kind!=="page"||n.recommendedOptions.length===0))return n.recommendedOptions.map(e=>e.label).join(" \xB7 ")}l(D,"recommendedLabel");function E(n,e,c){let t=Math.max(0,Math.min(e,n.length-1)),r=t+1,s=!0;for(;;){const i=r<n.length?{start:t,end:r+1}:void 0,a=t>0?{start:t-1,end:r}:void 0,u=(s?[i,a]:[a,i]).find(f=>f!==void 0&&N(n,f.start,f.end)<=c);if(u===void 0)break;t=u.start,r=u.end,s=!s}return{start:t,end:r}}l(E,"visibleWindow");function N(n,e,c){let t=e>0?1:0;for(let r=e;r<c;r++)t+=n[r].length;return c<n.length&&t++,t}l(N,"windowHeight");export{k as KIND_COLOR,R as KIND_ICON,T as buildInboxLines,v as formatTimeAgo,D as recommendedLabel};

package/dist/clients/surfaces/host.js

@@ -1 +0,0 @@
-export {};

package/dist/commands/api-client.js

@@ -1,290 +1,4 @@
-// api-client.ts — the shared CLI-side client factory + read-source adapter that
-// every re-plumbed `crtr` verb (Stage B) builds on.
-//
-// THE POINT (spec §1/§10, plan B-0): a `crtr` CLI process must NEVER open
-// canvas.db. This file is the seam that makes that possible — its transitive
-// RUNTIME import graph reaches ZERO canvas state-store code (`core/canvas/db.ts`
-// `openDb` / `core/canvas/canvas.ts` accessors). It gets there three ways:
-//   1. `CrtrClient` (`src/api`) is dependency-light by construction (spec §3.1).
-//   2. `ensureDaemon` is imported from the lean `daemon/manage.ts`, which — after
-//      the B-0 pidfile/boot-id extractions — is fs/process-only (no crtrd.ts,
-//      no `openDb`).
-//   3. `CanvasSource`/`NodeRow`/`NodeMeta` are TYPE-ONLY imports (erased at
-//      emit), so naming them pulls no runtime canvas code.
-// The `--canvas` remote branch reuses `RemoteCanvasSource`, itself verified
-// openDb-free (its only runtime import is the HTTP `createRemoteExec`; its
-// `CanvasSource`/`types` imports are type-only) — plan Q-3.
-import { closeSync, fstatSync, openSync, readSync } from 'node:fs';
-import { join } from 'node:path';
-import { CrtrClient, ApiError } from '../api/index.js';
-import { apiErrorToCliError } from '../core/io.js';
-import { autostartDisabled, ensureDaemon } from '../daemon/manage.js';
-import { DAEMON_STARTUP_WINDOW_MS } from '../daemon/startup-policy.js';
-import { readState } from '../core/config.js';
-import { resolveRemoteCanvasTarget } from '../core/remote-canvas-target.js';
-import { RemoteCanvasSource } from '../core/canvas/remote-canvas-source.js';
-import { crtrHome } from '../core/canvas/paths.js';
-/** The API projects exactly the fault a node row carries; `api/` simply cannot
- *  express the branded `operation_id` (it imports Node built-ins only), so the
- *  wire value is asserted back to the row's fault type here rather than
- *  reshaped. `broker↔crtrd` is deliberately absent from the wire link union: a
- *  stored fault can never carry it. */
-function withRowFault(dto) {
-    return { ...dto, fault: (dto.fault ?? null) };
-}
-// Error translation
-/** Rethrow an `ApiError` as the clean structured CLI error agents parse
- *  (`core/io` `handle`) — instead of the generic "internal bug" stderr path a
- *  raw non-`CrtrError` throw would take. The mapping itself lives in ONE place
- *  (`apiErrorToCliError`, `core/io.ts`); this is the explicit-catch helper a
- *  leaf uses when it wants to attach a call-site `next` hint. Non-`ApiError`
- *  throws propagate unchanged (a genuine bug still reads as `internal`). Typed
- *  `never` so callers can use it as the tail of a `catch` without confusing
- *  definite assignment. */
-export function rethrowAsCliError(err, next) {
-    if (err instanceof ApiError)
-        throw apiErrorToCliError(err, next);
-    throw err;
-}
-/** Fetch a node, mapping ONLY a 404 to `null` (the "not found" contract every
- *  existence-check leaf wants) and surfacing every other failure as the clean
- *  network-class CLI error via `rethrowAsCliError`. This replaces the old
- *  `.catch(() => null)` idiom that, post-B-1 (`getNode` is now an HTTP round-trip),
- *  masked a broken/slow/restarting daemon as a false "node not found". Same
- *  404-only→null mapping as `ApiCanvasSource.orNull`, but returning the raw DTO
- *  and rethrowing non-404s as CLI errors rather than swallowing them. */
-export async function getNodeOrNull(nodeId) {
-    try {
-        return await cliClient().getNode(nodeId);
-    }
-    catch (err) {
-        if (err instanceof ApiError && err.status === 404)
-            return null;
-        rethrowAsCliError(err);
-    }
-}
-// cliClient — the one place the CLI constructs a daemon client
-/** Bounded tail of crtrd.log surfaced on a cold-start `/healthz` timeout.
- *  Large enough to catch a real startup failure/stack trace,
- *  small enough that a runaway daemon log can never leak unbounded into a CLI
- *  error message. */
-export const COLD_START_DIAGNOSTIC_TAIL_BYTES = 4_096;
-const COLD_START_DIAGNOSTIC_TAIL_LINES = 20;
-/** Read a bounded tail of crtrd's event log to enrich a `daemon_unavailable`
- *  cold-start timeout, so the actual startup failure is not discarded behind a
- *  bare message. Bounds the I/O itself — opens the file and reads only the
- *  final `COLD_START_DIAGNOSTIC_TAIL_BYTES` bytes via `fstatSync`+`readSync`,
- *  never `readFileSync`-ing the whole append-only log — then decodes/filters
- *  that bounded slice. Best-effort and synchronous per the `coldStartDiagnostic`
- *  contract — a missing/unreadable/empty log yields `undefined` so the base
- *  message is used unchanged. */
-export function readColdStartDiagnostic() {
-    let fd;
-    try {
-        fd = openSync(join(crtrHome(), 'crtrd.log'), 'r');
-        const { size } = fstatSync(fd);
-        const start = Math.max(0, size - COLD_START_DIAGNOSTIC_TAIL_BYTES);
-        const length = size - start;
-        if (length <= 0)
-            return undefined;
-        const buffer = Buffer.alloc(length);
-        readSync(fd, buffer, 0, length, start);
-        const lines = buffer.toString('utf8').split('\n').filter((line) => line.trim() !== '');
-        const tail = lines.slice(-COLD_START_DIAGNOSTIC_TAIL_LINES).join('\n').trim();
-        return tail === '' ? undefined : `crtrd.log (tail):\n${tail}`;
-    }
-    catch {
-        return undefined;
-    }
-    finally {
-        if (fd !== undefined) {
-            try {
-                closeSync(fd);
-            }
-            catch {
-                // best-effort close; the read already happened (or failed) above.
-            }
-        }
-    }
-}
-/** The local-socket `CrtrClient` every CLI verb uses. Autostart is on by
- *  default: on a cold socket the injected `onColdSocket` hook fires
- *  `ensureDaemon()` (spawns crtrd detached via the branded host), then the
- *  client polls `/healthz` to a bounded deadline and retries once (the poll
- *  lives inside `CrtrClient`, A-2). If crtrd never becomes reachable, the
- *  client surfaces the final observed transport failure. This is the ONLY CLI
- *  reference to `ensureDaemon`.
- *
- *  `onColdSocket` is fire-and-forget — `ensureDaemon()` spawns crtrd and
- *  returns immediately, so the client's OWN `/healthz` poll is the only
- *  deadline the initiating CLI invocation actually waits on. It must never be
- *  narrower than the window `spawnDaemon`'s `verifyDaemonStartup` allows.
- *  Both callers use the shared startup policy so a valid on-disk migration
- *  cannot outlast the initiating CLI command. */
-export function cliClient(opts) {
-    if (autostartDisabled()) {
-        return CrtrClient.forLocalSocket({ autostart: false, ...(opts?.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}) });
-    }
-    return CrtrClient.forLocalSocket({
-        ...(opts?.timeoutMs !== undefined ? { timeoutMs: opts.timeoutMs } : {}),
-        onColdSocket: async () => {
-            // The client's bounded /healthz poll owns the readiness wait and failure.
-            ensureDaemon();
-        },
-        // On a cold-start timeout, enrich the bare `daemon_unavailable` with the
-        // tail of crtrd's event log instead of discarding it.
-        coldStartDiagnostic: readColdStartDiagnostic,
-        coldStartPollWindowMs: DAEMON_STARTUP_WINDOW_MS,
-    });
-}
-// ApiCanvasSource — a read CanvasSource backed entirely by the crtrd API
-// NodeSummaryDTO now carries every NodeRow field and NodeDetailDTO extends it,
-// so the viewer adapter returns the daemon's typed projections directly. It
-// performs no lossy legacy reconstruction or invented local-presence values.
-// Index the short-lived lean roster once so repeated topology lookups stay O(1).
-// listNodes/getRow still use full DTO endpoints for fields the roster omits.
-const ROSTER_CACHE_TTL_MS = 2000;
-export class ApiCanvasSource {
-    client;
-    rosterCache = null;
-    rosterInFlight = null;
-    constructor(client = cliClient()) {
-        this.client = client;
-    }
-    async roster() {
-        const now = Date.now();
-        if (this.rosterCache !== null && now - this.rosterCache.at < ROSTER_CACHE_TTL_MS) {
-            return this.rosterCache.index;
-        }
-        if (this.rosterInFlight !== null)
-            return this.rosterInFlight;
-        this.rosterInFlight = this.client
-            .canvasRoster()
-            .then((roster) => {
-            const index = { subscriptions: new Map(), subscribers: new Map() };
-            for (const edge of roster.edges) {
-                const subscription = { node_id: edge.to_id, active: edge.active, created: edge.created };
-                const subscriber = { node_id: edge.from_id, active: edge.active, created: edge.created };
-                const subscriptions = index.subscriptions.get(edge.from_id);
-                if (subscriptions === undefined)
-                    index.subscriptions.set(edge.from_id, [subscription]);
-                else
-                    subscriptions.push(subscription);
-                const subscribers = index.subscribers.get(edge.to_id);
-                if (subscribers === undefined)
-                    index.subscribers.set(edge.to_id, [subscriber]);
-                else
-                    subscribers.push(subscriber);
-            }
-            this.rosterCache = { at: Date.now(), index };
-            return index;
-        })
-            .finally(() => {
-            this.rosterInFlight = null;
-        });
-        return this.rosterInFlight;
-    }
-    /** Map a 404 from the API to the interface's `null` "not found" contract;
-     *  re-throw everything else. */
-    async orNull(fn) {
-        try {
-            return await fn();
-        }
-        catch (err) {
-            if (err instanceof ApiError && err.status === 404)
-                return null;
-            throw err;
-        }
-    }
-    async getNode(nodeId) {
-        const detail = await this.orNull(() => this.client.getNode(nodeId));
-        return detail === null ? null : withRowFault(detail);
-    }
-    async getRow(nodeId) {
-        const detail = await this.orNull(() => this.client.getNode(nodeId));
-        return detail === null ? null : withRowFault(detail);
-    }
-    async listNodes(filter) {
-        const status = filter?.status;
-        let rows;
-        if (Array.isArray(status)) {
-            // The list query takes a single status; fetch all + filter client-side to
-            // honor a multi-status filter without N round-trips.
-            const wanted = new Set(status);
-            const all = await this.client.listNodes();
-            rows = all.filter((r) => wanted.has(r.status));
-        }
-        else if (status !== undefined) {
-            rows = await this.client.listNodes({ status });
-        }
-        else {
-            rows = await this.client.listNodes();
-        }
-        return rows.map((row) => withRowFault(row));
-    }
-    async subscriptionsOf(subscriber) {
-        return this.roster().then((index) => index.subscriptions.get(subscriber) ?? []);
-    }
-    async subscribersOf(publisher) {
-        return this.roster().then((index) => index.subscribers.get(publisher) ?? []);
-    }
-    /** BFS over the active `subscribes_to` edges from `root` (its transitive view),
-     *  excluding `root` itself — the same traversal shape as
-     *  `RemoteCanvasSource.view`, expressed over the API's edge lists. */
-    async view(root) {
-        const seen = new Set([root]);
-        const out = [];
-        const queue = (await this.subscriptionsOf(root)).map((s) => s.node_id);
-        while (queue.length > 0) {
-            const id = queue.shift();
-            if (seen.has(id))
-                continue;
-            seen.add(id);
-            out.push(id);
-            for (const s of await this.subscriptionsOf(id)) {
-                if (!seen.has(s.node_id))
-                    queue.push(s.node_id);
-            }
-        }
-        return out;
-    }
-    /** Per-NODE open-ticket counts across `root`'s view. The renderer badges each
-     * node with the tickets it raised (the human bridge's parent), so this must
-     * be per-node. Request only this view's ids: using the
-     * enriched full-canvas snapshot for a five-second viewer poll blocked crtrd
-     * behind metadata and telemetry reads for every historical node. */
-    async ticketCountsForNodes(nodeIds) {
-        return (await this.client.attentionCounts([...nodeIds])).counts;
-    }
-    async ticketCountsForView(root) {
-        return this.ticketCountsForNodes([root, ...await this.view(root)]);
-    }
-    /** True when `nodeId` has at least one active (`active` edge flag, not just a
-     *  live subscriber) subscription to a node that is currently live
-     *  (`active`/`idle` status). `subscriptionsOf`'s roster-backed edges carry the
-     *  real per-edge `active` flag, so this filter is exact, not an over-report. */
-    async hasActiveLiveSubscription(nodeId) {
-        const subs = (await this.subscriptionsOf(nodeId)).filter((s) => s.active);
-        for (const s of subs) {
-            const row = await this.getRow(s.node_id);
-            if (row && (row.status === 'active' || row.status === 'idle'))
-                return true;
-        }
-        return false;
-    }
-}
-// cliCanvasSource — the source selector (mirrors resolveCanvasSource)
-/** The active read source for a CLI command. Mirrors `resolveCanvasSource`'s
- *  selection WITHOUT importing `core/canvas/source.ts` (which pulls
- *  `LocalCanvasSource` → `openDb`, failing the Stage-C import checker): an
- *  explicit `--canvas <name>` wins, else the durable `crtr canvas use` selection
- *  (`ScopeState.activeCanvas`), else the API-backed local source. The remote
- *  branch reuses the verified-openDb-free `RemoteCanvasSource` (plan Q-3). */
-export function cliCanvasSource(opts) {
-    const scope = opts?.scope ?? 'user';
-    const name = opts?.canvasName ?? readState(scope).activeCanvas ?? null;
-    if (!name)
-        return new ApiCanvasSource();
-    const { previewEndpoint, relayToken } = resolveRemoteCanvasTarget(name, scope);
-    return new RemoteCanvasSource(previewEndpoint, relayToken);
-}
+var p=Object.defineProperty;var c=(r,t)=>p(r,"name",{value:t,configurable:!0});import{closeSync as m,fstatSync as w,openSync as b,readSync as S}from"node:fs";import{join as g}from"node:path";import{CrtrClient as d,ApiError as u}from"../api/index.js";import{apiErrorToCliError as C}from"../core/io.js";import{autostartDisabled as _,ensureDaemon as y}from"../daemon/manage.js";import{DAEMON_STARTUP_WINDOW_MS as N}from"../daemon/startup-policy.js";import{readState as v}from"../core/config.js";import{resolveRemoteCanvasTarget as T}from"../core/remote-canvas-target.js";import{RemoteCanvasSource as A}from"../core/canvas/remote-canvas-source.js";import{crtrHome as I}from"../core/canvas/paths.js";function l(r){return{...r,fault:r.fault??null}}c(l,"withRowFault");function M(r,t){throw r instanceof u?C(r,t):r}c(M,"rethrowAsCliError");async function U(r){try{return await h().getNode(r)}catch(t){if(t instanceof u&&t.status===404)return null;M(t)}}c(U,"getNodeOrNull");const O=4096,D=20;function R(){let r;try{r=b(g(I(),"crtrd.log"),"r");const{size:t}=w(r),e=Math.max(0,t-O),n=t-e;if(n<=0)return;const s=Buffer.alloc(n);S(r,s,0,n,e);const o=s.toString("utf8").split(`
+`).filter(a=>a.trim()!=="").slice(-D).join(`
+`).trim();return o===""?void 0:`crtrd.log (tail):
+${o}`}catch{return}finally{if(r!==void 0)try{m(r)}catch{}}}c(R,"readColdStartDiagnostic");function h(r){return _()?d.forLocalSocket({autostart:!1,...r?.timeoutMs!==void 0?{timeoutMs:r.timeoutMs}:{}}):d.forLocalSocket({...r?.timeoutMs!==void 0?{timeoutMs:r.timeoutMs}:{},onColdSocket:c(async()=>{y()},"onColdSocket"),coldStartDiagnostic:R,coldStartPollWindowMs:N})}c(h,"cliClient");const x=2e3;class E{static{c(this,"ApiCanvasSource")}client;rosterCache=null;rosterInFlight=null;constructor(t=h()){this.client=t}async roster(){const t=Date.now();return this.rosterCache!==null&&t-this.rosterCache.at<x?this.rosterCache.index:this.rosterInFlight!==null?this.rosterInFlight:(this.rosterInFlight=this.client.canvasRoster().then(e=>{const n={subscriptions:new Map,subscribers:new Map};for(const s of e.edges){const i={node_id:s.to_id,active:s.active,created:s.created},o={node_id:s.from_id,active:s.active,created:s.created},a=n.subscriptions.get(s.from_id);a===void 0?n.subscriptions.set(s.from_id,[i]):a.push(i);const f=n.subscribers.get(s.to_id);f===void 0?n.subscribers.set(s.to_id,[o]):f.push(o)}return this.rosterCache={at:Date.now(),index:n},n}).finally(()=>{this.rosterInFlight=null}),this.rosterInFlight)}async orNull(t){try{return await t()}catch(e){if(e instanceof u&&e.status===404)return null;throw e}}async getNode(t){const e=await this.orNull(()=>this.client.getNode(t));return e===null?null:l(e)}async getRow(t){const e=await this.orNull(()=>this.client.getNode(t));return e===null?null:l(e)}async listNodes(t){const e=t?.status;let n;if(Array.isArray(e)){const s=new Set(e);n=(await this.client.listNodes()).filter(o=>s.has(o.status))}else e!==void 0?n=await this.client.listNodes({status:e}):n=await this.client.listNodes();return n.map(s=>l(s))}async subscriptionsOf(t){return this.roster().then(e=>e.subscriptions.get(t)??[])}async subscribersOf(t){return this.roster().then(e=>e.subscribers.get(t)??[])}async view(t){const e=new Set([t]),n=[],s=(await this.subscriptionsOf(t)).map(i=>i.node_id);for(;s.length>0;){const i=s.shift();if(!e.has(i)){e.add(i),n.push(i);for(const o of await this.subscriptionsOf(i))e.has(o.node_id)||s.push(o.node_id)}}return n}async ticketCountsForNodes(t){return(await this.client.attentionCounts([...t])).counts}async ticketCountsForView(t){return this.ticketCountsForNodes([t,...await this.view(t)])}async hasActiveLiveSubscription(t){const e=(await this.subscriptionsOf(t)).filter(n=>n.active);for(const n of e){const s=await this.getRow(n.node_id);if(s&&(s.status==="active"||s.status==="idle"))return!0}return!1}}function V(r){const t=r?.scope??"user",e=r?.canvasName??v(t).activeCanvas??null;if(!e)return new E;const{previewEndpoint:n,relayToken:s}=T(e,t);return new A(n,s)}c(V,"cliCanvasSource");export{E as ApiCanvasSource,O as COLD_START_DIAGNOSTIC_TAIL_BYTES,V as cliCanvasSource,h as cliClient,U as getNodeOrNull,R as readColdStartDiagnostic,M as rethrowAsCliError};

package/dist/commands/attention.js

@@ -1,215 +1 @@
-// `crtr canvas attention` — aggregate pending human tickets across the canvas.
-//
-// A pending "ticket" is any humanloop interaction awaiting the user: a page or
-// an anchored review. Each lives in its human bridge node
-// directory and is attributed through that bridge's parent relation. This
-// subtree surfaces a direct node projection; cwd is display metadata only.
-//
-// Exported as a branch; `crtr canvas` (canvas.ts) mounts it.
-import { defineBranch, defineLeaf } from '../core/command.js';
-import { InputError } from '../core/io.js';
-import { cliClient, cliCanvasSource } from './api-client.js';
-/** The nodes represented in the sub-DAG rooted at `viewId` (root + view). */
-async function viewNodeSet(source, viewId) {
-    return new Set([viewId, ...(await source.view(viewId))]);
-}
-// attention count
-const attentionCount = defineLeaf({
-    name: 'count',
-    description: 'total pending human-ticket count (machine-parseable stdout.count)',
-    whenToUse: 'a lightweight summary when you just need the number, not which cwds are blocked — scope it to a node or a sub-DAG, or default to canvas-wide. Use `list` when you need to act on where to go answer.',
-    help: {
-        name: 'canvas attention count',
-        // stdout.count is parsed directly by the nav chrome — keep the contract.
-        summary: 'return the number of pending human tickets (asks, reviews, notifications); stdout.count is machine-parseable',
-        params: [
-            {
-                kind: 'flag',
-                name: 'node',
-                type: 'string',
-                required: false,
-                constraint: 'Count tickets asked by this node. Mutually exclusive with --view.',
-            },
-            {
-                kind: 'flag',
-                name: 'view',
-                type: 'string',
-                required: false,
-                constraint: 'Sum tickets for all nodes in the sub-DAG rooted at this id. Mutually exclusive with --node.',
-            },
-        ],
-        output: [
-            { name: 'count', type: 'integer', required: true, constraint: 'Total pending human tickets in the requested scope.' },
-        ],
-        outputKind: 'object',
-        effects: ['Read-only: scans humanloop interaction dirs.'],
-    },
-    run: async (input) => {
-        const nodeId = input['node'];
-        const viewId = input['view'];
-        if (nodeId !== undefined && viewId !== undefined) {
-            throw new InputError({
-                error: 'ambiguous_scope',
-                message: '--node and --view are mutually exclusive',
-                next: 'Use one of --node <id>, --view <id>, or neither (canvas-wide).',
-            });
-        }
-        if (nodeId !== undefined) {
-            const source = cliCanvasSource();
-            const node = await source.getNode(nodeId);
-            if (node === null) {
-                throw new InputError({
-                    error: 'not_found',
-                    message: `no node: ${nodeId}`,
-                    next: 'List nodes with `crtr node inspect list`.',
-                });
-            }
-            const counts = await cliClient().attentionCounts([nodeId]);
-            return { count: counts.counts[nodeId] ?? 0 };
-        }
-        const items = (await cliClient().attention()).items;
-        if (viewId !== undefined) {
-            const source = cliCanvasSource();
-            if ((await source.getNode(viewId)) === null) {
-                throw new InputError({
-                    error: 'not_found',
-                    message: `no node: ${viewId}`,
-                    next: 'List nodes with `crtr node inspect list`.',
-                });
-            }
-            const ids = await viewNodeSet(source, viewId);
-            const total = items.filter((it) => ids.has(it.node_id)).reduce((s, e) => s + e.count, 0);
-            return { count: total };
-        }
-        // Canvas-wide — sum every asking-node entry.
-        return { count: items.reduce((s, e) => s + e.count, 0) };
-    },
-});
-// attention list
-const attentionList = defineLeaf({
-    name: 'list',
-    description: 'itemised list of cwds with pending human tickets',
-    whenToUse: 'finding which agents are blocked waiting on the user — an itemised list of the cwds with pending tickets (asks, reviews, notifications), oldest first, so you know where to go answer. Scope it to a sub-DAG or list canvas-wide. Use `canvas attention count` instead when you just need the number.',
-    help: {
-        name: 'canvas attention list',
-        summary: 'list nodes that asked pending human tickets',
-        params: [
-            {
-                kind: 'flag',
-                name: 'view',
-                type: 'string',
-                required: false,
-                constraint: 'Scope the list to the sub-DAG rooted at this node id. Omit for canvas-wide.',
-            },
-        ],
-        output: [
-            {
-                name: 'items',
-                type: 'object[]',
-                required: true,
-                constraint: 'Each: {node_id, name, cwd, count}. One entry per asking node with count > 0.',
-            },
-            { name: 'total', type: 'integer', required: true, constraint: 'Sum of counts across all entries.' },
-        ],
-        outputKind: 'object',
-        effects: ['Read-only: scans humanloop interaction dirs.'],
-    },
-    run: async (input) => {
-        const viewId = input['view'];
-        let items = (await cliClient().attention()).items;
-        if (viewId !== undefined) {
-            const source = cliCanvasSource();
-            if ((await source.getNode(viewId)) === null) {
-                throw new InputError({
-                    error: 'not_found',
-                    message: `no node: ${viewId}`,
-                    next: 'List nodes with `crtr node inspect list`.',
-                });
-            }
-            const ids = await viewNodeSet(source, viewId);
-            items = items.filter((it) => ids.has(it.node_id));
-        }
-        const total = items.reduce((s, e) => s + e.count, 0);
-        return { items, total };
-    },
-});
-// attention map
-const attentionMap = defineLeaf({
-    name: 'map',
-    description: 'per-node ticket counts for a visible set, batched in one pass',
-    whenToUse: 'labelling every node in a UI with its pending-ticket count in one batched pass — the form nav chrome polls (one process, one JSON blob) instead of N count shell-outs',
-    tier: 'hidden',
-    help: {
-        name: 'canvas attention map',
-        summary: 'per-node pending human-ticket counts for a visible set of nodes in ONE pass — the batched form the nav chrome polls (one process, one JSON blob) instead of N count shell-outs',
-        params: [
-            {
-                kind: 'flag',
-                name: 'view',
-                type: 'string',
-                required: false,
-                constraint: 'Include this node and its whole sub-DAG (root + reports recursively). Union with --nodes. At least one of --view/--nodes is required.',
-            },
-            {
-                kind: 'flag',
-                name: 'nodes',
-                type: 'string',
-                required: false,
-                constraint: 'Comma-separated explicit node ids to include (e.g. ancestry + peers). Union with --view.',
-            },
-        ],
-        output: [
-            {
-                name: 'counts',
-                type: 'object',
-                required: true,
-                constraint: 'Map of node_id → pending human-ticket count. Every requested id is present (0 when none).',
-            },
-        ],
-        outputKind: 'object',
-        effects: ['Read-only: scans the registered humanloop node root once.'],
-    },
-    run: async (input) => {
-        const viewId = input['view'];
-        const nodesRaw = input['nodes'];
-        if (viewId === undefined && (nodesRaw === undefined || nodesRaw.trim() === '')) {
-            throw new InputError({
-                error: 'missing_scope',
-                message: 'at least one of --view <id> or --nodes <a,b,c> is required',
-                next: 'Pass --view <root> to cover a sub-DAG, --nodes <a,b,c> for an explicit set, or both.',
-            });
-        }
-        const source = cliCanvasSource();
-        const ids = new Set();
-        if (viewId !== undefined) {
-            if ((await source.getNode(viewId)) === null) {
-                throw new InputError({
-                    error: 'not_found',
-                    message: `no node: ${viewId}`,
-                    next: 'List nodes with `crtr node inspect list`.',
-                });
-            }
-            ids.add(viewId);
-            for (const id of await source.view(viewId))
-                ids.add(id);
-        }
-        if (nodesRaw !== undefined) {
-            for (const id of nodesRaw.split(',').map((s) => s.trim()).filter((s) => s !== ''))
-                ids.add(id);
-        }
-        const counts = await cliClient().attentionCounts([...ids]);
-        return { counts: counts.counts };
-    },
-});
-// Export — mounted under `crtr canvas`
-export const attentionBranch = defineBranch({
-    name: 'attention',
-    description: 'count/list pending human tickets across the graph',
-    whenToUse: 'checking whether any agent on the canvas is blocked waiting on the user, and where: count the pending tickets (asks, reviews, notifications) or list the cwds that have them. Scope it to a node or a sub-DAG, or go canvas-wide. Use `canvas dashboard` instead for the graph SHAPE, or `node inspect list` for a plain node roster',
-    help: {
-        name: 'canvas attention',
-        summary: 'aggregate pending human tickets across the canvas',
-        model: '`count` returns a single integer (stdout.count is machine-parseable) and accepts --node or --view; `list` returns itemised asking-node entries and accepts --view only. Both default to canvas-wide. A ticket is any humanloop interaction awaiting the user: an ask, a review, or a notification.',
-    },
-    children: [attentionCount, attentionList, attentionMap],
-});
+var p=Object.defineProperty;var c=(o,e)=>p(o,"name",{value:e,configurable:!0});import{defineBranch as f,defineLeaf as h}from"../core/command.js";import{InputError as d}from"../core/io.js";import{cliClient as u,cliCanvasSource as l}from"./api-client.js";async function w(o,e){return new Set([e,...await o.view(e)])}c(w,"viewNodeSet");const g=h({name:"count",description:"total pending human-ticket count (machine-parseable stdout.count)",whenToUse:"a lightweight summary when you just need the number, not which cwds are blocked \u2014 scope it to a node or a sub-DAG, or default to canvas-wide. Use `list` when you need to act on where to go answer.",help:{name:"canvas attention count",summary:"return the number of pending human tickets (asks, reviews, notifications); stdout.count is machine-parseable",params:[{kind:"flag",name:"node",type:"string",required:!1,constraint:"Count tickets asked by this node. Mutually exclusive with --view."},{kind:"flag",name:"view",type:"string",required:!1,constraint:"Sum tickets for all nodes in the sub-DAG rooted at this id. Mutually exclusive with --node."}],output:[{name:"count",type:"integer",required:!0,constraint:"Total pending human tickets in the requested scope."}],outputKind:"object",effects:["Read-only: scans humanloop interaction dirs."]},run:c(async o=>{const e=o.node,t=o.view;if(e!==void 0&&t!==void 0)throw new d({error:"ambiguous_scope",message:"--node and --view are mutually exclusive",next:"Use one of --node <id>, --view <id>, or neither (canvas-wide)."});if(e!==void 0){if(await l().getNode(e)===null)throw new d({error:"not_found",message:`no node: ${e}`,next:"List nodes with `crtr node inspect list`."});return{count:(await u().attentionCounts([e])).counts[e]??0}}const s=(await u().attention()).items;if(t!==void 0){const n=l();if(await n.getNode(t)===null)throw new d({error:"not_found",message:`no node: ${t}`,next:"List nodes with `crtr node inspect list`."});const i=await w(n,t);return{count:s.filter(r=>i.has(r.node_id)).reduce((r,m)=>r+m.count,0)}}return{count:s.reduce((n,i)=>n+i.count,0)}},"run")}),v=h({name:"list",description:"itemised list of cwds with pending human tickets",whenToUse:"finding which agents are blocked waiting on the user \u2014 an itemised list of the cwds with pending tickets (asks, reviews, notifications), oldest first, so you know where to go answer. Scope it to a sub-DAG or list canvas-wide. Use `canvas attention count` instead when you just need the number.",help:{name:"canvas attention list",summary:"list nodes that asked pending human tickets",params:[{kind:"flag",name:"view",type:"string",required:!1,constraint:"Scope the list to the sub-DAG rooted at this node id. Omit for canvas-wide."}],output:[{name:"items",type:"object[]",required:!0,constraint:"Each: {node_id, name, cwd, count}. One entry per asking node with count > 0."},{name:"total",type:"integer",required:!0,constraint:"Sum of counts across all entries."}],outputKind:"object",effects:["Read-only: scans humanloop interaction dirs."]},run:c(async o=>{const e=o.view;let t=(await u().attention()).items;if(e!==void 0){const n=l();if(await n.getNode(e)===null)throw new d({error:"not_found",message:`no node: ${e}`,next:"List nodes with `crtr node inspect list`."});const i=await w(n,e);t=t.filter(a=>i.has(a.node_id))}const s=t.reduce((n,i)=>n+i.count,0);return{items:t,total:s}},"run")}),b=h({name:"map",description:"per-node ticket counts for a visible set, batched in one pass",whenToUse:"labelling every node in a UI with its pending-ticket count in one batched pass \u2014 the form nav chrome polls (one process, one JSON blob) instead of N count shell-outs",tier:"hidden",help:{name:"canvas attention map",summary:"per-node pending human-ticket counts for a visible set of nodes in ONE pass \u2014 the batched form the nav chrome polls (one process, one JSON blob) instead of N count shell-outs",params:[{kind:"flag",name:"view",type:"string",required:!1,constraint:"Include this node and its whole sub-DAG (root + reports recursively). Union with --nodes. At least one of --view/--nodes is required."},{kind:"flag",name:"nodes",type:"string",required:!1,constraint:"Comma-separated explicit node ids to include (e.g. ancestry + peers). Union with --view."}],output:[{name:"counts",type:"object",required:!0,constraint:"Map of node_id \u2192 pending human-ticket count. Every requested id is present (0 when none)."}],outputKind:"object",effects:["Read-only: scans the registered humanloop node root once."]},run:c(async o=>{const e=o.view,t=o.nodes;if(e===void 0&&(t===void 0||t.trim()===""))throw new d({error:"missing_scope",message:"at least one of --view <id> or --nodes <a,b,c> is required",next:"Pass --view <root> to cover a sub-DAG, --nodes <a,b,c> for an explicit set, or both."});const s=l(),n=new Set;if(e!==void 0){if(await s.getNode(e)===null)throw new d({error:"not_found",message:`no node: ${e}`,next:"List nodes with `crtr node inspect list`."});n.add(e);for(const a of await s.view(e))n.add(a)}if(t!==void 0)for(const a of t.split(",").map(r=>r.trim()).filter(r=>r!==""))n.add(a);return{counts:(await u().attentionCounts([...n])).counts}},"run")}),S=f({name:"attention",description:"count/list pending human tickets across the graph",whenToUse:"checking whether any agent on the canvas is blocked waiting on the user, and where: count the pending tickets (asks, reviews, notifications) or list the cwds that have them. Scope it to a node or a sub-DAG, or go canvas-wide. Use `canvas dashboard` instead for the graph SHAPE, or `node inspect list` for a plain node roster",help:{name:"canvas attention",summary:"aggregate pending human tickets across the canvas",model:"`count` returns a single integer (stdout.count is machine-parseable) and accepts --node or --view; `list` returns itemised asking-node entries and accepts --view only. Both default to canvas-wide. A ticket is any humanloop interaction awaiting the user: an ask, a review, or a notification."},children:[g,v,b]});export{S as attentionBranch};