@zhin.js/agent 0.1.31 → 0.2.0

package/lib/orchestrator/delegation-processor.js

@@ -0,0 +1,146 @@
+/**
+ * DelegationProcessor — 处理入站 MCP agent.delegate_task 创建的待执行委托。
+ */
+import { randomUUID } from 'node:crypto';
+import { Logger } from '@zhin.js/logger';
+import { getOrchestrationService } from './orchestration-service.js';
+import { getAgentDispatcher } from './agent-dispatcher.js';
+const logger = new Logger(null, 'DelegationProcessor');
+const DELEGATION_SESSION_PREFIX = 'mesh:delegation:';
+export class DelegationProcessor {
+    options;
+    timer = null;
+    processing = new Set();
+    constructor(options) {
+        this.options = options;
+    }
+    start() {
+        if (this.timer)
+            return;
+        const ms = this.options.pollIntervalMs ?? 5_000;
+        this.timer = setInterval(() => void this.tick(), ms);
+        if (this.timer && typeof this.timer === 'object' && 'unref' in this.timer) {
+            this.timer.unref();
+        }
+    }
+    stop() {
+        if (this.timer) {
+            clearInterval(this.timer);
+            this.timer = null;
+        }
+    }
+    async createDelegation(payload) {
+        const orch = getOrchestrationService();
+        if (!orch)
+            throw new Error('OrchestrationService not ready');
+        const taskId = randomUUID().slice(0, 8);
+        const sessionKey = `${DELEGATION_SESSION_PREFIX}${taskId}`;
+        const snapshot = await orch.startRun({
+            sessionKey,
+            title: payload.title,
+        });
+        const task = await orch.addTask({
+            runId: snapshot.run.id,
+            name: payload.title,
+            description: payload.description,
+            goal: payload.description,
+            role: 'main',
+            context: {
+                acceptance_criteria: payload.acceptance_criteria ?? '',
+                artifacts: payload.artifacts ?? [],
+                delegation: true,
+            },
+        });
+        void this.processTask(task.id, this.buildDelegationPrompt(payload), sessionKey);
+        return { remote_task_id: task.id, run_id: snapshot.run.id };
+    }
+    buildDelegationPrompt(payload) {
+        const lines = [
+            `# Delegated Task: ${payload.title}`,
+            payload.description,
+        ];
+        if (payload.acceptance_criteria) {
+            lines.push('', '## Acceptance Criteria', payload.acceptance_criteria);
+        }
+        if (payload.artifacts?.length) {
+            lines.push('', '## Artifacts');
+            for (const a of payload.artifacts) {
+                lines.push(`### ${a.name ?? 'artifact'}`, a.content ?? '');
+            }
+        }
+        return lines.join('\n');
+    }
+    async tick() {
+        const orch = getOrchestrationService();
+        if (!orch)
+            return;
+        const runs = await orch.repositoryHandle.listRunsBySessionKeyPrefix(DELEGATION_SESSION_PREFIX);
+        for (const run of runs) {
+            if (run.status !== 'active')
+                continue;
+            const tasks = await orch.repositoryHandle.listTasksByRun(run.id);
+            for (const task of tasks) {
+                if (task.status !== 'pending' || this.processing.has(task.id))
+                    continue;
+                void this.processTask(task.id, task.goal || task.description, run.session_key);
+            }
+        }
+    }
+    async processTask(taskId, prompt, sessionKey) {
+        if (this.processing.has(taskId))
+            return;
+        this.processing.add(taskId);
+        const orch = getOrchestrationService();
+        const dispatcher = getAgentDispatcher();
+        try {
+            await orch?.repositoryHandle.updateTaskStatus(taskId, 'running', { started_at: Date.now() });
+            dispatcher.syncTaskFromRecord((await orch.repositoryHandle.getTask(taskId)));
+            const context = {
+                platform: 'mesh',
+                botId: 'delegation',
+                sceneId: sessionKey,
+                senderId: 'remote-delegate',
+                scope: 'private',
+            };
+            await this.options.zhinAgent.prompt(prompt, context);
+            const resultText = 'Delegation completed via main agent turn';
+            dispatcher.recordResult({
+                taskId,
+                role: 'main',
+                success: true,
+                summary: resultText,
+                duration: 0,
+            });
+        }
+        catch (err) {
+            dispatcher.recordResult({
+                taskId,
+                role: 'main',
+                success: false,
+                summary: 'delegation failed',
+                error: err instanceof Error ? err.message : String(err),
+                duration: 0,
+            });
+            logger.error(`Delegation task ${taskId} failed:`, err);
+        }
+        finally {
+            this.processing.delete(taskId);
+        }
+    }
+}
+let globalProcessor = null;
+export function initDelegationProcessor(options) {
+    globalProcessor = new DelegationProcessor(options);
+    globalProcessor.start();
+    return globalProcessor;
+}
+export function getDelegationProcessor() {
+    return globalProcessor;
+}
+export function stopDelegationProcessor() {
+    if (globalProcessor) {
+        globalProcessor.stop();
+        globalProcessor = null;
+    }
+}
+//# sourceMappingURL=delegation-processor.js.map

package/lib/orchestrator/delegation-processor.js.map

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

package/lib/orchestrator/mission-milestone-notify.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Mission milestone IM delivery (ADR 0011 D7).
+ */
+import type { SendOptions } from '@zhin.js/core';
+import type { SubagentOrigin } from '../subagent.js';
+export interface ParsedSessionKey {
+    platform: string;
+    botId: string;
+    scope: 'private' | 'group' | 'channel';
+    sceneId: string;
+}
+/** Parse `platform:botId:scope:sceneId` session keys. */
+export declare function parseOrchestrationSessionKey(sessionKey: string): ParsedSessionKey | null;
+export declare function formatMissionMilestoneMessage(kind: string, runId: string, message: string): string;
+export declare function sessionKeyToSubagentOrigin(sessionKey: string): SubagentOrigin | null;
+export declare function deliverMissionMilestoneIm(sessionKey: string, kind: string, runId: string, message: string, send: (options: SendOptions) => Promise<string>): Promise<boolean>;
+//# sourceMappingURL=mission-milestone-notify.d.ts.map

package/lib/orchestrator/mission-milestone-notify.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-milestone-notify.d.ts","sourceRoot":"","sources":["../../src/orchestrator/mission-milestone-notify.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAErD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,KAAK,EAAE,SAAS,GAAG,OAAO,GAAG,SAAS,CAAC;IACvC,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,yDAAyD;AACzD,wBAAgB,4BAA4B,CAAC,UAAU,EAAE,MAAM,GAAG,gBAAgB,GAAG,IAAI,CAQxF;AAED,wBAAgB,6BAA6B,CAC3C,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,GACd,MAAM,CASR;AAED,wBAAgB,0BAA0B,CAAC,UAAU,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAUpF;AAED,wBAAsB,yBAAyB,CAC7C,UAAU,EAAE,MAAM,EAClB,IAAI,EAAE,MAAM,EACZ,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,MAAM,EACf,IAAI,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,GAC9C,OAAO,CAAC,OAAO,CAAC,CAYlB"}

package/lib/orchestrator/mission-milestone-notify.js

@@ -0,0 +1,49 @@
+/** Parse `platform:botId:scope:sceneId` session keys. */
+export function parseOrchestrationSessionKey(sessionKey) {
+    const parts = sessionKey.split(':');
+    if (parts.length < 4)
+        return null;
+    const [platform, botId, scopeRaw, ...rest] = parts;
+    const scope = scopeRaw === 'group' || scopeRaw === 'channel' ? scopeRaw : 'private';
+    const sceneId = rest.join(':');
+    if (!platform || !botId || !sceneId)
+        return null;
+    return { platform, botId, scope, sceneId };
+}
+export function formatMissionMilestoneMessage(kind, runId, message) {
+    const labels = {
+        mission_complete: 'Mission 完成',
+        mission_failed: 'Mission 失败',
+        mission_started: 'Mission 已启动',
+        mission_spec_gate_failed: 'Spec 门禁失败',
+    };
+    const title = labels[kind] ?? 'Mission 里程碑';
+    return `[${title}] run=${runId}\n${message}`;
+}
+export function sessionKeyToSubagentOrigin(sessionKey) {
+    const parsed = parseOrchestrationSessionKey(sessionKey);
+    if (!parsed)
+        return null;
+    return {
+        platform: parsed.platform,
+        botId: parsed.botId,
+        sceneId: parsed.sceneId,
+        senderId: 'mission-milestone',
+        sceneType: parsed.scope,
+    };
+}
+export async function deliverMissionMilestoneIm(sessionKey, kind, runId, message, send) {
+    const parsed = parseOrchestrationSessionKey(sessionKey);
+    if (!parsed)
+        return false;
+    const text = formatMissionMilestoneMessage(kind, runId, message);
+    await send({
+        context: parsed.platform,
+        bot: parsed.botId,
+        id: parsed.sceneId,
+        type: parsed.scope,
+        content: text,
+    });
+    return true;
+}
+//# sourceMappingURL=mission-milestone-notify.js.map

package/lib/orchestrator/mission-milestone-notify.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-milestone-notify.js","sourceRoot":"","sources":["../../src/orchestrator/mission-milestone-notify.ts"],"names":[],"mappings":"AAaA,yDAAyD;AACzD,MAAM,UAAU,4BAA4B,CAAC,UAAkB;IAC7D,MAAM,KAAK,GAAG,UAAU,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IACpC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IAClC,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,GAAG,IAAI,CAAC,GAAG,KAAK,CAAC;IACnD,MAAM,KAAK,GAAG,QAAQ,KAAK,OAAO,IAAI,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC;IACpF,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAC/B,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IACjD,OAAO,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,CAAC;AAC7C,CAAC;AAED,MAAM,UAAU,6BAA6B,CAC3C,IAAY,EACZ,KAAa,EACb,OAAe;IAEf,MAAM,MAAM,GAA2B;QACrC,gBAAgB,EAAE,YAAY;QAC9B,cAAc,EAAE,YAAY;QAC5B,eAAe,EAAE,aAAa;QAC9B,wBAAwB,EAAE,WAAW;KACtC,CAAC;IACF,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,aAAa,CAAC;IAC5C,OAAO,IAAI,KAAK,SAAS,KAAK,KAAK,OAAO,EAAE,CAAC;AAC/C,CAAC;AAED,MAAM,UAAU,0BAA0B,CAAC,UAAkB;IAC3D,MAAM,MAAM,GAAG,4BAA4B,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IACzB,OAAO;QACL,QAAQ,EAAE,MAAM,CAAC,QAAQ;QACzB,KAAK,EAAE,MAAM,CAAC,KAAK;QACnB,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,QAAQ,EAAE,mBAAmB;QAC7B,SAAS,EAAE,MAAM,CAAC,KAAK;KACxB,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,UAAkB,EAClB,IAAY,EACZ,KAAa,EACb,OAAe,EACf,IAA+C;IAE/C,MAAM,MAAM,GAAG,4BAA4B,CAAC,UAAU,CAAC,CAAC;IACxD,IAAI,CAAC,MAAM;QAAE,OAAO,KAAK,CAAC;IAC1B,MAAM,IAAI,GAAG,6BAA6B,CAAC,IAAI,EAAE,KAAK,EAAE,OAAO,CAAC,CAAC;IACjE,MAAM,IAAI,CAAC;QACT,OAAO,EAAE,MAAM,CAAC,QAAQ;QACxB,GAAG,EAAE,MAAM,CAAC,KAAK;QACjB,EAAE,EAAE,MAAM,CAAC,OAAO;QAClB,IAAI,EAAE,MAAM,CAAC,KAAK;QAClB,OAAO,EAAE,IAAI;KACd,CAAC,CAAC;IACH,OAAO,IAAI,CAAC;AACd,CAAC"}

package/lib/orchestrator/mission-negotiation.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Mission Negotiation — phase gate decisions (ADR 0011 D5).
+ */
+import type { AgentResult } from './agent-dispatcher.js';
+import type { OrchestrationTaskRecord } from '@zhin.js/ai';
+import { type MissionState } from './mission-state.js';
+import type { OrchestrationService } from './orchestration-service.js';
+export interface NegotiationOutcome {
+    action: 'continue' | 'retry_dev' | 'replan_spec' | 'skip_negotiate' | 'fail_run';
+    reason: string;
+    statePatch?: Partial<MissionState>;
+    skipTaskIds?: string[];
+    retryTaskIds?: string[];
+}
+export declare function evaluateMissionNegotiation(service: OrchestrationService, runId: string, completedTask: OrchestrationTaskRecord, result: AgentResult, tasks: OrchestrationTaskRecord[]): Promise<NegotiationOutcome>;
+export declare function applyNegotiationOutcome(service: OrchestrationService, runId: string, outcome: NegotiationOutcome): Promise<void>;
+//# sourceMappingURL=mission-negotiation.d.ts.map

package/lib/orchestrator/mission-negotiation.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-negotiation.d.ts","sourceRoot":"","sources":["../../src/orchestrator/mission-negotiation.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACzD,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,aAAa,CAAC;AAC3D,OAAO,EAEL,KAAK,YAAY,EAClB,MAAM,oBAAoB,CAAC;AAC5B,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4BAA4B,CAAC;AAEvE,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,UAAU,GAAG,WAAW,GAAG,aAAa,GAAG,gBAAgB,GAAG,UAAU,CAAC;IACjF,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,OAAO,CAAC,YAAY,CAAC,CAAC;IACnC,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;IACvB,YAAY,CAAC,EAAE,MAAM,EAAE,CAAC;CACzB;AAED,wBAAsB,0BAA0B,CAC9C,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,MAAM,EACb,aAAa,EAAE,uBAAuB,EACtC,MAAM,EAAE,WAAW,EACnB,KAAK,EAAE,uBAAuB,EAAE,GAC/B,OAAO,CAAC,kBAAkB,CAAC,CA+E7B;AAED,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,oBAAoB,EAC7B,KAAK,EAAE,MAAM,EACb,OAAO,EAAE,kBAAkB,GAC1B,OAAO,CAAC,IAAI,CAAC,CAgBf"}

package/lib/orchestrator/mission-negotiation.js

@@ -0,0 +1,89 @@
+import { appendDecisionLog, } from './mission-state.js';
+export async function evaluateMissionNegotiation(service, runId, completedTask, result, tasks) {
+    const state = await service.getMissionState(runId);
+    if (!state) {
+        return { action: 'continue', reason: 'no mission state' };
+    }
+    if (completedTask.phase === 'validate') {
+        if (result.success) {
+            const negotiate = tasks.find((t) => t.phase === 'negotiate');
+            return {
+                action: 'skip_negotiate',
+                reason: 'validation passed',
+                skipTaskIds: negotiate ? [negotiate.id] : [],
+                statePatch: { phase: 'done' },
+            };
+        }
+        const remaining = state.retry_budget.validate;
+        if (remaining > 0) {
+            const dev = tasks.find((t) => t.phase === 'develop');
+            return {
+                action: 'retry_dev',
+                reason: `validation failed, ${remaining - 1} retries left`,
+                retryTaskIds: dev ? [dev.id] : [],
+                statePatch: appendDecisionLog({
+                    ...state,
+                    retry_budget: { ...state.retry_budget, validate: remaining - 1 },
+                    phase: 'develop',
+                }, { actor: 'negotiation', action: 'retry_dev', reason: result.summary.slice(0, 200) }),
+            };
+        }
+        return {
+            action: 'replan_spec',
+            reason: 'validation retry budget exhausted',
+            retryTaskIds: tasks.filter((t) => t.phase === 'spec' || t.phase === 'develop').map((t) => t.id),
+            statePatch: appendDecisionLog(state, {
+                actor: 'negotiation',
+                action: 'replan_spec',
+                reason: 'validate retries exhausted',
+            }),
+        };
+    }
+    if (completedTask.phase === 'negotiate') {
+        if (result.success) {
+            return { action: 'continue', reason: 'negotiation completed' };
+        }
+        return {
+            action: 'fail_run',
+            reason: result.error ?? result.summary,
+            statePatch: appendDecisionLog(state, {
+                actor: 'negotiation',
+                action: 'fail_run',
+                reason: result.error ?? result.summary,
+            }),
+        };
+    }
+    if (completedTask.phase === 'spec' && result.success) {
+        return {
+            action: 'continue',
+            reason: 'spec phase done',
+            statePatch: { phase: 'develop' },
+        };
+    }
+    if (completedTask.phase === 'plan' && result.success) {
+        return {
+            action: 'continue',
+            reason: 'plan phase done',
+            statePatch: { phase: 'spec' },
+        };
+    }
+    return { action: 'continue', reason: 'default' };
+}
+export async function applyNegotiationOutcome(service, runId, outcome) {
+    if (outcome.statePatch) {
+        await service.patchMissionState(runId, outcome.statePatch, { skipAcl: true });
+    }
+    for (const taskId of outcome.skipTaskIds ?? []) {
+        await service.skipTask(taskId, outcome.reason);
+    }
+    for (const taskId of outcome.retryTaskIds ?? []) {
+        const task = await service.repositoryHandle.getTask(taskId);
+        if (task && (task.status === 'completed' || task.status === 'failed')) {
+            await service.retryTask(taskId);
+        }
+    }
+    if (outcome.action === 'fail_run') {
+        await service.completeRun(runId, true);
+    }
+}
+//# sourceMappingURL=mission-negotiation.js.map

package/lib/orchestrator/mission-negotiation.js.map

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

package/lib/orchestrator/mission-patch-acl.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Mission State patch ACL — phase-scoped writes (missions-v2).
+ */
+import type { MissionPhase, MissionState } from './mission-state.js';
+export declare function validateMissionStatePatch(currentPhase: MissionPhase, patch: Partial<MissionState>): {
+    ok: boolean;
+    reason?: string;
+};
+//# sourceMappingURL=mission-patch-acl.d.ts.map

package/lib/orchestrator/mission-patch-acl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-patch-acl.d.ts","sourceRoot":"","sources":["../../src/orchestrator/mission-patch-acl.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AAcrE,wBAAgB,yBAAyB,CACvC,YAAY,EAAE,YAAY,EAC1B,KAAK,EAAE,OAAO,CAAC,YAAY,CAAC,GAC3B;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,CAgBlC"}

package/lib/orchestrator/mission-patch-acl.js

@@ -0,0 +1,29 @@
+const PHASE_ALLOWED_KEYS = {
+    plan: new Set(['phase', 'plan_summary', 'decision_log', 'remote_validator_id']),
+    spec: new Set([
+        'phase', 'plan_summary', 'validation_spec_paths', 'assertion_count',
+        'spec_dry_run_passed', 'decision_log',
+    ]),
+    develop: new Set(['phase', 'writer_task_id', 'decision_log']),
+    validate: new Set(['phase', 'last_validation', 'decision_log']),
+    negotiate: new Set(['phase', 'decision_log', 'retry_budget']),
+    done: new Set(['phase', 'decision_log']),
+};
+export function validateMissionStatePatch(currentPhase, patch) {
+    const allowed = PHASE_ALLOWED_KEYS[currentPhase] ?? PHASE_ALLOWED_KEYS.plan;
+    for (const key of Object.keys(patch)) {
+        if (!allowed.has(key)) {
+            return { ok: false, reason: `phase=${currentPhase} 不允许写入字段 ${key}` };
+        }
+    }
+    if (patch.phase && patch.phase !== currentPhase) {
+        const order = ['plan', 'spec', 'develop', 'validate', 'negotiate', 'done'];
+        const cur = order.indexOf(currentPhase);
+        const next = order.indexOf(patch.phase);
+        if (next > cur + 1) {
+            return { ok: false, reason: `不允许从 phase=${currentPhase} 跳到 ${patch.phase}` };
+        }
+    }
+    return { ok: true };
+}
+//# sourceMappingURL=mission-patch-acl.js.map

package/lib/orchestrator/mission-patch-acl.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-patch-acl.js","sourceRoot":"","sources":["../../src/orchestrator/mission-patch-acl.ts"],"names":[],"mappings":"AAKA,MAAM,kBAAkB,GAA0D;IAChF,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,qBAAqB,CAAC,CAAC;IAC/E,IAAI,EAAE,IAAI,GAAG,CAAC;QACZ,OAAO,EAAE,cAAc,EAAE,uBAAuB,EAAE,iBAAiB;QACnE,qBAAqB,EAAE,cAAc;KACtC,CAAC;IACF,OAAO,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,gBAAgB,EAAE,cAAc,CAAC,CAAC;IAC7D,QAAQ,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,iBAAiB,EAAE,cAAc,CAAC,CAAC;IAC/D,SAAS,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,cAAc,EAAE,cAAc,CAAC,CAAC;IAC7D,IAAI,EAAE,IAAI,GAAG,CAAC,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;CACzC,CAAC;AAEF,MAAM,UAAU,yBAAyB,CACvC,YAA0B,EAC1B,KAA4B;IAE5B,MAAM,OAAO,GAAG,kBAAkB,CAAC,YAAY,CAAC,IAAI,kBAAkB,CAAC,IAAI,CAAC;IAC5E,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,KAAK,CAA2B,EAAE,CAAC;QAC/D,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,SAAS,YAAY,YAAY,GAAG,EAAE,EAAE,CAAC;QACvE,CAAC;IACH,CAAC;IACD,IAAI,KAAK,CAAC,KAAK,IAAI,KAAK,CAAC,KAAK,KAAK,YAAY,EAAE,CAAC;QAChD,MAAM,KAAK,GAAmB,CAAC,MAAM,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,CAAC,CAAC;QAC3F,MAAM,GAAG,GAAG,KAAK,CAAC,OAAO,CAAC,YAAY,CAAC,CAAC;QACxC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;QACxC,IAAI,IAAI,GAAG,GAAG,GAAG,CAAC,EAAE,CAAC;YACnB,OAAO,EAAE,EAAE,EAAE,KAAK,EAAE,MAAM,EAAE,cAAc,YAAY,OAAO,KAAK,CAAC,KAAK,EAAE,EAAE,CAAC;QAC/E,CAAC;IACH,CAAC;IACD,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,CAAC;AACtB,CAAC"}

package/lib/orchestrator/mission-runner.d.ts

@@ -0,0 +1,24 @@
+import type { ToolContext } from '@zhin.js/core';
+import type { SubagentManager } from '../subagent.js';
+import type { SendOptions } from '@zhin.js/core';
+export interface MissionRunnerDeps {
+    subagentManager: SubagentManager;
+    resolveSessionContext: (sessionKey: string) => ToolContext | null;
+    sendImMessage?: (options: SendOptions) => Promise<string>;
+}
+export declare class MissionRunner {
+    private readonly deps;
+    private unsub?;
+    constructor(deps: MissionRunnerDeps);
+    start(): void;
+    stop(): void;
+    advanceRun(runId: string): Promise<void>;
+    private handleResult;
+    notifyRunStarted(runId: string, sessionKey: string): Promise<void>;
+    private tryAutoSpecGate;
+    private spawnOrchestrationTask;
+    private notifyMilestone;
+}
+export declare function initMissionRunner(deps: MissionRunnerDeps): MissionRunner;
+export declare function getMissionRunner(): MissionRunner | null;
+//# sourceMappingURL=mission-runner.d.ts.map

package/lib/orchestrator/mission-runner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mission-runner.d.ts","sourceRoot":"","sources":["../../src/orchestrator/mission-runner.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AACjD,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AAiBtD,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,eAAe,CAAC;AAIjD,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,eAAe,CAAC;IACjC,qBAAqB,EAAE,CAAC,UAAU,EAAE,MAAM,KAAK,WAAW,GAAG,IAAI,CAAC;IAClE,aAAa,CAAC,EAAE,CAAC,OAAO,EAAE,WAAW,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC3D;AAID,qBAAa,aAAa;IAGZ,OAAO,CAAC,QAAQ,CAAC,IAAI;IAFjC,OAAO,CAAC,KAAK,CAAC,CAAa;gBAEE,IAAI,EAAE,iBAAiB;IAEpD,KAAK,IAAI,IAAI;IAOb,IAAI,IAAI,IAAI;IAKN,UAAU,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAkBhC,YAAY;IAuDpB,gBAAgB,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;YAS1D,eAAe;YAyCf,sBAAsB;YA+CtB,eAAe;CAsB9B;AAED,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,iBAAiB,GAAG,aAAa,CAKxE;AAED,wBAAgB,gBAAgB,IAAI,aAAa,GAAG,IAAI,CAEvD"}

package/lib/orchestrator/mission-runner.js

@@ -0,0 +1,179 @@
+/**
+ * MissionRunner — 始终自动推进 missions run（ADR 0011 D6）。
+ */
+import { Logger } from '@zhin.js/logger';
+import { originFromToolContext } from '../builtin/spawn-task-tool.js';
+import { getAgentDispatcher, } from './agent-dispatcher.js';
+import { getOrchestrationService } from './orchestration-service.js';
+import { appendDecisionLog, isMissionsTemplate } from './mission-state.js';
+import { applyNegotiationOutcome, evaluateMissionNegotiation, } from './mission-negotiation.js';
+import { deliverMissionMilestoneIm } from './mission-milestone-notify.js';
+import { defaultMissionSpecPaths, validateMissionSpecBundle, } from './mission-spec.js';
+const logger = new Logger(null, 'MissionRunner');
+let runnerInstance = null;
+export class MissionRunner {
+    deps;
+    unsub;
+    constructor(deps) {
+        this.deps = deps;
+    }
+    start() {
+        if (this.unsub)
+            return;
+        this.unsub = getAgentDispatcher().onResult((result) => {
+            void this.handleResult(result);
+        });
+    }
+    stop() {
+        this.unsub?.();
+        this.unsub = undefined;
+    }
+    async advanceRun(runId) {
+        const orch = getOrchestrationService();
+        if (!orch)
+            return;
+        const snapshot = await orch.getStatus(runId);
+        if (!snapshot || !isMissionsTemplate(snapshot.run))
+            return;
+        const dispatcher = getAgentDispatcher();
+        await dispatcher.hydrateRun(runId);
+        for (const task of snapshot.tasks) {
+            if (task.status !== 'pending')
+                continue;
+            const gate = await dispatcher.canExecuteMissions(task.id);
+            if (!gate.canExecute)
+                continue;
+            await this.spawnOrchestrationTask(runId, task.id, snapshot.run.session_key);
+            return;
+        }
+    }
+    async handleResult(result) {
+        const task = getAgentDispatcher().getTask(result.taskId);
+        if (!task?.runId)
+            return;
+        const orch = getOrchestrationService();
+        if (!orch)
+            return;
+        const snapshot = await orch.getStatus(task.runId);
+        if (!snapshot || !isMissionsTemplate(snapshot.run))
+            return;
+        const completed = snapshot.tasks.find((t) => t.id === result.taskId);
+        if (!completed)
+            return;
+        const negotiation = await evaluateMissionNegotiation(orch, task.runId, completed, result, snapshot.tasks);
+        await applyNegotiationOutcome(orch, task.runId, negotiation);
+        if (completed.phase === 'spec' && result.success) {
+            const gateOk = await this.tryAutoSpecGate(task.runId);
+            if (!gateOk) {
+                await this.notifyMilestone(task.runId, 'mission_spec_gate_failed', 'Validation Spec dry-run / manifest 未通过，WriteSpec 需重试', snapshot.run.session_key);
+                return;
+            }
+        }
+        if (negotiation.action === 'skip_negotiate' && result.success) {
+            await this.notifyMilestone(task.runId, 'mission_complete', 'Mission 验证通过，可合并', snapshot.run.session_key);
+        }
+        if (negotiation.action === 'fail_run') {
+            await this.notifyMilestone(task.runId, 'mission_failed', negotiation.reason, snapshot.run.session_key);
+        }
+        await this.advanceRun(task.runId);
+    }
+    async notifyRunStarted(runId, sessionKey) {
+        await this.notifyMilestone(runId, 'mission_started', 'Mission 编排已启动，MissionRunner 自动推进中', sessionKey);
+    }
+    async tryAutoSpecGate(runId) {
+        const orch = getOrchestrationService();
+        if (!orch)
+            return false;
+        const state = await orch.getMissionState(runId);
+        if (!state || state.spec_dry_run_passed)
+            return true;
+        const defaults = defaultMissionSpecPaths(runId);
+        const specPaths = state.validation_spec_paths.length
+            ? [...state.validation_spec_paths, defaults.manifestPath]
+            : [defaults.specTestPath, defaults.manifestPath];
+        const result = await validateMissionSpecBundle(runId, specPaths, true);
+        if (!result.ok) {
+            const current = await orch.getMissionState(runId);
+            if (current) {
+                await orch.patchMissionState(runId, appendDecisionLog({ ...current, spec_dry_run_passed: false }, {
+                    actor: 'mission-runner',
+                    action: 'spec_gate_fail',
+                    reason: result.reason ?? 'spec dry-run failed',
+                }), { skipAcl: true });
+            }
+            const specTask = (await orch.getStatus(runId))?.tasks.find((t) => t.phase === 'spec');
+            if (specTask && specTask.status === 'completed') {
+                await orch.retryTask(specTask.id);
+            }
+            return false;
+        }
+        await orch.patchMissionState(runId, {
+            validation_spec_paths: specPaths.filter((p) => p.endsWith('.test.ts') || p.includes('spec')),
+            assertion_count: result.assertionCount,
+            spec_dry_run_passed: true,
+            phase: 'develop',
+        }, { skipAcl: true });
+        return true;
+    }
+    async spawnOrchestrationTask(runId, taskId, sessionKey) {
+        const dispatcher = getAgentDispatcher();
+        const agentTask = dispatcher.getTask(taskId);
+        if (!agentTask)
+            return;
+        const ctx = this.deps.resolveSessionContext(sessionKey) ?? {
+            platform: 'orchestration',
+            botId: 'mission-runner',
+            sceneId: sessionKey,
+            senderId: 'mission-runner',
+            scope: 'private',
+        };
+        const origin = originFromToolContext(ctx);
+        dispatcher.markRunning(taskId, Promise.resolve({
+            taskId,
+            role: agentTask.role,
+            success: true,
+            summary: 'running',
+            duration: 0,
+        }));
+        void this.deps.subagentManager.spawn({
+            task: agentTask.goal || agentTask.description || agentTask.name,
+            label: agentTask.name,
+            origin,
+            role: agentTask.role,
+            orchestrationTaskId: taskId,
+            notifyContext: ctx,
+            contextMode: 'fresh',
+        }).catch((err) => {
+            logger.error('MissionRunner spawn failed:', err);
+            dispatcher.recordResult({
+                taskId,
+                role: agentTask.role,
+                success: false,
+                summary: 'spawn failed',
+                error: err instanceof Error ? err.message : String(err),
+                duration: 0,
+            });
+        });
+    }
+    async notifyMilestone(runId, kind, message, sessionKey) {
+        logger.info({ runId, kind, message }, 'Mission milestone');
+        if (sessionKey && this.deps.sendImMessage) {
+            try {
+                await deliverMissionMilestoneIm(sessionKey, kind, runId, message, this.deps.sendImMessage);
+            }
+            catch (err) {
+                logger.warn({ runId, kind, err }, 'Mission milestone IM notify failed');
+            }
+        }
+    }
+}
+export function initMissionRunner(deps) {
+    runnerInstance?.stop();
+    runnerInstance = new MissionRunner(deps);
+    runnerInstance.start();
+    return runnerInstance;
+}
+export function getMissionRunner() {
+    return runnerInstance;
+}
+//# sourceMappingURL=mission-runner.js.map

package/lib/orchestrator/mission-runner.js.map

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