@north-light/cli 0.0.0-stage → 0.3.413

package/dist/core/runtime/stamp/protocol.d.ts

@@ -0,0 +1,90 @@
+export declare const CRTR_STAMP_CUSTOM_TYPE = "crtr-stamp";
+/** Envelope version. Readers switch on `(kind, v)`. */
+export declare const STAMP_SCHEMA_VERSION = 1;
+export interface StampEnvelope<K extends string = string, P = object> {
+    v: number;
+    kind: K;
+    payload: P;
+    /** Plugin/contributor fields, namespaced. The core writer never interprets them. */
+    ext?: Record<string, Record<string, unknown>>;
+}
+/** One session file belongs to one node: which node, and which crtr wrote it.
+ *  Makes the file self-describing off-box, where canvas.db is unavailable. */
+export interface SessionStampPayload {
+    node: string;
+    crtr: string;
+}
+/** Transport a person's words arrived on. crouter core knows the attach viewer;
+ *  other front doors announce their own channel. */
+export interface HumanOrigin {
+    type: 'human';
+    channel?: {
+        type: string;
+    };
+}
+/** The runtime kinds mirror the `<runtime kind="…">` card vocabulary. */
+export type RuntimeOriginKind = 'inbox' | 'wake' | 'revive' | 'restart-continuation' | 'stop-guard' | 'park' | 'recovery' | 'context-nudge' | 'kickoff';
+/** One durable inbox entry's attribution, as delivered. */
+export interface InboxOriginEntry {
+    from?: string;
+    fromName?: string;
+    kind: string;
+    tier: string;
+    ref?: string;
+}
+export interface RuntimeOrigin {
+    type: 'runtime';
+    kind: RuntimeOriginKind;
+    /** `wake` carries the fired cron's `WakeOrigin` under this key rather than
+     *  spread flat: WakeOrigin has its own `kind` (`node_birth` /
+     *  `schedule_revive`), which flat would overwrite the origin kind. */
+    wake?: {
+        kind: string;
+        ownerId: string | null;
+        ownerName?: string;
+        armedAt: string;
+        recur?: string | null;
+    };
+    /** `inbox` carries one element per delivered entry. */
+    entries?: InboxOriginEntry[];
+    /** Other kind-specific structured fields — the structure the seam holds,
+     *  where the card carries only prose. */
+    [field: string]: unknown;
+}
+export type MessageOrigin = HumanOrigin | RuntimeOrigin;
+export type MessageVisibility = 'visible' | 'internal';
+export interface MessageStampPayload {
+    /** The target message's own `timestamp` (unix ms) — the join key. */
+    msgTs: number;
+    /** Absent means the message arrived with no announced origin (unknown),
+     *  never a guess. */
+    origin?: MessageOrigin;
+    /** Absent means visible. Internal messages remain in the raw session and
+     *  carry their classification through transcript projections. */
+    visibility?: MessageVisibility;
+}
+export type SessionStamp = StampEnvelope<'session', SessionStampPayload>;
+export type MessageStamp = StampEnvelope<'message', MessageStampPayload>;
+/** A kickoff prompt is composed by the daemon but sent by the broker, in a
+ *  different process, so its origin rides the broker's spawn env instead of the
+ *  in-process announcement channel. */
+export declare const KICKOFF_ORIGIN_ENV = "CRTR_KICKOFF_ORIGIN";
+export declare function encodeKickoffOrigin(origin: MessageOrigin): string;
+/** The kickoff origin the spawner recorded, or null when this launch carried
+ *  none (an idle broker, or a launch predating the variable). */
+export declare function decodeKickoffOrigin(raw: string | undefined): MessageOrigin | null;
+/** The stamp envelope carried by one session entry, or null when the entry is
+ *  not a well-formed crtr-stamp. */
+export declare function readStampEntry(entry: unknown): StampEnvelope | null;
+/** Every well-formed stamp in `entries`, in file order. */
+export declare function readStamps(entries: readonly unknown[]): StampEnvelope[];
+/** The session stamp in force at the end of `entries` — a fork carries the
+ *  source node's stamp until the new node appends its own, so "latest" is what
+ *  a reader wants. */
+export declare function latestSessionStamp(entries: readonly unknown[]): SessionStamp | null;
+/** The stamp for the message persisted at `msgTs`. Late or revised metadata is
+ *  a second stamp with the same key, so the last one wins. */
+export declare function messageStampFor(entries: readonly unknown[], msgTs: number): MessageStamp | null;
+/** Who authored the message persisted at `msgTs`, or null when nothing
+ *  announced an origin for it. */
+export declare function originFor(entries: readonly unknown[], msgTs: number): MessageOrigin | null;

package/dist/core/runtime/stamp/protocol.js

@@ -0,0 +1 @@
+var s=Object.defineProperty;var e=(t,n)=>s(t,"name",{value:n,configurable:!0});const f="crtr-stamp",y=1,S="CRTR_KICKOFF_ORIGIN";function m(t){return JSON.stringify(t)}e(m,"encodeKickoffOrigin");function g(t){if(t===void 0||t.trim()==="")return null;let n;try{n=JSON.parse(t)}catch{return null}return!i(n)||n.type!=="human"&&n.type!=="runtime"?null:n}e(g,"decodeKickoffOrigin");function i(t){return typeof t=="object"&&t!==null&&!Array.isArray(t)}e(i,"isRecord");function l(t){if(!i(t))return null;const n=t;if(n.type!=="custom"||n.customType!==f)return null;const r=n.data;if(!i(r)||typeof r.v!="number"||typeof r.kind!="string"||!i(r.payload))return null;const o=r.ext;return o!==void 0&&!i(o)?null:r}e(l,"readStampEntry");function u(t){const n=[];for(const r of t){const o=l(r);o!==null&&n.push(o)}return n}e(u,"readStamps");function a(t){if(t.kind!=="session"||t.v!==1)return!1;const n=t.payload;return typeof n.node=="string"&&typeof n.crtr=="string"}e(a,"isSessionStamp");function c(t){return t.kind!=="message"||t.v!==1?!1:typeof t.payload.msgTs=="number"}e(c,"isMessageStamp");function _(t){let n=null;for(const r of u(t))a(r)&&(n=r);return n}e(_,"latestSessionStamp");function p(t,n){let r=null;for(const o of u(t))c(o)&&o.payload.msgTs===n&&(r=o);return r}e(p,"messageStampFor");function x(t,n){return p(t,n)?.payload.origin??null}e(x,"originFor");export{f as CRTR_STAMP_CUSTOM_TYPE,S as KICKOFF_ORIGIN_ENV,y as STAMP_SCHEMA_VERSION,g as decodeKickoffOrigin,m as encodeKickoffOrigin,_ as latestSessionStamp,p as messageStampFor,x as originFor,l as readStampEntry,u as readStamps};

package/dist/core/runtime/stop-guard.d.ts

@@ -0,0 +1,31 @@
+import type { NodeMeta } from '../canvas/types.js';
+/** Silas, 2026-09-30: a run's root that keeps stopping with its schema armed and
+ *  no `result.submit` is reprompted this many consecutive times, then left
+ *  dormant with the schema still armed, so the run reads `idle`. */
+export declare const RUN_SCHEMA_REPROMPT_LIMIT = 3;
+/** A root an app's `run.start` created: only that path stores run metadata
+ *  (`spawnNode` sets `metadata_json` from `opts.run` alone). Roots the person
+ *  starts from `crtr`, including `nodes.parse` extractions, also carry
+ *  `run_id = node_id` but keep the unbounded structured-output reprompt. */
+export declare function isAppRunRoot(node: Pick<NodeMeta, 'node_id' | 'parent' | 'run_id' | 'metadata_json'>): boolean;
+/** Whether a live app run root that stops now would be reprompted with its
+ *  armed schema: the run is still `running`, not `idle`, between its turn's end
+ *  and the reprompt's turn (D2-RES-10). Reads only; counts nothing. */
+export declare function runSchemaRepromptPending(node: NodeMeta): boolean;
+export { STALL_REPROMPT } from '../../shared/generated-context.js';
+export interface StopSignals {
+    /** Did the node call `push --final` (finish) this turn? */
+    pushedFinal: boolean;
+}
+export type StopAction = {
+    action: 'allow';
+    reason: 'awaiting' | 'scheduled' | 'finished' | 'dormant';
+} | {
+    action: 'reprompt';
+    reason: 'stalled';
+    message: string;
+};
+/** Decide what to do when a node stops. crtrd supplies every current-canvas
+ * fact; the broker contributes only whether its Pi-owned background job registry
+ * is still running work. */
+export declare function evaluateStop(nodeId: string, signals: StopSignals, backgroundJobsRunning?: boolean): StopAction;

package/dist/core/runtime/stop-guard.js

@@ -0,0 +1,8 @@
+var _=Object.defineProperty;var r=(t,e)=>_(t,"name",{value:e,configurable:!0});import{hasActiveLiveSubscription as S,hasLiveMessageWait as v,hasPendingCronWake as w,getNode as c}from"../canvas/index.js";import{contextDir as m}from"../canvas/node-agent-paths.js";import{activeBackgroundBashJobs as d}from"../bash-jobs.js";import{hasOpenReplyBearingRequestByRequester as O}from"../human/requests.js";import{formatCard as o,formatStructuredOutputReprompt as A,STALL_REPROMPT as L}from"../../shared/generated-context.js";import{readOutputRequest as f,readSchemaReprompts as N,writeSchemaReprompts as b}from"./structured-output.js";import{openDb as q}from"../canvas/db.js";import{prepared as x}from"../sqlite-statements.js";const h=3;function g(t){return t.parent==null&&t.run_id===t.node_id&&t.metadata_json!=null}r(g,"isAppRunRoot");function R(t){const e=N(t);return e.count===0?e:x(q(),`SELECT 1 FROM deliveries d JOIN messages m ON m.message_id = d.message_id
+    WHERE d.destination_id = ? AND d.wake = 1 AND m.kind IN ('message', 'completed') AND d.created_at > ? LIMIT 1`).get(t,e.at)!==void 0?{count:0,at:e.at}:e}r(R,"effectiveSchemaReprompts");function y(t){const{count:e}=R(t);return e>=h?!1:(b(t,{count:e+1,at:Date.now()}),!0)}r(y,"takeRunSchemaReprompt");function H(t){return t.pi_pid!=null&&g(t)&&f(t.node_id).state==="valid"&&R(t.node_id).count<h&&u(t.node_id,d(m(t.node_id)).length>0)===null}r(H,"runSchemaRepromptPending");import{STALL_REPROMPT as Y}from"../../shared/generated-context.js";function E(t,e){return o("stop-guard",{},A(JSON.stringify(e,null,2),t))}r(E,"formatValidStructuredOutputReprompt");function M(t){return o("stop-guard",{},`Structured-output request file is invalid and cannot be used: ${t}
+
+You have two options:
+1. Remove the invalid file (the output-schema.json in your node directory has been corrupted)
+2. Fix the corruption if you know the original request schema
+
+After resolving the file, call the \`submit_result\` tool again (with \`decline\` when the schema cannot be honestly satisfied). If this is unexpected, escalate to the user using \`crtr human send\`.`)}r(M,"formatInvalidStructuredOutputReprompt");function u(t,e){return w(t)?"scheduled":S(t)||v(t)||O(t)||e?"awaiting":null}r(u,"wakeCapableWait");function J(t,e,i=d(m(t)).length>0){if(e.pushedFinal)return{action:"allow",reason:"finished"};const a=f(t);if(a.state==="valid"){const l=u(t,i);if(l!==null)return{action:"allow",reason:l};const p=c(t);return p!==null&&g(p)&&!y(t)?{action:"allow",reason:"dormant"}:{action:"reprompt",reason:"stalled",message:E(a.request.request_id,a.request.schema)}}if(a.state==="invalid")return{action:"reprompt",reason:"stalled",message:M(a.error)};const n=c(t);if(n!==null&&(n.final_report!=null||n.status==="done"||n.status==="dead"||n.status==="canceled"))return{action:"allow",reason:"finished"};if(n!==null&&n.lifecycle==="resident")return{action:"allow",reason:"dormant"};const s=u(t,i);return s!==null?{action:"allow",reason:s}:{action:"reprompt",reason:"stalled",message:o("stop-guard",{},L)}}r(J,"evaluateStop");export{h as RUN_SCHEMA_REPROMPT_LIMIT,Y as STALL_REPROMPT,J as evaluateStop,g as isAppRunRoot,H as runSchemaRepromptPending};

package/dist/core/runtime/stop-signals.d.ts

@@ -0,0 +1,16 @@
+export interface StopSignals {
+    pushedFinal: boolean;
+}
+export type StopSignal = keyof StopSignals;
+/** Record a successful command outcome for this broker process. The stophook
+ * consumes the marker at settlement, so no broker-side canvas read is needed to
+ * recognize the command the node itself just completed. */
+export declare function markStopSignal(nodeId: string, signal: StopSignal, identity?: string): void;
+/** Consume command outcomes from this broker's just-settled turn. Markers from
+ * an earlier crashed broker are discarded rather than bleeding into its successor. */
+export declare function consumeStopSignals(nodeId: string, identity?: string): StopSignals;
+/** Discard any marker left by an earlier run of this same broker — a run that
+ * errored or was interrupted returns before settlement consumes its markers, and
+ * the pid stamp cannot tell those apart from the current run's. Called when a new
+ * user-directed run begins, never on an in-run retry. */
+export declare function clearStopSignals(nodeId: string): void;

package/dist/core/runtime/stop-signals.js

@@ -0,0 +1 @@
+var S=Object.defineProperty;var t=(r,n)=>S(r,"name",{value:n,configurable:!0});import{existsSync as l,mkdirSync as m,readFileSync as g,rmSync as s,writeFileSync as y}from"node:fs";import{join as d}from"node:path";import{jobDir as f}from"../canvas/paths.js";const u=["pushedFinal"];function e(r,n){return d(f(r),`.${n}`)}t(e,"signalPath");function a(){return process.env.CRTR_BROKER_PID??String(process.pid)}t(a,"brokerIdentity");function R(r,n,o=a()){m(f(r),{recursive:!0}),y(e(r,n),o)}t(R,"markStopSignal");function b(r,n=a()){const o={pushedFinal:!1};for(const c of u){const i=e(r,c);if(!l(i))continue;const p=g(i,"utf8").trim();s(i,{force:!0}),p===n&&(o[c]=!0)}return o}t(b,"consumeStopSignals");function P(r){for(const n of u)s(e(r,n),{force:!0})}t(P,"clearStopSignals");export{P as clearStopSignals,b as consumeStopSignals,R as markStopSignal};

package/dist/core/runtime/stream-watchdog.d.ts

@@ -0,0 +1,54 @@
+/**
+ * A single-timer dead-man's switch: `poke(token)` (re)arms it, `clear()`
+ * disarms it, and `onStall(token)` fires exactly once if `poke()` isn't called
+ * again within `ms`. The broker pokes it on relayed engine events while a turn
+ * is awaiting the provider and clears it at `agent_end` / tool execution — see
+ * broker.ts `relayEvent`.
+ *
+ * The `token` is an opaque generation stamp: each arm captures the token passed
+ * to its `poke()`, and `onStall` receives exactly that token. The broker bumps
+ * a session generation on every rebind, so a timer armed against a since-
+ * superseded session hands its stale generation to `onStall`, which no-ops it
+ * instead of aborting the live replacement session.
+ */
+export declare class StreamWatchdog {
+    private readonly onStall;
+    private timer;
+    private paused;
+    private readonly ms;
+    constructor(onStall: (token: number) => void, ms?: number);
+    /** Proof of progress — (re)arm the timer for `token`, canceling any prior
+     *  countdown. The fired `onStall` receives THIS arm's token. Inert while
+     *  paused (a deliberate known-stream wait, see `pause`), so a poke relayed
+     *  during the wait cannot rearm the disarmed watchdog. */
+    poke(token: number): void;
+    /** Turn over (or broker tearing down) — no more relay expected until the
+     *  next `poke()`. Idempotent. Does NOT touch the paused flag. */
+    clear(): void;
+    /** Enter a deliberate known-stream wait: disarm the timer AND make `poke()`
+     *  inert, so an intentional provider cooldown (which relays no engine events)
+     *  is not mistaken for a wedged network stream. Paired with `resume()`. */
+    pause(): void;
+    /** Leave a known-stream wait and rearm against `token` (the live session
+     *  generation). A no-op arm if the turn has already moved on — the broker only
+     *  resumes while still streaming and idle of tools. */
+    resume(token: number): void;
+    /** Fully disarm AND unpause — the lifecycle reset used at agent_end, session
+     *  rebind, and dispose so a superseded known-stream wait can never strand a
+     *  later session in a paused state. */
+    reset(): void;
+}
+/** Broker release policy for a deliberate wait: only an unchanged provider
+ * stream resumes; a completed/rebound turn or active tool fully resets. */
+export declare function releaseKnownStreamWait(watchdog: StreamWatchdog, token: number, sessionIsStreaming: boolean, hasExecutingTools: boolean): void;
+export declare const KNOWN_STREAM_WAIT_UI: unique symbol;
+/** The broker-supplied control: given a finite future deadline (epoch ms), pause
+ *  the dead-stream watchdog and return a release fn that resumes it. */
+export type KnownStreamWaitControl = (deadlineMs: number) => () => void;
+/** Run a deliberate, deadline-bounded provider wait as KNOWN liveness so the
+ *  broker's dead-stream watchdog does not abort the intentional silence. Looks up
+ *  the broker-owned control on the extension UI context (keyed by
+ *  `KNOWN_STREAM_WAIT_UI`) and holds the watchdog paused for the duration of
+ *  `op`, releasing in `finally`. Falls back to a plain `op()` when no broker
+ *  control is present (unit tests, non-broker hosts). */
+export declare function withKnownStreamWait(ui: unknown, deadlineMs: number, op: () => Promise<void>): Promise<void>;

package/dist/core/runtime/stream-watchdog.js

@@ -0,0 +1 @@
+var a=Object.defineProperty;var s=(e,t)=>a(e,"name",{value:t,configurable:!0});import{envStreamWatchdogMs as o}from"../../shared/env.js";class f{static{s(this,"StreamWatchdog")}onStall;timer;paused=!1;ms;constructor(t,i){this.onStall=t,this.ms=i??o()}poke(t){this.paused||(this.clear(),this.timer=setTimeout(()=>{this.timer=void 0,this.onStall(t)},this.ms),typeof this.timer.unref=="function"&&this.timer.unref())}clear(){this.timer!==void 0&&(clearTimeout(this.timer),this.timer=void 0)}pause(){this.clear(),this.paused=!0}resume(t){this.paused=!1,this.poke(t)}reset(){this.paused=!1,this.clear()}}function h(e,t,i,r){i&&!r?e.resume(t):e.reset()}s(h,"releaseKnownStreamWait");const u=Symbol.for("@crouton-kit/crtr:known-stream-wait");async function l(e,t,i){const r=e?.[u];if(typeof r!="function"){await i();return}const n=r(t);try{await i()}finally{try{n()}catch{}}}s(l,"withKnownStreamWait");export{u as KNOWN_STREAM_WAIT_UI,f as StreamWatchdog,h as releaseKnownStreamWait,l as withKnownStreamWait};

package/dist/core/runtime/structured-output.d.ts

@@ -0,0 +1,91 @@
+import type { DeclinedResult } from '../canvas/types.js';
+/** The pi tool a node calls to answer its pending structured-output request
+ *  (registered by canvas-structured-output; `run.get` names it `submitting_result`). */
+export declare const SUBMIT_RESULT_TOOL = "submit_result";
+export type StructuredOutputMode = 'terminal' | 'oneoff';
+export interface StructuredOutputRequest {
+    request_id: string;
+    mode: StructuredOutputMode;
+    schema: Record<string, unknown>;
+    /** The one-off request's message id; its answer ends the requester's message watch. */
+    requestMessageId?: string;
+}
+/** Tri-state result of reading a structured-output request file. */
+export type StructuredOutputState = {
+    state: 'absent';
+} | {
+    state: 'valid';
+    request: StructuredOutputRequest;
+} | {
+    state: 'invalid';
+    error: string;
+};
+/** The `--output-schema` transport clause, rendered verbatim by every leaf that
+ *  accepts one. Declared once so the call sites cannot drift apart. */
+export declare const OUTPUT_SCHEMA_TRANSPORT = "A .json file path, or inline JSON beginning with `{`.";
+/** The full schema is enforced when the target submits its result through
+ *  `crtr push result`; a mismatch rejects with the field errors and records
+ *  nothing, so an over-constrained schema costs the target retries. */
+export declare const OUTPUT_SCHEMA_CONSTRAINTS = "The full schema (including enum, pattern, and numeric bounds) is enforced when the target submits its result (its `submit_result` tool, or `crtr push result`); a mismatch rejects with the field errors and records nothing, so an over-constrained schema costs the target retries. A target that cannot honestly satisfy the schema declines (`submit_result` with `decline`, or `crtr push result --decline \"<reason>\" --code <token> [--retryable]`), which records a failure outcome with reason `declined` carrying the reason, code, and retryable flag instead of a value.";
+export declare function outputSchemaPath(nodeId: string): string;
+/** Broker-visible copy; the daemon validates only against outputSchemaPath. */
+export declare function brokerOutputSchemaPath(nodeId: string): string;
+export declare function projectOutputSchema(nodeId: string): void;
+export declare function outputResultPath(nodeId: string, grantee?: string): string;
+/** The node's machine result, read beneath its agent folder; undefined when it wrote none. */
+export declare function readOutputResult(nodeId: string, grantee?: string): unknown;
+export declare function structuredRequestResultPath(nodeId: string, requestId: string, mode: StructuredOutputMode, grantee?: string): string;
+/** The marker a declined request leaves beside where `result.json` would have been. */
+export declare function outputDeclinedPath(nodeId: string, grantee?: string): string;
+export interface OutputDeclined extends DeclinedResult {
+    mode: StructuredOutputMode;
+    at: string;
+}
+export declare function parseOutputSchemaValue(value: string | undefined): Record<string, unknown> | null;
+/** The daemon is the only caller for a row-backed request sidecar. */
+export declare function writeStructuredRequestSidecar(row: {
+    request_id: string;
+    node_id: string | null;
+    submission: StructuredOutputMode;
+    schema: Record<string, unknown>;
+    request_message_id?: string | null;
+}): string;
+/** Read a structured-output request with full validation and error reporting.
+ *  Returns a tri-state: absent (file doesn't exist), valid (parsed successfully),
+ *  or invalid (file exists but is malformed). */
+export declare function readOutputRequest(nodeId: string): StructuredOutputState;
+export declare function readBrokerOutputRequest(nodeId: string): StructuredOutputState;
+/** Reads the pre-request-id sidecar shape for daemon boot adoption only. */
+export declare function readLegacyOutputRequest(nodeId: string): Pick<StructuredOutputRequest, 'mode' | 'schema' | 'requestMessageId'> | null;
+/** Validate a submitted result value against a stored output schema. Returns
+ *  the validated value (the validator applies the same benign coercions the
+ *  retired `submit` tool did — e.g. "5" → 5 for a number field), or throws an
+ *  Error whose message lists the per-field failures. pi-ai is imported lazily
+ *  so the daemon and CLI only pay for its module graph on an actual submit. */
+export declare function validateStructuredResult(schema: Record<string, unknown>, value: unknown): Promise<unknown>;
+/** Persist a validated result atomically (temp-file-plus-rename), so a
+ *  concurrent reader (Core's result poll peeks this file) never sees a torn
+ *  write. Returns the result path. */
+export declare function writeOutputResult(nodeId: string, value: unknown, grantee?: string): string;
+/** Persist a decline atomically. `result.json` is left untouched: a one-off
+ *  decline after an earlier answered request must not erase that answer. */
+export declare function writeOutputDeclined(nodeId: string, declined: OutputDeclined, grantee?: string): string;
+/** The stop guard's count of consecutive schema reprompts of a run's root
+ *  (Silas, 2026-09-30): daemon-owned, beside the schema it counts against. */
+export declare function schemaRepromptsPath(nodeId: string): string;
+export interface SchemaReprompts {
+    count: number;
+    at: number;
+}
+export declare function readSchemaReprompts(nodeId: string): SchemaReprompts;
+export declare function writeSchemaReprompts(nodeId: string, value: SchemaReprompts): void;
+/** A `result.submit` resets the count. */
+export declare function clearSchemaReprompts(nodeId: string): void;
+export declare function removeOutputSchema(nodeId: string, requestId?: string): void;
+export interface StagedStructuredProjection {
+    path: string;
+    tmpPath: string;
+}
+/** Stage the authoritative value before its settlement commit; install is one rename. */
+export declare function stageStructuredResult(nodeId: string, requestId: string, mode: StructuredOutputMode, value: unknown, grantee?: string): StagedStructuredProjection;
+export declare function installStagedStructuredProjection(staged: StagedStructuredProjection): string;

package/dist/core/runtime/structured-output.js

@@ -0,0 +1,5 @@
+var P=Object.defineProperty;var s=(t,e)=>P(t,"name",{value:e,configurable:!0});import{existsSync as N,mkdirSync as p,readFileSync as c,unlinkSync as d,writeFileSync as f,renameSync as h}from"node:fs";import{dirname as S,resolve as j}from"node:path";import{randomUUID as g}from"node:crypto";import{nodeDir as v,nodeRunDir as R,contextDir as O,nodeAgentDir as b}from"../canvas/paths.js";import{readTextBeneathIfExists as T,unlinkBeneath as A,writeFileBeneath as y}from"../spaces/open-beneath.js";import{InputError as x}from"../io.js";import{isRecord as i}from"../../shared/predicates.js";const W="submit_result",z="A .json file path, or inline JSON beginning with `{`.",G='The full schema (including enum, pattern, and numeric bounds) is enforced when the target submits its result (its `submit_result` tool, or `crtr push result`); a mismatch rejects with the field errors and records nothing, so an over-constrained schema costs the target retries. A target that cannot honestly satisfy the schema declines (`submit_result` with `decline`, or `crtr push result --decline "<reason>" --code <token> [--retryable]`), which records a failure outcome with reason `declined` carrying the reason, code, and retryable flag instead of a value.';function m(t){return`${v(t)}/output-schema.json`}s(m,"outputSchemaPath");function q(t){return`${R(t)}/output-schema.json`}s(q,"brokerOutputSchemaPath");function M(t){const e=m(t),r=q(t);N(e)&&y(R(t),r,c(e),{atomic:!0})}s(M,"projectOutputSchema");function _(t,e){return`${O(t,e)}/result.json`}s(_,"outputResultPath");function K(t,e){const r=T(b(t,e),_(t,e));return r===null?void 0:JSON.parse(r)}s(K,"readOutputResult");function E(t,e,r,n){return r==="terminal"?_(t,n):`${O(t,n)}/structured-requests/${e}/result.json`}s(E,"structuredRequestResultPath");function J(t,e){return`${O(t,e)}/declined.json`}s(J,"outputDeclinedPath");function Q(t){const e=t?.trim();if(e===void 0||e==="")return null;let r,n;if(e.startsWith("{"))r=e,n="inline JSON";else{const o=j(e);n=o;try{r=c(o,"utf8")}catch(a){throw new x({error:"bad_output_schema",message:`could not read output schema from ${o}: ${a.message}`,field:"output-schema",next:"Pass a readable JSON Schema file path, or inline JSON beginning with `{`."})}}let u;try{u=JSON.parse(r)}catch(o){throw new x({error:"bad_output_schema",message:`output schema from ${n} is not valid JSON: ${o.message}`,field:"output-schema",next:"Pass valid JSON whose top-level value is an object."})}if(!i(u))throw new x({error:"bad_output_schema",message:`output schema from ${n} must be a JSON object`,field:"output-schema",next:"Pass a JSON Schema object, not an array, string, number, boolean, or null."});return u}s(Q,"parseOutputSchemaValue");function X(t){if(t.node_id===null)throw new Error(`cannot publish structured request ${t.request_id} before node binding`);const e=t.node_id,r=m(e);p(S(r),{recursive:!0});const n={request_id:t.request_id,mode:t.submission,schema:t.schema,...t.request_message_id==null?{}:{requestMessageId:t.request_message_id}},u=`${r}.${g()}.tmp`;return f(u,`${JSON.stringify(n,null,2)}
+`,"utf8"),h(u,r),M(e),r}s(X,"writeStructuredRequestSidecar");function U(t){return w(m(t))}s(U,"readOutputRequest");function Y(t){return w(q(t))}s(Y,"readBrokerOutputRequest");function w(t){if(!N(t))return{state:"absent"};let e;try{e=c(t,"utf8")}catch(l){return{state:"invalid",error:`could not read request file: ${l.message}`}}let r;try{r=JSON.parse(e)}catch(l){return{state:"invalid",error:`request file is not valid JSON: ${l.message}`}}if(!i(r))return{state:"invalid",error:"request file top-level value must be an object"};const n=r.request_id,u=r.mode,o=r.schema;if(typeof n!="string"||n==="")return{state:"invalid",error:"request_id must be a non-empty string"};if(u!=="terminal"&&u!=="oneoff")return{state:"invalid",error:`mode must be 'terminal' or 'oneoff', got ${JSON.stringify(u)}`};if(!i(o))return{state:"invalid",error:`schema must be an object, got ${typeof o}`};const a=r.requestMessageId;return a!==void 0&&typeof a!="string"?{state:"invalid",error:`requestMessageId must be a string, got ${typeof a}`}:{state:"valid",request:{request_id:n,mode:u,schema:o,...a===void 0?{}:{requestMessageId:a}}}}s(w,"readOutputRequestAt");function Z(t){try{const e=JSON.parse(c(m(t),"utf8"));if(!i(e)||Object.hasOwn(e,"request_id"))return null;const r=e.mode,n=e.schema,u=e.requestMessageId;return r!=="terminal"&&r!=="oneoff"||!i(n)?null:{mode:r,schema:n,...typeof u=="string"?{requestMessageId:u}:{}}}catch{return null}}s(Z,"readLegacyOutputRequest");async function tt(t,e){const{validateToolArguments:r}=await import("@earendil-works/pi-ai");return r({name:"submit",description:"",parameters:t},{type:"toolCall",id:"structured-output",name:"submit",arguments:e})}s(tt,"validateStructuredResult");function et(t,e,r){const n=b(t,r),u=_(t,r);y(n,u,`${JSON.stringify(e,null,2)}
+`,{atomic:!0});try{A(n,J(t,r))}catch(o){if(o.code!=="ENOENT")throw o}return u}s(et,"writeOutputResult");function rt(t,e,r){const n=J(t,r);return y(b(t,r),n,`${JSON.stringify(e,null,2)}
+`,{atomic:!0}),n}s(rt,"writeOutputDeclined");function $(t){return`${v(t)}/output-schema-reprompts.json`}s($,"schemaRepromptsPath");function nt(t){try{const e=JSON.parse(c($(t),"utf8"));if(i(e)&&Number.isSafeInteger(e.count)&&Number.isFinite(e.at))return{count:e.count,at:e.at}}catch{}return{count:0,at:0}}s(nt,"readSchemaReprompts");function st(t,e){const r=$(t);p(S(r),{recursive:!0});const n=`${r}.${g()}.tmp`;f(n,JSON.stringify(e),"utf8"),h(n,r)}s(st,"writeSchemaReprompts");function k(t){try{d($(t))}catch{}}s(k,"clearSchemaReprompts");function ut(t,e){const r=m(t);if(e!==void 0){const u=U(t);if(u.state!=="valid"||u.request.request_id!==e)return}try{d(r)}catch{}k(t);const n=q(t);try{d(n)}catch{}}s(ut,"removeOutputSchema");function ot(t,e,r,n,u){const o=E(t,e,r,u);p(S(o),{recursive:!0});const a=`${o}.${g()}.tmp`;return f(a,`${JSON.stringify(n,null,2)}
+`,"utf8"),{path:o,tmpPath:a}}s(ot,"stageStructuredResult");function at(t){return h(t.tmpPath,t.path),t.path}s(at,"installStagedStructuredProjection");export{G as OUTPUT_SCHEMA_CONSTRAINTS,z as OUTPUT_SCHEMA_TRANSPORT,W as SUBMIT_RESULT_TOOL,q as brokerOutputSchemaPath,k as clearSchemaReprompts,at as installStagedStructuredProjection,J as outputDeclinedPath,_ as outputResultPath,m as outputSchemaPath,Q as parseOutputSchemaValue,M as projectOutputSchema,Y as readBrokerOutputRequest,Z as readLegacyOutputRequest,U as readOutputRequest,K as readOutputResult,nt as readSchemaReprompts,ut as removeOutputSchema,$ as schemaRepromptsPath,ot as stageStructuredResult,E as structuredRequestResultPath,tt as validateStructuredResult,rt as writeOutputDeclined,et as writeOutputResult,st as writeSchemaReprompts,X as writeStructuredRequestSidecar};

package/dist/core/runtime/surface-bg.d.ts

@@ -0,0 +1,13 @@
+/** The SGR escape that turns ON the distinct-surface background (the theme's
+ *  card plane), e.g. `\x1b[48;2;52;53;65m`. Pair with `\x1b[49m` to reset just
+ *  the background. Throws if no process has initialized the theme — callers on a
+ *  render path (the attach overlay) always have, by construction. */
+export declare function surfaceBgAnsi(): string;
+/** tmux flags that frame a `display-menu` / `display-popup` as a distinct
+ *  surface — a rounded border in the theme accent around a body painted with the
+ *  theme's card plane. The accent border is what carries the "you are somewhere
+ *  else" signal, because a card sits close to the page by design.
+ *  Empty when the theme is unavailable in this process (chrome stays default; the
+ *  attach viewer re-installs the menu with these once it has themed). One knob:
+ *  every crtr tmux float shares this single definition. */
+export declare function surfaceTmuxStyleArgs(): string[];

package/dist/core/runtime/surface-bg.js

@@ -0,0 +1 @@
+var c=Object.defineProperty;var t=(e,n)=>c(e,"name",{value:n,configurable:!0});const d=Symbol.for("@earendil-works/pi-coding-agent:theme");function o(){return globalThis[d]??void 0}t(o,"liveTheme");function f(){const e=o();if(e===void 0)throw new Error("surfaceBgAnsi: pi theme not initialized in this process");return e.getBgAnsi("userMessageBg")}t(f,"surfaceBgAnsi");function s(e){const n=/[34]8;2;(\d+);(\d+);(\d+)/.exec(e);if(n!==null){const i=t(u=>Number(u).toString(16).padStart(2,"0"),"hex");return`#${i(n[1])}${i(n[2])}${i(n[3])}`}const r=/[34]8;5;(\d+)/.exec(e);if(r!==null)return`colour${r[1]}`}t(s,"tmuxColor");function l(){const e=o();if(e===void 0)return[];const n=s(e.getBgAnsi("userMessageBg"));if(n===void 0)return[];const r=s(e.getFgAnsi("accent")),i=r===void 0?`bg=${n}`:`fg=${r},bg=${n}`;return["-b","rounded","-s",`bg=${n}`,"-S",i]}t(l,"surfaceTmuxStyleArgs");export{f as surfaceBgAnsi,l as surfaceTmuxStyleArgs};

package/dist/core/runtime/tmux-bindings.d.ts

@@ -0,0 +1,30 @@
+import { type BindingId, type BindingResolution } from '../keybindings/index.js';
+export interface TmuxInstalledPair {
+    readonly table: string;
+    readonly key: string;
+}
+export interface TmuxInstallDiagnostic {
+    readonly code: 'occupied' | 'tmux-error';
+    readonly bindingId?: BindingId;
+    readonly gesture?: string;
+    readonly message: string;
+}
+export interface TmuxInstallResult {
+    readonly ok: boolean;
+    readonly installed: readonly TmuxInstalledPair[];
+    readonly diagnostics: readonly TmuxInstallDiagnostic[];
+}
+/** The argv of the exact `display-menu` Alt+C installs, for a caller that has no
+ *  key to press — the viewer's `/menu`. The menu is built from the same
+ *  resolved bindings and actions, so it can never drift from the keyboard path.
+ *  Run it with `-t <pane>` so the `#{pane_id}` formats resolve to that pane. */
+export declare function crouterMenuTmuxArgs(bindingSnapshot?: BindingResolution<BindingId>): string[];
+/** Effective crouter gestures that tmux's root table currently consumes before
+ * pane input can see them. One list-keys snapshot serves the whole query. */
+export declare function occupiedTmuxRootGestures(gestures: readonly string[]): readonly string[];
+export declare function inboxToggleTmuxCommand(): string[];
+/** Reconcile the tmux server with one immutable crouter settings snapshot.
+ * Passing snapshots is hermetic; the no-argument front door reads both user
+ * settings from the same config read. The server lock covers the entire
+ * manifest read, restore, install, fingerprint, and write transition. */
+export declare function installTmuxBindings(bindingSnapshot?: BindingResolution<BindingId>, passthroughSnapshot?: readonly BindingId[]): TmuxInstallResult;

package/dist/core/runtime/tmux-bindings.js

@@ -0,0 +1,4 @@
+var Q=Object.defineProperty;var u=(e,n)=>Q(e,"name",{value:n,configurable:!0});import{mkdtempSync as Y,rmSync as Z,writeFileSync as V}from"node:fs";import{tmpdir as O}from"node:os";import{join as M}from"node:path";import{ATTACH_CONTROL_BINDINGS as U,BINDING_CATALOG as _,BINDING_IDS as ee,encodeAttachControlInput as ne,formatGesture as te,isAttachPaneBinding as re,resolveUserKeybindingSettings as q}from"../keybindings/index.js";import{normalizeTmuxPassthrough as ie}from"../config.js";import{withExclusiveDirectoryLock as oe}from"../exclusive-lock.js";import{surfaceTmuxStyleArgs as se}from"./surface-bg.js";import{runTmux as f,shellQuote as h}from"./tmux-driver.js";const A="@crtr_keybindings_manifest",p="root",ue={"crtr.tmux.menu.promote":{description:"promote to orchestrator",action:{kind:"keys",keys:"/promote"}},"crtr.tmux.menu.resume":{description:"find node",action:{kind:"keys",keys:"/resume"}},"crtr.tmux.menu.fork":{description:"fork into idle root",action:{kind:"direct",run:"node fork --pane {pane}"}},"crtr.tmux.menu.demote-mode":{description:"demote to base node",action:{kind:"command",run:"node config --mode base --pane {pane}"}},"crtr.tmux.menu.demote":{description:"demote to terminal (finish when done)",action:{kind:"command",run:"node lifecycle demote --pane {pane}"}},"crtr.tmux.menu.make-resident":{description:"make resident (interactable)",action:{kind:"command",run:"node config --lifecycle resident --pane {pane}"}},"crtr.tmux.menu.detach":{description:"demote + close viewer",action:{kind:"command",run:"node lifecycle demote --pane {pane} --detach"}},"crtr.tmux.menu.close-subtree":{description:"close agent + subtree",action:{kind:"command",run:"node lifecycle close --pane {pane}"}},"crtr.tmux.menu.background-bash":{description:"background running bash",action:{kind:"direct",run:"node bash background --pane {pane}"}},"crtr.tmux.menu.file-review":{description:"review a file",action:{kind:"raw-keys",keys:"M-S-r"}},"crtr.tmux.menu.metadata":{description:"metadata",action:{kind:"keys",keys:"/node-metadata"}},"crtr.tmux.menu.fold-tools":{description:"fold finished tool calls",action:{kind:"keys",keys:"/fold-tools"}},"crtr.tmux.menu.context":{description:"context + reports",action:{kind:"keys",keys:"/context"}},"crtr.tmux.menu.providers":{description:"settings",action:{kind:"popup",run:"sys settings",size:{w:"90%",h:"85%"}}},"crtr.tmux.menu.provider-options":{description:"provider options",action:{kind:"popup",run:"sys settings --page provider-options",size:{w:"90%",h:"85%"}}},"crtr.tmux.menu.plugins":{description:"plugins",action:{kind:"popup",run:"pkg browse",size:{w:"90%",h:"85%"}}},"crtr.tmux.menu.analytics":{description:"analytics",action:{kind:"popup",run:"canvas analytics --pane {pane}",size:{w:"90%",h:"85%"}}},"crtr.tmux.menu.context-admin":{description:"context surface",action:{kind:"popup",run:"sys context admin",size:{w:"98%",h:"96%"}}},"crtr.tmux.menu.graph":{description:"canvas graph",action:{kind:"keys",keys:"/graph"}},"crtr.tmux.menu.focus-manager":{description:"go to manager",action:{kind:"command",run:"surface node focus {manager}"}},"crtr.tmux.menu.copy-id":{description:"copy node id",action:{kind:"command",run:"surface node id --pane {pane}"}},"crtr.tmux.menu.reload-viewer":{description:"reload viewer",action:{kind:"direct",run:"surface reload --pane {pane}"}},"crtr.tmux.menu.recap":{description:"generate recap",action:{kind:"keys",keys:"/recap"}},"crtr.tmux.menu.pin":{description:"pin conversation",action:{kind:"direct",run:"surface node pin --pane {pane}"}},"crtr.tmux.menu.issue.idea":{description:"idea",action:{kind:"popup",run:"canvas issue new --type idea"}},"crtr.tmux.menu.issue.bug":{description:"bug",action:{kind:"popup",run:"canvas issue new --type bug"}}};function b(e){return e.replace(/#/g,"##")}u(b,"escapeTmuxFormats");function ce(e){return e.map(h).join(" ")}u(ce,"tmuxCommand");const ae={w:"60%",h:"50%"};function G(e,n=!1,t=ae){const r=`crtr canvas chord --pane '#{pane_id}' --run ${h(b(e))}${n?" --interactive":""}`;return n?{argv:["display-popup","-E","-w",t.w,"-h",t.h,"-d","#{pane_current_path}",r],menu:`display-popup -E -w ${t.w} -h ${t.h} -d "#{pane_current_path}" ${h(r)}`}:{argv:["run-shell",`${r} >/dev/null 2>&1`],menu:`run-shell ${h(`${r} >/dev/null 2>&1`)}`}}u(G,"chordCommand");function de(e){const t=`crtr ${b(e).replace("{pane}","#{pane_id}")} >/dev/null 2>&1`;return{argv:["run-shell","-b",t],menu:`run-shell -b ${h(t)}`}}u(de,"directCommand");function j(e){switch(e.kind){case"disabled":return null;case"separator":return null;case"dismiss":return{argv:["refresh-client"],menu:"refresh-client"};case"keys":{const n=b(e.keys);return{argv:["send-keys",n,"Enter"],menu:`send-keys -t '#{pane_id}' ${h(n)} Enter`}}case"raw-keys":{const n=b(e.keys);return{argv:["send-keys",n],menu:`send-keys -t '#{pane_id}' ${h(n)}`}}case"literal-input":{const n=b(e.input);return{argv:["send-keys","-l",n],menu:`send-keys -l -t '#{pane_id}' ${h(n)}`}}case"command":return G(e.run);case"direct":return de(e.run);case"popup":return G(e.run,!0,e.size);case"submenu":{const n=N(e.title,e.items);return{argv:n,menu:ce(n)}}}}u(j,"menuActionCommand");function me(e){return j(e)?.menu??""}u(me,"renderMenuAction");function pe(e){return e.replace(/#\[[^\]]*\]/g,"").length}u(pe,"menuItemWidth");function N(e,n){const t=b(e),r=n.reduce((o,c)=>Math.max(o,pe(c.description)),0),s=["display-menu","-T",`#[align=centre]${t}`,...se()];s.push("-x",`#{e|-:#{pane_right},${Math.max(t.length,r)+7}}`,"-y","#{e|+:#{pane_top},3}","--");for(const o of n){if(o.action.kind==="separator"){s.push("");continue}const c=o.action.kind==="disabled"?o.description:b(o.description);s.push(c,o.selector,me(o.action))}return s.push("","-esc / q to close","",""),s}u(N,"buildMenuArgs");const le={enter:"Enter",escape:"Escape",tab:"Tab",backspace:"BSpace",delete:"DC",space:"Space",up:"Up",down:"Down",left:"Left",right:"Right",pageup:"PPage",pagedown:"NPage",home:"Home",end:"End"};function z(e){if(e==="+")return{key:"+",modifiers:[]};if(e.endsWith("++"))return{key:"+",modifiers:e.slice(0,-2).split("+")};const n=e.split("+");return{key:n.pop(),modifiers:n}}u(z,"normalizedStrokeParts");function fe(e){return v(e)[0]}u(fe,"tmuxKey");function v(e){let{key:n,modifiers:t}=z(e);const r=new Set(t),s=u((o,c)=>[r.has("ctrl")?"C-":"",r.has("alt")?"M-":"",c?"S-":"",le[o]??o].join(""),"name");if(r.has("shift")&&n.length===1&&/[a-z]/.test(n)){const o=n.toUpperCase();return!r.has("ctrl")&&!r.has("alt")?[s(o,!1)]:[s(o,!0),s(o,!1),s(n,!0)]}return[s(n,r.has("shift"))]}u(v,"tmuxKeyNames");function ge(e){const{key:n,modifiers:t}=z(e);return t.includes("shift")&&/[a-z]/.test(n)?n.toUpperCase():n==="space"?" ":n}u(ge,"menuSelector");function T(e,n,t){const r=[];for(const s of e){const o=n.get(s);if(o!==void 0)for(const c of t.gestures(s))r.push({description:o.description,selector:ge(c),action:o.action})}return r}u(T,"boundMenuItems");function F(e){const n=new Map;for(const[c,l]of Object.entries(ue))l!==void 0&&n.set(c,l);for(const{menuId:c,actionId:l}of U){const x=_.find(w=>w.id===l);if(x===void 0)throw new Error(`missing attach binding definition ${l}`);n.set(c,{description:x.name.toLowerCase(),action:{kind:"literal-input",input:ne(l)}})}const t=T(U.map(({menuId:c})=>c),n,e);t.length>0&&n.set("crtr.tmux.menu.attach",{description:"attach viewer \u203A",action:{kind:"submenu",title:" attach viewer ",items:t}});const r=T(["crtr.tmux.menu.metadata","crtr.tmux.menu.context"],n,e);n.set("crtr.tmux.menu.show",{description:"inspect \u203A",action:{kind:"submenu",title:" inspect node ",items:r}});const s=T(["crtr.tmux.menu.fold-tools"],n,e);n.set("crtr.tmux.menu.view-settings",{description:"display \u203A",action:{kind:"submenu",title:" display ",items:s}});const o=T(["crtr.tmux.menu.issue.idea","crtr.tmux.menu.issue.bug"],n,e);return n.set("crtr.tmux.menu.issues",{description:"create \u203A",action:{kind:"submenu",title:" create ",items:o}}),n}u(F,"resolvedMenuActions");function K(e,n){const t=u(c=>T(c,n,e),"boundItems"),r=[],s=u((c,l)=>{l.length!==0&&(r.length>0&&r.push({description:"",selector:"",action:{kind:"separator"}}),r.push({description:`-#[bold]${c}`,selector:"",action:{kind:"disabled"}},...l))},"addGroup");s("Explore",t(["crtr.tmux.menu.resume","crtr.tmux.menu.graph","crtr.tmux.menu.focus-manager","crtr.tmux.menu.show","crtr.tmux.menu.view-settings"])),s("Current node",t(["crtr.tmux.menu.attach","crtr.tmux.menu.background-bash","crtr.tmux.menu.file-review","crtr.tmux.menu.pin","crtr.tmux.menu.copy-id","crtr.tmux.menu.reload-viewer","crtr.tmux.menu.recap"])),s("Lifecycle",t(["crtr.tmux.menu.fork","crtr.tmux.menu.promote","crtr.tmux.menu.demote-mode","crtr.tmux.menu.demote","crtr.tmux.menu.make-resident","crtr.tmux.menu.detach","crtr.tmux.menu.close-subtree"])),s("System",t(["crtr.tmux.menu.providers","crtr.tmux.menu.provider-options","crtr.tmux.menu.plugins","crtr.tmux.menu.analytics","crtr.tmux.menu.context-admin","crtr.tmux.menu.issues"]));const o=e.gestures("crtr.tmux.menu.open");if(o.length>0&&r.length>0){r.push({description:"",selector:"",action:{kind:"separator"}});for(const c of o)r.push({description:`${te(c)} to close`,selector:fe(c),action:{kind:"dismiss"}})}return r}u(K,"menuItems");function Pe(e){const n=e??q().bindings;return N(" crtr ",K(n,F(n)))}u(Pe,"crouterMenuTmuxArgs");function S(e,n){let t=n;for(;t<e.length&&/\s/.test(e[t]);)t+=1;if(t>=e.length)return null;let r=null,s="";for(;t<e.length;){const o=e[t];if(r===null&&/\s/.test(o))break;if(r===null&&(o==="'"||o==='"')){r=o,t+=1;continue}if(r===o){r=null,t+=1;continue}if(o==="\\"&&r!=="'"&&t+1<e.length){s+=e[t+1],t+=2;continue}s+=o,t+=1}return{value:s,end:t}}u(S,"readTmuxToken");function B(e){const n=S(e,0);if(n?.value!=="bind-key")return null;let t=n.end,r=!1;for(;;){const s=S(e,t);if(s===null)return null;if(t=s.end,s.value==="-r"){r=!0;continue}if(s.value!=="-T")continue;const o=S(e,t);if(o===null)return null;const c=S(e,o.end);return c===null?null:{table:o.value,key:c.value,command:e.slice(c.end).trimStart(),repeat:r}}}u(B,"parseTmuxBinding");function $(e,n){const t=f(["list-keys","-T",e]);return t.ok?t.stdout.split(`
+`).find(r=>{const s=B(r);return s?.table===e&&s.key===n})??null:null}u($,"bindingAt");function Le(e){const n=f(["list-keys","-T",p]);if(!n.ok)return[];const t=new Set(n.stdout.split(`
+`).flatMap(r=>{const s=B(r);return s?.table===p?[s.key]:[]}));return e.filter(r=>!r.includes(" > ")&&v(r).some(s=>t.has(s)))}u(Le,"occupiedTmuxRootGestures");function R(e){return typeof e=="object"&&e!==null&&typeof e.table=="string"&&typeof e.key=="string"}u(R,"isInstalledPair");function ke(e){if(typeof e!="object"||e===null)return!1;const n=e;return typeof n.bindingId=="string"&&ee.has(n.bindingId)&&typeof n.gesture=="string"&&typeof n.key=="string"&&(typeof n.original=="string"||n.original===null)&&typeof n.wrapper=="string"&&(n.state==="owned"||n.state==="relinquished")}u(ke,"isWrappedRootBinding");function he(){const e=f(["show-options","-s","-q",A]);if(!e.ok)return null;if(e.stdout==="")return{pairs:[],wrappers:[]};const n=f(["show-options","-s","-qv",A]);if(!n.ok)return null;try{const t=JSON.parse(n.stdout);if(Array.isArray(t))return t.every(R)?{pairs:t,wrappers:[]}:null;if(typeof t!="object"||t===null)return null;const r=t;return!Array.isArray(r.pairs)||!r.pairs.every(R)||!Array.isArray(r.wrappers)||!r.wrappers.every(ke)?null:{pairs:r.pairs,wrappers:r.wrappers}}catch{return null}}u(he,"readManifest");function W(e){return f(["set-option","-s",A,JSON.stringify(e)])}u(W,"writeManifest");function C(e){return e.replace(/\\/g,"\\\\").replace(/;/g,"\\;")}u(C,"tmuxKeyArgument");function xe(e){return`"${e.replace(/\\/g,"\\\\").replace(/"/g,'\\"').replace(/;/g,"\\;")}"`}u(xe,"tmuxCommandToken");function ye(e){let n=null,t="";for(let r=0;r<e.length;r+=1){const s=e[r];if(n===null&&(s==="'"||s==='"')){n=s,t+=s;continue}if(n===s){n=null,t+=s;continue}if(s==="\\"&&r+1<e.length){const o=e[r+1];n===null&&o===";"?t+=";":t+=s+o,r+=1;continue}t+=s}return t}u(ye,"bindingCommandForBranch");function be(e){const n=Y(M(O(),"crtr-tmux-binding-")),t=M(n,"binding.conf");try{return V(t,`${e}
+`,"utf8"),f(["source-file",t])}finally{Z(n,{recursive:!0,force:!0})}}u(be,"sourceBindingLine");function X(e){return e.original===null?f(["unbind-key","-T",p,C(e.key)]):be(e.original)}u(X,"restoreWrappedBinding");function we(){return["run-shell","-b",'crtr surface inbox --quiet --tmux-socket "#{socket_path}" --tmux-client "#{client_name}" --target-pane "#{pane_id}"']}u(we,"inboxToggleTmuxCommand");function ve(e){switch(e){case"crtr.tmux.node.next":return["run-shell","crtr surface node cycle --dir next --pane '#{pane_id}' >/dev/null 2>&1"];case"crtr.tmux.node.previous":return["run-shell","crtr surface node cycle --dir prev --pane '#{pane_id}' >/dev/null 2>&1"];case"crtr.tmux.inbox.toggle":return we();default:throw new Error(`no tmux command for ${e}`)}}u(ve,"actionCommand");function $e(){const e=process.env.TMUX?.split(",")[0]?.trim();if(e!==void 0&&e!=="")return`${e}.crtr-keybindings.lock`;const n=f(["display-message","-p","#{socket_path}"]);if(n.ok&&n.stdout!=="")return`${n.stdout}.crtr-keybindings.lock`;const t=typeof process.getuid=="function"?process.getuid():"user";return M(O(),`crtr-tmux-keybindings-${t}.lock`)}u($e,"tmuxBindingLockPath");function De(e,n=[]){return oe($e(),()=>Ie(e,n))}u(De,"installTmuxBindings");function Ie(e,n=[]){const t=e===void 0?q():void 0,r=e??t.bindings,s=e===void 0?t.tmuxPassthrough:ie(n),o=[],c=[],l=he();if(l===null)return o.push({code:"tmux-error",message:`tmux is unavailable or ${A} is malformed`}),{ok:!1,installed:c,diagnostics:o};const x=new Map;for(const i of s){const a=_.find(d=>d.id===i);if(!(a===void 0||!re(a))){for(const d of r.gestures(i))if(!d.includes(" > "))for(const m of v(d))x.has(m)||x.set(m,{bindingId:i,gesture:d})}}const w=new Set,I=[];for(const i of l.wrappers){const a=x.get(i.key),d=$(p,i.key);if(d!==null&&d===i.original)continue;if(i.state==="relinquished"||d!==i.wrapper){w.add(i.key),a!==void 0&&I.push({...i,...a,state:"relinquished"});continue}const m=X(i);m.ok||(w.add(i.key),I.push(i),o.push({code:"tmux-error",bindingId:i.bindingId,gesture:i.gesture,message:`could not restore tmux binding ${p}:${i.key}: ${m.stderr}`}))}for(const i of l.pairs){if(i.table===p&&w.has(i.key))continue;const a=f(["unbind-key","-T",i.table,C(i.key)]);!a.ok&&$(i.table,i.key)!==null&&o.push({code:"tmux-error",message:`could not remove crouter binding ${i.table}:${i.key}: ${a.stderr}`})}if(o.some(i=>i.code==="tmux-error")){const i=W({pairs:l.pairs,wrappers:I});return i.ok||o.push({code:"tmux-error",message:`could not save crouter tmux ownership manifest: ${i.stderr}`}),{ok:!1,installed:c,diagnostics:o}}const E=u((i,a,d,m,k)=>{if($(i,a)!==null)return o.push({code:"occupied",bindingId:m,gesture:k,message:`${i}:${a} is already bound by tmux; ${m} was not installed`}),!1;const g=f(["bind-key","-T",i,C(a),...d]);return g.ok?(c.push({table:i,key:a}),!0):(o.push({code:"tmux-error",bindingId:m,gesture:k,message:`could not install ${m}: ${g.stderr}`}),!1)},"install"),P=F(r),H=N(" crtr ",K(r,P));for(const i of r.gestures("crtr.tmux.menu.open"))for(const a of v(i))E(p,a,H,"crtr.tmux.menu.open",i);for(const i of _){if(i.pair?.field!=="menu")continue;const a=_.find(y=>y.id===i.pair?.pairedId);if(a?.pair?.field!=="global")continue;const d=i.id,m=a.id,k=P.get(d),g=k===void 0?null:j(k.action);if(g===null)throw new Error(`no direct tmux action for paired menu binding ${d}`);for(const y of r.gestures(m))for(const J of v(y))E(p,J,g.argv,m,y)}for(const i of["crtr.tmux.node.next","crtr.tmux.node.previous","crtr.tmux.inbox.toggle"])for(const a of r.gestures(i))for(const d of v(a))E(p,d,ve(i),i,a);const L=[];for(const[i,a]of x){if(w.has(i))continue;const d=$(p,i);if(d===null)continue;const m=B(d);if(m===null||m.command===""){o.push({code:"tmux-error",bindingId:a.bindingId,gesture:a.gesture,message:`could not parse occupied tmux binding ${p}:${i}`});continue}const k=f(["bind-key",...m.repeat?["-r"]:[],"-T",p,C(i),"if-shell","-F","#{!=:#{@crtr_attach},}",`send-keys ${xe(i)}`,ye(m.command)]);if(!k.ok){o.push({code:"tmux-error",bindingId:a.bindingId,gesture:a.gesture,message:`could not wrap ${p}:${i}: ${k.stderr}`});continue}const g=$(p,i);if(g===null||!g.includes("@crtr_attach")){o.push({code:"tmux-error",bindingId:a.bindingId,gesture:a.gesture,message:`could not fingerprint wrapped tmux binding ${p}:${i}`});continue}const y={...a,key:i,original:d,wrapper:g,state:"owned"};I.push(y),L.push(y)}const D=W({pairs:c,wrappers:I});if(!D.ok){o.push({code:"tmux-error",message:`could not save crouter tmux ownership manifest: ${D.stderr}`});for(const i of L)$(p,i.key)===i.wrapper&&X(i)}return{ok:o.every(i=>i.code!=="tmux-error"),installed:c,diagnostics:o}}u(Ie,"reconcileTmuxBindings");export{Pe as crouterMenuTmuxArgs,we as inboxToggleTmuxCommand,De as installTmuxBindings,Le as occupiedTmuxRootGestures};

package/dist/core/runtime/tmux-chrome.d.ts

@@ -0,0 +1,2 @@
+export { installTmuxBindings, occupiedTmuxRootGestures, type TmuxInstalledPair, type TmuxInstallDiagnostic, type TmuxInstallResult, } from './tmux-bindings.js';
+export { sendKeysEnter, displayMessage, paneCurrentPath, getPaneOption, } from './tmux-driver.js';

package/dist/core/runtime/tmux-chrome.js

@@ -0,0 +1 @@
+import{installTmuxBindings as n,occupiedTmuxRootGestures as s}from"./tmux-bindings.js";import{sendKeysEnter as r,displayMessage as a,paneCurrentPath as i,getPaneOption as p}from"./tmux-driver.js";export{a as displayMessage,p as getPaneOption,n as installTmuxBindings,s as occupiedTmuxRootGestures,i as paneCurrentPath,r as sendKeysEnter};