@sisu-ai/mw-tool-calling 9.0.4 → 10.0.0

package/README.md

@@ -88,6 +88,22 @@ agent.use(toolCalling);
 agent.use(iterativeToolCalling);
 ```
 
+## Tool Execution Records
+
+Each executed tool call is appended to `ctx.state.toolExecutions`:
+
+```ts
+type ToolExecutionRecord = {
+  aliasName: string;
+  canonicalName: string;
+  callId?: string;
+  args: unknown;
+  result: unknown;
+};
+```
+
+This is useful for diagnostics and post-run inspection without manually parsing `tool` messages.
+
 # Community & Support
 
 Discover what you can do through examples or documentation. Check it out at https://github.com/finger-gun/sisu. Example projects live under [`examples/`](https://github.com/finger-gun/sisu/tree/main/examples) in the repo.
@@ -133,9 +149,9 @@ Discover what you can do through examples or documentation. Check it out at http
 - [@sisu-ai/tool-azure-blob](packages/tools/azure-blob/README.md)
 - [@sisu-ai/tool-extract-urls](packages/tools/extract-urls/README.md)
 - [@sisu-ai/tool-github-projects](packages/tools/github-projects/README.md)
+- [@sisu-ai/tool-rag](packages/tools/rag/README.md)
 - [@sisu-ai/tool-summarize-text](packages/tools/summarize-text/README.md)
 - [@sisu-ai/tool-terminal](packages/tools/terminal/README.md)
-- [@sisu-ai/tool-vec-chroma](packages/tools/vec-chroma/README.md)
 - [@sisu-ai/tool-web-fetch](packages/tools/web-fetch/README.md)
 - [@sisu-ai/tool-web-search-duckduckgo](packages/tools/web-search-duckduckgo/README.md)
 - [@sisu-ai/tool-web-search-google](packages/tools/web-search-google/README.md)
@@ -143,6 +159,19 @@ Discover what you can do through examples or documentation. Check it out at http
 - [@sisu-ai/tool-wikipedia](packages/tools/wikipedia/README.md)
 </details>
 
+<details>
+<summary>All RAG packages</summary>
+
+- [@sisu-ai/rag-core](packages/rag/core/README.md)
+</details>
+
+<details>
+<summary>All vector packages</summary>
+
+- [@sisu-ai/vector-core](packages/vector/core/README.md)
+- [@sisu-ai/vector-chroma](packages/vector/chroma/README.md)
+</details>
+
 <details>
 <summary>All examples</summary>
 

package/dist/index.js

@@ -1,3 +1,11 @@
+function pushToolExecution(ctx, record) {
+    const existing = ctx.state.toolExecutions;
+    if (Array.isArray(existing)) {
+        existing.push(record);
+        return;
+    }
+    ctx.state.toolExecutions = [record];
+}
 /**
  * Apply user-configured aliases to tools before passing to adapter.
  * Creates new tool objects with aliased names while keeping originals in registry.
@@ -29,6 +37,35 @@ function applyAliasesToTools(tools, aliasMap) {
     }
     return { aliasedTools, reverseMap };
 }
+function hasParseSchema(schema) {
+    if (!schema || typeof schema !== "object") {
+        return false;
+    }
+    const maybeSchema = schema;
+    return typeof maybeSchema.parse === "function";
+}
+function normalizeToolArguments(args) {
+    if (typeof args !== "string") {
+        return args;
+    }
+    let current = args;
+    for (let i = 0; i < 2; i++) {
+        if (typeof current !== "string") {
+            return current;
+        }
+        const trimmed = current.trim();
+        if (!trimmed) {
+            return args;
+        }
+        try {
+            current = JSON.parse(trimmed);
+        }
+        catch {
+            return current;
+        }
+    }
+    return current;
+}
 export const toolCalling = async (ctx, next) => {
     await next();
     const toolList = ctx.tools.list();
@@ -85,9 +122,11 @@ export const toolCalling = async (ctx, next) => {
                 const key = keyOf(call);
                 let result = cache.get(key);
                 if (result === undefined) {
-                    const args = tool.schema?.parse
-                        ? tool.schema.parse(call.arguments)
-                        : call.arguments;
+                    const schema = tool.schema;
+                    const normalizedArgs = normalizeToolArguments(call.arguments);
+                    const args = hasParseSchema(schema)
+                        ? schema.parse(normalizedArgs)
+                        : normalizedArgs;
                     ctx.log.debug?.("[tool-calling] invoking tool", {
                         aliasName: call.name,
                         canonicalName: canonicalName,
@@ -117,6 +156,13 @@ export const toolCalling = async (ctx, next) => {
                     ...(call.id ? { tool_call_id: call.id } : { name: call.name }),
                 };
                 ctx.messages.push(toolMsg);
+                pushToolExecution(ctx, {
+                    aliasName: call.name,
+                    canonicalName,
+                    callId: call.id,
+                    args: lastArgsByName.get(call.name),
+                    result,
+                });
                 ctx.log.debug?.("[tool-calling] tool result appended", {
                     name: call.name,
                     id: call.id,
@@ -181,9 +227,11 @@ export const iterativeToolCalling = async (ctx, next) => {
                 const key = keyOf(call);
                 let result = cache.get(key);
                 if (result === undefined) {
-                    const args = tool.schema?.parse
-                        ? tool.schema.parse(call.arguments)
-                        : call.arguments;
+                    const schema = tool.schema;
+                    const normalizedArgs = normalizeToolArguments(call.arguments);
+                    const args = hasParseSchema(schema)
+                        ? schema.parse(normalizedArgs)
+                        : normalizedArgs;
                     ctx.log.debug?.("[iterative-tool-calling] invoking tool", {
                         aliasName: call.name,
                         canonicalName: canonicalName,
@@ -215,6 +263,13 @@ export const iterativeToolCalling = async (ctx, next) => {
                     ...(call.id ? { tool_call_id: call.id } : { name: call.name }),
                 };
                 ctx.messages.push(toolMsg);
+                pushToolExecution(ctx, {
+                    aliasName: call.name,
+                    canonicalName,
+                    callId: call.id,
+                    args: lastArgsByName.get(call.name),
+                    result,
+                });
             }
             continue; // next round may call more tools
         }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@sisu-ai/mw-tool-calling",
-  "version": "9.0.4",
+  "version": "10.0.0",
   "license": "Apache-2.0",
   "type": "module",
   "main": "dist/index.js",
@@ -12,7 +12,7 @@
     "access": "public"
   },
   "peerDependencies": {
-    "@sisu-ai/core": "^2.3.3"
+    "@sisu-ai/core": "^2.4.0"
   },
   "repository": {
     "type": "git",