@zhin.js/agent 0.1.30 → 0.1.32

package/lib/orchestrator/orchestration-service.js

@@ -0,0 +1,221 @@
+import { getAgentDispatcher } from './agent-dispatcher.js';
+import { taskRecordToAgentTaskShape, } from './orchestration-repository.js';
+import { MISSIONS_TEMPLATE, createDefaultMissionState, } from './mission-state.js';
+import { validateMissionStatePatch } from './mission-patch-acl.js';
+export { MISSIONS_TEMPLATE };
+export class OrchestrationService {
+    repository;
+    constructor(repository) {
+        this.repository = repository;
+    }
+    get repositoryHandle() {
+        return this.repository;
+    }
+    async startRun(input) {
+        const remoteValidator = input.remoteValidator?.trim();
+        const run = await this.repository.createRun({
+            session_key: input.sessionKey,
+            title: input.title ?? 'Orchestration run',
+            template: MISSIONS_TEMPLATE,
+        });
+        await this.installMissionsTemplate(run.id, { remoteValidatorId: remoteValidator });
+        return { run, tasks: await this.repository.listTasksByRun(run.id) };
+    }
+    async addTask(input) {
+        let executor_kind = 'local';
+        let remote_agent_id = '';
+        if (input.executor?.startsWith('remote:')) {
+            executor_kind = 'remote';
+            remote_agent_id = input.executor.slice('remote:'.length);
+        }
+        const task = await this.repository.createTask({
+            run_id: input.runId,
+            name: input.name,
+            description: input.description,
+            role: input.role,
+            goal: input.goal,
+            depends_on: input.dependsOn,
+            executor_kind,
+            remote_agent_id,
+            priority: input.priority,
+            context: input.context,
+            is_writer: input.is_writer,
+            phase: input.phase,
+        });
+        const dispatcher = getAgentDispatcher();
+        dispatcher.syncTaskFromRecord(task);
+        return task;
+    }
+    async getStatus(runId) {
+        const snapshot = await this.repository.getRunWithTasks(runId);
+        if (!snapshot)
+            return null;
+        const dispatcher = getAgentDispatcher();
+        for (const task of snapshot.tasks) {
+            dispatcher.syncTaskFromRecord(task);
+        }
+        return snapshot;
+    }
+    async completeRun(runId, force = false) {
+        const snapshot = await this.getStatus(runId);
+        if (!snapshot)
+            return { ok: false, message: `Run ${runId} not found` };
+        const blocking = snapshot.tasks.filter((t) => t.status === 'pending' || t.status === 'running');
+        if (blocking.length > 0 && !force) {
+            return {
+                ok: false,
+                message: `Run has ${blocking.length} incomplete task(s). Use force=true to close anyway.`,
+            };
+        }
+        const hasFailed = snapshot.tasks.some((t) => t.status === 'failed');
+        await this.repository.updateRunStatus(runId, hasFailed && !force ? 'failed' : 'completed');
+        return { ok: true, message: `Run ${runId} marked ${hasFailed && !force ? 'failed' : 'completed'}` };
+    }
+    async retryTask(taskId) {
+        const task = await this.repository.getTask(taskId);
+        if (!task)
+            return { ok: false, message: `Task ${taskId} not found` };
+        if (task.status !== 'failed') {
+            return { ok: false, message: `Task ${taskId} is ${task.status}, only failed tasks can be retried` };
+        }
+        await this.repository.updateTaskStatus(taskId, 'pending', {
+            error: '',
+            result_summary: '',
+            started_at: null,
+            finished_at: null,
+        });
+        const updated = await this.repository.getTask(taskId);
+        if (updated)
+            getAgentDispatcher().syncTaskFromRecord(updated);
+        return { ok: true, message: `Task ${taskId} reset to pending` };
+    }
+    async skipTask(taskId, reason) {
+        const task = await this.repository.getTask(taskId);
+        if (!task)
+            return { ok: false, message: `Task ${taskId} not found` };
+        if (task.status !== 'failed' && task.status !== 'pending') {
+            return { ok: false, message: `Task ${taskId} is ${task.status}, cannot skip` };
+        }
+        await this.repository.updateTaskStatus(taskId, 'skipped', {
+            error: reason || 'skipped by director',
+            finished_at: Date.now(),
+        });
+        const updated = await this.repository.getTask(taskId);
+        if (updated)
+            getAgentDispatcher().syncTaskFromRecord(updated);
+        return { ok: true, message: `Task ${taskId} skipped` };
+    }
+    async listRuns(sessionKey) {
+        if (!sessionKey) {
+            return [];
+        }
+        const runs = await this.repository.listRunsBySessionKey(sessionKey);
+        const out = [];
+        for (const run of runs) {
+            const tasks = await this.repository.listTasksByRun(run.id);
+            out.push({ run, tasks });
+        }
+        return out;
+    }
+    taskToAgentTask(task) {
+        const shape = taskRecordToAgentTaskShape(task);
+        return {
+            id: shape.id,
+            runId: shape.runId,
+            name: shape.name,
+            description: shape.description,
+            role: shape.role,
+            goal: shape.goal,
+            dependencies: shape.dependencies,
+            priority: shape.priority,
+            context: shape.context,
+            status: shape.status,
+            executorKind: shape.executorKind,
+            remoteAgentId: shape.remoteAgentId,
+            remoteTaskId: shape.remoteTaskId,
+            isWriter: shape.isWriter,
+            phase: shape.phase,
+        };
+    }
+    async installMissionsTemplate(runId, options) {
+        const initial = createDefaultMissionState('plan');
+        if (options.remoteValidatorId?.trim()) {
+            initial.remote_validator_id = options.remoteValidatorId.trim();
+        }
+        await this.patchMissionState(runId, initial, { skipAcl: true });
+        const plan = await this.addTask({
+            runId,
+            name: 'Plan',
+            role: 'planner',
+            phase: 'plan',
+            goal: 'Produce implementation plan (plan.md)',
+            description: 'Missions planning phase',
+        });
+        const writeSpec = await this.addTask({
+            runId,
+            name: 'WriteSpec',
+            role: 'planner',
+            phase: 'spec',
+            goal: 'Write Validation Spec under .zhin/missions/<runId>/ (spec.test.ts + manifest.json)',
+            description: 'Validation Spec phase',
+            dependsOn: [plan.id],
+        });
+        const develop = await this.addTask({
+            runId,
+            name: 'Develop',
+            role: 'subtask',
+            phase: 'develop',
+            is_writer: true,
+            goal: 'Implement to satisfy Validation Spec only',
+            description: 'Single writer development phase',
+            dependsOn: [writeSpec.id],
+        });
+        const validateExecutor = options.remoteValidatorId?.trim()
+            ? `remote:${options.remoteValidatorId.trim()}`
+            : undefined;
+        const validate = await this.addTask({
+            runId,
+            name: 'Validate',
+            role: 'validator',
+            phase: 'validate',
+            goal: 'Run run_validation_spec until all assertions pass',
+            description: options.remoteValidatorId ? 'Remote behavior validation' : 'Behavior validation phase',
+            dependsOn: [develop.id],
+            executor: validateExecutor,
+        });
+        await this.addTask({
+            runId,
+            name: 'Negotiate',
+            role: 'planner',
+            phase: 'negotiate',
+            goal: 'Re-evaluate mission direction on validation failure',
+            description: 'Negotiation phase',
+            dependsOn: [validate.id],
+        });
+    }
+    async patchMissionState(runId, patch, options) {
+        if (!options?.skipAcl) {
+            const current = await this.repository.getMissionState(runId);
+            if (current) {
+                const check = validateMissionStatePatch(current.phase, patch);
+                if (!check.ok) {
+                    throw new Error(check.reason ?? 'Mission State patch 被拒绝');
+                }
+            }
+        }
+        return this.repository.patchMissionState(runId, patch);
+    }
+    async getMissionState(runId) {
+        return this.repository.getMissionState(runId);
+    }
+}
+let globalService = null;
+export function initOrchestrationService(repository) {
+    globalService = new OrchestrationService(repository);
+    getAgentDispatcher().setRepository(repository);
+    return globalService;
+}
+export function getOrchestrationService() {
+    return globalService;
+}
+//# sourceMappingURL=orchestration-service.js.map

package/lib/orchestrator/orchestration-service.js.map

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

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

@@ -0,0 +1,32 @@
+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>;
+    healthCheckAll(): Promise<RemoteAgentHealth[]>;
+    pingAgent(agentId: string): Promise<RemoteAgentHealth>;
+}
+export declare function getRemoteAgentRegistry(): RemoteAgentRegistry;
+export declare function initRemoteAgentRegistry(config: AIConfig | undefined): RemoteAgentRegistry;
+//# 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;IAc5D,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"}

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

@@ -0,0 +1,120 @@
+/**
+ * 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 = new McpClientConnection(this.toMcpEntry(agent));
+            this.connections.set(agentId, conn);
+        }
+        if (!conn.isConnected) {
+            await conn.connect();
+        }
+        return conn;
+    }
+    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;
+}
+//# 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":"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"}

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

@@ -0,0 +1,16 @@
+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;
+//# 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"}

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

@@ -0,0 +1,75 @@
+/**
+ * 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;
+}
+//# sourceMappingURL=remote-task-poller.js.map