@gaunt-sloth/core 2.0.0-alpha.9 → 2.0.0-beta.0

package/dist/runtime/structuredOutput.js

@@ -0,0 +1,393 @@
+/**
+ * @module runtime/structuredOutput
+ *
+ * EXT-88 — the **`withStructuredOutput` boundary**. Every `withStructuredOutput` call in this
+ * project goes through {@link structuredOutputBoundary}: `rateShellCommand` (the approvals rater),
+ * {@link askStructured} (arbitrary caller schemas, including `gth workflow` scripts) and
+ * `@gaunt-sloth/batch`'s eval judge. Review's rating step is deliberately not one of them — it
+ * reaches its schema through a bound TOOL, which is a different path with different rules.
+ *
+ * ## The problem it exists to solve
+ *
+ * A single Zod object normally does two jobs at once — it is converted into the JSON Schema the
+ * provider is sent, and it validates the answer that comes back. Those two jobs want **opposite**
+ * things from an optional field, and Zod has only one knob for both:
+ *
+ * - **On the wire**, OpenAI's strict `json_schema` rule is *"`required` must be supplied and must
+ *   include every key in `properties`"*. A `.optional()` field is left out of `required`, and the
+ *   OpenAI API rejects the whole request with `400 Invalid schema for response_format`. Optionality
+ *   there is spelled as a **nullable type on a required key**, not as an absent key.
+ * - **On the way back**, providers do not agree. Some (ChatGroq) rewrite the schema themselves so
+ *   every property is required-and-nullable, and their models answer `null`. Others (Anthropic,
+ *   Google GenAI, Ollama) leave the field genuinely optional and their models may simply omit it.
+ *   Zod's `.optional()` admits `undefined` and **not** `null`, so the first group's answer is
+ *   rejected by the very schema that asked for it — and the caller sees a parse failure that looks
+ *   like a bad model rather than a self-contradicting request.
+ *
+ * ## The shape that satisfies both
+ *
+ * For every field the caller declared `.optional()`, the boundary sends
+ * `inner.nullable().prefault(null)` instead. That one node is the wire/validation twin:
+ *
+ * - **Wire** — `prefault` does not change the parsed *output* type, so the key lands in `required`
+ *   and its type is `["string","null"]` / `anyOf: [T, null]`. Strict mode is satisfied, and the
+ *   model is given a legal way to say "nothing here". Unlike `.default()`, `prefault` emits **no
+ *   `default` keyword** into the JSON Schema, so nothing extra is added to what the provider sees.
+ * - **Validation** — the same node accepts the value, accepts `null`, and accepts the key being
+ *   **missing** (which is what `prefault` supplies the `null` for). All three arms are needed: the
+ *   third is what keeps the providers that do *not* hoist working.
+ *
+ * The `null` never escapes: {@link StructuredOutputBoundary.safeParse} strips it back to the key
+ * being **absent** and then validates with the caller's **original** schema, so the parsed type is
+ * exactly what the caller declared — an optional string stays `string | undefined` and never
+ * becomes `string | null | undefined`.
+ *
+ * ## Two properties that must not be lost in a "simplification"
+ *
+ * - **Every `.describe()` survives into the emitted JSON Schema.** The descriptions are the only
+ *   place the model is told what the fields mean. Expressing the null-to-absent step with
+ *   `.transform()` on the field is the obvious-looking alternative and it costs the field its
+ *   description — worse, the conversion OpenAI's path uses refuses to represent a transform at all.
+ *   Normalization therefore happens in **code**, after the parse, never in the schema.
+ * - **A genuinely malformed answer still fails.** This boundary removes a *false* parse failure; it
+ *   is not a blanket "accept anything". A wrong type in an optional field is still rejected, because
+ *   the final validation is the caller's own untouched schema. In particular `.catch()` must not be
+ *   used to express any of this — it would swallow real failures.
+ *
+ * ## Coverage, and the deliberate limits
+ *
+ * The rewrite descends through objects, arrays, tuples, records and the single-child wrappers
+ * (`nullable`, `readonly`, `default`, `prefault`, `nonoptional`), so an optional nested inside an
+ * object inside an array is handled.
+ *
+ * It deliberately stops at **unions** (including discriminated unions), **intersections**, `lazy`,
+ * `map`, `set`, `pipe`/`transform` and `custom`, leaving those subtrees exactly as the caller wrote
+ * them, and it leaves a **recursive** schema alone in its entirety. The reason is one rule: the
+ * rewrite and the normalization must cover **precisely the same set**. At a union the incoming value
+ * gives no reliable answer to *which branch was taken*, so a `null` could not be stripped back out;
+ * rewriting there while being unable to normalize would manufacture the very parse failure this
+ * module removes. Recursion is refused for the neighbouring reason — a rewrite that stopped at the
+ * cycle would make a key required at one depth and optional at the next, which satisfies no
+ * provider's strict rule and is harder to reason about than the caller's own schema.
+ *
+ * An optional inside one of those constructs keeps today's behaviour — correct everywhere it is
+ * correct today, and still rejected by OpenAI's strict rule, which is a visible error rather than a
+ * silent one.
+ */
+import * as z from 'zod';
+/**
+ * A normalizer's answer for "this key must not be present at all" — distinct from `undefined`,
+ * because an object key explicitly set to `undefined` is still an own property and `Object.hasOwn`
+ * would report it. Callers must not have to learn a second spelling of "absent".
+ */
+const ABSENT = Symbol('structured-output-absent');
+function defOf(schema) {
+    return schema._zod.def;
+}
+/**
+ * Rebuild `schema` with part of its definition replaced, keeping everything else — the checks
+ * (`minItems`, `minimum`, …) and the registered `.describe()` metadata. Built from Zod's own clone
+ * rather than by calling `z.object(...)` / `z.array(...)` afresh, because re-constructing would
+ * silently drop those constraints from the schema the provider is sent.
+ *
+ * The metadata is copied through the registry rather than by cloning with Zod's `parent` option.
+ * A parent link is how Zod represents "the same schema, re-described", and its JSON-Schema emitter
+ * honours that by emitting a **`$ref` to the parent** with the differences as sibling keys. For a
+ * rewritten object that is actively wrong: the `$ref` would point at a definition still carrying the
+ * ORIGINAL `required` list — the one missing exactly the optional key this module exists to hoist —
+ * and `$ref`-with-siblings is not accepted by every provider's strict mode. Copying the metadata
+ * leaves the clone an independent schema, which is what it actually is.
+ */
+function cloneWith(schema, patch) {
+    const next = { ...defOf(schema), ...patch };
+    const cloned = z.core.clone(schema, next);
+    const meta = z.globalRegistry.get(schema);
+    if (meta)
+        z.globalRegistry.add(cloned, meta);
+    return cloned;
+}
+function isRecord(value) {
+    return typeof value === 'object' && value !== null && !Array.isArray(value);
+}
+/**
+ * `.optional()` → `inner.nullable().prefault(null)`, plus the normalizer that puts it back.
+ *
+ * The description is re-stated on the nullable wrapper so it lands at **field level** in the emitted
+ * JSON Schema whichever way the caller spelled it (`z.string().describe(D).optional()` carries it on
+ * the inner type, `z.string().optional().describe(D)` on the wrapper).
+ *
+ * `null` is only stripped where the caller's own declaration gives it no meaning. A field written
+ * `z.string().nullable().optional()` asked for `null` to be a value in its own right, so it keeps
+ * it; only a plain `.optional()`, for which `null` was never a legal answer and can only have come
+ * from the required-and-nullable rewrite, collapses to the key being absent.
+ */
+function walkOptional(schema, def) {
+    const inner = def.innerType;
+    const innerWalk = walk(inner);
+    const description = schema.description ?? inner.description;
+    const nullIsMeaningful = inner.safeParse(null).success;
+    // A field that already admits `null` needs no second nullable wrapper — one would emit a nested
+    // `anyOf` inside an `anyOf` that says nothing the inner one does not.
+    let nullable = nullIsMeaningful ? innerWalk.schema : innerWalk.schema.nullable();
+    if (description !== undefined)
+        nullable = nullable.describe(description);
+    const wireSchema = nullable.prefault(null);
+    const innerNormalize = innerWalk.normalize;
+    const normalize = (value) => {
+        if (value === undefined)
+            return ABSENT;
+        if (value === null)
+            return nullIsMeaningful ? null : ABSENT;
+        return innerNormalize ? innerNormalize(value) : value;
+    };
+    return { schema: wireSchema, normalize };
+}
+function walkObject(schema, def) {
+    const shape = def.shape ?? {};
+    const nextShape = {};
+    const normalizers = [];
+    let changed = false;
+    for (const [key, field] of Object.entries(shape)) {
+        const result = walk(field);
+        nextShape[key] = result.schema;
+        if (result.schema !== field)
+            changed = true;
+        if (result.normalize)
+            normalizers.push([key, result.normalize]);
+    }
+    if (!changed && normalizers.length === 0)
+        return { schema };
+    const normalize = (value) => {
+        if (!isRecord(value))
+            return value;
+        const out = { ...value };
+        for (const [key, normalizeField] of normalizers) {
+            if (!Object.hasOwn(out, key))
+                continue;
+            const normalized = normalizeField(out[key]);
+            if (normalized === ABSENT)
+                delete out[key];
+            else
+                out[key] = normalized;
+        }
+        return out;
+    };
+    return { schema: changed ? cloneWith(schema, { shape: nextShape }) : schema, normalize };
+}
+function walkArray(schema, def) {
+    const element = def.element;
+    const result = walk(element);
+    if (result.schema === element && !result.normalize)
+        return { schema };
+    const normalizeElement = result.normalize;
+    const normalize = normalizeElement
+        ? (value) => {
+            if (!Array.isArray(value))
+                return value;
+            return value.map((item) => {
+                const normalized = normalizeElement(item);
+                // An element position has no key to remove, so "absent" degrades to `undefined` — which
+                // is what an optional element schema accepts anyway.
+                return normalized === ABSENT ? undefined : normalized;
+            });
+        }
+        : undefined;
+    return {
+        schema: result.schema === element ? schema : cloneWith(schema, { element: result.schema }),
+        normalize,
+    };
+}
+function walkTuple(schema, def) {
+    const items = def.items ?? [];
+    const rest = def.rest ?? null;
+    const itemResults = items.map((item) => walk(item));
+    const restResult = rest ? walk(rest) : undefined;
+    const changed = itemResults.some((result, index) => result.schema !== items[index]) ||
+        (restResult !== undefined && rest !== null && restResult.schema !== rest);
+    const needsNormalize = itemResults.some((result) => result.normalize) || restResult?.normalize !== undefined;
+    if (!changed && !needsNormalize)
+        return { schema };
+    const normalize = needsNormalize
+        ? (value) => {
+            if (!Array.isArray(value))
+                return value;
+            return value.map((item, index) => {
+                // Gate on POSITION: a prefix item is normalized by its own item schema and never by the
+                // rest schema, which describes a different position entirely.
+                const normalizeItem = index < items.length ? itemResults[index]?.normalize : restResult?.normalize;
+                if (!normalizeItem)
+                    return item;
+                const normalized = normalizeItem(item);
+                return normalized === ABSENT ? undefined : normalized;
+            });
+        }
+        : undefined;
+    return {
+        schema: changed
+            ? cloneWith(schema, {
+                items: itemResults.map((result) => result.schema),
+                rest: restResult ? restResult.schema : rest,
+            })
+            : schema,
+        normalize,
+    };
+}
+function walkRecord(schema, def) {
+    const valueType = def.valueType;
+    const result = walk(valueType);
+    if (result.schema === valueType && !result.normalize)
+        return { schema };
+    const normalizeValue = result.normalize;
+    const normalize = normalizeValue
+        ? (value) => {
+            if (!isRecord(value))
+                return value;
+            const out = {};
+            for (const [key, item] of Object.entries(value)) {
+                const normalized = normalizeValue(item);
+                if (normalized !== ABSENT)
+                    out[key] = normalized;
+            }
+            return out;
+        }
+        : undefined;
+    return {
+        schema: result.schema === valueType ? schema : cloneWith(schema, { valueType: result.schema }),
+        normalize,
+    };
+}
+/**
+ * The single-child wrappers: `nullable`, `readonly`, `default`, `prefault`, `nonoptional`.
+ *
+ * A wrapper is **transparent to optionality**. `z.string().optional().default('foo')` is still sent
+ * as a required key typed `anyOf: [T, null]`, so a `null` arriving here is the wire's "nothing here"
+ * and must reach the inner normalizer that knows how to remove it. Passing every `null` straight
+ * through instead would advertise `null` to the provider and then reject the one it sends — the same
+ * self-contradiction this module exists to remove, one wrapper deep. What "absent" then means is the
+ * caller's own business, because the final validation is the caller's untouched schema: under
+ * `.default('foo')` it resolves to `'foo'`, under `.readonly()` the key simply stays absent.
+ *
+ * The exception is a wrapper that makes `null` a value in its own right — the caller wrote
+ * `.nullable()` **outside** the optional. That is the question {@link walkOptional} asks of its own
+ * inner type, asked one level up, and it is what keeps the two spellings of nullable-and-optional
+ * from disagreeing about the same field.
+ *
+ * `undefined` is passed through rather than being given a second meaning here: the wire never
+ * produces one (`prefault` supplies `null` for a missing key), and a genuinely missing object key
+ * never reaches a field normalizer at all — {@link walkObject} skips it.
+ */
+function walkWrapper(schema, def) {
+    const inner = def.innerType;
+    const result = walk(inner);
+    if (result.schema === inner && !result.normalize)
+        return { schema };
+    const innerNormalize = result.normalize;
+    const nullIsMeaningful = innerNormalize !== undefined && schema.safeParse(null).success;
+    const normalize = innerNormalize
+        ? (value) => {
+            if (value === undefined)
+                return value;
+            if (value === null && nullIsMeaningful)
+                return null;
+            return innerNormalize(value);
+        }
+        : undefined;
+    return {
+        schema: result.schema === inner ? schema : cloneWith(schema, { innerType: result.schema }),
+        normalize,
+    };
+}
+/**
+ * Thrown when the walk re-enters a schema it is already inside, i.e. the caller's schema is
+ * recursive. Caught in {@link structuredOutputBoundary}, which then leaves the whole schema alone —
+ * see the module doc's limits.
+ */
+const CYCLIC = Symbol('structured-output-cyclic');
+/** The schemas the current walk is inside. A node reached twice on one path is a cycle. */
+const inProgress = new WeakSet();
+/**
+ * Rewrite one node. Every branch here has a matching arm in the normalizer it returns — the two
+ * halves are produced by the **same** walk precisely so their coverage cannot drift apart. Anything
+ * not listed is returned untouched, with no normalizer.
+ *
+ * A **recursive** schema aborts the whole walk rather than being partly rewritten. Zod spells
+ * recursion as a getter in an object's shape, which reads as an ordinary `object` here and would
+ * otherwise descend for ever. Rewriting only the levels reached before the cycle would put an
+ * optional key in `required` at one depth and leave it out at the next — an inconsistency that
+ * satisfies no provider's strict rule while making the emitted schema harder to reason about than
+ * the caller's own.
+ */
+function walk(schema) {
+    if (inProgress.has(schema))
+        throw CYCLIC;
+    inProgress.add(schema);
+    try {
+        return walkNode(schema);
+    }
+    finally {
+        inProgress.delete(schema);
+    }
+}
+function walkNode(schema) {
+    const def = defOf(schema);
+    switch (def.type) {
+        case 'optional':
+            return walkOptional(schema, def);
+        case 'object':
+            return walkObject(schema, def);
+        case 'array':
+            return walkArray(schema, def);
+        case 'tuple':
+            return walkTuple(schema, def);
+        case 'record':
+            return walkRecord(schema, def);
+        case 'nullable':
+        case 'readonly':
+        case 'default':
+        case 'prefault':
+        case 'nonoptional':
+            return walkWrapper(schema, def);
+        default:
+            return { schema };
+    }
+}
+/**
+ * Memoized per schema instance. Repeated calls with the same schema — the common case, since call
+ * sites hold a module-level schema constant — return the same `wireSchema` reference, which is what
+ * LangChain's own JSON-Schema conversion cache is keyed on.
+ */
+const boundaries = new WeakMap();
+/**
+ * Build the {@link StructuredOutputBoundary} for a schema — the one entry point every
+ * `withStructuredOutput` call in this project goes through. See the module doc for what it does and
+ * why.
+ *
+ * @param schema The caller's schema, used unchanged for the final validation.
+ */
+export function structuredOutputBoundary(schema) {
+    const cached = boundaries.get(schema);
+    if (cached)
+        return cached;
+    let walked;
+    try {
+        walked = walk(schema);
+    }
+    catch (error) {
+        // A recursive schema is left exactly as the caller wrote it — the same answer this module gives
+        // for a union, and for the same reason: it will not rewrite what it cannot also normalize.
+        if (error !== CYCLIC)
+            throw error;
+        walked = { schema: schema };
+    }
+    const normalize = walked.normalize;
+    const boundary = {
+        wireSchema: walked.schema,
+        safeParse(raw) {
+            const normalized = normalize ? normalize(raw) : raw;
+            return schema.safeParse(normalized === ABSENT ? undefined : normalized);
+        },
+    };
+    boundaries.set(schema, boundary);
+    return boundary;
+}
+//# sourceMappingURL=structuredOutput.js.map

package/dist/runtime/structuredOutput.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"structuredOutput.js","sourceRoot":"","sources":["../../src/runtime/structuredOutput.ts"],"names":[],"mappings":"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"}

package/dist/utils/ProgressIndicator.d.ts

@@ -1,7 +1,28 @@
+/**
+ * A dot-per-second terminal progress indicator.
+ *
+ * **EXT-53 — always stop it, on every exit path.** In its automatic (non-`manual`) mode the
+ * indicator owns a 1s `setInterval`, which is an *active libuv handle*: while it is alive Node's
+ * event loop can never drain and the process cannot exit, no matter that every await has resolved.
+ * A `stop()` that is only reachable on the success path therefore turns any error into a hang
+ * rather than an exit. Construct the indicator OUTSIDE the `try` and clear it in a `finally`.
+ *
+ * `stop()` is idempotent (see below), so a `finally { indicator.stop() }` is always safe to add
+ * even where a success-path `stop()` already ran.
+ */
 export declare class ProgressIndicator {
     private interval;
+    private readonly manual;
+    private stopped;
     constructor(initialMessage: string, manual?: boolean);
     private indicateInner;
     indicate(): void;
+    /**
+     * Clear the interval (releasing the libuv handle) and terminate the dot line with a newline.
+     *
+     * Idempotent: the handle is nulled and a second call is a complete no-op, so it emits no stray
+     * blank line. That is what makes it safe to call from a `finally` on top of an existing
+     * success-path `stop()`.
+     */
     stop(): void;
 }

package/dist/utils/ProgressIndicator.js

@@ -1,9 +1,24 @@
 import { stdout } from '#src/utils/systemUtils.js';
+/**
+ * A dot-per-second terminal progress indicator.
+ *
+ * **EXT-53 — always stop it, on every exit path.** In its automatic (non-`manual`) mode the
+ * indicator owns a 1s `setInterval`, which is an *active libuv handle*: while it is alive Node's
+ * event loop can never drain and the process cannot exit, no matter that every await has resolved.
+ * A `stop()` that is only reachable on the success path therefore turns any error into a hang
+ * rather than an exit. Construct the indicator OUTSIDE the `try` and clear it in a `finally`.
+ *
+ * `stop()` is idempotent (see below), so a `finally { indicator.stop() }` is always safe to add
+ * even where a success-path `stop()` already ran.
+ */
 export class ProgressIndicator {
     interval = undefined;
+    manual;
+    stopped = false;
     constructor(initialMessage, manual) {
+        this.manual = !!manual;
         stdout.write(initialMessage);
-        if (!manual) {
+        if (!this.manual) {
             this.interval = setInterval(this.indicateInner, 1000);
         }
     }
@@ -11,14 +26,26 @@ export class ProgressIndicator {
         stdout.write('.');
     }
     indicate() {
-        if (this.interval) {
+        if (!this.manual) {
             throw new Error('ProgressIndicator.indicate only to be called in manual mode');
         }
         this.indicateInner();
     }
+    /**
+     * Clear the interval (releasing the libuv handle) and terminate the dot line with a newline.
+     *
+     * Idempotent: the handle is nulled and a second call is a complete no-op, so it emits no stray
+     * blank line. That is what makes it safe to call from a `finally` on top of an existing
+     * success-path `stop()`.
+     */
     stop() {
-        if (this.interval) {
+        if (this.stopped) {
+            return;
+        }
+        this.stopped = true;
+        if (this.interval !== undefined) {
             clearInterval(this.interval);
+            this.interval = undefined;
         }
         stdout.write('\n');
     }

package/dist/utils/ProgressIndicator.js.map

@@ -1 +1 @@
-{"version":3,"file":"ProgressIndicator.js","sourceRoot":"","sources":["../../src/utils/ProgressIndicator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD,MAAM,OAAO,iBAAiB;IACpB,QAAQ,GAAuB,SAAS,CAAC;IAEjD,YAAY,cAAsB,EAAE,MAAgB;QAClD,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC7B,IAAI,CAAC,MAAM,EAAE,CAAC;YACZ,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAsB,CAAC;QAC7E,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,QAAQ;QACN,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED,IAAI;QACF,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC/B,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;CACF"}
+{"version":3,"file":"ProgressIndicator.js","sourceRoot":"","sources":["../../src/utils/ProgressIndicator.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,EAAE,MAAM,2BAA2B,CAAC;AAEnD;;;;;;;;;;;GAWG;AACH,MAAM,OAAO,iBAAiB;IACpB,QAAQ,GAAuB,SAAS,CAAC;IAChC,MAAM,CAAU;IACzB,OAAO,GAAG,KAAK,CAAC;IAExB,YAAY,cAAsB,EAAE,MAAgB;QAClD,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC;QACvB,MAAM,CAAC,KAAK,CAAC,cAAc,CAAC,CAAC;QAC7B,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,IAAI,CAAC,QAAQ,GAAG,WAAW,CAAC,IAAI,CAAC,aAAa,EAAE,IAAI,CAAsB,CAAC;QAC7E,CAAC;IACH,CAAC;IAEO,aAAa;QACnB,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpB,CAAC;IAED,QAAQ;QACN,IAAI,CAAC,IAAI,CAAC,MAAM,EAAE,CAAC;YACjB,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,CAAC,aAAa,EAAE,CAAC;IACvB,CAAC;IAED;;;;;;OAMG;IACH,IAAI;QACF,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,OAAO;QACT,CAAC;QACD,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;QACpB,IAAI,IAAI,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;YAChC,aAAa,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC7B,IAAI,CAAC,QAAQ,GAAG,SAAS,CAAC;QAC5B,CAAC;QACD,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IACrB,CAAC;CACF"}

package/dist/utils/aiignoreUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"aiignoreUtils.js","sourceRoot":"","sources":["../../src/utils/aiignoreUtils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"aiignoreUtils.js","sourceRoot":"","sources":["../../src/utils/aiignoreUtils.ts"],"names":[],"mappings":"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"}

package/dist/utils/binaryOutputUtils.js.map

@@ -1 +1 @@
-{"version":3,"file":"binaryOutputUtils.js","sourceRoot":"","sources":["../../src/utils/binaryOutputUtils.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"binaryOutputUtils.js","sourceRoot":"","sources":["../../src/utils/binaryOutputUtils.ts"],"names":[],"mappings":"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"}

package/dist/utils/consoleUtils.d.ts

@@ -1,4 +1,25 @@
 import { StatusLevel, StatusUpdateCallback } from '#src/core/types.js';
+/**
+ * ANSI color codes — the 16-colour slots only, deliberately. A 16-colour slot is rendered with the
+ * user's OWN terminal theme colour, so output looks native in light and dark schemes alike; a
+ * 256-colour or 24-bit escape would pin us to one palette and clash with half of them.
+ *
+ * Exported so the surfaces that build their own pre-styled blocks (rather than passing a whole
+ * message through {@link colorText}) still draw from this one table — see
+ * `core/launchBanner.ts`, which paints only the face half of each banner row.
+ *
+ * `as const` because `packages/core` publishes `"./*.js": "./dist/*.js"`, so this is PUBLIC API of a
+ * published package: without it any consumer could assign `ANSI_COLORS.magenta` and repaint the
+ * whole CLI from the outside. Read-only, one table, no remote control.
+ */
+export declare const ANSI_COLORS: {
+    readonly red: '\u001B[31m';
+    readonly yellow: '\u001B[33m';
+    readonly green: '\u001B[32m';
+    readonly magenta: '\u001B[35m';
+    readonly dim: '\u001B[2m';
+    readonly reset: '\u001B[0m';
+};
 export declare const initSessionLogging: (logFileName: string, enableLogging: boolean) => void;
 /**
  * Set the console logging level.
@@ -18,11 +39,85 @@ export declare const resetConsoleLevel: () => void;
 export declare const flushSessionLog: () => void;
 export declare const stopSessionLogging: () => void;
 export declare function displayError(message: string): void;
+/**
+ * Open a warning-capture window: from now until {@link endWarningCapture}, each
+ * `displayWarning` message is buffered (IN ADDITION to being printed/logged as usual). Used by
+ * the TUI session module to grab the transient load-time config advisories and thread them into
+ * the persistent notice surface. Idempotent-ish: a second call starts a fresh buffer.
+ */
+export declare const beginWarningCapture: () => void;
+/**
+ * Close the warning-capture window opened by {@link beginWarningCapture} and return everything
+ * collected (empty array if none / never opened). Always call this — a `try/finally` around the
+ * captured work — so a throw can't leak the capture state into later warnings.
+ */
+export declare const endWarningCapture: () => string[];
 export declare function displayWarning(message: string): void;
 export declare function displaySuccess(message: string): void;
 export declare function displayInfo(message: string): void;
 export declare function display(message: string): void;
+/**
+ * TUI-C30 — print one pre-styled tool-call indication block (the plain surface's compact
+ * `✓ name(args…)` + greyed preview, built by `core/plainToolIndication.ts`). Same INFO-level
+ * gate, stdout channel and session-log treatment as {@link displayInfo} — matching the stream
+ * discipline of the existing tool notices — but WITHOUT the blanket dim wrap: the block styles
+ * each line itself (diff colours, per-line dim), and an outer wrapper would be broken by the
+ * inner resets. The session log gets the ANSI-stripped text via {@link writeToSessionLog}.
+ */
+export declare function displayToolIndication(message: string): void;
+/**
+ * TUI-C33 — print the interactive-launch banner (the pre-styled block built by
+ * `core/launchBanner.ts`) on the plain surface. Same DISPLAY-level gate and stdout channel as
+ * {@link display}, so a quieted console silences it too, but deliberately NOT routed through
+ * {@link writeToSessionLog}: the session log is a transcript of the conversation, not a screenshot
+ * of the screen, and a five-row sloth at the top of it is noise. The block also styles itself (the
+ * face half of each row carries the colour), so no outer wrap is applied.
+ */
+export declare function displayLaunchBanner(message: string): void;
 export declare function formatInputPrompt(message: string): string;
+/**
+ * How loud one line of an interactive dialog is — its COLOUR, and nothing else.
+ *
+ * The other `display*` helpers bind a colour to a stream: picking red means picking stdout, picking
+ * yellow means picking stderr. A dialog needs both halves independently, so this names the half that
+ * is about appearance and leaves the stream to {@link displayDialogLine}, which always chooses the
+ * same one.
+ *
+ * `notice`/`warn`/`danger` are the three tones `core/shell/escalationSeverity` grades an escalation
+ * with, so a surface can pass a rater outcome's tone straight through; `plain` is text with no
+ * severity (the framed command, a blank spacer) and `prompt` is the line the human types their
+ * answer after.
+ */
+export type DialogTone = 'plain' | 'notice' | 'warn' | 'danger' | 'prompt';
+/**
+ * Print one line of an interactive dialog — an approval prompt, an attack banner — **on stderr**.
+ *
+ * ## One dialog, one stream
+ *
+ * A dialog's meaning is carried by the ORDER of its lines: a heading, then whose words the next
+ * lines are, then the words. Two streams cannot promise an order. Only writes to the *same* stream
+ * are delivered in the order they were made — across stdout and stderr nothing is promised, and the
+ * difference is observable the moment the two go to different places: with stdout a pipe or a file
+ * it is block-buffered while stderr is not, so a captured run can carry a rater's answer above the
+ * command it answers. A security dialog whose line order holds only on a terminal is not a gate, so
+ * every line of one goes through here and through nothing else.
+ *
+ * **stderr, because a prompt is not program output.** It is the conventional home for interaction,
+ * it is not block-buffered, and it leaves stdout carrying only what the run produced. The cost is
+ * real and is documented for users: piping stdout (`gth code --no-tui | tee log`) no longer captures
+ * the dialog — the terminal still shows it, `2>` still collects it, and an enabled session log still
+ * records it. The log write here is UNCONDITIONAL, which the gated helpers' is not: theirs sits
+ * behind the level guard, so a quieted console drops those lines from the transcript as well as
+ * from the screen. A dialog stays whole in both places.
+ *
+ * ## Not level-gated, on purpose
+ *
+ * The dialog is a QUESTION, not a status message, and the level filter is per line: gated, a quieted
+ * console prints the parts above its threshold and drops the rest, which is how an approval prompt
+ * comes to show a severity heading with no command under it. Half a dialog is worse than none,
+ * because it still looks like a whole one.
+ */
+export declare function displayDialogLine(message: string, tone?: DialogTone): void;
 /**
  * Display a debug message to the console and log it.
  * This function also integrates with debugUtils to output logs when at debug level.