@tormentalabs/claude-code-wire-compat 0.3.0 → 0.5.0

package/dist/model-identity.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"model-identity.d.ts","sourceRoot":"","sources":["../src/model-identity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAOzE"}
+{"version":3,"file":"model-identity.d.ts","sourceRoot":"","sources":["../src/model-identity.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,gBAAgB,CAAC;AAE5D,qDAAqD;AACrD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAEvD;AAgBD,qDAAqD;AACrD,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAqBtD;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,YAAY,EAAE,MAAM,GAAG,qBAAqB,CAOzE"}

package/dist/model-identity.js

@@ -3,9 +3,22 @@
 export function stripModelMarkers(model) {
     return model.replace(/\[(1|2)m\]/gi, "");
 }
+/**
+ * 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) {
+    return model.replace(/(\d)\.(\d)/g, "$1-$2");
+}
 /** Ports upstream `$_` (binary offset 226639025). */
 export function normalizeModelId(model) {
-    model = model.toLowerCase();
+    model = dottedToDashedVersion(model.toLowerCase());
     if (model.includes("claude-fable-5"))
         return "claude-fable-5";
     if (model.includes("claude-mythos-5"))

package/dist/model-identity.js.map

@@ -1 +1 @@
-{"version":3,"file":"model-identity.js","sourceRoot":"","sources":["../src/model-identity.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAI5C,qDAAqD;AACrD,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAC5B,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC9D,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACvE,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACpE,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACpE,IAAI,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAC3E,IAAI,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAClE,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACpE,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACpE,IAAI,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAClE,IAAI,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO,eAAe,CAAC;IAC5D,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC9D,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,YAAoB;IAChD,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACnD,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACrD,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACnD,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACrD,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC"}
+{"version":3,"file":"model-identity.js","sourceRoot":"","sources":["../src/model-identity.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAI5C,qDAAqD;AACrD,MAAM,UAAU,iBAAiB,CAAC,KAAa;IAC7C,OAAO,KAAK,CAAC,OAAO,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED;;;;;;;;;GASG;AACH,SAAS,qBAAqB,CAAC,KAAa;IAC1C,OAAO,KAAK,CAAC,OAAO,CAAC,aAAa,EAAE,OAAO,CAAC,CAAC;AAC/C,CAAC;AAED,qDAAqD;AACrD,MAAM,UAAU,gBAAgB,CAAC,KAAa;IAC5C,KAAK,GAAG,qBAAqB,CAAC,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC;IACnD,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC9D,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,4BAA4B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,iBAAiB,CAAC;IACvE,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACpE,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACpE,IAAI,8BAA8B,CAAC,IAAI,CAAC,KAAK,CAAC;QAAE,OAAO,mBAAmB,CAAC;IAC3E,IAAI,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAClE,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACpE,IAAI,KAAK,CAAC,QAAQ,CAAC,mBAAmB,CAAC;QAAE,OAAO,mBAAmB,CAAC;IACpE,IAAI,KAAK,CAAC,QAAQ,CAAC,kBAAkB,CAAC;QAAE,OAAO,kBAAkB,CAAC;IAClE,IAAI,KAAK,CAAC,QAAQ,CAAC,eAAe,CAAC;QAAE,OAAO,eAAe,CAAC;IAC5D,IAAI,KAAK,CAAC,QAAQ,CAAC,iBAAiB,CAAC;QAAE,OAAO,iBAAiB,CAAC;IAChE,IAAI,KAAK,CAAC,QAAQ,CAAC,gBAAgB,CAAC;QAAE,OAAO,gBAAgB,CAAC;IAC9D,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;AACtC,CAAC;AAED;;;GAGG;AACH,MAAM,UAAU,aAAa,CAAC,YAAoB;IAChD,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACnD,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACrD,IAAI,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC;QAAE,OAAO,OAAO,CAAC;IACnD,IAAI,YAAY,CAAC,QAAQ,CAAC,QAAQ,CAAC;QAAE,OAAO,QAAQ,CAAC;IACrD,IAAI,YAAY,CAAC,QAAQ,CAAC,MAAM,CAAC;QAAE,OAAO,MAAM,CAAC;IACjD,OAAO,SAAS,CAAC;AACnB,CAAC"}

package/dist/model-queries.d.ts

@@ -0,0 +1,77 @@
+import type { ClaudeCodeProtocolProfile } from "./contracts.js";
+/**
+ * Whether the active profile's catalogue records `capability` for `model`.
+ *
+ * `capability` is a verbatim upstream capability string. Ids the profile does
+ * not catalogue answer `false` for every capability: the catalogue is the only
+ * evidence this query consults, and absence of evidence is reported as
+ * absence. Callers wanting the derived nine-boolean view -- which falls back
+ * to the ported predicates for uncatalogued ids -- want `resolveModel`.
+ */
+export declare function modelCapability(model: string, capability: string, profile?: ClaudeCodeProtocolProfile): boolean;
+/** Whether `model` normalizes to `claude-opus-4-6`. */
+export declare function isOpus46Model(model: string): boolean;
+/** Whether `model` normalizes to `claude-opus-4-7`. */
+export declare function isOpus47Model(model: string): boolean;
+/** Whether `model` normalizes to `claude-opus-4-8`. */
+export declare function isOpus48Model(model: string): boolean;
+/** Whether `model` normalizes to `claude-sonnet-4-6`. */
+export declare function isSonnet46Model(model: string): boolean;
+/** Whether `model` normalizes to `claude-fable-5`. */
+export declare function isFable5Model(model: string): boolean;
+/** Whether `model` normalizes to `claude-mythos-5`. */
+export declare function isMythos5Model(model: string): boolean;
+/**
+ * Whether `model` belongs to the haiku family.
+ *
+ * Reuses `modelFamilyOf`, the package's one family classifier, so a new haiku
+ * id is classified in exactly one place.
+ */
+export declare function isHaikuModel(model: string): boolean;
+/**
+ * Whether `model` is a Claude 3 generation id.
+ *
+ * The `claude-3-` substring test is the same one the ported capability
+ * predicates open with (`model-capabilities.ts`), applied to the normalized
+ * id, so a Claude 3 id spelled with a dotted version (`claude-3.5-sonnet`)
+ * classifies with its hyphenated spelling.
+ */
+export declare function isClaude3Model(model: string): boolean;
+/**
+ * Whether `model` may receive the 1M-context beta.
+ *
+ * Three sources, in order: an explicit 1M marker in the id, the active
+ * profile's `context.supports1mBeta`, and -- for ids the profile does not
+ * catalogue -- the ported family set (`claude-sonnet-4*`, Opus 4.6/4.7/4.8).
+ */
+export declare function isEligibleFor1MContext(model: string, profile?: ClaudeCodeProtocolProfile): boolean;
+/**
+ * Whether `model` names 1M context explicitly and therefore always uses it.
+ *
+ * Marker-only by design. The catalogue's `context.native1m` is a DIFFERENT
+ * question -- the model's native window -- and consulting it here would make
+ * every natively-1M id answer true, which is not what a static "always send
+ * 1M" gate means. Use `modelContextWindow`-shaped catalogue reads for that.
+ */
+export declare function hasOneMillionContext(model: string): boolean;
+/**
+ * Whether `model` supports the structured-outputs beta.
+ *
+ * Delegates to the predicate ported from the genuine client (`j4e`), which is
+ * narrower and better evidenced than a family-shaped heuristic.
+ */
+export declare function supportsStructuredOutputs(model: string): boolean;
+/** Whether `model` supports the web-search tool. */
+export declare function supportsWebSearch(model: string): boolean;
+/**
+ * Whether `model` uses adaptive thinking (`{type: "adaptive"}`) instead of a
+ * manual `budget_tokens`.
+ *
+ * The union of the named family predicates, not a catalogue read: this gates
+ * the shape of the emitted `thinking` block, and an uncatalogued id must not
+ * inherit adaptive thinking from the permissive capability fallback. Ask
+ * `modelCapability(model, "adaptive_thinking", profile)` for the catalogue's
+ * answer.
+ */
+export declare function isAdaptiveThinkingModel(model: string): boolean;
+//# sourceMappingURL=model-queries.d.ts.map

package/dist/model-queries.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"model-queries.d.ts","sourceRoot":"","sources":["../src/model-queries.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,gBAAgB,CAAC;AA4EhE;;;;;;;;GAQG;AACH,wBAAgB,eAAe,CAC7B,KAAK,EAAE,MAAM,EACb,UAAU,EAAE,MAAM,EAClB,OAAO,GAAE,yBAAuD,GAC/D,OAAO,CAcT;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,uDAAuD;AACvD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,yDAAyD;AACzD,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEtD;AAED,sDAAsD;AACtD,wBAAgB,aAAa,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAEpD;AAED,uDAAuD;AACvD,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGnD;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAErD;AAED;;;;;;GAMG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,MAAM,EACb,OAAO,GAAE,yBAAuD,GAC/D,OAAO,CAkBT;AAED;;;;;;;GAOG;AACH,wBAAgB,oBAAoB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAE3D;AAED;;;;;GAKG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAGhE;AAED,oDAAoD;AACpD,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAKxD;AAED;;;;;;;;;GASG;AACH,wBAAgB,uBAAuB,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAS9D"}

package/dist/model-queries.js

@@ -0,0 +1,205 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+import { supportsStructuredOutputs as portedStructuredOutputs } from "./model-capabilities.js";
+import { modelFamilyOf, normalizeModelId } from "./model-identity.js";
+import { CLAUDE_CODE_2_1_195_PROFILE } from "./profiles/claude-code-2.1.195.js";
+/*
+ * Read-only model queries.
+ *
+ * DESIGN DECISION (Phase 1.1). Two surfaces, deliberately separate:
+ *
+ *   1. `modelCapability(model, capability, profile)` -- the GENERIC query. The
+ *      catalogue is the source of truth: it normalizes the id, looks the entry
+ *      up in `profile.supportedModels` and asks whether the verbatim upstream
+ *      capability string is present. It invents nothing, maps nothing, and
+ *      therefore answers for capability strings this package does not model as
+ *      a `ClaudeCodeCapabilities` field (`fast_mode`, `lean_prompt`,
+ *      `fable_5_mitigations`, `mid_conv_system`, ...) as readily as for the
+ *      six that it does.
+ *
+ *   2. The NAMED family/version predicates below -- `isOpus47Model` and
+ *      friends. A family is not a catalogue capability; it is an identity
+ *      question. They are therefore written over `normalizeModelId` and
+ *      `modelFamilyOf`, NOT over a new family regex and NOT over the
+ *      catalogue. Consequence, and it is intended: an id normalizing to
+ *      `claude-opus-4-7` answers `isOpus47Model` true whether or not the
+ *      active profile catalogues it.
+ *
+ * Do not fold (2) into (1). Asking `modelCapability(model, "adaptive_thinking")`
+ * and asking `isAdaptiveThinkingModel(model)` are different questions with
+ * different answers for ids the active profile does not catalogue, and both
+ * questions have callers.
+ *
+ * INVALID INPUT. Every predicate here returns `false` for a non-string or an
+ * empty id rather than throwing. This departs from `resolveModel`
+ * (`ClaudeCodeWireError("INVALID_INPUT")`) on purpose: these are predicates,
+ * their upstream counterparts are total functions returning `false` on a
+ * falsy model, and a predicate that throws cannot be used in the boolean
+ * position its callers put it in.
+ *
+ * RUNTIME NEUTRALITY. No builtins, no clock, no randomness, no I/O.
+ */
+/** Lowercased + dotted-to-dashed id, or `null` for input no predicate can answer for. */
+function normalizedOrNull(model) {
+    if (typeof model !== "string" || model.length === 0) {
+        return null;
+    }
+    return normalizeModelId(model);
+}
+/**
+ * Explicit 1M markers a caller can spell into the model id.
+ *
+ * `\[1m\]` is deliberately absent: it marks a request-time context selection,
+ * not an always-1M id, and the upstream marker check does not accept it.
+ */
+const ONE_MILLION_MARKER_RE = /(^|[-_ ])1m($|[-_ ])|context[-_]?1m/iu;
+/** As `ONE_MILLION_MARKER_RE`, plus the bracketed request-time marker. */
+const ONE_MILLION_ELIGIBLE_MARKER_RE = /(^|[-_ ])1m($|[-_ ])|context[-_]?1m|\[1m\]/iu;
+/**
+ * Vendor tokens the upstream web-search gate accepts. Transcribed as a token
+ * list rather than a regex so it stays a data question, not a pattern-matching
+ * one.
+ */
+const WEB_SEARCH_VENDOR_TOKENS = Object.freeze([
+    "claude",
+    "sonnet",
+    "opus",
+    "haiku",
+    "gpt",
+    "gemini",
+]);
+/**
+ * Whether the active profile's catalogue records `capability` for `model`.
+ *
+ * `capability` is a verbatim upstream capability string. Ids the profile does
+ * not catalogue answer `false` for every capability: the catalogue is the only
+ * evidence this query consults, and absence of evidence is reported as
+ * absence. Callers wanting the derived nine-boolean view -- which falls back
+ * to the ported predicates for uncatalogued ids -- want `resolveModel`.
+ */
+export function modelCapability(model, capability, profile = CLAUDE_CODE_2_1_195_PROFILE) {
+    const id = normalizedOrNull(model);
+    if (id === null ||
+        typeof capability !== "string" ||
+        capability.length === 0) {
+        return false;
+    }
+    const entry = profile.supportedModels[id];
+    if (entry === undefined) {
+        return false;
+    }
+    return entry.capabilities.includes(capability);
+}
+/** Whether `model` normalizes to `claude-opus-4-6`. */
+export function isOpus46Model(model) {
+    return normalizedOrNull(model) === "claude-opus-4-6";
+}
+/** Whether `model` normalizes to `claude-opus-4-7`. */
+export function isOpus47Model(model) {
+    return normalizedOrNull(model) === "claude-opus-4-7";
+}
+/** Whether `model` normalizes to `claude-opus-4-8`. */
+export function isOpus48Model(model) {
+    return normalizedOrNull(model) === "claude-opus-4-8";
+}
+/** Whether `model` normalizes to `claude-sonnet-4-6`. */
+export function isSonnet46Model(model) {
+    return normalizedOrNull(model) === "claude-sonnet-4-6";
+}
+/** Whether `model` normalizes to `claude-fable-5`. */
+export function isFable5Model(model) {
+    return normalizedOrNull(model) === "claude-fable-5";
+}
+/** Whether `model` normalizes to `claude-mythos-5`. */
+export function isMythos5Model(model) {
+    return normalizedOrNull(model) === "claude-mythos-5";
+}
+/**
+ * Whether `model` belongs to the haiku family.
+ *
+ * Reuses `modelFamilyOf`, the package's one family classifier, so a new haiku
+ * id is classified in exactly one place.
+ */
+export function isHaikuModel(model) {
+    const id = normalizedOrNull(model);
+    return id !== null && modelFamilyOf(id) === "haiku";
+}
+/**
+ * Whether `model` is a Claude 3 generation id.
+ *
+ * The `claude-3-` substring test is the same one the ported capability
+ * predicates open with (`model-capabilities.ts`), applied to the normalized
+ * id, so a Claude 3 id spelled with a dotted version (`claude-3.5-sonnet`)
+ * classifies with its hyphenated spelling.
+ */
+export function isClaude3Model(model) {
+    return normalizedOrNull(model)?.includes("claude-3-") ?? false;
+}
+/**
+ * Whether `model` may receive the 1M-context beta.
+ *
+ * Three sources, in order: an explicit 1M marker in the id, the active
+ * profile's `context.supports1mBeta`, and -- for ids the profile does not
+ * catalogue -- the ported family set (`claude-sonnet-4*`, Opus 4.6/4.7/4.8).
+ */
+export function isEligibleFor1MContext(model, profile = CLAUDE_CODE_2_1_195_PROFILE) {
+    const id = normalizedOrNull(model);
+    if (id === null) {
+        return false;
+    }
+    if (ONE_MILLION_ELIGIBLE_MARKER_RE.test(model)) {
+        return true;
+    }
+    const entry = profile.supportedModels[id];
+    if (entry !== undefined) {
+        return entry.context?.supports1mBeta === true;
+    }
+    return (id.startsWith("claude-sonnet-4") ||
+        id === "claude-opus-4-6" ||
+        id === "claude-opus-4-7" ||
+        id === "claude-opus-4-8");
+}
+/**
+ * Whether `model` names 1M context explicitly and therefore always uses it.
+ *
+ * Marker-only by design. The catalogue's `context.native1m` is a DIFFERENT
+ * question -- the model's native window -- and consulting it here would make
+ * every natively-1M id answer true, which is not what a static "always send
+ * 1M" gate means. Use `modelContextWindow`-shaped catalogue reads for that.
+ */
+export function hasOneMillionContext(model) {
+    return normalizedOrNull(model) !== null && ONE_MILLION_MARKER_RE.test(model);
+}
+/**
+ * Whether `model` supports the structured-outputs beta.
+ *
+ * Delegates to the predicate ported from the genuine client (`j4e`), which is
+ * narrower and better evidenced than a family-shaped heuristic.
+ */
+export function supportsStructuredOutputs(model) {
+    const id = normalizedOrNull(model);
+    return id !== null && portedStructuredOutputs(id);
+}
+/** Whether `model` supports the web-search tool. */
+export function supportsWebSearch(model) {
+    const id = normalizedOrNull(model);
+    return (id !== null && WEB_SEARCH_VENDOR_TOKENS.some((token) => id.includes(token)));
+}
+/**
+ * Whether `model` uses adaptive thinking (`{type: "adaptive"}`) instead of a
+ * manual `budget_tokens`.
+ *
+ * The union of the named family predicates, not a catalogue read: this gates
+ * the shape of the emitted `thinking` block, and an uncatalogued id must not
+ * inherit adaptive thinking from the permissive capability fallback. Ask
+ * `modelCapability(model, "adaptive_thinking", profile)` for the catalogue's
+ * answer.
+ */
+export function isAdaptiveThinkingModel(model) {
+    return (isOpus46Model(model) ||
+        isOpus47Model(model) ||
+        isOpus48Model(model) ||
+        isSonnet46Model(model) ||
+        isFable5Model(model) ||
+        isMythos5Model(model));
+}
+//# sourceMappingURL=model-queries.js.map

package/dist/model-queries.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@tormentalabs/claude-code-wire-compat",
-  "version": "0.3.0",
+  "version": "0.5.0",
   "description": "Runtime-neutral Claude Code Messages wire compatibility primitives",
   "type": "module",
   "private": false,
@@ -53,7 +53,6 @@
     "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",
     "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"
@@ -61,18 +60,18 @@
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.5",
     "@eslint/js": "10.0.1",
-    "@types/node": "26.1.1",
+    "@types/node": "26.2.0",
     "@vitest/coverage-v8": "4.1.10",
     "@vitest/eslint-plugin": "1.6.24",
     "eslint": "10.8.0",
     "fast-check": "4.9.0",
-    "globals": "17.7.0",
+    "globals": "17.11.0",
     "license-checker-rseidelsohn": "5.0.1",
     "miniflare": "4.20260722.0",
     "prettier": "3.9.6",
     "publint": "0.3.22",
     "typescript": "6.0.3",
-    "typescript-eslint": "8.65.0",
+    "typescript-eslint": "8.67.0",
     "vitest": "4.1.10"
   },
   "overrides": {

package/src/build-request.ts

@@ -111,6 +111,7 @@ const COUNT_TOKENS_INPUT_KEYS = new Set([
   "clientApp",
   "anthropicAdditionalProtection",
   "extraHeaders",
+  "extraHeaderPolicy",
 ]);
 const BUILT_KEYS = new Set(["url", "method", "headers", "body", "evidence"]);
 /**
@@ -873,6 +874,7 @@ function validateCountTokensInput(input: ClaudeCodeCountTokensInput): {
   readonly clientRequestId: string;
   readonly crypto: Pick<Crypto, "subtle"> | undefined;
   readonly profileOverride: ClaudeCodeProfileOverride | undefined;
+  readonly extraHeaderPolicy: ClaudeCodeExtraHeaderPolicy | undefined;
 } {
   if (!isRecord(input)) fail();
   assertExactKeys(input, COUNT_TOKENS_INPUT_KEYS);
@@ -915,11 +917,15 @@ function validateCountTokensInput(input: ClaudeCodeCountTokensInput): {
   const profileOverride = Object.hasOwn(input, "profileOverride")
     ? validateProfileOverride(ownValue(input, "profileOverride"))
     : undefined;
+  const extraHeaderPolicy = Object.hasOwn(input, "extraHeaderPolicy")
+    ? validateExtraHeaderPolicy(ownValue(input, "extraHeaderPolicy"))
+    : undefined;
   return {
     source: input,
     clientRequestId,
     crypto: cryptoValue,
     profileOverride,
+    extraHeaderPolicy,
   };
 }
 
@@ -1441,23 +1447,25 @@ export async function buildClaudeCodeCountTokensRequest(
       ),
     );
     const betas = Object.freeze([...countTokensBetas, TOKEN_COUNTING_BETA]);
+    const headerPlan = buildOrderedHeaderPlan({
+      accessToken: validated.source.accessToken,
+      runtime: identity,
+      clientRequestId: validated.clientRequestId,
+      betaFeatures: betas,
+      app: validated.source.app ?? effectiveProfile.entrypoint,
+      stainlessRetryCount: validated.source.stainlessRetryCount ?? 0,
+      stainlessHelper: validated.source.stainlessHelper,
+      claudeRemoteContainerId: validated.source.claudeRemoteContainerId,
+      claudeRemoteSessionId: validated.source.claudeRemoteSessionId,
+      clientApp: validated.source.clientApp,
+      anthropicAdditionalProtection:
+        validated.source.anthropicAdditionalProtection,
+      extraHeaders: validated.source.extraHeaders ?? [],
+      extraHeaderPolicy: validated.extraHeaderPolicy ?? "strict",
+      profile: pinnedProfile,
+    });
     const headers = applyEffectiveProfileHeaders(
-      buildOrderedHeaders({
-        accessToken: validated.source.accessToken,
-        runtime: identity,
-        clientRequestId: validated.clientRequestId,
-        betaFeatures: betas,
-        app: validated.source.app ?? effectiveProfile.entrypoint,
-        stainlessRetryCount: validated.source.stainlessRetryCount ?? 0,
-        stainlessHelper: validated.source.stainlessHelper,
-        claudeRemoteContainerId: validated.source.claudeRemoteContainerId,
-        claudeRemoteSessionId: validated.source.claudeRemoteSessionId,
-        clientApp: validated.source.clientApp,
-        anthropicAdditionalProtection:
-          validated.source.anthropicAdditionalProtection,
-        extraHeaders: validated.source.extraHeaders ?? [],
-        profile: pinnedProfile,
-      }),
+      headerPlan.headers,
       effectiveProfile,
     );
     const canonical = canonicalCountTokensLists(
@@ -1484,6 +1492,12 @@ export async function buildClaudeCodeCountTokensRequest(
         logicalHeaders: headers,
         betaFeatures: betas,
         body,
+        // Emitted only for the opted-in policy, exactly as the main path does,
+        // so count-tokens evidence for every other request keeps the shape it
+        // had before the seam reached this surface.
+        ...(validated.extraHeaderPolicy === "dropConflicting"
+          ? { droppedExtraHeaderNames: headerPlan.droppedExtraHeaderNames }
+          : {}),
       },
       validated.crypto,
     );

package/src/contracts.ts

@@ -1067,7 +1067,15 @@ export interface ClaudeCodeRequestInput {
  * Narrower than `ClaudeCodeRequestInput` by design. Upstream `P5e` derives the
  * beta set from the model alone, so there is deliberately no `capabilities`
  * field, and the count-tokens body carries no `system`, `metadata`, or
- * `maxTokens`.
+ * `maxTokens`. Those four omissions are fidelity to upstream and stay out.
+ *
+ * `extraHeaderPolicy` is deliberately IN, on the other hand: it is a PACKAGE
+ * EXTENSION over the transport, not a claim about the count-tokens body, and
+ * `buildOrderedHeaders` is the same code path on both surfaces. Leaving it out
+ * forced consumers to re-implement conflict dropping client-side against a
+ * mirrored list of the header names this package owns. Omitting the field, or
+ * passing `"strict"`, leaves the emitted count-tokens request byte-identical,
+ * evidence included.
  */
 export type ClaudeCodeCountTokensInput = Pick<
   ClaudeCodeRequestInput,
@@ -1087,6 +1095,7 @@ export type ClaudeCodeCountTokensInput = Pick<
   | "clientApp"
   | "anthropicAdditionalProtection"
   | "extraHeaders"
+  | "extraHeaderPolicy"
 >;
 
 export interface BuiltClaudeCodeCountTokensRequest extends Omit<

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,33 @@ 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 { 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";

package/src/model-identity.ts

@@ -7,9 +7,23 @@ export function stripModelMarkers(model: string): string {
   return model.replace(/\[(1|2)m\]/gi, "");
 }
 
+/**
+ * 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). */
 export function normalizeModelId(model: string): string {
-  model = model.toLowerCase();
+  model = dottedToDashedVersion(model.toLowerCase());
   if (model.includes("claude-fable-5")) return "claude-fable-5";
   if (model.includes("claude-mythos-5")) return "claude-mythos-5";
   if (model.includes("claude-opus-4-8")) return "claude-opus-4-8";