hoomanjs 1.6.0 → 1.7.0

package/README.md

@@ -26,7 +26,7 @@ It gives you:
 
 ## Features
 
-- Multiple LLM providers: `ollama`, `openai`, `anthropic`, `google`, `bedrock`, `groq`, `xai`
+- Multiple LLM providers: `ollama`, `openai`, `anthropic`, `google`, `bedrock`, `groq`, `moonshot`, `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
@@ -263,6 +263,7 @@ Supported `llm.provider` values:
 - `google`
 - `bedrock`
 - `groq`
+- `moonshot`
 - `xai`
 
 ## Provider Notes
@@ -345,6 +346,21 @@ Uses the Vercel AI SDK Groq provider (`@ai-sdk/groq`) on top of Strands `VercelM
 }
 ```
 
+### Moonshot
+
+Uses the Vercel AI SDK Moonshot provider (`@ai-sdk/moonshotai`) on top of Strands `VercelModel`. Provider-specific settings `apiKey`, `baseURL`, `headers`, and `fetch` are picked up; other values are forwarded into the model config (`temperature`, `maxTokens`, `providerOptions`, etc.). Defaults to `MOONSHOT_API_KEY` from the environment when no `apiKey` is supplied. Moonshot reasoning models such as `kimi-k2-thinking` can be configured through `params.providerOptions.moonshotai`.
+
+```json
+{
+  "provider": "moonshot",
+  "model": "kimi-k2.5",
+  "params": {
+    "apiKey": "...",
+    "temperature": 0.7
+  }
+}
+```
+
 ### 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.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "hoomanjs",
-  "version": "1.6.0",
+  "version": "1.7.0",
   "description": "Bun-powered local AI agent CLI with chat, exec, ACP, MCP, and skills support.",
   "author": {
     "name": "Vaibhav Pandey",
@@ -52,6 +52,7 @@
     "@agentclientprotocol/sdk": "^0.18.2",
     "@ai-sdk/anthropic": "^3.0.69",
     "@ai-sdk/groq": "^3.0.35",
+    "@ai-sdk/moonshotai": "^2.0.16",
     "@ai-sdk/xai": "^3.0.83",
     "@aws-sdk/client-bedrock-runtime": "^3.1028.0",
     "@google/genai": "^1.40.0",

package/src/core/config.ts

@@ -6,6 +6,7 @@ export enum LlmProvider {
   Anthropic = "anthropic",
   Google = "google",
   Groq = "groq",
+  Moonshot = "moonshot",
   OpenAI = "openai",
   Ollama = "ollama",
   Bedrock = "bedrock",

package/src/core/models/index.ts

@@ -12,6 +12,7 @@ export const modelProviders: Record<string, () => Promise<ModelProvider>> = {
   bedrock: () => import("./bedrock.ts"),
   google: () => import("./google.ts"),
   groq: () => import("./groq.ts"),
+  moonshot: () => import("./moonshot.ts"),
   ollama: () => import("./ollama/index.ts"),
   openai: () => import("./openai.ts"),
   xai: () => import("./xai.ts"),

package/src/core/models/moonshot.ts

@@ -0,0 +1,54 @@
+import { createMoonshotAI, moonshotai } from "@ai-sdk/moonshotai";
+import { VercelModel } from "@strands-agents/sdk/models/vercel";
+import type { MoonshotAIProviderSettings } from "@ai-sdk/moonshotai";
+import type { VercelModelConfig } from "@strands-agents/sdk/models/vercel";
+import { omit, pick } from "lodash";
+
+const PROVIDER_SETTINGS_KEYS = [
+  "apiKey",
+  "baseURL",
+  "headers",
+  "fetch",
+] as const;
+
+function pickProviderSettings(
+  params: Record<string, unknown>,
+): MoonshotAIProviderSettings {
+  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 MoonshotAIProviderSettings;
+}
+
+function pickVercelModelConfig(
+  params: Record<string, unknown>,
+): Partial<VercelModelConfig> {
+  return omit(params, [
+    ...PROVIDER_SETTINGS_KEYS,
+  ]) as Partial<VercelModelConfig>;
+}
+
+/**
+ * Moonshot AI via AI SDK + Strands {@link VercelModel}.
+ *
+ * - **`config.llm.model`**: model id passed to `moonshotai(...)` (e.g. `kimi-k2.5`).
+ * - **`params`**: {@link MoonshotAIProviderSettings} (`apiKey`, `baseURL`, `headers`, `fetch`).
+ *   If none are set, the default provider is used (`MOONSHOT_API_KEY` from env).
+ * - Any other `params` keys are forwarded as {@link VercelModelConfig} (e.g. `temperature`,
+ *   `maxTokens`, `providerOptions`).
+ */
+export function create(
+  model: string,
+  params: Record<string, unknown> = {},
+): VercelModel {
+  const settings = pickProviderSettings(params);
+  const provider =
+    Object.keys(settings).length > 0 ? createMoonshotAI(settings) : moonshotai;
+  const config = pickVercelModelConfig(params);
+  return new VercelModel({
+    provider: provider(model),
+    ...config,
+  });
+}