@north-light/crouter 0.3.318 → 0.3.320

package/dist/core/installed-plugins.js

@@ -1,78 +1 @@
-// installed-plugins.ts — the LEAF-LEVEL installed-plugin reader: list the
-// plugin packages physically present under one scope root, with their
-// manifests and enabled-state from that root's config.json `plugins` block.
-//
-// This lives below resolver.ts (which re-exports it for its existing callers)
-// so that config.ts can layer plugin-declared launch config (`kinds`) into
-// `readMergedLaunchConfig` without an import cycle: resolver.ts imports
-// config.ts, so config.ts can never import resolver.ts. Imports here stay
-// leaf-safe: types, fs-utils, manifest only.
-import { join } from 'node:path';
-import { CONFIG_FILE } from '../types.js';
-import { listDirs, pathExists, readJsonIfExists } from './fs-utils.js';
-import { readPluginManifest } from './manifest.js';
-import { awaitBundleSwap, bundleSwapInFlightElsewhere } from './plugin-swap-lock.js';
-import { userStore } from './scoped-state/paths.js';
-import { readRawSettings } from './scoped-state/settings.js';
-function pluginConfigForRoot(scope, root) {
-    const store = scope === 'user' ? userStore(root) : undefined;
-    const cfg = store
-        ? readRawSettings({ store, key: 'user', kind: 'user', root: store.root })
-        : readJsonIfExists(join(root, CONFIG_FILE));
-    return cfg && cfg.plugins && typeof cfg.plugins === 'object' ? cfg.plugins : {};
-}
-/**
- * A bundle-plugin swap replaces `<plugins>/<name>` with two renames, so there
- * is a window in which the config names a plugin whose directory is not there.
- * A list taken inside that window would drop a plugin that is installed and
- * about to be present again — the caller would build a command tree missing it.
- *
- * That exact signal — named in config, absent on disk — is what we re-check,
- * and only when another process's swap lock says a swap is actually running: a
- * genuinely deleted directory holds no lock and is reported as gone at once.
- * Every normal invocation, where each config-named plugin has its directory,
- * pays one Set lookup per name and nothing else.
- */
-function swapsToWaitOut(scopeRootPath, cfg, present) {
-    const names = Object.keys(cfg);
-    if (names.every((name) => present.has(name)))
-        return [];
-    return names.filter((name) => !present.has(name) && bundleSwapInFlightElsewhere(scopeRootPath, name));
-}
-export function listInstalledPluginsInRoot(scope, scopeRootPath) {
-    const dir = join(scopeRootPath, 'plugins');
-    if (!pathExists(dir))
-        return [];
-    const cfg = pluginConfigForRoot(scope, scopeRootPath);
-    const first = collectInstalledPlugins(scope, dir, cfg);
-    const waiting = swapsToWaitOut(scopeRootPath, cfg, new Set(first.map((plugin) => plugin.name)));
-    if (waiting.length === 0)
-        return first;
-    for (const name of waiting)
-        awaitBundleSwap(scopeRootPath, name);
-    // One re-list, never a loop: the second read is taken after every swap we
-    // observed has finished. A swap that starts after it is a package this
-    // invocation was never going to see anyway.
-    return collectInstalledPlugins(scope, dir, cfg);
-}
-function collectInstalledPlugins(scope, dir, cfg) {
-    const out = [];
-    for (const name of listDirs(dir)) {
-        const root = join(dir, name);
-        const manifest = readPluginManifest(root);
-        if (!manifest)
-            continue;
-        const entry = cfg[name];
-        const version = typeof entry?.version === 'string' ? entry.version : manifest.version;
-        out.push({
-            name,
-            scope,
-            root,
-            manifest,
-            enabled: typeof entry?.enabled === 'boolean' ? entry.enabled : true,
-            sourceMarketplace: typeof entry?.source_marketplace === 'string' ? entry.source_marketplace : undefined,
-            version,
-        });
-    }
-    return out;
-}
+var m=Object.defineProperty;var f=(r,n)=>m(r,"name",{value:n,configurable:!0});import{join as a}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";function S(r,n){const e=r==="user"?k(n):void 0,t=e?v({store:e,key:"user",kind:"user",root:e.root}):w(a(n,p));return t&&t.plugins&&typeof t.plugins=="object"?t.plugins:{}}f(S,"pluginConfigForRoot");function h(r,n,e){const t=Object.keys(n);return t.every(o=>e.has(o))?[]:t.filter(o=>!e.has(o)&&I(r,o))}f(h,"swapsToWaitOut");function B(r,n){const e=a(n,"plugins");if(!d(e))return[];const t=S(r,n),o=l(r,e,t),u=h(n,t,new Set(o.map(i=>i.name)));if(u.length===0)return o;for(const i of u)b(n,i);return l(r,e,t)}f(B,"listInstalledPluginsInRoot");function l(r,n,e){const t=[];for(const o of g(n)){const u=a(n,o),i=y(u);if(!i)continue;const s=e[o],c=typeof s?.version=="string"?s.version:i.version;t.push({name:o,scope:r,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(l,"collectInstalledPlugins");export{B as listInstalledPluginsInRoot};

package/dist/core/io.js

@@ -1,356 +1,7 @@
-// The agent-facing I/O contract. Flags and positional args on input; stdout is
-// agent-ready markdown/XML the caller acts on directly (the result rendered FOR
-// the model, not data it parses); structured errors; stderr is diagnostics only
-// and never carries the result. The raw JSON object is available behind the
-// `--json` global for tooling. See the cli-design reference.
-import { appendFileSync, statSync } from 'node:fs';
-import { CrtrError } from './errors.js';
-import { ExitCode } from '../types.js';
-import { PREVIEW_RESULT_PATH_ENV } from './preview-result-path.js';
-import { renderError } from './render.js';
-import { ApiError } from '../api/index.js';
-// output mode — prose (default) vs raw JSON (--json global, for tooling)
-let jsonOutput = false;
-let preview;
-/** 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 const PREVIEW_RESULT_MAX_BYTES = 256 * 1024;
-/** Begin collecting the current leaf's structured response, if its caller
- * supplied the private per-tool-call result path. */
-export function beginPreview(path) {
-    const resultPath = process.env[PREVIEW_RESULT_PATH_ENV];
-    preview = resultPath === undefined || resultPath === '' ? undefined : { path, jsonl: [] };
-}
-function publishPreview(record) {
-    const resultPath = process.env[PREVIEW_RESULT_PATH_ENV];
-    if (resultPath === undefined || resultPath === '')
-        return;
-    const line = `${JSON.stringify({ path: preview?.path ?? '', ...record })}\n`;
-    try {
-        const spent = statSync(resultPath, { throwIfNoEntry: false })?.size ?? 0;
-        if (spent + Buffer.byteLength(line, 'utf8') > PREVIEW_RESULT_MAX_BYTES)
-            return;
-        appendFileSync(resultPath, line, 'utf8');
-    }
-    catch {
-        // Preview transport is optional UI metadata. Its failure must never alter
-        // the CLI's stdout/error contract.
-    }
-}
-/** Publish the single-object or collected JSONL result after leaf dispatch. */
-export function publishPreviewResult(result) {
-    if (preview === undefined)
-        return;
-    if (result !== undefined && result !== null)
-        publishPreview({ result });
-    else if (preview.jsonl.length > 0 || preview.error !== undefined) {
-        publishPreview({ ...(preview.jsonl.length > 0 ? { jsonl: preview.jsonl } : {}), ...(preview.error === undefined ? {} : { error: preview.error }) });
-    }
-}
-/** Mirror a structured record whose caller renders it itself instead of using
- * the generic dispatcher (JSONL and event-stream leaves). */
-export function recordPreviewLine(obj) {
-    preview?.jsonl.push(obj);
-}
-/** Preserve a verbatim JSONL stream's structured frames without changing the
- * bytes written to stdout. Invalid third-party lines remain raw-only. */
-export function recordPreviewJsonLine(line) {
-    try {
-        const value = JSON.parse(line);
-        if (value !== null && typeof value === 'object' && !Array.isArray(value))
-            recordPreviewLine(value);
-    }
-    catch { /* a malformed remote frame remains the command's raw truth */ }
-}
-/** Record a terminal streaming failure that correctly remains off stdout
- * because prior frames have already been delivered. */
-export function recordPreviewError(payload) {
-    if (preview !== undefined)
-        preview.error = payload;
-}
-/** Set by the dispatcher when `--json` is present anywhere in argv. */
-export function setJsonOutput(v) {
-    jsonOutput = v;
-}
-/** True when the caller asked for raw JSON instead of rendered prose. */
-export function isJsonOutput() {
-    return jsonOutput;
-}
-/** A command-level failure: surfaces as the JSON response on stdout. */
-export class InputError extends CrtrError {
-    payload;
-    constructor(payload, exitCode = ExitCode.USAGE) {
-        super(payload.error, payload.message, exitCode, { ...payload });
-        this.name = 'InputError';
-        this.payload = payload;
-    }
-}
-// stdin
-/** 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 async function readStdinRaw() {
-    if (process.stdin.isTTY)
-        return '';
-    const chunks = [];
-    for await (const chunk of process.stdin)
-        chunks.push(chunk);
-    return Buffer.concat(chunks).toString('utf8');
-}
-/** 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 async function peekStdinRaw(timeoutMs = 200) {
-    if (process.stdin.isTTY)
-        return '';
-    return await new Promise((resolve) => {
-        const chunks = [];
-        let settled = false;
-        const finish = () => {
-            if (settled)
-                return;
-            settled = true;
-            clearTimeout(timer);
-            process.stdin.removeListener('data', onData);
-            process.stdin.removeListener('end', onEnd);
-            process.stdin.removeListener('error', onError);
-            process.stdin.pause();
-            resolve(Buffer.concat(chunks).toString('utf8'));
-        };
-        const onData = (chunk) => chunks.push(chunk);
-        const onEnd = () => finish();
-        const onError = () => finish();
-        const timer = setTimeout(finish, timeoutMs);
-        process.stdin.on('data', onData);
-        process.stdin.on('end', onEnd);
-        process.stdin.on('error', onError);
-        process.stdin.resume();
-    });
-}
-// stdout — the result, nothing else
-/** 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 function emit(obj) {
-    process.stdout.write(JSON.stringify(obj, null, 2) + '\n');
-}
-/** One JSONL record. Call per event in a stream; partial reads stay parseable. */
-export function emitLine(obj) {
-    recordPreviewLine(obj);
-    process.stdout.write(JSON.stringify(obj) + '\n');
-}
-/**
- * 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 function writeStdout(s) {
-    return new Promise((resolve) => {
-        let settled = false;
-        const onErr = (e) => {
-            if (e.code === 'EPIPE')
-                finish(false);
-        };
-        const finish = (ok) => {
-            if (settled)
-                return;
-            settled = true;
-            process.stdout.off('error', onErr);
-            resolve(ok);
-        };
-        process.stdout.on('error', onErr);
-        try {
-            process.stdout.write(s, (err) => finish(err === null || err === undefined));
-        }
-        catch {
-            finish(false);
-        }
-    });
-}
-// stderr — diagnostics the agent MAY capture, never the result
-export function diag(message) {
-    process.stderr.write(message + '\n');
-}
-// errors
-function payloadOf(e) {
-    if (e instanceof InputError)
-        return e.payload;
-    const d = (e.details !== undefined ? e.details : {});
-    const result = d.primaryCompleted === true
-        && d.result !== null
-        && typeof d.result === 'object'
-        && !Array.isArray(d.result)
-        ? jsonSafeResult(d.result)
-        : undefined;
-    const next = d.next !== undefined
-        ? d.next
-        : 'Inspect the error and adjust the call. See -h for the schema.';
-    const base = {
-        error: e.code,
-        message: e.message,
-        received: d.received,
-        field: d.field,
-        ...(typeof d.http_status === 'number' ? { http_status: d.http_status } : {}),
-    };
-    return result === undefined
-        ? { ...base, next }
-        : { ...base, primaryCompleted: true, result, next };
-}
-/** Detach completed results from getters/prototypes and keep every error sink
- * JSON-safe. Tagged values preserve a truthful representation when a trusted
- * primary violates its declared JSON result contract. */
-function jsonSafeResult(result) {
-    const seen = new WeakSet();
-    try {
-        const encoded = JSON.stringify(result, (_key, value) => {
-            if (typeof value === 'bigint')
-                return { $crtrType: 'bigint', value: value.toString() };
-            if (typeof value === 'number' && !Number.isFinite(value))
-                return { $crtrType: 'number', value: String(value) };
-            if (typeof value === 'undefined' || typeof value === 'function' || typeof value === 'symbol') {
-                return { $crtrType: typeof value };
-            }
-            if (value !== null && typeof value === 'object') {
-                if (seen.has(value))
-                    return { $crtrType: 'circular' };
-                seen.add(value);
-            }
-            return value;
-        });
-        if (encoded !== undefined) {
-            const decoded = JSON.parse(encoded);
-            if (decoded !== null && typeof decoded === 'object' && !Array.isArray(decoded)) {
-                return decoded;
-            }
-        }
-    }
-    catch { /* a throwing getter/toJSON must not suppress the partial failure */ }
-    return {
-        $crtrType: 'unavailable',
-        message: 'The completed primary result could not be represented as JSON.',
-    };
-}
-// ApiError → clean CLI error — the ONE shared translation (plan C-5)
-//
-// A daemon `ApiError` is NOT a `CrtrError`, so left unhandled it falls through
-// `handle()` as an "internal crtr bug" — the wrong UX for an operational
-// failure. This is the single place that maps it back to the clean, structured
-// error the pre-API leaves surfaced, so every re-plumbed verb shares one
-// contract instead of re-implementing the mapping per command. io.ts importing
-// `ApiError` from `src/api` is canvas-clean (src/api is Node-built-ins only).
-/** Map a daemon HTTP status to the stable CLI error code the pre-API leaves
- *  used, so agent-facing error contracts survive the re-plumb. Used only as the
- *  fallback when the server did NOT round-trip a full structured payload. */
-const STATUS_TO_CLI_CODE = {
-    400: 'invalid_request',
-    404: 'not_found',
-    409: 'conflict',
-    422: 'unprocessable',
-    503: 'daemon_unavailable',
-};
-/** Translate an `ApiError` into the clean CLI error a leaf should surface.
- *  Three tiers, in priority order:
- *   1. Daemon-down (503 / `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 function apiErrorToCliError(err, next) {
-    // A handover is NOT a down daemon: the successor is already up (the client
-    // waited for its /healthz), so telling anyone to start one is wrong — the
-    // only thing left is to re-issue the call.
-    if (err.code === 'daemon_restarting') {
-        return new CrtrError('daemon_restarting', err.message, ExitCode.NETWORK, {
-            next: 'crtrd is now on the new generation — retry the command.',
-        });
-    }
-    if (err.status === 503 || err.code === 'daemon_unavailable') {
-        return new CrtrError('daemon_unavailable', err.message, ExitCode.NETWORK, {
-            next: 'Start it with `crtr sys daemon start`, then retry.',
-        });
-    }
-    const d = err.details;
-    const payload = d && typeof d.error === 'string' && typeof d.message === 'string' && typeof d.next === 'string'
-        ? d
-        : {
-            error: STATUS_TO_CLI_CODE[err.status] ?? err.code,
-            message: err.message,
-            next: next ??
-                (err.status >= 500
-                    ? 'This is a crtr bug, not a bad call. Retry; if it persists, report it (the daemon log holds the full cause).'
-                    : err.status === 404
-                        ? 'List nodes with `crtr node inspect list`.'
-                        : 'Inspect the error and adjust the call. See -h for the schema.'),
-        };
-    // Preserve the exit-code class the server leaf carried instead of collapsing
-    // every non-503 to USAGE(2): a not-found (404 / `not_found`) surfaces exit 3
-    // and an ambiguous match exit 4, matching the codes the local-only leaves
-    // (memory/pkg/sys) still emit so the taxonomy stays uniform across the CLI.
-    return new InputError(payload, exitForCliCode(payload.error, err.status));
-}
-/** The `ExitCode` class a reconstructed API error should carry, keyed off the
- *  round-tripped CLI code (and the 404 status as the not-found signal — the
- *  server maps NOT_FOUND's exit class to status 404, but folds AMBIGUOUS and
- *  USAGE both onto 400, so `ambiguous` is recoverable only from the code). */
-function exitForCliCode(code, status) {
-    if (code === 'not_found' || status === 404)
-        return ExitCode.NOT_FOUND;
-    if (code === 'ambiguous')
-        return ExitCode.AMBIGUOUS;
-    return ExitCode.USAGE;
-}
-/** 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 function handle(e) {
-    if (e instanceof ApiError) {
-        handle(apiErrorToCliError(e));
-        return;
-    }
-    if (e instanceof CrtrError) {
-        const payload = payloadOf(e);
-        if (preview !== undefined)
-            publishPreview({ error: payload });
-        const out = jsonOutput
-            ? JSON.stringify(payload, null, 2)
-            : renderError(payload);
-        process.stdout.write(out + '\n');
-        process.exitCode = e.exitCode;
-        return;
-    }
-    const err = e;
-    const message = err !== null && err !== undefined && typeof err.message === 'string'
-        ? err.message
-        : String(e);
-    process.stderr.write(JSON.stringify({
-        error: 'internal',
-        message,
-        next: 'This is a crtr bug, not a bad call. Retry; if it persists, report it.',
-    }, null, 2) + '\n');
-    process.exitCode = ExitCode.GENERAL;
-}
+var x=Object.defineProperty;var n=(e,t)=>x(e,"name",{value:t,configurable:!0});import{appendFileSync as E,statSync as w}from"node:fs";import{CrtrError as f}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 a=!1,i;const _=256*1024;function $(e){const t=process.env[m];i=t===void 0||t===""?void 0:{path:e,jsonl:[]}}n($,"beginPreview");function d(e){const t=process.env[m];if(t===void 0||t==="")return;const s=`${JSON.stringify({path:i?.path??"",...e})}
+`;try{if((w(t,{throwIfNoEntry:!1})?.size??0)+Buffer.byteLength(s,"utf8")>_)return;E(t,s,"utf8")}catch{}}n(d,"publishPreview");function B(e){i!==void 0&&(e!=null?d({result:e}):(i.jsonl.length>0||i.error!==void 0)&&d({...i.jsonl.length>0?{jsonl:i.jsonl}:{},...i.error===void 0?{}:{error:i.error}}))}n(B,"publishPreviewResult");function y(e){i?.jsonl.push(e)}n(y,"recordPreviewLine");function W(e){try{const t=JSON.parse(e);t!==null&&typeof t=="object"&&!Array.isArray(t)&&y(t)}catch{}}n(W,"recordPreviewJsonLine");function F(e){i!==void 0&&(i.error=e)}n(F,"recordPreviewError");function G(e){a=e}n(G,"setJsonOutput");function D(){return a}n(D,"isJsonOutput");class h extends f{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 V(){if(process.stdin.isTTY)return"";const e=[];for await(const t of process.stdin)e.push(t);return Buffer.concat(e).toString("utf8")}n(V,"readStdinRaw");async function Y(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",u),process.stdin.removeListener("end",p),process.stdin.removeListener("error",l),process.stdin.pause(),t(Buffer.concat(s).toString("utf8")))},"finish"),u=n(S=>s.push(S),"onData"),p=n(()=>r(),"onEnd"),l=n(()=>r(),"onError"),g=setTimeout(r,e);process.stdin.on("data",u),process.stdin.on("end",p),process.stdin.on("error",l),process.stdin.resume()})}n(Y,"peekStdinRaw");function K(e){process.stdout.write(JSON.stringify(e,null,2)+`
+`)}n(K,"emit");function M(e){y(e),process.stdout.write(JSON.stringify(e)+`
+`)}n(M,"emitLine");function q(e){return new Promise(t=>{let s=!1;const o=n(u=>{u.code==="EPIPE"&&r(!1)},"onErr"),r=n(u=>{s||(s=!0,process.stdout.off("error",o),t(u))},"finish");process.stdout.on("error",o);try{process.stdout.write(e,u=>r(u==null))}catch{r(!1)}})}n(q,"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 P={400:"invalid_request",404:"not_found",409:"conflict",422:"unprocessable",503:"daemon_unavailable"};function A(e,t){if(e.code==="daemon_restarting")return new f("daemon_restarting",e.message,c.NETWORK,{next:"crtrd is now on the new generation \u2014 retry the command."});if(e.status===503||e.code==="daemon_unavailable")return new f("daemon_unavailable",e.message,c.NETWORK,{next:"Start it with `crtr sys daemon start`, then retry."});const s=e.details,o=s&&typeof s.error=="string"&&typeof s.message=="string"&&typeof s.next=="string"?s:{error:P[e.status]??e.code,message: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(o,j(o.error,e.status))}n(A,"apiErrorToCliError");function j(e,t){return e==="not_found"||t===404?c.NOT_FOUND:e==="ambiguous"?c.AMBIGUOUS:c.USAGE}n(j,"exitForCliCode");function R(e){if(e instanceof T){R(A(e));return}if(e instanceof f){const o=O(e);i!==void 0&&d({error:o});const r=a?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(R,"handle");export{h as InputError,_ as PREVIEW_RESULT_MAX_BYTES,A as apiErrorToCliError,$ as beginPreview,z as diag,K as emit,M as emitLine,R as handle,D as isJsonOutput,Y as peekStdinRaw,B as publishPreviewResult,V as readStdinRaw,F as recordPreviewError,W as recordPreviewJsonLine,y as recordPreviewLine,G as setJsonOutput,q as writeStdout};

package/dist/core/keybindings/attach-control.js

@@ -1,42 +1 @@
-export const ATTACH_CONTROL_BINDINGS = [
-    { menuId: 'crtr.tmux.menu.attach.detach', actionId: 'crtr.attach.detach' },
-    { menuId: 'crtr.tmux.menu.attach.clear-or-detach', actionId: 'crtr.attach.clear-or-detach' },
-    { menuId: 'crtr.tmux.menu.attach.graph.toggle', actionId: 'crtr.attach.graph.toggle' },
-    { menuId: 'crtr.tmux.menu.attach.help.toggle', actionId: 'crtr.attach.help.toggle' },
-    { menuId: 'crtr.tmux.menu.attach.inbox.toggle', actionId: 'crtr.attach.inbox.toggle' },
-    { menuId: 'crtr.tmux.menu.attach.inbox-strip', actionId: 'crtr.attach.inbox-strip' },
-    { menuId: 'crtr.tmux.menu.attach.model-ladder.next', actionId: 'crtr.attach.model-ladder.next' },
-    { menuId: 'crtr.tmux.menu.attach.model-ladder.previous', actionId: 'crtr.attach.model-ladder.previous' },
-    { menuId: 'crtr.tmux.menu.attach.command.inspect', actionId: 'crtr.attach.command.inspect' },
-    { menuId: 'crtr.tmux.menu.attach.file-review', actionId: 'crtr.attach.file-review' },
-    { menuId: 'crtr.tmux.menu.attach.profile-files', actionId: 'crtr.attach.profile-files' },
-    { menuId: 'crtr.tmux.menu.attach.search', actionId: 'crtr.attach.search' },
-    { menuId: 'crtr.tmux.menu.attach.whip', actionId: 'crtr.attach.whip' },
-];
-const ATTACH_CONTROL_PREFIX = '\x1b_crtr;';
-const ATTACH_CONTROL_SUFFIX = '\x1b\\';
-const ATTACH_BINDING_IDS = new Set(ATTACH_CONTROL_BINDINGS.map(({ actionId }) => actionId));
-export function decodeAttachControlInput(data) {
-    if (!data.startsWith(ATTACH_CONTROL_PREFIX) || !data.endsWith(ATTACH_CONTROL_SUFFIX))
-        return undefined;
-    const actionId = data.slice(ATTACH_CONTROL_PREFIX.length, -ATTACH_CONTROL_SUFFIX.length);
-    return ATTACH_BINDING_IDS.has(actionId) ? actionId : undefined;
-}
-export function encodeAttachControlInput(actionId) {
-    return `${ATTACH_CONTROL_PREFIX}${actionId}${ATTACH_CONTROL_SUFFIX}`;
-}
-export function extractAttachControlInput(data) {
-    let match;
-    for (const { actionId } of ATTACH_CONTROL_BINDINGS) {
-        const encoded = encodeAttachControlInput(actionId);
-        const index = data.indexOf(encoded);
-        if (index >= 0 && (match === undefined || index < match.index))
-            match = { actionId, encoded, index };
-    }
-    if (match === undefined)
-        return undefined;
-    return {
-        actionId: match.actionId,
-        remaining: data.slice(0, match.index) + data.slice(match.index + match.encoded.length),
-    };
-}
+var u=Object.defineProperty;var c=(t,e)=>u(t,"name",{value:e,configurable:!0});const i=[{menuId:"crtr.tmux.menu.attach.detach",actionId:"crtr.attach.detach"},{menuId:"crtr.tmux.menu.attach.clear-or-detach",actionId:"crtr.attach.clear-or-detach"},{menuId:"crtr.tmux.menu.attach.graph.toggle",actionId:"crtr.attach.graph.toggle"},{menuId:"crtr.tmux.menu.attach.help.toggle",actionId:"crtr.attach.help.toggle"},{menuId:"crtr.tmux.menu.attach.inbox.toggle",actionId:"crtr.attach.inbox.toggle"},{menuId:"crtr.tmux.menu.attach.inbox-strip",actionId:"crtr.attach.inbox-strip"},{menuId:"crtr.tmux.menu.attach.model-ladder.next",actionId:"crtr.attach.model-ladder.next"},{menuId:"crtr.tmux.menu.attach.model-ladder.previous",actionId:"crtr.attach.model-ladder.previous"},{menuId:"crtr.tmux.menu.attach.command.inspect",actionId:"crtr.attach.command.inspect"},{menuId:"crtr.tmux.menu.attach.file-review",actionId:"crtr.attach.file-review"},{menuId:"crtr.tmux.menu.attach.profile-files",actionId:"crtr.attach.profile-files"},{menuId:"crtr.tmux.menu.attach.search",actionId:"crtr.attach.search"},{menuId:"crtr.tmux.menu.attach.whip",actionId:"crtr.attach.whip"}],r="\x1B_crtr;",a="\x1B\\",m=new Set(i.map(({actionId:t})=>t));function l(t){if(!t.startsWith(r)||!t.endsWith(a))return;const e=t.slice(r.length,-a.length);return m.has(e)?e:void 0}c(l,"decodeAttachControlInput");function h(t){return`${r}${t}${a}`}c(h,"encodeAttachControlInput");function x(t){let e;for(const{actionId:d}of i){const o=h(d),n=t.indexOf(o);n>=0&&(e===void 0||n<e.index)&&(e={actionId:d,encoded:o,index:n})}if(e!==void 0)return{actionId:e.actionId,remaining:t.slice(0,e.index)+t.slice(e.index+e.encoded.length)}}c(x,"extractAttachControlInput");export{i as ATTACH_CONTROL_BINDINGS,l as decodeAttachControlInput,h as encodeAttachControlInput,x as extractAttachControlInput};

package/dist/core/keybindings/background-bash.js

@@ -1,33 +1 @@
-import { formatGesture } from './match.js';
-import { resolveUserKeybindings } from './resolve.js';
-const MENU_OPEN = 'crtr.tmux.menu.open';
-const BACKGROUND_BASH = 'crtr.tmux.menu.background-bash';
-/** The tmux menu's own shift-aware selector rendering (bare key -> itself,
- *  shift+letter -> uppercase, shift+space -> a literal space) stays local
- *  because `runtime/tmux-bindings.ts` consumes this module through
- *  `keybindings/index.ts`; importing its private selector here would cycle. */
-function selectorLabel(stroke) {
-    const parts = stroke.split('+');
-    const key = parts.at(-1);
-    return parts.includes('shift') && /[a-z]/.test(key) ? key.toUpperCase() : key === 'space' ? ' ' : key;
-}
-/** The Alt+C -> b gesture pair for the background-bash tmux menu item, e.g.
- *  `Alt+C b`. Null when either the menu-open gesture or the background-bash
- *  selector is disabled (no bindings) — there is no fallback rendering for a
- *  disabled binding. Bindings default to the user's resolved config; callers
- *  holding a live snapshot (e.g. the attach viewer) pass it so a `/reload`
- *  rebind is honored. */
-export function backgroundBashShortcut(bindings = resolveUserKeybindings()) {
-    const menuOpen = bindings.gestures(MENU_OPEN);
-    const selector = bindings.gestures(BACKGROUND_BASH);
-    if (menuOpen.length === 0 || selector.length === 0)
-        return null;
-    return `${menuOpen.map(formatGesture).join(' / ')} ${selectorLabel(selector[0])}`;
-}
-/** Footer hint for the background-bash gesture: "<shortcut> to background", or
- *  null when disabled. No CLI fallback — the tmux gesture is the only way to
- *  invoke this handoff. */
-export function backgroundBashHint(bindings) {
-    const shortcut = backgroundBashShortcut(bindings);
-    return shortcut !== null ? `${shortcut} to background` : null;
-}
+var o=Object.defineProperty;var r=(e,t)=>o(e,"name",{value:t,configurable:!0});import{formatGesture as s}from"./match.js";import{resolveUserKeybindings as u}from"./resolve.js";const c="crtr.tmux.menu.open",a="crtr.tmux.menu.background-bash";function l(e){const t=e.split("+"),n=t.at(-1);return t.includes("shift")&&/[a-z]/.test(n)?n.toUpperCase():n==="space"?" ":n}r(l,"selectorLabel");function p(e=u()){const t=e.gestures(c),n=e.gestures(a);return t.length===0||n.length===0?null:`${t.map(s).join(" / ")} ${l(n[0])}`}r(p,"backgroundBashShortcut");function g(e){const t=p(e);return t!==null?`${t} to background`:null}r(g,"backgroundBashHint");export{g as backgroundBashHint,p as backgroundBashShortcut};