@rise-so/pi-grok-build 0.1.0 → 0.1.1

package/README.md

@@ -16,8 +16,9 @@ One dependency-free core with two adapters:
 
 | Model | Context | Pricing (per Mtok in/out/cache-read) | Notes |
 |---|---|---|---|
-| `grok-build-0.1` | 256k | $1.00 / $2.00 / $0.20 | flagship; aliases `grok-code-fast-1` upstream; pricing live-verified |
+| `grok-build-0.1` | 256k | $1.00 / $2.00 / $0.20 | aliases `grok-code-fast-1` upstream; pricing live-verified |
 | `grok-4.3` | 1M | $1.25 / $2.50 / $0.20 | reasoning model; pricing live-verified; live pricing doubles past 200k tokens (pi records the base tier) |
+| `grok-4.5` | 500k | $2.00 / $6.00 / $0.50 | reasoning model; documented efforts **low / medium / high** (default high, can't be disabled); pricing live-verified; long-context tier doubles past 200k |
 | `grok-composer-2.5-fast` | 200k | $3.00 / $15.00 / $0.50 | responds on `/responses` but is **absent from the live `/models` catalog**; context/output metadata from third-party registries |
 
 ### Media models (not wired up)
@@ -49,7 +50,8 @@ Then pick a model:
 
 ```sh
 pi --model xai-grok-build/grok-build-0.1
-pi --model xai-grok-build/grok-4.3 -p "one-shot prompt"
+pi --model xai-grok-build/grok-4.5 -p "one-shot prompt"
+pi --model xai-grok-build/grok-4.5:high -p "harder task"
 ```
 
 No `npm install` is needed for pi imports — pi's loader aliases
@@ -132,11 +134,12 @@ guards this with an import grep; keep it green.
   time; a concurrent Grok CLI login collides on the port.
 - OAuth is the only auth path, by policy. There is no `$XAI_API_KEY` handling,
   no API-key login row, and no reading of other programs' credential files.
-- Context windows and pricing for `grok-build-0.1` / `grok-4.3` are confirmed
-  by xAI's live `GET /v1/models` (see `pnpm smoke:models`). `maxTokens` output
-  caps are registry metadata only. `grok-composer-2.5-fast` is unlisted in the
-  live catalog (it serves anyway); its context/output figures come from
-  third-party registries and its pricing is maintainer-supplied.
+- Context windows and pricing for `grok-build-0.1` / `grok-4.3` / `grok-4.5`
+  are confirmed by xAI's live `GET /v1/models` (see `pnpm smoke:models`).
+  `maxTokens` output caps are registry metadata only. `grok-composer-2.5-fast`
+  is unlisted in the live catalog (it serves anyway); its context/output
+  figures come from third-party registries and its pricing is
+  maintainer-supplied.
 
 ## Development
 

package/dist/extension.js

@@ -45,6 +45,8 @@ export default function xaiGrokBuild(pi) {
             id: model.id,
             name: model.name,
             reasoning: model.reasoning,
+            // Only some catalog entries set thinkingLevelMap; `in` narrows the union.
+            ...("thinkingLevelMap" in model ? { thinkingLevelMap: { ...model.thinkingLevelMap } } : {}),
             input: [...model.input],
             cost: { ...model.cost },
             contextWindow: model.contextWindow,

package/dist/provider.d.ts

@@ -1,4 +1,4 @@
 import { type Provider } from "@earendil-works/pi-ai";
 import { type XaiOptions } from "./xai-grok-build.js";
-export { GROK_43_MODEL, GROK_BUILD_MODEL, GROK_COMPOSER_MODEL, GROK_MODELS, XAI_BASE_URL, XAI_MODEL_ID, XAI_PROVIDER_ID, type XaiOptions, } from "./xai-grok-build.js";
+export { GROK_43_MODEL, GROK_45_MODEL, GROK_BUILD_MODEL, GROK_COMPOSER_MODEL, GROK_MODELS, XAI_BASE_URL, XAI_MODEL_ID, XAI_PROVIDER_ID, type XaiOptions, } from "./xai-grok-build.js";
 export declare function xaiGrokBuildResponsesProvider(options?: XaiOptions): Provider<"openai-responses">;

package/dist/provider.js

@@ -9,7 +9,7 @@
 import { createProvider, } from "@earendil-works/pi-ai";
 import { openAIResponsesApi } from "@earendil-works/pi-ai/api/openai-responses.lazy";
 import { GROK_MODELS, XAI_BASE_URL, XAI_PROVIDER_ID, loginXai, refreshXai, requireXaiOAuthCredential, } from "./xai-grok-build.js";
-export { GROK_43_MODEL, GROK_BUILD_MODEL, GROK_COMPOSER_MODEL, GROK_MODELS, XAI_BASE_URL, XAI_MODEL_ID, XAI_PROVIDER_ID, } from "./xai-grok-build.js";
+export { GROK_43_MODEL, GROK_45_MODEL, GROK_BUILD_MODEL, GROK_COMPOSER_MODEL, GROK_MODELS, XAI_BASE_URL, XAI_MODEL_ID, XAI_PROVIDER_ID, } from "./xai-grok-build.js";
 export function xaiGrokBuildResponsesProvider(options = {}) {
     const opts = { ...options };
     return createProvider({

package/dist/xai-grok-build.d.ts

@@ -43,6 +43,32 @@ export declare const GROK_43_MODEL: {
         readonly supportsLongCacheRetention: false;
     };
 };
+export declare const GROK_45_MODEL: {
+    id: string;
+    name: string;
+    api: "openai-responses";
+    provider: string;
+    baseUrl: string;
+    reasoning: true;
+    thinkingLevelMap: {
+        readonly off: null;
+        readonly minimal: null;
+        readonly xhigh: null;
+    };
+    input: ("text" | "image")[];
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    contextWindow: number;
+    maxTokens: number;
+    compat: {
+        readonly sendSessionIdHeader: false;
+        readonly supportsLongCacheRetention: false;
+    };
+};
 export declare const GROK_COMPOSER_MODEL: {
     id: string;
     name: string;
@@ -104,6 +130,31 @@ export declare const GROK_MODELS: readonly [{
         readonly sendSessionIdHeader: false;
         readonly supportsLongCacheRetention: false;
     };
+}, {
+    id: string;
+    name: string;
+    api: "openai-responses";
+    provider: string;
+    baseUrl: string;
+    reasoning: true;
+    thinkingLevelMap: {
+        readonly off: null;
+        readonly minimal: null;
+        readonly xhigh: null;
+    };
+    input: ("text" | "image")[];
+    cost: {
+        input: number;
+        output: number;
+        cacheRead: number;
+        cacheWrite: number;
+    };
+    contextWindow: number;
+    maxTokens: number;
+    compat: {
+        readonly sendSessionIdHeader: false;
+        readonly supportsLongCacheRetention: false;
+    };
 }, {
     id: string;
     name: string;

package/dist/xai-grok-build.js

@@ -29,10 +29,10 @@ const MODEL_COMPAT = {
     supportsLongCacheRetention: false,
 };
 // Catalog notes:
-// - Context windows and per-Mtok pricing for grok-build-0.1 and grok-4.3 are
-//   confirmed by xAI's live GET /v1/models (see `pnpm smoke:models`). Live
-//   pricing doubles past a 200k-token threshold; pi's cost model has no
-//   long-context tier, so the base tier is recorded.
+// - Context windows and per-Mtok pricing for grok-build-0.1, grok-4.3, and
+//   grok-4.5 are confirmed by xAI's live GET /v1/models (see
+//   `pnpm smoke:models`). Live pricing doubles past a 200k-token threshold;
+//   pi's cost model has no long-context tier, so the base tier is recorded.
 // - maxTokens values are third-party registry metadata, unverified against
 //   live output caps: pi-ai sends max_output_tokens only when stream options
 //   set maxTokens, which they normally don't.
@@ -40,6 +40,13 @@ const MODEL_COMPAT = {
 //   accepts /responses calls with a subscription OAuth token. Context/output
 //   metadata comes from third-party registries; pricing was supplied by the
 //   maintainer (not machine-verifiable against /models since it's unlisted).
+// - grok-4.5 is a reasoning model. xAI's docs specify reasoning_effort
+//   low/medium/high (default high, cannot be disabled); a live probe showed
+//   "minimal" and "xhigh" also return 200 but they are undocumented (and
+//   "xhigh" means agent count on grok-4.20-multi-agent, not depth), so only
+//   the documented levels are exposed: off/minimal/xhigh are nulled. Nulling
+//   "off" also stops pi's openai-responses path from sending
+//   `reasoning.effort: "none"` (a live 400) when no effort is set.
 //
 // The credential also sees media models (grok-imagine-image,
 // grok-imagine-image-quality, grok-imagine-video, grok-imagine-video-1.5).
@@ -81,6 +88,31 @@ export const GROK_43_MODEL = {
     maxTokens: 65_536,
     compat: MODEL_COMPAT,
 };
+/** Documented efforts only: low / medium / high (default high; see catalog notes). */
+const GROK_45_THINKING_LEVEL_MAP = {
+    off: null,
+    minimal: null,
+    xhigh: null,
+};
+export const GROK_45_MODEL = {
+    id: "grok-4.5",
+    name: "Grok 4.5",
+    api: "openai-responses",
+    provider: XAI_PROVIDER_ID,
+    baseUrl: XAI_BASE_URL,
+    reasoning: true,
+    thinkingLevelMap: GROK_45_THINKING_LEVEL_MAP,
+    input: ["text", "image"],
+    cost: {
+        input: 2,
+        output: 6,
+        cacheRead: 0.5,
+        cacheWrite: 0,
+    },
+    contextWindow: 500_000,
+    maxTokens: 65_536,
+    compat: MODEL_COMPAT,
+};
 export const GROK_COMPOSER_MODEL = {
     id: "grok-composer-2.5-fast",
     name: "Grok Composer 2.5 Fast",
@@ -99,7 +131,12 @@ export const GROK_COMPOSER_MODEL = {
     maxTokens: 32_768,
     compat: MODEL_COMPAT,
 };
-export const GROK_MODELS = [GROK_BUILD_MODEL, GROK_43_MODEL, GROK_COMPOSER_MODEL];
+export const GROK_MODELS = [
+    GROK_BUILD_MODEL,
+    GROK_43_MODEL,
+    GROK_45_MODEL,
+    GROK_COMPOSER_MODEL,
+];
 /** pi hands back `Record<string, unknown>`. Narrow at the boundary; fail fast. */
 export function requireXaiOAuthCredential(value) {
     const access = stringValue(value["access"]);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rise-so/pi-grok-build",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "type": "module",
   "description": "xAI Grok Build provider for pi: OAuth login (borrowed Grok CLI client) plus Grok chat models over the OpenAI Responses API. OAuth only. Usable as a pi extension or as a pi-ai library provider.",
   "license": "MIT",

package/src/extension.ts

@@ -63,6 +63,8 @@ export default function xaiGrokBuild(pi: ExtensionAPI): void {
       id: model.id,
       name: model.name,
       reasoning: model.reasoning,
+      // Only some catalog entries set thinkingLevelMap; `in` narrows the union.
+      ...("thinkingLevelMap" in model ? { thinkingLevelMap: { ...model.thinkingLevelMap } } : {}),
       input: [...model.input],
       cost: { ...model.cost },
       contextWindow: model.contextWindow,

package/src/provider.ts

@@ -27,6 +27,7 @@ import {
 
 export {
   GROK_43_MODEL,
+  GROK_45_MODEL,
   GROK_BUILD_MODEL,
   GROK_COMPOSER_MODEL,
   GROK_MODELS,

package/src/xai-grok-build.ts

@@ -36,10 +36,10 @@ const MODEL_COMPAT = {
 } as const;
 
 // Catalog notes:
-// - Context windows and per-Mtok pricing for grok-build-0.1 and grok-4.3 are
-//   confirmed by xAI's live GET /v1/models (see `pnpm smoke:models`). Live
-//   pricing doubles past a 200k-token threshold; pi's cost model has no
-//   long-context tier, so the base tier is recorded.
+// - Context windows and per-Mtok pricing for grok-build-0.1, grok-4.3, and
+//   grok-4.5 are confirmed by xAI's live GET /v1/models (see
+//   `pnpm smoke:models`). Live pricing doubles past a 200k-token threshold;
+//   pi's cost model has no long-context tier, so the base tier is recorded.
 // - maxTokens values are third-party registry metadata, unverified against
 //   live output caps: pi-ai sends max_output_tokens only when stream options
 //   set maxTokens, which they normally don't.
@@ -47,6 +47,13 @@ const MODEL_COMPAT = {
 //   accepts /responses calls with a subscription OAuth token. Context/output
 //   metadata comes from third-party registries; pricing was supplied by the
 //   maintainer (not machine-verifiable against /models since it's unlisted).
+// - grok-4.5 is a reasoning model. xAI's docs specify reasoning_effort
+//   low/medium/high (default high, cannot be disabled); a live probe showed
+//   "minimal" and "xhigh" also return 200 but they are undocumented (and
+//   "xhigh" means agent count on grok-4.20-multi-agent, not depth), so only
+//   the documented levels are exposed: off/minimal/xhigh are nulled. Nulling
+//   "off" also stops pi's openai-responses path from sending
+//   `reasoning.effort: "none"` (a live 400) when no effort is set.
 //
 // The credential also sees media models (grok-imagine-image,
 // grok-imagine-image-quality, grok-imagine-video, grok-imagine-video-1.5).
@@ -91,6 +98,33 @@ export const GROK_43_MODEL = {
   compat: MODEL_COMPAT,
 } satisfies Model<"openai-responses">;
 
+/** Documented efforts only: low / medium / high (default high; see catalog notes). */
+const GROK_45_THINKING_LEVEL_MAP = {
+  off: null,
+  minimal: null,
+  xhigh: null,
+} as const;
+
+export const GROK_45_MODEL = {
+  id: "grok-4.5",
+  name: "Grok 4.5",
+  api: "openai-responses",
+  provider: XAI_PROVIDER_ID,
+  baseUrl: XAI_BASE_URL,
+  reasoning: true,
+  thinkingLevelMap: GROK_45_THINKING_LEVEL_MAP,
+  input: ["text", "image"],
+  cost: {
+    input: 2,
+    output: 6,
+    cacheRead: 0.5,
+    cacheWrite: 0,
+  },
+  contextWindow: 500_000,
+  maxTokens: 65_536,
+  compat: MODEL_COMPAT,
+} satisfies Model<"openai-responses">;
+
 export const GROK_COMPOSER_MODEL = {
   id: "grok-composer-2.5-fast",
   name: "Grok Composer 2.5 Fast",
@@ -110,7 +144,12 @@ export const GROK_COMPOSER_MODEL = {
   compat: MODEL_COMPAT,
 } satisfies Model<"openai-responses">;
 
-export const GROK_MODELS = [GROK_BUILD_MODEL, GROK_43_MODEL, GROK_COMPOSER_MODEL] as const;
+export const GROK_MODELS = [
+  GROK_BUILD_MODEL,
+  GROK_43_MODEL,
+  GROK_45_MODEL,
+  GROK_COMPOSER_MODEL,
+] as const;
 
 export type XaiOptions = {
   /**