@zhin.js/agent 0.1.30 → 0.1.32

package/lib/builtin/orchestration-tools.js

@@ -0,0 +1,283 @@
+import { resolveIMSessionIdFromToolContext } from '@zhin.js/ai';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+import { getOrchestrationService, } from '../orchestrator/orchestration-service.js';
+import { writeOrchestrationRunSummaryToMemory } from '../orchestration-memory-hook.js';
+function sessionKeyFromContext(ctx) {
+    return resolveIMSessionIdFromToolContext({
+        platform: ctx.platform || '',
+        botId: ctx.botId || '',
+        scope: ctx.scope,
+        sceneId: ctx.sceneId || '',
+        senderId: ctx.senderId || '',
+    });
+}
+function requireService() {
+    const svc = getOrchestrationService();
+    if (!svc)
+        throw new Error('OrchestrationService 未初始化');
+    return svc;
+}
+function formatRunStatus(runId, snapshot) {
+    if (!snapshot)
+        return `Run ${runId} 不存在`;
+    const lines = [
+        `# Run ${snapshot.run.id}`,
+        `status: ${snapshot.run.status}`,
+        `title: ${snapshot.run.title}`,
+        `template: ${snapshot.run.template || '(none)'}`,
+        `session: ${snapshot.run.session_key}`,
+        '',
+        '## Tasks',
+    ];
+    for (const t of snapshot.tasks) {
+        lines.push(`- [${t.status}] ${t.id} (${t.role}) ${t.name}`
+            + (t.executor_kind === 'remote' ? ` remote:${t.remote_agent_id}` : '')
+            + (t.depends_on && t.depends_on !== '[]' ? ` deps:${t.depends_on}` : ''));
+        if (t.result_summary)
+            lines.push(`  result: ${t.result_summary.slice(0, 200)}`);
+        if (t.error)
+            lines.push(`  error: ${t.error.slice(0, 200)}`);
+    }
+    if (snapshot.run.mission_state_json?.trim()) {
+        try {
+            const ms = JSON.parse(snapshot.run.mission_state_json);
+            lines.push('', '## Mission State');
+            lines.push(`phase: ${ms.phase}`);
+            if (ms.validation_spec_paths?.length) {
+                lines.push(`spec_paths: ${ms.validation_spec_paths.join(', ')}`);
+            }
+            if (ms.last_validation) {
+                lines.push(`last_validation: passed=${ms.last_validation.passed} failed=${ms.last_validation.failed}`);
+            }
+        }
+        catch {
+            // ignore invalid mission state
+        }
+    }
+    return lines.join('\n');
+}
+const START_PARAMS = {
+    type: 'object',
+    properties: {
+        title: { type: 'string', description: 'Run 标题' },
+        remote_validator: {
+            type: 'string',
+            description: '可选：Validate 跑在 remote:<agentId>',
+        },
+    },
+};
+const ADD_TASK_PARAMS = {
+    type: 'object',
+    properties: {
+        run_id: { type: 'string', description: '编排 run ID' },
+        name: { type: 'string', description: '任务名称' },
+        description: { type: 'string', description: '任务描述' },
+        role: {
+            type: 'string',
+            enum: ['planner', 'subtask', 'reviewer', 'researcher', 'executor', 'worker', 'validator'],
+            description: 'Agent 角色',
+        },
+        goal: { type: 'string', description: '任务目标' },
+        depends_on: {
+            type: 'array',
+            items: { type: 'string' },
+            description: '依赖任务 ID 列表',
+        },
+        executor: {
+            type: 'string',
+            description: 'local 或 remote:<agentId>',
+        },
+        context: { type: 'object', description: '结构化上下文（JSON）' },
+    },
+    required: ['run_id', 'name'],
+};
+const RUN_ID_PARAMS = {
+    type: 'object',
+    properties: {
+        run_id: { type: 'string', description: '编排 run ID' },
+        force: { type: 'boolean', description: '强制关闭（忽略未完成节点）' },
+    },
+    required: ['run_id'],
+};
+const TASK_ID_PARAMS = {
+    type: 'object',
+    properties: {
+        task_id: { type: 'string', description: '任务 ID' },
+        reason: { type: 'string', description: 'skip 原因' },
+    },
+    required: ['task_id'],
+};
+const PATCH_STATE_PARAMS = {
+    type: 'object',
+    properties: {
+        run_id: { type: 'string', description: '编排 run ID' },
+        patch: { type: 'object', description: 'Mission State 部分更新（JSON）' },
+    },
+    required: ['run_id', 'patch'],
+};
+class OrchestrationPatchStateTool extends BuiltinBaseTool {
+    name = 'orchestration_patch_state';
+    description = '更新 Mission State（missions Broadcast 共享状态；按 phase ACL 校验）。';
+    parameters = PATCH_STATE_PARAMS;
+    async run(args) {
+        const svc = requireService();
+        const runId = String(args.run_id ?? '');
+        if (!runId)
+            return '请提供 run_id';
+        const patch = args.patch;
+        if (!patch || typeof patch !== 'object')
+            return '请提供 patch 对象';
+        try {
+            const next = await svc.patchMissionState(runId, patch);
+            if (!next)
+                return `Run ${runId} 不存在`;
+            return `Mission State 已更新：phase=${next.phase} spec_paths=${next.validation_spec_paths.length}`;
+        }
+        catch (err) {
+            return err instanceof Error ? err.message : String(err);
+        }
+    }
+}
+class OrchestrationStartTool extends BuiltinBaseTool {
+    sessionContext;
+    name = 'orchestration_start';
+    description = '创建 Mission 编排 run（missions 五阶段 DAG）；MissionRunner 自动推进。';
+    parameters = START_PARAMS;
+    constructor(sessionContext) {
+        super();
+        this.sessionContext = sessionContext;
+        this.tags.push('orchestration', 'director');
+    }
+    async run(args) {
+        const svc = requireService();
+        const sessionKey = sessionKeyFromContext(this.sessionContext);
+        const title = typeof args.title === 'string' ? args.title : undefined;
+        const remoteValidator = typeof args.remote_validator === 'string'
+            ? args.remote_validator.replace(/^remote:/, '')
+            : undefined;
+        const snapshot = await svc.startRun({ sessionKey, title, remoteValidator });
+        const { isMissionsTemplate } = await import('../orchestrator/mission-state.js');
+        if (isMissionsTemplate({ template: snapshot.run.template })) {
+            const { getMissionRunner } = await import('../orchestrator/mission-runner.js');
+            const runner = getMissionRunner();
+            if (runner) {
+                void runner.notifyRunStarted(snapshot.run.id, sessionKey);
+                void runner.advanceRun(snapshot.run.id);
+            }
+        }
+        const tpl = snapshot.run.template || '(custom)';
+        return (`编排 run 已创建：${snapshot.run.id}\n`
+            + `template: ${tpl}\n`
+            + `session: ${sessionKey}\n`
+            + `tasks: ${snapshot.tasks.map((t) => `${t.id}(${t.role})`).join(', ') || '(empty)'}\n`
+            + (snapshot.tasks.length
+                ? 'MissionRunner 将自动推进；无需手动 spawn_task。'
+                : '使用 orchestration_add_task 添加节点。'));
+    }
+}
+class OrchestrationAddTaskTool extends BuiltinBaseTool {
+    name = 'orchestration_add_task';
+    description = '向 run 添加 DAG 节点（role、depends_on、executor）。';
+    parameters = ADD_TASK_PARAMS;
+    async run(args) {
+        const svc = requireService();
+        const runId = String(args.run_id ?? '');
+        if (!runId)
+            return '请提供 run_id';
+        const input = {
+            runId,
+            name: String(args.name ?? 'task'),
+            description: typeof args.description === 'string' ? args.description : undefined,
+            role: typeof args.role === 'string' ? args.role : undefined,
+            goal: typeof args.goal === 'string' ? args.goal : undefined,
+            dependsOn: Array.isArray(args.depends_on) ? args.depends_on.map(String) : undefined,
+            executor: typeof args.executor === 'string'
+                ? args.executor
+                : undefined,
+            context: args.context && typeof args.context === 'object'
+                ? args.context
+                : undefined,
+        };
+        const task = await svc.addTask(input);
+        return `任务已添加：${task.id} (${task.role}) status=${task.status}`;
+    }
+}
+class OrchestrationStatusTool extends BuiltinBaseTool {
+    name = 'orchestration_status';
+    description = '查询 run 及 DAG 任务状态。';
+    parameters = RUN_ID_PARAMS;
+    async run(args) {
+        const svc = requireService();
+        const runId = String(args.run_id ?? '');
+        if (!runId)
+            return '请提供 run_id';
+        const snapshot = await svc.getStatus(runId);
+        return formatRunStatus(runId, snapshot);
+    }
+}
+class OrchestrationCompleteTool extends BuiltinBaseTool {
+    name = 'orchestration_complete';
+    description = '关闭编排 run（默认要求无 pending/running 节点）。';
+    parameters = RUN_ID_PARAMS;
+    async run(args) {
+        const svc = requireService();
+        const runId = String(args.run_id ?? '');
+        if (!runId)
+            return '请提供 run_id';
+        const result = await svc.completeRun(runId, args.force === true);
+        if (result.ok) {
+            const snapshot = await svc.getStatus(runId);
+            if (snapshot)
+                await writeOrchestrationRunSummaryToMemory(snapshot);
+        }
+        return result.message;
+    }
+}
+class OrchestrationRetryTaskTool extends BuiltinBaseTool {
+    name = 'orchestration_retry_task';
+    description = '将 failed 任务重置为 pending，解锁下游。';
+    parameters = TASK_ID_PARAMS;
+    async run(args) {
+        const svc = requireService();
+        const taskId = String(args.task_id ?? '');
+        if (!taskId)
+            return '请提供 task_id';
+        const result = await svc.retryTask(taskId);
+        return result.message;
+    }
+}
+class OrchestrationSkipTaskTool extends BuiltinBaseTool {
+    name = 'orchestration_skip_task';
+    description = '跳过 failed/pending 任务（记录 reason），解锁下游。';
+    parameters = TASK_ID_PARAMS;
+    async run(args) {
+        const svc = requireService();
+        const taskId = String(args.task_id ?? '');
+        if (!taskId)
+            return '请提供 task_id';
+        const reason = typeof args.reason === 'string' ? args.reason : 'skipped by director';
+        const result = await svc.skipTask(taskId, reason);
+        return result.message;
+    }
+}
+export function createOrchestrationTools(context) {
+    return [
+        new OrchestrationStartTool(context).toTool(),
+        new OrchestrationAddTaskTool().toTool(),
+        new OrchestrationStatusTool().toTool(),
+        new OrchestrationCompleteTool().toTool(),
+        new OrchestrationRetryTaskTool().toTool(),
+        new OrchestrationSkipTaskTool().toTool(),
+        new OrchestrationPatchStateTool().toTool(),
+    ];
+}
+export const ORCHESTRATION_TOOL_NAMES = [
+    'orchestration_start',
+    'orchestration_add_task',
+    'orchestration_status',
+    'orchestration_complete',
+    'orchestration_retry_task',
+    'orchestration_skip_task',
+    'orchestration_patch_state',
+];
+//# sourceMappingURL=orchestration-tools.js.map

package/lib/builtin/orchestration-tools.js.map

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

package/lib/builtin/run-deferred-task-tool.d.ts

@@ -12,7 +12,7 @@ export interface RunDeferredTaskToolOptions {
 export declare class RunDeferredTaskBuiltinTool extends BuiltinBaseTool {
     private readonly opts;
     readonly name = "run_deferred_task";
-    readonly description = "\u5728\u9694\u79BB\u7684 Worker \u5B50 Agent \u4E2D\u6267\u884C deferred \u5DE5\u5177\u4EFB\u52A1\uFF08github/mcp/\u63D2\u4EF6\u7B49\uFF09\u3002\u8FD9\u662F\u8C03\u7528 deferred \u80FD\u529B\u7684\u552F\u4E00\u5165\u53E3";
+    readonly description = "\u5728\u9694\u79BB\u7684 Worker \u5B50 Agent \u4E2D\u540C\u6B65\u6267\u884C deferred \u5DE5\u5177\u4EFB\u52A1\uFF08github/mcp/\u63D2\u4EF6\u7B49\uFF09\u3002Worker \u5B8C\u6210\u540E\u5C06\u7ED3\u679C\u4F5C\u4E3A\u5DE5\u5177\u8FD4\u56DE\u503C\u4EA4\u8FD8\u4E3B Agent\uFF0C\u7531\u4E3B Agent \u5728\u540C\u4E00\u8F6E\u5BF9\u8BDD\u4E2D\u7EE7\u7EED\u7F16\u6392\u6216\u603B\u7ED3\u56DE\u590D\u7528\u6237\u3002\u8FD9\u662F\u8C03\u7528 deferred \u80FD\u529B\u7684\u552F\u4E00\u5165\u53E3";
     readonly parameters: ToolParametersSchema<Record<string, any>>;
     readonly kind = "meta";
     readonly executionTimeoutMs: number;

package/lib/builtin/run-deferred-task-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"run-deferred-task-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/run-deferred-task-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,4BAA4B,EAAE,oBAa1C,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,0BAA2B,SAAQ,eAAe;IAQjD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,kOAC4D;IAChF,QAAQ,CAAC,UAAU,4CAAgC;IACnD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;gBAEP,IAAI,EAAE,0BAA0B;IAOvD,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAM9D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI,CAEhF"}
+{"version":3,"file":"run-deferred-task-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/run-deferred-task-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,IAAI,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAC5E,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,4BAA4B,EAAE,oBAa1C,CAAC;AAEF,MAAM,WAAW,0BAA0B;IACzC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,SAAS,CAAC,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IACjE,mCAAmC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,qBAAa,0BAA2B,SAAQ,eAAe;IAQjD,OAAO,CAAC,QAAQ,CAAC,IAAI;IAPjC,QAAQ,CAAC,IAAI,uBAAuB;IACpC,QAAQ,CAAC,WAAW,seACwH;IAC5I,QAAQ,CAAC,UAAU,4CAAgC;IACnD,QAAQ,CAAC,IAAI,UAAU;IACvB,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;gBAEP,IAAI,EAAE,0BAA0B;IAOvD,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,UAAU,CAAC;CAM9D;AAED,wBAAgB,yBAAyB,CAAC,IAAI,EAAE,0BAA0B,GAAG,IAAI,CAEhF"}

package/lib/builtin/run-deferred-task-tool.js

@@ -16,7 +16,7 @@ export const RUN_DEFERRED_TASK_PARAMETERS = {
 export class RunDeferredTaskBuiltinTool extends BuiltinBaseTool {
     opts;
     name = 'run_deferred_task';
-    description = '在隔离的 Worker 子 Agent 中执行 deferred 工具任务（github/mcp/插件等）。这是调用 deferred 能力的唯一入口';
+    description = '在隔离的 Worker 子 Agent 中同步执行 deferred 工具任务（github/mcp/插件等）。Worker 完成后将结果作为工具返回值交还主 Agent，由主 Agent 在同一轮对话中继续编排或总结回复用户。这是调用 deferred 能力的唯一入口';
     parameters = RUN_DEFERRED_TASK_PARAMETERS;
     kind = 'meta';
     executionTimeoutMs;

package/lib/builtin/run-deferred-task-tool.js.map

@@ -1 +1 @@
-{"version":3,"file":"run-deferred-task-tool.js","sourceRoot":"","sources":["../../src/builtin/run-deferred-task-tool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,CAAC,MAAM,4BAA4B,GAAyB;IAChE,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iCAAiC;SAC/C;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;SACvD;KACF;IACD,QAAQ,EAAE,CAAC,MAAM,CAAC;CACnB,CAAC;AAQF,MAAM,OAAO,0BAA2B,SAAQ,eAAe;IAQhC;IAPpB,IAAI,GAAG,mBAAmB,CAAC;IAC3B,WAAW,GAClB,6EAA6E,CAAC;IACvE,UAAU,GAAG,4BAA4B,CAAC;IAC1C,IAAI,GAAG,MAAM,CAAC;IACd,kBAAkB,CAAS;IAEpC,YAA6B,IAAgC;QAC3D,KAAK,EAAE,CAAC;QADmB,SAAI,GAAJ,IAAI,CAA4B;QAE3D,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAA6B;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI;YAAE,OAAO,aAAa,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACvF,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,IAAI,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAgC;IACxE,OAAO,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;AACvD,CAAC"}
+{"version":3,"file":"run-deferred-task-tool.js","sourceRoot":"","sources":["../../src/builtin/run-deferred-task-tool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,MAAM,CAAC,MAAM,4BAA4B,GAAyB;IAChE,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,IAAI,EAAE;YACJ,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,iCAAiC;SAC/C;QACD,UAAU,EAAE;YACV,IAAI,EAAE,QAAQ;YACd,WAAW,EAAE,yCAAyC;SACvD;KACF;IACD,QAAQ,EAAE,CAAC,MAAM,CAAC;CACnB,CAAC;AAQF,MAAM,OAAO,0BAA2B,SAAQ,eAAe;IAQhC;IAPpB,IAAI,GAAG,mBAAmB,CAAC;IAC3B,WAAW,GAClB,yIAAyI,CAAC;IACnI,UAAU,GAAG,4BAA4B,CAAC;IAC1C,IAAI,GAAG,MAAM,CAAC;IACd,kBAAkB,CAAS;IAEpC,YAA6B,IAAgC;QAC3D,KAAK,EAAE,CAAC;QADmB,SAAI,GAAJ,IAAI,CAA4B;QAE3D,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,SAAS,IAAI,OAAO,CAAC;QACpD,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,QAAQ,EAAE,UAAU,CAAC,CAAC;QACjD,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,UAAU,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC;IACxE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAA6B;QACrC,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,IAAI,CAAC,IAAI;YAAE,OAAO,aAAa,CAAC;QAChC,MAAM,SAAS,GAAG,IAAI,CAAC,UAAU,IAAI,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;QACvF,OAAO,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,SAAS,IAAI,SAAS,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,MAAM,UAAU,yBAAyB,CAAC,IAAgC;IACxE,OAAO,IAAI,0BAA0B,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC;AACvD,CAAC"}

package/lib/builtin/run-spec-dry-run-tool.d.ts

@@ -0,0 +1,6 @@
+/**
+ * run_spec_dry_run — Planner tool: manifest + vitest dry-run.
+ */
+import type { AgentTool } from '@zhin.js/core';
+export declare function createRunSpecDryRunTool(): AgentTool;
+//# sourceMappingURL=run-spec-dry-run-tool.d.ts.map

package/lib/builtin/run-spec-dry-run-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-spec-dry-run-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/run-spec-dry-run-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAoC,MAAM,eAAe,CAAC;AA6DjF,wBAAgB,uBAAuB,IAAI,SAAS,CAEnD"}

package/lib/builtin/run-spec-dry-run-tool.js

@@ -0,0 +1,51 @@
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+import { getOrchestrationService } from '../orchestrator/orchestration-service.js';
+import { defaultMissionSpecPaths, validateMissionSpecBundle, } from '../orchestrator/mission-spec.js';
+const PARAMS = {
+    type: 'object',
+    properties: {
+        run_id: { type: 'string', description: '编排 run ID' },
+        spec_paths: {
+            type: 'array',
+            items: { type: 'string' },
+            description: '可选；默认 .zhin/missions/<runId>/spec.test.ts',
+        },
+    },
+    required: ['run_id'],
+};
+class RunSpecDryRunTool extends BuiltinBaseTool {
+    name = 'run_spec_dry_run';
+    description = '运行 Validation Spec dry-run（manifest + vitest）。Planner/Spec 阶段使用；通过后写入 spec_dry_run_passed。';
+    parameters = PARAMS;
+    async run(args) {
+        const runId = String(args.run_id ?? '').trim();
+        if (!runId)
+            return '请提供 run_id';
+        const svc = getOrchestrationService();
+        if (!svc)
+            return 'OrchestrationService 未初始化';
+        const run = await svc.repositoryHandle.getRun(runId);
+        if (!run)
+            return `Run ${runId} 不存在`;
+        const defaults = defaultMissionSpecPaths(runId);
+        const specPaths = Array.isArray(args.spec_paths)
+            ? args.spec_paths.map(String)
+            : [defaults.specTestPath, defaults.manifestPath];
+        const result = await validateMissionSpecBundle(runId, specPaths, true);
+        if (!result.ok) {
+            return `Spec dry-run 失败：${result.reason ?? 'unknown'}`;
+        }
+        await svc.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',
+        });
+        return (`Spec dry-run 通过：assertions=${result.assertionCount}\n`
+            + `paths=${specPaths.join(', ')}`);
+    }
+}
+export function createRunSpecDryRunTool() {
+    return new RunSpecDryRunTool().toTool();
+}
+//# sourceMappingURL=run-spec-dry-run-tool.js.map

package/lib/builtin/run-spec-dry-run-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-spec-dry-run-tool.js","sourceRoot":"","sources":["../../src/builtin/run-spec-dry-run-tool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EACL,uBAAuB,EACvB,yBAAyB,GAC1B,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,GAAyB;IACnC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;QACpD,UAAU,EAAE;YACV,IAAI,EAAE,OAAO;YACb,KAAK,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE;YACzB,WAAW,EAAE,2CAA2C;SACzD;KACF;IACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;CACrB,CAAC;AAEF,MAAM,iBAAkB,SAAQ,eAAe;IACpC,IAAI,GAAG,kBAAkB,CAAC;IAC1B,WAAW,GAClB,4FAA4F,CAAC;IACtF,UAAU,GAAG,MAAM,CAAC;IAE7B,KAAK,CAAC,GAAG,CAAC,IAA6B;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,YAAY,CAAC;QAEhC,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO,2BAA2B,CAAC;QAE7C,MAAM,GAAG,GAAG,MAAM,GAAG,CAAC,gBAAgB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACrD,IAAI,CAAC,GAAG;YAAE,OAAO,OAAO,KAAK,MAAM,CAAC;QAEpC,MAAM,QAAQ,GAAG,uBAAuB,CAAC,KAAK,CAAC,CAAC;QAChD,MAAM,SAAS,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YAC9C,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC;YAC7B,CAAC,CAAC,CAAC,QAAQ,CAAC,YAAY,EAAE,QAAQ,CAAC,YAAY,CAAC,CAAC;QAEnD,MAAM,MAAM,GAAG,MAAM,yBAAyB,CAAC,KAAK,EAAE,SAAS,EAAE,IAAI,CAAC,CAAC;QACvE,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,OAAO,mBAAmB,MAAM,CAAC,MAAM,IAAI,SAAS,EAAE,CAAC;QACzD,CAAC;QAED,MAAM,GAAG,CAAC,iBAAiB,CAAC,KAAK,EAAE;YACjC,qBAAqB,EAAE,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YAC5F,eAAe,EAAE,MAAM,CAAC,cAAc;YACtC,mBAAmB,EAAE,IAAI;YACzB,KAAK,EAAE,SAAS;SACjB,CAAC,CAAC;QAEH,OAAO,CACL,8BAA8B,MAAM,CAAC,cAAc,IAAI;cACrD,SAAS,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAClC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,uBAAuB;IACrC,OAAO,IAAI,iBAAiB,EAAE,CAAC,MAAM,EAAe,CAAC;AACvD,CAAC"}

package/lib/builtin/run-validation-spec-tool.d.ts

@@ -0,0 +1,8 @@
+/**
+ * run_validation_spec — Validator-only tool (ADR 0011 D3).
+ */
+import type { AgentTool } from '@zhin.js/core';
+export type { ValidationSpecRunner } from '../orchestrator/mission-spec.js';
+export { defaultValidationSpecRunner, setValidationSpecRunnerForTests, resetValidationSpecRunner, getValidationSpecRunner, } from '../orchestrator/mission-spec.js';
+export declare function createRunValidationSpecTool(): AgentTool;
+//# sourceMappingURL=run-validation-spec-tool.d.ts.map

package/lib/builtin/run-validation-spec-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-validation-spec-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/run-validation-spec-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAoC,MAAM,eAAe,CAAC;AAQjF,YAAY,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAC5E,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AAiDzC,wBAAgB,2BAA2B,IAAI,SAAS,CAEvD"}

package/lib/builtin/run-validation-spec-tool.js

@@ -0,0 +1,44 @@
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+import { getOrchestrationService } from '../orchestrator/orchestration-service.js';
+import { getValidationSpecRunner, parseValidationOutput, } from '../orchestrator/mission-spec.js';
+export { defaultValidationSpecRunner, setValidationSpecRunnerForTests, resetValidationSpecRunner, getValidationSpecRunner, } from '../orchestrator/mission-spec.js';
+const PARAMS = {
+    type: 'object',
+    properties: {
+        run_id: { type: 'string', description: '编排 run ID' },
+    },
+    required: ['run_id'],
+};
+class RunValidationSpecTool extends BuiltinBaseTool {
+    name = 'run_validation_spec';
+    description = '运行 Mission Validation Spec（vitest）。Validator 专用；不得配合 read_file 查看实现。';
+    parameters = PARAMS;
+    async run(args) {
+        const runId = String(args.run_id ?? '').trim();
+        if (!runId)
+            return '请提供 run_id';
+        const svc = getOrchestrationService();
+        if (!svc)
+            return 'OrchestrationService 未初始化';
+        const state = await svc.getMissionState(runId);
+        if (!state || state.validation_spec_paths.length === 0) {
+            return 'Mission State 中无 validation_spec_paths';
+        }
+        const execResult = await getValidationSpecRunner()(state.validation_spec_paths);
+        const validation = parseValidationOutput(execResult.stdout, execResult.stderr, execResult.ok);
+        await svc.patchMissionState(runId, {
+            last_validation: validation,
+            phase: validation.failed === 0 ? 'done' : 'validate',
+        });
+        if (execResult.ok && validation.failed === 0) {
+            return (`Validation Spec 通过：passed=${validation.passed}\n`
+                + execResult.stdout.slice(0, 2000));
+        }
+        return (`Validation Spec 失败：passed=${validation.passed} failed=${validation.failed}\n`
+            + execResult.stderr.slice(0, 2000));
+    }
+}
+export function createRunValidationSpecTool() {
+    return new RunValidationSpecTool().toTool();
+}
+//# sourceMappingURL=run-validation-spec-tool.js.map

package/lib/builtin/run-validation-spec-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"run-validation-spec-tool.js","sourceRoot":"","sources":["../../src/builtin/run-validation-spec-tool.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,EAAE,uBAAuB,EAAE,MAAM,0CAA0C,CAAC;AACnF,OAAO,EACL,uBAAuB,EACvB,qBAAqB,GACtB,MAAM,iCAAiC,CAAC;AAGzC,OAAO,EACL,2BAA2B,EAC3B,+BAA+B,EAC/B,yBAAyB,EACzB,uBAAuB,GACxB,MAAM,iCAAiC,CAAC;AAEzC,MAAM,MAAM,GAAyB;IACnC,IAAI,EAAE,QAAQ;IACd,UAAU,EAAE;QACV,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,WAAW,EAAE;KACrD;IACD,QAAQ,EAAE,CAAC,QAAQ,CAAC;CACrB,CAAC;AAEF,MAAM,qBAAsB,SAAQ,eAAe;IACxC,IAAI,GAAG,qBAAqB,CAAC;IAC7B,WAAW,GAClB,sEAAsE,CAAC;IAChE,UAAU,GAAG,MAAM,CAAC;IAE7B,KAAK,CAAC,GAAG,CAAC,IAA6B;QACrC,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC/C,IAAI,CAAC,KAAK;YAAE,OAAO,YAAY,CAAC;QAEhC,MAAM,GAAG,GAAG,uBAAuB,EAAE,CAAC;QACtC,IAAI,CAAC,GAAG;YAAE,OAAO,2BAA2B,CAAC;QAE7C,MAAM,KAAK,GAAG,MAAM,GAAG,CAAC,eAAe,CAAC,KAAK,CAAC,CAAC;QAC/C,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,qBAAqB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvD,OAAO,wCAAwC,CAAC;QAClD,CAAC;QAED,MAAM,UAAU,GAAG,MAAM,uBAAuB,EAAE,CAAC,KAAK,CAAC,qBAAqB,CAAC,CAAC;QAChF,MAAM,UAAU,GAAG,qBAAqB,CAAC,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,MAAM,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC;QAE9F,MAAM,GAAG,CAAC,iBAAiB,CAAC,KAAK,EAAE;YACjC,eAAe,EAAE,UAAU;YAC3B,KAAK,EAAE,UAAU,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,UAAU;SACrD,CAAC,CAAC;QAEH,IAAI,UAAU,CAAC,EAAE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC7C,OAAO,CACL,6BAA6B,UAAU,CAAC,MAAM,IAAI;kBAChD,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CACnC,CAAC;QACJ,CAAC;QACD,OAAO,CACL,6BAA6B,UAAU,CAAC,MAAM,WAAW,UAAU,CAAC,MAAM,IAAI;cAC5E,UAAU,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,CACnC,CAAC;IACJ,CAAC;CACF;AAED,MAAM,UAAU,2BAA2B;IACzC,OAAO,IAAI,qBAAqB,EAAE,CAAC,MAAM,EAAe,CAAC;AAC3D,CAAC"}

package/lib/builtin/spawn-task-tool.d.ts

@@ -10,7 +10,7 @@ export declare class SpawnTaskBuiltinTool extends BuiltinBaseTool {
     private readonly sessionContext;
     private readonly manager;
     readonly name = "spawn_task";
-    readonly description = "\u5C06\u590D\u6742\u6216\u8017\u65F6\u7684\u4EFB\u52A1\u4EA4\u7ED9\u5B50 agent\u3002\u9ED8\u8BA4\u5F02\u6B65\uFF08\u5B8C\u6210\u540E\u53E6\u6761\u63A8\u9001\uFF09\uFF1B\u9700\u540C\u6B65\u7B49\u5F85\u7ED3\u679C\u65F6\u8BBE wait=true\u3002\u6587\u751F\u56FE\u7528 draw\uFF0C\u8BC6\u56FE\u7528 vision\u3002\u542B\u56FE\u7ED3\u679C\u65E5\u5FD7 preview \u4E3A {image}\uFF1Bwait=true \u65F6\u52FF\u518D\u53D1\u300C\u7A0D\u7B49\u300D\u3002";
+    readonly description = "\u5C06\u590D\u6742\u6216\u8017\u65F6\u7684\u4EFB\u52A1\u4EA4\u7ED9\u5B50 agent\u3002\u9ED8\u8BA4\u5F02\u6B65\uFF08\u5B8C\u6210\u540E\u53E6\u6761\u63A8\u9001\uFF09\uFF1B\u9700\u540C\u6B65\u7B49\u5F85\u7ED3\u679C\u65F6\u8BBE wait=true\u3002\u786C\u7F16\u6392\u6A21\u5F0F\u4E0B\u987B\u4F20 run_id+task_id\u3002\u6587\u751F\u56FE\u7528 draw\uFF0C\u8BC6\u56FE\u7528 vision\u3002\u542B\u56FE\u7ED3\u679C\u65E5\u5FD7 preview \u4E3A {image}\uFF1Bwait=true \u65F6\u52FF\u518D\u53D1\u300C\u7A0D\u7B49\u300D\u3002";
     readonly parameters: ToolParametersSchema<Record<string, any>>;
     constructor(sessionContext: ToolContext, manager: SubagentManager);
     toTool(): Tool;

package/lib/builtin/spawn-task-tool.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"spawn-task-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/spawn-task-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACtE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,qBAAqB,EAAE,oBAsBnC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAS1E;AAED,qBAAa,oBAAqB,SAAQ,eAAe;IAOrD,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,ubACuG;IAC3H,QAAQ,CAAC,UAAU,4CAAyB;gBAGzB,cAAc,EAAE,WAAW,EAC3B,OAAO,EAAE,eAAe;IAO3C,MAAM,IAAI,IAAI;IAMR,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CA6BtF;AAED,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,eAAe,GAAG,SAAS,CAE7F"}
+{"version":3,"file":"spawn-task-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/spawn-task-tool.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,WAAW,EAAE,oBAAoB,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AACpG,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AAKtE,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,eAAO,MAAM,qBAAqB,EAAE,oBAoCnC,CAAC;AAEF,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,WAAW,GAAG,cAAc,CAS1E;AAED,qBAAa,oBAAqB,SAAQ,eAAe;IAOrD,OAAO,CAAC,QAAQ,CAAC,cAAc;IAC/B,OAAO,CAAC,QAAQ,CAAC,OAAO;IAP1B,QAAQ,CAAC,IAAI,gBAAgB;IAC7B,QAAQ,CAAC,WAAW,4fAC+H;IACnJ,QAAQ,CAAC,UAAU,4CAAyB;gBAGzB,cAAc,EAAE,WAAW,EAC3B,OAAO,EAAE,eAAe;IAO3C,MAAM,IAAI,IAAI;IAMR,GAAG,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,QAAQ,CAAC,EAAE,WAAW,GAAG,OAAO,CAAC,UAAU,CAAC;CAqEtF;AAED,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,WAAW,EACpB,OAAO,EAAE,eAAe,GACvB,SAAS,CAEX"}

package/lib/builtin/spawn-task-tool.js

@@ -1,3 +1,6 @@
+import { getAgentDispatcher } from '../orchestrator/agent-dispatcher.js';
+import { getOrchestrationService } from '../orchestrator/orchestration-service.js';
+import { executeRemoteOrchestrationTask } from '../orchestrator/remote-task-executor.js';
 import { BuiltinBaseTool } from './builtin-base-tool.js';
 export const SPAWN_TASK_PARAMETERS = {
     type: 'object',
@@ -18,6 +21,19 @@ export const SPAWN_TASK_PARAMETERS = {
             type: 'boolean',
             description: '为 true 时同步等待子 agent 完成并将结果返回给你',
         },
+        context: {
+            type: 'string',
+            enum: ['fork', 'fresh'],
+            description: '上下文模式：fork 注入主会话最近消息快照；fresh 空上下文。缺省按 *.agent.md 或角色默认',
+        },
+        run_id: {
+            type: 'string',
+            description: '硬编排 run ID（与 task_id 配合使用）',
+        },
+        task_id: {
+            type: 'string',
+            description: '硬编排任务 ID（须先 orchestration_add_task 或 template 预置）',
+        },
     },
     required: ['task'],
 };
@@ -35,7 +51,7 @@ export class SpawnTaskBuiltinTool extends BuiltinBaseTool {
     sessionContext;
     manager;
     name = 'spawn_task';
-    description = '将复杂或耗时的任务交给子 agent。默认异步（完成后另条推送）；需同步等待结果时设 wait=true。文生图用 draw，识图用 vision。含图结果日志 preview 为 {image}；wait=true 时勿再发「稍等」。';
+    description = '将复杂或耗时的任务交给子 agent。默认异步（完成后另条推送）；需同步等待结果时设 wait=true。硬编排模式下须传 run_id+task_id。文生图用 draw，识图用 vision。含图结果日志 preview 为 {image}；wait=true 时勿再发「稍等」。';
     parameters = SPAWN_TASK_PARAMETERS;
     constructor(sessionContext, manager) {
         super();
@@ -56,15 +72,51 @@ export class SpawnTaskBuiltinTool extends BuiltinBaseTool {
         if (typeof task !== 'string' || !task) {
             return '请提供任务描述';
         }
+        const runId = typeof args.run_id === 'string' ? args.run_id.trim() : '';
+        const orchestrationTaskId = typeof args.task_id === 'string' ? args.task_id.trim() : '';
+        if (runId && !orchestrationTaskId) {
+            return 'spawn_task 须同时提供 run_id 与 task_id';
+        }
+        if (orchestrationTaskId) {
+            const dispatcher = getAgentDispatcher();
+            const orch = getOrchestrationService();
+            if (orch && runId) {
+                await dispatcher.hydrateRun(runId);
+                const run = await orch.repositoryHandle.getRun(runId);
+                const { isMissionsTemplate } = await import('../orchestrator/mission-state.js');
+                if (run && isMissionsTemplate(run)) {
+                    return `${run.template} 由 MissionRunner 自动推进，请勿手动 spawn_task`;
+                }
+            }
+            const gate = await dispatcher.canExecuteMissions(orchestrationTaskId);
+            if (!gate.canExecute) {
+                return `无法执行 task ${orchestrationTaskId}：${gate.reason ?? '门禁未通过'}`;
+            }
+            const agentTask = dispatcher.getTask(orchestrationTaskId);
+            if (agentTask?.executorKind === 'remote') {
+                const remoteResult = await executeRemoteOrchestrationTask(orchestrationTaskId);
+                if (args.wait === true) {
+                    return remoteResult.message;
+                }
+                return remoteResult.message;
+            }
+        }
         const origin = originFromToolContext(this.sessionContext);
         const labelStr = typeof label === 'string' ? label : undefined;
         const agentOpt = typeof agentName === 'string' && agentName.trim() ? agentName.trim() : undefined;
+        const contextMode = args.context === 'fork' || args.context === 'fresh' ? args.context : undefined;
+        const orchestrationRole = orchestrationTaskId
+            ? getAgentDispatcher().getTask(orchestrationTaskId)?.role
+            : undefined;
         const opts = {
             task,
             label: labelStr,
             origin,
             agent: agentOpt,
+            role: orchestrationRole,
             notifyContext: this.sessionContext,
+            contextMode,
+            orchestrationTaskId: orchestrationTaskId || undefined,
         };
         if (args.wait === true) {
             const result = await this.manager.spawnSync(opts);

package/lib/builtin/spawn-task-tool.js.map

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

package/lib/builtin-tools.d.ts

@@ -15,6 +15,8 @@ import type { Plugin, ToolInput } from '@zhin.js/core';
 export interface BuiltinToolsOptions {
     /** 插件实例，用于 ask_user 工具创建 Prompt 交互 */
     plugin: Plugin;
+    /** L4 语义记忆：注册 memory_search / memory_upsert */
+    semanticMemory?: boolean;
     /** Max chars for skill instruction extraction (model-size-aware) */
     skillInstructionMaxChars?: number;
     /**

package/lib/builtin-tools.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../src/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAkBvD,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,oEAAoE;IACpE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAC1C;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,EAAE,CAkC5E"}
+{"version":3,"file":"builtin-tools.d.ts","sourceRoot":"","sources":["../src/builtin-tools.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,eAAe,CAAC;AAoBvD,MAAM,WAAW,mBAAmB;IAClC,sCAAsC;IACtC,MAAM,EAAE,MAAM,CAAC;IACf,+CAA+C;IAC/C,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,oEAAoE;IACpE,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC;;OAEG;IACH,wBAAwB,CAAC,EAAE,MAAM,MAAM,EAAE,CAAC;IAC1C;;;OAGG;IACH,eAAe,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,GAAG,SAAS,CAAC;CACxD;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,OAAO,EAAE,mBAAmB,GAAG,SAAS,EAAE,CAuC5E"}

package/lib/builtin-tools.js

@@ -27,6 +27,8 @@ import { createActivateSkillTool } from './builtin/activate-skill-tool.js';
 import { createInstallSkillTool } from './builtin/install-skill-tool.js';
 import { createAskUserTool } from './builtin/ask-user-tool.js';
 import { createAnalyzeMediaTool } from './builtin/analyze-media-tool.js';
+import { createMemorySearchTool } from './builtin/memory-search-tool.js';
+import { createMemoryUpsertTool } from './builtin/memory-upsert-tool.js';
 /**
  * 创建所有内置系统工具
  */
@@ -56,6 +58,10 @@ export function createBuiltinTools(options) {
     }));
     tools.push(createInstallSkillTool());
     tools.push(createAskUserTool(pluginRef));
+    if (options?.semanticMemory) {
+        tools.push(createMemorySearchTool());
+        tools.push(createMemoryUpsertTool());
+    }
     return tools;
 }
 //# sourceMappingURL=builtin-tools.js.map