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

package/src/profiles/beta-registry-2.1.233.ts

@@ -0,0 +1,200 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+interface BetaRegistryEntry {
+  readonly featureKey: string;
+  readonly header: string;
+}
+
+/*
+ * `deepFreeze` is duplicated from `src/beta-registry.ts` rather than imported.
+ * A shared helper module would make the two registries import-coupled for four
+ * lines of code, and the 2.1.195 registry already carries its own copy; keeping
+ * each registry a leaf keeps a version bump from rippling.
+ */
+function deepFreeze<T>(value: T): T {
+  if (value !== null && typeof value === "object") {
+    for (const key of Reflect.ownKeys(value)) {
+      deepFreeze(Reflect.get(value, key));
+    }
+    Object.freeze(value);
+  }
+  return value;
+}
+
+/**
+ * Genuine-client beta registry as of 2.1.233, upstream `Fb_` (byte offset
+ * 287505865).
+ *
+ * KEY ORDER IS LOAD-BEARING. Upstream neither sorts this object nor keeps a
+ * canonical list elsewhere, and `src/betas.ts` emits headers in the order its
+ * push sites fire, not in registry order -- but the registry order is the
+ * transcription of record and the only thing that makes a diff against a future
+ * build meaningful. Do not reorder for tidiness, alphabetisation, or grouping.
+ */
+export const BETA_REGISTRY_2_1_233 = deepFreeze({
+  CLAUDE_CODE: { featureKey: "claude_code", header: "claude-code-20250219" },
+  OAUTH_AUTH: { featureKey: "oauth_auth", header: "oauth-2025-04-20" },
+  INTERLEAVED_THINKING: {
+    featureKey: "interleaved_thinking",
+    header: "interleaved-thinking-2025-05-14",
+  },
+  LONG_CONTEXT: { featureKey: "long_context", header: "context-1m-2025-08-07" },
+  CONTEXT_MANAGEMENT: {
+    featureKey: "context_management",
+    header: "context-management-2025-06-27",
+  },
+  STRUCTURED_OUTPUTS: {
+    featureKey: "structured_outputs",
+    header: "structured-outputs-2025-12-15",
+  },
+  WEB_SEARCH: { featureKey: "web_search", header: "web-search-2025-03-05" },
+  ADVANCED_TOOL_USE: {
+    featureKey: "tool_search",
+    header: "advanced-tool-use-2025-11-20",
+  },
+  TOOL_SEARCH: {
+    featureKey: "tool_search",
+    header: "tool-search-tool-2025-10-19",
+  },
+  EFFORT: { featureKey: "effort", header: "effort-2025-11-24" },
+  TASK_BUDGETS: {
+    featureKey: "task_budgets",
+    header: "task-budgets-2026-03-13",
+  },
+  PROMPT_CACHING_SCOPE: {
+    featureKey: "prompt_caching_scope",
+    header: "prompt-caching-scope-2026-01-05",
+  },
+  PROMPT_CACHING_EVICT: {
+    featureKey: "prompt_caching_evict",
+    header: "prompt-caching-evict-2026-05-12",
+  },
+  EXTENDED_CACHE_TTL: {
+    featureKey: "extended_cache_ttl",
+    header: "extended-cache-ttl-2025-04-11",
+  },
+  SPEED: { featureKey: "speed", header: "fast-mode-2026-02-01" },
+  REDACT_THINKING: {
+    featureKey: "redact_thinking",
+    header: "redact-thinking-2026-02-12",
+  },
+  THINKING_TOKEN_COUNT: {
+    featureKey: "thinking_token_count",
+    header: "thinking-token-count-2026-05-13",
+  },
+  AFK_MODE: { featureKey: "afk_mode", header: "afk-mode-2026-01-31" },
+  ADVISOR_TOOL: {
+    featureKey: "advisor_tool",
+    header: "advisor-tool-2026-03-01",
+  },
+  CACHE_DIAGNOSIS: {
+    featureKey: "cache_diagnosis",
+    header: "cache-diagnosis-2026-04-07",
+  },
+  CONTEXT_HINT: {
+    featureKey: "context_hint",
+    header: "context-hint-2026-04-09",
+  },
+  MCP_SERVERS: {
+    featureKey: "mcp_servers",
+    header: "mcp-servers-2025-12-04",
+  },
+  FILES_API: { featureKey: "files_api", header: "files-api-2025-04-14" },
+  ENVIRONMENTS: {
+    featureKey: "environments",
+    header: "environments-2025-11-01",
+  },
+  CCR_BYOC: { featureKey: "ccr_byoc", header: "ccr-byoc-2025-07-29" },
+  MID_CONVERSATION_SYSTEM: {
+    featureKey: "mid_conversation_system",
+    header: "mid-conversation-system-2026-04-07",
+  },
+  PER_MESSAGE_EFFORT: {
+    featureKey: "per_message_effort",
+    header: "per-turn-control-2026-07-01",
+  },
+  SERVER_SIDE_FALLBACK: {
+    featureKey: "server_side_fallback",
+    header: "server-side-fallback-2026-06-01",
+  },
+  SERVER_SIDE_FALLBACK_CATEGORY: {
+    featureKey: "server_side_fallback_category",
+    header: "server-side-fallback-2026-07-01",
+  },
+  FALLBACK_CREDIT: {
+    featureKey: "fallback_credit",
+    header: "fallback-credit-2026-06-01",
+  },
+  /*
+   * NARRATION_SUMMARIES BELONGS HERE AND IS DELIBERATELY ABSENT.
+   *
+   * 2.1.195 carried `NARRATION_SUMMARIES` (`narration_summaries` /
+   * `summarize-connector-text-2026-03-13`, upstream `RPt`) at exactly this
+   * position, between `FALLBACK_CREDIT` and `AUTO_MODE_CLASSIFIER`. Upstream
+   * removed it in 2.1.222+: the frozen array in the 2.1.233 build has a null
+   * slot here and the header string appears nowhere in the binary.
+   *
+   * This is a REMOVAL, not a transcription gap. Re-adding the entry would
+   * reintroduce a header the genuine client no longer sends and would break the
+   * wire-compatibility claim on the first request. `src/betas.ts` treats the
+   * narration push site as conditional on the entry's presence precisely so
+   * this absence needs no special-casing anywhere else. Do not "fix" it.
+   */
+  AUTO_MODE_CLASSIFIER: {
+    featureKey: "auto_mode_classifier",
+    header: "auto-mode-classifier-2026-07-16",
+  },
+} satisfies Record<string, BetaRegistryEntry>);
+
+/*
+ * Third-party filtering as of 2.1.233, upstream `X5p` (consumed by `J4u`).
+ *
+ * Delta against the 2.1.195 set (`Pvi`): `mid-conversation-system-2026-04-07`
+ * was ADDED; nothing was removed. Eleven headers, extracted from the 2.1.233
+ * build rather than assumed to have carried over.
+ */
+export const THIRD_PARTY_ALLOWED_BETAS_2_1_233: ReadonlySet<string> =
+  Object.freeze(
+    new Set([
+      BETA_REGISTRY_2_1_233.CLAUDE_CODE.header,
+      BETA_REGISTRY_2_1_233.INTERLEAVED_THINKING.header,
+      BETA_REGISTRY_2_1_233.LONG_CONTEXT.header,
+      BETA_REGISTRY_2_1_233.CONTEXT_MANAGEMENT.header,
+      BETA_REGISTRY_2_1_233.STRUCTURED_OUTPUTS.header,
+      BETA_REGISTRY_2_1_233.WEB_SEARCH.header,
+      BETA_REGISTRY_2_1_233.EFFORT.header,
+      BETA_REGISTRY_2_1_233.TOOL_SEARCH.header,
+      BETA_REGISTRY_2_1_233.AFK_MODE.header,
+      BETA_REGISTRY_2_1_233.FALLBACK_CREDIT.header,
+      BETA_REGISTRY_2_1_233.MID_CONVERSATION_SYSTEM.header,
+    ]),
+  );
+
+/*
+ * Provider filtering as of 2.1.233, upstream `pts` (consumed by `y1s`).
+ * Extracted, not assumed: the set is byte-identical to the 2.1.195 one (`S2r`).
+ *
+ * Static reference data with no call site in `src/`, exactly like its 2.1.195
+ * counterpart. See `test/governance/provider-scope.test.ts`.
+ */
+export const BEDROCK_UNSUPPORTED_BETAS_2_1_233: ReadonlySet<string> =
+  Object.freeze(
+    new Set([
+      BETA_REGISTRY_2_1_233.INTERLEAVED_THINKING.header,
+      BETA_REGISTRY_2_1_233.LONG_CONTEXT.header,
+      BETA_REGISTRY_2_1_233.TOOL_SEARCH.header,
+    ]),
+  );
+
+/*
+ * Count-tokens selection as of 2.1.233, upstream `fts` (consumed by `_1s`).
+ * Extracted, not assumed: identical to the 2.1.195 set (`E2r`).
+ */
+export const COUNT_TOKENS_BETAS_2_1_233: ReadonlySet<string> = Object.freeze(
+  new Set([
+    BETA_REGISTRY_2_1_233.CLAUDE_CODE.header,
+    BETA_REGISTRY_2_1_233.INTERLEAVED_THINKING.header,
+    BETA_REGISTRY_2_1_233.CONTEXT_MANAGEMENT.header,
+    BETA_REGISTRY_2_1_233.OAUTH_AUTH.header,
+  ]),
+);

package/src/profiles/claude-code-2.1.195.ts

@@ -0,0 +1,168 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+import type { ClaudeCodeProtocolProfile } from "../contracts.js";
+import { COUNT_TOKENS_ENDPOINT } from "../count-tokens.js";
+
+function deepFreeze<T>(value: T): T {
+  if (value !== null && typeof value === "object") {
+    for (const key of Reflect.ownKeys(value)) {
+      deepFreeze(Reflect.get(value, key));
+    }
+    Object.freeze(value);
+  }
+  return value;
+}
+
+export const CLAUDE_CODE_2_1_195_PROFILE: ClaudeCodeProtocolProfile =
+  deepFreeze({
+    id: "claude-code-2.1.195-sdk-0.94.0",
+    cliVersion: "2.1.195",
+    sdkVersion: "0.94.0",
+    endpoint: "https://api.anthropic.com/v1/messages?beta=true",
+    countTokensEndpoint: COUNT_TOKENS_ENDPOINT,
+    entrypoint: "cli",
+    userAgent: "claude-cli/2.1.195 (external, cli)",
+    buildTime: "2026-06-26T01:00:56Z",
+    gitSha: "4603aa3f2ea164bd0974f82eb413ae7acc99a7ee",
+    attributionHeaderEnabled: true,
+    provider: "anthropic",
+    anthropicVersion: "2023-06-01",
+    contextHintEnabled: false,
+    betaPolicy: {
+      oauthAuthenticated: true,
+      experimentalBetasEnabled: true,
+      oneMillionContextEnabled: true,
+      interleavedThinkingEnabled: true,
+      interactive: true,
+      thinkingSummariesShown: false,
+      thinkingTokenCountEnabled: true,
+      narrationSummariesEnabled: false,
+      structuredOutputsEnabled: false,
+      afkModeEnabled: false,
+      cacheDiagnosisEnabled: false,
+    },
+    /**
+     * Verbatim genuine-client catalogue at byte offset 226599191.
+     * `defaultEffort` is policy exposed as catalogue data; this package must
+     * never apply it to a request.
+     */
+    supportedModels: {
+      "claude-3-5-haiku": {
+        family: "haiku",
+        capabilities: [],
+        maxOutputTokens: { default: 8192, upper: 8192 },
+      },
+      "claude-haiku-4-5": {
+        family: "haiku",
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 64000 },
+      },
+      "claude-3-5-sonnet": {
+        family: "sonnet",
+        capabilities: [],
+        maxOutputTokens: { default: 8192, upper: 8192 },
+      },
+      "claude-3-7-sonnet": {
+        family: "sonnet",
+        capabilities: [],
+        maxOutputTokens: { default: 32000, upper: 64000 },
+      },
+      "claude-sonnet-4-0": {
+        family: "sonnet",
+        context: { window: 200000, supports1mBeta: true },
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 64000 },
+      },
+      "claude-sonnet-4-5": {
+        family: "sonnet",
+        context: { window: 200000, supports1mBeta: true },
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 64000 },
+      },
+      "claude-sonnet-4-6": {
+        family: "sonnet",
+        context: { window: 200000, supports1mBeta: true },
+        maxOutputTokens: { default: 32000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "adaptive_thinking",
+          "context_management",
+        ],
+      },
+      "claude-opus-4-0": {
+        family: "opus",
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 32000 },
+      },
+      "claude-opus-4-1": {
+        family: "opus",
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 32000 },
+      },
+      "claude-opus-4-5": {
+        family: "opus",
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 64000 },
+      },
+      "claude-opus-4-6": {
+        family: "opus",
+        context: { window: 200000, supports1mBeta: true },
+        maxOutputTokens: { default: 64000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "adaptive_thinking",
+          "context_management",
+          "fast_mode",
+        ],
+      },
+      "claude-opus-4-7": {
+        family: "opus",
+        context: { window: 1e6, native1m: true, supports1mBeta: true },
+        maxOutputTokens: { default: 64000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "xhigh_effort",
+          "adaptive_thinking",
+          "context_management",
+          "fast_mode",
+        ],
+        defaultEffort: "xhigh",
+      },
+      "claude-opus-4-8": {
+        family: "opus",
+        context: { window: 1e6, native1m: true, supports1mBeta: true },
+        maxOutputTokens: { default: 64000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "xhigh_effort",
+          "adaptive_thinking",
+          "mid_conv_system",
+          "context_management",
+          "fast_mode",
+          "lean_prompt",
+        ],
+        defaultEffort: "high",
+      },
+      "claude-fable-5": {
+        family: "fable",
+        context: { window: 1e6, native1m: true, supports1mBeta: true },
+        maxOutputTokens: { default: 64000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "xhigh_effort",
+          "adaptive_thinking",
+          "rejects_disabled_thinking",
+          "mid_conv_system",
+          "context_management",
+          "lean_prompt",
+          "fable_5_mitigations",
+        ],
+        defaultEffort: "high",
+      },
+    },
+  });

package/src/profiles/claude-code-2.1.233.ts

@@ -0,0 +1,240 @@
+// SPDX-License-Identifier: GPL-3.0-or-later
+
+import type { ClaudeCodeProtocolProfile } from "../contracts.js";
+import { COUNT_TOKENS_ENDPOINT } from "../count-tokens.js";
+
+/*
+ * Protocol profile for genuine client 2.1.233.
+ *
+ * Provenance: extracted from the official 2.1.233 win32-x64 binary. The
+ * catalogue and every scalar below are transcribed from
+ * `docs/protocol/versions/claude-code-2.1.233-analysis.md`, which records the
+ * byte offsets they came from.
+ *
+ * `effort_cost_index` -- the only static-catalogue field added between 2.1.222
+ * and 2.1.233 -- is deliberately omitted; the decision is recorded in
+ * `docs/source-trace.md`.
+ *
+ * Context modelling follows 2.1.195 exactly wherever the upstream flags are
+ * the same. `supports_1m_suffix` is not modelled, so an entry declaring a
+ * 200000 window with nothing but that flag carries no `context` object here,
+ * as in the 2.1.195 profile.
+ */
+
+function deepFreeze<T>(value: T): T {
+  if (value !== null && typeof value === "object") {
+    for (const key of Reflect.ownKeys(value)) {
+      deepFreeze(Reflect.get(value, key));
+    }
+    Object.freeze(value);
+  }
+  return value;
+}
+
+export const CLAUDE_CODE_2_1_233_PROFILE: ClaudeCodeProtocolProfile =
+  deepFreeze({
+    id: "claude-code-2.1.233-sdk-0.112.1",
+    cliVersion: "2.1.233",
+    sdkVersion: "0.112.1",
+    endpoint: "https://api.anthropic.com/v1/messages?beta=true",
+    countTokensEndpoint: COUNT_TOKENS_ENDPOINT,
+    entrypoint: "cli",
+    userAgent: "claude-cli/2.1.233 (external, cli)",
+    buildTime: "2026-08-14T17:21:48Z",
+    gitSha: "f8d57569aaf350fe25dc4dfa10cad59db8ea4d45",
+    attributionHeaderEnabled: true,
+    provider: "anthropic",
+    anthropicVersion: "2023-06-01",
+    contextHintEnabled: false,
+    betaPolicy: {
+      oauthAuthenticated: true,
+      experimentalBetasEnabled: true,
+      oneMillionContextEnabled: true,
+      interleavedThinkingEnabled: true,
+      interactive: true,
+      thinkingSummariesShown: false,
+      thinkingTokenCountEnabled: true,
+      // Inert for this profile: 2.1.233 removed `narration_summaries` from the
+      // beta registry, so there is no entry for this flag to gate.
+      narrationSummariesEnabled: false,
+      structuredOutputsEnabled: false,
+      afkModeEnabled: false,
+      cacheDiagnosisEnabled: false,
+    },
+    /**
+     * Verbatim genuine-client catalogue, 17 entries in the catalogue's own
+     * order. `defaultEffort` is policy exposed as catalogue data; this package
+     * must never apply it to a request.
+     */
+    supportedModels: {
+      "claude-3-5-haiku": {
+        family: "haiku",
+        capabilities: [],
+        maxOutputTokens: { default: 8192, upper: 8192 },
+      },
+      "claude-haiku-4-5": {
+        family: "haiku",
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 64000 },
+      },
+      "claude-3-5-sonnet": {
+        family: "sonnet",
+        capabilities: [],
+        maxOutputTokens: { default: 8192, upper: 8192 },
+      },
+      "claude-3-7-sonnet": {
+        family: "sonnet",
+        capabilities: [],
+        maxOutputTokens: { default: 32000, upper: 64000 },
+      },
+      "claude-sonnet-4-0": {
+        family: "sonnet",
+        context: { window: 200000, supports1mBeta: true },
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 64000 },
+      },
+      "claude-sonnet-4-5": {
+        family: "sonnet",
+        context: { window: 200000, supports1mBeta: true },
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 64000 },
+      },
+      "claude-sonnet-4-6": {
+        family: "sonnet",
+        context: { window: 200000, supports1mBeta: true },
+        maxOutputTokens: { default: 32000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "adaptive_thinking",
+          "context_management",
+        ],
+      },
+      // New at 2.1.233. The entry also declares `native_1m_3p` for
+      // bedrock/vertex/foundry; this package is anthropic-only, so that flag
+      // is not modelled.
+      "claude-sonnet-5": {
+        family: "sonnet",
+        context: { window: 1e6, native1m: true, supports1mBeta: true },
+        maxOutputTokens: { default: 64000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "xhigh_effort",
+          "adaptive_thinking",
+          "mid_conv_system",
+          "context_management",
+        ],
+        defaultEffort: "high",
+      },
+      "claude-opus-4-0": {
+        family: "opus",
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 32000 },
+      },
+      "claude-opus-4-1": {
+        family: "opus",
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 32000 },
+      },
+      // No `effort`, and no exception restoring it. The C1 exception in
+      // `model-capabilities.ts` belongs to 2.1.195, whose derivation ran off
+      // predicates; 2.1.233 derives from this catalogue, so the omission is
+      // the genuine answer here.
+      "claude-opus-4-5": {
+        family: "opus",
+        capabilities: ["context_management"],
+        maxOutputTokens: { default: 32000, upper: 64000 },
+      },
+      // Delta D3 vs 2.1.195: `fast_mode` is gone from this entry.
+      "claude-opus-4-6": {
+        family: "opus",
+        context: { window: 200000, supports1mBeta: true },
+        maxOutputTokens: { default: 64000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "adaptive_thinking",
+          "context_management",
+        ],
+      },
+      // Delta D3 vs 2.1.195: `fast_mode` is gone from this entry too.
+      "claude-opus-4-7": {
+        family: "opus",
+        context: { window: 1e6, native1m: true, supports1mBeta: true },
+        maxOutputTokens: { default: 64000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "xhigh_effort",
+          "adaptive_thinking",
+          "context_management",
+        ],
+        defaultEffort: "xhigh",
+      },
+      "claude-opus-4-8": {
+        family: "opus",
+        context: { window: 1e6, native1m: true, supports1mBeta: true },
+        maxOutputTokens: { default: 64000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "xhigh_effort",
+          "adaptive_thinking",
+          "mid_conv_system",
+          "context_management",
+          "fast_mode",
+          "lean_prompt",
+        ],
+        defaultEffort: "high",
+      },
+      // New at 2.1.233.
+      "claude-opus-5": {
+        family: "opus",
+        context: { window: 1e6, native1m: true, supports1mBeta: true },
+        maxOutputTokens: { default: 64000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "xhigh_effort",
+          "adaptive_thinking",
+          "mid_conv_system",
+          "context_management",
+          "fast_mode",
+          "lean_prompt",
+          "refusal_fallback",
+          "opus_5_prompt_bundle",
+        ],
+        defaultEffort: "high",
+      },
+      "claude-fable-5": {
+        family: "fable",
+        context: { window: 1e6, native1m: true, supports1mBeta: true },
+        maxOutputTokens: { default: 64000, upper: 128000 },
+        capabilities: [
+          "effort",
+          "max_effort",
+          "xhigh_effort",
+          "adaptive_thinking",
+          "rejects_disabled_thinking",
+          "mid_conv_system",
+          "context_management",
+          "lean_prompt",
+          "fable_5_mitigations",
+          "refusal_fallback",
+        ],
+        defaultEffort: "high",
+      },
+      // New at 2.1.233, and the notable one: under 2.1.195 `claude-mythos-5`
+      // had no catalogue entry at all (product decision D-1) and was
+      // recognised only by name in individual predicates. Here it is
+      // catalogued with an empty capability array, which is a denial rather
+      // than the maximally permissive predicate fallback.
+      "claude-mythos-5": {
+        family: "mythos",
+        context: { window: 1e6, native1m: true, supports1mBeta: true },
+        capabilities: [],
+        maxOutputTokens: { default: 64000, upper: 128000 },
+      },
+    },
+  });