@vietor/agent-core 0.7.0 → 0.7.2

package/README.md

@@ -787,6 +787,18 @@ interface ProcessResult {
 }
 ```
 
+### `findCommands`
+
+**`findCommands(commands: string[]): string[]`**
+
+Return the subset of commands that exist on the PATH (uses `where` on Windows, `command -v` elsewhere). Useful for picking an available interpreter, e.g. `node` vs `bun`.
+
+```ts
+import { findCommands } from "@vietor/agent-core/util";
+
+findCommands(["python", "python3"]);   // e.g. ["python"]
+```
+
 ## File
 
 ### `tryReadFileText`
@@ -839,7 +851,7 @@ const data = await res.json();
 
 ## Constants
 
-Default values mirrored by `LLMConfig` — exported so host config types can reference the same defaults.
+Default values mirrored by `LLMConfig` — exported so host config types can reference the same defaults. Tool-call timeouts and empty results also share constants here:
 
 | Constant | Value | Meaning |
 |---|---|---|
@@ -847,3 +859,5 @@ Default values mirrored by `LLMConfig` — exported so host config types can ref
 | `DEFAULT_BACKEND` | `"completions"` | Default `LLMConfig.backend` |
 | `DEFAULT_MAX_INPUT_TOKENS` | `1_000_000` | Default `LLMConfig.maxInputTokens` |
 | `DEFAULT_MAX_OUTPUT_TOKENS` | `128_000` | Default `LLMConfig.maxOutputTokens` |
+| `CALL_TIMEOUT_MS` | `300_000` | Default tool-call timeout (Shell, MCP tools) |
+| `NO_OUTPUT` | `"(no output)"` | Content placeholder for empty tool results |

package/dist/index.d.ts

@@ -5,7 +5,7 @@ export { INITIAL_RUN_METRICS, type SessionEvent, type TimelineEvent, type RunMet
 export type { Tool, ToolContext, ToolSchema, Todo, TodoStatus, TextResult } from "./tools/types.js";
 export { toolError } from "./tools/types.js";
 export type { BuiltinToolsOptions } from "./tools/registry.js";
-export type { Skill } from "./skills/loader.js";
+export type { Skill } from "./skills/types.js";
 export { tryLoadSkills } from "./skills/loader.js";
 export type { MCPClientInfo, MCPServerConfig, MCPServerInfo } from "./mcp/types.js";
 export type { LLMConfig, LLMThinkingEffort, LLMBackend } from "./llm/types.js";

package/dist/runtime/agent.d.ts

@@ -1,7 +1,7 @@
 import type { LLMClient } from "../llm/types.js";
 import { SessionMessages, type SessionMessage } from "./session-messages.js";
 import type { SessionEvent } from "./events.js";
-import type { Skill } from "../skills/loader.js";
+import type { Skill } from "../skills/types.js";
 import type { ToolRegistry } from "../tools/registry.js";
 import type { Todo } from "../tools/types.js";
 export type RunStatus = "ok" | "aborted" | "error" | "stalled" | "maxTurns";

package/dist/runtime/session.d.ts

@@ -1,7 +1,7 @@
 import type { LLMClient, LLMConfig } from "../llm/types.js";
 import type { MCPServerManager } from "../mcp/manager.js";
 import type { MCPServerConfig, MCPServerInfo } from "../mcp/types.js";
-import type { Skill } from "../skills/loader.js";
+import type { Skill } from "../skills/types.js";
 import { type BuiltinToolsOptions, type ToolRegistry } from "../tools/registry.js";
 import type { Todo, Tool } from "../tools/types.js";
 import { type SessionEvent, type TimelineEvent } from "./events.js";

package/dist/skills/loader.d.ts

@@ -1,6 +1,2 @@
-export interface Skill {
-    name: string;
-    description?: string;
-    prompt: string;
-}
+import { type Skill } from "./types.js";
 export declare function tryLoadSkills(path: string): Skill[] | undefined;

package/dist/skills/loader.js

@@ -1,6 +1,7 @@
 import { existsSync, readdirSync } from "node:fs";
 import { join } from "node:path";
 import { tryReadFileText } from "../util/file.js";
+import {} from "./types.js";
 function parseSkillFile(skillName, skillFile) {
     const content = tryReadFileText(skillFile);
     if (!content)

package/dist/skills/types.d.ts

@@ -0,0 +1,5 @@
+export interface Skill {
+    name: string;
+    description?: string;
+    prompt: string;
+}

package/dist/skills/types.js

@@ -0,0 +1 @@
+export {};

package/dist/tools/registry.d.ts

@@ -1,6 +1,6 @@
 import type { Tool, ToolContext, ToolSchema, Todo } from "./types.js";
 import { type SubAgentToolDeps } from "./sub-agent.js";
-import type { Skill } from "../skills/loader.js";
+import type { Skill } from "../skills/types.js";
 import type { TextResult } from "./types.js";
 export declare class ToolRegistry {
     private tools;

package/dist/tools/skill.d.ts

@@ -1,3 +1,3 @@
-import type { Skill } from "../skills/loader.js";
+import type { Skill } from "../skills/types.js";
 import type { Tool } from "./types.js";
 export declare function createSkillTool(resolve: (name: string) => Skill | undefined): Tool;

package/dist/util/index.d.ts

@@ -1,7 +1,7 @@
 export { AbortedError, backoffDelay, isAbortError, mapWithConcurrency, withAbort, withRetry, withTimeout, withTimeoutFn, type RetryOptions } from "./async.js";
-export { DEFAULT_BACKEND, DEFAULT_MAX_INPUT_TOKENS, DEFAULT_MAX_OUTPUT_TOKENS, DEFAULT_THINKING_EFFORT } from "./constants.js";
+export { DEFAULT_BACKEND, DEFAULT_MAX_INPUT_TOKENS, DEFAULT_MAX_OUTPUT_TOKENS, DEFAULT_THINKING_EFFORT, CALL_TIMEOUT_MS, NO_OUTPUT } from "./constants.js";
 export { tryReadFileText } from "./file.js";
 export { htmlToMarkdown } from "./html.js";
 export { netFetch } from "./net.js";
-export { type ProcessResult, runProcess } from "./subprocess.js";
+export { type ProcessResult, runProcess, findCommands } from "./subprocess.js";
 export { formatCompactNumber, formatDuration, getTextBytes, summarizeText, toErrorMessage } from "./text.js";

package/dist/util/index.js

@@ -1,7 +1,7 @@
 export { AbortedError, backoffDelay, isAbortError, mapWithConcurrency, withAbort, withRetry, withTimeout, withTimeoutFn } from "./async.js";
-export { DEFAULT_BACKEND, DEFAULT_MAX_INPUT_TOKENS, DEFAULT_MAX_OUTPUT_TOKENS, DEFAULT_THINKING_EFFORT } from "./constants.js";
+export { DEFAULT_BACKEND, DEFAULT_MAX_INPUT_TOKENS, DEFAULT_MAX_OUTPUT_TOKENS, DEFAULT_THINKING_EFFORT, CALL_TIMEOUT_MS, NO_OUTPUT } from "./constants.js";
 export { tryReadFileText } from "./file.js";
 export { htmlToMarkdown } from "./html.js";
 export { netFetch } from "./net.js";
-export { runProcess } from "./subprocess.js";
+export { runProcess, findCommands } from "./subprocess.js";
 export { formatCompactNumber, formatDuration, getTextBytes, summarizeText, toErrorMessage } from "./text.js";

package/dist/util/subprocess.d.ts

@@ -13,3 +13,4 @@ export declare function runProcess(cmd: string, args: string[], opts?: {
     cwd?: string;
     timeout?: number;
 }, signal?: AbortSignal): Promise<ProcessResult>;
+export declare function findCommands(commands: string[]): string[];

package/dist/util/subprocess.js

@@ -1,4 +1,4 @@
-import { spawn, spawnSync } from "node:child_process";
+import { spawn, spawnSync, execSync } from "node:child_process";
 import { MAX_PROCESS_BUFFER_MB, mbToBytes } from "./constants.js";
 const KILL_GRACE_MS = 2000;
 const MAX_PROCESS_BUFFER = mbToBytes(MAX_PROCESS_BUFFER_MB);
@@ -111,3 +111,16 @@ export function runProcess(cmd, args, opts = {}, signal) {
         });
     });
 }
+export function findCommands(commands) {
+    const isWindows = process.platform === 'win32';
+    return commands.filter((cmd) => {
+        try {
+            const checkCmd = isWindows ? `where ${cmd}` : `command -v ${cmd}`;
+            execSync(checkCmd, { stdio: 'ignore' });
+            return true;
+        }
+        catch {
+            return false;
+        }
+    });
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vietor/agent-core",
-  "version": "0.7.0",
+  "version": "0.7.2",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -24,10 +24,10 @@
     "url": "https://github.com/vietor/easy-agent.git"
   },
   "dependencies": {
-    "@anthropic-ai/sdk": "^0.115.0",
+    "@anthropic-ai/sdk": "^0.117.1",
     "@modelcontextprotocol/sdk": "^1.30.0",
     "@vscode/ripgrep": "^1.18.0",
-    "openai": "^7.4.0",
+    "openai": "^7.5.0",
     "turndown": "^7.2.4",
     "undici": "^8.10.0"
   },