@zhin.js/agent 0.1.31 → 0.2.0

package/lib/orchestrator/remote-agent-registry.d.ts

@@ -0,0 +1,34 @@
+import type { AIConfig } from '@zhin.js/core';
+import { McpClientConnection } from '../mcp-client/connection.js';
+import type { McpServerEntry } from './types.js';
+export interface RemoteAgentEntry {
+    id: string;
+    name: string;
+    url: string;
+    token?: string;
+    roles: string[];
+    description: string;
+}
+export interface RemoteAgentHealth {
+    id: string;
+    healthy: boolean;
+    error?: string;
+}
+export declare class RemoteAgentRegistry {
+    private entries;
+    private health;
+    private connections;
+    loadFromConfig(config: AIConfig | undefined): void;
+    list(): RemoteAgentEntry[];
+    get(id: string): RemoteAgentEntry | undefined;
+    getHealth(id: string): RemoteAgentHealth | undefined;
+    toMcpEntry(agent: RemoteAgentEntry): McpServerEntry;
+    getConnection(agentId: string): Promise<McpClientConnection>;
+    dispose(): Promise<void>;
+    healthCheckAll(): Promise<RemoteAgentHealth[]>;
+    pingAgent(agentId: string): Promise<RemoteAgentHealth>;
+}
+export declare function getRemoteAgentRegistry(): RemoteAgentRegistry;
+export declare function initRemoteAgentRegistry(config: AIConfig | undefined): RemoteAgentRegistry;
+export declare function disposeRemoteAgentRegistry(): Promise<void>;
+//# sourceMappingURL=remote-agent-registry.d.ts.map

package/lib/orchestrator/remote-agent-registry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-agent-registry.d.ts","sourceRoot":"","sources":["../../src/orchestrator/remote-agent-registry.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AAE9C,OAAO,EAAE,mBAAmB,EAAE,MAAM,6BAA6B,CAAC;AAClE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAIjD,MAAM,WAAW,gBAAgB;IAC/B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,EAAE,MAAM,EAAE,CAAC;IAChB,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,iBAAiB;IAChC,EAAE,EAAE,MAAM,CAAC;IACX,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB;AAsBD,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,OAAO,CAAuC;IACtD,OAAO,CAAC,MAAM,CAAwC;IACtD,OAAO,CAAC,WAAW,CAA0C;IAE7D,cAAc,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,IAAI;IAOlD,IAAI,IAAI,gBAAgB,EAAE;IAI1B,GAAG,CAAC,EAAE,EAAE,MAAM,GAAG,gBAAgB,GAAG,SAAS;IAI7C,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,iBAAiB,GAAG,SAAS;IAIpD,UAAU,CAAC,KAAK,EAAE,gBAAgB,GAAG,cAAc;IAa7C,aAAa,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAoB5D,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAaxB,cAAc,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC;IAS9C,SAAS,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,iBAAiB,CAAC;CAwB7D;AAID,wBAAgB,sBAAsB,IAAI,mBAAmB,CAK5D;AAED,wBAAgB,uBAAuB,CAAC,MAAM,EAAE,QAAQ,GAAG,SAAS,GAAG,mBAAmB,CAIzF;AAED,wBAAsB,0BAA0B,IAAI,OAAO,CAAC,IAAI,CAAC,CAKhE"}

package/lib/orchestrator/remote-agent-registry.js

@@ -0,0 +1,150 @@
+/**
+ * RemoteAgentRegistry — static ai.remoteAgents + health check (Agent Mesh v1).
+ */
+import { Logger } from '@zhin.js/logger';
+import { resolveConfigEnvString } from '../utils/config-env.js';
+import { McpClientConnection } from '../mcp-client/connection.js';
+const logger = new Logger(null, 'RemoteAgentRegistry');
+function parseRemoteAgents(config) {
+    const raw = config?.remoteAgents;
+    if (!raw?.length)
+        return [];
+    const out = [];
+    for (const item of raw) {
+        if (!item?.id?.trim() || !item.url?.trim())
+            continue;
+        const url = resolveConfigEnvString(item.url) ?? item.url;
+        const token = item.token ? (resolveConfigEnvString(item.token) ?? item.token) : undefined;
+        out.push({
+            id: item.id.trim(),
+            name: item.name?.trim() || item.id.trim(),
+            url: url.trim(),
+            token,
+            roles: Array.isArray(item.roles) ? item.roles.map(String) : [],
+            description: item.description?.trim() || '',
+        });
+    }
+    return out;
+}
+export class RemoteAgentRegistry {
+    entries = new Map();
+    health = new Map();
+    connections = new Map();
+    loadFromConfig(config) {
+        this.entries.clear();
+        for (const entry of parseRemoteAgents(config)) {
+            this.entries.set(entry.id, entry);
+        }
+    }
+    list() {
+        return [...this.entries.values()];
+    }
+    get(id) {
+        return this.entries.get(id);
+    }
+    getHealth(id) {
+        return this.health.get(id);
+    }
+    toMcpEntry(agent) {
+        const headers = {};
+        if (agent.token) {
+            headers.Authorization = `Bearer ${agent.token}`;
+        }
+        return {
+            name: `remote-agent:${agent.id}`,
+            transport: 'streamable-http',
+            url: agent.url,
+            headers,
+        };
+    }
+    async getConnection(agentId) {
+        const agent = this.entries.get(agentId);
+        if (!agent)
+            throw new Error(`Remote agent "${agentId}" not registered`);
+        let conn = this.connections.get(agentId);
+        if (conn && conn.isConnected)
+            return conn;
+        if (conn) {
+            try {
+                await conn.disconnect();
+            }
+            catch { /* ignore */ }
+            this.connections.delete(agentId);
+        }
+        conn = new McpClientConnection(this.toMcpEntry(agent));
+        try {
+            await conn.connect();
+        }
+        catch (err) {
+            this.connections.delete(agentId);
+            throw err;
+        }
+        this.connections.set(agentId, conn);
+        return conn;
+    }
+    async dispose() {
+        for (const [agentId, conn] of this.connections.entries()) {
+            try {
+                await conn.disconnect();
+            }
+            catch (err) {
+                logger.debug(`Failed to disconnect remote agent ${agentId}:`, err);
+            }
+        }
+        this.connections.clear();
+        this.entries.clear();
+        this.health.clear();
+    }
+    async healthCheckAll() {
+        const results = [];
+        for (const agent of this.entries.values()) {
+            const health = await this.pingAgent(agent.id);
+            results.push(health);
+        }
+        return results;
+    }
+    async pingAgent(agentId) {
+        const agent = this.entries.get(agentId);
+        if (!agent) {
+            const h = { id: agentId, healthy: false, error: 'not registered' };
+            this.health.set(agentId, h);
+            return h;
+        }
+        try {
+            const conn = await this.getConnection(agentId);
+            await conn.ping();
+            const h = { id: agentId, healthy: true };
+            this.health.set(agentId, h);
+            return h;
+        }
+        catch (err) {
+            const h = {
+                id: agentId,
+                healthy: false,
+                error: err instanceof Error ? err.message : String(err),
+            };
+            this.health.set(agentId, h);
+            logger.debug(`Remote agent ${agentId} health check failed:`, err);
+            return h;
+        }
+    }
+}
+let globalRegistry = null;
+export function getRemoteAgentRegistry() {
+    if (!globalRegistry) {
+        globalRegistry = new RemoteAgentRegistry();
+    }
+    return globalRegistry;
+}
+export function initRemoteAgentRegistry(config) {
+    const registry = getRemoteAgentRegistry();
+    registry.loadFromConfig(config);
+    return registry;
+}
+export async function disposeRemoteAgentRegistry() {
+    if (globalRegistry) {
+        await globalRegistry.dispose();
+        globalRegistry = null;
+    }
+}
+//# sourceMappingURL=remote-agent-registry.js.map

package/lib/orchestrator/remote-agent-registry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-agent-registry.js","sourceRoot":"","sources":["../../src/orchestrator/remote-agent-registry.ts"],"names":[],"mappings":"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"}

package/lib/orchestrator/remote-task-executor.d.ts

@@ -0,0 +1,10 @@
+export declare function executeRemoteOrchestrationTask(taskId: string): Promise<{
+    ok: boolean;
+    message: string;
+}>;
+export declare function pollRemoteTaskStatus(taskId: string): Promise<{
+    done: boolean;
+    status: string;
+    result?: string;
+}>;
+//# sourceMappingURL=remote-task-executor.d.ts.map

package/lib/orchestrator/remote-task-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-task-executor.d.ts","sourceRoot":"","sources":["../../src/orchestrator/remote-task-executor.ts"],"names":[],"mappings":"AAmBA,wBAAsB,8BAA8B,CAClD,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAC,CAwE3C;AAED,wBAAsB,oBAAoB,CACxC,MAAM,EAAE,MAAM,GACb,OAAO,CAAC;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkD7D"}

package/lib/orchestrator/remote-task-executor.js

@@ -0,0 +1,142 @@
+/**
+ * Remote task execution via MCP agent.delegate_task (Agent Mesh v1).
+ */
+import { getAgentDispatcher } from './agent-dispatcher.js';
+import { getRemoteAgentRegistry } from './remote-agent-registry.js';
+import { getOrchestrationService } from './orchestration-service.js';
+function extractMcpText(result) {
+    if (typeof result === 'string')
+        return result;
+    const content = result?.content;
+    if (Array.isArray(content)) {
+        return content
+            .filter((c) => c.type === 'text' && c.text)
+            .map((c) => c.text)
+            .join('\n');
+    }
+    return JSON.stringify(result);
+}
+export async function executeRemoteOrchestrationTask(taskId) {
+    const dispatcher = getAgentDispatcher();
+    const orch = getOrchestrationService();
+    const task = dispatcher.getTask(taskId);
+    if (!task) {
+        return { ok: false, message: `任务 ${taskId} 不存在` };
+    }
+    if (task.executorKind !== 'remote' || !task.remoteAgentId) {
+        return { ok: false, message: `任务 ${taskId} 不是远程执行任务` };
+    }
+    const registry = getRemoteAgentRegistry();
+    const agent = registry.get(task.remoteAgentId);
+    if (!agent) {
+        return { ok: false, message: `远程 Agent ${task.remoteAgentId} 未注册` };
+    }
+    const promise = (async () => {
+        try {
+            const conn = await registry.getConnection(task.remoteAgentId);
+            const result = await conn.callTool('agent.delegate_task', {
+                title: task.name,
+                description: task.goal || task.description,
+                acceptance_criteria: task.context?.acceptance_criteria ?? '',
+                artifacts: task.context?.artifacts ?? [],
+            });
+            const text = extractMcpText(result);
+            let remoteTaskId = taskId;
+            try {
+                const parsed = JSON.parse(text);
+                remoteTaskId = parsed.remote_task_id ?? parsed.task_id ?? taskId;
+            }
+            catch {
+                const match = text.match(/remote_task_id["\s:]+([a-zA-Z0-9-]+)/);
+                if (match)
+                    remoteTaskId = match[1];
+            }
+            if (orch) {
+                await orch.repositoryHandle.updateTaskStatus(taskId, 'running', {
+                    remote_task_id: remoteTaskId,
+                    started_at: Date.now(),
+                });
+            }
+            dispatcher.markRunning(taskId, Promise.resolve({
+                taskId,
+                role: task.role,
+                success: true,
+                summary: `delegated to ${task.remoteAgentId}:${remoteTaskId}`,
+                duration: 0,
+            }));
+        }
+        catch (err) {
+            dispatcher.recordResult({
+                taskId,
+                role: task.role,
+                success: false,
+                summary: 'remote delegate failed',
+                error: err instanceof Error ? err.message : String(err),
+                duration: 0,
+            });
+        }
+    })();
+    dispatcher.markRunning(taskId, promise.then(() => ({
+        taskId,
+        role: task.role,
+        success: true,
+        summary: 'remote delegation started',
+        duration: 0,
+    })));
+    return {
+        ok: true,
+        message: `远程任务已委托给 ${task.remoteAgentId}（task ${taskId}），将通过轮询同步状态。`,
+    };
+}
+export async function pollRemoteTaskStatus(taskId) {
+    const dispatcher = getAgentDispatcher();
+    const orch = getOrchestrationService();
+    const task = dispatcher.getTask(taskId);
+    if (!task?.remoteAgentId || !task.remoteTaskId) {
+        return { done: false, status: 'unknown' };
+    }
+    const conn = await getRemoteAgentRegistry().getConnection(task.remoteAgentId);
+    const statusResult = await conn.callTool('agent.query_status', { task_id: task.remoteTaskId });
+    const statusText = extractMcpText(statusResult);
+    let status = 'running';
+    try {
+        const parsed = JSON.parse(statusText);
+        status = parsed.status ?? status;
+    }
+    catch {
+        if (/completed|done|success/i.test(statusText))
+            status = 'completed';
+        if (/failed|error/i.test(statusText))
+            status = 'failed';
+        if (/pending/i.test(statusText))
+            status = 'pending';
+    }
+    if (status === 'completed') {
+        const resultRaw = await conn.callTool('agent.get_result', { task_id: task.remoteTaskId });
+        const resultText = extractMcpText(resultRaw);
+        dispatcher.recordResult({
+            taskId,
+            role: task.role,
+            success: true,
+            summary: resultText.slice(0, 4000),
+            duration: 0,
+        });
+        return { done: true, status, result: resultText };
+    }
+    if (status === 'failed' || status === 'cancelled') {
+        dispatcher.recordResult({
+            taskId,
+            role: task.role,
+            success: false,
+            summary: statusText,
+            error: statusText,
+            duration: 0,
+        });
+        return { done: true, status, result: statusText };
+    }
+    if (orch) {
+        await orch.repositoryHandle.updateTaskStatus(taskId, 'running');
+    }
+    return { done: false, status };
+}
+//# sourceMappingURL=remote-task-executor.js.map

package/lib/orchestrator/remote-task-executor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-task-executor.js","sourceRoot":"","sources":["../../src/orchestrator/remote-task-executor.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,sBAAsB,EAAE,MAAM,4BAA4B,CAAC;AACpE,OAAO,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAErE,SAAS,cAAc,CAAC,MAAe;IACrC,IAAI,OAAO,MAAM,KAAK,QAAQ;QAAE,OAAO,MAAM,CAAC;IAC9C,MAAM,OAAO,GAAI,MAAgE,EAAE,OAAO,CAAC;IAC3F,IAAI,KAAK,CAAC,OAAO,CAAC,OAAO,CAAC,EAAE,CAAC;QAC3B,OAAO,OAAO;aACX,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,IAAI,CAAC,CAAC,IAAI,CAAC;aAC1C,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAK,CAAC;aACnB,IAAI,CAAC,IAAI,CAAC,CAAC;IAChB,CAAC;IACD,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC;AAChC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,8BAA8B,CAClD,MAAc;IAEd,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,uBAAuB,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,MAAM,EAAE,CAAC;IACpD,CAAC;IACD,IAAI,IAAI,CAAC,YAAY,KAAK,QAAQ,IAAI,CAAC,IAAI,CAAC,aAAa,EAAE,CAAC;QAC1D,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,MAAM,WAAW,EAAE,CAAC;IACzD,CAAC;IAED,MAAM,QAAQ,GAAG,sBAAsB,EAAE,CAAC;IAC1C,MAAM,KAAK,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC/C,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,OAAO,EAAE,YAAY,IAAI,CAAC,aAAa,MAAM,EAAE,CAAC;IACtE,CAAC;IAED,MAAM,OAAO,GAAG,CAAC,KAAK,IAAmB,EAAE;QACzC,IAAI,CAAC;YACH,MAAM,IAAI,GAAG,MAAM,QAAQ,CAAC,aAAa,CAAC,IAAI,CAAC,aAAc,CAAC,CAAC;YAC/D,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,qBAAqB,EAAE;gBACxD,KAAK,EAAE,IAAI,CAAC,IAAI;gBAChB,WAAW,EAAE,IAAI,CAAC,IAAI,IAAI,IAAI,CAAC,WAAW;gBAC1C,mBAAmB,EAAE,IAAI,CAAC,OAAO,EAAE,mBAAmB,IAAI,EAAE;gBAC5D,SAAS,EAAE,IAAI,CAAC,OAAO,EAAE,SAAS,IAAI,EAAE;aACzC,CAAC,CAAC;YACH,MAAM,IAAI,GAAG,cAAc,CAAC,MAAM,CAAC,CAAC;YACpC,IAAI,YAAY,GAAG,MAAM,CAAC;YAC1B,IAAI,CAAC;gBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAkD,CAAC;gBACjF,YAAY,GAAG,MAAM,CAAC,cAAc,IAAI,MAAM,CAAC,OAAO,IAAI,MAAM,CAAC;YACnE,CAAC;YAAC,MAAM,CAAC;gBACP,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,sCAAsC,CAAC,CAAC;gBACjE,IAAI,KAAK;oBAAE,YAAY,GAAG,KAAK,CAAC,CAAC,CAAE,CAAC;YACtC,CAAC;YACD,IAAI,IAAI,EAAE,CAAC;gBACT,MAAM,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,EAAE;oBAC9D,cAAc,EAAE,YAAY;oBAC5B,UAAU,EAAE,IAAI,CAAC,GAAG,EAAE;iBACvB,CAAC,CAAC;YACL,CAAC;YACD,UAAU,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,OAAO,CAAC;gBAC7C,MAAM;gBACN,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,IAAI;gBACb,OAAO,EAAE,gBAAgB,IAAI,CAAC,aAAa,IAAI,YAAY,EAAE;gBAC7D,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC,CAAC;QACN,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,UAAU,CAAC,YAAY,CAAC;gBACtB,MAAM;gBACN,IAAI,EAAE,IAAI,CAAC,IAAI;gBACf,OAAO,EAAE,KAAK;gBACd,OAAO,EAAE,wBAAwB;gBACjC,KAAK,EAAE,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;gBACvD,QAAQ,EAAE,CAAC;aACZ,CAAC,CAAC;QACL,CAAC;IACH,CAAC,CAAC,EAAE,CAAC;IAEL,UAAU,CAAC,WAAW,CAAC,MAAM,EAAE,OAAO,CAAC,IAAI,CAAC,GAAG,EAAE,CAAC,CAAC;QACjD,MAAM;QACN,IAAI,EAAE,IAAI,CAAC,IAAI;QACf,OAAO,EAAE,IAAI;QACb,OAAO,EAAE,2BAA2B;QACpC,QAAQ,EAAE,CAAC;KACZ,CAAC,CAAC,CAAC,CAAC;IAEL,OAAO;QACL,EAAE,EAAE,IAAI;QACR,OAAO,EAAE,YAAY,IAAI,CAAC,aAAa,SAAS,MAAM,cAAc;KACrE,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,MAAc;IAEd,MAAM,UAAU,GAAG,kBAAkB,EAAE,CAAC;IACxC,MAAM,IAAI,GAAG,uBAAuB,EAAE,CAAC;IACvC,MAAM,IAAI,GAAG,UAAU,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC;IACxC,IAAI,CAAC,IAAI,EAAE,aAAa,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,CAAC;QAC/C,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;IAC5C,CAAC;IAED,MAAM,IAAI,GAAG,MAAM,sBAAsB,EAAE,CAAC,aAAa,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC9E,MAAM,YAAY,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,oBAAoB,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;IAC/F,MAAM,UAAU,GAAG,cAAc,CAAC,YAAY,CAAC,CAAC;IAChD,IAAI,MAAM,GAAG,SAAS,CAAC;IACvB,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,UAAU,CAAwB,CAAC;QAC7D,MAAM,GAAG,MAAM,CAAC,MAAM,IAAI,MAAM,CAAC;IACnC,CAAC;IAAC,MAAM,CAAC;QACP,IAAI,yBAAyB,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,MAAM,GAAG,WAAW,CAAC;QACrE,IAAI,eAAe,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,MAAM,GAAG,QAAQ,CAAC;QACxD,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC;YAAE,MAAM,GAAG,SAAS,CAAC;IACtD,CAAC;IAED,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAC3B,MAAM,SAAS,GAAG,MAAM,IAAI,CAAC,QAAQ,CAAC,kBAAkB,EAAE,EAAE,OAAO,EAAE,IAAI,CAAC,YAAY,EAAE,CAAC,CAAC;QAC1F,MAAM,UAAU,GAAG,cAAc,CAAC,SAAS,CAAC,CAAC;QAC7C,UAAU,CAAC,YAAY,CAAC;YACtB,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI;YACb,OAAO,EAAE,UAAU,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC;YAClC,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,MAAM,KAAK,QAAQ,IAAI,MAAM,KAAK,WAAW,EAAE,CAAC;QAClD,UAAU,CAAC,YAAY,CAAC;YACtB,MAAM;YACN,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,KAAK;YACd,OAAO,EAAE,UAAU;YACnB,KAAK,EAAE,UAAU;YACjB,QAAQ,EAAE,CAAC;SACZ,CAAC,CAAC;QACH,OAAO,EAAE,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACpD,CAAC;IAED,IAAI,IAAI,EAAE,CAAC;QACT,MAAM,IAAI,CAAC,gBAAgB,CAAC,gBAAgB,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IAClE,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,KAAK,EAAE,MAAM,EAAE,CAAC;AACjC,CAAC"}

package/lib/orchestrator/remote-task-poller.d.ts

@@ -0,0 +1,17 @@
+export interface RemoteTaskPollerConfig {
+    intervalMs?: number;
+    enabled?: boolean;
+}
+export declare class RemoteTaskPoller {
+    private readonly config;
+    private timer;
+    private polling;
+    constructor(config?: RemoteTaskPollerConfig);
+    start(): void;
+    stop(): void;
+    tick(): Promise<void>;
+}
+export declare function getRemoteTaskPoller(): RemoteTaskPoller;
+export declare function startRemoteTaskPoller(config?: RemoteTaskPollerConfig): RemoteTaskPoller;
+export declare function stopRemoteTaskPoller(): void;
+//# sourceMappingURL=remote-task-poller.d.ts.map

package/lib/orchestrator/remote-task-poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-task-poller.d.ts","sourceRoot":"","sources":["../../src/orchestrator/remote-task-poller.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,sBAAsB;IACrC,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED,qBAAa,gBAAgB;IAIf,OAAO,CAAC,QAAQ,CAAC,MAAM;IAHnC,OAAO,CAAC,KAAK,CAA+C;IAC5D,OAAO,CAAC,OAAO,CAAS;gBAEK,MAAM,GAAE,sBAA2B;IAEhE,KAAK,IAAI,IAAI;IAab,IAAI,IAAI,IAAI;IAON,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAsB5B;AAID,wBAAgB,mBAAmB,IAAI,gBAAgB,CAKtD;AAED,wBAAgB,qBAAqB,CAAC,MAAM,CAAC,EAAE,sBAAsB,GAAG,gBAAgB,CAIvF;AAED,wBAAgB,oBAAoB,IAAI,IAAI,CAK3C"}

package/lib/orchestrator/remote-task-poller.js

@@ -0,0 +1,81 @@
+/**
+ * RemoteTaskPoller — 轮询远程 MCP 任务状态（Agent Mesh v1）。
+ */
+import { Logger } from '@zhin.js/logger';
+import { getOrchestrationService } from './orchestration-service.js';
+import { getAgentDispatcher } from './agent-dispatcher.js';
+import { pollRemoteTaskStatus } from './remote-task-executor.js';
+const logger = new Logger(null, 'RemoteTaskPoller');
+export class RemoteTaskPoller {
+    config;
+    timer = null;
+    polling = false;
+    constructor(config = {}) {
+        this.config = config;
+    }
+    start() {
+        if (this.config.enabled === false)
+            return;
+        if (this.timer)
+            return;
+        const intervalMs = this.config.intervalMs ?? 15_000;
+        this.timer = setInterval(() => {
+            void this.tick();
+        }, intervalMs);
+        if (this.timer && typeof this.timer === 'object' && 'unref' in this.timer) {
+            this.timer.unref();
+        }
+        logger.debug(`RemoteTaskPoller started (interval=${intervalMs}ms)`);
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async tick() {
+        if (this.polling)
+            return;
+        this.polling = true;
+        try {
+            const orch = getOrchestrationService();
+            if (!orch)
+                return;
+            const tasks = await orch.repositoryHandle.listActiveRemoteTasks();
+            const dispatcher = getAgentDispatcher();
+            for (const record of tasks) {
+                dispatcher.syncTaskFromRecord(record);
+                if (record.remote_task_id) {
+                    try {
+                        await pollRemoteTaskStatus(record.id);
+                    }
+                    catch (err) {
+                        logger.debug(`poll failed for ${record.id}:`, err);
+                    }
+                }
+            }
+        }
+        finally {
+            this.polling = false;
+        }
+    }
+}
+let globalPoller = null;
+export function getRemoteTaskPoller() {
+    if (!globalPoller) {
+        globalPoller = new RemoteTaskPoller();
+    }
+    return globalPoller;
+}
+export function startRemoteTaskPoller(config) {
+    globalPoller = new RemoteTaskPoller(config);
+    globalPoller.start();
+    return globalPoller;
+}
+export function stopRemoteTaskPoller() {
+    if (globalPoller) {
+        globalPoller.stop();
+        globalPoller = null;
+    }
+}
+//# sourceMappingURL=remote-task-poller.js.map

package/lib/orchestrator/remote-task-poller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-task-poller.js","sourceRoot":"","sources":["../../src/orchestrator/remote-task-poller.ts"],"names":[],"mappings":"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"}

package/lib/orchestrator/task-queue.d.ts

@@ -64,6 +64,9 @@ export declare class TaskQueue {
     private running;
     private completed;
     private listeners;
+    private cleanupTimer?;
+    private disposed;
+    private static readonly AUTO_CLEANUP_INTERVAL_MS;
     constructor(config?: Partial<TaskQueueConfig>);
     /**
      * 添加任务并等待完成（含重试后的最终结果）
@@ -108,13 +111,25 @@ export declare class TaskQueue {
      */
     retryTask(id: string): boolean;
     /**
-     * 添加事件监听器
+     * 添加事件监听器，返回 dispose 函数用于移除
      */
-    on(event: string, listener: (task: Task) => void): void;
+    on(event: string, listener: (task: Task) => void): () => void;
+    /**
+     * 移除事件监听器
+     */
+    off(listener: (event: string, task: Task) => void): void;
+    /**
+     * 移除所有事件监听器
+     */
+    removeAllListeners(): void;
     /**
      * 清理已完成的任务
      */
-    cleanup(): void;
+    cleanup(): number;
+    /**
+     * 销毁队列，释放所有资源
+     */
+    dispose(): void;
     /**
      * 将任务加入队列
      */

package/lib/orchestrator/task-queue.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"task-queue.d.ts","sourceRoot":"","sources":["../../src/orchestrator/task-queue.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"task-queue.d.ts","sourceRoot":"","sources":["../../src/orchestrator/task-queue.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,MAAM,UAAU,GAClB,SAAS,GACT,QAAQ,GACR,SAAS,GACT,WAAW,GACX,QAAQ,GACR,WAAW,GACX,SAAS,GACT,UAAU,CAAC;AAEf,MAAM,MAAM,YAAY,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAIlE,MAAM,WAAW,IAAI,CAAC,CAAC,GAAG,OAAO;IAC/B,YAAY;IACZ,EAAE,EAAE,MAAM,CAAC;IACX,WAAW;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,YAAY;IACZ,QAAQ,EAAE,YAAY,CAAC;IACvB,WAAW;IACX,MAAM,EAAE,UAAU,CAAC;IACnB,aAAa;IACb,OAAO,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IAC1B,eAAe;IACf,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;IACxB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,WAAW;IACX,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW;IACX,MAAM,CAAC,EAAE,CAAC,CAAC;IACX,WAAW;IACX,KAAK,CAAC,EAAE,KAAK,CAAC;IACd,YAAY;IACZ,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACpC;AAID,MAAM,WAAW,eAAe;IAC9B,YAAY;IACZ,cAAc,EAAE,MAAM,CAAC;IACvB,iBAAiB;IACjB,cAAc,EAAE,MAAM,CAAC;IACvB,eAAe;IACf,iBAAiB,EAAE,MAAM,CAAC;IAC1B,cAAc;IACd,cAAc,EAAE,OAAO,CAAC;IACxB,kBAAkB;IAClB,SAAS,EAAE,OAAO,CAAC;IACnB,iBAAiB;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAqBD,qBAAa,SAAS;IACpB,OAAO,CAAC,MAAM,CAAkB;IAChC,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,KAAK,CAAgB;IAC7B,OAAO,CAAC,OAAO,CAA0B;IACzC,OAAO,CAAC,SAAS,CAA0B;IAC3C,OAAO,CAAC,SAAS,CAAkD;IACnE,OAAO,CAAC,YAAY,CAAC,CAAiC;IACtD,OAAO,CAAC,QAAQ,CAAS;IAEzB,OAAO,CAAC,MAAM,CAAC,QAAQ,CAAC,wBAAwB,CAAkB;gBAEtD,MAAM,GAAE,OAAO,CAAC,eAAe,CAAM;IAQjD;;OAEG;IACG,cAAc,CAAC,CAAC,EACpB,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC,GAChE,OAAO,CAAC,CAAC,CAAC;IAmBb;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,IAAI,GAAG,QAAQ,GAAG,WAAW,GAAG,YAAY,CAAC,GAAG,IAAI,CAAC,CAAC,CAAC;IAmBtF;;OAEG;IACH,OAAO,CAAC,EAAE,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;IAIrC;;OAEG;IACH,WAAW,IAAI,IAAI,EAAE;IAIrB;;OAEG;IACH,cAAc,IAAI;QAChB,OAAO,EAAE,MAAM,CAAC;QAChB,MAAM,EAAE,MAAM,CAAC;QACf,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,MAAM,EAAE,MAAM,CAAC;KAChB;IA+BD;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAI5B;;OAEG;IACH,IAAI,IAAI,IAAI;IAOZ;;OAEG;IACH,UAAU,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAiB/B;;OAEG;IACH,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO;IAc9B;;OAEG;IACH,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,MAAM,IAAI;IAY7D;;OAEG;IACH,GAAG,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,EAAE,IAAI,KAAK,IAAI,GAAG,IAAI;IAOxD;;OAEG;IACH,kBAAkB,IAAI,IAAI;IAI1B;;OAEG;IACH,OAAO,IAAI,MAAM;IAsBjB;;OAEG;IACH,OAAO,IAAI,IAAI;IAef;;OAEG;IACH,OAAO,CAAC,WAAW;IA0CnB;;OAEG;YACW,YAAY;IAW1B;;OAEG;YACW,WAAW;IAuEzB;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAkBzB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAY3B;;OAEG;IACH,OAAO,CAAC,eAAe;CASxB;AAMD;;GAEG;AACH,wBAAgB,YAAY,IAAI,SAAS,CAKxC;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,OAAO,CAAC,eAAe,CAAC,GAAG,SAAS,CAIzE"}

package/lib/orchestrator/task-queue.js

@@ -30,8 +30,15 @@ export class TaskQueue {
     running = new Set();
     completed = new Set();
     listeners = [];
+    cleanupTimer;
+    disposed = false;
+    static AUTO_CLEANUP_INTERVAL_MS = 10 * 60 * 1000; // 10 分钟
     constructor(config = {}) {
         this.config = { ...DEFAULT_CONFIG, ...config };
+        this.cleanupTimer = setInterval(() => this.cleanup(), TaskQueue.AUTO_CLEANUP_INTERVAL_MS);
+        if (this.cleanupTimer && typeof this.cleanupTimer === 'object' && 'unref' in this.cleanupTimer) {
+            this.cleanupTimer.unref();
+        }
     }
     /**
      * 添加任务并等待完成（含重试后的最终结果）
@@ -42,9 +49,7 @@ export class TaskQueue {
             const handler = (event, t) => {
                 if (t.id !== fullTask.id)
                     return;
-                const idx = this.listeners.indexOf(handler);
-                if (idx >= 0)
-                    this.listeners.splice(idx, 1);
+                this.off(handler);
                 if (event === 'task:completed') {
                     resolve(t.result);
                     return;
@@ -165,14 +170,33 @@ export class TaskQueue {
         return true;
     }
     /**
-     * 添加事件监听器
+     * 添加事件监听器，返回 dispose 函数用于移除
      */
     on(event, listener) {
-        this.listeners.push((e, task) => {
+        const wrapper = (e, task) => {
             if (e === event) {
                 listener(task);
             }
-        });
+        };
+        this.listeners.push(wrapper);
+        return () => {
+            this.off(wrapper);
+        };
+    }
+    /**
+     * 移除事件监听器
+     */
+    off(listener) {
+        const idx = this.listeners.indexOf(listener);
+        if (idx >= 0) {
+            this.listeners.splice(idx, 1);
+        }
+    }
+    /**
+     * 移除所有事件监听器
+     */
+    removeAllListeners() {
+        this.listeners.length = 0;
     }
     /**
      * 清理已完成的任务
@@ -180,6 +204,7 @@ export class TaskQueue {
     cleanup() {
         const now = Date.now();
         const expiration = this.config.taskExpiration || 24 * 60 * 60 * 1000; // 24 hours
+        let cleaned = 0;
         for (const [taskId, task] of this.tasks.entries()) {
             if (task.status === 'completed' ||
                 task.status === 'failed' ||
@@ -187,9 +212,29 @@ export class TaskQueue {
                 if (task.completedAt && now - task.completedAt > expiration) {
                     this.tasks.delete(taskId);
                     this.completed.delete(taskId);
+                    cleaned++;
                 }
             }
         }
+        return cleaned;
+    }
+    /**
+     * 销毁队列，释放所有资源
+     */
+    dispose() {
+        if (this.disposed)
+            return;
+        this.disposed = true;
+        if (this.cleanupTimer) {
+            clearInterval(this.cleanupTimer);
+            this.cleanupTimer = undefined;
+        }
+        this.stop();
+        this.tasks.clear();
+        this.queue.length = 0;
+        this.running.clear();
+        this.completed.clear();
+        this.removeAllListeners();
     }
     /**
      * 将任务加入队列
@@ -355,6 +400,7 @@ export function getTaskQueue() {
  * 初始化任务队列
  */
 export function initTaskQueue(config) {
+    globalTaskQueue?.dispose();
     globalTaskQueue = new TaskQueue(config);
     return globalTaskQueue;
 }