@vietor/agent-core 0.7.0 → 0.7.1

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/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.1",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",