@north-light/cli 0.0.0 → 0.3.413

package/dist/core/human-actions.d.ts

@@ -0,0 +1,25 @@
+export interface ResolvedHumanAction {
+    name: string;
+    /** Absolute path of the config file that won resolution. */
+    configOrigin: string;
+    /** Fully resolved argv; argv[0] is an absolute executable path. */
+    argv: string[];
+    /** Fully resolved absolute working directory. */
+    cwd: string;
+}
+export type HumanActionIssue = {
+    kind: 'unknown_action';
+    name: string;
+} | {
+    kind: 'invalid_action';
+    name: string;
+    configOrigin: string;
+    reason: string;
+    block?: true;
+};
+/** Resolve one declared action from a creator's absolute cwd: nearest project
+ * ancestor first, then farther project ancestors, then user scope. Never
+ * consults plugin or profile config. Read-only; never executes anything. */
+export declare function resolveHumanAction(name: string, creatorCwd: string): ResolvedHumanAction | HumanActionIssue;
+/** Every declared action reachable from a cwd, with its issues, for doctor. */
+export declare function inspectHumanActions(creatorCwd: string): Array<ResolvedHumanAction | HumanActionIssue>;

package/dist/core/human-actions.js

@@ -0,0 +1 @@
+var v=Object.defineProperty;var e=(i,o)=>v(i,"name",{value:o,configurable:!0});import{statSync as a}from"node:fs";import{dirname as h,join as f,resolve as g}from"node:path";import{CONFIG_FILE as u}from"../types.js";import{humanActionDeclarationIssues as d,readRawConfigAtRoot as l}from"./config.js";import{findProjectScopeRoots as k,scopeRoot as m}from"./scope.js";function O(i){const o=[];for(const r of k(i,null)){const c=l(r)?.humanActions;c!==void 0&&o.push({configOrigin:f(r,u),authoringRoot:h(r),raw:c})}const n=m("user");if(n!==null){const r=l(n)?.humanActions;r!==void 0&&o.push({configOrigin:f(n,u),authoringRoot:n,raw:r})}return o}e(O,"actionContributors");function y(i,o){return d({[i]:o}).find(n=>n.name===i)?.reason}e(y,"declarationIssue");function w(i,o,n){const r=g(n.authoringRoot,o.cwd);try{if(!a(r).isDirectory())return{kind:"invalid_action",name:i,configOrigin:n.configOrigin,reason:`cwd is not a directory: ${r}`}}catch{return{kind:"invalid_action",name:i,configOrigin:n.configOrigin,reason:`cwd does not exist: ${r}`}}const c=g(n.authoringRoot,o.argv[0]);try{const t=a(c);if(!t.isFile())return{kind:"invalid_action",name:i,configOrigin:n.configOrigin,reason:`argv[0] is not a regular file: ${c}`};if((t.mode&73)===0)return{kind:"invalid_action",name:i,configOrigin:n.configOrigin,reason:`argv[0] lacks the POSIX exec bit: ${c}`}}catch{return{kind:"invalid_action",name:i,configOrigin:n.configOrigin,reason:`argv[0] does not exist: ${c}`}}return{name:i,configOrigin:n.configOrigin,argv:[c,...o.argv.slice(1)],cwd:r}}e(w,"resolveDeclaredAction");function I(i,o){for(const n of O(o)){if(n.raw===null||typeof n.raw!="object"||Array.isArray(n.raw))continue;const r=n.raw;if(!Object.hasOwn(r,i))continue;const c=r[i],t=y(i,c);return t!==void 0?{kind:"invalid_action",name:i,configOrigin:n.configOrigin,reason:t}:w(i,c,n)}return{kind:"unknown_action",name:i}}e(I,"resolveHumanAction");function $(i){const o=[];for(const n of O(i)){const r=d(n.raw),c=new Map(r.map(t=>[t.name,t.reason]));if(n.raw===null||typeof n.raw!="object"||Array.isArray(n.raw)){for(const t of r)o.push({kind:"invalid_action",name:t.name,configOrigin:n.configOrigin,reason:t.reason,...t.block===!0?{block:!0}:{}});continue}for(const[t,p]of Object.entries(n.raw)){const s=c.get(t);if(s!==void 0){o.push({kind:"invalid_action",name:t,configOrigin:n.configOrigin,reason:s});continue}o.push(w(t,p,n))}}return o}e($,"inspectHumanActions");export{$ as inspectHumanActions,I as resolveHumanAction};

package/dist/core/inspector/chrome.d.ts

@@ -0,0 +1,6 @@
+import type { ChromeState } from './contract.js';
+export type ChipState = 'working' | 'blocked' | 'attention' | 'ready' | 'idle';
+/** Derive the Inspector state chip from its current host signals. */
+export declare function deriveState(c: ChromeState): ChipState;
+/** A fresh Inspector chrome record. */
+export declare function initialChrome(): ChromeState;

package/dist/core/inspector/chrome.js

@@ -0,0 +1 @@
+var l=Object.defineProperty;var n=(e,r)=>l(e,"name",{value:r,configurable:!0});function u(e){return e.busy?"working":e.banner?.level==="error"?"blocked":e.banner?.level==="action"?"attention":e.loaded?"ready":"idle"}n(u,"deriveState");function a(){return{status:null,banner:null,subtitle:null,mode:null,busy:!1,loaded:!1,lastRefresh:0}}n(a,"initialChrome");export{u as deriveState,a as initialChrome};

package/dist/core/inspector/contract.d.ts

@@ -0,0 +1,105 @@
+import type { Draw, Rect } from '../tui/draw.js';
+import type { BindingId } from '../keybindings/index.js';
+export type BannerLevel = 'info' | 'action' | 'error';
+export interface Banner {
+    msg: string;
+    level: BannerLevel;
+}
+export interface DumpContext {
+    banner: Banner | null;
+}
+export interface HostSignals {
+    setStatus(msg: string | null): void;
+    setBanner(msg: string, level: BannerLevel): void;
+    clearBanner(): void;
+    setSubtitle(subtitle: string | null): void;
+    setMode(mode: string | null): void;
+    quit(): void;
+}
+export interface ChromeState {
+    status: string | null;
+    banner: Banner | null;
+    subtitle: string | null;
+    mode: string | null;
+    busy: boolean;
+    loaded: boolean;
+    lastRefresh: number;
+}
+export interface SourceRequest {
+    kind: 'exec';
+    bin: string;
+    args: string[];
+    cwd?: string;
+    stdin?: string;
+}
+export interface RawResponse {
+    ok: boolean;
+    exitCode?: number;
+    stdout: string;
+    stderr: string;
+}
+export interface SourceError {
+    kind: string;
+    display: {
+        headline: string;
+        explanation: string;
+        nextStep: string;
+        level: BannerLevel;
+        blocking: boolean;
+    };
+}
+export type Result<T> = {
+    ok: true;
+    data: T;
+} | {
+    ok: false;
+    error: SourceError;
+};
+export interface Source<T, A = void> {
+    id: string;
+    request(args: A): SourceRequest;
+    parse(raw: RawResponse): Result<T>;
+}
+export interface Command<T, A = void> {
+    id: string;
+    request(args: A): SourceRequest;
+    parse(raw: RawResponse): Result<T>;
+}
+export interface IntentCtx<S> {
+    readonly state: S;
+    set(next: S | ((previous: S) => S)): void;
+    resolve<T, A>(source: Source<T, A>, args?: A): Promise<Result<T>>;
+    execute<T, A>(command: Command<T, A>, args?: A): Promise<Result<T>>;
+    signal: HostSignals;
+    dispatch(intent: string, payload?: unknown): Promise<void>;
+}
+export type Intent<S, P = void> = (ctx: IntentCtx<S>, payload: P) => void | Promise<void>;
+export interface InspectorCore<S> {
+    manifest: {
+        title: string;
+        subtitle?: string;
+        refreshMs?: number;
+    };
+    init(options: Readonly<Record<string, string>>): S;
+    intents: Record<string, Intent<S, any>>;
+}
+export interface KeyHint {
+    keys: string;
+    label: string;
+}
+export interface InspectorKeyBinding<S> {
+    bindingId: BindingId;
+    intent: string;
+    payload?: (state: S) => unknown;
+    when?: (state: S) => boolean;
+    hint?: {
+        label: string;
+    };
+}
+export interface InspectorTui<S> {
+    render(state: S, draw: Draw, content: Rect): void;
+    keymap: InspectorKeyBinding<S>[];
+}
+export interface InspectorText<S> {
+    dump(state: S, context?: DumpContext): string;
+}

package/dist/core/inspector/core.d.ts

@@ -0,0 +1,39 @@
+import type { CronDTO } from '../../api/dto/crons.js';
+import type { InspectorCore, SourceError } from './contract.js';
+import { scheduledItems, type BashJobRow, type InspectorSection } from './model.js';
+/** What a `y` confirmation will act on. The pending action carries its own kind
+ *  so a section change cannot change the armed operation. */
+export type PendingAction = {
+    kind: 'cron' | 'job';
+    id: string;
+    label: string;
+};
+export interface InspectorState {
+    target: string;
+    section: InspectorSection;
+    dossier: {
+        data: Record<string, unknown> | null;
+        error: SourceError | null;
+        fetchedAt: number;
+    };
+    schedule: {
+        data: CronDTO[] | null;
+        error: SourceError | null;
+        fetchedAt: number;
+    };
+    jobs: {
+        data: BashJobRow[] | null;
+        error: SourceError | null;
+        fetchedAt: number;
+    };
+    selectedCronId: string | null;
+    selectedJobId: string | null;
+    expanded: boolean;
+    pendingCancel: PendingAction | null;
+    scroll: Record<InspectorSection, number>;
+    /** Opened with `--read-only`: the keymap offers no cron cancel or job stop. */
+    readOnly: boolean;
+}
+export declare const inspectorCore: InspectorCore<InspectorState>;
+export declare function selectedJob(state: InspectorState): BashJobRow | undefined;
+export { scheduledItems };

package/dist/core/inspector/core.js

@@ -0,0 +1,2 @@
+var C=Object.defineProperty;var s=(e,n)=>C(e,"name",{value:n,configurable:!0});import{record as I,scheduledItems as i}from"./model.js";function c(e,n,r,o){return{kind:e,display:{headline:n,explanation:r,nextStep:"Press g to retry.",level:"error",blocking:o}}}s(c,"error");function u(e,n,r){if(!e.ok)return{ok:!1,error:c("unavailable","Inspector unavailable",`Could not run crtr: ${e.stderr||"command not found"}`,r)};if(e.exitCode!==0)return{ok:!1,error:c("failed",r?"Node is gone":"Schedule unavailable",e.stderr||e.stdout||`crtr ${n} failed`,r)};try{const o=JSON.parse(e.stdout);if(o===null||typeof o!="object"||Array.isArray(o))throw new Error("not an object");return{ok:!0,data:o}}catch{return{ok:!1,error:c("parse","Inspector unavailable",`Could not parse crtr ${n} JSON.`,r)}}}s(u,"parseJson");const k={id:"dossier",request:s(e=>({kind:"exec",bin:"crtr",args:["--json","node","inspect","show",e]}),"request"),parse:s(e=>u(e,"node inspect show",!0),"parse")},w={id:"schedule",request:s(()=>({kind:"exec",bin:"crtr",args:["--json","cron","list"]}),"request"),parse:s(e=>{const n=u(e,"cron list",!1);if(!n.ok)return n;const r=n.data.crons;return Array.isArray(r)?{ok:!0,data:r}:{ok:!1,error:c("parse","Schedule unavailable","The cron list did not contain cron rows.",!1)}},"parse")},y=14,S={id:"jobs",request:s(e=>({kind:"exec",bin:"crtr",args:["--json","node","bash","list","--node",e,"--tail",String(y)]}),"request"),parse:s(e=>{const n=u(e,"node bash list",!1);if(!n.ok)return n;const r=n.data.jobs;return Array.isArray(r)?{ok:!0,data:r}:{ok:!1,error:c("parse","Jobs unavailable","The job list did not contain job rows.",!1)}},"parse")},_={id:"cancel",request:s(e=>({kind:"exec",bin:"crtr",args:["--json","cron","cancel",e]}),"request"),parse:s(e=>{const n=u(e,"cron cancel",!1);return n.ok?{ok:!0,data:{canceled:String(n.data.canceled??"")}}:n},"parse")},v={id:"kill-job",request:s(({target:e,job:n})=>({kind:"exec",bin:"crtr",args:["--json","node","bash","kill",n,"--node",e]}),"request"),parse:s(e=>{const n=u(e,"node bash kill",!1);return n.ok?{ok:!0,data:{job:String(n.data.job_id??"")}}:n},"parse")},$={id:"open-log",request:s(({path:e,title:n})=>({kind:"exec",bin:"tmux",args:["new-window","-n",n,`less +F -- ${h(e)} 2>/dev/null || tail -f -- ${h(e)}`]}),"request"),parse:s(e=>!e.ok||(e.exitCode??0)!==0?{ok:!1,error:c("no_tmux","Could not open the log",e.stderr||"tmux new-window failed \u2014 the Inspector must be running inside tmux.",!1)}:{ok:!0,data:{}},"parse")};function h(e){return`'${e.split("'").join("'\\''")}'`}s(h,"quote");const b=["overview","schedule","jobs","raw"];function J(e){return e==="schedule"||e==="jobs"||e==="raw"?e:"overview"}s(J,"section");function g(e){const n=`${i(e.schedule.data??[]).length} cron(s) armed`,r=`${(e.jobs.data??[]).length} background job(s) running`;return e.section==="schedule"?n:e.section==="jobs"?r:`${n} \xB7 ${r}`}s(g,"countsFor");function A(e,n){const r=i(n),o=e.selectedCronId;if(o!==null&&r.some(t=>t.cron.cron_id===o))return{...e,schedule:{data:n,error:null,fetchedAt:Date.now()}};const l=i(e.schedule.data??[]).findIndex(t=>t.cron.cron_id===o),a=r[Math.min(Math.max(0,l),Math.max(0,r.length-1))];return{...e,schedule:{data:n,error:null,fetchedAt:Date.now()},selectedCronId:a?.cron.cron_id??null,expanded:!1,pendingCancel:null}}s(A,"reconcile");const D={manifest:{title:"Inspector",refreshMs:5e3},init(e){return{target:e.target??"",section:J(e.section),dossier:{data:null,error:null,fetchedAt:0},schedule:{data:null,error:null,fetchedAt:0},jobs:{data:null,error:null,fetchedAt:0},selectedCronId:null,selectedJobId:null,expanded:!1,pendingCancel:null,scroll:{overview:0,schedule:0,jobs:0,raw:0},readOnly:e.readOnly==="true"}},intents:{async refresh(e){e.signal.setStatus("Refreshing\u2026");let n;const[r,o,l]=await Promise.all([e.resolve(k,e.state.target),e.resolve(w,e.state.target),e.resolve(S,e.state.target)]);if(!r.ok){e.set(t=>({...t,dossier:{...t.dossier,error:r.error}})),e.signal.setBanner(`${r.error.display.headline}: ${r.error.display.explanation}`,"error"),e.signal.setStatus(null);return}if(e.set(t=>({...t,dossier:{data:r.data,error:null,fetchedAt:Date.now()}})),!o.ok)e.set(t=>({...t,schedule:{...t.schedule,error:o.error}})),e.signal.setBanner(o.error.display.explanation,"error");else{const t=e.state.selectedCronId;e.set(d=>A(d,o.data)),t!==null&&!o.data.some(d=>d.cron_id===t)&&(n="Selected cron disappeared; moved to the next item."),e.state.schedule.error!==null&&e.signal.clearBanner()}if(!l.ok)e.set(t=>({...t,jobs:{...t.jobs,error:l.error}}));else{const t=e.state.selectedJobId!==null&&!l.data.some(d=>d.job_id===e.state.selectedJobId);e.set(d=>B(d,l.data)),t&&(n="The selected job finished; moved to the next one.")}e.signal.setStatus(n??g(e.state));const a=I(e.state.dossier.data?.node);e.signal.setSubtitle(`${a.name??e.state.target} \xB7 ${e.state.section}`)},sectionNext(e){const n=b,r=n[(n.indexOf(e.state.section)+1)%n.length];e.set(o=>({...o,section:r,pendingCancel:null})),e.signal.clearBanner(),e.signal.setStatus(g(e.state)),e.signal.setSubtitle(`${e.state.target} \xB7 ${r}`)},sectionPrev(e){const n=b,r=n[(n.indexOf(e.state.section)+n.length-1)%n.length];e.set(o=>({...o,section:r,pendingCancel:null})),e.signal.clearBanner(),e.signal.setStatus(g(e.state)),e.signal.setSubtitle(`${e.state.target} \xB7 ${r}`)},down(e){e.set(n=>m(n,1))},up(e){e.set(n=>m(n,-1))},pageDown(e){e.set(n=>({...n,scroll:{...n.scroll,[n.section]:n.scroll[n.section]+8}}))},pageUp(e){e.set(n=>({...n,scroll:{...n.scroll,[n.section]:Math.max(0,n.scroll[n.section]-8)}}))},toggleDetail(e){(e.state.section==="jobs"?e.state.selectedJobId!==null:e.state.selectedCronId!==null)&&e.set(n=>({...n,expanded:!n.expanded}))},cancelItem(e){const n=e.state.section==="jobs"?f(e.state)&&{kind:"job",id:f(e.state).job_id,label:p(f(e.state).command)}:e.state.selectedCronId!==null&&{kind:"cron",id:e.state.selectedCronId,label:e.state.selectedCronId};if(n){if(n.kind==="job"&&f(e.state)?.pgid===null){e.signal.setBanner("This job predates recorded process groups \u2014 crtr cannot stop it. Open its log and stop it by hand.","error");return}e.set(r=>({...r,pendingCancel:n})),e.signal.setBanner(n.kind==="job"?`Stop job \u201C${n.label}\u201D? It dies now and the node is told. Press y to confirm.`:`Cancel cron ${n.label}? Press y to confirm.`,"action")}},async openLog(e){const n=f(e.state);if(n===void 0)return;e.signal.setStatus("Opening the job log\u2026");const r=await e.execute($,{path:n.log_path,title:`job \xB7 ${p(n.command,18)}`});if(!r.ok){e.signal.setBanner(r.error.display.explanation,"error");return}e.signal.setBanner("Log opened in a new tmux window, following live. Quit the Inspector to read it.","info")},async confirm(e){const n=e.state.pendingCancel;if(n===null)return;if(n.kind==="job"){e.signal.setStatus("Stopping the job\u2026");const l=await e.execute(v,{target:e.state.target,job:n.id});if(e.set(t=>({...t,pendingCancel:null})),!l.ok){e.signal.setBanner(l.error.display.explanation,"error");return}await e.dispatch("refresh");const a=(e.state.jobs.data??[]).some(t=>t.job_id===n.id);e.signal.setBanner(a?"The job is still running; refresh and retry.":"Job stopped \u2014 the node was told it was canceled.",a?"error":"info");return}e.signal.setStatus("Canceling cron\u2026");const r=await e.execute(_,n.id);if(e.set(l=>({...l,pendingCancel:null})),!r.ok){e.signal.setBanner(r.error.display.explanation,"error");return}await e.dispatch("refresh");const o=(e.state.schedule.data??[]).some(l=>l.cron_id===n.id);e.signal.setBanner(o?"Cron remains armed; refresh and retry.":"Cron canceled.",o?"error":"info")},dismiss(e){e.set(n=>({...n,pendingCancel:null})),e.signal.clearBanner()},retarget(e){const n=M(e.state)?.cron,r=n?.anchor_node??n?.created_by;r&&(e.set(o=>({...o,target:r,selectedCronId:null,expanded:!1,pendingCancel:null,dossier:{data:null,error:null,fetchedAt:0},schedule:{data:null,error:null,fetchedAt:0},jobs:{data:null,error:null,fetchedAt:0}})),e.dispatch("refresh"))},quit(e){e.signal.quit()}}};function M(e){return i(e.schedule.data??[]).find(n=>n.cron.cron_id===e.selectedCronId)}s(M,"selectedItem");function f(e){return(e.jobs.data??[]).find(n=>n.job_id===e.selectedJobId)}s(f,"selectedJob");function p(e,n=40){const r=(e.split(`
+`)[0]??"").replace(/\s+/g," ").trim();return r.length>n?`${r.slice(0,n-1)}\u2026`:r}s(p,"commandHead");function B(e,n){const r={data:n,error:null,fetchedAt:Date.now()};if(e.selectedJobId!==null&&n.some(t=>t.job_id===e.selectedJobId))return{...e,jobs:r};const o=(e.jobs.data??[]).findIndex(t=>t.job_id===e.selectedJobId),l=n[Math.min(Math.max(0,o),Math.max(0,n.length-1))],a=e.pendingCancel?.kind==="job"?null:e.pendingCancel;return{...e,jobs:r,selectedJobId:l?.job_id??null,expanded:!1,pendingCancel:a}}s(B,"reconcileJobs");function m(e,n){if(e.section==="jobs"){const a=e.jobs.data??[];if(a.length===0)return e;const t=Math.max(0,a.findIndex(j=>j.job_id===e.selectedJobId)),d=Math.max(0,Math.min(a.length-1,t+n));return{...e,selectedJobId:a[d].job_id,expanded:!1,pendingCancel:null}}if(e.section!=="schedule")return{...e,scroll:{...e.scroll,[e.section]:Math.max(0,e.scroll[e.section]+n)}};const r=i(e.schedule.data??[]);if(r.length===0)return e;const o=Math.max(0,r.findIndex(a=>a.cron.cron_id===e.selectedCronId)),l=Math.max(0,Math.min(r.length-1,o+n));return{...e,selectedCronId:r[l].cron.cron_id,expanded:!1,pendingCancel:null}}s(m,"move");export{D as inspectorCore,i as scheduledItems,f as selectedJob};

package/dist/core/inspector/host.d.ts

@@ -0,0 +1,46 @@
+import { type Draw, type Rect, type Size } from '../tui/draw.js';
+import type { InspectorCore, InspectorTui, InspectorText, InspectorKeyBinding, KeyHint, BannerLevel } from './contract.js';
+import { type BindingId, type BindingResolution, type RawTerminalInput } from '../keybindings/index.js';
+export interface RunInspectorOptions {
+    options?: Record<string, string>;
+}
+/** The host-tracked chrome state. `banner` + `busy` + `loaded` derive the title
+ *  state chip; `tick` advances the spinner under the busy-tick repaint. */
+export interface Chrome {
+    status: string | null;
+    banner: {
+        msg: string;
+        level: BannerLevel;
+    } | null;
+    busy: boolean;
+    loaded: boolean;
+    lastRefresh: number;
+    tick: number;
+    subtitle: string | null;
+    mode: string | null;
+}
+/** The Inspector title and effective footer key hints. */
+export interface InspectorChromeManifest {
+    title: string;
+    subtitle?: string;
+    keymap?: KeyHint[];
+}
+/** Draw the host chrome into `draw` and return the content Rect for the view.
+ *  Three zones: title row (state rail + title/subtitle + state chip + liveness),
+ *  a hairline, and a footer (status left, keymap right) with a severity banner
+ *  on the row above it when set. */
+declare function drawInspectorChrome(draw: Draw, size: Size, manifest: InspectorChromeManifest, c: Chrome, now?: number): Rect;
+export { drawInspectorChrome };
+/** Decode terminal bytes into the shared keybinding catalog's input shape. */
+export declare function parseInspectorInput(data: Buffer, bindings?: BindingResolution<BindingId>): RawTerminalInput;
+/** Resolve footer hints from the Inspector's current mode and user bindings. */
+export declare function resolveInspectorKeyHints<S>(keymap: InspectorKeyBinding<S>[], bindings: BindingResolution<BindingId>, state: S): KeyHint[];
+/** Match the first active Inspector action claimed by the input. */
+export declare function matchInspectorBinding<S>(keymap: InspectorKeyBinding<S>[], bindings: BindingResolution<BindingId>, state: S, raw: RawTerminalInput): {
+    intent: string;
+    payload: unknown;
+} | null;
+/** Match the Inspector host's exit action through the catalog snapshot. */
+export declare function matchesInspectorHostBinding(bindings: BindingResolution<BindingId>, raw: RawTerminalInput): boolean;
+/** Host the Inspector until it quits, or emit its static text snapshot. */
+export declare function runInspector<S>(core: InspectorCore<S>, tui: InspectorTui<S>, text: InspectorText<S>, opts?: RunInspectorOptions): Promise<void>;

package/dist/core/inspector/host.js

@@ -0,0 +1,4 @@
+var Z=Object.defineProperty;var o=(e,s)=>Z(e,"name",{value:s,configurable:!0});import{setupTerminal as ee,restoreTerminal as te,getTerminalSize as ne,parseKeypress as re}from"../tui/terminal.js";import{createDraw as se,detectColorCaps as oe}from"../tui/draw.js";import{initialChrome as G,deriveState as ie}from"./chrome.js";import{createInspectorTransport as ae}from"./transport.js";import{formatBinding as le,matchesTerminalInput as N,resolveUserKeybindings as ce}from"../keybindings/index.js";const x={cyan:"36",green:"32",yellow:"33",red:"31",grey:"90"},ue={working:{word:"working",glyph:"\u27F3",fg:x.cyan},blocked:{word:"blocked",glyph:"\u26A0",fg:x.red},attention:{word:"attention",glyph:"\u26A0",fg:x.yellow},ready:{word:"ready",glyph:"\u25CF",fg:x.green},idle:{word:"idle",glyph:"\u25CC",fg:x.grey}},j=["\u27F3","\u27F2"],fe={compose:"\u270E",react:"\u263A"},de="\u270E",pe={info:{glyph:"\u2139",fg:x.cyan},action:{glyph:"\u25B8",fg:x.yellow},error:{glyph:"\u2717",fg:x.red}};function he(e){return/…$/.test(e)||/^(loading|sending|reacting|opening|working|refreshing)\b/i.test(e)?{fg:x.cyan}:/^(sent|reacted|done|saved|caught up)\b/i.test(e)||/\bsent\b/i.test(e)?{fg:x.green}:{}}o(he,"statusStyle");function R(e){let s=0;for(const a of e)s+=Array.from(a.text).length;return s}o(R,"spanWidth");function ge(e){const s=Math.max(0,Math.floor(e/1e3));if(s<5)return"just now";if(s<60)return`${s}s`;const a=Math.floor(s/60);if(a<60)return`${a}m`;const t=Math.floor(a/60);return t<24?`${t}h`:`${Math.floor(t/24)}d`}o(ge,"relTime");function me(e,s){if(e.length===0||s<=0)return[];const a=o(()=>({text:" \xB7 ",style:{dim:!0}}),"sep"),t=o((d,m)=>{const h=[];return d.forEach((u,i)=>{i>0&&h.push(a()),h.push({text:u.keys,style:{bold:!0}}),m&&h.push({text:` ${u.label}`,style:{dim:!0}})}),h},"build");let r=t(e,!0);if(R(r)<=s||(r=t(e,!1),R(r)<=s))return r;const c=e[e.length-1];for(let d=e.length-1;d>0;d--)if(r=t([...e.slice(0,d),c],!1),R(r)<=s)return r;return t([c],!1)}o(me,"keymapSpans");function Q(e,s,a,t,r=Date.now()){const{cols:c,rows:d}=s,m=ie(t);let h,u,i,y=!1;if(t.mode)h=t.mode,u=fe[t.mode]??de,i=x.yellow;else{const k=ue[m];h=k.word,u=k.glyph,i=k.fg,y=m==="working"}const f={fg:i,bold:!0},g=[{text:`${y?j[t.tick%j.length]??u:u} ${h}`,style:f}];t.loaded&&t.lastRefresh>0&&g.push({text:` \xB7 updated ${ge(r-t.lastRefresh)}`,style:{dim:!0}});const M=R(g);e.text(0,0,"\u258E",f);const E=t.subtitle??a.subtitle,H=[{text:a.title,style:{bold:!0}}];E&&H.push({text:` \xB7 ${E}`,style:{dim:!0}}),e.spans(0,2,H,Math.max(0,c-2-M-1)),e.spansRight(0,c,g,M),e.hline(1,0,c);const b=d-1,$=t.status??"",q=Math.min(R([{text:$}]),Math.max(0,Math.floor(c/2)));$&&e.spans(b,0,[{text:$,style:he($)}],q);const S=Math.max(0,c-q-1);e.spansRight(b,c,me(a.keymap??[],S),S);let A=1;if(t.banner){const k=pe[t.banner.level];e.spans(b-1,0,[{text:`${k.glyph} `,style:{fg:k.fg,bold:!0}},{text:t.banner.msg,style:{bold:!0}}],c),A=2}const K=2,C=Math.max(1,d-K-A);return{row:K,col:0,width:c,height:C}}o(Q,"drawInspectorChrome");function ye(e){for(const s of e.bindings.values())if(s.gestures.includes("ctrl+h"))return!0;return!1}o(ye,"bindingSetClaimsCtrlH");function be(e){if(e.length===0)return null;const s=e.length>1?` (+${e.length-1} more)`:"";return`keybindings: ${e[0].message}${s}`}o(be,"summarizeKeybindingDiagnostics");function we(e,s){const a=re(e),t={...a.key,input:a.input},r=e.toString("utf8"),c={"\x1B[3~":"delete","\x1B[5~":"pageUp","\x1B[6~":"pageDown","\x1B[H":"home","\x1B[F":"end","\x1B[1~":"home","\x1B[4~":"end","\x1BOH":"home","\x1BOF":"end"},d=o(y=>{const f=Number(y);t.shift=f===2||f===4||f===6||f===8,t.meta=f===3||f===4||f===7||f===8,t.ctrl=f===5||f===6||f===7||f===8},"setModifiers"),m=c[r];m&&(t[m]=!0);const h=/^\x1b\[(?:1;)?([2-8])?([ABCD])$/.exec(r);h&&(d(h[1]),t[{A:"upArrow",B:"downArrow",C:"rightArrow",D:"leftArrow"}[h[2]]]=!0);const u=/^\x1b\[(3|5|6|1|4);([2-8])~$/.exec(r);u&&(t[{3:"delete",5:"pageUp",6:"pageDown",1:"home",4:"end"}[u[1]]]=!0,d(u[2]));const i=/^\x1b\[1;([2-8])([HF])$/.exec(r);if(i&&(t[i[2]==="H"?"home":"end"]=!0,d(i[1])),r.length===2&&r.startsWith("\x1B")&&a.input===r){const y=r.charCodeAt(1);t.input=y<32?String.fromCharCode(y+64).toLowerCase():r[1],t.meta=!0,t.ctrl=y<32}return t.backspace&&((r==="\b"||r==="\x1B\b")&&s&&ye(s)?(t.input="h",t.ctrl=!0,t.meta=!1,t.backspace=!1):(t.input="",t.ctrl=!1,t.meta=!1,t.backspace=!0)),t}o(we,"parseInspectorInput");function xe(e,s,a){const t=[];for(const r of e)!r.hint||r.when&&!r.when(a)||s.gestures(r.bindingId).length!==0&&t.push({keys:le(s,r.bindingId),label:r.hint.label});return t}o(xe,"resolveInspectorKeyHints");function ke(e,s,a,t){for(const r of e)if(!(r.when&&!r.when(a))&&N(s,r.bindingId,t))return{intent:r.intent,payload:r.payload?r.payload(a):void 0};return null}o(ke,"matchInspectorBinding");function ve(e,s){return N(e,"crtr.inspector.force-quit",s)}o(ve,"matchesInspectorHostBinding");async function P(e,s,a){const t=await e.send(s.request(a));return s.parse(t)}o(P,"runRequest");async function De(e,s,a,t={}){const r=Object.freeze({...t.options??{}}),c=ce(),d=be(c.diagnostics),m=ae({cwd:process.cwd()});if(!process.stdin.isTTY||!process.stdout.isTTY){d&&process.stderr.write(`${d}
+`);let n=e.init(r);const l=G(),T={get state(){return n},set(p){n=typeof p=="function"?p(n):p},resolve:o((p,B)=>P(m,p,B),"resolve"),execute:o((p,B)=>P(m,p,B),"execute"),signal:{setStatus(){},setBanner(p,B){l.banner={msg:p,level:B}},clearBanner(){l.banner=null},setSubtitle(){},setMode(){},quit(){}},dispatch:o(async(p,B)=>{const _=e.intents[p];_&&await _(T,B)},"dispatch")},I=e.intents.refresh;if(I)try{await I(T,void 0)}catch{}let v=a.dump(n,{banner:l.banner});v.endsWith(`
+`)||(v+=`
+`),process.stdout.write(v);return}const h=oe();let u=e.init(r);const i=G();let y=0;d&&(i.banner={msg:d,level:"action"});let f=!1;const F=o(()=>{if(!f){f=!0;try{te()}catch{}}},"cleanup");process.once("exit",F);const g=o(()=>{const n=ne(),{draw:l,frame:w}=se(n,h),T={...e.manifest,keymap:xe(s.keymap,c,u)},I={...i,tick:y},v=Q(l,n,T,I);try{s.render(u,l,v)}catch(p){i.banner={msg:`render error: ${O(p)}`,level:"error"}}process.stdout.write(w())},"render");let M;const E=o(()=>{M||(M=setInterval(()=>{y++,g()},120))},"startBusyTick"),H=o(()=>{M&&(clearInterval(M),M=void 0)},"stopBusyTick");let b=!1,$=o(()=>{},"resolveLoop");const q=new Promise(n=>{$=n});let S;const A=o(()=>{if(!b){for(b=!0,S&&clearInterval(S);D.length>0;)D.shift().resolve();H(),F(),$()}},"finish"),K={setStatus(n){i.status=n},setBanner(n,l){i.banner=n==null?null:{msg:n,level:l}},clearBanner(){i.banner=null},setSubtitle(n){i.subtitle=n},setMode(n){i.mode=n},quit(){A()}};let C=!1,k=!1;const D=[],L=o(n=>{n==="refresh"&&(i.loaded=!0,i.lastRefresh=Date.now())},"markRefreshed");function X(){return{get state(){return u},set(n){u=typeof n=="function"?n(u):n,g()},resolve:o((n,l)=>P(m,n,l),"resolve"),execute:o((n,l)=>P(m,n,l),"execute"),signal:K,dispatch:o((n,l)=>U(n,l),"dispatch")}}o(X,"makeCtx");async function U(n,l){if(b)return;const w=e.intents[n];if(!w){i.banner={msg:`unknown intent: ${n}`,level:"error"},g();return}const T=X();let I;try{I=w(T,l)}catch(v){i.banner={msg:O(v),level:"error"},L(n),g();return}if(I instanceof Promise){const v=C;v||(C=!0,i.busy=!0,g(),E());try{await I}catch(p){i.banner={msg:O(p),level:"error"}}finally{v||(C=!1,i.busy=!1,H()),L(n),g()}}else L(n),g()}o(U,"runIntentInline");async function Y(){if(!k){k=!0;try{for(;!b&&D.length>0;){const n=D.shift();try{await U(n.intentName,n.payload)}finally{n.resolve()}}}finally{k=!1,!b&&D.length>0&&Y()}}}o(Y,"drainDispatchQueue");function W(n,l){return b?Promise.resolve():new Promise(w=>{D.push({intentName:n,payload:l,resolve:w}),Y()})}o(W,"enqueueDispatch"),ee(),g(),e.intents.refresh&&await W("refresh");const J=2;let z=0;typeof e.manifest.refreshMs=="number"&&e.manifest.refreshMs>0&&(S=setInterval(()=>{C||W("refresh")},e.manifest.refreshMs));const V=o(async n=>{if(b)return;let l;try{l=we(n,c)}catch{return}if(ve(c,l)){A();return}if(C&&z>=J)return;const w=ke(s.keymap,c,u,l);if(w){z+=1;try{await W(w.intent,w.payload)}finally{z-=1}}},"onData");process.stdin.on("data",n=>{V(n)}),process.stdout.on("resize",()=>{b||g()}),await q}o(De,"runInspector");function O(e){return e instanceof Error?e.message:String(e)}o(O,"errText");export{Q as drawInspectorChrome,ke as matchInspectorBinding,ve as matchesInspectorHostBinding,we as parseInspectorInput,xe as resolveInspectorKeyHints,De as runInspector};

package/dist/core/inspector/model.d.ts

@@ -0,0 +1,88 @@
+import type { CronDTO } from '../../api/dto/crons.js';
+export type InspectorSection = 'overview' | 'schedule' | 'jobs' | 'raw';
+/** One live background bash job, as `crtr --json node bash list` reports it. */
+export interface BashJobRow {
+    job_id: string;
+    command: string;
+    /** Human-readable label supplied with the bash call, or null when absent. */
+    purpose: string | null;
+    started_at: string;
+    elapsed_ms: number;
+    log_path: string;
+    /** Supervisor process group — null for a job started before crtr persisted
+     *  one, which is exactly the set of jobs the Inspector cannot stop. */
+    pgid: number | null;
+    log_tail: string[];
+}
+export interface ScheduledItem {
+    cron: CronDTO;
+    nextAt: string;
+    cadence: string;
+    target: string;
+}
+export declare const ICON: {
+    readonly identity: string;
+    readonly state: string;
+    readonly place: string;
+    readonly graph: string;
+    readonly artifacts: string;
+    readonly paths: string;
+    readonly cron: string;
+    readonly job: string;
+    readonly log: string;
+    readonly section: string;
+    readonly raw: string;
+    readonly empty: string;
+};
+/** Semantic tone for a value. Hue is always paired with a word or glyph so the
+ *  meaning survives NO_COLOR / a mono terminal. */
+export type Tone = 'plain' | 'dim' | 'good' | 'warn' | 'bad' | 'accent';
+export interface Field {
+    label: string;
+    value: string;
+    tone?: Tone;
+    /** Glyph drawn immediately before the value, in the value's tone. */
+    glyph?: string;
+}
+export interface Group {
+    icon: string;
+    title: string;
+    fields: Field[];
+}
+export declare function statusVisual(status: string): {
+    glyph: string;
+    tone: Tone;
+};
+export declare function scheduledItems(crons: readonly CronDTO[]): ScheduledItem[];
+/** Elapsed duration in the shape every bash-handoff surface uses: `12s`,
+ *  `3m 40s`, `1h 04m`. Duplicated from core/bash-jobs.ts on purpose — a view
+ *  module stays a pure read and never pulls the node:fs job scanner in. */
+export declare function elapsed(ms: number): string;
+/** How a running job's age reads at a glance: an ordered ramp, not decoration.
+ *  Fresh work is green, a job past 15m is amber, past an hour is red — the same
+ *  good/warn/bad progression the node status glyphs use. */
+export declare function jobTone(elapsedMs: number): Tone;
+/** Milliseconds a job has been running, live from `started_at`. */
+export declare function jobElapsedMs(job: BashJobRow, now?: number): number;
+/** Live elapsed time for a job row — recomputed from `started_at` so the number
+ *  keeps ticking between the view's 5s refreshes; `elapsed_ms` is the fallback. */
+export declare function jobElapsed(job: BashJobRow, now?: number): string;
+/** First line of a command, whitespace-collapsed and capped for a one-row cell. */
+export declare function commandCell(command: string, cap?: number): string;
+/** A person-readable purpose leads when present; legacy jobs retain their
+ * command label. */
+export declare function jobLabel(job: BashJobRow, cap?: number): string;
+export declare function relativeTime(iso: string | null, now?: number): string;
+/** How long ago an ISO timestamp was, e.g. `3d ago`. `—` when absent. */
+export declare function ago(iso: unknown, now?: number): string;
+/** `$HOME/x` → `~/x`; everything else verbatim. Paths are long and the tail is
+ *  the informative end, so the draw layer clips them, not this. */
+export declare function shortPath(input: unknown, home?: string): string;
+/** 97526 → `97.5k`. Token counts are read at a glance, not audited. */
+export declare function compactCount(input: unknown): string;
+/** The overview, grouped into the cards the presenters draw. Ordering is the
+ *  reading order: who → what it is doing → where → its graph → what it produced
+ *  → where that lives on disk. */
+export declare function overviewGroups(dossier: Record<string, unknown> | null): Group[];
+export declare function record(value: unknown): Record<string, unknown>;
+export declare function value(value: unknown): string;

package/dist/core/inspector/model.js

@@ -0,0 +1,2 @@
+var y=Object.defineProperty;var o=(e,t)=>y(e,"name",{value:t,configurable:!0});const i=o(e=>String.fromCodePoint(e),"cp"),u={identity:i(62144),state:i(61713),place:i(61563),graph:i(61920),artifacts:i(61914),paths:i(61686),cron:i(61463),job:i(61459),log:i(61728),section:i(61842),raw:i(61729),empty:i(61875)},v={active:{glyph:"\u25CF",tone:"good"},idle:{glyph:"\u25CB",tone:"warn"},done:{glyph:"\u2713",tone:"accent"},dead:{glyph:"\u2717",tone:"bad"},canceled:{glyph:"\u2298",tone:"dim"}};function w(e){return v[e]??{glyph:"\u25C6",tone:"plain"}}o(w,"statusVisual");function D(e){return e.map(t=>({cron:t,nextAt:t.fire_at,cadence:t.recur===null||t.recur==="none"?"one-shot":t.recur,target:t.sink??t.anchor_node??"daemon"})).sort((t,n)=>t.nextAt!==n.nextAt?t.nextAt.localeCompare(n.nextAt):t.cron.cron_id.localeCompare(n.cron.cron_id))}o(D,"scheduledItems");function M(e){const t=Math.max(0,Math.floor(e/1e3));if(t<60)return`${t}s`;const n=Math.floor(t/60);return n<60?`${n}m ${String(t%60).padStart(2,"0")}s`:`${Math.floor(n/60)}h ${String(n%60).padStart(2,"0")}m`}o(M,"elapsed");function F(e){return e>=60*6e4?"bad":e>=15*6e4?"warn":"good"}o(F,"jobTone");function S(e,t=Date.now()){const n=Date.parse(e.started_at);return Number.isFinite(n)?t-n:e.elapsed_ms}o(S,"jobElapsedMs");function C(e,t=Date.now()){return M(S(e,t))}o(C,"jobElapsed");function A(e,t=60){const n=(e.split(`
+`)[0]??"").replace(/\s+/g," ").trim();return n.length>t?`${n.slice(0,t-1)}\u2026`:n}o(A,"commandCell");function L(e,t=60){return A(e.purpose??e.command,t)}o(L,"jobLabel");function T(e,t=Date.now()){if(e===null)return"\u2014";const n=Date.parse(e);if(!Number.isFinite(n))return e;const c=n-t;if(c<=0)return"due now";const r=Math.ceil(c/6e4);if(r<60)return`in ${r}m`;const a=Math.floor(r/60);return a<24?`in ${a}h${r%60?` ${r%60}m`:""}`:`in ${Math.floor(a/24)}d${a%24?` ${a%24}h`:""}`}o(T,"relativeTime");function j(e,t=Date.now()){if(typeof e!="string"||e==="")return"\u2014";const n=Date.parse(e);if(!Number.isFinite(n))return String(e);const c=Math.max(0,Math.floor((t-n)/1e3));if(c<60)return`${c}s ago`;const r=Math.floor(c/60);if(r<60)return`${r}m ago`;const a=Math.floor(r/60);if(a<24)return`${a}h ago`;const s=Math.floor(a/24);return s<30?`${s}d ago`:`${Math.floor(s/30)}mo ago`}o(j,"ago");function d(e,t=process.env.HOME??""){const n=l(e);return t!==""&&n.startsWith(`${t}/`)?`~${n.slice(t.length)}`:n}o(d,"shortPath");function N(e){const t=Number(e);return Number.isFinite(t)?t<1e3?String(t):t<1e6?`${(t/1e3).toFixed(t<1e4?1:0)}k`:`${(t/1e6).toFixed(1)}M`:l(e)}o(N,"compactCount");function b(e){return Array.isArray(e)?e.filter(t=>typeof t=="object"&&t!==null):[]}o(b,"neighbors");function $(e){if(e.length===0)return"\u2014";const t=e.slice(0,3).map(n=>n.name??n.node_id??"?");return e.length>3?`${t.join(", ")} +${e.length-3}`:t.join(", ")}o($,"neighborLine");function E(e){const t=m(e?.node),n=m(e?.paths),c=m(e?.artifacts),r=l(t.status),a=w(r),s=l(t.intent),h=l(t.waiting_for),g=b(e?.managers),x=b(e?.reports),f=Number(e?.pending_crons??0);return[{icon:u.identity,title:"identity",fields:[{label:"name",value:l(t.name),tone:"accent"},{label:"id",value:l(t.node_id),tone:"dim"},{label:"role",value:_(t.kind,t.mode,t.lifecycle)},{label:"model",value:l(t.model??t.model_override),tone:t.model??t.model_override?"plain":"dim"}]},{icon:u.state,title:"state",fields:[{label:"status",value:r,tone:a.tone,glyph:a.glyph},{label:"intent",value:s,tone:s==="\u2014"?"dim":"warn"},{label:"waiting on",value:h,tone:h==="\u2014"?"dim":"warn"},{label:"context",value:`${N(t.context_tokens)} tokens \xB7 ${l(t.cycles)} cycle(s)`},{label:"created",value:`${j(t.created)}`,tone:"dim"}]},{icon:u.place,title:"place",fields:[{label:"workspace",value:d(t.cwd)},{label:"profile",value:l(t.profile_id),tone:"dim"},{label:"host",value:_(t.host_kind,t.pi_pid?`pid ${String(t.pi_pid)}`:null),tone:"dim"}]},{icon:u.graph,title:"graph",fields:[{label:"managers",value:$(g),tone:g.length===0?"dim":"plain"},{label:"reports",value:$(x),tone:x.length===0?"dim":"plain"},{label:"parent",value:l(t.parent),tone:"dim"}]},{icon:u.artifacts,title:"output",fields:[{label:"artifacts",value:`${p(c.doc)} doc \xB7 ${p(c.report)} report \xB7 ${p(c.roadmap)} roadmap`},{label:"crons",value:f===0?"none armed":`${f} armed`,tone:f===0?"dim":"accent"}]},{icon:u.paths,title:"paths",fields:[{label:"context",value:d(n.context_dir),tone:"dim"},{label:"session",value:d(n.session_file??t.pi_session_file),tone:"dim"}]}]}o(E,"overviewGroups");function p(e){const t=Number(e??0);return Number.isFinite(t)?String(t):"0"}o(p,"count");function m(e){return e!==null&&typeof e=="object"&&!Array.isArray(e)?e:{}}o(m,"record");function l(e){return e==null||e===""?"\u2014":String(e)}o(l,"value");function _(...e){return e.map(l).filter(t=>t!=="\u2014").join(" \xB7 ")||"\u2014"}o(_,"join");export{u as ICON,j as ago,A as commandCell,N as compactCount,M as elapsed,C as jobElapsed,S as jobElapsedMs,L as jobLabel,F as jobTone,E as overviewGroups,m as record,T as relativeTime,D as scheduledItems,d as shortPath,w as statusVisual,l as value};

package/dist/core/inspector/text.d.ts

@@ -0,0 +1,5 @@
+import type { InspectorText } from './contract.js';
+import type { InspectorState } from './core.js';
+/** The piped path: same information and grouping as the TUI, minus the glyphs
+ *  and hue a pipe cannot carry. */
+export declare const inspectorText: InspectorText<InspectorState>;

package/dist/core/inspector/text.js

@@ -0,0 +1,6 @@
+import{jobElapsed as l,jobLabel as d,overviewGroups as a,relativeTime as u,scheduledItems as $,value as t}from"./model.js";const c={dump(n,s){const e=[`Inspector \u2014 ${n.target}`];if(s?.banner&&e.push("",`[${s.banner.level}] ${s.banner.msg}`),n.dossier.error)return e.push("",n.dossier.error.display.headline,n.dossier.error.display.explanation),e.join(`
+`);for(const o of a(n.dossier.data)){e.push("",`${o.title.toUpperCase()}`);for(const r of o.fields)e.push(`  ${r.label.padEnd(12)}${r.value}`)}if(e.push("","SNAPSHOT",`  taken       ${new Date().toISOString()}`,"","SCHEDULE"),n.schedule.error)return e.push(`  ${n.schedule.error.display.explanation}`,`  ${n.schedule.error.display.nextStep}`),e.join(`
+`);const i=$(n.schedule.data??[]);i.length===0&&e.push("  nothing armed");for(const o of i){const r=o.cron;e.push("",`  ${r.name} \xB7 ${o.cadence} \xB7 ${u(o.nextAt)}`,`    id        ${r.cron_id}`,`    next      ${o.nextAt}`,`    state     ${t(r.state)}`,`    output    ${r.on_output}${r.sink?` \u2192 ${r.sink}`:""}`,`    expires   ${t(r.expires_at)}`)}if(e.push("","BACKGROUND BASH JOBS"),n.jobs.error)return e.push(`  ${n.jobs.error.display.explanation}`,`  ${n.jobs.error.display.nextStep}`),e.join(`
+`);const p=n.jobs.data??[];p.length===0&&e.push("  nothing running");for(const o of p){e.push("",`  ${d(o)} \xB7 ${l(o)}`,`    id        ${o.job_id}`,...o.purpose===null?[]:[`    command   ${o.command.split(`
+`)[0]}`],`    started   ${o.started_at}`,`    log       ${o.log_path}`);for(const r of o.log_tail.slice(-5))e.push(`    | ${r}`)}return e.join(`
+`)}};export{c as inspectorText};

package/dist/core/inspector/transport.d.ts

@@ -0,0 +1,6 @@
+import type { RawResponse, SourceRequest } from './contract.js';
+export declare function createInspectorTransport(options?: {
+    cwd?: string;
+}): {
+    send(request: SourceRequest): Promise<RawResponse>;
+};

package/dist/core/inspector/transport.js

@@ -0,0 +1 @@
+var g=Object.defineProperty;var m=(d,c)=>g(d,"name",{value:c,configurable:!0});import{execFile as w}from"node:child_process";const l=10*1024*1024;function b(d={}){const c=d.cwd??process.cwd();return{send(n){return new Promise(i=>{const s=w(n.bin,n.args,{cwd:n.cwd??c,maxBuffer:l,encoding:"utf8"},(o,e,t)=>{if(!o){i({ok:!0,exitCode:0,stdout:e,stderr:t});return}const f=o.code;if(typeof f=="number"){i({ok:!0,exitCode:f,stdout:e??"",stderr:t??""});return}const a=o.signal;if(a){const r=t&&t.trim()!==""?t:`killed by signal ${a}${a==="SIGKILL"?" (often out-of-memory)":""}`;i({ok:!0,exitCode:1,stdout:e??"",stderr:r});return}const u=f==="ENOENT"?`${n.bin}: command not found`:o.message;i({ok:!1,stdout:e??"",stderr:u})});n.stdin!==void 0&&s.stdin&&(s.stdin.write(n.stdin),s.stdin.end())})}}}m(b,"createInspectorTransport");export{b as createInspectorTransport};

package/dist/core/inspector/tui.d.ts

@@ -0,0 +1,3 @@
+import type { InspectorTui } from './contract.js';
+import type { InspectorState } from './core.js';
+export declare const inspectorTui: InspectorTui<InspectorState>;

package/dist/core/inspector/tui.js

@@ -0,0 +1,2 @@
+var S=Object.defineProperty;var o=(e,n)=>S(e,"name",{value:n,configurable:!0});import{ICON as p,commandCell as T,jobElapsed as j,jobElapsedMs as L,jobLabel as C,jobTone as R,overviewGroups as A,relativeTime as f,scheduledItems as I,shortPath as x,value as b}from"./model.js";const m=12,d="  ",v={plain:void 0,dim:{dim:!0},good:{fg:"32"},warn:{fg:"33"},bad:{fg:"31",bold:!0},accent:{fg:"36"}},$={dim:!0},g={dim:!0},N={fg:"36",bold:!0},O=[{id:"overview",label:"overview"},{id:"schedule",label:"schedule"},{id:"jobs",label:"jobs"},{id:"raw",label:"raw"}];function k(e,n){return[{text:`${d}${e.padEnd(m)}`,style:$},...n]}o(k,"fieldRow");function J(e,n,t){const i=v[n??"plain"];return[{text:t===void 0?e:`${t} ${e}`,style:i}]}o(J,"valueSpans");function E(e,n,t){const i=`${e} ${n}`,s=Math.max(0,t-i.length-3);return[{text:" "},{text:i,style:N},{text:` ${"\u2500".repeat(s)}`,style:g}]}o(E,"groupHeader");function y(e,n){const t=[{text:" "}];O.forEach((s,l)=>{l>0&&t.push({text:"  \xB7  ",style:{dim:!0}});const r=s.id===e.section,c=s.id==="schedule"?` ${I(e.schedule.data??[]).length}`:s.id==="jobs"?` ${(e.jobs.data??[]).length}`:"";t.push({text:r?`${p.section} ${s.label}${c}`:`${s.label}${c}`,style:r?{fg:"36",bold:!0}:{dim:!0}})});const i=t.reduce((s,l)=>s+l.text.length,0);return t.push({text:` ${"\u2500".repeat(Math.max(0,n-i-1))}`,style:g}),t}o(y,"tabStrip");function D(e,n){const t=[];for(const i of e){t.push(E(i.icon,i.title,n));for(const s of i.fields)t.push(k(s.label,J(s.value,s.tone,s.glyph)));t.push([])}return t[t.length-1]?.length===0&&t.pop(),t}o(D,"groupRows");function q(e,n){return e.dossier.data===null?[[{text:`${d}loading node overview\u2026`,style:{dim:!0}}]]:D(A(e.dossier.data),n)}o(q,"overviewRows");function W(e){return e.dossier.data===null?[[{text:`${d}loading raw record\u2026`,style:{dim:!0}}]]:JSON.stringify(e.dossier.data,null,2).split(`
+`).map(n=>{const t=/^(\s*)"([^"]+)":\s?(.*)$/.exec(n);if(t===null)return[{text:n,style:g}];const[,i="",s="",l=""]=t,r=l.startsWith('"')?void 0:l.startsWith("{")||l.startsWith("[")?g:{fg:"33"};return[{text:i},{text:s,style:{fg:"36"}},{text:": ",style:g},{text:l,style:r}]})}o(W,"rawRows");function w(e,n,t){return[[{text:` \u2717 ${e}`,style:{fg:"31",bold:!0}}],[],[{text:`${d}${n}`}],[],[{text:`${d}${t}`,style:{dim:!0}}]]}o(w,"errorRows");function Y(e,n){const t=e.cron,i=t.state==="paused",s=f(e.nextAt)==="due now",l=i?{dim:!0}:s?{fg:"33",bold:!0}:{fg:"32"},r=[[{text:`${d}${d}${e.cadence}`,style:{dim:!0}},{text:" \xB7 ",style:{dim:!0}},{text:`${t.on_output}${t.sink?` \u2192 ${t.sink}`:""}`,style:{dim:!0}},...i?[{text:"  paused",style:{fg:"33"}}]:[]]];if(n){const c=[["id",t.cron_id],["next fire",`${f(e.nextAt)}  ${b(t.fire_at)}`],["recurrence",e.cadence],["state",b(t.state)],["target",x(e.target)],["expires",b(t.expires_at)]];r.push([]);for(const[a,u]of c)r.push([{text:`${d}${d}${a.padEnd(m)}`,style:$},{text:u}])}return r.push([]),{spans:[{text:` ${p.cron} `,style:l},{text:t.name,style:{bold:!0}}],right:[{text:`${f(e.nextAt)} `,style:l}],lines:r}}o(Y,"cronItem");function B(e,n,t){const i=v[R(L(e))],s=e.log_tail[e.log_tail.length-1],l=[];if(!n)l.push([{text:`${d}${d}${s===void 0?"no output yet":_(s,t-6)}`,style:{dim:!0}}]);else{const r=[["job",e.job_id],...e.purpose===null?[]:[["command",T(e.command,Math.max(20,t-26))]],["started",e.started_at],["log",x(e.log_path)],["watch",`tail -f ${x(e.log_path)}`]];for(const[c,a]of r)l.push([{text:`${d}${d}${c.padEnd(m)}`,style:$},{text:a,style:c==="watch"?{fg:"36"}:void 0}]);l.push([]),l.push(E(p.log,`last ${e.log_tail.length} lines`,t-2)),e.log_tail.length===0&&l.push([{text:`${d}${d}no output yet`,style:{dim:!0}}]);for(const c of e.log_tail)l.push([{text:`${d}${d}${_(c,t-6)}`,style:{dim:!0}}])}return l.push([]),{spans:[{text:` ${p.job} `,style:i},{text:C(e,Math.max(20,t-26)),style:{bold:!0}}],right:[{text:`${j(e)} `,style:i}],lines:l}}o(B,"jobItem");function _(e,n){const t=e.replace(/\t/g,"  ").replace(/[\u0000-\u0008\u000b-\u001f]/g,""),i=Math.max(10,n);return t.length>i?`${t.slice(0,i-1)}\u2026`:t}o(_,"logCell");function H(){return[[{text:` ${p.empty} nothing running`,style:{dim:!0}}],[],[{text:`${d}This node has no bash commands running in the background.`,style:{dim:!0}}]]}o(H,"jobsEmptyRows");function P(){return[[{text:` ${p.empty} nothing armed`,style:{dim:!0}}],[],[{text:`${d}This node has no crons waiting to fire.`,style:{dim:!0}}],[{text:`${d}Arm one with `,style:{dim:!0}},{text:"crtr cron add",style:{fg:"36"}},{text:".",style:{dim:!0}}]]}o(P,"scheduleEmptyRows");function h(e,n,t,i){const s=y(e,i.width),l=i.height-2;if(t.spans(i.row,i.col,s,i.width),l<=0)return;const r=Math.max(0,n.length-l),c=Math.min(Math.max(0,e.scroll[e.section]),r);if(n.slice(c,c+l).forEach((a,u)=>t.spans(i.row+2+u,i.col,a,i.width)),n.length>l){const a=r===0?100:Math.round((c+l)/n.length*100);t.spansRight(i.row,i.col+i.width,[{text:` ${a}% `,style:{dim:!0}}])}}o(h,"paint");const V={render(e,n,t){if(e.dossier.error?.display.blocking){const r=e.dossier.error.display;h(e,w(r.headline,r.explanation,r.nextStep),n,t);return}if(e.section==="overview"){h(e,q(e,t.width),n,t);return}if(e.section==="raw"){h(e,W(e),n,t);return}if(e.section==="jobs"){if(e.jobs.error){const u=e.jobs.error.display;h(e,w(u.headline,u.explanation,u.nextStep),n,t);return}const r=e.jobs.data??[];if(r.length===0){h(e,H(),n,t);return}n.spans(t.row,t.col,y(e,t.width),t.width);const c=Math.max(0,r.findIndex(u=>u.job_id===e.selectedJobId)),a=r.map((u,M)=>B(u,M===c&&e.expanded,t.width));n.list({...t,row:t.row+2,height:Math.max(0,t.height-2)},a,c,e.scroll.jobs);return}if(e.schedule.error){const r=e.schedule.error.display;h(e,w(r.headline,r.explanation,r.nextStep),n,t);return}const i=I(e.schedule.data??[]);if(i.length===0){h(e,P(),n,t);return}n.spans(t.row,t.col,y(e,t.width),t.width);const s=Math.max(0,i.findIndex(r=>r.cron.cron_id===e.selectedCronId)),l=i.map((r,c)=>Y(r,c===s&&e.expanded));n.list({...t,row:t.row+2,height:Math.max(0,t.height-2)},l,s,e.scroll.schedule)},keymap:[{bindingId:"crtr.inspector.down",intent:"down",hint:{label:"move"}},{bindingId:"crtr.inspector.up",intent:"up"},{bindingId:"crtr.inspector.section-next",intent:"sectionNext",hint:{label:"section"}},{bindingId:"crtr.inspector.section-prev",intent:"sectionPrev"},{bindingId:"crtr.inspector.page-down",intent:"pageDown"},{bindingId:"crtr.inspector.page-up",intent:"pageUp"},{bindingId:"crtr.inspector.toggle-detail",intent:"toggleDetail",when:o(e=>e.section==="schedule"&&e.selectedCronId!==null||e.section==="jobs"&&e.selectedJobId!==null,"when"),hint:{label:"details"}},{bindingId:"crtr.inspector.cancel-item",intent:"cancelItem",when:o(e=>!e.readOnly&&e.section==="schedule"&&e.selectedCronId!==null,"when"),hint:{label:"cancel"}},{bindingId:"crtr.inspector.cancel-item",intent:"cancelItem",when:o(e=>!e.readOnly&&e.section==="jobs"&&e.selectedJobId!==null,"when"),hint:{label:"stop job"}},{bindingId:"crtr.inspector.open-log",intent:"openLog",when:o(e=>e.section==="jobs"&&e.selectedJobId!==null,"when"),hint:{label:"open log"}},{bindingId:"crtr.inspector.confirm",intent:"confirm",when:o(e=>e.pendingCancel!==null,"when"),hint:{label:"confirm"}},{bindingId:"crtr.inspector.dismiss",intent:"dismiss",hint:{label:"dismiss"}},{bindingId:"crtr.inspector.retarget",intent:"retarget",when:o(e=>e.section==="schedule"&&e.selectedCronId!==null,"when"),hint:{label:"retarget"}},{bindingId:"crtr.inspector.refresh",intent:"refresh",hint:{label:"refresh"}},{bindingId:"crtr.inspector.quit",intent:"quit",hint:{label:"quit"}}]};export{V as inspectorTui};

package/dist/core/installed-plugins.d.ts

@@ -0,0 +1,2 @@
+import type { InstalledPlugin, Scope } from '../types.js';
+export declare function listInstalledPluginsInRoot(scope: Scope, scopeRootPath: string): InstalledPlugin[];

package/dist/core/installed-plugins.js

@@ -0,0 +1 @@
+var m=Object.defineProperty;var f=(e,n)=>m(e,"name",{value:n,configurable:!0});import{join as l}from"node:path";import{CONFIG_FILE as p}from"../types.js";import{listDirs as g,pathExists as d,readJsonIfExists as w}from"./fs-utils.js";import{readPluginManifest as y}from"./manifest.js";import{awaitBundleSwap as b,bundleSwapInFlightElsewhere as I}from"./plugin-swap-lock.js";import{userStore as k}from"./scoped-state/paths.js";import{readRawSettings as v}from"./scoped-state/settings.js";import{pluginsDir as S}from"./scope.js";function h(e,n){const r=e==="user"?k(n):void 0,t=r?v({store:r,key:"user",kind:"user",root:r.root}):w(l(n,p));return t&&t.plugins&&typeof t.plugins=="object"?t.plugins:{}}f(h,"pluginConfigForRoot");function E(e,n,r){const t=Object.keys(n);return t.every(o=>r.has(o))?[]:t.filter(o=>!r.has(o)&&I(e,o))}f(E,"swapsToWaitOut");function G(e,n){const r=e==="user"?S("user"):l(n,"plugins");if(!d(r))return[];const t=h(e,n),o=a(e,r,t),u=E(n,t,new Set(o.map(i=>i.name)));if(u.length===0)return o;for(const i of u)b(n,i);return a(e,r,t)}f(G,"listInstalledPluginsInRoot");function a(e,n,r){const t=[];for(const o of g(n)){const u=l(n,o),i=y(u);if(!i)continue;const s=r[o],c=typeof s?.version=="string"?s.version:i.version;t.push({name:o,scope:e,root:u,manifest:i,enabled:typeof s?.enabled=="boolean"?s.enabled:!0,sourceMarketplace:typeof s?.source_marketplace=="string"?s.source_marketplace:void 0,version:c})}return t}f(a,"collectInstalledPlugins");export{G as listInstalledPluginsInRoot};

package/dist/core/io.d.ts

@@ -0,0 +1,122 @@
+import { CrtrError } from './errors.js';
+import { type ExitCodeValue } from '../types.js';
+import { ApiError } from '../api/index.js';
+/** The private result mirror for one crtr CLI invocation launched by the
+ * canvas bash-preview extension. This deliberately never enters stdout: bash
+ * text is model context, while Pi tool-result details are viewer-only.
+ *
+ * One bash tool call may run several crtr invocations (`read a && read b`), so
+ * the mirror file is JSONL: one record per invocation, appended in order. Each
+ * invocation is its own process and `beginPreview` resets this module's state,
+ * so the appends compose across them with no shared state or locking. */
+export interface CrtrPreviewRecord {
+    path: string;
+    result?: Record<string, unknown>;
+    jsonl?: Record<string, unknown>[];
+    error?: ErrorPayload;
+}
+/** A preview is bounded UI metadata, never a bulk-data channel. One
+ * `crtr integration run` once mirrored a 3 MB CRM dump into every copy of the
+ * transcript that contains its tool result — the session file, every replay
+ * frame, and the host product's stored conversation — because pi's 50 KB
+ * stdout truncation never sees this channel. The mirror write is the one
+ * choke point every record passes, so the bound lives here: an oversized
+ * record is dropped, and the viewer falls back to rendering the agent-facing
+ * stdout text, which pi bounds itself.
+ *
+ * Because records accumulate, this bounds the FILE TOTAL, not one line: a
+ * record that would overrun the remaining budget is dropped whole, so every
+ * line on disk stays valid JSON. */
+export declare const PREVIEW_RESULT_MAX_BYTES: number;
+/** Begin collecting the current leaf's structured response, if its caller
+ * supplied the private per-tool-call result path. */
+export declare function beginPreview(path: string): void;
+/** Publish the single-object or collected JSONL result after leaf dispatch. */
+export declare function publishPreviewResult(result: Record<string, unknown> | void): void;
+/** Mirror a structured record whose caller renders it itself instead of using
+ * the generic dispatcher (JSONL and event-stream leaves). */
+export declare function recordPreviewLine(obj: Record<string, unknown>): void;
+/** Preserve a verbatim JSONL stream's structured frames without changing the
+ * bytes written to stdout. Invalid third-party lines remain raw-only. */
+export declare function recordPreviewJsonLine(line: string): void;
+/** Record a terminal streaming failure that correctly remains off stdout
+ * because prior frames have already been delivered. */
+export declare function recordPreviewError(payload: ErrorPayload): void;
+/** Set by the dispatcher when `--json` is present anywhere in argv. */
+export declare function setJsonOutput(v: boolean): void;
+/** True when the caller asked for raw JSON instead of rendered prose. */
+export declare function isJsonOutput(): boolean;
+/** Structured error payload. `error` is a stable code the agent branches on;
+ *  `next` is the recovery road sign. */
+interface ErrorPayloadBase {
+    error: string;
+    message: string;
+    received?: unknown;
+    field?: string;
+    /** Transport status of a failed backend call (HTTP-transport plugins). It is kept out
+     *  of `received` on purpose: `received` names the caller's offending VALUE, and
+     *  reporting an HTTP status there is a false claim about what was sent. */
+    http_status?: number;
+    next: string;
+}
+export type ErrorPayload = ErrorPayloadBase & ({
+    primaryCompleted: true;
+    result: Record<string, unknown>;
+} | {
+    primaryCompleted?: never;
+    result?: never;
+});
+/** A command-level failure: surfaces as the JSON response on stdout. */
+export declare class InputError extends CrtrError {
+    payload: ErrorPayload;
+    constructor(payload: ErrorPayload, exitCode?: ExitCodeValue);
+}
+/** Read raw stdin to EOF. Returns empty string when stdin is a TTY (no pipe).
+ *  Called by the argv parser for leaves declaring a `stdin` parameter. */
+export declare function readStdinRaw(): Promise<string>;
+/** Best-effort, non-hanging peek at whatever stdin bytes are already
+ *  buffered — used ONLY to detect a positional/stdin conflict, never to
+ *  consume the leaf's actual required stdin body. Genuine piped/redirected
+ *  content (a heredoc, `< file`, `cat x |`) is fully written into the pipe
+ *  before this process starts reading, so it resolves within one tick; a
+ *  non-TTY stdin that's simply inherited and held open with nothing written
+ *  to it (e.g. a caller subprocess that never closes its own stdin) would
+ *  otherwise hang `readStdinRaw()` forever — this bounds that wait instead
+ *  of blocking the whole invocation on an ambiguous pipe. Returns '' on a
+ *  TTY (nothing can be piped) or once the bound elapses with no bytes. */
+export declare function peekStdinRaw(timeoutMs?: number): Promise<string>;
+/** Raw-JSON mirror of a single-shot response (the `--json` escape hatch). The
+ *  default path renders the result as prose instead — see render.ts. */
+export declare function emit(obj: Record<string, unknown>): void;
+/** One JSONL record. Call per event in a stream; partial reads stay parseable. */
+export declare function emitLine(obj: Record<string, unknown>): void;
+/**
+ * Write to stdout and resolve true ONLY once the bytes are confirmed flushed to
+ * a connected reader. Resolves false if the consumer is gone (EPIPE) or the
+ * write fails. This is the reliable "the caller actually received it" signal:
+ * use it to gate side effects that must only happen on genuine delivery (e.g.
+ * acking a collected result). A killed process never resolves at all — also
+ * safe, since the gated side effect then never runs.
+ */
+export declare function writeStdout(s: string): Promise<boolean>;
+export declare function diag(message: string): void;
+/** Translate an `ApiError` into the clean CLI error a leaf should surface.
+ *  Three tiers, in priority order:
+ *   1. Daemon-down (`daemon_unavailable`) → a `network`-class `CrtrError`
+ *      so the exit code and next-hint match the operational failure it is.
+ *   2. A server-thrown `InputError` round-trips its FULL structured payload
+ *      through `toErrorBody` into `ApiError.details` (`{error,message,next,…}`) —
+ *      reconstruct it verbatim so a gate/guard error (revive reopen-gate, push
+ *      worktree/finalization guard, …) surfaces byte-for-byte as the leaf raised
+ *      it before the re-plumb, preserving its SPECIFIC code + next.
+ *   3. Otherwise map status→code (`STATUS_TO_CLI_CODE`) with the server message
+ *      and a caller-supplied-or-default `next`. */
+export declare function apiErrorToCliError(err: ApiError, next?: string): CrtrError;
+/** Terminal error handler. Command-level failures (bad input, not-found,
+ *  ambiguous) surface as the JSON response on stdout so the caller parses one
+ *  contract. A daemon `ApiError` is translated to that same clean contract
+ *  (`apiErrorToCliError`) as a safety net for any leaf that lets it propagate.
+ *  Runtime/internal failures go to stderr as `{error:"internal"}` — raw traces
+ *  never reach the agent. Exits non-zero either way. */
+export declare function handle(e: unknown): void;
+export {};

package/dist/core/io.js

@@ -0,0 +1,7 @@
+var w=Object.defineProperty;var n=(e,t)=>w(e,"name",{value:t,configurable:!0});import{appendFileSync as x,statSync as E}from"node:fs";import{CrtrError as a}from"./errors.js";import{ExitCode as c}from"../types.js";import{PREVIEW_RESULT_PATH_ENV as m}from"./preview-result-path.js";import{renderError as b}from"./render.js";import{ApiError as T}from"../api/index.js";let d=!1,u;const _=256*1024;function W(e){const t=process.env[m];u=t===void 0||t===""?void 0:{path:e,jsonl:[]}}n(W,"beginPreview");function f(e){const t=process.env[m];if(t===void 0||t==="")return;const s=`${JSON.stringify({path:u?.path??"",...e})}
+`;try{if((E(t,{throwIfNoEntry:!1})?.size??0)+Buffer.byteLength(s,"utf8")>_)return;x(t,s,"utf8")}catch{}}n(f,"publishPreview");function k(e){u!==void 0&&(e!=null?f({result:e}):(u.jsonl.length>0||u.error!==void 0)&&f({...u.jsonl.length>0?{jsonl:u.jsonl}:{},...u.error===void 0?{}:{error:u.error}}))}n(k,"publishPreviewResult");function y(e){u?.jsonl.push(e)}n(y,"recordPreviewLine");function B(e){try{const t=JSON.parse(e);t!==null&&typeof t=="object"&&!Array.isArray(t)&&y(t)}catch{}}n(B,"recordPreviewJsonLine");function F(e){u!==void 0&&(u.error=e)}n(F,"recordPreviewError");function G(e){d=e}n(G,"setJsonOutput");function K(){return d}n(K,"isJsonOutput");class h extends a{static{n(this,"InputError")}payload;constructor(t,s=c.USAGE){super(t.error,t.message,s,{...t}),this.name="InputError",this.payload=t}}async function q(){if(process.stdin.isTTY)return"";const e=[];for await(const t of process.stdin)e.push(t);return Buffer.concat(e).toString("utf8")}n(q,"readStdinRaw");async function D(e=200){return process.stdin.isTTY?"":await new Promise(t=>{const s=[];let o=!1;const r=n(()=>{o||(o=!0,clearTimeout(g),process.stdin.removeListener("data",i),process.stdin.removeListener("end",p),process.stdin.removeListener("error",l),process.stdin.pause(),t(Buffer.concat(s).toString("utf8")))},"finish"),i=n(S=>s.push(S),"onData"),p=n(()=>r(),"onEnd"),l=n(()=>r(),"onError"),g=setTimeout(r,e);process.stdin.on("data",i),process.stdin.on("end",p),process.stdin.on("error",l),process.stdin.resume()})}n(D,"peekStdinRaw");function V(e){process.stdout.write(JSON.stringify(e,null,2)+`
+`)}n(V,"emit");function Y(e){y(e),process.stdout.write(JSON.stringify(e)+`
+`)}n(Y,"emitLine");function M(e){return new Promise(t=>{let s=!1;const o=n(i=>{i.code==="EPIPE"&&r(!1)},"onErr"),r=n(i=>{s||(s=!0,process.stdout.off("error",o),t(i))},"finish");process.stdout.on("error",o);try{process.stdout.write(e,i=>r(i==null))}catch{r(!1)}})}n(M,"writeStdout");function z(e){process.stderr.write(e+`
+`)}n(z,"diag");function O(e){if(e instanceof h)return e.payload;const t=e.details!==void 0?e.details:{},s=t.primaryCompleted===!0&&t.result!==null&&typeof t.result=="object"&&!Array.isArray(t.result)?N(t.result):void 0,o=t.next!==void 0?t.next:"Inspect the error and adjust the call. See -h for the schema.",r={error:e.code,message:e.message,received:t.received,field:t.field,...typeof t.http_status=="number"?{http_status:t.http_status}:{}};return s===void 0?{...r,next:o}:{...r,primaryCompleted:!0,result:s,next:o}}n(O,"payloadOf");function N(e){const t=new WeakSet;try{const s=JSON.stringify(e,(o,r)=>{if(typeof r=="bigint")return{$crtrType:"bigint",value:r.toString()};if(typeof r=="number"&&!Number.isFinite(r))return{$crtrType:"number",value:String(r)};if(typeof r>"u"||typeof r=="function"||typeof r=="symbol")return{$crtrType:typeof r};if(r!==null&&typeof r=="object"){if(t.has(r))return{$crtrType:"circular"};t.add(r)}return r});if(s!==void 0){const o=JSON.parse(s);if(o!==null&&typeof o=="object"&&!Array.isArray(o))return o}}catch{}return{$crtrType:"unavailable",message:"The completed primary result could not be represented as JSON."}}n(N,"jsonSafeResult");const R={400:"invalid_request",404:"not_found",409:"conflict",422:"unprocessable"};function A(e,t){if(e.code==="daemon_restarting")return new a("daemon_restarting",e.message,c.NETWORK,{next:"crtrd is now on the new generation \u2014 retry the command."});if(e.code==="layout_migration_required")return new a("layout_migration_required",e.message,c.NETWORK,{next:"Run `crtr sys migrate` while the runtime is offline, then restart it."});if(e.code==="daemon_unavailable")return new a("daemon_unavailable",e.message,c.NETWORK,{next:"Start it with `crtr sys daemon start`, then retry."});if(e.status===503)return new a(e.code,e.message,c.NETWORK,{next:t??"Retry the command; if it persists, inspect the unavailable service named in the error."});const s=e.details,o=Array.isArray(s?.violations)?s.violations.map(i=>`${String(i.field)} ${String(i.problem)}${i.received!==void 0?` (received ${JSON.stringify(i.received)})`:""}`):[],r=s&&typeof s.error=="string"&&typeof s.message=="string"&&typeof s.next=="string"?s:{error:R[e.status]??e.code,message:o.length>0?`${e.message}: ${o.join("; ")}`:e.message,next:t??(e.status>=500?"This is a crtr bug, not a bad call. Retry; if it persists, report it (the daemon log holds the full cause).":e.status===404?"List nodes with `crtr node inspect list`.":"Inspect the error and adjust the call. See -h for the schema.")};return new h(r,P(r.error,e.status))}n(A,"apiErrorToCliError");function P(e,t){return e==="not_found"||t===404?c.NOT_FOUND:e==="ambiguous"?c.AMBIGUOUS:c.USAGE}n(P,"exitForCliCode");function j(e){if(e instanceof T){j(A(e));return}if(e instanceof a){const o=O(e);u!==void 0&&f({error:o});const r=d?JSON.stringify(o,null,2):b(o);process.stdout.write(r+`
+`),process.exitCode=e.exitCode;return}const t=e,s=t!=null&&typeof t.message=="string"?t.message:String(e);process.stderr.write(JSON.stringify({error:"internal",message:s,next:"This is a crtr bug, not a bad call. Retry; if it persists, report it."},null,2)+`
+`),process.exitCode=c.GENERAL}n(j,"handle");export{h as InputError,_ as PREVIEW_RESULT_MAX_BYTES,A as apiErrorToCliError,W as beginPreview,z as diag,V as emit,Y as emitLine,j as handle,K as isJsonOutput,D as peekStdinRaw,k as publishPreviewResult,q as readStdinRaw,F as recordPreviewError,B as recordPreviewJsonLine,y as recordPreviewLine,G as setJsonOutput,M as writeStdout};