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

package/CHANGELOG.md

@@ -2,6 +2,56 @@
 
 All notable changes to this project will be documented in this file.
 
+## [0.5.0] - 2026-08-16
+
+### Added
+
+- **Model-query surface**, fourteen exports from the package entry point:
+  the generic `modelCapability(model, capability, profile)`, which reads the
+  verbatim upstream capability string off the active catalogue, plus the named
+  identity predicates `isOpus46Model`, `isOpus47Model`, `isOpus48Model`,
+  `isSonnet46Model`, `isFable5Model`, `isMythos5Model`, `isHaikuModel`,
+  `isClaude3Model`, `isAdaptiveThinkingModel`, `hasOneMillionContext`,
+  `isEligibleFor1MContext`, `supportsStructuredOutputs` and
+  `supportsWebSearch`.
+
+  The predicates are written over the existing `normalizeModelId` /
+  `modelFamilyOf` pair rather than over new family regexes, so a model id
+  classifies the same way here as it does everywhere else in the package. They
+  answer `false` for an empty or non-string id instead of throwing.
+
+  Motivation: consumers were re-deriving model identity from ad hoc substring
+  matches, which drifts from the catalogue the package already carries.
+
+- **`normalizeModelId` accepts dotted model version ids.** A digit-dot-digit
+  run is rewritten to the hyphenated wire form before the upstream branch
+  ladder, so `claude-opus-4.7` classifies identically to `claude-opus-4-7`.
+
+  Compatibility: ids without a dotted version (`gpt-4o`, the empty string,
+  `vendor.example/model-x`) normalise byte-identically to before.
+
+- **Beta registries are public**: `BETA_REGISTRY` (28 entries),
+  `BETA_REGISTRY_2_1_233` (31 entries) and `TOKEN_COUNTING_BETA`. They are
+  protocol constants transcribed from the genuine client, so a consumer that
+  reads a beta header off the registry cannot drift from the package that
+  emits it. Reading a header is not emitting one — composition, gating and
+  push order stay inside the package, and the policy sets
+  (`THIRD_PARTY_ALLOWED_BETAS`, `BEDROCK_UNSUPPORTED_BETAS`,
+  `COUNT_TOKENS_BETAS`) remain private.
+
+### Documentation
+
+- **Endpoint URL contract** (README, "Endpoint URL and custom base URLs"):
+  `built.url` is the profile's pinned, literal-typed endpoint. A host with a
+  custom base substitutes protocol, hostname and port while preserving the
+  package's `pathname` and `search`. The input deliberately gains no `baseUrl`
+  field — widening the literal `url` type is a breaking change for consumers
+  that pin the endpoint, the field would duplicate what `URL` already does,
+  and the only observed consumer case is an origin override.
+
+No breaking changes: every surface above is additive, and the golden fixtures
+re-seal to the same bytes.
+
 ## [0.4.0] - 2026-08-16
 
 ### Added

package/README.md

@@ -30,6 +30,38 @@ import { CLAUDE_CODE_2_1_233_PROFILE } from "@tormentalabs/claude-code-wire-comp
 
 The fail-closed rule is unchanged: only these exported singletons are accepted. Any other object, even a structurally identical clone, is rejected with `ClaudeCodeWireError` code `INVALID_INPUT`. This prevents callers from substituting an unpinned protocol profile.
 
+## Endpoint URL and custom base URLs
+
+`built.url` is the **pinned endpoint of the profile**, not a suggestion. It is literal-typed, so the type is part of the contract:
+
+- `buildClaudeCodeRequest` → `"https://api.anthropic.com/v1/messages?beta=true"`
+- `buildClaudeCodeCountTokensRequest` → `"https://api.anthropic.com/v1/messages/count_tokens?beta=true"`
+
+A host that talks to a proxy, a gateway, or a regional endpoint **overrides the origin and nothing else**: replace protocol, hostname and port; keep the package's `pathname` and `search` verbatim. The `?beta=true` query and the `/v1/messages` path are wire contract — dropping either changes what the server does, and the golden fixtures no longer describe the request that was sent.
+
+```ts
+const built = await buildClaudeCodeRequest(input);
+
+// Origin override. `pathname` and `search` come from the package, untouched.
+const target = new URL(built.url);
+const base = new URL(hostBaseUrl); // whatever the host resolved, e.g. from its own config
+target.protocol = base.protocol;
+target.hostname = base.hostname;
+target.port = base.port;
+
+await fetch(target, {
+  method: built.method,
+  headers: built.headers,
+  body: built.body,
+});
+```
+
+**The input will not gain a `baseUrl` field.** Three reasons, recorded so the request does not come back:
+
+1. `BuiltClaudeCodeRequest["url"]` is a string literal type. Widening it to `string` to accommodate an arbitrary base is a breaking change at the type level for every consumer that pins the endpoint.
+2. Speculative surface is not added to this package. A host that has a base URL already has a URL library; a package field would be a second way to do the same thing, with a validation and normalisation burden this package would then own.
+3. The only real consumer case observed is an origin override, which the four lines above express exactly — including the case where the base URL carries a path prefix, which a naive `baseUrl + pathname` concatenation gets wrong.
+
 ## Protocol documentation
 
 The wire contract this package pins was reverse engineered before it was

package/dist/index.d.ts

@@ -1,9 +1,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
@@ -12,7 +13,11 @@
 export type { AntiVerbosityPolicy, AntiVerbositySection, BuiltClaudeCodeCountTokensRequest, BuiltClaudeCodeRequest, ClaudeCodeBetaOverrides, ClaudeCodeBetaPolicy, ClaudeCodeCapabilities, ClaudeCodeCapabilityDecisions, ClaudeCodeCatalogueEntry, ClaudeCodeEffort, ClaudeCodeExtraHeaderPolicy, ClaudeCodeMetadataOverrides, ClaudeCodeModelFamily, ClaudeCodeProtocolProfile, ClaudeCodeCountTokensInput, ClaudeCodeRequestInput, ClaudeCodeRuntimeIdentity, ClaudeCodeWireErrorCode, HeaderPair, JsonPrimitive, JsonValue, Message, MessageContent, RedactedRequestEvidence, SystemInput, TextBlock, ThinkingDisplay, ToolDefinition, ToolResultBlock, ToolUseBlock, } from "./contracts.js";
 export { ClaudeCodeWireError } from "./contracts.js";
 export { DEFAULT_ANTI_VERBOSITY_POLICY, antiVerbosityText, 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";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAEH,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,iCAAiC,EACjC,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,6BAA6B,EAC7B,wBAAwB,EACxB,gBAAgB,EAChB,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,SAAS,EACT,OAAO,EACP,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,SAAS,EACT,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EACL,6BAA6B,EAC7B,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,iCAAiC,EACjC,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AAEH,YAAY,EACV,mBAAmB,EACnB,oBAAoB,EACpB,iCAAiC,EACjC,sBAAsB,EACtB,uBAAuB,EACvB,oBAAoB,EACpB,sBAAsB,EACtB,6BAA6B,EAC7B,wBAAwB,EACxB,gBAAgB,EAChB,2BAA2B,EAC3B,2BAA2B,EAC3B,qBAAqB,EACrB,yBAAyB,EACzB,0BAA0B,EAC1B,sBAAsB,EACtB,yBAAyB,EACzB,uBAAuB,EACvB,UAAU,EACV,aAAa,EACb,SAAS,EACT,OAAO,EACP,cAAc,EACd,uBAAuB,EACvB,WAAW,EACX,SAAS,EACT,eAAe,EACf,cAAc,EACd,eAAe,EACf,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EACL,6BAA6B,EAC7B,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EACL,iCAAiC,EACjC,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC"}

package/dist/index.js

@@ -1,7 +1,11 @@
 // SPDX-License-Identifier: GPL-3.0-or-later
 export { ClaudeCodeWireError } from "./contracts.js";
 export { DEFAULT_ANTI_VERBOSITY_POLICY, antiVerbosityText, 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";
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AA+C5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EACL,6BAA6B,EAC7B,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,iCAAiC,EACjC,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,4CAA4C;AAgD5C,OAAO,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAErD,OAAO,EACL,6BAA6B,EAC7B,iBAAiB,EACjB,0BAA0B,GAC3B,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,OAAO,EACL,iCAAiC,EACjC,sBAAsB,EACtB,2BAA2B,GAC5B,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAExD,OAAO,EACL,oBAAoB,EACpB,uBAAuB,EACvB,cAAc,EACd,sBAAsB,EACtB,aAAa,EACb,YAAY,EACZ,cAAc,EACd,aAAa,EACb,aAAa,EACb,aAAa,EACb,eAAe,EACf,eAAe,EACf,yBAAyB,EACzB,iBAAiB,GAClB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,qBAAqB,EAAE,MAAM,qCAAqC,CAAC;AAC5E,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAChF,OAAO,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC"}

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.4.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"

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";

package/src/model-queries.ts

@@ -0,0 +1,241 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+import type { ClaudeCodeProtocolProfile } from "./contracts.js";
+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: string): string | null {
+  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: readonly string[] = 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: string,
+  capability: string,
+  profile: ClaudeCodeProtocolProfile = CLAUDE_CODE_2_1_195_PROFILE,
+): boolean {
+  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: string): boolean {
+  return normalizedOrNull(model) === "claude-opus-4-6";
+}
+
+/** Whether `model` normalizes to `claude-opus-4-7`. */
+export function isOpus47Model(model: string): boolean {
+  return normalizedOrNull(model) === "claude-opus-4-7";
+}
+
+/** Whether `model` normalizes to `claude-opus-4-8`. */
+export function isOpus48Model(model: string): boolean {
+  return normalizedOrNull(model) === "claude-opus-4-8";
+}
+
+/** Whether `model` normalizes to `claude-sonnet-4-6`. */
+export function isSonnet46Model(model: string): boolean {
+  return normalizedOrNull(model) === "claude-sonnet-4-6";
+}
+
+/** Whether `model` normalizes to `claude-fable-5`. */
+export function isFable5Model(model: string): boolean {
+  return normalizedOrNull(model) === "claude-fable-5";
+}
+
+/** Whether `model` normalizes to `claude-mythos-5`. */
+export function isMythos5Model(model: string): boolean {
+  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: string): boolean {
+  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: string): boolean {
+  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: string,
+  profile: ClaudeCodeProtocolProfile = CLAUDE_CODE_2_1_195_PROFILE,
+): boolean {
+  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: string): boolean {
+  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: string): boolean {
+  const id = normalizedOrNull(model);
+  return id !== null && portedStructuredOutputs(id);
+}
+
+/** Whether `model` supports the web-search tool. */
+export function supportsWebSearch(model: string): boolean {
+  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: string): boolean {
+  return (
+    isOpus46Model(model) ||
+    isOpus47Model(model) ||
+    isOpus48Model(model) ||
+    isSonnet46Model(model) ||
+    isFable5Model(model) ||
+    isMythos5Model(model)
+  );
+}