nodal-agents 0.4.2 → 0.4.3

package/README.md

@@ -16,12 +16,6 @@ connectors, and delegate to each other to get the job done.
 to install, runs on any machine with Node 22+ (Mac, PC, Linux), and works
 with **any LLM** — frontier or local, paid or free.
 
-> **Run the models others choke on.** DeepSeek V4 works out of the box —
-> including the cheap, fast OpenRouter routes — because the runtime quietly
-> handles its quirks (non-standard tool-call payloads) instead of failing.
-> Mix the right model per agent: a frontier model where judgment matters, a
-> near-free one where it doesn't.
-
 ---
 
 ## Why Nodal-Agents
@@ -29,7 +23,7 @@ with **any LLM** — frontier or local, paid or free.
 | | |
 | --- | --- |
 | 🏠  **Local-first** | Single binary, embedded Postgres, zero cloud dependency. Your conversations, memory, and credentials stay on your machine. |
-| 🔌  **Any model, per agent** | Anthropic, OpenAI, Google, Groq, Mistral, OpenRouter, or any local model (LM Studio, Ollama). Setup is just an API key per provider — **each agent picks its own model**, so you can run Claude for the orchestrator and **DeepSeek V4** for the workers. The quirks of OSS frontier models (DeepSeek's non-spec tool args, Kimi/Qwen/GLM XML tool formats) are handled automatically. |
+| 🔌  **Any model, per agent** | Anthropic, OpenAI, Google, Groq, Mistral, OpenRouter, or any local model (LM Studio, Ollama). Setup is just an API key per provider — **each agent picks its own model**, so you can run Claude for the orchestrator and **DeepSeek V4** for the workers. The quirks of OSS frontier models (DeepSeek's non-spec tool args, Kimi/Qwen/GLM XML tool formats, and round-tripping a reasoning model's chain-of-thought across tool calls so MiniMax M3 / DeepSeek / Gemini 3 don't degrade mid-task) are handled automatically. |
 | 🛟  **Provider failover** | Give an agent a backup key chain — if its provider 5xx's, times out, or hits quota mid-job, the runner fails over to the next one and keeps going (and fails loud only when the whole chain is down). |
 | 🧠  **Memory that compounds** | Persistent facts (entity-scoped, auto-injected into every job) and chat-thread continuity (your agent remembers what it said 30 seconds ago — and what it said yesterday). |
 | 🤝  **Orchestrators that finish** | Router and planner orchestrators delegate to specialist sub-agents, then resume on completion to wrap up the answer. |
@@ -90,7 +84,7 @@ When a newer version is available, `nodal-agents up` also prints a one-line
 notice:
 
 ```
-ℹ v0.4.2 available — run `nodal-agents update`
+ℹ v0.4.3 available — run `nodal-agents update`
 ```
 
 ### Build from source
@@ -218,7 +212,7 @@ pnpm deps:check   # runs locally and in CI before every release
 
 ## Status
 
-**Current release:** `0.4.2` on npm `latest`. Used daily by the
+**Current release:** `0.4.3` on npm `latest`. Used daily by the
 maintainer, stable enough for personal production. Pre-1.0 — breaking
 changes are still possible between minors.
 
@@ -227,7 +221,9 @@ changes are still possible between minors.
 - Multi-LLM, **per-agent model selection** — provider setup is just an API key
   (one per provider); each agent chooses its own model on top. Frontier and
   local providers, including **DeepSeek V4** (non-spec tool-call args normalized
-  automatically), plus native tool-call parsing for Kimi K2 / Qwen3-Coder / GLM
+  automatically) and **reasoning models like MiniMax M3** (their hidden
+  chain-of-thought is round-tripped across tool calls so they keep reasoning on
+  multi-turn tasks), plus native tool-call parsing for Kimi K2 / Qwen3-Coder / GLM
 - **Provider failover** — an opt-in ordered key chain per agent; on a 5xx /
   timeout / quota mid-job the runner fails over to the next key, and fails loud
   (`all_providers_failed`) only when the whole chain is exhausted

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nodal-agents",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Local-first AI agent platform with a web dashboard — install in one command.",
   "license": "MIT",
   "repository": {
@@ -46,6 +46,7 @@
     "@ai-sdk/openai": "^3.0.63",
     "@ai-sdk/openai-compatible": "^2.0.47",
     "@ai-sdk/provider": "^3.0.10",
+    "@openrouter/ai-sdk-provider": "^2.9.0",
     "ollama-ai-provider-v2": "^3.5.0",
     "googleapis": "^171.4.0",
     "@notionhq/client": "^2.3.0",

package/runner.js

@@ -1164,7 +1164,9 @@ var init_model_catalog = __esm({
       ],
       // OpenRouter models are namespaced by sub-vendor (anthropic/, deepseek/, …).
       // The UI groups them by that vendor (see modelGroupLabel). Tested + working
-      // routes; all accept a forced tool_choice.
+      // routes. `forcedToolChoice` is per-model: most accept tool_choice:'required';
+      // MiniMax M3 does not (some of its OpenRouter endpoints reject the forced
+      // value), so it runs on 'auto' + the runtime floor.
       openrouter: [
         // Anthropic
         {
@@ -1233,6 +1235,16 @@ var init_model_catalog = __esm({
           modelId: "google/gemma-4-31b-it",
           label: "Gemma 4 31B-IT",
           capabilities: { tools: true, forcedToolChoice: true }
+        },
+        // MiniMax
+        {
+          modelId: "minimax/minimax-m3",
+          label: "MiniMax M3",
+          // A reasoning model. Some of its OpenRouter endpoints reject a FORCED
+          // tool_choice ('required') → we send 'auto' (forcedToolChoice:false).
+          // reasoning:true makes the provider return reasoning_details so the runner
+          // can round-trip them across tool-call turns.
+          capabilities: { tools: true, forcedToolChoice: false, reasoning: true }
         }
       ]
     };
@@ -10946,7 +10958,8 @@ function buildGroqModel(config) {
 }
 
 // ../../packages/llm/src/providers/openrouter.ts
-import { createOpenAICompatible as createOpenAICompatible2 } from "@ai-sdk/openai-compatible";
+init_src();
+import { createOpenRouter } from "@openrouter/ai-sdk-provider";
 import { wrapLanguageModel } from "ai";
 
 // ../../packages/llm/src/providers/parsers.ts
@@ -11174,15 +11187,21 @@ function buildOpenRouterModel(config) {
     throw new ProviderConfigError("openrouter provider requires an apiKey");
   }
   const baseURL = config.baseURL ?? PROVIDER_PRESETS.openrouter.defaultBaseURL;
-  const provider = createOpenAICompatible2({
-    name: "openrouter",
-    baseURL,
+  const provider = createOpenRouter({
     apiKey: config.apiKey,
+    baseURL,
+    // 'strict' is the documented mode for the first-party OpenRouter API
+    // ('compatible' is for 3rd-party proxies). We hit openrouter.ai directly.
+    compatibility: "strict",
     // Normalise non-spec responses (e.g. DeepSeek V4 returning function.arguments
-    // as an object instead of a JSON string) before AI SDK's Zod schema sees them.
+    // as an object instead of a JSON string) before the SDK's Zod schema sees them.
     fetch: createTolerantFetch()
   });
-  const base = provider(config.model);
+  const isReasoning = findModelCatalogEntry("openrouter", config.model)?.capabilities.reasoning;
+  const base = provider.chat(
+    config.model,
+    isReasoning ? { extraBody: { reasoning: { enabled: true } } } : void 0
+  );
   const middleware = middlewareForFamily(detectAgenticFamily(config.model));
   if (middleware) {
     return wrapLanguageModel({ model: base, middleware });
@@ -28158,14 +28177,18 @@ async function executeJob(jobId, deps, _runnerEnv) {
         await failJob(db, jobId, "delivery_spam_guard", runStats());
         return { status: "failed", error: "delivery_spam_guard" };
       }
+      const reasoningParts = response.reasoning ?? [];
       const assistantMsg = {
         role: "assistant",
-        content: rawToolCalls.length > 0 ? rawToolCalls.map((tc) => ({
-          type: "tool-call",
-          toolCallId: tc.toolCallId,
-          toolName: tc.toolName,
-          input: tc.input
-        })) : response.text || ""
+        content: rawToolCalls.length > 0 ? [
+          ...reasoningParts,
+          ...rawToolCalls.map((tc) => ({
+            type: "tool-call",
+            toolCallId: tc.toolCallId,
+            toolName: tc.toolName,
+            input: tc.input
+          }))
+        ] : reasoningParts.length > 0 ? [...reasoningParts, { type: "text", text: response.text || "" }] : response.text || ""
       };
       messages = [...messages, assistantMsg];
       const returnResultCall = rawToolCalls.find((tc) => tc.toolName === "return_result");
@@ -29208,6 +29231,7 @@ var CHAT_TOOLS = {
     inputSchema: z89.object({ instruction: z89.string().min(1).max(4e3) })
   }
 };
+var ESCALATION_RECHECK = "Re-read your previous reply. If it committed to performing an action \u2014 running, launching, sending, fetching, creating, configuring, delegating, or any task or tool use \u2014 then your text ALONE did nothing: call the run_task tool NOW with a clear, self-contained instruction. If your reply was pure conversation, a question, or simply recalling a fact, do not call any tool \u2014 the conversation is complete.";
 async function runChatTurn(opts) {
   const { deps, entityId, agentId, conversationId, message } = opts;
   const db = deps.db;
@@ -29249,8 +29273,43 @@ async function runChatTurn(opts) {
     origin: "dashboard",
     surface: "chat"
   });
-  const rows = await db.select({ role: chatMessages.role, content: chatMessages.content }).from(chatMessages).where(eq4(chatMessages.conversationId, conversationId)).orderBy(desc(chatMessages.createdAt)).limit(HISTORY_LIMIT);
-  const messages = rows.reverse().map((r) => ({ role: r.role, content: r.content }));
+  const rows = await db.select({
+    role: chatMessages.role,
+    content: chatMessages.content,
+    jobId: chatMessages.jobId,
+    jobTask: agentJobs.task
+  }).from(chatMessages).leftJoin(agentJobs, eq4(chatMessages.jobId, agentJobs.id)).where(eq4(chatMessages.conversationId, conversationId)).orderBy(desc(chatMessages.createdAt)).limit(HISTORY_LIMIT);
+  const messages = [];
+  for (const r of rows.reverse()) {
+    if (r.role === "assistant" && r.jobId) {
+      const toolCallId = `hist-${r.jobId}`;
+      messages.push({
+        role: "assistant",
+        content: [
+          ...r.content ? [{ type: "text", text: r.content }] : [],
+          {
+            type: "tool-call",
+            toolCallId,
+            toolName: "run_task",
+            input: { instruction: r.jobTask ?? "" }
+          }
+        ]
+      });
+      messages.push({
+        role: "tool",
+        content: [
+          {
+            type: "tool-result",
+            toolCallId,
+            toolName: "run_task",
+            output: { type: "text", value: "Task dispatched." }
+          }
+        ]
+      });
+    } else {
+      messages.push({ role: r.role, content: r.content });
+    }
+  }
   let text22 = "";
   let runTask;
   try {
@@ -29261,7 +29320,23 @@ async function runChatTurn(opts) {
     });
     text22 = (response.text ?? "").trim();
     runTask = (response.toolCalls ?? []).find((tc) => tc.toolName === "run_task");
-  } catch {
+  } catch (err) {
+    console.warn(`[run-chat-turn] tools call failed (${agentRow.slug}):`, err.message);
+  }
+  if (!runTask && text22) {
+    try {
+      const recheck = await llmClient.generateText({
+        system: systemPrompt,
+        messages: [
+          ...messages,
+          { role: "assistant", content: text22 },
+          { role: "user", content: ESCALATION_RECHECK }
+        ],
+        tools: CHAT_TOOLS
+      });
+      runTask = (recheck.toolCalls ?? []).find((tc) => tc.toolName === "run_task");
+    } catch {
+    }
   }
   if (runTask) {
     const instruction = String(runTask.input?.instruction ?? "").trim() || message;

package/web/.next/BUILD_ID

@@ -1 +1 @@
-ZuUX-HBTQOhLf0tFI6JQI
+n6jP_zB4kqJScKY_T2ciu

package/web/.next/app-path-routes-manifest.json

@@ -13,8 +13,8 @@
   "/(dashboard)/agents/[id]/edit/page": "/agents/[id]/edit",
   "/(dashboard)/agents/[id]/telegram/page": "/agents/[id]/telegram",
   "/(dashboard)/agents/page": "/agents",
-  "/(dashboard)/automations/page": "/automations",
   "/(dashboard)/approvals/page": "/approvals",
+  "/(dashboard)/automations/page": "/automations",
   "/(dashboard)/chat/page": "/chat",
   "/(dashboard)/connectors/page": "/connectors",
   "/(dashboard)/credentials/page": "/credentials",

package/web/.next/build-manifest.json

@@ -4,8 +4,8 @@
   ],
   "devFiles": [],
   "lowPriorityFiles": [
-    "static/ZuUX-HBTQOhLf0tFI6JQI/_buildManifest.js",
-    "static/ZuUX-HBTQOhLf0tFI6JQI/_ssgManifest.js"
+    "static/n6jP_zB4kqJScKY_T2ciu/_buildManifest.js",
+    "static/n6jP_zB4kqJScKY_T2ciu/_ssgManifest.js"
   ],
   "rootMainFiles": [
     "static/chunks/webpack-3741bf0a7636d65e.js",

package/web/.next/prerender-manifest.json

@@ -78,8 +78,8 @@
   "dynamicRoutes": {},
   "notFoundRoutes": [],
   "preview": {
-    "previewModeId": "3ee52df782a2df2a4ee50789902ca7be",
-    "previewModeSigningKey": "89ca14b4b6d0a92f00c85b444ae7555c09e000f7447bbab9332647fa03c9e2ae",
-    "previewModeEncryptionKey": "c5e0ed4849dcf791d73cc1bb97004c7e4b13127cb4b820419f39aa7aea22021e"
+    "previewModeId": "98616a9865e16bddc6a1143b769ee98e",
+    "previewModeSigningKey": "ee3ee89f46a6815ae05eb06949ae794c6962a52e9a6f58e3dfbcf1c6614ff841",
+    "previewModeEncryptionKey": "c4c6b207c2e3329b64d6c383809a95a2f5f1f3ecd6c68005de252da1d057c7bb"
   }
 }