@vietor/agent-core 0.7.5 → 0.7.6

package/dist/tools/glob.js

@@ -1,6 +1,6 @@
 import { formatRipgrepOutput, ripgrepResultSummary, runRipgrepLines } from "../util/ripgrep.js";
 import { NO_MATCHES } from "../util/constants.js";
-import { resolveOptionalPath } from "../util/file.js";
+import { resolveSearchPath } from "../util/file.js";
 const DESCRIPTION = "List files under a directory, optionally filtered by a glob pattern (e.g. **/*.ts). Skips node_modules and .git.";
 export const globTool = {
     name: "Glob",
@@ -15,12 +15,12 @@ export const globTool = {
         required: [],
     },
     async execute(args, ctx) {
-        const cwd = resolveOptionalPath(args, ctx.cwd);
+        const { cwd, target } = resolveSearchPath(args, ctx.cwd);
         const rgArgs = ["--files"];
         const pattern = args.pattern;
         if (pattern)
             rgArgs.push("-g", pattern);
-        rgArgs.push(".");
+        rgArgs.push(target);
         const { lines, truncated } = await runRipgrepLines(rgArgs, cwd, ctx.signal);
         return { content: formatRipgrepOutput(lines, truncated, NO_MATCHES) };
     },

package/dist/tools/grep.js

@@ -1,6 +1,6 @@
 import { formatRipgrepOutput, ripgrepResultSummary, runRipgrepLines } from "../util/ripgrep.js";
 import { DEFAULT_GREP_LIMIT, NO_MATCHES } from "../util/constants.js";
-import { resolveOptionalPath } from "../util/file.js";
+import { resolveSearchPath } from "../util/file.js";
 const DESCRIPTION = `Search file contents recursively for a regex pattern (RE2 syntax). Skips node_modules and .git. Returns path:line:content, capped at ${DEFAULT_GREP_LIMIT} lines. For large codebases, use output_mode=files_with_matches first, or narrow with glob/type, or raise head_limit.`;
 export const grepTool = {
     name: "Grep",
@@ -10,7 +10,7 @@ export const grepTool = {
         type: "object",
         properties: {
             pattern: { type: "string" },
-            path: { type: "string", description: "root directory, defaults to cwd" },
+            path: { type: "string", description: "file or directory, defaults to cwd" },
             glob: { type: "string", description: "filter files, e.g. *.ts" },
             type: { type: "string", description: "file type, e.g. ts, js, py" },
             output_mode: { type: "string", enum: ["content", "files_with_matches", "count"], description: "defaults to content" },
@@ -25,7 +25,7 @@ export const grepTool = {
         required: ["pattern"],
     },
     async execute(args, ctx) {
-        const cwd = resolveOptionalPath(args, ctx.cwd);
+        const { cwd, target } = resolveSearchPath(args, ctx.cwd);
         const rgArgs = ["--line-number", "--with-filename", "--no-heading"];
         if (args.ignore_case)
             rgArgs.push("-i");
@@ -56,7 +56,7 @@ export const grepTool = {
             rgArgs.push("-c");
         else
             rgArgs.push("-m", String(headLimit));
-        rgArgs.push("--", args.pattern, ".");
+        rgArgs.push("--", args.pattern, target);
         const { lines, truncated } = await runRipgrepLines(rgArgs, cwd, ctx.signal, headLimit);
         return { content: formatRipgrepOutput(lines, truncated, NO_MATCHES) };
     },

package/dist/tools/sub-agent.js

@@ -1,5 +1,7 @@
 import { NOT_EXECUTED_PREFIX } from "../util/constants.js";
+import { summarizeText } from "../util/text.js";
 import { toolError } from "./types.js";
+const MAX_LABEL_LENGTH = 50;
 export const SUB_AGENT_GUIDANCE = '- Consider delegating to the SubAgent tool when the task matches an agent type, when you have independent work to run in parallel, or when answering would mean reading across several files — delegate and keep the conclusion, not the file dumps. type: "explore" — read-only search agent for broad fan-out searches (state the search breadth in the task); type: "plan" — software architect producing implementation plans. For a single-fact lookup where you already know the file, symbol, or value, search directly. Once you have delegated a search, do not also run it yourself — wait for the result. Issue at most 2 SubAgent calls per turn; multiple calls in the same turn run concurrently. Sub-agents are read-only and return only their final report, not intermediate steps — verify important results yourself. For large workloads with many independent items that would exceed the turn budget, split the items into chunks sized so each sub-agent can complete its chunk within its own loop budget, delegate one SubAgent per chunk, and run the remaining chunks in the following turns as results return. Instruct each sub-agent to report results per item in structured lines so you can consolidate.';
 const EXPLORE_PROMPT = [
     "You are the Explore sub-agent — a read-only search agent for broad fan-out searches. Use it when answering means sweeping many files, directories, or naming conventions and the parent needs only the conclusion, not the file dumps. You read excerpts rather than whole files, so you locate code — you do not review or audit it. You are read-only: you must not modify any files.",
@@ -51,11 +53,21 @@ export function createSubAgentTool(deps) {
                     enum: SUB_AGENT_DEFS.map((d) => d.type),
                     description: 'The sub-agent type to invoke: "explore" (read-only fan-out search) or "plan" (implementation plan).',
                 },
+                label: {
+                    type: "string",
+                    maxLength: MAX_LABEL_LENGTH,
+                    description: `Short label (max ${MAX_LABEL_LENGTH} characters) for this sub-agent run, shown in the UI.`,
+                },
                 task: { type: "string", description: "The task or question for the sub-agent, as a self-contained description." },
             },
             required: ["type", "task"],
         },
-        argSummaryKeys: ["type"],
+        summarizeArgs: (args) => {
+            const type = args.type;
+            const label = typeof args.label === "string" ? summarizeText(args.label, MAX_LABEL_LENGTH) : "";
+            const def = SUB_AGENT_DEFS.find((d) => d.type === type);
+            return (def?.name || type) + (label ? ` ${label}` : "");
+        },
         async execute(args, ctx) {
             const type = args.type;
             const task = (args.task ?? "").trim();
@@ -80,7 +92,7 @@ export function createSubAgentTool(deps) {
                 }
             }
             const suffix = stallReason ? ` ${stallReason}` : "";
-            return { content: `Sub-agent "${type}" ended with status ${status}.${suffix}\n\n${reply}`, isError: true };
+            return { content: `Sub-agent "${def.name}" ended with status ${status}.${suffix}\n\n${reply}`, isError: true };
         },
     };
 }

package/dist/util/async.js

@@ -11,7 +11,7 @@ export function isAbortError(e) {
     return name === "AbortError" || name === "APIUserAbortError";
 }
 export function backoffDelay(attempt) {
-    return 1000 * 2 ** attempt;
+    return Math.min(2000 * 2 ** attempt, 60_000);
 }
 export async function withRetry(fn, opts) {
     for (let attempt = 0;; attempt++) {

package/dist/util/file.d.ts

@@ -1,3 +1,6 @@
 export declare function tryReadFileText(path: string): string | undefined;
 export declare function resolveRequiredPath(args: Record<string, unknown>, cwd: string): string;
-export declare function resolveOptionalPath(args: Record<string, unknown>, cwd: string): string;
+export declare function resolveSearchPath(args: Record<string, unknown>, cwd: string): {
+    cwd: string;
+    target: string;
+};

package/dist/util/file.js

@@ -1,4 +1,4 @@
-import { existsSync, readFileSync } from "node:fs";
+import { existsSync, readFileSync, statSync } from "node:fs";
 import { resolve } from "node:path";
 export function tryReadFileText(path) {
     if (existsSync(path)) {
@@ -14,6 +14,10 @@ export function resolveRequiredPath(args, cwd) {
         throw new Error("path is required");
     return resolve(cwd, path);
 }
-export function resolveOptionalPath(args, cwd) {
-    return resolve(cwd, args.path || "");
+export function resolveSearchPath(args, cwd) {
+    const path = resolve(cwd, args.path || "");
+    if (existsSync(path) && !statSync(path).isDirectory()) {
+        return { cwd, target: path };
+    }
+    return { cwd: path, target: "." };
 }

package/package.json

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