@gaunt-sloth/core 2.0.0-alpha.27 → 2.0.0-alpha.29

package/dist/runtime/structuredOutput.d.ts

@@ -0,0 +1,104 @@
+/**
+ * @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';
+/**
+ * The two halves of one structured-output call: what to send, and how to read the answer.
+ *
+ * @typeParam T The caller's own parsed type — unchanged by the boundary.
+ */
+export interface StructuredOutputBoundary<T> {
+    /**
+     * The schema to hand to `model.withStructuredOutput(...)`. Identical (by reference) to the
+     * caller's schema when it contains no optional field, so a schema that never had the problem is
+     * sent byte-for-byte as it is today.
+     */
+    wireSchema: z.ZodType<Record<string, unknown>>;
+    /**
+     * Validate a model answer: normalize every `null` that stands for "no value" back to the key being
+     * absent, then validate with the caller's **original** schema. Never throws — a malformed answer
+     * comes back as `success: false`, exactly as `schema.safeParse` would.
+     */
+    safeParse(raw: unknown): z.ZodSafeParseResult<T>;
+}
+/**
+ * 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 declare function structuredOutputBoundary<T>(schema: z.ZodType<T>): StructuredOutputBoundary<T>;

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/llmUtils.d.ts

@@ -1,5 +1,6 @@
 import { RunnableConfig } from '@langchain/core/runnables';
 import { GthConfig, PromptSegmentName } from '#src/config.js';
+import type { GthCommand } from '#src/core/types.js';
 import { SystemMessage } from '@langchain/core/messages';
 /**
  * Creates new runnable config.
@@ -29,6 +30,22 @@ export declare function readChatPrompt(config: PromptReadConfig): string;
 export declare function buildSystemMessages(config: GthConfig, modePrompt?: string | null): SystemMessage[];
 export declare function readCodePrompt(config: PromptReadConfig): string;
 export declare function readExecPrompt(config: PromptReadConfig): string;
+/**
+ * GS2-79 — the SINGLE place a command's mode prompt is chosen, for every site that composes a
+ * system prompt via {@link buildSystemMessages}: both agent backends and the subagent profiles.
+ *
+ * It exists because the selection used to be an inline three-branch ternary copied to each of
+ * those sites, and a command missing from one copy is silently served the CHAT prompt — the
+ * default branch — rather than failing. That is how `review`/`pr` came to compose the chat prompt
+ * while the review instructions were smuggled in as a caller-side leading `SystemMessage`, which
+ * Anthropic rejects outright ("System messages are only permitted as the first passed message").
+ * One function means a new command is wired once, and `review`/`pr` cannot silently fall back to
+ * chat again.
+ *
+ * `review`/`pr` resolve to the REVIEW INSTRUCTIONS (`.gsloth.review.md`), which is what makes a
+ * review a review; every command without a mode prompt of its own keeps the chat prompt.
+ */
+export declare function readModePrompt(command: GthCommand | undefined, config: PromptReadConfig): string;
 /**
  * Read a prompt file from the project config dir (honouring identity profiles), falling back
  * to a packaged default unless `noDefaultPrompts` is set. Downstream packages owning their own

package/dist/utils/llmUtils.js

@@ -115,6 +115,34 @@ export function readCodePrompt(config) {
 export function readExecPrompt(config) {
     return readPromptSegment('exec', config);
 }
+/**
+ * GS2-79 — the SINGLE place a command's mode prompt is chosen, for every site that composes a
+ * system prompt via {@link buildSystemMessages}: both agent backends and the subagent profiles.
+ *
+ * It exists because the selection used to be an inline three-branch ternary copied to each of
+ * those sites, and a command missing from one copy is silently served the CHAT prompt — the
+ * default branch — rather than failing. That is how `review`/`pr` came to compose the chat prompt
+ * while the review instructions were smuggled in as a caller-side leading `SystemMessage`, which
+ * Anthropic rejects outright ("System messages are only permitted as the first passed message").
+ * One function means a new command is wired once, and `review`/`pr` cannot silently fall back to
+ * chat again.
+ *
+ * `review`/`pr` resolve to the REVIEW INSTRUCTIONS (`.gsloth.review.md`), which is what makes a
+ * review a review; every command without a mode prompt of its own keeps the chat prompt.
+ */
+export function readModePrompt(command, config) {
+    switch (command) {
+        case 'code':
+            return readCodePrompt(config);
+        case 'exec':
+            return readExecPrompt(config);
+        case 'review':
+        case 'pr':
+            return readReviewInstructions(config);
+        default:
+            return readChatPrompt(config);
+    }
+}
 /**
  * Read a prompt file from the project config dir (honouring identity profiles), falling back
  * to a packaged default unless `noDefaultPrompts` is set. Downstream packages owning their own

package/dist/utils/llmUtils.js.map

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

package/dist/utils/systemPromptNotes.d.ts

@@ -15,6 +15,7 @@
  * `GthDeepAgent`.
  */
 import type { McpServerInstruction } from '#src/core/types.js';
+import { type FilesystemToolsConfig } from '#src/config/filesystem-tools.js';
 /**
  * EXT-26: the platform-agnostic tail shared by both {@link appendOsShellNote} branches.
  *
@@ -81,6 +82,18 @@ export interface CommitCoAuthor {
  *    measured not to work. A file path carries no shell metacharacters, so the file form removes the
  *    failure mode instead of asking the model to avoid it.
  *
+ * **The clause that names the writing tool is gated on `filesystem`** (EXT-84), through the one
+ * shared derivation {@link isWriteFileToolRegistered} — the same interpretation that decides which
+ * tools are actually registered. Naming an unregistered tool while forbidding both the shell
+ * fallback and the inline flag leaves the model NO compliant path, and its likeliest recovery is
+ * the inline form this note exists to prevent. So when the write tool is registered the note names
+ * it literally (the overwhelmingly common case, and a literal name is what makes the instruction
+ * actionable); when it is not, the note names no tool, keeps both prohibitions and the file form,
+ * and supplies the compliant path that remains: do not commit, and hand the message back to the
+ * user. That branch states no availability claim of its own — the backends read the same
+ * `filesystem` value but register filesystem tools differently, so a note asserting "you have no
+ * file-writing tool" could be flatly false on one of them.
+ *
  * The note's prose carries **no backtick and no other markup** — including no angle-bracket
  * placeholder: it is the one piece of guidance whose subject is how to write a commit message, so
  * quoting its own examples in backticks would demonstrate the exact style rule 2 exists to stop, and
@@ -100,7 +113,7 @@ export interface CommitCoAuthor {
  * the deep `GthDeepAgent` inject it (the git-commit capability rides on `run_shell_command`, which
  * both backends expose in code mode). Returns the note alone when there is no base prompt.
  */
-export declare function appendCommitCoAuthorNote(systemPrompt: string | undefined, coAuthor?: CommitCoAuthor, modelIdentity?: ResolvedModelIdentity): string;
+export declare function appendCommitCoAuthorNote(systemPrompt: string | undefined, coAuthor?: CommitCoAuthor, modelIdentity?: ResolvedModelIdentity, filesystem?: FilesystemToolsConfig): string;
 /**
  * GS2-34/GS2-53 — the resolved active-model identity, as a STRUCTURED value.
  *