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

package/src/build-request.ts

@@ -30,6 +30,7 @@ import {
 import { resolveModel } from "./models.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";
 import type { NormalizedRequestInput } from "./redaction.js";
 import { buildRedactedEvidence, toSafeErrorDetails } from "./redaction.js";
 import {
@@ -38,7 +39,7 @@ import {
 } from "./request-body.js";
 import { sha256Hex } from "./sha256.js";
 import { buildCanonicalSystem, IDENTITY_TEXT } from "./system-prompt.js";
-import { isThinkingDisplayActive } from "./thinking.js";
+import { isThinkingActive, isThinkingDisplayActive } from "./thinking.js";
 import { classifySurrogateAt } from "./unicode.js";
 
 const METHOD = "POST";
@@ -152,6 +153,8 @@ const CAPABILITY_KEYS = [
   "contextManagement",
   "temperature",
   "rejectsDisabledThinking",
+  "midConvToolChange",
+  "perTurnEffort",
 ] as const;
 const CAPABILITY_KEY_SET = new Set(CAPABILITY_KEYS);
 /** Adds the optional package-extension override keys carried by evidence. */
@@ -319,10 +322,14 @@ function containsString(value: unknown, target: string): boolean {
 }
 
 /**
- * The profiles this package will assemble a request for. Two entries: the
- * 2.1.195 default and the 2.1.233 profile, which callers must pass
- * explicitly. Admitting a profile is exactly this list -- `validateProfile`
- * did not change to accept the second one.
+ * Every pinned profile singleton, and nothing else. The set is not enumerated
+ * in prose here: the literal below IS the enumeration and cannot go stale,
+ * whereas a count in a comment goes stale on the next port -- which is exactly
+ * what happened to the text this replaced. Which profile a caller gets when it
+ * passes none is `DEFAULT_PROFILE` below and is deliberately not restated
+ * here, so that a default switch touches one line rather than two. Admitting a
+ * profile is exactly this list -- `validateProfile` never changed to accept a
+ * new one.
  *
  * Membership is by REFERENCE, deliberately. A structural check would accept a
  * caller-built object that merely looks like a pinned profile, and every wire
@@ -339,11 +346,16 @@ function containsString(value: unknown, target: string): boolean {
 const ACCEPTED_PROFILES: ReadonlySet<ClaudeCodeProtocolProfile> = new Set([
   CLAUDE_CODE_2_1_195_PROFILE,
   CLAUDE_CODE_2_1_233_PROFILE,
+  CLAUDE_CODE_2_1_280_PROFILE,
 ]);
 
 /**
- * The profile every public entry point resolves to when the caller supplies
- * none. Declared once so that the default is a single, greppable seam: a test
+ * The profile the request-building entry points (`buildClaudeCodeRequest`,
+ * `buildClaudeCodeCountTokensRequest` and `parseBuiltClaudeCodeRequest`)
+ * resolve to when the caller supplies none. It is not a global default: the
+ * model-query and anti-verbosity helpers deliberately keep their own,
+ * separately declared default and are NOT governed by this constant. Declared
+ * once so that the default is a single, greppable seam: a test
  * that means "whatever the default is" reads THIS instead of naming a
  * version, which keeps a default switch to a one-line diff and keeps tests
  * that genuinely mean 2.1.195 honest about saying so.
@@ -352,7 +364,7 @@ const ACCEPTED_PROFILES: ReadonlySet<ClaudeCodeProtocolProfile> = new Set([
  * from `src/index.ts`: the public runtime surface stays closed.
  */
 export const DEFAULT_PROFILE: ClaudeCodeProtocolProfile =
-  CLAUDE_CODE_2_1_233_PROFILE;
+  CLAUDE_CODE_2_1_280_PROFILE;
 
 function validateProfile(
   profile: ClaudeCodeProtocolProfile,
@@ -950,6 +962,8 @@ function requestedCapabilities(
     temperature: raw?.temperature ?? supported.temperature,
     rejectsDisabledThinking:
       raw?.rejectsDisabledThinking ?? supported.rejectsDisabledThinking,
+    midConvToolChange: raw?.midConvToolChange ?? supported.midConvToolChange,
+    perTurnEffort: raw?.perTurnEffort ?? supported.perTurnEffort,
   };
   for (const key of CAPABILITY_KEYS) {
     if (typeof result[key] !== "boolean") fail("UNSUPPORTED_CAPABILITY");
@@ -1038,7 +1052,7 @@ function parseCapabilityDecisions(
   value: unknown,
 ): ClaudeCodeCapabilityDecisions {
   if (!isRecord(value)) fail();
-  // The nine capability keys are mandatory; the package-extension override keys
+  // Every capability key is mandatory; the package-extension override keys
   // are optional and must survive the round-trip untouched, so they are allowed
   // here but never synthesized.
   assertExactKeys(value, CAPABILITY_DECISION_KEY_SET);
@@ -1064,6 +1078,8 @@ function parseCapabilityDecisions(
     contextManagement: readBoolean("contextManagement"),
     temperature: readBoolean("temperature"),
     rejectsDisabledThinking: readBoolean("rejectsDisabledThinking"),
+    midConvToolChange: readBoolean("midConvToolChange"),
+    perTurnEffort: readBoolean("perTurnEffort"),
   };
 }
 
@@ -1071,7 +1087,7 @@ function parseCapabilityDecisions(
  * Validates evidence against the profile the request was parsed under, not
  * against a hardcoded singleton. `parseBuiltClaudeCodeRequest` already
  * validates `url` against `pinnedProfile.endpoint`; the profile id is the one
- * remaining field where the two pinned profiles differ, so it has to follow
+ * remaining field where pinned profiles differ, so it has to follow
  * the same source or a request built with a non-default profile could never
  * be re-parsed. Still fail-closed: the profile reaching here has already
  * passed `validateProfile`.
@@ -1442,6 +1458,10 @@ export async function buildClaudeCodeCountTokensRequest(
           normalizedId: resolvedModel.id,
           capabilities: resolvedModel.capabilities,
           thinkingDisplayActive: false,
+          // A constant, not a re-derivation: this path carries no thinking
+          // request, so `isThinkingActive(undefined, capabilities)` is false
+          // by construction.
+          thinkingActive: false,
         },
         effectiveProfile,
       ),
@@ -1516,8 +1536,9 @@ export async function buildClaudeCodeCountTokensRequest(
 /**
  * Builds one canonical request for the pinned Claude Code wire profile.
  *
- * @param profile - The only accepted value is the exported
- * `CLAUDE_CODE_2_1_195_PROFILE` singleton. Any other object, even a
+ * @param profile - The accepted values are the exported pinned profile
+ * singletons held in `ACCEPTED_PROFILES`; omitting the argument resolves to
+ * `DEFAULT_PROFILE`. Any other object, even a
  * structurally identical clone, is rejected with `ClaudeCodeWireError` code
  * `INVALID_INPUT`. This deliberate fail-closed behaviour prevents callers from
  * substituting an unpinned protocol profile.
@@ -1581,13 +1602,12 @@ export async function buildClaudeCodeRequest(
       validated.suppressBillingBlock,
       validated.suppressIdentityBlock,
     );
-    const canonicalBody = buildCanonicalBody(
-      evidenceRequest(validated.source, validated.source.model),
-      effectiveModel,
-      system,
-      metadata,
-      effectiveProfile,
-    );
+    /*
+     * Composition runs BEFORE body construction so that a beta site can hand a
+     * decision to the body emitter. Both calls are pure and neither feeds the
+     * other's arguments today, so the order itself changes no serialised byte;
+     * the swap lands on its own so the packed-consumer digests prove that.
+     */
     const composedBetas = composeBetasWithAudit(
       {
         rawModel: validated.source.model,
@@ -1598,6 +1618,10 @@ export async function buildClaudeCodeRequest(
           capabilities,
           effectiveProfile.betaPolicy,
         ),
+        thinkingActive: isThinkingActive(
+          validated.source.thinking,
+          capabilities,
+        ),
         ...(validated.source.cacheControl?.ttl === undefined
           ? {}
           : { cacheTtl: validated.source.cacheControl.ttl }),
@@ -1616,6 +1640,14 @@ export async function buildClaudeCodeRequest(
       },
       effectiveProfile,
     );
+    const canonicalBody = buildCanonicalBody(
+      evidenceRequest(validated.source, validated.source.model),
+      effectiveModel,
+      system,
+      metadata,
+      effectiveProfile,
+      composedBetas.thinkingDisplayOverride,
+    );
     const betas = composedBetas.betas;
     const headerPlan = buildOrderedHeaderPlan({
       accessToken: validated.source.accessToken,
@@ -1706,8 +1738,9 @@ export async function buildClaudeCodeRequest(
 /**
  * Validates and clones a previously built request into a deeply frozen value.
  *
- * @param profile - The only accepted value is the exported
- * `CLAUDE_CODE_2_1_195_PROFILE` singleton. Any other object, even a
+ * @param profile - The accepted values are the exported pinned profile
+ * singletons held in `ACCEPTED_PROFILES`; omitting the argument resolves to
+ * `DEFAULT_PROFILE`. Any other object, even a
  * structurally identical clone, is rejected with `ClaudeCodeWireError` code
  * `INVALID_INPUT`. This deliberate fail-closed behaviour prevents callers from
  * substituting an unpinned protocol profile.

package/src/contracts.ts

@@ -669,6 +669,10 @@ export interface ClaudeCodeCapabilities {
   readonly contextManagement: boolean;
   readonly temperature: boolean;
   readonly rejectsDisabledThinking: boolean;
+  /** Catalogue string `mid_conv_tool_change`. */
+  readonly midConvToolChange: boolean;
+  /** Catalogue string `per_turn_effort`. */
+  readonly perTurnEffort: boolean;
 }
 
 /** Host-state beta gates pinned for a default first-party environment. */
@@ -1221,8 +1225,9 @@ export interface RedactedRequestEvidence {
 }
 
 /**
- * Records the nine model capability decisions, plus any package-extension beta
- * override the caller supplied.
+ * Records every model capability decision -- the key set is exactly
+ * `keyof ClaudeCodeCapabilities`, so it widens whenever that interface does --
+ * plus any package-extension beta override the caller supplied.
  *
  * The override keys are OPTIONAL and are emitted only when the corresponding
  * member of `betaOverrides` is present, so evidence for a request that omits

package/src/fingerprint.ts

@@ -56,6 +56,11 @@ export async function createBillingFingerprint(
   crypto?: Pick<Crypto, "subtle">,
 ): Promise<string> {
   const cryptoProvider = crypto ?? getDefaultCrypto();
+  // The upstream transcription in the analysis doc writes `||` here; `??` is a
+  // deliberate, safe difference, not a divergence to "fix" in either
+  // direction. A string subscript yields either a one-unit string, which is
+  // always truthy, or `undefined`, so no value makes the two operators
+  // disagree (and no test can tell them apart).
   const material = `${FINGERPRINT_PREFIX}${firstUserText[4] ?? "0"}${firstUserText[7] ?? "0"}${firstUserText[20] ?? "0"}${cliVersion}`;
   const bytes = new TextEncoder().encode(material);
 

package/src/headers.ts

@@ -8,6 +8,7 @@ import type {
 import { ClaudeCodeWireError } from "./contracts.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";
 
 const HEADER_NAMES = Object.freeze({
   anthropicBeta: "anthropic-beta",
@@ -163,13 +164,14 @@ function parseExtraHeaderPolicy(value: unknown): ClaudeCodeExtraHeaderPolicy {
 
 /**
  * Accepts a pinned profile by REFERENCE, never by shape, and returns the
- * singleton itself so nothing downstream can be handed a look-alike. Adding
- * the second pinned profile widens the accepted set by exactly one object;
+ * singleton itself so nothing downstream can be handed a look-alike. Each
+ * pinned profile widens the accepted set by exactly one object;
  * anything else, including a structural clone, still fails closed.
  */
 function parseProfile(value: unknown): ClaudeCodeProtocolProfile {
   if (value === CLAUDE_CODE_2_1_195_PROFILE) return CLAUDE_CODE_2_1_195_PROFILE;
   if (value === CLAUDE_CODE_2_1_233_PROFILE) return CLAUDE_CODE_2_1_233_PROFILE;
+  if (value === CLAUDE_CODE_2_1_280_PROFILE) return CLAUDE_CODE_2_1_280_PROFILE;
   throw new ClaudeCodeWireError("INVALID_INPUT");
 }
 

package/src/index.ts

@@ -3,9 +3,10 @@
 /**
  * Public entry point for the Claude Code wire compatibility package.
  *
- * Only the surfaces listed below are public. The Wave 2 implementation
- * Internal protocol modules remain private; only the documented builder and
- * parser are exported here.
+ * Only the surfaces listed below are public. Internal protocol modules remain
+ * private; the documented builder, parser, anti-verbosity helpers, read-only
+ * model queries and the transcribed beta registries are exported here, and
+ * nothing else.
  *
  * Importing this module has no side effects. It reads no environment, opens
  * no network connection, touches no clock or random source, and holds no
@@ -53,11 +54,35 @@ export {
   selectAntiVerbositySection,
 } from "./anti-verbosity.js";
 
+export { BETA_REGISTRY } from "./beta-registry.js";
+
 export {
   buildClaudeCodeCountTokensRequest,
   buildClaudeCodeRequest,
   parseBuiltClaudeCodeRequest,
 } from "./build-request.js";
 
+export { TOKEN_COUNTING_BETA } from "./count-tokens.js";
+
+export {
+  hasOneMillionContext,
+  isAdaptiveThinkingModel,
+  isClaude3Model,
+  isEligibleFor1MContext,
+  isFable5Model,
+  isHaikuModel,
+  isMythos5Model,
+  isOpus46Model,
+  isOpus47Model,
+  isOpus48Model,
+  isSonnet46Model,
+  modelCapability,
+  supportsStructuredOutputs,
+  supportsWebSearch,
+} from "./model-queries.js";
+
+export { BETA_REGISTRY_2_1_233 } from "./profiles/beta-registry-2.1.233.js";
+export { BETA_REGISTRY_2_1_280 } from "./profiles/beta-registry-2.1.280.js";
 export { CLAUDE_CODE_2_1_195_PROFILE } from "./profiles/claude-code-2.1.195.js";
 export { CLAUDE_CODE_2_1_233_PROFILE } from "./profiles/claude-code-2.1.233.js";
+export { CLAUDE_CODE_2_1_280_PROFILE } from "./profiles/claude-code-2.1.280.js";

package/src/model-capabilities.ts

@@ -9,20 +9,20 @@ import { profileBehaviors } from "./profile-behaviors.js";
 import { CLAUDE_CODE_2_1_195_PROFILE } from "./profiles/claude-code-2.1.195.js";
 
 /*
- * Capability derivation, ported from the genuine client's nine capability
- * predicates.
+ * Capability derivation, ported from the genuine client's capability
+ * predicates and, since 2.1.280, from catalogue strings that have no predicate
+ * upstream at all.
  *
  * READ THIS FIRST -- there are two derivation paths and they are not
  * interchangeable:
  *
  *   1. Catalogue path (`deriveCapabilitiesFromCatalogue`), taken for every id
- *      present in the 2.1.195 catalogue. Six of the nine capabilities have a
- *      verbatim upstream string in `ClaudeCodeCatalogueEntry.capabilities`
- *      (`effort`, `max_effort`, `xhigh_effort`, `adaptive_thinking`,
- *      `context_management`, `rejects_disabled_thinking`) and are read from
- *      there. The other three (`thinking`, `interleavedThinking`,
- *      `temperature`) have NO catalogue string in any client version and stay
- *      predicate-derived.
+ *      present in the catalogue. The fields listed in
+ *      `CATALOGUE_BACKED_CAPABILITIES` have a verbatim upstream string in
+ *      `ClaudeCodeCatalogueEntry.capabilities` and are read from there; that
+ *      map is the enumeration, so this comment does not repeat it. The rest
+ *      (`thinking`, `interleavedThinking`, `temperature`) have NO catalogue
+ *      string in any client version and stay predicate-derived.
  *   2. Predicate fallback (`deriveCapabilitiesFromPredicates`), taken for ids
  *      with no catalogue entry -- `claude-mythos-5` (absent by product
  *      decision D-1), ids from a newer client, and anything that escaped
@@ -39,7 +39,7 @@ import { CLAUDE_CODE_2_1_195_PROFILE } from "./profiles/claude-code-2.1.195.js";
  * surprising:
  *
  *   On the first-party provider -- the only provider this package targets --
- *   every one of these nine predicates reduces to a pure function of the
+ *   every one of these predicates reduces to a pure function of the
  *   normalized model id.
  *
  * Why. Upstream, each predicate has the shape
@@ -87,7 +87,7 @@ import { CLAUDE_CODE_2_1_195_PROFILE } from "./profiles/claude-code-2.1.195.js";
  * `claude-mythos-5` has no catalogue entry by product decision D-1. Upstream
  * special-cases it by name in `Kw`, `Hke`, `Yte` and `Uot`; this port subsumes
  * those clauses into the first-party fallback, which yields an identical
- * result. The explicit D-1 test asserting its full nine-boolean row is the
+ * result. The explicit D-1 test asserting its full capability row is the
  * guard for that equivalence.
  *
  * Model ids reaching these functions have already been normalized by
@@ -337,11 +337,19 @@ export function rejectsDisabledThinking(normalizedId: string): boolean {
 }
 
 /**
- * The six `ClaudeCodeCapabilities` fields the catalogue represents, paired
- * with their verbatim upstream capability string. The three omitted fields --
- * `thinking`, `interleavedThinking`, `temperature` -- have no catalogue
- * string in any client version and are derived from their predicates on both
- * paths.
+ * The `ClaudeCodeCapabilities` fields the catalogue represents, paired with
+ * their verbatim upstream capability string. Whatever is not a key here --
+ * `thinking`, `interleavedThinking` and `temperature` today -- has no
+ * catalogue string in any client version and is derived from its predicate on
+ * both paths. The literal below is the enumeration; no count is restated in
+ * prose, because a count beside the thing it counts goes stale on the next
+ * port.
+ *
+ * `per_turn_timing` is deliberately NOT mapped. It is a real 2.1.280
+ * catalogue string carried by three models, but the beta it would gate,
+ * `timing-2026-09-09`, is environment-gated off on the default path, so a
+ * field here would be a capability nothing reads. Mapping it would invent a
+ * derived value with no emission behind it.
  */
 const CATALOGUE_BACKED_CAPABILITIES = {
   effort: "effort",
@@ -350,12 +358,14 @@ const CATALOGUE_BACKED_CAPABILITIES = {
   adaptiveThinking: "adaptive_thinking",
   contextManagement: "context_management",
   rejectsDisabledThinking: "rejects_disabled_thinking",
+  midConvToolChange: "mid_conv_tool_change",
+  perTurnEffort: "per_turn_effort",
 } as const;
 
 /**
- * Pure catalogue -> capabilities mapping. Reads nothing but `entry` for the
- * six catalogue-backed fields; `normalizedId` is used only for the three
- * fields the catalogue does not represent.
+ * Pure catalogue -> capabilities mapping. Reads nothing but `entry` for every
+ * catalogue-backed field; `normalizedId` is used only for the fields the
+ * catalogue does not represent.
  *
  * This function applies no exceptions and no id special cases. The one cell
  * where the 2.1.195 catalogue disagrees with the wire is corrected by the
@@ -381,6 +391,8 @@ export function deriveCapabilitiesFromCatalogue(
     rejectsDisabledThinking: has(
       CATALOGUE_BACKED_CAPABILITIES.rejectsDisabledThinking,
     ),
+    midConvToolChange: has(CATALOGUE_BACKED_CAPABILITIES.midConvToolChange),
+    perTurnEffort: has(CATALOGUE_BACKED_CAPABILITIES.perTurnEffort),
   });
 }
 
@@ -408,6 +420,30 @@ function deriveCapabilitiesFromPredicates(
     contextManagement: supportsContextManagement(normalizedId),
     temperature: supportsTemperature(normalizedId),
     rejectsDisabledThinking: rejectsDisabledThinking(normalizedId),
+    /*
+     * Both are FALSE here, and this is the one place where the two derivation
+     * paths stop agreeing in kind: the six older catalogue-backed fields above
+     * resolve maximally permissive for an uncatalogued id, these two resolve
+     * restrictive. That asymmetry is deliberate, and the reason differs per
+     * field.
+     *
+     * `perTurnEffort: false` MATCHES upstream. Its lookup consults the static
+     * catalogue and, at default settings, the remote client-data path that
+     * could override it is empty, so an id with no entry yields false there
+     * too.
+     *
+     * `midConvToolChange: false` DIVERGES from upstream, which still sends
+     * `mid-conversation-tool-changes-2026-07-01` for a model it has no
+     * catalogue entry for. The analysis document records that as a divergence
+     * recorded but not ported, for the same reason the package declines the
+     * neighbouring permissive tail: a capability granted to an unknown id is a
+     * guess about a model this package knows nothing about.
+     *
+     * Neither field has an upstream predicate to fall back on -- both exist
+     * only as catalogue strings -- so there is no third option here.
+     */
+    midConvToolChange: false,
+    perTurnEffort: false,
   });
 }
 

package/src/model-identity.ts

@@ -7,17 +7,44 @@ export function stripModelMarkers(model: string): string {
   return model.replace(/\[(1|2)m\]/gi, "");
 }
 
-/** Ports upstream `$_` (binary offset 226639025). */
+/**
+ * Rewrites dotted version separators to the hyphenated form upstream uses on
+ * the wire (`claude-opus-4.7` -> `claude-opus-4-7`). Only a digit-dot-digit
+ * run is rewritten, so ids with no dotted version (`gpt-4o`, `""`) and
+ * unrelated dots are left byte-identical.
+ *
+ * The plugin performs the same rewrite at its wire seam
+ * (`lib/mimicry/wire-compat.mjs`); the plugin's own family predicates accept
+ * `[._-]` interchangeably, so this keeps package classification in parity.
+ */
+function dottedToDashedVersion(model: string): string {
+  return model.replace(/(\d)\.(\d)/g, "$1-$2");
+}
+
+/**
+ * Ports upstream `$_` (binary offset 226639025); in the 2.1.280 bundle the
+ * function is `GF` at byte offset 7413751. The two offsets are in different
+ * address spaces: the first indexes the 2.1.195 platform binary, the second
+ * the carved 2.1.280 JavaScript bundle, so neither can be found in the other.
+ *
+ * Rung order is load-bearing: each test is a substring test, so a longer id
+ * must precede the shorter id it contains or the shorter rung swallows it.
+ */
 export function normalizeModelId(model: string): string {
-  model = model.toLowerCase();
+  model = dottedToDashedVersion(model.toLowerCase());
+  if (model.includes("claude-fable-5-1")) return "claude-fable-5-1";
   if (model.includes("claude-fable-5")) return "claude-fable-5";
+  if (model.includes("claude-mythos-5-1")) return "claude-mythos-5-1";
   if (model.includes("claude-mythos-5")) return "claude-mythos-5";
+  if (model.includes("claude-opus-5-5")) return "claude-opus-5-5";
+  if (model.includes("claude-opus-5")) return "claude-opus-5";
   if (model.includes("claude-opus-4-8")) return "claude-opus-4-8";
   if (model.includes("claude-opus-4-7")) return "claude-opus-4-7";
   if (model.includes("claude-opus-4-6")) return "claude-opus-4-6";
   if (model.includes("claude-opus-4-5")) return "claude-opus-4-5";
   if (model.includes("claude-opus-4-1")) return "claude-opus-4-1";
   if (/claude-opus-4(?!-\d(?!\d))/.test(model)) return "claude-opus-4-0";
+  if (model.includes("claude-sonnet-5")) return "claude-sonnet-5";
   if (model.includes("claude-sonnet-4-6")) return "claude-sonnet-4-6";
   if (model.includes("claude-sonnet-4-5")) return "claude-sonnet-4-5";
   if (/claude-sonnet-4(?!-\d(?!\d))/.test(model)) return "claude-sonnet-4-0";