Re-bake the xAI Responses adapter with host Grok option keys

Author: TheGreatAxios

src/config/index.ts

@@ -46,7 +46,7 @@ import {
   GROK_RESPONSES_PROVIDER,
   GROK_SESSION_ID_OPTION,
   GROK_USER_ID_OPTION,
-} from "../provider/grok-responses-adapter.js";
+} from "../provider/grok-responses.js";
 import { BIFROST_PROVIDER } from "../provider/bifrost-adapter.js";
 import { isOllamaProviderId, ollamaOpenAIBaseURL } from "../provider/ollama.js";
 import { selectableGoModelIds } from "../provider/opencode-go-models.js";

src/provider/grok-responses-adapter.ts

@@ -1,6 +1,6 @@
 import { describe, expect, test } from "bun:test";
 import type { ConversationTurn, LastCycleSource } from "@intx/types/runtime";
-import { createGrokResponsesAdapter } from "./grok-responses-adapter.js";
+import { createGrokResponsesAdapter } from "./grok-responses.js";
 
 const source: LastCycleSource = {
   sourceId: "xai/test",
@@ -199,15 +199,19 @@ describe("createGrokResponsesAdapter", () => {
 
   test("treats Responses completed, incomplete, and done events as stream-terminal", () => {
     const adapter = createGrokResponsesAdapter(source);
-    expect(typeof adapter.isStreamTerminal).toBe("function");
+    const isStreamTerminal = adapter.isStreamTerminal;
+    expect(typeof isStreamTerminal).toBe("function");
+    if (typeof isStreamTerminal !== "function") {
+      throw new Error("expected isStreamTerminal to be a function");
+    }
     for (const type of ["response.completed", "response.incomplete", "response.done"]) {
-      expect(adapter.isStreamTerminal!(JSON.stringify({ type }))).toBe(true);
+      expect(isStreamTerminal(JSON.stringify({ type }))).toBe(true);
     }
     for (const type of ["response.output_text.delta", "response.created", "response.in_progress"]) {
-      expect(adapter.isStreamTerminal!(JSON.stringify({ type }))).toBe(false);
+      expect(isStreamTerminal(JSON.stringify({ type }))).toBe(false);
     }
-    expect(adapter.isStreamTerminal!("{not json")).toBe(false);
-    expect(adapter.isStreamTerminal!("null")).toBe(false);
-    expect(adapter.isStreamTerminal!('"just a string"')).toBe(false);
+    expect(isStreamTerminal("{not json")).toBe(false);
+    expect(isStreamTerminal("null")).toBe(false);
+    expect(isStreamTerminal('"just a string"')).toBe(false);
   });
 });

…/provider/grok-responses-adapter.test.ts src/provider/grok-responses.test.tssrc/provider/grok-responses-adapter.test.ts renamed to src/provider/grok-responses.test.ts src/provider/grok-responses-adapter.test.ts renamed to src/provider/grok-responses.test.ts

@@ -0,0 +1,23 @@
+import { responsesAdapterFactory } from "@corbits/openai-responses";
+import { XAI_USER_ID_OPTION, xaiResponsesQuirks } from "@corbits/xai-provider";
+import type { AdapterFactory } from "@intx/inference";
+
+export const GROK_RESPONSES_PROVIDER = "grok-responses";
+
+export const GROK_USER_ID_OPTION = "grokUserId";
+export const GROK_SESSION_ID_OPTION = "grokSessionId";
+
+// Spread xAI quirks and remap only host option keys. Config still writes
+// grokUserId / grokSessionId / reasoning_effort; wrapping buildRequest to
+// alias those would hide the mismatch instead of baking the host names.
+export const createGrokResponsesAdapter: AdapterFactory = responsesAdapterFactory({
+  ...xaiResponsesQuirks,
+  sessionIdOption: GROK_SESSION_ID_OPTION,
+  headers: {
+    ...xaiResponsesQuirks.headers,
+    fromOption: (xaiResponsesQuirks.headers?.fromOption ?? []).map((entry) =>
+      entry.optionKey === XAI_USER_ID_OPTION ? { ...entry, optionKey: GROK_USER_ID_OPTION } : entry,
+    ),
+  },
+  reasoning: { ...xaiResponsesQuirks.reasoning, effortOption: "reasoning_effort" },
+});

src/provider/grok-responses.ts

@@ -7,15 +7,15 @@ import { loadAdapterRegistry } from "@intx/inference/providers";
 import * as openaiCompatible from "./openai-compatible-adapter.js";
 import * as opencodeGo from "./opencode-go-adapter.js";
 import * as codexResponses from "./codex-responses-adapter.js";
-import * as grokResponses from "./grok-responses-adapter.js";
+import * as grokResponses from "./grok-responses.js";
 import * as bifrostAdapter from "./bifrost-adapter.js";
 import * as openaiResponses from "./openai-responses.js";
 import * as opencodeGoAnthropic from "./opencode-go-anthropic-adapter.js";
 import {
   CODEX_RESPONSES_PROVIDER,
   withCodexContentTypeRepair,
 } from "./codex-responses-adapter.js";
-import { GROK_RESPONSES_PROVIDER } from "./grok-responses-adapter.js";
+import { GROK_RESPONSES_PROVIDER } from "./grok-responses.js";
 import { withReplaySanitizer } from "./replay-sanitizer.js";
 import { OPENCODE_GO_PROVIDER_ID } from "../../packages/opencode-go/src/index.js";
 import { BIFROST_PROVIDER } from "./bifrost-adapter.js";
@@ -44,7 +44,7 @@ const manifest: AdapterManifest = [
   },
   {
     provider: GROK_RESPONSES_PROVIDER,
-    specifier: "grok-responses-adapter",
+    specifier: "grok-responses",
     export: "createGrokResponsesAdapter",
   },
   {
@@ -68,7 +68,7 @@ const localModules: Record<string, unknown> = {
   "openai-compatible-adapter": openaiCompatible,
   "opencode-go-adapter": opencodeGo,
   "codex-responses-adapter": codexResponses,
-  "grok-responses-adapter": grokResponses,
+  "grok-responses": grokResponses,
   "bifrost-adapter": bifrostAdapter,
   "openai-responses": openaiResponses,
   "opencode-go-anthropic-adapter": opencodeGoAnthropic,

src/provider/inference-dependencies.ts

@@ -8,7 +8,7 @@ import {
   createCodexResponsesAdapter,
   tagSignature,
 } from "./codex-responses-adapter.js";
-import { createGrokResponsesAdapter } from "./grok-responses-adapter.js";
+import { createGrokResponsesAdapter } from "./grok-responses.js";
 import { createOpenAICompatibleAdapter } from "./openai-compatible-adapter.js";
 import {
   sanitizeReplayTurns,

src/provider/replay-sanitizer.test.ts

@@ -1,4 +1,4 @@
-import { GROK_RESPONSES_PROVIDER } from "../provider/grok-responses-adapter.js";
+import { GROK_RESPONSES_PROVIDER } from "../provider/grok-responses.js";
 import { isXaiProviderName } from "../config/xai-providers.js";
 
 /**