@tormentalabs/claude-code-wire-compat 0.1.0-rc.17 → 0.2.0

package/dist/thinking.js

@@ -1,9 +1,23 @@
 // SPDX-License-Identifier: GPL-3.0-or-later
+import { profileBehaviors } from "./profile-behaviors.js";
+import { CLAUDE_CODE_2_1_195_PROFILE } from "./profiles/claude-code-2.1.195.js";
 /**
  * Per-model output token limits, ported from upstream `Xxe` at byte offset
- * 227378240. Keyed on the NORMALISED model id, and deliberately independent of
- * the catalogue: `claude-3-opus`, `claude-3-sonnet` and `claude-3-haiku` are
- * reachable through the normaliser but have no catalogue entry.
+ * 227378240. Keyed on the NORMALISED model id.
+ *
+ * Resolution order, since Fase 1.2:
+ *
+ *   1. The pinned 2.1.195 catalogue, when the id has an entry carrying
+ *      `maxOutputTokens`. That is the single source of truth for every model
+ *      the profile knows, and `token-limits-equivalence.test.ts` pins the two
+ *      sources cell by cell.
+ *   2. Otherwise the transcribed `Xxe` table below, preserved intact as the
+ *      demarcated fallback. It is NOT dead code and must not be trimmed to
+ *      "only the ids the catalogue lacks": `claude-3-opus`, `claude-3-sonnet`
+ *      and `claude-3-haiku` are reachable through the normaliser with no
+ *      catalogue entry, `claude-mythos-5` is absent from the catalogue by
+ *      product decision D-1, and any id from a newer client lands on the
+ *      final fallback row.
  *
  * Both fields are load-bearing. `upperLimit` seeds the thinking budget when the
  * caller supplies none (upstream `wvi = Xxe(e).upperLimit - 1`); `default` caps
@@ -17,33 +31,84 @@
  *     override this package cannot observe.
  *   - `bvi(e)` adjusts BOTH fields, but sits behind `_vi()`, which returns a
  *     hard `false`. Dead code upstream.
+ *
+ * From 2.1.222 onward upstream grew a THIRD adjustment, this one derived from
+ * the request rather than from host state, and therefore observable: see
+ * `requestedMaxTokens` below.
+ *
+ * @param requestedMaxTokens
+ *   The caller's own `max_tokens`, when the call site has it. Modelled for
+ *   profiles from 2.1.222 onward only; see the demarcated block below.
  */
-export function modelOutputTokenLimits(normalizedId) {
-    if (normalizedId === "claude-fable-5" || normalizedId === "claude-mythos-5") {
-        return { default: 64000, upperLimit: 128000 };
-    }
-    if (normalizedId === "claude-opus-4-8") {
-        return { default: 64000, upperLimit: 128000 };
-    }
-    if (normalizedId === "claude-opus-4-7") {
-        return { default: 64000, upperLimit: 128000 };
+export function modelOutputTokenLimits(normalizedId, profile = CLAUDE_CODE_2_1_195_PROFILE, requestedMaxTokens) {
+    const resolved = resolveDeclaredLimits(normalizedId, profile);
+    /*
+     * ---- Demarcated: request-derived upper bound, upstream 2.1.222+. ----
+     *
+     * Upstream raises `upperLimit` to the caller's own `max_tokens` and lowers
+     * `default` to fit under it:
+     *
+     *   upperLimit = requestedMaxTokens;
+     *   default    = Math.min(default, upperLimit);
+     *
+     * Verified byte-identical between upstream 2.1.222 and 2.1.233.
+     *
+     * The gate is STRUCTURAL, not a capability flag: this behaviour exists in
+     * upstream 2.1.222+ and 2.1.195 does not have it, so the 195 profile must
+     * never see it. Which profiles are on which side is `profile-behaviors.ts`'s
+     * question, not this module's.
+     *
+     * `Number.isSafeInteger` is deliberately stricter than upstream's truthy
+     * check. The upstream runtime only ever produces integers in this field, so
+     * the two agree on every reachable input; here a NaN or Infinity would
+     * propagate straight into `budget_tokens`, which must stay an integer.
+     */
+    if (profileBehaviors(profile).requestDerivedTokenCeiling &&
+        requestedMaxTokens !== undefined &&
+        Number.isSafeInteger(requestedMaxTokens) &&
+        requestedMaxTokens >= 4096) {
+        const upperLimit = requestedMaxTokens;
+        return { default: Math.min(resolved.default, upperLimit), upperLimit };
     }
-    if (normalizedId === "claude-sonnet-4-6") {
-        return { default: 32000, upperLimit: 128000 };
+    return resolved;
+}
+function resolveDeclaredLimits(normalizedId, profile) {
+    const declared = profile.supportedModels[normalizedId]?.maxOutputTokens;
+    if (declared !== undefined) {
+        // `upper` is the catalogue's name for what this module calls `upperLimit`;
+        // the rename happens here and nowhere else.
+        return { default: declared.default, upperLimit: declared.upper };
     }
-    if (normalizedId === "claude-opus-4-6") {
+    /*
+     * ---- Demarcated fallback: the reachable remainder of `Xxe`. ----
+     *
+     * No catalogue id reaches this point. Every entry of the 2.1.195 catalogue
+     * declares `maxOutputTokens`, and `capability-equivalence.test.ts` fails if
+     * one stops doing so, which is what keeps the rows below to the ids the
+     * catalogue genuinely cannot answer for:
+     *
+     *   - `claude-mythos-5` has no catalogue entry by product decision D-1.
+     *   - `claude-3-opus`, `claude-3-sonnet` and `claude-3-haiku` are reachable
+     *     through the normaliser and predate the catalogue.
+     *
+     * The rows for catalogued ids were deleted rather than kept "just in case":
+     * they were unreachable, so they could be neither covered nor
+     * mutation-killed, and a second copy of a limit that no longer serves any
+     * request is exactly the duplicated table
+     * `test/governance/single-source-of-truth.test.ts` exists to prevent.
+     *
+     * This mirrors upstream 2.1.222, where derivation is catalogue-first and
+     * the surviving legacy rows are the `claude-3-*` ones plus a generic tail.
+     *
+     * If a future profile omits `maxOutputTokens` for some id, that id lands on
+     * the generic tail below -- 32000/128000 -- rather than on a stale
+     * per-model row. That is deliberate: a wrong-but-loud generic limit is
+     * recoverable, a silently stale per-model limit is not. The equivalence
+     * guard fires first in any case.
+     */
+    if (normalizedId === "claude-mythos-5") {
         return { default: 64000, upperLimit: 128000 };
     }
-    if (normalizedId === "claude-opus-4-5" ||
-        normalizedId === "claude-sonnet-4-0" ||
-        normalizedId === "claude-sonnet-4-5" ||
-        normalizedId === "claude-haiku-4-5") {
-        return { default: 32000, upperLimit: 64000 };
-    }
-    if (normalizedId === "claude-opus-4-1" ||
-        normalizedId === "claude-opus-4-0") {
-        return { default: 32000, upperLimit: 32000 };
-    }
     if (normalizedId === "claude-3-opus") {
         return { default: 4096, upperLimit: 4096 };
     }
@@ -53,13 +118,6 @@ export function modelOutputTokenLimits(normalizedId) {
     if (normalizedId === "claude-3-haiku") {
         return { default: 4096, upperLimit: 4096 };
     }
-    if (normalizedId === "claude-3-5-sonnet" ||
-        normalizedId === "claude-3-5-haiku") {
-        return { default: 8192, upperLimit: 8192 };
-    }
-    if (normalizedId === "claude-3-7-sonnet") {
-        return { default: 32000, upperLimit: 64000 };
-    }
     return { default: 32000, upperLimit: 128000 };
 }
 /**
@@ -81,9 +139,15 @@ export function modelOutputTokenLimits(normalizedId) {
  * Upstream uses `||`, not `??`, so a zero override would fall back to the
  * default. Unreachable here: `max_tokens` is validated as a positive integer
  * before this runs.
+ *
+ * `requested` is forwarded as the request-derived bound so that this call site
+ * reads the same table upstream reads. It cannot change the result: the
+ * override only ever lowers `default` to `requested`, and
+ * `min(requested, min(default, requested)) === min(requested, default)`. It is
+ * passed for coherence of reading, not for effect.
  */
-export function clampMaxTokens(requested, normalizedId) {
-    return Math.min(requested, modelOutputTokenLimits(normalizedId).default);
+export function clampMaxTokens(requested, normalizedId, profile = CLAUDE_CODE_2_1_195_PROFILE) {
+    return Math.min(requested, modelOutputTokenLimits(normalizedId, profile, requested).default);
 }
 /**
  * Upstream `Yn = nr && CM() && QOt(u) ? n.display : void 0`, combined with the
@@ -121,7 +185,7 @@ export function isThinkingDisplayActive(request, capabilities, betaPolicy) {
  * adaptive. Serialised bodies are compared byte for byte, so the insertion
  * order below must not be rearranged.
  */
-export function resolveThinking(request, normalizedId, capabilities, betaPolicy, maxTokens) {
+export function resolveThinking(request, normalizedId, capabilities, betaPolicy, maxTokens, profile = CLAUDE_CODE_2_1_195_PROFILE) {
     // Upstream `nr = n.type !== "disabled" && !CLAUDE_CODE_DISABLE_THINKING`.
     const requestActive = request !== undefined && request.type !== "disabled";
     const displayActive = isThinkingDisplayActive(request, capabilities, betaPolicy);
@@ -137,8 +201,13 @@ export function resolveThinking(request, normalizedId, capabilities, betaPolicy,
             // Upstream: `let Tr = wvi(u)` — the model's upper limit minus one —
             // overridden by the caller's budget when supplied, then clamped by
             // `Tr = Math.min(Fi - 1, Tr)` where `Fi` is the emitted `max_tokens`.
+            //
+            // This is the one wire-visible consumer of the request-derived bound: on
+            // a 2.1.222+ profile a caller asking for a `max_tokens` above the
+            // catalogue's upper limit seeds the default budget from THEIR number
+            // minus one, not from the catalogue's.
             const requested = request.budgetTokens ??
-                modelOutputTokenLimits(normalizedId).upperLimit - 1;
+                modelOutputTokenLimits(normalizedId, profile, maxTokens).upperLimit - 1;
             emitted = { budget_tokens: Math.min(maxTokens - 1, requested) };
             emitted["type"] = "enabled";
             if (display !== undefined)

package/dist/thinking.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tormentalabs/claude-code-wire-compat",
-  "version": "0.1.0-rc.17",
+  "version": "0.2.0",
   "description": "Runtime-neutral Claude Code Messages wire compatibility primitives",
   "type": "module",
   "private": false,
@@ -19,6 +19,7 @@
   },
   "files": [
     "dist",
+    "src",
     "README.md",
     "LICENSE",
     "NOTICE",
@@ -32,6 +33,10 @@
     "./profiles/claude-code-2.1.195": {
       "types": "./dist/profiles/claude-code-2.1.195.d.ts",
       "import": "./dist/profiles/claude-code-2.1.195.js"
+    },
+    "./profiles/claude-code-2.1.233": {
+      "types": "./dist/profiles/claude-code-2.1.233.d.ts",
+      "import": "./dist/profiles/claude-code-2.1.233.js"
     }
   },
   "types": "./dist/index.d.ts",
@@ -48,7 +53,10 @@
     "test:coverage": "vitest run --coverage",
     "test:pack": "node scripts/verify-packed-consumers.mjs",
     "pack:check": "npm pack --dry-run && publint && attw --pack . --profile esm-only",
-    "drift:check": "node scripts/verify-drift.mjs"
+    "drift:check": "node scripts/verify-drift.mjs",
+    "fixtures:check": "node scripts/seal-golden-fixtures.mjs --check",
+    "fixtures:seal": "node scripts/seal-golden-fixtures.mjs --write",
+    "extract:profile": "node scripts/extract-upstream-profile.mjs"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.5",

package/src/anti-verbosity.ts

@@ -0,0 +1,219 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+import type {
+  AntiVerbosityPolicy,
+  AntiVerbositySection,
+  ClaudeCodeProtocolProfile,
+} from "./contracts.js";
+import { ClaudeCodeWireError } from "./contracts.js";
+import { normalizeModelId } from "./model-identity.js";
+import { CLAUDE_CODE_2_1_195_PROFILE } from "./profiles/claude-code-2.1.195.js";
+
+/**
+ * The genuine client's anti-verbosity system-prompt section, and the three-way
+ * selector that chooses between its variants.
+ *
+ * Upstream this is `ytm(e)` at byte offset 238083640 of the
+ * pinned client build. The four strings below were not transcribed by hand: they
+ * were produced by executing the client's own template literals against stubbed
+ * predicates. The forensic dump tooling collapses non-printable runs and so
+ * cannot be trusted for whitespace inside a template literal; the branch-3
+ * heading in particular is followed by a newline, not a space, which a
+ * dump-based reading got wrong.
+ *
+ * The package EXPOSES this text and never injects it. `buildClaudeCodeRequest`
+ * does not consult this module. The genuine client assembles a large system
+ * prompt from many sections and this package models only the protocol envelope,
+ * so silently adding one section would produce a body matching neither the
+ * client nor the caller's intent. This is the same boundary already settled for
+ * `defaultEffort` and for cache-breakpoint placement: expose, let the caller
+ * decide.
+ */
+
+/** Mirrors upstream defaults: a stock first-party install reports both false. */
+export const DEFAULT_ANTI_VERBOSITY_POLICY: AntiVerbosityPolicy = Object.freeze(
+  {
+    briefModeEnabled: false,
+    pewterOwlToolEnabled: false,
+  },
+);
+
+/**
+ * Branch 1 with upstream `htm` true, which is the default because `htm` is
+ * `!(isBriefEnabled() || pewterOwlTool())`. Carries the extra paragraph about
+ * text written between tool calls.
+ */
+export const COMMUNICATING_WITH_THE_USER_FULL =
+  "# Communicating with the user\n" +
+  "\n" +
+  "Your text output is what the user reads; they usually can't see your thinking or the raw tool results. Write it for a teammate who stepped away and is catching up, not for a log file: they don't know the codenames or shorthand you created along the way, and they didn't watch your process unfold. Before your first tool call, say in a sentence what you're about to do; while working, give brief updates when you find something load-bearing or change direction.\n" +
+  "\n" +
+  "Text you write between tool calls may not be shown to the user. Everything the user needs from this turn — answers, summaries, findings, conclusions, deliverables — must be in the final text message of your turn, with no tool calls after it. Keep text between tool calls to brief status notes. If something important appeared only mid-turn or in your thinking, restate it in that final message.\n" +
+  "\n" +
+  'Lead with the outcome. Your first sentence after finishing should answer "what happened" or "what did you find" — the thing the user would ask for if they said "just give me the TLDR." Supporting detail and reasoning come after, for readers who want them.\n' +
+  "\n" +
+  "Being readable and being concise are different things, and readable matters more. If the user has to reread your summary or ask you to explain, any time saved by brevity is gone. The way to keep output short is to be selective about what you include (drop details that don't change what the reader would do next), not to compress the writing into fragments, abbreviations, arrow chains like `A → B → fails`, or jargon. What you do include, write in complete sentences with the technical terms spelled out. Don't make the reader cross-reference labels or numbering you invented earlier; say what you mean in place.\n" +
+  "\n" +
+  "Match the response to the question: a simple question gets a direct answer in prose, not headers and sections. Use tables only for short enumerable facts, with explanations in the surrounding prose rather than the cells. Calibrate to the user — a bit tighter for an expert, more explanatory for someone newer.\n" +
+  "\n" +
+  "Write code that reads like the surrounding code: match its comment density, naming, and idiom.\n" +
+  "Only write a code comment to state a constraint the code itself can't show — never to say where it came from, what the next line does, or why your change is correct; that's you talking to the reviewer, not the next reader, and it's noise the moment the PR merges.";
+
+/** Branch 1 with upstream `htm` false: brief mode or the pewter-owl tool is on. */
+export const COMMUNICATING_WITH_THE_USER_CONDENSED =
+  "# Communicating with the user\n" +
+  "\n" +
+  "Your text output is what the user reads between tool calls; they usually can't see your thinking or the raw tool results. Write it for a teammate who stepped away and is catching up, not for a log file: they don't know the codenames or shorthand you created along the way, and they didn't watch your process unfold. Before your first tool call, say in a sentence what you're about to do; while working, give brief updates when you find something load-bearing or change direction.\n" +
+  "\n" +
+  'Lead with the outcome. Your first sentence after finishing should answer "what happened" or "what did you find" — the thing the user would ask for if they said "just give me the TLDR." Supporting detail and reasoning come after, for readers who want them.\n' +
+  "\n" +
+  "Being readable and being concise are different things, and readable matters more. If the user has to reread your summary or ask you to explain, any time saved by brevity is gone. The way to keep output short is to be selective about what you include (drop details that don't change what the reader would do next), not to compress the writing into fragments, abbreviations, arrow chains like `A → B → fails`, or jargon. What you do include, write in complete sentences with the technical terms spelled out. Don't make the reader cross-reference labels or numbering you invented earlier; say what you mean in place.\n" +
+  "\n" +
+  "Match the response to the question: a simple question gets a direct answer in prose, not headers and sections. Use tables only for short enumerable facts, with explanations in the surrounding prose rather than the cells. Calibrate to the user — a bit tighter for an expert, more explanatory for someone newer.\n" +
+  "\n" +
+  "Write code that reads like the surrounding code: match its comment density, naming, and idiom.\n" +
+  "Only write a code comment to state a constraint the code itself can't show — never to say where it came from, what the next line does, or why your change is correct; that's you talking to the reviewer, not the next reader, and it's noise the moment the PR merges.";
+
+/** Branch 2, upstream `ph(e)` true. A single sentence. */
+export const LEAN_SECTION =
+  "Write code that reads like the surrounding code: match its comment density, naming, and idiom.";
+
+/** Branch 3, the fallthrough. */
+export const TEXT_OUTPUT_SECTION =
+  "# Text output (does not apply to tool calls)\n" +
+  "Assume users can't see most tool calls or thinking — only your text output. Before your first tool call, state in one sentence what you're about to do. While working, give short updates at key moments: when you find something, when you change direction, or when you hit a blocker. Brief is good — silent is not. One sentence per update is almost always enough.\n" +
+  "\n" +
+  "Don't narrate your internal deliberation. User-facing text should be relevant communication to the user, not a running commentary on your thought process. State results and decisions directly, and focus user-facing text on relevant updates for the user.\n" +
+  "\n" +
+  "When you do write updates, write so the reader can pick up cold: complete sentences, no unexplained jargon or shorthand from earlier in the session. But keep it tight — a clear sentence is better than a clear paragraph.\n" +
+  "\n" +
+  "End-of-turn summary: one or two sentences. What changed and what's next. Nothing else.\n" +
+  "\n" +
+  "Match responses to the task: a simple question gets a direct answer, not headers and sections.\n" +
+  "\n" +
+  "In code: default to writing no comments. Never write multi-paragraph docstrings or multi-line comment blocks — one short line max. Don't create planning, decision, or analysis documents unless the user asks for them — work from conversation context, not intermediate files.";
+
+/**
+ * SHA-256 of each constant as executed from the genuine client. A test pins
+ * these so any edit to the text above fails loudly rather than silently
+ * shipping a divergent prompt.
+ */
+export const ANTI_VERBOSITY_DIGESTS = Object.freeze({
+  communicatingWithTheUserFull:
+    "41a8a87303e6f6f8224906daf9741fd6be495b79400854d92078991d15e9c56c",
+  communicatingWithTheUserCondensed:
+    "7028dc6d1492b7616b9b5f2f58416c09a0db5cd671f1032fbaeb9120ad51437b",
+  lean: "ee43af37398581e92bde06d341c98c7b7a9ff6c56023c2bc17b9feaf2d6e31ea",
+  textOutput:
+    "c184a5d4b4b6a0fc374a37c69f72937abf38bcccaa2d0cce0427968fcda3ccc7",
+});
+
+/** Upstream `i_e`, deliberately applied to the RAW caller string. */
+const EAP_PATTERN = /-eap($|\[)/iu;
+
+function catalogueCapability(
+  normalizedId: string,
+  capability: string,
+  profile: ClaudeCodeProtocolProfile,
+): boolean {
+  if (!Object.hasOwn(profile.supportedModels, normalizedId)) return false;
+  return (
+    profile.supportedModels[normalizedId]?.capabilities.includes(capability) ===
+    true
+  );
+}
+
+/**
+ * Upstream `Mte`. This is one of the few places where the catalogue capability
+ * array is genuinely load-bearing: unlike the nine model-capability predicates,
+ * `Mte` has no provider fallback, so the membership test decides the result.
+ */
+function hasFableMitigations(
+  normalizedId: string,
+  profile: ClaudeCodeProtocolProfile,
+): boolean {
+  return (
+    catalogueCapability(normalizedId, "fable_5_mitigations", profile) ||
+    normalizedId === "claude-mythos-5"
+  );
+}
+
+/**
+ * Upstream `Kkd`. Its trailing `return !td()` is false on the first-party
+ * provider this profile pins, so an unrecognised identifier falls through to
+ * the lean branch rather than the text-output branch.
+ *
+ * Upstream also carries `|| t === "claude-mythos-5"` beside the
+ * `lean_prompt` test. It is omitted here because it is unreachable: the only
+ * caller tests `hasFableMitigations` first, which already claims mythos-5 for
+ * the communicating-with-the-user branch. Upstream shares `Kkd` with other
+ * call sites and so still needs it. Restore it if this helper ever gains a
+ * second caller.
+ */
+function usesTextOutputSection(
+  rawModel: string,
+  profile: ClaudeCodeProtocolProfile,
+): boolean {
+  if (EAP_PATTERN.test(rawModel)) return false;
+  const id = normalizeModelId(rawModel);
+  if (catalogueCapability(id, "lean_prompt", profile)) return false;
+  return (
+    id.includes("claude-3-") ||
+    id.includes("haiku") ||
+    id.includes("sonnet") ||
+    id === "claude-opus-4-0" ||
+    id === "claude-opus-4-1" ||
+    id === "claude-opus-4-5" ||
+    id === "claude-opus-4-6" ||
+    id === "claude-opus-4-7"
+  );
+}
+
+/**
+ * Reports which branch of upstream `ytm` a model selects.
+ *
+ * Upstream `gtm` is `return !1`, so branch 1 is gated on `Mte` alone. Note
+ * that `ytm` passes the NORMALISED id to `Mte` but the RAW caller string to
+ * `ph`, because `ph` reaches `i_e`, which must see an unnormalised
+ * `-eap` suffix. That asymmetry is reproduced here.
+ */
+export function selectAntiVerbositySection(
+  rawModel: string,
+  profile: ClaudeCodeProtocolProfile = CLAUDE_CODE_2_1_195_PROFILE,
+): AntiVerbositySection {
+  if (typeof rawModel !== "string" || rawModel.length === 0) {
+    throw new ClaudeCodeWireError("INVALID_INPUT");
+  }
+  if (hasFableMitigations(normalizeModelId(rawModel), profile)) {
+    return "communicating-with-the-user";
+  }
+  return usesTextOutputSection(rawModel, profile) ? "text-output" : "lean";
+}
+
+/** Returns the exact section text the genuine client would emit for a model. */
+export function antiVerbosityText(
+  rawModel: string,
+  policy: AntiVerbosityPolicy = DEFAULT_ANTI_VERBOSITY_POLICY,
+  profile: ClaudeCodeProtocolProfile = CLAUDE_CODE_2_1_195_PROFILE,
+): string {
+  // Validated eagerly, and for every section rather than only the one that
+  // reads it, so a malformed policy fails the same way regardless of which
+  // model it is paired with. `selectAntiVerbositySection` validates its own
+  // argument the same way despite the declared types, because callers reach
+  // this module across an untyped boundary.
+  const candidate: unknown = policy;
+  if (candidate === null || typeof candidate !== "object") {
+    throw new ClaudeCodeWireError("INVALID_INPUT");
+  }
+  const brief: unknown = Reflect.get(candidate, "briefModeEnabled");
+  const pewterOwl: unknown = Reflect.get(candidate, "pewterOwlToolEnabled");
+  if (typeof brief !== "boolean" || typeof pewterOwl !== "boolean") {
+    throw new ClaudeCodeWireError("INVALID_INPUT");
+  }
+  const section = selectAntiVerbositySection(rawModel, profile);
+  if (section === "lean") return LEAN_SECTION;
+  if (section === "text-output") return TEXT_OUTPUT_SECTION;
+  return brief || pewterOwl
+    ? COMMUNICATING_WITH_THE_USER_CONDENSED
+    : COMMUNICATING_WITH_THE_USER_FULL;
+}

package/src/beta-registry.ts

@@ -0,0 +1,140 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+interface BetaRegistryEntry {
+  readonly featureKey: string;
+  readonly header: string;
+}
+
+function deepFreeze<T>(value: T): T {
+  if (value !== null && typeof value === "object") {
+    for (const key of Reflect.ownKeys(value)) {
+      deepFreeze(Reflect.get(value, key));
+    }
+    Object.freeze(value);
+  }
+  return value;
+}
+
+/** Genuine-client beta registry, upstream `Udd`. */
+export const BETA_REGISTRY = deepFreeze({
+  CLAUDE_CODE: { featureKey: "claude_code", header: "claude-code-20250219" }, // Y2e
+  OAUTH_AUTH: { featureKey: "oauth_auth", header: "oauth-2025-04-20" }, // qIe
+  INTERLEAVED_THINKING: {
+    featureKey: "interleaved_thinking",
+    header: "interleaved-thinking-2025-05-14",
+  }, // Gnt
+  LONG_CONTEXT: { featureKey: "long_context", header: "context-1m-2025-08-07" }, // FY
+  CONTEXT_MANAGEMENT: {
+    featureKey: "context_management",
+    header: "context-management-2025-06-27",
+  }, // X2e
+  STRUCTURED_OUTPUTS: {
+    featureKey: "structured_outputs",
+    header: "structured-outputs-2025-12-15",
+  }, // lte
+  WEB_SEARCH: { featureKey: "web_search", header: "web-search-2025-03-05" }, // IPt
+  ADVANCED_TOOL_USE: {
+    featureKey: "tool_search",
+    header: "advanced-tool-use-2025-11-20",
+  }, // p2r
+  TOOL_SEARCH: {
+    featureKey: "tool_search",
+    header: "tool-search-tool-2025-10-19",
+  }, // xPt
+  EFFORT: { featureKey: "effort", header: "effort-2025-11-24" }, // Wnt
+  TASK_BUDGETS: {
+    featureKey: "task_budgets",
+    header: "task-budgets-2026-03-13",
+  }, // lAn
+  PROMPT_CACHING_SCOPE: {
+    featureKey: "prompt_caching_scope",
+    header: "prompt-caching-scope-2026-01-05",
+  }, // qnt
+  EXTENDED_CACHE_TTL: {
+    featureKey: "extended_cache_ttl",
+    header: "extended-cache-ttl-2025-04-11",
+  }, // J2e
+  SPEED: { featureKey: "speed", header: "fast-mode-2026-02-01" }, // Vnt
+  REDACT_THINKING: {
+    featureKey: "redact_thinking",
+    header: "redact-thinking-2026-02-12",
+  }, // kPt
+  THINKING_TOKEN_COUNT: {
+    featureKey: "thinking_token_count",
+    header: "thinking-token-count-2026-05-13",
+  }, // cAn
+  NARRATION_SUMMARIES: {
+    featureKey: "narration_summaries",
+    header: "summarize-connector-text-2026-03-13",
+  }, // RPt
+  AFK_MODE: { featureKey: "afk_mode", header: "afk-mode-2026-01-31" }, // T0
+  ADVISOR_TOOL: {
+    featureKey: "advisor_tool",
+    header: "advisor-tool-2026-03-01",
+  }, // f2r
+  CACHE_DIAGNOSIS: {
+    featureKey: "cache_diagnosis",
+    header: "cache-diagnosis-2026-04-07",
+  }, // fye
+  CONTEXT_HINT: {
+    featureKey: "context_hint",
+    header: "context-hint-2026-04-09",
+  }, // m2r
+  MCP_SERVERS: {
+    featureKey: "mcp_servers",
+    header: "mcp-servers-2025-12-04",
+  }, // g2r
+  FILES_API: { featureKey: "files_api", header: "files-api-2025-04-14" }, // h2r
+  ENVIRONMENTS: {
+    featureKey: "environments",
+    header: "environments-2025-11-01",
+  }, // y2r
+  CCR_BYOC: { featureKey: "ccr_byoc", header: "ccr-byoc-2025-07-29" }, // _2r
+  MID_CONVERSATION_SYSTEM: {
+    featureKey: "mid_conversation_system",
+    header: "mid-conversation-system-2026-04-07",
+  }, // jY
+  SERVER_SIDE_FALLBACK: {
+    featureKey: "server_side_fallback",
+    header: "server-side-fallback-2026-06-01",
+  }, // r1
+  FALLBACK_CREDIT: {
+    featureKey: "fallback_credit",
+    header: "fallback-credit-2026-06-01",
+  }, // o1
+} satisfies Record<string, BetaRegistryEntry>);
+
+// Reserved for later work packages; upstream `Pvi` third-party filtering.
+export const THIRD_PARTY_ALLOWED_BETAS: ReadonlySet<string> = Object.freeze(
+  new Set([
+    BETA_REGISTRY.CLAUDE_CODE.header,
+    BETA_REGISTRY.INTERLEAVED_THINKING.header,
+    BETA_REGISTRY.LONG_CONTEXT.header,
+    BETA_REGISTRY.CONTEXT_MANAGEMENT.header,
+    BETA_REGISTRY.STRUCTURED_OUTPUTS.header,
+    BETA_REGISTRY.WEB_SEARCH.header,
+    BETA_REGISTRY.EFFORT.header,
+    BETA_REGISTRY.TOOL_SEARCH.header,
+    BETA_REGISTRY.AFK_MODE.header,
+    BETA_REGISTRY.FALLBACK_CREDIT.header,
+  ]),
+);
+
+// Reserved for later work packages; upstream `S2r` provider filtering.
+export const BEDROCK_UNSUPPORTED_BETAS: ReadonlySet<string> = Object.freeze(
+  new Set([
+    BETA_REGISTRY.INTERLEAVED_THINKING.header,
+    BETA_REGISTRY.LONG_CONTEXT.header,
+    BETA_REGISTRY.TOOL_SEARCH.header,
+  ]),
+);
+
+// Reserved for later work packages; upstream `E2r` count-tokens selection.
+export const COUNT_TOKENS_BETAS: ReadonlySet<string> = Object.freeze(
+  new Set([
+    BETA_REGISTRY.CLAUDE_CODE.header,
+    BETA_REGISTRY.INTERLEAVED_THINKING.header,
+    BETA_REGISTRY.CONTEXT_MANAGEMENT.header,
+    BETA_REGISTRY.OAUTH_AUTH.header,
+  ]),
+);