nexus-agentd 0.4.1 → 0.4.2

package/README.md

@@ -118,11 +118,16 @@ npm install -g \
   pi-acp
 ```
 
-`command`、`args`、`probeArgs`、`inheritEnv` 和 `env` 是仅可在本机配置文件修改的高级字段，WebUI
+`command`、`args`、`probeArgs`、`probeTimeoutMs`、`inheritEnv` 和 `env` 是仅可在本机配置文件修改的高级字段，WebUI
 不接受这些字段。Workspace 在启动进程前经过 `realpath` 边界校验。通用 `stdio` 驱动用于自定义入口，
 必须指定 `command`，用 `probeArgs` 指定可用性检查参数（例如 `["--version"]`）；编辑其他字段时保留
 这些本地配置。命令探测不等于 ACP 握手成功。
 
+`probeTimeoutMs` 是可用性探测的期限，默认 60000 毫秒。探测会真正拉起一次 Agent 进程，而 Agent 在
+应答探测前往往要加载大量插件（例如 Hermes 会注册 50 多个插件提供者），启动耗时远超普通 shell
+命令；期限过短会把正在正常启动的 Agent 报成「不可用 / probe timed out」。启动较慢的 Agent 按实测
+启动时间调高该值即可。
+
 权限策略支持 `ask`（询问）、`allow`（自动允许单次）和 `deny`（拒绝）。`allow` 只选择 Agent 提供的
 `allow_once`，缺少该选项则取消授权，不回退到永久授权。`ask` 模式下普通 `action: "accept"` 也只选择
 单次授权，永久授权需要客户端明确传入对应 `optionId`。这不限制重复的单次自动授权，但只提供永久选项的

package/dist/config.js

@@ -181,6 +181,7 @@ function parseAgent(id, value) {
         probeArgs: input.probeArgs === undefined
             ? undefined
             : stringArray(input.probeArgs, `agents.${id}.probeArgs`),
+        probeTimeoutMs: integerValue(input.probeTimeoutMs, `agents.${id}.probeTimeoutMs`, 60 * 1000, 1000, 10 * 60 * 1000),
         inheritEnv: input.inheritEnv === undefined
             ? undefined
             : stringArray(input.inheritEnv, `agents.${id}.inheritEnv`),

package/dist/control-plane-validation.js

@@ -117,7 +117,7 @@ export function clampTimeout(value, fallback, min, max) {
 }
 export function preservedAcpAdvanced(previous) {
     const result = {};
-    for (const key of ['command', 'args', 'probeArgs', 'inheritEnv', 'env']) {
+    for (const key of ['command', 'args', 'probeArgs', 'probeTimeoutMs', 'inheritEnv', 'env']) {
         if (previous[key] !== undefined)
             result[key] = structuredClone(previous[key]);
     }

package/dist/control-plane.js

@@ -513,7 +513,8 @@ export class AgentdControlPlane {
             enabled: config.enabled !== false,
             workspace: config.workspace || this.config.workspaceRoots[0] || '',
             permissionPolicy: config.permissionPolicy || 'ask',
-            permissionTimeoutMs: config.permissionTimeoutMs || 15 * 60 * 1000
+            permissionTimeoutMs: config.permissionTimeoutMs || 15 * 60 * 1000,
+            probeTimeoutMs: config.probeTimeoutMs || 60 * 1000
         };
     }
     exclusive(task) {

package/dist/drivers/stdio.d.ts

@@ -1,5 +1,13 @@
 import type { AgentdDriverConfig } from '../types.js';
 import type { AgentDriver } from './types.js';
+/**
+ * How long an availability probe may take before it is reported as a timeout.
+ * Probes spawn a real agent process, and agents that load plugins before
+ * answering (Hermes registers 50+ plugin providers) need far longer than the
+ * five seconds that used to be hard-coded here — they were reported as down
+ * while starting up normally. Override per agent with `probeTimeoutMs`.
+ */
+export declare const DEFAULT_PROBE_TIMEOUT_MS = 60000;
 export interface StdioAcpDriverDefaults {
     name: string;
     description: string;

package/dist/drivers/stdio.js

@@ -27,6 +27,14 @@ const BASE_ENV_KEYS = [
     'ProgramFiles(x86)',
     'PATHEXT'
 ];
+/**
+ * How long an availability probe may take before it is reported as a timeout.
+ * Probes spawn a real agent process, and agents that load plugins before
+ * answering (Hermes registers 50+ plugin providers) need far longer than the
+ * five seconds that used to be hard-coded here — they were reported as down
+ * while starting up normally. Override per agent with `probeTimeoutMs`.
+ */
+export const DEFAULT_PROBE_TIMEOUT_MS = 60_000;
 export function createStdioAcpDriver(id, config, defaults) {
     const command = config.command || defaults.command;
     const args = config.args === undefined ? [...defaults.args] : [...config.args];
@@ -45,7 +53,10 @@ export function createStdioAcpDriver(id, config, defaults) {
         ownsProcessGroup: process.platform !== 'win32',
         async probe() {
             try {
-                const version = await probeCommand(command, config.probeArgs || defaults.probeArgs || ['--version'], env, name, { ownsProcessGroup: process.platform !== 'win32' });
+                const version = await probeCommand(command, config.probeArgs || defaults.probeArgs || ['--version'], env, name, {
+                    ownsProcessGroup: process.platform !== 'win32',
+                    timeoutMs: config.probeTimeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS
+                });
                 return {
                     id,
                     name,
@@ -155,7 +166,7 @@ export function probeCommand(command, args, env, label, options = {}) {
             // process. Wait for tree termination before rejecting so a timed
             // out health check cannot leave an agent running in the background.
             void cleanup().then(() => finish(new Error(`${label} probe timed out`)), (error) => finish(new Error(`${label} probe timed out; cleanup failed: ${cleanupFailure(error)}`)));
-        }, options.timeoutMs ?? 5000);
+        }, options.timeoutMs ?? DEFAULT_PROBE_TIMEOUT_MS);
         timer.unref?.();
         child.stdout.on('data', (chunk) => {
             output = `${output}${String(chunk)}`.slice(-8192);

package/dist/types.d.ts

@@ -27,6 +27,12 @@ export interface AgentdDriverConfig {
     args?: string[];
     /** Arguments used by a command availability probe. */
     probeArgs?: string[];
+    /**
+     * Milliseconds the availability probe may take before it is reported as a
+     * timeout. Agent CLIs that load plugins before answering a probe need far
+     * more than a shell command; defaults to 60000.
+     */
+    probeTimeoutMs?: number;
     inheritEnv?: string[];
     env?: Record<string, string>;
     permissionPolicy?: PermissionPolicy;
@@ -141,6 +147,7 @@ export interface AgentdAgentConfigView {
     workspace?: string;
     permissionPolicy?: PermissionPolicy;
     permissionTimeoutMs?: number;
+    probeTimeoutMs?: number;
     agentCardUrl?: string;
     agentUrl?: string;
     preferredTransport?: A2ATransportPreference;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "nexus-agentd",
-  "version": "0.4.1",
+  "version": "0.4.2",
   "description": "Local Nexus Gateway daemon with an HTTP/SSE API and WebUI for allowlisted ACP and remote A2A agents",
   "type": "module",
   "main": "dist/index.js",