cartethyia 2.5.9 → 2.6.0

package/src/providers/integrations/buddy/buddy-checkin.ts

@@ -1,3 +1,5 @@
+import { asCoercedNumber as sharedAsNumber, asRecord as sharedAsRecord } from "../../../shared/coerce";
+
 // Buddy-family daily check-in (daily login credit claim), shared by all three
 // variants (`cb`, `cbcn`, `workbuddy`): same Tencent billing facade, same
 // status/claim contract — only the endpoint base and identity headers differ
@@ -370,20 +372,14 @@ function isRetryableClaim(error: unknown, status: number | null): boolean {
 }
 
 function asRecord(value: unknown): Record<string, unknown> | null {
-  return value !== null && typeof value === "object" && !Array.isArray(value)
-    ? (value as Record<string, unknown>)
-    : null;
+  return sharedAsRecord(value) ?? null;
 }
 
 function asNumber(value: unknown): number | null {
-  if (typeof value === "number") return Number.isFinite(value) ? value : null;
-  if (typeof value === "string" && value.trim()) {
-    const parsed = Number(value);
-    return Number.isFinite(parsed) ? parsed : null;
-  }
-  return null;
+  return sharedAsNumber(value) ?? null;
 }
 
+
 /** Reads the envelope's business code; `0` means success. */
 function envelopeCode(payload: unknown): number | null {
   const envelope = asRecord(payload);

package/src/providers/integrations/buddy/buddy-discovery-shared.ts

@@ -1,3 +1,5 @@
+import { asNumber as sharedAsNumber, asRecord } from "../../../shared/coerce";
+
 /**
  * Model discovery for the buddy family (CodeBuddy intl / CN, WorkBuddy).
  *
@@ -77,14 +79,8 @@ function siteOrigin(baseUrl: string): string {
   return baseUrl.replace(/\/+$/, "").replace(/\/v\d+$/, "");
 }
 
-function asRecord(value: unknown): Record<string, unknown> | undefined {
-  return typeof value === "object" && value !== null && !Array.isArray(value)
-    ? (value as Record<string, unknown>)
-    : undefined;
-}
-
 function asNumber(value: unknown): number | null {
-  return typeof value === "number" && Number.isFinite(value) ? value : null;
+  return sharedAsNumber(value) ?? null;
 }
 
 /**

package/src/providers/integrations/buddy/buddy-quota-shared.ts

@@ -1,3 +1,5 @@
+import { asNumber as sharedAsNumber } from "../../../shared/coerce";
+
 /**
  * Shared Tencent billing-meter parsing for the CodeBuddy family
  * (`cb`, `cbcn`, `workbuddy`).
@@ -348,7 +350,7 @@ function enterpriseUsageUrl(resourceUrl: string): string {
 }
 
 function finiteNumber(value: unknown): number | undefined {
-  return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+  return sharedAsNumber(value);
 }
 
 /**

package/src/providers/integrations/buddy/capabilities.ts

@@ -1,3 +1,7 @@
+// dynamic-import-ok: lazy per-realm capability map. Each buddy regional
+// product (cb/cbcn/workbuddy/workbuddycn) imports its adapter + oauth +
+// discovery on first use so a deployment that only serves one realm never
+// drags the others into memory.
 import type { ProviderModuleCapabilities } from "../../provider-capabilities";
 import { oauthCapability, quotaCapability } from "../../provider-capabilities";
 

package/src/providers/integrations/buddy/codebuddy/cn-provider.ts

@@ -6,7 +6,7 @@
 // Headers: per-provider CodeBuddy headers (CLI identity for CN)
 // Payload: neutralize CN agent prompts, reasoning_summary auto only when reasoning_effort
 
-import { OpenAICompatibleAdapter } from "../../../adapters/compatible-adapter";
+import { BuddyMediaAdapter } from "../buddy-media";
 import type { ProviderDispatchContext, ProviderDispatchTarget, ProviderAdapter } from "../../../provider-contracts";
 import type { ModelDefinition } from "../../../provider-model-definition";
 import type { DiscoveryInput } from "../../../discovery/discovery-types";
@@ -16,7 +16,13 @@ import { providerBaseUrl } from "../../../provider-metadata";
 import {
   codebuddyAdapterConfig,
 } from "./shared";
-import { makeBuddyModel, type BuddyRawEntry } from "../buddy-catalog-shared";
+import { CODEBUDDY_SYSTEM_PROMPT } from "./provider";
+import {
+  BUDDY_CN_IMAGE_MODEL_ID_SET,
+  makeBuddyCnImageModels,
+  makeBuddyModel,
+  type BuddyRawEntry,
+} from "../buddy-catalog-shared";
 import { BUDDY_CN_MODELS_PATH, fetchBuddyDirectoryModels } from "../buddy-discovery-shared";
 import {
   buddyPrePayloadCommon,
@@ -100,59 +106,47 @@ export function codeBuddyCnPrePayload(
 // Exported because `buddyModelOutputLimit` searches every buddy raw table, and
 // a CN-only id would otherwise never get an output limit.
 export const CODEBUDDY_CN_RAW: readonly BuddyRawEntry[] = [
-  ["glm-5.1", "GLM 5.1", true, true, 200_000, 131_072],
-  ["glm-5.2", "GLM 5.2", true, true, 1_000_000, 131_072],
-  ["glm-5.3", "GLM 5.3", true, true, 1_000_000, 131_072],
+  ["glm-5.1", "GLM 5.1", true, true, 200_000, 48_000],
+  ["glm-5.2", "GLM 5.2", true, true, 1_000_000, 64_000],
+  ["glm-5.3", "GLM 5.3", true, true, 1_000_000, 64_000],
   ["glm-5.3-flash", "GLM 5.3 Flash", true, true, 1_000_000, 131_072],
-  ["glm-5v-turbo", "GLM 5v Turbo", true, true, 200_000, 131_072],
-  ["minimax-m3", "MiniMax M3", true, true, 512_000, 512_000],
+  ["glm-5v-turbo", "GLM 5v Turbo", true, true, 200_000, 64_000],
+  ["minimax-m3", "MiniMax M3", true, true, 512_000, 64_000],
   // 1M context, reasoning always on (upstream states both); vision inherited
   // from the M3 row, which is the same family.
-  ["minimax-m3.1-flash", "MiniMax M3.1 Flash", true, true, 1_000_000, 512_000],
-  ["mimo-v2.6-pro", "MiMo V2.6 Pro", true, true, 1_000_000, 512_000],
-  ["kimi-k2.8-preview", "Kimi K2.8 Preview", true, true, 1_048_576, 65_536],
-  ["kimi-k2.7", "Kimi K2.7", true, true, 256_000, 65_536],
-  ["kimi-k2.6", "Kimi K2.6", true, true, 256_000, 262_144],
-  ["kimi-k2.5", "Kimi K2.5", true, true, 164_000, 262_144],
-  ["kimi-k3.1-pro", "Kimi K3.1 Pro", true, true, 1_000_000, 64_000],
-  ["kimi-k3.1-pro-highspeed", "Kimi K3.1 Pro Highspeed", true, true, 1_000_000, 64_000],
+  ["minimax-m3.1-flash", "MiniMax M3.1 Flash", true, true, 1_000_000, 128_000],
+  ["mimo-v2.6-pro", "MiMo V2.6 Pro", true, true, 1_000_000, 128_000],
+  ["kimi-k2.8-preview", "Kimi K2.8 Preview", true, true, 1_000_000, 64_000],
+  ["kimi-k3.1-pro", "Kimi K3.1 Pro", true, true, 1_000_000, 32_000],
   ["hy3", "Hy3", true, true, 192_000, 64_000],
-  ["hy4-preview", "Hy4 Preview", true, true, 1_000_000, 64_000],
-  ["uto", "UTO", true, true, 256_000, 32_000],
+  ["hy4-preview", "Hy4 Preview", true, true, 960_000, 64_000],
   ["space-bunny", "Space Bunny", true, true, 1_000_000, 128_000],
   ["step-5-preview", "Step 5 Preview", true, true, 1_000_000, 64_000],
-  ["deepseek-v4-flash", "DeepSeek V4 Flash", true, true, 1_000_000, 384_000],
-  ["deepseek-v4-pro", "DeepSeek V4 Pro", true, true, 1_000_000, 384_000],
-  ["deepseek-v4.1-flash", "DeepSeek V4.1 Flash", true, true, 1_000_000, 384_000],
-  // ---- Legacy CN fallback ids (reference `DEFAULT_MODELS`) ------------------
-  // The reference's CN fallback table carries these and we did not. They are
-  // *fallback* rows: the reference has no static international roster at all, so
-  // an id appearing there means "there is a fallback value", not "the upstream
-  // serves it today". Limits below are the closest sibling's where the
-  // reference states none — unverified — confirm against a live account before
-  // trusting the numbers.
-  // unverified — confirm first: limits inherited from the sibling generation.
-  // `hy4-preview-x` is deliberately absent: the reference's fallback list has
-  // it, but a live CN CLI directory read does not publish it
-  // (`test/providers/buddy-model-catalog.test.ts`), and live discovery beats a
-  // fallback table.
-  ["hy3-x", "Hy3 X", true, true, 192_000, 64_000],
-  ["deepseek-v3-2-volc", "DeepSeek V3.2 Volc", true, true, 1_000_000, 384_000],
-  ["glm-5.0", "GLM 5.0", true, true, 200_000, 131_072],
-  ["glm-5.0-turbo", "GLM 5.0 Turbo", true, true, 200_000, 131_072],
-  ["glm-4.7", "GLM 4.7", true, true, 200_000, 131_072],
-  ["glm-4.6", "GLM 4.6", true, true, 200_000, 131_072],
-  ["glm-4.6v", "GLM 4.6V", true, true, 200_000, 131_072],
-  ["minimax-m2.7", "MiniMax M2.7", true, true, 512_000, 512_000],
-  ["minimax-m2.5", "MiniMax M2.5", true, true, 512_000, 512_000],
-  ["kimi-k2-thinking", "Kimi K2 Thinking", true, true, 256_000, 65_536],
-  ["hunyuan-chat", "Hunyuan Chat", true, true, 256_000, 32_000],
-  // `default` is the CN backend-selected id, the CN counterpart of the intl
-  // `default-model`. Limits are the conservative floor of the roster.
-  // unverified — confirm first.
-  ["default", "Default", true, true, 200_000, 32_000],
+  ["deepseek-v4-pro", "DeepSeek V4 Pro", true, true, 1_000_000, 128_000],
+  ["deepseek-v4.1-flash", "DeepSeek V4.1 Flash", true, true, 1_000_000, 128_000],
+  // Live on the CN roster but absent here, so a request for it resolved to
+  // nothing. Limits as published by /v3/config.
+  ["kimi-k3-1", "Kimi K3-1", true, true, 1_000_000, 32_000],
+  ["minimax-m2.7", "MiniMax M2.7", true, true, 200_000, 48_000],
+];
+/**
+ * CN's image-generation rows (`hunyuan-image-alpha`).
+ *
+ * Reached through `/images/generations` like the international rows. The image
+ * ids are filtered out of the chat pass so one id never appears under two
+ * service kinds, matching how the intl catalog does it.
+ */
+export const CODEBUDDY_CN_IMAGE_MODELS: readonly ModelDefinition[] = makeBuddyCnImageModels(
+  CODEBUDDY_CN_PROVIDER_ID,
+  "/images/generations",
+);
+
+export const CODEBUDDY_CN_MODELS: readonly ModelDefinition[] = [
+  ...CODEBUDDY_CN_RAW.filter((entry) => !BUDDY_CN_IMAGE_MODEL_ID_SET.has(entry[0])).map((entry) =>
+    makeBuddyModel(entry, CODEBUDDY_CN_PROVIDER_ID, undefined, "cn"),
+  ),
+  ...CODEBUDDY_CN_IMAGE_MODELS,
 ];
-export const CODEBUDDY_CN_MODELS: readonly ModelDefinition[] = CODEBUDDY_CN_RAW.map((entry) => makeBuddyModel(entry, "cbcn", undefined, "cn"));
 
 /** Reads the CodeBuddy CN console directory (same envelope as the intl site). */
 export async function discoverCodeBuddyCnModels(
@@ -172,7 +166,10 @@ export async function discoverCodeBuddyCnModels(
 // Public factory
 
 export function createCodeBuddyCnAdapter(fetchImpl?: typeof fetch): ProviderAdapter {
-  return new OpenAICompatibleAdapter(
+  // BuddyMediaAdapter, not OpenAICompatibleAdapter: the CN realm publishes an
+  // image-generation row, and the plain compatible adapter has no image path,
+  // so `hunyuan-image-alpha` would route to /chat/completions and fail.
+  return new BuddyMediaAdapter(
     codebuddyAdapterConfig({
       providerId: CODEBUDDY_CN_PROVIDER_ID,
       baseUrl: CODEBUDDY_CN_BASE_URL,
@@ -180,5 +177,16 @@ export function createCodeBuddyCnAdapter(fetchImpl?: typeof fetch): ProviderAdap
       prePayload: codeBuddyCnPrePayload,
       ...(fetchImpl ? { fetchImpl } : {}),
     }),
+    {
+      variant: "CLI",
+      // The CN realm has no separate system prompt of its own; the neutral CN
+      // prompt is applied by `codeBuddyCnPrePayload`, so the media config
+      // reuses the intl one purely to satisfy the required field. Image
+      // generation sends a prompt, not a conversation, so this turn is
+      // discarded by the image path in every case.
+      systemPrompt: CODEBUDDY_SYSTEM_PROMPT,
+      baseUrl: CODEBUDDY_CN_BASE_URL,
+      imageGenerationPath: "/images/generations",
+    },
   );
 }

package/src/providers/integrations/buddy/codebuddy/provider.ts

@@ -1,180 +1,180 @@
-// CodeBuddy International adapter — exact provider contract.
-// Canonical provider ID: cb
-// Base (manifest-owned CODEBUDDY_BASE_URL) → Chat: base + /chat/completions
-// Auth: Authorization Bearer for both api_key and oauth
-// Stream: force stream=true upstream, factory reaggregates for non-stream callers
-// Headers: per-provider CodeBuddy headers with fresh correlation IDs per dispatch
-// Payload: leading CodeBuddy system prompt + typed user content, reasoning_summary auto only when reasoning_effort
-
-import { BuddyMediaAdapter } from "../buddy-media";
-import type { ProviderDispatchContext, ProviderDispatchTarget, ProviderAdapter } from "../../../provider-contracts";
-import type { ModelDefinition } from "../../../provider-model-definition";
-import type { DiscoveryInput } from "../../../discovery/discovery-types";
-import { GatewayError } from "../../../../protocol/gateway-error";
-import type { CanonicalRequest } from "../../../../protocol/canonical-model";
-import { providerBaseUrl } from "../../../provider-metadata";
-import {
-  codebuddyAdapterConfig,
-  codebuddyHeaders,
-} from "./shared";
-import {
-  BUDDY_SHARED_RAW,
-  BUDDY_IMAGE_MODEL_ID_SET,
-  BUDDY_VIDEO_MODEL_ID_SET,
-  makeBuddyModel,
-  makeBuddyImageModels,
-  makeBuddyVideoModels,
-  type BuddyRawEntry,
-} from "../buddy-catalog-shared";
-import { BUDDY_INTL_MODELS_PATH, fetchBuddyDirectoryModels } from "../buddy-discovery-shared";
-import {
-  applyBuddySystemPrompt,
-  buddyPrePayloadCommon,
-  normalizeBuddyToolNames,
-} from "../buddy-chat-shared";
-
-
-// Constants — public contract
-export const CODEBUDDY_PROVIDER_ID = "cb" as const;
-export const CODEBUDDY_BASE_URL = providerBaseUrl("cb");
-// Upstream model translation — preserve provider mapping
-
-// Payload hook — provider intl semantics
-// - force stream=true
-// - reasoning_summary auto only when reasoning_effort requested
-// - upstreamId translation
-// - leading CodeBuddy system prompt + typed user content normalization
-
-/**
- * Leading system turn for this variant.
- *
- * The upstream validates that the wire *opens* with a `system` turn (code
- * `11128`) but does not check its text — the CN variant installs a plain
- * engineering-assistant sentence in the same slot and the gateway accepts it.
- * So this text is a product choice rather than a wire contract, and the
- * previous vendor-branded line ("You are CodeBuddy Code.") made every request
- * claim an identity the caller never chose, while also discarding whatever
- * system prompt the caller actually sent.
- *
- * The prompt is therefore a neutral assistant identity with an explicit
- * persona: pragmatic, direct, and honest — no sycophancy, no hedging, no
- * invented certainty.
- */
-export const CODEBUDDY_SYSTEM_PROMPT =
-  "You are a pragmatic and direct software engineering assistant. " +
-  "Be honest and truthful: state what you know, say plainly when you are unsure " +
-  "or do not know, and never claim to have done something you have not done. " +
-  "Prefer concrete answers over filler, and say so when a request is ambiguous " +
-  "instead of guessing silently.";
-
-function codeBuddyIntlPrePayload(
-  payload: Record<string, unknown>,
-  request: CanonicalRequest,
-  candidate: ProviderDispatchTarget,
-  context?: ProviderDispatchContext,
-): void {
-  // International ladder: DeepSeek Flash and friends serve only `high`.
-  buddyPrePayloadCommon(payload, request, "intl", context);
-  const rawModel = payload["model"];
-  const source =
-    typeof rawModel === "string" && rawModel.length > 0
-      ? rawModel
-      : candidate.model_id;
-  if (!source) throw new GatewayError("invalid_request", 400, "CodeBuddy model is required");
-  const messages = payload["messages"];
-  if (Array.isArray(messages)) {
-    applyBuddySystemPrompt(messages as Array<Record<string, unknown>>, CODEBUDDY_SYSTEM_PROMPT);
-  }
-  normalizeBuddyToolNames(payload);
-  void request;
-}
-
-// Model catalog — shared CodeBuddy / WorkBuddy international roster
-
-const CODEBUDDY_INTL_RAW: readonly BuddyRawEntry[] = BUDDY_SHARED_RAW;
-
-/**
- * CodeBuddy's image generation rows.
- *
- * These ids also sit on the shared chat roster as ordinary `llm` rows, which is
- * why they were unreachable as image models: nothing downstream could tell a
- * chat model from one that returns an image, so `mediaGeneration` was false for
- * every catalog row. The roster and the declared capabilities come from
- * {@link makeBuddyImageModels} so cb and WorkBuddy cannot drift.
- */
-export const CODEBUDDY_IMAGE_MODELS: readonly ModelDefinition[] = makeBuddyImageModels(
-  "cb",
-  "/images/generations",
-);
-
-/**
- * CodeBuddy's video-generation rows (`seedance-2.5`).
- *
- * Reached through `/videos/generations` on the `/v2` base, so the endpoint is
- * the upstream video path rather than a chat-completions path.
- */
-export const CODEBUDDY_VIDEO_MODELS: readonly ModelDefinition[] = makeBuddyVideoModels(
-  "cb",
-  "/videos/generations",
-);
-
-/**
- * The full cb catalog the registry loads: chat roster plus image and video rows.
- *
- * The image and video ids are filtered out of the chat pass so one id never
- * appears under two service kinds. Exported as a single list so
- * `default-registry.ts` keeps one import for this provider.
- */
-export const CODEBUDDY_MODELS: readonly ModelDefinition[] = [
-  ...CODEBUDDY_INTL_RAW.filter(
-    (entry) => !BUDDY_IMAGE_MODEL_ID_SET.has(entry[0]) && !BUDDY_VIDEO_MODEL_ID_SET.has(entry[0]),
-  ).map((entry) => makeBuddyModel(entry, "cb")),
-  ...CODEBUDDY_IMAGE_MODELS,
-  ...CODEBUDDY_VIDEO_MODELS,
-];
-
-/**
- * Reads the CodeBuddy intl console directory.
- *
- * The static `CODEBUDDY_MODELS` above stays the fallback — this console is
- * documented to answer 500 intermittently — while discovery carries the
- * upstream's own limits and capability flags.
- */
-export async function discoverCodeBuddyModels(
-  input: DiscoveryInput,
-): Promise<readonly ModelDefinition[] | null> {
-  return fetchBuddyDirectoryModels({
-    siteUrl: CODEBUDDY_BASE_URL,
-    providerId: CODEBUDDY_PROVIDER_ID,
-    credential: input.credential,
-    modelsPath: BUDDY_INTL_MODELS_PATH,
-    endpoint: undefined,
-    ...(input.signal ? { signal: input.signal } : {}),
-    ...(input.fetcher ? { fetcher: input.fetcher } : {}),
-  });
-}
-
-// Public factory — uses OpenAI-compatible factory but forces provider semantics
-// Supports both api_key and oauth via Authorization Bearer (factory handles both)
-
-export function createCodeBuddyAdapter(fetchImpl?: typeof fetch): ProviderAdapter {
-  return new BuddyMediaAdapter(
-    codebuddyAdapterConfig({
-      providerId: CODEBUDDY_PROVIDER_ID,
-      baseUrl: CODEBUDDY_BASE_URL,
-      variant: "IDE",
-      cliIdentity: true,
-      prePayload: codeBuddyIntlPrePayload,
-      ...(fetchImpl ? { fetchImpl } : {}),
-    }),
-    {
-      variant: "IDE",
-      // BuddyMediaConfig has no `cliIdentity`; the CLI identity is selected by
-      // supplying the builder that takes it.
-      buildHeaders: (context, request) => codebuddyHeaders("IDE", context, request, true),
-      systemPrompt: CODEBUDDY_SYSTEM_PROMPT,
-      baseUrl: CODEBUDDY_BASE_URL,
-      imageGenerationPath: "/images/generations",
-    },
-  );
-}
+// CodeBuddy International adapter — exact provider contract.
+// Canonical provider ID: cb
+// Base (manifest-owned CODEBUDDY_BASE_URL) → Chat: base + /chat/completions
+// Auth: Authorization Bearer for both api_key and oauth
+// Stream: force stream=true upstream, factory reaggregates for non-stream callers
+// Headers: per-provider CodeBuddy headers with fresh correlation IDs per dispatch
+// Payload: leading CodeBuddy system prompt + typed user content, reasoning_summary auto only when reasoning_effort
+
+import { BuddyMediaAdapter } from "../buddy-media";
+import type { ProviderDispatchContext, ProviderDispatchTarget, ProviderAdapter } from "../../../provider-contracts";
+import type { ModelDefinition } from "../../../provider-model-definition";
+import type { DiscoveryInput } from "../../../discovery/discovery-types";
+import { GatewayError } from "../../../../protocol/gateway-error";
+import type { CanonicalRequest } from "../../../../protocol/canonical-model";
+import { providerBaseUrl } from "../../../provider-metadata";
+import {
+  codebuddyAdapterConfig,
+  codebuddyHeaders,
+} from "./shared";
+import {
+  BUDDY_SHARED_RAW,
+  BUDDY_IMAGE_MODEL_ID_SET,
+  BUDDY_VIDEO_MODEL_ID_SET,
+  makeBuddyModel,
+  makeBuddyImageModels,
+  makeBuddyVideoModels,
+  type BuddyRawEntry,
+} from "../buddy-catalog-shared";
+import { BUDDY_INTL_MODELS_PATH, fetchBuddyDirectoryModels } from "../buddy-discovery-shared";
+import {
+  applyBuddySystemPrompt,
+  buddyPrePayloadCommon,
+  normalizeBuddyToolNames,
+} from "../buddy-chat-shared";
+
+
+// Constants — public contract
+export const CODEBUDDY_PROVIDER_ID = "cb" as const;
+export const CODEBUDDY_BASE_URL = providerBaseUrl("cb");
+// Upstream model translation — preserve provider mapping
+
+// Payload hook — provider intl semantics
+// - force stream=true
+// - reasoning_summary auto only when reasoning_effort requested
+// - upstreamId translation
+// - leading CodeBuddy system prompt + typed user content normalization
+
+/**
+ * Leading system turn for this variant.
+ *
+ * The upstream validates that the wire *opens* with a `system` turn (code
+ * `11128`) but does not check its text — the CN variant installs a plain
+ * engineering-assistant sentence in the same slot and the gateway accepts it.
+ * So this text is a product choice rather than a wire contract, and the
+ * previous vendor-branded line ("You are CodeBuddy Code.") made every request
+ * claim an identity the caller never chose, while also discarding whatever
+ * system prompt the caller actually sent.
+ *
+ * The prompt is therefore a neutral assistant identity with an explicit
+ * persona: pragmatic, direct, and honest — no sycophancy, no hedging, no
+ * invented certainty.
+ */
+export const CODEBUDDY_SYSTEM_PROMPT =
+  "You are a pragmatic and direct software engineering assistant. " +
+  "Be honest and truthful: state what you know, say plainly when you are unsure " +
+  "or do not know, and never claim to have done something you have not done. " +
+  "Prefer concrete answers over filler, and say so when a request is ambiguous " +
+  "instead of guessing silently.";
+
+function codeBuddyIntlPrePayload(
+  payload: Record<string, unknown>,
+  request: CanonicalRequest,
+  candidate: ProviderDispatchTarget,
+  context?: ProviderDispatchContext,
+): void {
+  // International ladder: DeepSeek Flash and friends serve only `high`.
+  buddyPrePayloadCommon(payload, request, "intl", context);
+  const rawModel = payload["model"];
+  const source =
+    typeof rawModel === "string" && rawModel.length > 0
+      ? rawModel
+      : candidate.model_id;
+  if (!source) throw new GatewayError("invalid_request", 400, "CodeBuddy model is required");
+  const messages = payload["messages"];
+  if (Array.isArray(messages)) {
+    applyBuddySystemPrompt(messages as Array<Record<string, unknown>>, CODEBUDDY_SYSTEM_PROMPT);
+  }
+  normalizeBuddyToolNames(payload);
+  void request;
+}
+
+// Model catalog — shared CodeBuddy / WorkBuddy international roster
+
+const CODEBUDDY_INTL_RAW: readonly BuddyRawEntry[] = BUDDY_SHARED_RAW;
+
+/**
+ * CodeBuddy's image generation rows.
+ *
+ * These ids also sit on the shared chat roster as ordinary `llm` rows, which is
+ * why they were unreachable as image models: nothing downstream could tell a
+ * chat model from one that returns an image, so `mediaGeneration` was false for
+ * every catalog row. The roster and the declared capabilities come from
+ * {@link makeBuddyImageModels} so cb and WorkBuddy cannot drift.
+ */
+export const CODEBUDDY_IMAGE_MODELS: readonly ModelDefinition[] = makeBuddyImageModels(
+  "cb",
+  "/images/generations",
+);
+
+/**
+ * CodeBuddy's video-generation rows (`seedance-2.5`).
+ *
+ * Reached through `/videos/generations` on the `/v2` base, so the endpoint is
+ * the upstream video path rather than a chat-completions path.
+ */
+export const CODEBUDDY_VIDEO_MODELS: readonly ModelDefinition[] = makeBuddyVideoModels(
+  "cb",
+  "/videos/generations",
+);
+
+/**
+ * The full cb catalog the registry loads: chat roster plus image and video rows.
+ *
+ * The image and video ids are filtered out of the chat pass so one id never
+ * appears under two service kinds. Exported as a single list so
+ * `default-registry.ts` keeps one import for this provider.
+ */
+export const CODEBUDDY_MODELS: readonly ModelDefinition[] = [
+  ...CODEBUDDY_INTL_RAW.filter(
+    (entry) => !BUDDY_IMAGE_MODEL_ID_SET.has(entry[0]) && !BUDDY_VIDEO_MODEL_ID_SET.has(entry[0]),
+  ).map((entry) => makeBuddyModel(entry, "cb")),
+  ...CODEBUDDY_IMAGE_MODELS,
+  ...CODEBUDDY_VIDEO_MODELS,
+];
+
+/**
+ * Reads the CodeBuddy intl console directory.
+ *
+ * The static `CODEBUDDY_MODELS` above stays the fallback — this console is
+ * documented to answer 500 intermittently — while discovery carries the
+ * upstream's own limits and capability flags.
+ */
+export async function discoverCodeBuddyModels(
+  input: DiscoveryInput,
+): Promise<readonly ModelDefinition[] | null> {
+  return fetchBuddyDirectoryModels({
+    siteUrl: CODEBUDDY_BASE_URL,
+    providerId: CODEBUDDY_PROVIDER_ID,
+    credential: input.credential,
+    modelsPath: BUDDY_INTL_MODELS_PATH,
+    endpoint: undefined,
+    ...(input.signal ? { signal: input.signal } : {}),
+    ...(input.fetcher ? { fetcher: input.fetcher } : {}),
+  });
+}
+
+// Public factory — uses OpenAI-compatible factory but forces provider semantics
+// Supports both api_key and oauth via Authorization Bearer (factory handles both)
+
+export function createCodeBuddyAdapter(fetchImpl?: typeof fetch): ProviderAdapter {
+  return new BuddyMediaAdapter(
+    codebuddyAdapterConfig({
+      providerId: CODEBUDDY_PROVIDER_ID,
+      baseUrl: CODEBUDDY_BASE_URL,
+      variant: "IDE",
+      cliIdentity: true,
+      prePayload: codeBuddyIntlPrePayload,
+      ...(fetchImpl ? { fetchImpl } : {}),
+    }),
+    {
+      variant: "IDE",
+      // BuddyMediaConfig has no `cliIdentity`; the CLI identity is selected by
+      // supplying the builder that takes it.
+      buildHeaders: (context, request) => codebuddyHeaders("IDE", context, request, true),
+      systemPrompt: CODEBUDDY_SYSTEM_PROMPT,
+      baseUrl: CODEBUDDY_BASE_URL,
+      imageGenerationPath: "/images/generations",
+    },
+  );
+}