@tormentalabs/claude-code-wire-compat 0.4.0 → 0.6.0

package/dist/thinking.js

@@ -176,6 +176,72 @@ export function isThinkingDisplayActive(request, capabilities, betaPolicy) {
         capabilities.interleavedThinking &&
         betaPolicy.experimentalBetasEnabled);
 }
+/**
+ * Narrows an unvalidated caller `thinking` value to its `type` literal.
+ *
+ * Deliberately tolerant of unvalidated input for the same reason
+ * `isThinkingDisplayActive` is: beta composition asks this question before
+ * `buildCanonicalBody` has validated the shape. Anything malformed answers
+ * `undefined` here and is rejected later by the body validator.
+ */
+function thinkingRequestType(request) {
+    if (request === null || typeof request !== "object")
+        return undefined;
+    const type = request["type"];
+    if (type === "enabled" || type === "adaptive" || type === "disabled") {
+        return type;
+    }
+    return undefined;
+}
+/**
+ * Decides WHICH thinking object `resolveThinking` will emit, without building
+ * it.
+ *
+ * Split out of `resolveThinking` so that beta composition and body emission
+ * answer the same question from one place. A second, independently written
+ * copy of this predicate is exactly how a beta header and the body field it
+ * is coupled to drift apart.
+ */
+export function resolveThinkingType(requestType, capabilities) {
+    const requestActive = requestType !== undefined && requestType !== "disabled";
+    if (requestActive && capabilities.thinking) {
+        return capabilities.adaptiveThinking ? "adaptive" : "enabled";
+    }
+    if (requestType === "disabled" &&
+        capabilities.thinking &&
+        !capabilities.rejectsDisabledThinking) {
+        return "disabled";
+    }
+    return undefined;
+}
+/**
+ * Upstream `ac = Kg && Fg() && iQt(model)`, the predicate the 2.1.280 thinking
+ * push sites gate on, with `Fg()` (`experimentalBetasEnabled`) factored OUT.
+ *
+ * Every push site conjoins the experimental gate itself, so folding it in here
+ * would count it twice and make the one site that legitimately does not want it
+ * impossible to express. `Kg`'s environment-disable term is not modelled: this
+ * package reads no environment.
+ *
+ * This is deliberately NOT `ResolvedThinking.requestActive`. That one is true
+ * whenever the caller asked for thinking at all, including for a model whose
+ * capabilities emit no thinking object — which would ship a thinking beta
+ * header for a body that carries no thinking block.
+ *
+ * Upstream `ac` conjoins only the interleaved predicate `iQt`; requiring a
+ * resolved `"adaptive"`/`"enabled"` type additionally requires
+ * `capabilities.thinking`, one conjunct more than upstream. That extra term is
+ * unobservable in practice: `supportsThinking` and `supportsInterleavedThinking`
+ * in `model-capabilities.ts` are the same expression, so no derived capability
+ * set separates them. Only an explicit caller capability override can, and then
+ * the package declines to announce a thinking beta for a request whose body
+ * will carry no thinking object.
+ */
+export function isThinkingActive(request, capabilities) {
+    const type = resolveThinkingType(thinkingRequestType(request), capabilities);
+    return ((type === "adaptive" || type === "enabled") &&
+        capabilities.interleavedThinking);
+}
 /**
  * Resolves the caller's thinking request into the object the genuine client
  * would put on the wire.
@@ -184,43 +250,75 @@ export function isThinkingDisplayActive(request, capabilities, betaPolicy) {
  * for the enabled branch — `budget_tokens` FIRST — and `{type, display}` for
  * adaptive. Serialised bodies are compared byte for byte, so the insertion
  * order below must not be rearranged.
+ *
+ * `displayOverride` is the body-side half of beta push site 12b
+ * (`thinkingDisplayOverride` from `composeBetasWithAudit`); it is not
+ * caller-facing, which is why `ThinkingDisplay` stays unwidened. When both it
+ * and a caller display are present the override wins -- a combination the
+ * composition guard makes unreachable, since site 12b requires that the caller
+ * supplied no display.
  */
-export function resolveThinking(request, normalizedId, capabilities, betaPolicy, maxTokens, profile = CLAUDE_CODE_2_1_195_PROFILE) {
+export function resolveThinking(request, normalizedId, capabilities, betaPolicy, maxTokens, profile = CLAUDE_CODE_2_1_195_PROFILE, displayOverride) {
     // Upstream `nr = n.type !== "disabled" && !CLAUDE_CODE_DISABLE_THINKING`.
     const requestActive = request !== undefined && request.type !== "disabled";
     const displayActive = isThinkingDisplayActive(request, capabilities, betaPolicy);
     const display = displayActive ? request?.display : undefined;
+    const resolvedType = resolveThinkingType(request?.type, capabilities);
     let emitted;
-    if (requestActive && capabilities.thinking) {
-        if (capabilities.adaptiveThinking) {
-            emitted = { type: "adaptive" };
-            if (display !== undefined)
-                emitted["display"] = display;
-        }
-        else {
-            // 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, profile, maxTokens).upperLimit - 1;
-            emitted = { budget_tokens: Math.min(maxTokens - 1, requested) };
-            emitted["type"] = "enabled";
-            if (display !== undefined)
-                emitted["display"] = display;
-        }
+    if (resolvedType === "adaptive") {
+        emitted = { type: "adaptive" };
+        if (display !== undefined)
+            emitted["display"] = display;
+        // Assignment, not reconstruction: an existing key keeps its position and a
+        // new one appends last, matching upstream `{...yc, display: "updates"}`.
+        if (displayOverride !== undefined)
+            emitted["display"] = displayOverride;
     }
-    else if (request?.type === "disabled" &&
-        capabilities.thinking &&
-        !capabilities.rejectsDisabledThinking) {
+    else if (resolvedType === "enabled") {
+        // Transcribed from the 2.1.280 analysis document:
+        //   let hf = mlo(_e);
+        //   if (r.type === "enabled" && r.budgetTokens !== void 0) hf = r.budgetTokens;
+        //   hf = Math.max(1024, Math.min(Rv - 1, hf));
+        // The default budget is the model's upper limit minus one. The caller's
+        // `budgetTokens` replaces it only when the caller itself declared an
+        // `enabled` request -- the guard reads the caller's raw `type`, not the
+        // resolved one, so an `adaptive` request downgraded to `enabled` on a
+        // model without adaptive thinking ignores its budget. The result is
+        // clamped to the emitted `max_tokens` minus one, and the floor of 1024 is
+        // applied after that clamp, so the floor wins when the two conflict.
+        //
+        // No older analysis document in this repository transcribes this
+        // computation at all, so the floor and the type guard are evidenced for
+        // 2.1.280 only. They are applied to every profile as one shared
+        // behaviour -- the same deliberate choice already made for the model-id
+        // normalizer ladder -- and nothing here asserts whether older clients
+        // had them.
+        //
+        // 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 callerBudget = request?.type === "enabled" ? request.budgetTokens : undefined;
+        const requested = callerBudget ??
+            modelOutputTokenLimits(normalizedId, profile, maxTokens).upperLimit - 1;
+        emitted = {
+            budget_tokens: Math.max(1024, Math.min(maxTokens - 1, requested)),
+        };
+        emitted["type"] = "enabled";
+        if (display !== undefined)
+            emitted["display"] = display;
+        // Same in-place assignment as the adaptive arm: order stays
+        // `budget_tokens, type, display`.
+        if (displayOverride !== undefined)
+            emitted["display"] = displayOverride;
+    }
+    else if (resolvedType === "disabled") {
         emitted = { type: "disabled" };
     }
     // Upstream `Jr = Xn?.type === "enabled" || Xn?.type === "adaptive"
     //             || Xn === void 0 && U4e(u)`.
+    // Upstream uses this to demote `tool_choice` of type `tool`; the
+    // request body also demotes type `any` on it, a documented divergence.
     const extendedThinkingActive = emitted?.["type"] === "enabled" ||
         emitted?.["type"] === "adaptive" ||
         (emitted === undefined && capabilities.rejectsDisabledThinking);

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":"AAAA,4CAA4C;AAO5C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAyEhF;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsCG;AACH,MAAM,UAAU,sBAAsB,CACpC,YAAoB,EACpB,UAAqC,2BAA2B,EAChE,kBAA2B;IAE3B,MAAM,QAAQ,GAAG,qBAAqB,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;IAE9D;;;;;;;;;;;;;;;;;;;;OAoBG;IACH,IACE,gBAAgB,CAAC,OAAO,CAAC,CAAC,0BAA0B;QACpD,kBAAkB,KAAK,SAAS;QAChC,MAAM,CAAC,aAAa,CAAC,kBAAkB,CAAC;QACxC,kBAAkB,IAAI,IAAI,EAC1B,CAAC;QACD,MAAM,UAAU,GAAG,kBAAkB,CAAC;QACtC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,GAAG,CAAC,QAAQ,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,UAAU,EAAE,CAAC;IACzE,CAAC;IAED,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,qBAAqB,CAC5B,YAAoB,EACpB,OAAkC;IAElC,MAAM,QAAQ,GAAG,OAAO,CAAC,eAAe,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC;IACxE,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC3B,2EAA2E;QAC3E,4CAA4C;QAC5C,OAAO,EAAE,OAAO,EAAE,QAAQ,CAAC,OAAO,EAAE,UAAU,EAAE,QAAQ,CAAC,KAAK,EAAE,CAAC;IACnE,CAAC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;OA0BG;IACH,IAAI,YAAY,KAAK,iBAAiB,EAAE,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAChD,CAAC;IACD,IAAI,YAAY,KAAK,eAAe,EAAE,CAAC;QACrC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,YAAY,KAAK,iBAAiB,EAAE,CAAC;QACvC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IACD,IAAI,YAAY,KAAK,gBAAgB,EAAE,CAAC;QACtC,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC;IAC7C,CAAC;IACD,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,UAAU,EAAE,MAAM,EAAE,CAAC;AAChD,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,MAAM,UAAU,cAAc,CAC5B,SAAiB,EACjB,YAAoB,EACpB,UAAqC,2BAA2B;IAEhE,OAAO,IAAI,CAAC,GAAG,CACb,SAAS,EACT,sBAAsB,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,OAAO,CACjE,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAAgB,EAChB,YAAoC,EACpC,UAAgC;IAEhC,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,KAAK,CAAC;IAClE,MAAM,MAAM,GAAG,OAAkC,CAAC;IAClD,IAAI,MAAM,CAAC,MAAM,CAAC,KAAK,UAAU;QAAE,OAAO,KAAK,CAAC;IAChD,MAAM,OAAO,GAAG,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,IAAI,OAAO,KAAK,YAAY,IAAI,OAAO,KAAK,SAAS;QAAE,OAAO,KAAK,CAAC;IACpE,OAAO,CACL,YAAY,CAAC,QAAQ;QACrB,YAAY,CAAC,mBAAmB;QAChC,UAAU,CAAC,wBAAwB,CACpC,CAAC;AACJ,CAAC;AAQD;;;;;;;GAOG;AACH,SAAS,mBAAmB,CAC1B,OAAgB;IAEhB,IAAI,OAAO,KAAK,IAAI,IAAI,OAAO,OAAO,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IACtE,MAAM,IAAI,GAAI,OAAmC,CAAC,MAAM,CAAC,CAAC;IAC1D,IAAI,IAAI,KAAK,SAAS,IAAI,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,UAAU,EAAE,CAAC;QACrE,OAAO,IAAI,CAAC;IACd,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,mBAAmB,CACjC,WAAgD,EAChD,YAAoC;IAEpC,MAAM,aAAa,GAAG,WAAW,KAAK,SAAS,IAAI,WAAW,KAAK,UAAU,CAAC;IAC9E,IAAI,aAAa,IAAI,YAAY,CAAC,QAAQ,EAAE,CAAC;QAC3C,OAAO,YAAY,CAAC,gBAAgB,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,SAAS,CAAC;IAChE,CAAC;IACD,IACE,WAAW,KAAK,UAAU;QAC1B,YAAY,CAAC,QAAQ;QACrB,CAAC,YAAY,CAAC,uBAAuB,EACrC,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,UAAU,gBAAgB,CAC9B,OAAgB,EAChB,YAAoC;IAEpC,MAAM,IAAI,GAAG,mBAAmB,CAAC,mBAAmB,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC,CAAC;IAC7E,OAAO,CACL,CAAC,IAAI,KAAK,UAAU,IAAI,IAAI,KAAK,SAAS,CAAC;QAC3C,YAAY,CAAC,mBAAmB,CACjC,CAAC;AACJ,CAAC;AAED;;;;;;;;;;;;;;;GAeG;AACH,MAAM,UAAU,eAAe,CAC7B,OAAoC,EACpC,YAAoB,EACpB,YAAoC,EACpC,UAAgC,EAChC,SAAiB,EACjB,UAAqC,2BAA2B,EAChE,eAA2B;IAE3B,0EAA0E;IAC1E,MAAM,aAAa,GAAG,OAAO,KAAK,SAAS,IAAI,OAAO,CAAC,IAAI,KAAK,UAAU,CAAC;IAC3E,MAAM,aAAa,GAAG,uBAAuB,CAC3C,OAAO,EACP,YAAY,EACZ,UAAU,CACX,CAAC;IACF,MAAM,OAAO,GAAG,aAAa,CAAC,CAAC,CAAC,OAAO,EAAE,OAAO,CAAC,CAAC,CAAC,SAAS,CAAC;IAE7D,MAAM,YAAY,GAAG,mBAAmB,CAAC,OAAO,EAAE,IAAI,EAAE,YAAY,CAAC,CAAC;IAEtE,IAAI,OAA4C,CAAC;IAEjD,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;QAC/B,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QACxD,2EAA2E;QAC3E,yEAAyE;QACzE,IAAI,eAAe,KAAK,SAAS;YAAE,OAAO,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC;IAC1E,CAAC;SAAM,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QACtC,kDAAkD;QAClD,sBAAsB;QACtB,gFAAgF;QAChF,+CAA+C;QAC/C,wEAAwE;QACxE,qEAAqE;QACrE,wEAAwE;QACxE,sEAAsE;QACtE,oEAAoE;QACpE,0EAA0E;QAC1E,qEAAqE;QACrE,EAAE;QACF,iEAAiE;QACjE,wEAAwE;QACxE,gEAAgE;QAChE,wEAAwE;QACxE,sEAAsE;QACtE,YAAY;QACZ,EAAE;QACF,yEAAyE;QACzE,kEAAkE;QAClE,qEAAqE;QACrE,uCAAuC;QACvC,MAAM,YAAY,GAChB,OAAO,EAAE,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,SAAS,CAAC;QACjE,MAAM,SAAS,GACb,YAAY;YACZ,sBAAsB,CAAC,YAAY,EAAE,OAAO,EAAE,SAAS,CAAC,CAAC,UAAU,GAAG,CAAC,CAAC;QAC1E,OAAO,GAAG;YACR,aAAa,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC,SAAS,GAAG,CAAC,EAAE,SAAS,CAAC,CAAC;SAClE,CAAC;QACF,OAAO,CAAC,MAAM,CAAC,GAAG,SAAS,CAAC;QAC5B,IAAI,OAAO,KAAK,SAAS;YAAE,OAAO,CAAC,SAAS,CAAC,GAAG,OAAO,CAAC;QACxD,4DAA4D;QAC5D,kCAAkC;QAClC,IAAI,eAAe,KAAK,SAAS;YAAE,OAAO,CAAC,SAAS,CAAC,GAAG,eAAe,CAAC;IAC1E,CAAC;SAAM,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QACvC,OAAO,GAAG,EAAE,IAAI,EAAE,UAAU,EAAE,CAAC;IACjC,CAAC;IAED,mEAAmE;IACnE,2CAA2C;IAC3C,iEAAiE;IACjE,uEAAuE;IACvE,MAAM,sBAAsB,GAC1B,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,SAAS;QAC/B,OAAO,EAAE,CAAC,MAAM,CAAC,KAAK,UAAU;QAChC,CAAC,OAAO,KAAK,SAAS,IAAI,YAAY,CAAC,uBAAuB,CAAC,CAAC;IAElE,OAAO,MAAM,CAAC,MAAM,CAAC;QACnB,OAAO,EAAE,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC;QACnE,aAAa;QACb,sBAAsB;KACvB,CAAC,CAAC;AACL,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tormentalabs/claude-code-wire-compat",
-  "version": "0.4.0",
+  "version": "0.6.0",
   "description": "Runtime-neutral Claude Code Messages wire compatibility primitives",
   "type": "module",
   "private": false,
@@ -37,6 +37,10 @@
     "./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"
+    },
+    "./profiles/claude-code-2.1.280": {
+      "types": "./dist/profiles/claude-code-2.1.280.d.ts",
+      "import": "./dist/profiles/claude-code-2.1.280.js"
     }
   },
   "types": "./dist/index.d.ts",
@@ -51,9 +55,8 @@
     "format:check": "prettier --check .",
     "test": "vitest run",
     "test:coverage": "vitest run --coverage",
-    "test:pack": "node scripts/verify-packed-consumers.mjs",
+    "test:pack": "npm run build && 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",
     "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"

package/src/betas.ts

@@ -11,8 +11,10 @@ import {
   supportsStructuredOutputs,
 } from "./model-capabilities.js";
 import { BETA_REGISTRY_2_1_233 } from "./profiles/beta-registry-2.1.233.js";
+import { BETA_REGISTRY_2_1_280 } from "./profiles/beta-registry-2.1.280.js";
 import { CLAUDE_CODE_2_1_195_PROFILE } from "./profiles/claude-code-2.1.195.js";
 import { CLAUDE_CODE_2_1_233_PROFILE } from "./profiles/claude-code-2.1.233.js";
+import { CLAUDE_CODE_2_1_280_PROFILE } from "./profiles/claude-code-2.1.280.js";
 
 /*
  * Provenance. The emitted order is a port of the genuine client's base beta set
@@ -41,13 +43,22 @@ interface BetaRegistryEntry {
  * The entries the push sites below require, as a structural contract rather
  * than a reference to one concrete registry.
  *
- * Registry versions have different key sets. Every key here except
- * `NARRATION_SUMMARIES` is present in all of them, so those push sites index
- * directly. `NARRATION_SUMMARIES` is optional because upstream removed it after
- * 2.1.195 (see `src/profiles/beta-registry-2.1.233.ts`): its push site survives
- * and becomes inert when the resolved registry has no entry to push. Making the
- * optionality part of the TYPE is what forces every future registry to be
- * checked against the push sites at compile time instead of at runtime.
+ * Registry versions have different key sets. Every REQUIRED key here is present
+ * in all of them, so those push sites index directly. The optional ones are
+ * optional because they exist in some registry versions and not others, and a
+ * push site whose key is absent becomes inert: it evaluates its gates, finds no
+ * entry, pushes nothing, and the surrounding order closes up with no gap.
+ * Making the optionality part of the TYPE is what forces every future registry
+ * to be checked against the push sites at compile time instead of at runtime.
+ *
+ * `NARRATION_SUMMARIES` is optional in the older direction -- upstream removed
+ * it after 2.1.195 (see `src/profiles/beta-registry-2.1.233.ts`). The keys
+ * added for 2.1.280 -- the remaining optional members declared below -- are
+ * optional in the newer direction: they are absent from the 2.1.195 registry,
+ * and all but `PER_MESSAGE_EFFORT` are absent from the 2.1.233 one. `PER_MESSAGE_EFFORT` IS declared by the 2.1.233 registry, so
+ * registry absence does not keep its site inert there; what does is the
+ * catalogue, because no 2.1.233 model declares the backing capability. The two
+ * mechanisms are not interchangeable and both are load-bearing.
  */
 export interface ComposableBetaRegistry {
   readonly CLAUDE_CODE: BetaRegistryEntry;
@@ -60,7 +71,12 @@ export interface ComposableBetaRegistry {
   readonly STRUCTURED_OUTPUTS: BetaRegistryEntry;
   readonly PROMPT_CACHING_SCOPE: BetaRegistryEntry;
   readonly MID_CONVERSATION_SYSTEM: BetaRegistryEntry;
+  readonly PER_MESSAGE_EFFORT?: BetaRegistryEntry;
+  readonly MID_CONV_TOOL_CHANGE?: BetaRegistryEntry;
+  readonly MID_CONVERSATION_SYSTEM_CLEAR_AT?: BetaRegistryEntry;
   readonly EFFORT: BetaRegistryEntry;
+  readonly THINKING_BINDING_CONTROLS?: BetaRegistryEntry;
+  readonly THINKING_DISPLAY_UPDATES?: BetaRegistryEntry;
   readonly SPEED: BetaRegistryEntry;
   readonly AFK_MODE: BetaRegistryEntry;
   readonly EXTENDED_CACHE_TTL: BetaRegistryEntry;
@@ -73,6 +89,7 @@ const PROFILE_BETA_REGISTRIES: ReadonlyMap<string, ComposableBetaRegistry> =
   new Map<string, ComposableBetaRegistry>([
     [CLAUDE_CODE_2_1_195_PROFILE.id, BETA_REGISTRY],
     [CLAUDE_CODE_2_1_233_PROFILE.id, BETA_REGISTRY_2_1_233],
+    [CLAUDE_CODE_2_1_280_PROFILE.id, BETA_REGISTRY_2_1_280],
   ]);
 
 /**
@@ -84,8 +101,17 @@ const PROFILE_BETA_REGISTRIES: ReadonlyMap<string, ComposableBetaRegistry> =
  * give `composeBetas` a second, differently-worded opinion about profile
  * validity. Standalone callers keep the 2.1.195 behaviour they had before
  * profiles were a parameter.
+ *
+ * Exported for tests only, and deliberately NOT re-exported from
+ * `src/index.ts`: the public runtime surface stays closed. That fallback is
+ * precisely why a test needs to reach this function. A profile bound to the
+ * wrong registry, or to none, silently composes against 2.1.195 instead of
+ * failing, and every required key of `ComposableBetaRegistry` currently
+ * carries an identical header in all three registries -- so a mis-binding
+ * changes no emitted byte and no behavioural suite can see it. Asking this
+ * function directly is the only way to observe the binding at all.
  */
-function resolveBetaRegistry(
+export function resolveBetaRegistry(
   profile: ClaudeCodeProtocolProfile,
 ): ComposableBetaRegistry {
   return PROFILE_BETA_REGISTRIES.get(profile.id) ?? BETA_REGISTRY;
@@ -96,6 +122,17 @@ export interface ComposeBetasInput {
   readonly normalizedId: string;
   readonly capabilities: ClaudeCodeCapabilities;
   readonly thinkingDisplayActive: boolean;
+  /**
+   * Whether a `thinking` object of type `adaptive` or `enabled` will reach the
+   * wire for this request AND the model is interleaved-thinking capable, i.e.
+   * upstream `ac` minus its `Fg()` term. Compute it with `isThinkingActive`
+   * from `./thinking.js`; never re-derive it at a call site.
+   *
+   * Required rather than optional: it is a total function of inputs every call
+   * site already holds, and requiring it is what forces a new call site to
+   * decide rather than silently inherit a default.
+   */
+  readonly thinkingActive: boolean;
   readonly cacheTtl?: "5m" | "1h" | null;
   readonly speed?: "standard" | "fast" | null;
   /**
@@ -129,6 +166,19 @@ export interface ComposeBetasInput {
 export interface ComposedBetas {
   readonly betas: readonly string[];
   readonly suppressedBetaNames: readonly string[];
+  /**
+   * Present only when push site 12b fired. This is the body-side half of a
+   * beta/body pair: the site pushes the display-updates beta AND decides that
+   * the body's `thinking` object carries `display: "updates"`. The consumer is
+   * the canonical body builder (`buildCanonicalBody`), which hands it to
+   * `resolveThinking`.
+   *
+   * `suppressBetas` cannot unset it. Suppressing the beta identifier removes
+   * the HEADER only; the body keeps `display: "updates"`. That matches the
+   * existing coupled pair where suppressing `effort-2025-11-24` leaves
+   * `output_config.effort` in the body.
+   */
+  readonly thinkingDisplayOverride?: "updates";
 }
 
 /**
@@ -240,10 +290,151 @@ export function composeBetasWithAudit(
 
   // No web-search beta: upstream pushes it only for vertex and foundry.
   if (experimental) out.push(registry.PROMPT_CACHING_SCOPE.header);
-  if (supportsMidConversationSystem(input.normalizedId, profile))
+
+  /*
+   * Upstream `jR`. The local boolean below records that this site PUSHED, which
+   * is what sites 11b and 11c gate on -- upstream reads `Ee.includes(jR)`, the
+   * composed array, not the registry. Asking the registry instead would fire
+   * those two sites for a model this one skipped.
+   */
+  const midConversationSystemFired = supportsMidConversationSystem(
+    input.normalizedId,
+    profile,
+  );
+  if (midConversationSystemFired) {
     out.push(registry.MID_CONVERSATION_SYSTEM.header);
+  }
+
+  /*
+   * Site 11a. Upstream `wRt`, which reduces to
+   * `Fg() && mD(provider) && catalogue-declares-per_turn_effort`; the provider
+   * term is first-party here by construction.
+   */
+  const perMessageEffort = registry.PER_MESSAGE_EFFORT;
+  if (
+    experimental &&
+    input.capabilities.perTurnEffort &&
+    perMessageEffort !== undefined
+  ) {
+    out.push(perMessageEffort.header);
+  }
+
+  /*
+   * Site 11b. Upstream `oQt() && Tue(model)`. `Tue` opens with
+   * `if (!Fg() || !kue(e)) return false`, so the experimental gate is upstream's
+   * and not an addition. Step 3 of `Tue` -- which sends the beta for any model
+   * with NO catalogue entry -- is deliberately not ported; see the analysis
+   * document's divergence record.
+   */
+  const midConvToolChange = registry.MID_CONV_TOOL_CHANGE;
+  if (
+    experimental &&
+    midConversationSystemFired &&
+    input.capabilities.midConvToolChange &&
+    midConvToolChange !== undefined
+  ) {
+    out.push(midConvToolChange.header);
+  }
+
+  /*
+   * Site 11c. Upstream `Mo`, which is the one site whose experimental gate is
+   * invisible at the statement level -- `Mo` names no `Fg()` at all. The gate is
+   * reached three calls deep instead: `Mee` is `oRt(model) !== "off"`, `oRt`
+   * wraps `fur`, and `fur` opens by returning `"off"` when `Fg()` is false. So
+   * `experimental` is upstream's own conjunct here exactly as it is at 11a and
+   * 11b, and a reader who checks only the `Mo` expression will wrongly conclude
+   * it was invented. It was not.
+   *
+   * `Mo`'s remaining conjuncts are constants for this package. `!l7(querySource)`
+   * holds because `l7` is true only for the two auto-mode query sources. `!Vr`
+   * holds because `Vr` is a per-session latch, and a stateless package composes
+   * every request as a first request. `Mee`'s other terms are fixed on the
+   * first-party path. What is left is `Ee.includes(jR)`, which is precisely the
+   * `midConversationSystemFired` outcome recorded at site 11.
+   */
+  const midConversationSystemClearAt =
+    registry.MID_CONVERSATION_SYSTEM_CLEAR_AT;
+  if (
+    experimental &&
+    midConversationSystemFired &&
+    midConversationSystemClearAt !== undefined
+  ) {
+    out.push(midConversationSystemClearAt.header);
+  }
+
+  // Site 12.
   if (input.capabilities.effort) out.push(registry.EFFORT.header);
 
+  /*
+   * Site 12a. Upstream `er && Fg()` with the latch write, which on the pinned
+   * first-party path collapses to thinking-active AND experimental.
+   * The coupled body field `thinking.block_binding` is NOT emitted: it needs a
+   * host override this package cannot observe.
+   */
+  const thinkingBindingControls = registry.THINKING_BINDING_CONTROLS;
+  if (
+    experimental &&
+    input.thinkingActive &&
+    thinkingBindingControls !== undefined
+  ) {
+    out.push(thinkingBindingControls.header);
+  }
+
+  /*
+   * Site 12b. Upstream guards the push with
+   * `(yc?.type === "adaptive" || yc?.type === "enabled") && ac && firstParty
+   *  && !callerSuppliedDisplay && ...` plus the simulate-proxy environment
+   * variable and a per-session latch. The reachable remainder of that guard is
+   * modelled below: `experimental` is upstream's `Fg()` term inside `ac`,
+   * `input.thinkingActive` is the thinking-type test together with the rest of
+   * `ac`, and `!input.thinkingDisplayActive` is the caller-supplied-display
+   * test. First-party is not modelled because this package only builds the
+   * first-party path, the simulate-proxy env var is not modelled because the
+   * package reads no environment, and the per-session latch is always empty in
+   * a stateless package that composes every request as a first request.
+   *
+   * The branch is additionally reached only when the display-mode resolver
+   * `Gxt` returns its connector-text result; its other results break out
+   * before the push. `!policy.thinkingSummariesShown` is that resolver's
+   * `sQt()` term, mapped onto the profile flag exactly as at the
+   * redact-thinking site above. See the 2.1.280 analysis document, §6.4, for
+   * the resolver itself.
+   *
+   * The resolver's other two diverting branches are already covered by
+   * `!thinkingDisplayActive`. A caller display of `"summarized"` takes the
+   * first branch, and `"omitted"` takes the second whenever the
+   * explicit-display flag is falsy, which is the only state this package can
+   * express -- it models no equivalent of that flag. Under a truthy
+   * explicit-display flag upstream would fall through and overwrite an
+   * explicit `"omitted"` with `"updates"`; that input is unreachable here, and
+   * is recorded rather than modelled.
+   *
+   * The site is coupled: it pushes the beta, records `display: "updates"` for
+   * the body builder, and removes the previously composed redact-thinking beta
+   * (upstream `qu()`).
+   *
+   * The splice sits INSIDE this block and is deliberately the LAST thing it
+   * does. At this point `out` holds only canonical pushes, because the caller
+   * `additionalBetas` merge runs later. So a caller who explicitly supplies
+   * `redact-thinking-2026-02-12` in `additionalBetas` still gets it, precisely
+   * because the merge's `if (!out.includes(beta))` test now succeeds. Moving
+   * the splice after the merge would silently eat that caller's entry.
+   */
+  const thinkingDisplayUpdates = registry.THINKING_DISPLAY_UPDATES;
+  let thinkingDisplayOverride: "updates" | undefined;
+  if (
+    experimental &&
+    input.thinkingActive &&
+    !policy.thinkingSummariesShown &&
+    !input.thinkingDisplayActive &&
+    thinkingDisplayUpdates !== undefined
+  ) {
+    out.push(thinkingDisplayUpdates.header);
+    thinkingDisplayOverride = "updates";
+    const redactIndex = out.indexOf(registry.REDACT_THINKING.header);
+    if (redactIndex !== -1) out.splice(redactIndex, 1);
+  }
+
   if (input.speed === "fast" && !out.includes(registry.SPEED.header)) {
     out.push(registry.SPEED.header);
   }
@@ -286,6 +477,9 @@ export function composeBetasWithAudit(
     return Object.freeze({
       betas: Object.freeze(out),
       suppressedBetaNames: NO_SUPPRESSED_BETAS,
+      ...(thinkingDisplayOverride === undefined
+        ? {}
+        : { thinkingDisplayOverride }),
     });
   }
   const suppressed = new Set(validateAdditionalBetas(input.suppressBetas));
@@ -298,5 +492,10 @@ export function composeBetasWithAudit(
   return Object.freeze({
     betas: Object.freeze(kept),
     suppressedBetaNames: Object.freeze(removed),
+    // The suppression filter above touches only the header list; the body
+    // half of the site-12b pair survives it by design.
+    ...(thinkingDisplayOverride === undefined
+      ? {}
+      : { thinkingDisplayOverride }),
   });
 }