Skip to content

Open source file-system and knowledge based agent template. Build AI agents that stay up to date with your knowledge base

improve how agent use tool

Hugo Richard12846cb9dc55
diff --git a/.agents/skills/.gitkeep b/.agents/skills/.gitkeep
new file mode 100644
index 0000000..e69de29
diff --git a/apps/chat/package.json b/apps/chat/package.json
index b570e08..b813ca4 100644
--- a/apps/chat/package.json
+++ b/apps/chat/package.json
@@ -18,8 +18,8 @@
"snapshot:create": "curl -X POST http://localhost:3000/api/sandbox/snapshot"
},
"dependencies": {
- "@ai-sdk/gateway": "^3.0.39",
- "@ai-sdk/vue": "^3.0.78",
+ "@ai-sdk/gateway": "^3.0.45",
+ "@ai-sdk/vue": "^3.0.85",
"@chat-adapter/discord": "^4.9.0",
"@chat-adapter/state-memory": "^4.9.0",
"@chat-adapter/state-redis": "^4.9.0",
@@ -40,7 +40,7 @@
"@vercel/blob": "^2.2.0",
"@vercel/functions": "^3.4.1",
"@vercel/sandbox": "^1.4.1",
- "ai": "^6.0.78",
+ "ai": "^6.0.85",
"better-auth": "^1.4.18",
"chat": "^4.9.0",
"date-fns": "^4.1.0",
diff --git a/apps/chat/server/utils/create-agent.ts b/apps/chat/server/utils/create-agent.ts
index be5ff0b..1f13220 100644
--- a/apps/chat/server/utils/create-agent.ts
+++ b/apps/chat/server/utils/create-agent.ts
@@ -1,9 +1,34 @@
import { stepCountIs, ToolLoopAgent } from 'ai'
+import type { ModelMessage } from '@ai-sdk/provider-utils'
+import { log } from 'evlog'
import type { AgentConfig } from './router/schema'
import { DEFAULT_MODEL } from './router/schema'
import type { AgentConfigData } from './agent-config'
import { getAgentConfig } from './agent-config'
+/**
+ * Ensure all tool-call `input` fields in messages are valid JSON objects.
+ * The Anthropic API rejects requests where `input` is a string instead of an object.
+ * This can happen when the AI SDK carries forward a raw JSON string from a previous step.
+ */
+function sanitizeToolCallInputs(messages: ModelMessage[]): ModelMessage[] {
+ for (const message of messages) {
+ if (message.role !== 'assistant' || !Array.isArray(message.content)) continue
+ for (const part of message.content) {
+ if (part.type === 'tool-call' && typeof part.input === 'string') {
+ log.warn('agent', `Sanitizing tool-call input for ${part.toolName}: input was a string, parsing to object`)
+ try {
+ part.input = JSON.parse(part.input)
+ }
+ catch {
+ part.input = {}
+ }
+ }
+ }
+ }
+ return messages
+}
+
export interface RoutingResult {
routerConfig: AgentConfig
agentConfig: AgentConfigData
@@ -77,7 +102,9 @@ export function createAgent({
stopWhen: stepCountIs(effectiveMaxSteps),
}
},
- prepareStep: ({ stepNumber }) => {
+ prepareStep: ({ stepNumber, messages }) => {
+ sanitizeToolCallInputs(messages)
+
if (isAdminMode) return
// Force text output on the last step by removing all tools
if (stepNumber >= maxSteps - 1) {
diff --git a/bun.lock b/bun.lock
index c2374c3..2219dae 100644
--- a/bun.lock
+++ b/bun.lock
@@ -13,8 +13,8 @@
"apps/chat": {
"name": "@savoir/chat",
"dependencies": {
- "@ai-sdk/gateway": "^3.0.39",
- "@ai-sdk/vue": "^3.0.78",
+ "@ai-sdk/gateway": "^3.0.45",
+ "@ai-sdk/vue": "^3.0.85",
"@chat-adapter/discord": "^4.9.0",
"@chat-adapter/state-memory": "^4.9.0",
"@chat-adapter/state-redis": "^4.9.0",
@@ -35,7 +35,7 @@
"@vercel/blob": "^2.2.0",
"@vercel/functions": "^3.4.1",
"@vercel/sandbox": "^1.4.1",
- "ai": "^6.0.78",
+ "ai": "^6.0.85",
"better-auth": "^1.4.18",
"chat": "^4.9.0",
"date-fns": "^4.1.0",
@@ -88,13 +88,13 @@
"minimatch": "^10.0.1",
},
"packages": {
- "@ai-sdk/gateway": ["@ai-sdk/[email protected]", "", { "dependencies": { "@ai-sdk/provider": "3.0.8", "@ai-sdk/provider-utils": "4.0.15", "@vercel/oidc": "3.1.0" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-zSKCsmSr+pSYMXQIg6eJell21gJZ6S/VTANS9bmDj2di9pew6hOld4mb57HJvnSLR2Hr+v8BSeQvEzxadR9eDQ=="],
+ "@ai-sdk/gateway": ["@ai-sdk/[email protected]", "", { "dependencies": { "@ai-sdk/provider": "3.0.8", "@ai-sdk/provider-utils": "4.0.15", "@vercel/oidc": "3.1.0" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-ZB6kHV+D8mLCRnkpWotLCV/rZK4NiODxx4Kv7JdT9QmQknbG/scbE4iyoT4JLFdULA8Y/IVbMvyE0Nwq3Dceqw=="],
"@ai-sdk/provider": ["@ai-sdk/[email protected]", "", { "dependencies": { "json-schema": "^0.4.0" } }, "sha512-oGMAgGoQdBXbZqNG0Ze56CHjDZ1IDYOwGYxYjO5KLSlz5HiNQ9udIXsPZ61VWaHGZ5XW/jyjmr6t2xz2jGVwbQ=="],
"@ai-sdk/provider-utils": ["@ai-sdk/[email protected]", "", { "dependencies": { "@ai-sdk/provider": "3.0.8", "@standard-schema/spec": "^1.1.0", "eventsource-parser": "^3.0.6" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-8XiKWbemmCbvNN0CLR9u3PQiet4gtEVIrX4zzLxnCj06AwsEDJwJVBbKrEI4t6qE8XRSIvU2irka0dcpziKW6w=="],
- "@ai-sdk/vue": ["@ai-sdk/[email protected]", "", { "dependencies": { "@ai-sdk/provider-utils": "4.0.15", "ai": "6.0.84", "swrv": "^1.0.4" }, "peerDependencies": { "vue": "^3.3.4" } }, "sha512-6zlo8gSRz0lPa6iiRwhde2jC/lBuTsKrpwNs0jf6cfrd/ABYaPLCkAytfpVdyp+3Ds4I14iZudHJ8XIRHnfsQw=="],
+ "@ai-sdk/vue": ["@ai-sdk/[email protected]", "", { "dependencies": { "@ai-sdk/provider-utils": "4.0.15", "ai": "6.0.85", "swrv": "^1.0.4" }, "peerDependencies": { "vue": "^3.3.4" } }, "sha512-UcT2doAybQTXhe/+1AjuKC0zsPSiI860U2U2YqErBWH9mGOzt2QDfNxZ+eSCJvAwJhmAfUmbz6OHk7TuE7drrQ=="],
"@alloc/quick-lru": ["@alloc/[email protected]", "", {}, "sha512-UrcABB+4bUrFABwbluTIBErXwvbsU/V7TZWfmbgJfbkwiBuziS9gxdODUyuiecfdGQ85jglMW6juS3+z5TsKLw=="],
@@ -1668,7 +1668,7 @@
"agent-base": ["[email protected]", "", {}, "sha512-MnA+YT8fwfJPgBx3m60MNqakm30XOkyIoH1y6huTQvC0PwZG7ki8NacLBcrPbNoo8vEZy7Jpuk7+jMO+CUovTQ=="],
- "ai": ["[email protected]", "", { "dependencies": { "@ai-sdk/gateway": "3.0.44", "@ai-sdk/provider": "3.0.8", "@ai-sdk/provider-utils": "4.0.15", "@opentelemetry/api": "1.9.0" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-dKYjHiWDvegJARWsl8pWCaeUWb1VJOzEdP9Hh7fWBCHUTF95c2TyZcUqbR5/XwKtWVue/8T9E/k5DPT9nFkF9Q=="],
+ "ai": ["[email protected]", "", { "dependencies": { "@ai-sdk/gateway": "3.0.45", "@ai-sdk/provider": "3.0.8", "@ai-sdk/provider-utils": "4.0.15", "@opentelemetry/api": "1.9.0" }, "peerDependencies": { "zod": "^3.25.76 || ^4.1.8" } }, "sha512-2bP7M+OcNQGSIH8I3jdujUadxj4tAwuHBvLhpmDSlcjRXXry3zNGEajjjRraOjObHMO/Yqa37PJWhPVHIHt2TQ=="],
"ajv": ["[email protected]", "", { "dependencies": { "fast-deep-equal": "^3.1.1", "fast-json-stable-stringify": "^2.0.0", "json-schema-traverse": "^0.4.1", "uri-js": "^4.2.2" } }, "sha512-j3fVLgvTo527anyYyJOGTYJbG+vnnQYvE0m5mmkc1TK+nxAppkCLMIL0aZ4dblVCNoGShhm+kzE4ZUykBoMg4g=="],
diff --git a/packages/sdk/src/tools/shell.ts b/packages/sdk/src/tools/shell.ts
index 5f9ba93..36cff2a 100644
--- a/packages/sdk/src/tools/shell.ts
+++ b/packages/sdk/src/tools/shell.ts
@@ -10,6 +10,10 @@ Use standard Unix commands to explore and read files.`,
inputSchema: z.object({
command: z.string().describe('Bash command to execute'),
}),
+ inputExamples: [
+ { input: { command: 'find docs/ -maxdepth 2 -type d' } },
+ { input: { command: 'grep -rl "useAsyncData" docs/ --include="*.md" | head -5' } },
+ ],
onInputAvailable: ({ toolCallId, input }) => {
onToolCall?.({
toolCallId,
@@ -84,6 +88,10 @@ Maximum 10 commands per batch.`,
inputSchema: z.object({
commands: z.array(z.string()).min(1).max(10).describe('Array of bash commands to execute'),
}),
+ inputExamples: [
+ { input: { commands: ['head -80 docs/getting-started.md', 'head -80 docs/installation.md'] } },
+ { input: { commands: ['grep -rl "routing" docs/ --include="*.md" | head -5', 'cat docs/api/reference.md'] } },
+ ],
onInputAvailable: ({ toolCallId, input }) => {
onToolCall?.({
toolCallId,