@moxxy/plugin-provider-xai 0.21.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Moxxy (moxxy.ai)
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { grokModels } from './models.js';
+export { grokModels };
+/**
+ * xAI (Grok). The xAI API speaks the OpenAI Chat Completions protocol, so this
+ * reuses the shared {@link defineOpenAICompatProvider} with the `xai` slug +
+ * base URL + Grok catalog forced on (so usage stats, provider events and error
+ * context attribute to `xai`, not `openai`).
+ */
+export declare const xaiProviderDef: import("@moxxy/sdk").ProviderDef;
+export declare const xaiPlugin: import("@moxxy/sdk").Plugin;
+export default xaiPlugin;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,CAAC;AAKtB;;;;;GAKG;AACH,eAAO,MAAM,cAAc,kCASzB,CAAC;AAEH,eAAO,MAAM,SAAS,6BAIpB,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/dist/index.js

@@ -0,0 +1,29 @@
+import { definePlugin } from '@moxxy/sdk';
+import { defineOpenAICompatProvider } from '@moxxy/plugin-provider-openai';
+import { grokModels } from './models.js';
+export { grokModels };
+const XAI_BASE_URL = 'https://api.x.ai/v1';
+const XAI_DEFAULT_MODEL = 'grok-4';
+/**
+ * xAI (Grok). The xAI API speaks the OpenAI Chat Completions protocol, so this
+ * reuses the shared {@link defineOpenAICompatProvider} with the `xai` slug +
+ * base URL + Grok catalog forced on (so usage stats, provider events and error
+ * context attribute to `xai`, not `openai`).
+ */
+export const xaiProviderDef = defineOpenAICompatProvider({
+    name: 'xai',
+    baseURL: XAI_BASE_URL,
+    defaultModel: XAI_DEFAULT_MODEL,
+    models: grokModels,
+    auth: {
+        kind: 'apiKey',
+        hint: 'xAI API key (starts with `xai-`) from https://console.x.ai',
+    },
+});
+export const xaiPlugin = definePlugin({
+    name: '@moxxy/plugin-provider-xai',
+    version: '0.0.0',
+    providers: [xaiProviderDef],
+});
+export default xaiPlugin;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAC1C,OAAO,EAAE,0BAA0B,EAAE,MAAM,+BAA+B,CAAC;AAC3E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,OAAO,EAAE,UAAU,EAAE,CAAC;AAEtB,MAAM,YAAY,GAAG,qBAAqB,CAAC;AAC3C,MAAM,iBAAiB,GAAG,QAAQ,CAAC;AAEnC;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GAAG,0BAA0B,CAAC;IACvD,IAAI,EAAE,KAAK;IACX,OAAO,EAAE,YAAY;IACrB,YAAY,EAAE,iBAAiB;IAC/B,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE;QACJ,IAAI,EAAE,QAAQ;QACd,IAAI,EAAE,4DAA4D;KACnE;CACF,CAAC,CAAC;AAEH,MAAM,CAAC,MAAM,SAAS,GAAG,YAAY,CAAC;IACpC,IAAI,EAAE,4BAA4B;IAClC,OAAO,EAAE,OAAO;IAChB,SAAS,EAAE,CAAC,cAAc,CAAC;CAC5B,CAAC,CAAC;AAEH,eAAe,SAAS,CAAC"}

package/dist/models.d.ts

@@ -0,0 +1,26 @@
+import type { ModelDescriptor } from '@moxxy/sdk';
+/**
+ * xAI Grok model catalog, as of 2026-06 (verify against
+ * https://docs.x.ai/docs/models). The xAI API is OpenAI-compatible, so these
+ * stream through the shared {@link import('@moxxy/plugin-provider-openai').OpenAIProvider}.
+ * grok-4.3 is the current flagship with a 1M context; the grok-4 tier is 256k;
+ * grok-3 is 131k. Vision is available on the grok-4 family. An unlisted model
+ * id still works — it's passed straight through to api.x.ai; the catalog only
+ * drives context-window budgets and capability gating.
+ *
+ * The grok-4 family + grok-3-mini are reasoning models — xAI streams their
+ * `reasoning_content` deltas, which the shared OpenAIProvider already surfaces;
+ * supportsReasoning gates reasoning_effort + reasoning-stream surfacing on
+ * (without it the capability is dead upstream even when the user enables it).
+ *
+ * supportsDocuments is intentionally NOT set: the xAI API is reached through the
+ * OpenAI-compatibility surface, and (like the Gemini compat endpoint) it does
+ * not honor the OpenAI `file`/`file_data` content part the shared translate
+ * layer emits for `document` blocks. Asserting it would make the desktop ship
+ * raw PDF bytes the endpoint rejects/ignores — losing the document with no
+ * fallback. Leaving it unset keeps the safe extracted-text path. Images ride
+ * `image_url` data URLs (accepted), so supportsImages stays true on the vision
+ * tier.
+ */
+export declare const grokModels: ReadonlyArray<ModelDescriptor>;
+//# sourceMappingURL=models.d.ts.map

package/dist/models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.d.ts","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,eAAO,MAAM,UAAU,EAAE,aAAa,CAAC,eAAe,CAYrD,CAAC"}

package/dist/models.js

@@ -0,0 +1,35 @@
+/**
+ * xAI Grok model catalog, as of 2026-06 (verify against
+ * https://docs.x.ai/docs/models). The xAI API is OpenAI-compatible, so these
+ * stream through the shared {@link import('@moxxy/plugin-provider-openai').OpenAIProvider}.
+ * grok-4.3 is the current flagship with a 1M context; the grok-4 tier is 256k;
+ * grok-3 is 131k. Vision is available on the grok-4 family. An unlisted model
+ * id still works — it's passed straight through to api.x.ai; the catalog only
+ * drives context-window budgets and capability gating.
+ *
+ * The grok-4 family + grok-3-mini are reasoning models — xAI streams their
+ * `reasoning_content` deltas, which the shared OpenAIProvider already surfaces;
+ * supportsReasoning gates reasoning_effort + reasoning-stream surfacing on
+ * (without it the capability is dead upstream even when the user enables it).
+ *
+ * supportsDocuments is intentionally NOT set: the xAI API is reached through the
+ * OpenAI-compatibility surface, and (like the Gemini compat endpoint) it does
+ * not honor the OpenAI `file`/`file_data` content part the shared translate
+ * layer emits for `document` blocks. Asserting it would make the desktop ship
+ * raw PDF bytes the endpoint rejects/ignores — losing the document with no
+ * fallback. Leaving it unset keeps the safe extracted-text path. Images ride
+ * `image_url` data URLs (accepted), so supportsImages stays true on the vision
+ * tier.
+ */
+export const grokModels = [
+    // grok-4 family: current frontier. 4.3 is the flagship (1M context). Reasoning + vision.
+    { id: 'grok-4.3', contextWindow: 1_000_000, maxOutputTokens: 64_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsReasoning: true },
+    { id: 'grok-4', contextWindow: 256_000, maxOutputTokens: 64_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsReasoning: true },
+    { id: 'grok-4-fast', contextWindow: 256_000, maxOutputTokens: 64_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsReasoning: true },
+    // grok-code-fast-1: agentic-coding specialist (text-only). Reasoning model.
+    { id: 'grok-code-fast-1', contextWindow: 256_000, maxOutputTokens: 64_000, supportsTools: true, supportsStreaming: true, supportsReasoning: true },
+    // grok-3 tier: prior generation, still served. Only the -mini variant reasons.
+    { id: 'grok-3', contextWindow: 131_072, maxOutputTokens: 32_768, supportsTools: true, supportsStreaming: true },
+    { id: 'grok-3-mini', contextWindow: 131_072, maxOutputTokens: 32_768, supportsTools: true, supportsStreaming: true, supportsReasoning: true },
+];
+//# sourceMappingURL=models.js.map

package/dist/models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"models.js","sourceRoot":"","sources":["../src/models.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,MAAM,UAAU,GAAmC;IACxD,yFAAyF;IACzF,EAAE,EAAE,EAAE,UAAU,EAAE,aAAa,EAAE,SAAS,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE;IAClK,EAAE,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE;IAC9J,EAAE,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,cAAc,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE;IAEnK,4EAA4E;IAC5E,EAAE,EAAE,EAAE,kBAAkB,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE;IAElJ,+EAA+E;IAC/E,EAAE,EAAE,EAAE,QAAQ,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE;IAC/G,EAAE,EAAE,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE,iBAAiB,EAAE,IAAI,EAAE;CAC9I,CAAC"}

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@moxxy/plugin-provider-xai",
+  "version": "0.21.1",
+  "description": "xAI (Grok) LLMProvider plugin for moxxy. Streams the OpenAI-compatible xAI API (https://api.x.ai/v1).",
+  "keywords": [
+    "moxxy",
+    "agent",
+    "provider",
+    "xai",
+    "grok",
+    "llm"
+  ],
+  "homepage": "https://moxxy.ai",
+  "bugs": {
+    "url": "https://github.com/moxxy-ai/moxxy/issues"
+  },
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/moxxy-ai/moxxy.git",
+    "directory": "packages/plugin-provider-xai"
+  },
+  "author": "Michal Makowski <michal.makowski97@gmail.com>",
+  "license": "MIT",
+  "publishConfig": {
+    "access": "public"
+  },
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src"
+  ],
+  "moxxy": {
+    "plugin": {
+      "entry": "./dist/index.js",
+      "kind": "provider"
+    }
+  },
+  "dependencies": {
+    "@moxxy/sdk": "0.21.1",
+    "@moxxy/plugin-provider-openai": "0.21.1"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "typescript": "^5.7.3",
+    "vitest": "^2.1.8",
+    "zod": "^3.24.0",
+    "@moxxy/tsconfig": "0.0.0",
+    "@moxxy/vitest-preset": "0.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest run",
+    "clean": "rm -rf dist .turbo"
+  }
+}

package/src/index.test.ts

@@ -0,0 +1,120 @@
+import { describe, expect, it } from 'vitest';
+import { xaiPlugin, xaiProviderDef, grokModels } from './index.js';
+
+describe('@moxxy/plugin-provider-xai', () => {
+  it('registers the xai provider', () => {
+    expect(xaiPlugin.providers?.map((p) => p.name)).toEqual(['xai']);
+  });
+
+  it('advertises the Grok catalog (including the 1M-context grok-4.3 flagship)', () => {
+    expect(xaiProviderDef.models).toEqual(grokModels);
+    expect(grokModels.find((m) => m.id === 'grok-4.3')).toMatchObject({ contextWindow: 1_000_000 });
+  });
+
+  it('createClient stamps the xai slug so usage/errors attribute to xAI, not openai', () => {
+    const client = xaiProviderDef.createClient({ apiKey: 'xai-test-key' });
+    expect(client.name).toBe('xai');
+    expect(client.models).toEqual(grokModels);
+  });
+
+  it('exposes an apiKey auth descriptor', () => {
+    expect(xaiProviderDef.auth).toMatchObject({ kind: 'apiKey' });
+  });
+
+  it('the reasoning-tier Grok models advertise supportsReasoning', () => {
+    // Reasoning gating (reasoning_effort + reasoning-stream surfacing) keys off
+    // this flag; absent it, the loop silently drops reasoning config even when
+    // the user enables it. The grok-4 family + grok-3-mini are reasoning models.
+    const reasoningIds = ['grok-4.3', 'grok-4', 'grok-4-fast', 'grok-code-fast-1', 'grok-3-mini'];
+    for (const id of reasoningIds) {
+      expect(grokModels.find((m) => m.id === id)?.supportsReasoning, id).toBe(true);
+    }
+    // The non-mini grok-3 is NOT a reasoning model — keep the flag off so the
+    // loop doesn't request reasoning the model won't honor.
+    expect(grokModels.find((m) => m.id === 'grok-3')?.supportsReasoning).toBeUndefined();
+  });
+
+  it('every Grok descriptor carries a positive, in-window maxOutputTokens budget', () => {
+    // Without maxOutputTokens the context budgeter can't reserve completion
+    // space, so a near-full window + large generation gets server-truncated
+    // instead of pre-emptively elided.
+    for (const m of grokModels) {
+      expect(typeof m.maxOutputTokens, `${m.id} maxOutputTokens`).toBe('number');
+      expect(m.maxOutputTokens!, `${m.id} maxOutputTokens > 0`).toBeGreaterThan(0);
+      expect(m.maxOutputTokens!, `${m.id} maxOutputTokens <= contextWindow`).toBeLessThanOrEqual(m.contextWindow);
+    }
+  });
+
+  it('every Grok descriptor is structurally well-formed (positive window, required flags, unique id)', () => {
+    // Lock the catalog invariants so a careless future edit can't silently ship
+    // a descriptor the SDK budgeter/capability-gating would mis-read.
+    const seen = new Set<string>();
+    for (const m of grokModels) {
+      expect(typeof m.id, 'id is a string').toBe('string');
+      expect(m.id.length, `${m.id} id non-empty`).toBeGreaterThan(0);
+      expect(seen.has(m.id), `${m.id} is not duplicated`).toBe(false);
+      seen.add(m.id);
+      expect(typeof m.contextWindow, `${m.id} contextWindow`).toBe('number');
+      expect(m.contextWindow, `${m.id} contextWindow > 0`).toBeGreaterThan(0);
+      expect(m.supportsTools, `${m.id} supportsTools`).toBe(true);
+      expect(m.supportsStreaming, `${m.id} supportsStreaming`).toBe(true);
+    }
+  });
+
+  it('no Grok descriptor asserts supportsDocuments (OpenAI-compat endpoint rejects native file parts)', () => {
+    // Intentional: the xAI compat surface does not honor the OpenAI `file`/
+    // `file_data` content part the shared translate layer emits for `document`
+    // blocks. Asserting supportsDocuments would make the desktop ship raw PDF
+    // bytes the endpoint drops — losing the doc with no fallback. The safe path
+    // is the extracted-text route (supportsDocuments unset → text). Guard the
+    // decision so it can't be re-introduced without an explicit, tested choice.
+    for (const m of grokModels) {
+      expect(m.supportsDocuments, `${m.id} must not assert supportsDocuments`).toBeUndefined();
+    }
+  });
+
+  it('createClient degrades to xAI defaults on hostile/wrong-typed config (no smuggled non-string fields)', () => {
+    // The registry hands createClient an untyped Record<string, unknown>. A
+    // wrong-typed baseURL/defaultModel (object/number) must NOT reach the OpenAI
+    // SDK (where a non-string baseURL would throw or silently mis-route); the
+    // narrowing drops them so the vendor defaults stand. A string apiKey is
+    // present (the SDK constructor requires a non-empty key) — everything else
+    // is hostile. The worst case here is degradation to defaults, never a crash.
+    const hostile = {
+      apiKey: 'xai-test-key',
+      baseURL: { evil: true },
+      defaultModel: 12345,
+      extraJunk: ['should', 'be', 'ignored'],
+    } as unknown as Record<string, unknown>;
+    const client = xaiProviderDef.createClient(hostile);
+    expect(client.name).toBe('xai');
+    expect(client.models).toEqual(grokModels);
+  });
+
+  it('refuses an empty config rather than smuggling OPENAI_API_KEY to xai', () => {
+    // Worst case: the registry hands us {} (no key) while OPENAI_API_KEY is set in
+    // env. The OpenAI SDK ctor would silently fall back to it and ship the user's
+    // real OpenAI credential to api.x.ai — createClient MUST refuse, not smuggle.
+    const prev = process.env.OPENAI_API_KEY;
+    process.env.OPENAI_API_KEY = 'sk-env-fallback-for-test';
+    try {
+      expect(() => xaiProviderDef.createClient({})).toThrow(/requires an API key/);
+    } finally {
+      if (prev === undefined) delete process.env.OPENAI_API_KEY;
+      else process.env.OPENAI_API_KEY = prev;
+    }
+  });
+
+  it('builds a working client when a real apiKey is supplied (no junk smuggled)', () => {
+    const client = xaiProviderDef.createClient({ apiKey: 'xai-test-key' });
+    expect(client.name).toBe('xai');
+    expect(client.models).toEqual(grokModels);
+  });
+
+  it('exposes a validateKey probe (so a bad xAI key is caught before first stream)', () => {
+    // defineOpenAICompatProvider wires validateOpenAICompatKey against the xAI
+    // base URL unless validate:false. xai relies on the default, so the setup
+    // wizard / `moxxy login` can verify the key against api.x.ai/v1/models.
+    expect(typeof xaiProviderDef.validateKey).toBe('function');
+  });
+});

package/src/index.ts

@@ -0,0 +1,33 @@
+import { definePlugin } from '@moxxy/sdk';
+import { defineOpenAICompatProvider } from '@moxxy/plugin-provider-openai';
+import { grokModels } from './models.js';
+
+export { grokModels };
+
+const XAI_BASE_URL = 'https://api.x.ai/v1';
+const XAI_DEFAULT_MODEL = 'grok-4';
+
+/**
+ * xAI (Grok). The xAI API speaks the OpenAI Chat Completions protocol, so this
+ * reuses the shared {@link defineOpenAICompatProvider} with the `xai` slug +
+ * base URL + Grok catalog forced on (so usage stats, provider events and error
+ * context attribute to `xai`, not `openai`).
+ */
+export const xaiProviderDef = defineOpenAICompatProvider({
+  name: 'xai',
+  baseURL: XAI_BASE_URL,
+  defaultModel: XAI_DEFAULT_MODEL,
+  models: grokModels,
+  auth: {
+    kind: 'apiKey',
+    hint: 'xAI API key (starts with `xai-`) from https://console.x.ai',
+  },
+});
+
+export const xaiPlugin = definePlugin({
+  name: '@moxxy/plugin-provider-xai',
+  version: '0.0.0',
+  providers: [xaiProviderDef],
+});
+
+export default xaiPlugin;

package/src/models.ts

@@ -0,0 +1,38 @@
+import type { ModelDescriptor } from '@moxxy/sdk';
+
+/**
+ * xAI Grok model catalog, as of 2026-06 (verify against
+ * https://docs.x.ai/docs/models). The xAI API is OpenAI-compatible, so these
+ * stream through the shared {@link import('@moxxy/plugin-provider-openai').OpenAIProvider}.
+ * grok-4.3 is the current flagship with a 1M context; the grok-4 tier is 256k;
+ * grok-3 is 131k. Vision is available on the grok-4 family. An unlisted model
+ * id still works — it's passed straight through to api.x.ai; the catalog only
+ * drives context-window budgets and capability gating.
+ *
+ * The grok-4 family + grok-3-mini are reasoning models — xAI streams their
+ * `reasoning_content` deltas, which the shared OpenAIProvider already surfaces;
+ * supportsReasoning gates reasoning_effort + reasoning-stream surfacing on
+ * (without it the capability is dead upstream even when the user enables it).
+ *
+ * supportsDocuments is intentionally NOT set: the xAI API is reached through the
+ * OpenAI-compatibility surface, and (like the Gemini compat endpoint) it does
+ * not honor the OpenAI `file`/`file_data` content part the shared translate
+ * layer emits for `document` blocks. Asserting it would make the desktop ship
+ * raw PDF bytes the endpoint rejects/ignores — losing the document with no
+ * fallback. Leaving it unset keeps the safe extracted-text path. Images ride
+ * `image_url` data URLs (accepted), so supportsImages stays true on the vision
+ * tier.
+ */
+export const grokModels: ReadonlyArray<ModelDescriptor> = [
+  // grok-4 family: current frontier. 4.3 is the flagship (1M context). Reasoning + vision.
+  { id: 'grok-4.3', contextWindow: 1_000_000, maxOutputTokens: 64_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsReasoning: true },
+  { id: 'grok-4', contextWindow: 256_000, maxOutputTokens: 64_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsReasoning: true },
+  { id: 'grok-4-fast', contextWindow: 256_000, maxOutputTokens: 64_000, supportsTools: true, supportsStreaming: true, supportsImages: true, supportsReasoning: true },
+
+  // grok-code-fast-1: agentic-coding specialist (text-only). Reasoning model.
+  { id: 'grok-code-fast-1', contextWindow: 256_000, maxOutputTokens: 64_000, supportsTools: true, supportsStreaming: true, supportsReasoning: true },
+
+  // grok-3 tier: prior generation, still served. Only the -mini variant reasons.
+  { id: 'grok-3', contextWindow: 131_072, maxOutputTokens: 32_768, supportsTools: true, supportsStreaming: true },
+  { id: 'grok-3-mini', contextWindow: 131_072, maxOutputTokens: 32_768, supportsTools: true, supportsStreaming: true, supportsReasoning: true },
+];