@vietor/agent-core 0.7.2 → 0.7.3

package/README.md

@@ -425,7 +425,7 @@ interface Tool {
   readOnly?: boolean;
   description: string;
   parameters: Record<string, unknown>;   // JSON Schema object
-  summaryKeys?: string[];                // parameter keys used for display summary
+  argSummaryKeys?: string[];                // parameter keys used for display summary
   summarizeArgs?: (args: Record<string, unknown>) => string; // custom summary function
   summarizeResult?(result: TextResult): string; // result summary for timeline display
   execute(args: Record<string, unknown>, ctx: ToolContext): Promise<TextResult>;
@@ -436,7 +436,7 @@ interface Tool {
 - `parameters` is passed to the LLM as a JSON Schema to describe the tool's arguments.
 - When the LLM calls a tool, `execute` receives the parsed arguments and a context object.
 - `execute` returns a `TextResult` (`{ content, isError? }`). Expected failures return `toolError(...)` (exported from the package); unexpected errors may throw and are wrapped by the registry.
-- `summaryKeys` / `summarizeArgs` control what appears in the tool log entry's `argsSummary` field.
+- `argSummaryKeys` / `summarizeArgs` control what appears in the tool log entry's `argsSummary` field.
 - `summarizeResult` (optional) returns a short result summary for timeline display. Called after execution with the result; the registry prefixes the wall-clock duration. Falls back to a default summary (byte/line count) when not defined.
 
 ### `ToolContext`

package/dist/mcp/manager.js

@@ -125,12 +125,12 @@ export class MCPServerManager {
         this.markFailed(name, entry.type, error ?? "MCP server connection closed");
     }
     adapt(server, client, tool) {
-        const summaryKeys = summaryCandidates(tool.inputSchema);
+        const argSummaryKeys = summaryCandidates(tool.inputSchema);
         return {
             name: mcpToolName(server, tool.name),
             description: tool.description ?? `${server} ${tool.name}`,
             parameters: tool.inputSchema,
-            ...(summaryKeys.length ? { summaryKeys } : {}),
+            ...(argSummaryKeys.length ? { argSummaryKeys } : {}),
             async execute(args, ctx) {
                 const result = await withTimeoutFn((signal) => client.callTool(tool.name, args, signal), CALL_TIMEOUT_MS, ctx.signal, `MCP tool call timed out (${CALL_TIMEOUT_MS / 1000}s)`);
                 const text = extractContent(result);

package/dist/tools/ask-user.js

@@ -21,6 +21,6 @@ export function createAskUserTool(ask) {
             }
             return { content: await ask(question, options) };
         },
-        summaryKeys: ["question"],
+        argSummaryKeys: ["question"],
     };
 }

package/dist/tools/file-edit.js

@@ -39,5 +39,5 @@ export const fileEditTool = {
             return "Edit failed";
         return "Edit completed";
     },
-    summaryKeys: ["path"],
+    argSummaryKeys: ["path"],
 };

package/dist/tools/file-read.js

@@ -89,5 +89,5 @@ export const fileReadTool = {
     summarizeResult(result) {
         return summaryBytes("Read", result, "Read failed");
     },
-    summaryKeys: ["path"],
+    argSummaryKeys: ["path"],
 };

package/dist/tools/file-write.js

@@ -21,5 +21,5 @@ export const fileWriteTool = {
             return "Write failed";
         return "Write completed";
     },
-    summaryKeys: ["path"],
+    argSummaryKeys: ["path"],
 };

package/dist/tools/glob.js

@@ -27,5 +27,5 @@ export const globTool = {
     summarizeResult(result) {
         return ripgrepResultSummary("file", result, "Glob failed", "Found 0 files");
     },
-    summaryKeys: ["pattern", "path"],
+    argSummaryKeys: ["pattern", "path"],
 };

package/dist/tools/grep.js

@@ -63,5 +63,5 @@ export const grepTool = {
     summarizeResult(result) {
         return ripgrepResultSummary("match", result, "Grep failed", "Found 0 matches");
     },
-    summaryKeys: ["pattern", "path", "glob"],
+    argSummaryKeys: ["pattern", "path", "glob"],
 };

package/dist/tools/registry.js

@@ -76,10 +76,10 @@ export class ToolRegistry {
             return "";
         if (tool.summarizeArgs)
             return tool.summarizeArgs(args);
-        if (!tool.summaryKeys)
+        if (!tool.argSummaryKeys)
             return "";
         const parts = [];
-        for (const k of tool.summaryKeys) {
+        for (const k of tool.argSummaryKeys) {
             const v = args[k];
             if (typeof v === "string" && v) {
                 parts.push(v);

package/dist/tools/shell.js

@@ -53,5 +53,5 @@ export const shellTool = {
     summarizeResult(result) {
         return summaryBytes("Command executed", result, "Command failed");
     },
-    summaryKeys: ["command"],
+    argSummaryKeys: ["command"],
 };

package/dist/tools/skill.js

@@ -12,7 +12,7 @@ export function createSkillTool(resolve) {
             },
             required: ["name"],
         },
-        summaryKeys: ["name"],
+        argSummaryKeys: ["name"],
         async execute(args, _ctx) {
             const name = (args.name || "").trim();
             if (!name) {

package/dist/tools/sub-agent.js

@@ -55,7 +55,7 @@ export function createSubAgentTool(deps) {
             },
             required: ["type", "task"],
         },
-        summaryKeys: ["type"],
+        argSummaryKeys: ["type"],
         async execute(args, ctx) {
             const type = args.type;
             const task = (args.task ?? "").trim();

package/dist/tools/types.d.ts

@@ -25,7 +25,7 @@ export interface Tool {
     readOnly?: boolean;
     description: string;
     parameters: Record<string, unknown>;
-    summaryKeys?: string[];
+    argSummaryKeys?: string[];
     summarizeArgs?: (args: Record<string, unknown>) => string;
     summarizeResult?(result: TextResult): string;
     execute(args: Record<string, unknown>, ctx: ToolContext): Promise<TextResult>;

package/dist/tools/web-fetch.js

@@ -100,5 +100,5 @@ export const webFetchTool = {
     summarizeResult(result) {
         return summaryBytes("Fetched", result, "Fetch failed");
     },
-    summaryKeys: ["url"],
+    argSummaryKeys: ["url"],
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vietor/agent-core",
-  "version": "0.7.2",
+  "version": "0.7.3",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",