@iislee/opencodex 2.11.0 → 2.31.0

package/src/adapters/command-code.ts

@@ -0,0 +1,601 @@
+import { randomUUID } from "node:crypto";
+import { execFile as execFileCallback } from "node:child_process";
+import { promisify } from "node:util";
+import { opendir } from "node:fs/promises";
+import type { AdapterEvent, OcxContentPart, OcxMessage, OcxParsedRequest, OcxProviderConfig, OcxTool, OcxUsage } from "../types";
+import { isAllowedToolChoice, namespacedToolName, resolveToolChoiceWireName, toolAllowedByChoice } from "../types";
+import type { AdapterFetchContext, AdapterRequest, ProviderAdapter } from "./base";
+import type { TranslatorBudget } from "../lib/translator-budget";
+import { readBoundedResponseBody } from "../lib/bounded-body";
+import { configuredReasoningEfforts } from "../reasoning-effort";
+import { commandCodeReasoningEfforts, refreshCommandCodeReasoningEfforts } from "../providers/command-code-efforts";
+import { identifyRoutedModel } from "./identity";
+import { buildNonOpenAIToolCatalogNudgeForTools } from "./tool-catalog-nudge";
+import { parseDataUrl } from "./image";
+
+// Retain the short ids emitted by the first local integration. New requests use the live catalog's
+// provider-native IDs directly; this map is compatibility-only and is not a model fallback list.
+const COMMAND_CODE_MODEL_ALIASES: Readonly<Record<string, string>> = {
+  "deepseek-v4-flash": "deepseek/deepseek-v4-flash",
+  "kimi-k3": "moonshotai/Kimi-K3",
+  "glm-5.3": "zai-org/GLM-5.3",
+  "glm-5.2": "zai-org/GLM-5.2",
+};
+
+function canonicalCommandCodeModelId(modelId: string): string {
+  return Object.hasOwn(COMMAND_CODE_MODEL_ALIASES, modelId) ? COMMAND_CODE_MODEL_ALIASES[modelId]! : modelId;
+}
+
+/** Flatten tool-result content for the text-only wire output, keeping an `[image]` marker per image part in content order. */
+function toolResultText(content: string | OcxContentPart[]): string {
+  if (typeof content === "string") return content;
+  return content.map(part => (part.type === "text" ? part.text : "[image]")).join("");
+}
+
+/** Best-effort media type from a remote https URL extension, e.g. image/png. */
+function mediaTypeFromUrl(url: string): string | undefined {
+  const ext = url.split(/[?#]/)[0]!.match(/\.([a-zA-Z0-9]+)$/)?.[1]?.toLowerCase();
+  if (!ext) return undefined;
+  const known: Record<string, string> = {
+    png: "image/png", jpg: "image/jpeg", jpeg: "image/jpeg", gif: "image/gif", webp: "image/webp", bmp: "image/bmp",
+  };
+  return known[ext];
+}
+
+/** Wire image part: `{ type, image, mediaType? }` per the /alpha/generate ModelMessage schema. */
+function wireImagePart(imageUrl: string): Record<string, unknown> {
+  const parsed = parseDataUrl(imageUrl);
+  const mediaType = parsed?.mediaType ?? mediaTypeFromUrl(imageUrl);
+  return { type: "image", image: imageUrl, ...(mediaType ? { mediaType } : {}) };
+}
+
+/**
+ * The /alpha/generate wire pairs every assistant `tool-call` with a following `tool` message
+ * whose `tool-result.toolCallId` matches it. Codex history is not guaranteed to carry that
+ * pairing (interrupted turns, compacted threads, and multi-step tool rounds all can leave an
+ * assistant call with no recorded result), and the upstream rejects an unpaired call with
+ * `Tool result is missing for tool call <id>`, which currently surfaces as a generic 502
+ * (#1383). This builder keeps the pairing invariant:
+ *
+ * - a `toolResult` that matches a declared assistant call emits the native `tool-result`;
+ * - a `toolResult` with no matching declared call degrades to a text carrier so the model
+ *   still sees the outcome without a 400-prone standalone `tool` message;
+ * - every declared assistant call that never received a result gets an explicit error
+ *   `tool-result`, so the upstream never sees an unpaired call.
+ */
+function wireMessages(messages: OcxMessage[]): Array<Record<string, unknown>> {
+  const out: Array<Record<string, unknown>> = [];
+  const pendingCalls: Array<{ id: string; name: string }> = [];
+  // Image parts returned by a tool cannot live inside the text-only `tool-result` wire
+  // output. They ride a follow-up user message, but that user message must not break the
+  // adjacency of the assistant turn's tool results, so carriers are buffered and flushed
+  // only after every declared call has its native or synthesized result.
+  const pendingImageCarriers: Array<Record<string, unknown>> = [];
+  // The /alpha/generate wire requires every assistant tool-call to be closed by a matching
+  // `tool-result` immediately after the declaring assistant message. Close any declared call
+  // that never received a result before a non-toolResult message moves the turn forward, so a
+  // synthesized `tool` message never lands after a user message or a new assistant turn.
+  const closePendingCalls = (): void => {
+    for (const call of pendingCalls) {
+      out.push({ role: "tool", content: [{
+        type: "tool-result",
+        toolCallId: call.id,
+        toolName: call.name,
+        output: { type: "error-text", value: "[ocx] no tool result was recorded for this tool call; execution status unknown." },
+      }] });
+    }
+    pendingCalls.length = 0;
+    if (pendingImageCarriers.length > 0) {
+      out.push(...pendingImageCarriers);
+      pendingImageCarriers.length = 0;
+    }
+  };
+  for (const message of messages) {
+    if (message.role === "assistant") {
+      closePendingCalls();
+      const content: Array<Record<string, unknown>> = [];
+      for (const part of message.content) {
+        if (part.type === "text") content.push({ type: "text", text: part.text });
+        else if (part.type === "thinking") content.push({ type: "reasoning", text: part.thinking });
+        else {
+          const wireName = namespacedToolName(part.namespace, part.name);
+          content.push({ type: "tool-call", toolCallId: part.id, toolName: wireName, input: part.arguments });
+          pendingCalls.push({ id: part.id, name: wireName });
+        }
+      }
+      out.push({ role: "assistant", content });
+      continue;
+    }
+    if (message.role === "toolResult") {
+      const callIndex = pendingCalls.findIndex(call => call.id === message.toolCallId);
+      const paired = callIndex >= 0;
+      if (paired) pendingCalls.splice(callIndex, 1);
+      if (!paired) {
+        // Pending calls from an earlier assistant turn must still be closed before any user
+        // message lands, or their synthesized results would follow the orphan carrier.
+        closePendingCalls();
+        // The upstream rejects a standalone tool message whose call was never declared by an
+        // assistant turn. Preserve the outcome as text so the model can still act on it.
+        const label = message.toolName ? `${message.toolName} (${message.toolCallId})` : message.toolCallId;
+        const text = toolResultText(message.content);
+        // The orphan result cannot ride a `tool` message; carry it in a user message instead.
+        out.push({ role: "user", content: [{ type: "text", text: `[tool result without adjacent tool call: ${label}]\n${text}` }] });
+        continue;
+      }
+      out.push({ role: "tool", content: [{
+        type: "tool-result",
+        toolCallId: message.toolCallId,
+        toolName: namespacedToolName(message.toolNamespace, message.toolName),
+        output: { type: message.isError ? "error-text" : "text", value: toolResultText(message.content) },
+      }] });
+      // The proprietary wire's tool-result output is text-only; image parts returned by a
+      // tool (e.g. Codex view_image) cannot live inside it. Carry them in a follow-up user
+      // message using the same image encoding as the user branch so the bytes reach the model.
+      const images = typeof message.content === "string" ? [] : message.content.filter(part => part.type === "image");
+      if (images.length > 0) {
+        pendingImageCarriers.push({ role: "user", content: images.map(part => wireImagePart((part as { imageUrl: string }).imageUrl)) });
+      }
+      continue;
+    }
+    // User/developer message: no pending tool results may follow it on the wire.
+    closePendingCalls();
+    const content: Array<Record<string, unknown>> = [];
+    if (typeof message.content === "string") content.push({ type: "text", text: message.content });
+    else for (const part of message.content) {
+      if (part.type === "text") content.push({ type: "text", text: part.text });
+      else content.push(wireImagePart(part.imageUrl));
+    }
+    out.push({ role: "user", content });
+  }
+  closePendingCalls();
+  return out;
+}
+
+function visibleTools(parsed: OcxParsedRequest): OcxTool[] {
+  const choice = parsed.options.toolChoice;
+  if (choice === "none") return [];
+  const tools = parsed.context.tools ?? [];
+  if (isAllowedToolChoice(choice)) {
+    const allowed = new Set(choice.allowedTools);
+    return tools.filter(tool => toolAllowedByChoice(tool, allowed, tools));
+  }
+  if (choice && typeof choice !== "string") {
+    const selected = resolveToolChoiceWireName(tools, choice.name);
+    return tools.filter(tool => namespacedToolName(tool.namespace, tool.name) === selected);
+  }
+  return tools;
+}
+
+function toolChoiceInstruction(parsed: OcxParsedRequest): string | undefined {
+  const choice = parsed.options.toolChoice;
+  if (choice === "required" || (isAllowedToolChoice(choice) && choice.mode === "required")) {
+    return "Tool choice is required for this turn. Make at least one call from the advertised tool catalog before answering.";
+  }
+  if (choice && typeof choice !== "string" && !isAllowedToolChoice(choice)) {
+    // Resolve the forced name (bare, namespace__name, or namespace.name) to the advertised
+    // wire name so the instruction names a tool that is actually in the catalog.
+    const wireName = resolveToolChoiceWireName(parsed.context.tools, choice.name);
+    return `Tool choice is required for this turn. Call the advertised tool named ${wireName} before answering.`;
+  }
+  return undefined;
+}
+
+function wireTools(tools: OcxTool[]): Array<Record<string, unknown>> {
+  return tools.map(tool => ({
+    name: namespacedToolName(tool.namespace, tool.name),
+    description: tool.description,
+    input_schema: tool.parameters,
+  }));
+}
+
+function currentWorkingDirectory(): string | undefined {
+  try { return process.cwd(); } catch { return undefined; }
+}
+
+/** Cap the workspace listing so a large directory does not ship every entry name upstream. */
+const MAX_WORKSPACE_STRUCTURE_ENTRIES = 64;
+/** Cap how many recent commit subjects the config carries. */
+const MAX_RECENT_COMMITS = 8;
+/** Cap each recent commit entry to keep the request bounded even for long subjects. */
+const MAX_RECENT_COMMIT_LENGTH = 512;
+/** Cap the git status text sent upstream. */
+const MAX_GIT_STATUS_LENGTH = 2048;
+/** Keep collected workspace/git metadata fresh for this long (ms) so repeated requests reuse it. */
+const WORKSPACE_METADATA_TTL_MS = 30_000;
+/** Hard cap on cached workspace metadata entries to prevent unbounded growth across distinct cwds. */
+export const MAX_WORKSPACE_METADATA_ENTRIES = 128;
+
+/** Derive a bounded project slug from the working directory for the `x-project-slug` header. */
+function projectSlug(cwd: string): string {
+  return cwd.replace(/[^a-zA-Z0-9]+/g, "-").replace(/^-|-$/g, "").toLowerCase().slice(0, 64) || "workspace";
+}
+
+interface GitWorkspaceInfo {
+  isGitRepo: boolean;
+  currentBranch: string;
+  mainBranch: string;
+  gitStatus: string;
+  recentCommits: string[];
+}
+
+export const workspaceMetadataCache = new Map<string, { collectedAt: number; value: GitWorkspaceInfo }>();
+
+/**
+ * Evict expired entries first, then the oldest live entry if at capacity.
+ * Called before inserting a new key so the cache never exceeds the cap.
+ */
+export function pruneWorkspaceMetadataCache(now: number): void {
+  // Pass 1: remove expired entries.
+  for (const [key, entry] of workspaceMetadataCache) {
+    if (now - entry.collectedAt >= WORKSPACE_METADATA_TTL_MS) {
+      workspaceMetadataCache.delete(key);
+    }
+  }
+  // Pass 2: if still at capacity, evict the oldest live entry.
+  if (workspaceMetadataCache.size >= MAX_WORKSPACE_METADATA_ENTRIES) {
+    let oldestKey: string | null = null;
+    let oldestAt = Infinity;
+    for (const [key, entry] of workspaceMetadataCache) {
+      if (entry.collectedAt < oldestAt) {
+        oldestAt = entry.collectedAt;
+        oldestKey = key;
+      }
+    }
+    if (oldestKey !== null) workspaceMetadataCache.delete(oldestKey);
+  }
+}
+
+const execFile = promisify(execFileCallback);
+
+/** Best-effort git metadata for the upstream config contract; every read fails safe and stays off the event loop. */
+async function gitWorkspaceInfo(cwd: string | undefined): Promise<GitWorkspaceInfo> {
+  const fallback: GitWorkspaceInfo = { isGitRepo: false, currentBranch: "", mainBranch: "", gitStatus: "", recentCommits: [] };
+  if (!cwd) return fallback;
+  const cached = workspaceMetadataCache.get(cwd);
+  if (cached && Date.now() - cached.collectedAt < WORKSPACE_METADATA_TTL_MS) return cached.value;
+  const run = async (args: string[]): Promise<string> => {
+    try {
+      const { stdout } = await execFile("git", args, { cwd, encoding: "utf8", timeout: 2000, windowsHide: true });
+      return stdout.trim();
+    } catch {
+      return "";
+    }
+  };
+  const root = await run(["rev-parse", "--show-toplevel"]);
+  const value = root
+    ? {
+        isGitRepo: true,
+        currentBranch: (await run(["rev-parse", "--abbrev-ref", "HEAD"])) || "HEAD",
+        mainBranch: (await run(["symbolic-ref", "--short", "refs/remotes/origin/HEAD"])).replace(/^origin\//, "") || (await run(["rev-parse", "--abbrev-ref", "HEAD"])) || "",
+        gitStatus: (await run(["status", "--porcelain"])).slice(0, MAX_GIT_STATUS_LENGTH),
+        recentCommits: (await run(["log", "--oneline", `-${MAX_RECENT_COMMITS}`]))
+          .split("\n")
+          .filter(Boolean)
+          .slice(0, MAX_RECENT_COMMITS)
+          .map(commit => commit.slice(0, MAX_RECENT_COMMIT_LENGTH)),
+      }
+    : fallback;
+  const now = Date.now();
+  if (!workspaceMetadataCache.has(cwd)) pruneWorkspaceMetadataCache(now);
+  workspaceMetadataCache.set(cwd, { collectedAt: now, value });
+  return value;
+}
+
+async function commandCodeConfig(cwd: string | undefined): Promise<Record<string, unknown>> {
+  let structure: string[] = [];
+  if (cwd) {
+    try {
+      // Iterate and stop after the cap instead of materializing every entry: a directory with a
+      // huge number of names must not stall the request path for 64 metadata rows.
+      const dir = await opendir(cwd);
+      try {
+        for await (const entry of dir) {
+          if (entry.name.startsWith(".")) continue;
+          structure.push(entry.name);
+          if (structure.length >= MAX_WORKSPACE_STRUCTURE_ENTRIES) break;
+        }
+      } finally {
+        await dir.close().catch(() => undefined);
+      }
+    } catch { /* workspace metadata is optional */ }
+  }
+  const git = await gitWorkspaceInfo(cwd);
+  return {
+    ...(cwd ? { workingDir: cwd } : {}),
+    date: new Date().toISOString().slice(0, 10),
+    environment: process.platform,
+    structure,
+    ...git,
+  };
+}
+
+function usage(value: unknown): OcxUsage | undefined {
+  if (!value || typeof value !== "object" || Array.isArray(value)) return undefined;
+  const row = value as Record<string, unknown>;
+  const inputTokens = typeof row.inputTokens === "number" ? row.inputTokens : 0;
+  const outputTokens = typeof row.outputTokens === "number" ? row.outputTokens : 0;
+  const details = row.inputTokenDetails && typeof row.inputTokenDetails === "object" && !Array.isArray(row.inputTokenDetails)
+    ? row.inputTokenDetails as Record<string, unknown> : {};
+  const cachedInputTokens = typeof details.cacheReadTokens === "number" ? details.cacheReadTokens : undefined;
+  const cacheCreationInputTokens = typeof details.cacheWriteTokens === "number" ? details.cacheWriteTokens : undefined;
+  return {
+    inputTokens, outputTokens, totalTokens: inputTokens + outputTokens,
+    ...(cachedInputTokens !== undefined ? { cachedInputTokens, cacheReadInputTokens: cachedInputTokens } : {}),
+    ...(cacheCreationInputTokens !== undefined ? { cacheCreationInputTokens } : {}),
+  };
+}
+
+function eventError(value: unknown): string {
+  if (typeof value === "string" && value) return value;
+  if (value && typeof value === "object" && !Array.isArray(value)) {
+    const message = (value as Record<string, unknown>).message;
+    if (typeof message === "string" && message) return message;
+  }
+  return "Command Code stream error";
+}
+
+/**
+ * True when the upstream rejected a tool-result continuation because an assistant tool call
+ * had no matching result (`Tool result is missing for tool call <id>`). The proxy now keeps
+ * that pairing invariant before sending, so this error is a distinct provider-side
+ * validation failure rather than a generic stream fault; classify it as such for the
+ * dashboard/logs instead of a plain upstream 502.
+ */
+function isMissingToolResultError(value: unknown): boolean {
+  const text = eventError(value).toLowerCase();
+  return text.includes("tool result is missing") || text.includes("tool_result is missing");
+}
+
+async function*ndjson(response: Response, budget: TranslatorBudget): AsyncGenerator<Record<string, unknown>> {
+  if (!response.body) throw new Error("Command Code response body missing");
+  const reader = response.body.getReader();
+  const decoder = new TextDecoder();
+  const encoder = new TextEncoder();
+  let buffer = "";
+  let bufferBytes = 0;
+  try {
+    for (;;) {
+      const { value, done } = await reader.read();
+      const next = buffer + decoder.decode(value, { stream: !done });
+      const nextBytes = encoder.encode(next).byteLength;
+      const reservation = budget.reserveTransient(nextBytes, { kind: "live_transient" });
+      buffer = next;
+      reservation.commitRetained();
+      budget.releaseRetained(bufferBytes, { kind: "live_transient" });
+      bufferBytes = nextBytes;
+      let newline = buffer.indexOf("\n");
+      while (newline >= 0) {
+        const line = buffer.slice(0, newline).trim(); buffer = buffer.slice(newline + 1);
+        if (line) { try { yield JSON.parse(stripEventFrame(line)) as Record<string, unknown>; } catch { /* ignore non-events */ } }
+        newline = buffer.indexOf("\n");
+      }
+      const residualBytes = encoder.encode(buffer).byteLength;
+      const residualReservation = budget.reserveTransient(residualBytes, { kind: "live_transient" });
+      residualReservation.commitRetained();
+      budget.releaseRetained(bufferBytes, { kind: "live_transient" });
+      bufferBytes = residualBytes;
+      if (done) break;
+    }
+    const final = buffer.trim();
+    if (final) { try { yield JSON.parse(stripEventFrame(final)) as Record<string, unknown>; } catch { /* ignore */ } }
+  } finally {
+    budget.releaseRetained(bufferBytes, { kind: "live_transient" });
+    try { await reader.cancel(); } catch { /* already closed */ }
+    reader.releaseLock();
+  }
+}
+
+/** The endpoint is newline-delimited JSON; defensively strip an SSE `data:` frame if the gateway ever switches shapes. */
+function stripEventFrame(line: string): string {
+  return line.startsWith("data:") ? line.slice("data:".length).trim() : line;
+}
+
+function isReasoningEffortRejection(status: number, payload: string): boolean {
+  return (status === 400 || status === 422) && /reasoning[_ -]?effort|unsupported effort|invalid effort/i.test(payload);
+}
+
+function requestWithoutReasoningEffort(request: AdapterRequest): AdapterRequest | undefined {
+  try {
+    const body = JSON.parse(request.body) as { params?: Record<string, unknown> };
+    if (!body.params?.reasoning_effort) return undefined;
+    delete body.params.reasoning_effort;
+    return { ...request, body: JSON.stringify(body), reasoningLog: undefined };
+  } catch {
+    return undefined;
+  }
+}
+
+async function fetchCommandCode(request: AdapterRequest, ctx: AdapterFetchContext | undefined, executor: typeof globalThis.fetch): Promise<Response> {
+  const timeout = new AbortController();
+  const timer = setTimeout(() => timeout.abort(new DOMException("Timeout elapsed", "TimeoutError")), ctx?.timeoutMs ?? 200_000);
+  const callerSignal = ctx?.abortSignal ?? new AbortController().signal;
+  try {
+    return await executor(request.url, {
+      method: request.method,
+      headers: request.headers,
+      body: request.body,
+      redirect: "manual",
+      signal: AbortSignal.any([callerSignal, timeout.signal]),
+    });
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
+function supportedCommandCodeEffort(provider: OcxProviderConfig, modelId: string, requested: string | undefined): string | undefined {
+  if (!requested || requested === "none") return undefined;
+  // Compatibility ids (deepseek-v4-flash / glm-5.2) must resolve to their canonical
+  // Command Code id before the effort lookup, or legacy requests silently lose the
+  // reasoning effort because the official table is keyed by the canonical ids.
+  const canonicalId = canonicalCommandCodeModelId(modelId);
+  const supported = commandCodeReasoningEfforts(canonicalId) ?? configuredReasoningEfforts(provider, canonicalId);
+  if (!supported) return undefined;
+  // Only remap xhigh/ultra→max for models whose official profile documents that
+  // aliasing (deepseek v4, glm-5.2). Muse Spark's upstream accepts xhigh as a
+  // distinct wire value and rejects ultra, so it must not be collapsed.
+  let wire = requested;
+  const lower = canonicalId.toLowerCase();
+  const needsAlias =
+    lower === "deepseek/deepseek-v4-pro" ||
+    lower === "deepseek/deepseek-v4-flash" ||
+    lower === "zai-org/glm-5.2";
+  if (requested === "xhigh" && !supported.includes("xhigh") && supported.includes("max")) {
+    wire = "max";
+  } else if (requested === "ultra" && needsAlias && supported.includes("max")) {
+    wire = "max";
+  }
+  return (supported as readonly string[]).includes(wire) ? wire : undefined;
+}
+
+export function createCommandCodeAdapter(provider: OcxProviderConfig): ProviderAdapter {
+  const executor = (provider as OcxProviderConfig & { fetch?: typeof globalThis.fetch }).fetch ?? globalThis.fetch;
+  return {
+    name: "command-code",
+    async buildRequest(parsed: OcxParsedRequest): Promise<AdapterRequest> {
+      if (!provider.apiKey) throw new Error("Command Code credential missing — run ocx login command-code");
+      const cwd = currentWorkingDirectory();
+      const tools = visibleTools(parsed);
+      const toolNudge = buildNonOpenAIToolCatalogNudgeForTools(tools, parsed.options.toolChoice);
+      const choiceInstruction = toolChoiceInstruction(parsed);
+      const system = identifyRoutedModel([
+        ...(parsed.context.systemPrompt ?? []),
+        ...(toolNudge ? [toolNudge] : []),
+        ...(choiceInstruction ? [choiceInstruction] : []),
+      ].join("\n\n"), parsed.modelId);
+      const reasoningEffort = supportedCommandCodeEffort(provider, parsed.modelId, parsed.options.reasoning);
+      const body = {
+        config: await commandCodeConfig(cwd), memory: "", taste: null, skills: null,
+        permissionMode: "standard", mode: "agent",
+        params: {
+          model: canonicalCommandCodeModelId(parsed.modelId),
+          messages: wireMessages(parsed.context.messages),
+          tools: wireTools(tools),
+          system,
+          max_tokens: parsed.options.maxOutputTokens ?? provider.defaultMaxOutputTokens ?? 64_000,
+          // The proprietary /alpha/generate endpoint is NDJSON-stream-only; the proxy converts
+          // the buffered/streamed events to the client's requested shape (parsed.stream).
+          stream: true,
+          ...(parsed.options.temperature !== undefined ? { temperature: parsed.options.temperature } : {}),
+          ...(reasoningEffort ? { reasoning_effort: reasoningEffort } : {}),
+        },
+      };
+      const headers: Record<string, string> = {
+        Authorization: `Bearer ${provider.apiKey}`,
+        "Content-Type": "application/json",
+        "User-Agent": "cli",
+        "x-command-code-version": provider.commandCodeVersion ?? "0.52.1",
+        "x-cli-environment": "production",
+        "x-taste-learning": "false",
+        "x-co-flag": "false",
+        "x-session-id": randomUUID(),
+      };
+      if (cwd) headers["x-project-slug"] = projectSlug(cwd);
+      return {
+        url: `${provider.baseUrl.replace(/\/$/, "")}/alpha/generate`, method: "POST",
+        headers,
+        body: JSON.stringify(body),
+        ...(reasoningEffort ? { reasoningLog: { effectiveEffort: reasoningEffort, wireField: "reasoning_effort" as const, wireValue: reasoningEffort } } : {}),
+      };
+    },
+    async fetchResponse(request: AdapterRequest, ctx?: AdapterFetchContext): Promise<Response> {
+      const response = await fetchCommandCode(request, ctx, executor);
+      if (response.ok) return response;
+      const currentEffort = (() => {
+        try { return (JSON.parse(request.body) as { params?: { reasoning_effort?: unknown } }).params?.reasoning_effort; } catch { return undefined; }
+      })();
+      if (typeof currentEffort !== "string") return response;
+      let body = "";
+      try {
+        const observed = await readBoundedResponseBody(response.clone(), { signal: ctx?.abortSignal, maxBytes: 8 * 1024 });
+        if (!observed.displaySafe) return response;
+        body = observed.text;
+      } catch { return response; }
+      if (!isReasoningEffortRejection(response.status, body)) return response;
+      const modelId = (() => {
+        try { return (JSON.parse(request.body) as { params?: { model?: unknown } }).params?.model; } catch { return undefined; }
+      })();
+      if (typeof modelId !== "string") return response;
+      const refreshed = await refreshCommandCodeReasoningEfforts(modelId, executor);
+      if (!refreshed || refreshed.includes(currentEffort)) return response;
+      const retry = requestWithoutReasoningEffort(request);
+      if (!retry) return response;
+      try { void response.body?.cancel(); } catch { /* already closed */ }
+      return fetchCommandCode(retry, ctx, executor);
+    },
+    async *parseStream(response: Response, budget: TranslatorBudget): AsyncGenerator<AdapterEvent> {
+      let sawFinish = false;
+      for await (const event of ndjson(response, budget)) {
+        switch (event.type) {
+          case "text-delta": if (typeof event.text === "string") yield { type: "text_delta", text: event.text }; break;
+          case "reasoning-delta": if (typeof event.text === "string") yield { type: "thinking_delta", thinking: event.text }; break;
+          case "tool-call": {
+            const id = typeof event.toolCallId === "string" ? event.toolCallId : randomUUID();
+            const name = typeof event.toolName === "string" ? event.toolName : "tool";
+            const input = event.input ?? event.args ?? {};
+            const argumentsText = typeof input === "string" ? input : JSON.stringify(input);
+            yield { type: "tool_call_start", id, name };
+            budget.openCall(id);
+            try {
+              const reservation = budget.reserveTransient(new TextEncoder().encode(argumentsText).byteLength, { kind: "tool_args", callId: id });
+              reservation.commitRetained();
+              yield { type: "tool_call_delta", arguments: argumentsText };
+              yield { type: "tool_call_end" };
+            } finally {
+              budget.closeCall(id);
+            }
+            break;
+          }
+          case "finish-step":
+          case "finish": {
+            // Both events are terminal on the current wire; streams commonly carry both, so
+            // only the first one emits the done. finish-step carries `usage`; finish may carry
+            // `totalUsage` (current flows) or `usage`.
+            if (sawFinish) break;
+            sawFinish = true;
+            const usageValue = event.totalUsage ?? event.usage;
+            const stopReason = typeof event.rawFinishReason === "string" ? event.rawFinishReason : typeof event.finishReason === "string" ? event.finishReason : undefined;
+            // The AI SDK's `error` finish reason means the generation failed upstream, not that it
+            // stopped. Reporting it as a `done` left the bridge to infer failure from a stop-reason
+            // string, which either read as a clean completion or (once classified) mislabelled an
+            // upstream error as a content filter and rejected it from the replay cache for the
+            // wrong reason.
+            if (stopReason === "error") {
+              // Keep the usage: a failed turn still consumed tokens, and dropping it makes the
+              // turn look free in accounting and reports zeros to the client.
+              yield {
+                type: "error",
+                message: "Command Code upstream ended the turn with finishReason \"error\"",
+                status: 502,
+                errorType: "upstream_error",
+                usage: usage(usageValue),
+              };
+              break;
+            }
+            yield { type: "done", usage: usage(usageValue), stopReason };
+            break;
+          }
+          case "error": {
+            const message = eventError(event.error);
+            if (isMissingToolResultError(message)) {
+              // Provider-side tool-result validation: the request carried an assistant tool
+              // call the upstream refused to accept. This is not a network/stream stall; the
+              // proxy normally prevents it by pairing every call, so flag it distinctly.
+              yield { type: "error", message, status: 502, errorType: "upstream_error", code: "missing_tool_result" };
+            } else {
+              yield { type: "error", message, status: 502 };
+            }
+            break;
+          }
+        }
+      }
+      // A stream that ends without a finish event still needs a terminal done so the
+      // server does not wait on an adapter that silently stopped emitting.
+      if (!sawFinish) yield { type: "done", usage: undefined, stopReason: undefined };
+    },
+    async parseResponse(response: Response, budget: TranslatorBudget): Promise<AdapterEvent[]> {
+      const events: AdapterEvent[] = [];
+      for await (const event of this.parseStream(response, budget)) events.push(event);
+      return events;
+    },
+  };
+}