hoomanjs 1.3.0 → 1.4.0

package/README.md

@@ -26,7 +26,7 @@ It gives you:
 
 ## Features
 
-- Multiple LLM providers: `ollama`, `openai`, `anthropic`, `google`, `bedrock`
+- Multiple LLM providers: `ollama`, `openai`, `anthropic`, `google`, `bedrock`, `xai`
 - Local configuration under `~/.hooman`
 - MCP server support via `stdio`, `streamable-http`, and `sse`
 - MCP server `instructions` support: server-provided instructions are appended to the agent system prompt
@@ -262,6 +262,7 @@ Supported `llm.provider` values:
 - `anthropic`
 - `google`
 - `bedrock`
+- `xai`
 
 ## Provider Notes
 
@@ -328,6 +329,21 @@ Uses Strands `GoogleModel` on top of `@google/genai`. Top-level options like `ap
 
 Supports `region`, `clientConfig`, and optional `apiKey`, with all other values forwarded as Bedrock model options.
 
+### xAI
+
+Uses the Vercel AI SDK xAI provider (`@ai-sdk/xai`) on top of Strands `VercelModel`. Provider-specific settings `apiKey`, `baseURL`, and `headers` are picked up; other values are forwarded into the model config (`temperature`, `maxTokens`, etc.). Defaults to `XAI_API_KEY` from the environment when no `apiKey` is supplied.
+
+```json
+{
+  "provider": "xai",
+  "model": "grok-4.20-non-reasoning",
+  "params": {
+    "apiKey": "...",
+    "temperature": 0.7
+  }
+}
+```
+
 ## MCP Configuration
 
 `mcp.json` is stored as:

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hoomanjs",
-  "version": "1.3.0",
+  "version": "1.4.0",
   "description": "Bun-powered local AI agent CLI with chat, exec, ACP, MCP, and skills support.",
   "author": {
     "name": "Vaibhav Pandey",
@@ -51,6 +51,7 @@
   "dependencies": {
     "@agentclientprotocol/sdk": "^0.18.2",
     "@ai-sdk/anthropic": "^3.0.69",
+    "@ai-sdk/xai": "^3.0.83",
     "@aws-sdk/client-bedrock-runtime": "^3.1028.0",
     "@google/genai": "^1.40.0",
     "@huggingface/transformers": "^4.0.1",

package/src/core/config.ts

@@ -8,6 +8,7 @@ export enum LlmProvider {
   OpenAI = "openai",
   Ollama = "ollama",
   Bedrock = "bedrock",
+  Xai = "xai",
 }
 
 const LlmSchema = z.object({

package/src/core/models/index.ts

@@ -13,4 +13,5 @@ export const modelProviders: Record<string, () => Promise<ModelProvider>> = {
   google: () => import("./google.ts"),
   ollama: () => import("./ollama/index.ts"),
   openai: () => import("./openai.ts"),
+  xai: () => import("./xai.ts"),
 };

package/src/core/models/xai.ts

@@ -0,0 +1,47 @@
+import { createXai, xai } from "@ai-sdk/xai";
+import { VercelModel } from "@strands-agents/sdk/models/vercel";
+import type { XaiProviderSettings } from "@ai-sdk/xai";
+import type { VercelModelConfig } from "@strands-agents/sdk/models/vercel";
+import { omit, pick } from "lodash";
+
+const PROVIDER_SETTINGS_KEYS = ["apiKey", "baseURL", "headers"] as const;
+
+function pickProviderSettings(
+  params: Record<string, unknown>,
+): XaiProviderSettings {
+  const picked = pick(params, [...PROVIDER_SETTINGS_KEYS]) as Record<
+    string,
+    unknown
+  >;
+  const unset = Object.keys(picked).filter((k) => picked[k] === undefined);
+  return omit(picked, unset) as XaiProviderSettings;
+}
+
+function pickVercelModelConfig(
+  params: Record<string, unknown>,
+): Partial<VercelModelConfig> {
+  return omit(params, [
+    ...PROVIDER_SETTINGS_KEYS,
+  ]) as Partial<VercelModelConfig>;
+}
+
+/**
+ * xAI (Grok) via AI SDK + Strands {@link VercelModel}.
+ *
+ * - **`config.llm.model`**: model id passed to `xai(...)` (e.g. `grok-4.20-non-reasoning`).
+ * - **`params`**: {@link XaiProviderSettings} (`apiKey`, `baseURL`, `headers`).
+ *   If none are set, the default provider is used (`XAI_API_KEY` from env).
+ * - Any other `params` keys are forwarded as {@link VercelModelConfig} (e.g. `temperature`, `maxTokens`).
+ */
+export function create(
+  model: string,
+  params: Record<string, unknown> = {},
+): VercelModel {
+  const settings = pickProviderSettings(params);
+  const provider = Object.keys(settings).length > 0 ? createXai(settings) : xai;
+  const config = pickVercelModelConfig(params);
+  return new VercelModel({
+    provider: provider(model),
+    ...config,
+  });
+}