@north-light/crouter 0.3.318 → 0.3.320

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

@@ -1,156 +1,4 @@
-import { existsSync, mkdirSync, readFileSync, unlinkSync, writeFileSync, renameSync } from 'node:fs';
-import { dirname, resolve } from 'node:path';
-import { randomUUID } from 'node:crypto';
-import { nodeDir, contextDir } from '../canvas/paths.js';
-import { InputError } from '../io.js';
-import { isRecord } from '../../shared/predicates.js';
-/** The `--output-schema` transport clause, rendered verbatim by every leaf that
- *  accepts one. Declared once so the call sites cannot drift apart. */
-export 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 const OUTPUT_SCHEMA_CONSTRAINTS = 'The full schema (including enum, pattern, and numeric bounds) is enforced when the target submits its result with `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 with `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 function outputSchemaPath(nodeId) {
-    return `${nodeDir(nodeId)}/output-schema.json`;
-}
-export function outputResultPath(nodeId) {
-    return `${contextDir(nodeId)}/result.json`;
-}
-/** The marker a declined request leaves beside where `result.json` would have been. */
-export function outputDeclinedPath(nodeId) {
-    return `${contextDir(nodeId)}/declined.json`;
-}
-export function parseOutputSchemaValue(value) {
-    const raw = value?.trim();
-    if (raw === undefined || raw === '')
-        return null;
-    let text;
-    let source;
-    if (raw.startsWith('{')) {
-        text = raw;
-        source = 'inline JSON';
-    }
-    else {
-        const path = resolve(raw);
-        source = path;
-        try {
-            text = readFileSync(path, 'utf8');
-        }
-        catch (err) {
-            throw new InputError({
-                error: 'bad_output_schema',
-                message: `could not read output schema from ${path}: ${err.message}`,
-                field: 'output-schema',
-                next: 'Pass a readable JSON Schema file path, or inline JSON beginning with `{`.',
-            });
-        }
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(text);
-    }
-    catch (err) {
-        throw new InputError({
-            error: 'bad_output_schema',
-            message: `output schema from ${source} is not valid JSON: ${err.message}`,
-            field: 'output-schema',
-            next: 'Pass valid JSON whose top-level value is an object.',
-        });
-    }
-    if (!isRecord(parsed)) {
-        throw new InputError({
-            error: 'bad_output_schema',
-            message: `output schema from ${source} must be a JSON object`,
-            field: 'output-schema',
-            next: 'Pass a JSON Schema object, not an array, string, number, boolean, or null.',
-        });
-    }
-    return parsed;
-}
-/** Write a structured-output request atomically using temp-file-plus-rename. */
-export function writeOutputSchema(nodeId, mode, schema) {
-    const path = outputSchemaPath(nodeId);
-    mkdirSync(dirname(path), { recursive: true });
-    const request = { mode, schema };
-    const json = `${JSON.stringify(request, null, 2)}\n`;
-    const tmpPath = `${path}.${randomUUID()}.tmp`;
-    writeFileSync(tmpPath, json, 'utf8');
-    renameSync(tmpPath, path);
-    return path;
-}
-/** 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 function readOutputRequest(nodeId) {
-    const path = outputSchemaPath(nodeId);
-    if (!existsSync(path))
-        return { state: 'absent' };
-    let text;
-    try {
-        text = readFileSync(path, 'utf8');
-    }
-    catch (err) {
-        return { state: 'invalid', error: `could not read request file: ${err.message}` };
-    }
-    let parsed;
-    try {
-        parsed = JSON.parse(text);
-    }
-    catch (err) {
-        return { state: 'invalid', error: `request file is not valid JSON: ${err.message}` };
-    }
-    if (!isRecord(parsed)) {
-        return { state: 'invalid', error: 'request file top-level value must be an object' };
-    }
-    const mode = parsed['mode'];
-    const schema = parsed['schema'];
-    if (mode !== 'terminal' && mode !== 'oneoff') {
-        return { state: 'invalid', error: `mode must be 'terminal' or 'oneoff', got ${JSON.stringify(mode)}` };
-    }
-    if (!isRecord(schema)) {
-        return { state: 'invalid', error: `schema must be an object, got ${typeof schema}` };
-    }
-    return { state: 'valid', request: { mode, schema } };
-}
-/** 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 async function validateStructuredResult(schema, value) {
-    const { validateToolArguments } = await import('@earendil-works/pi-ai');
-    return validateToolArguments({ name: 'submit', description: '', parameters: schema }, { type: 'toolCall', id: 'structured-output', name: 'submit', arguments: value });
-}
-/** 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 function writeOutputResult(nodeId, value) {
-    const path = outputResultPath(nodeId);
-    mkdirSync(dirname(path), { recursive: true });
-    const tmpPath = `${path}.${randomUUID()}.tmp`;
-    writeFileSync(tmpPath, `${JSON.stringify(value, null, 2)}\n`, 'utf8');
-    renameSync(tmpPath, path);
-    try {
-        unlinkSync(outputDeclinedPath(nodeId));
-    }
-    catch { /* no earlier decline to retire */ }
-    return path;
-}
-/** Persist a decline atomically. `result.json` is left untouched: a one-off
- *  decline after an earlier answered request must not erase that answer. */
-export function writeOutputDeclined(nodeId, declined) {
-    const path = outputDeclinedPath(nodeId);
-    mkdirSync(dirname(path), { recursive: true });
-    const tmpPath = `${path}.${randomUUID()}.tmp`;
-    writeFileSync(tmpPath, `${JSON.stringify(declined, null, 2)}\n`, 'utf8');
-    renameSync(tmpPath, path);
-    return path;
-}
-export function removeOutputSchema(nodeId) {
-    const path = outputSchemaPath(nodeId);
-    try {
-        unlinkSync(path);
-    }
-    catch { /* already gone */ }
-}
+var b=Object.defineProperty;var a=(t,e)=>b(t,"name",{value:e,configurable:!0});import{existsSync as v,mkdirSync as i,readFileSync as S,unlinkSync as g,writeFileSync as c,renameSync as l}from"node:fs";import{dirname as m,resolve as w}from"node:path";import{randomUUID as h}from"node:crypto";import{nodeDir as $,contextDir as y}from"../canvas/paths.js";import{InputError as p}from"../io.js";import{isRecord as d}from"../../shared/predicates.js";const q="A .json file path, or inline JSON beginning with `{`.",A='The full schema (including enum, pattern, and numeric bounds) is enforced when the target submits its result with `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 with `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 f(t){return`${$(t)}/output-schema.json`}a(f,"outputSchemaPath");function x(t){return`${y(t)}/result.json`}a(x,"outputResultPath");function O(t){return`${y(t)}/declined.json`}a(O,"outputDeclinedPath");function U(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=w(e);n=o;try{r=S(o,"utf8")}catch(u){throw new p({error:"bad_output_schema",message:`could not read output schema from ${o}: ${u.message}`,field:"output-schema",next:"Pass a readable JSON Schema file path, or inline JSON beginning with `{`."})}}let s;try{s=JSON.parse(r)}catch(o){throw new p({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(!d(s))throw new p({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 s}a(U,"parseOutputSchemaValue");function D(t,e,r){const n=f(t);i(m(n),{recursive:!0});const o=`${JSON.stringify({mode:e,schema:r},null,2)}
+`,u=`${n}.${h()}.tmp`;return c(u,o,"utf8"),l(u,n),n}a(D,"writeOutputSchema");function C(t){const e=f(t);if(!v(e))return{state:"absent"};let r;try{r=S(e,"utf8")}catch(u){return{state:"invalid",error:`could not read request file: ${u.message}`}}let n;try{n=JSON.parse(r)}catch(u){return{state:"invalid",error:`request file is not valid JSON: ${u.message}`}}if(!d(n))return{state:"invalid",error:"request file top-level value must be an object"};const s=n.mode,o=n.schema;return s!=="terminal"&&s!=="oneoff"?{state:"invalid",error:`mode must be 'terminal' or 'oneoff', got ${JSON.stringify(s)}`}:d(o)?{state:"valid",request:{mode:s,schema:o}}:{state:"invalid",error:`schema must be an object, got ${typeof o}`}}a(C,"readOutputRequest");async function k(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})}a(k,"validateStructuredResult");function E(t,e){const r=x(t);i(m(r),{recursive:!0});const n=`${r}.${h()}.tmp`;c(n,`${JSON.stringify(e,null,2)}
+`,"utf8"),l(n,r);try{g(O(t))}catch{}return r}a(E,"writeOutputResult");function F(t,e){const r=O(t);i(m(r),{recursive:!0});const n=`${r}.${h()}.tmp`;return c(n,`${JSON.stringify(e,null,2)}
+`,"utf8"),l(n,r),r}a(F,"writeOutputDeclined");function H(t){const e=f(t);try{g(e)}catch{}}a(H,"removeOutputSchema");export{A as OUTPUT_SCHEMA_CONSTRAINTS,q as OUTPUT_SCHEMA_TRANSPORT,O as outputDeclinedPath,x as outputResultPath,f as outputSchemaPath,U as parseOutputSchemaValue,C as readOutputRequest,H as removeOutputSchema,k as validateStructuredResult,F as writeOutputDeclined,E as writeOutputResult,D as writeOutputSchema};

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

@@ -1,85 +1 @@
-// surface-bg.ts — the "distinct popup surface" background, theme-derived.
-//
-// crtr's overlays and popups must read as a SEPARATE surface from the normal one
-// (CTO ruling, insights/terminal-ui/inline-ui-placement #11): a popup whose background matches
-// the surface has invisible edges, so you can't tell where the float begins. We
-// paint them from the active pi theme — theme-derived, so it adapts to light/dark
-// and is ONE centralized knob, not a scattered hardcode.
-//
-// WHICH ROLE: `userMessageBg`, the theme's CARD plane — not `selectedBg`. Every
-// theme places its card one step off the page background (gruvbox-material
-// #32302f vs #282828; pi's own dark #343541, light #e8e8e8) while `selectedBg` is
-// a SELECTION BAND, deliberately pushed far off the page so a highlighted row
-// lifts. Painting a 90%×85% takeover with the selection band made the whole
-// screen that band: every dim/muted role lost the contrast it was designed
-// against (gruvbox dim text fell to 2.1:1), and the row highlight drawn ON TOP
-// had nowhere left to go. The card plane keeps content legibility and leaves the
-// selection band free to do its actual job inside the popup.
-//
-// A card sits close to the page by design, so the EDGE signal rule 11 demands
-// comes from the border, not the fill: we paint the rounded border in the theme
-// accent so the float's boundary is unmistakable.
-//
-// pi 0.79 does not re-export these roles through its public API (the `.` entry
-// omits `getResolvedThemeColors` and the live `theme` singleton). It DOES publish
-// the live `Theme` instance on a process-global symbol once `initTheme()` has run
-// — the same hook pi's own SDK reads (see broker.ts `ctx.ui.theme`). We read it
-// there and use the public `Theme.bg()` / `Theme.getBgAnsi()` methods.
-//
-// CRITICAL: this module must NOT statically import `@earendil-works/pi-coding-agent`
-// — that package costs ~400ms to load and would land on the cold `crtr` front
-// door (which never otherwise loads pi). We only READ the process-global symbol;
-// any process that needs styling (the attach viewer, a node's broker) has already
-// called `initTheme()` and populated it. Where the symbol is absent (the front
-// door, before it execs into the themed `crtr surface attach`), the tmux helpers return
-// no style args and the chrome stays at its default — the viewer re-themes it.
-const THEME_SYMBOL = Symbol.for('@earendil-works/pi-coding-agent:theme');
-/** The live pi Theme if a process has already run `initTheme()`, else undefined.
- *  Read-only: never initializes (that would pull pi into the front door). */
-function liveTheme() {
-    const t = globalThis[THEME_SYMBOL];
-    return (t ?? undefined);
-}
-/** 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 function surfaceBgAnsi() {
-    const t = liveTheme();
-    if (t === undefined)
-        throw new Error('surfaceBgAnsi: pi theme not initialized in this process');
-    return t.getBgAnsi('userMessageBg');
-}
-/** An SGR colour parameter (`48;2;r;g;b` or `38;5;n`) as a tmux colour token —
- *  `#rrggbb` on a truecolor theme, `colourN` on a 256-colour one. tmux cannot
- *  read pi's theme, so we translate the SGR pi already resolved for us.
- *  undefined when the role is empty (the SGR is a bare default-colour reset). */
-function tmuxColor(ansi) {
-    const tc = /[34]8;2;(\d+);(\d+);(\d+)/.exec(ansi);
-    if (tc !== null) {
-        const hex = (n) => Number(n).toString(16).padStart(2, '0');
-        return `#${hex(tc[1])}${hex(tc[2])}${hex(tc[3])}`;
-    }
-    const c256 = /[34]8;5;(\d+)/.exec(ansi);
-    if (c256 !== null)
-        return `colour${c256[1]}`;
-    return undefined;
-}
-/** 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 function surfaceTmuxStyleArgs() {
-    const t = liveTheme();
-    if (t === undefined)
-        return [];
-    const bg = tmuxColor(t.getBgAnsi('userMessageBg'));
-    if (bg === undefined)
-        return [];
-    const accent = tmuxColor(t.getFgAnsi('accent'));
-    const border = accent === undefined ? `bg=${bg}` : `fg=${accent},bg=${bg}`;
-    return ['-b', 'rounded', '-s', `bg=${bg}`, '-S', border];
-}
+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};