@zhin.js/agent 0.1.31 → 0.1.32

package/README.md

@@ -18,7 +18,8 @@ Zhin AI Agent 组合层：在 `@zhin.js/core` 的类型与 Provider 之上，提
 - 📦 **上下文与记忆**：`ContextRepository`（`agent_messages`）、`AgentSessionStore`、`ImTranscriptStore`（`im_transcripts` + `chat_history`）；辅助：`ContextManager`、`ConversationMemory`、`UserProfileStore`
 - ⏰ **跟进与定时**：`FollowUpManager`、`PersistentCronEngine`、cron 工具
 - 🔧 **内置工具**：bash、read_file、write_file、ask_user、web_search、`chat_history`（按关键词/最近条数查 `im_transcripts`）等
-- 📐 **会话压缩**：`compactSession`、token 估算、总结与裁剪
+- 📐 **Compaction（ADR 0010）**：生产 `agentLoop` 接线 L1 micro + L2 LLM；IM `/compact`；yaml `ai.agent.compaction`
+- 🌳 **会话树**：`parent_id` + `active_leaf`；IM `/tree`、`/reset`；branch summarization；Console `GET/POST /api/agent/sessions/...`
 - 🪝 **Hook 系统**：`registerAIHook`、`triggerAIHook` 等
 
 ## 依赖关系
@@ -128,7 +129,7 @@ declare module '@zhin.js/core' {
 
 默认**不**注册 `@modelcontextprotocol/server-memory`；设 `ai.memoryMcp: true` 启用（`data/knowledge-graph.jsonl`）。另可通过 `ai.mcpServers`（或 `ctx.agent.addMcp`）注册更多 Server；每次 AI 回合前懒连接，`mcp_{server}_{tool}` 并入 ZhinAgent 工具池。需可选安装 `@modelcontextprotocol/sdk`（peer dependency）。
 
-**记忆**：内置 `read_memory` / `write_memory` 已移除，请使用 `mcp_memory_read_graph`、`mcp_memory_create_entities` 等。工作区 `AGENTS.md` 仍由 bootstrap 注入。
+**记忆**：默认 **文件三层**（`ai.memory` → `data/memory/`）；内置 `read_memory` / `write_memory` 已移除。`ai.memoryMcp: true` 时另注册 MCP 图谱（弃用路径）。工作区 `AGENTS.md` / `TOOLS.md` 由 bootstrap 注入。
 
 ```yaml
 ai:
@@ -234,6 +235,33 @@ ai:
       model: mimo-v2.5-pro
 ```
 
+## Provider 与模型列表
+
+`AIService` 构造时：
+
+1. 按 `ai.providers.<别名>` 实例化 Provider（须配置 `api`，如 `openai-completions`）。
+2. `registerLlmApiFromProviders`：**未写 `models` 的 provider** 在 ApiRegistry 注册为空白名单，由后台 `ModelRegistry.discover()` 填充 `provider.models`；**写了 `models`** 则用 yaml 白名单。
+3. `createZhinAgent` 启动时 `loadCache()` 先恢复上次发现结果，再异步刷新 `/v1/models`。
+
+`agents.<name>.model`（如 `mimo-v2.5-pro`）须在发现列表中，或在中转 API 的 `/v1/models` 响应里出现；无需为每个模型手写 yaml，除非要锁定白名单。
+
+```yaml
+ai:
+  providers:
+    openai-main:
+      api: openai-completions
+      baseUrl: ${OPENAI_BASE_URL}
+      apiKey: ${OPENAI_API_KEY}
+      # models 省略 → 自动 GET /v1/models
+    cloudflare-flash:
+      api: cloudflare-workers-ai
+      models: ["@cf/zai-org/glm-4.7-flash"]  # 显式列表
+  agents:
+    zhin:
+      provider: openai-main
+      model: mimo-v2.5-pro
+```
+
 ## Model harness
 
 按 provider / model 覆盖 Agent 循环默认参数（当前主要为 **`maxIterations`**）。
@@ -262,6 +290,18 @@ ai:
 
 增补内置默认值：在 `model-harness.ts` 增加 `ModelHarnessRow` 并附测试；YAML 只做覆盖，不替代 TS 约定层。
 
+## IM 管理命令
+
+由 `register-management-tools.ts` / `register-introspection-commands.ts` 注册（master / 有权限用户）：
+
+| 类别 | 命令 |
+|------|------|
+| 会话 | `/compact` · `/tree` · `/tree N` · `/reset` |
+| 运维 | `/models` · `/health` |
+| 内省 | `/cmd` · `/bots` · `/bindings` · `/tools` · `/mcp` |
+
+zhin-package CLI：`zhin packages`（`basic/cli`）。详见 [ADR 0010](../../docs/adr/0010-pi-coding-agent-harness-alignment.md)。
+
 ## 开发
 
 ### 项目结构

package/lib/builtin/memory-search-tool.d.ts

@@ -0,0 +1,2 @@
+export declare function createMemorySearchTool(): import("@zhin.js/core").Tool<Record<string, any>>;
+//# sourceMappingURL=memory-search-tool.d.ts.map

package/lib/builtin/memory-search-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-search-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/memory-search-tool.ts"],"names":[],"mappings":"AAoEA,wBAAgB,sBAAsB,sDAErC"}

package/lib/builtin/memory-search-tool.js

@@ -0,0 +1,61 @@
+import { resolveIMSessionIdFromToolContext } from '@zhin.js/ai';
+import { parseMemoryTags } from '@zhin.js/ai';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+import { getMemoryEntryRepository } from '../memory-entry-registry.js';
+const PARAMS = {
+    type: 'object',
+    properties: {
+        query: { type: 'string', description: '检索关键词或短语' },
+        scope: {
+            type: 'string',
+            enum: ['global', 'platform', 'session', 'user'],
+            description: '可选：限定记忆范围',
+        },
+        limit: { type: 'number', description: '最多返回条数（默认 5）' },
+    },
+    required: ['query'],
+};
+function sessionScopeKey(ctx) {
+    return resolveIMSessionIdFromToolContext({
+        platform: ctx.platform || '',
+        botId: ctx.botId || '',
+        scope: ctx.scope,
+        sceneId: ctx.sceneId || '',
+        senderId: ctx.senderId || '',
+    });
+}
+class MemorySearchTool extends BuiltinBaseTool {
+    name = 'memory_search';
+    description = '在语义记忆库中检索与 query 相关的事实条目（memory_entries）。';
+    parameters = PARAMS;
+    keywords = ['memory', 'recall', 'remember', '记忆', '回忆'];
+    async run(args, context) {
+        const repo = getMemoryEntryRepository();
+        if (!repo)
+            return '语义记忆未启用（ai.memory.semantic.enabled）或未初始化数据库。';
+        const query = String(args.query ?? '').trim();
+        if (!query)
+            return '请提供 query';
+        const scope = typeof args.scope === 'string' ? args.scope : undefined;
+        const limit = typeof args.limit === 'number' ? args.limit : 5;
+        const scopeKey = scope === 'session' && context ? sessionScopeKey(context) : undefined;
+        const hits = await repo.search({
+            query,
+            scope: scope,
+            scope_key: scopeKey,
+            limit,
+        });
+        if (!hits.length)
+            return `未找到与 "${query}" 相关的记忆条目。`;
+        const lines = hits.map((e) => {
+            const tags = parseMemoryTags(e.tags);
+            return `- [${e.scope}${e.scope_key ? `:${e.scope_key}` : ''}] ${e.key}=${e.content}`
+                + (tags.length ? ` (tags: ${tags.join(', ')})` : '');
+        });
+        return `找到 ${hits.length} 条记忆：\n${lines.join('\n')}`;
+    }
+}
+export function createMemorySearchTool() {
+    return new MemorySearchTool().toTool();
+}
+//# sourceMappingURL=memory-search-tool.js.map

package/lib/builtin/memory-search-tool.js.map

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

package/lib/builtin/memory-upsert-tool.d.ts

@@ -0,0 +1,2 @@
+export declare function createMemoryUpsertTool(): import("@zhin.js/core").Tool<Record<string, any>>;
+//# sourceMappingURL=memory-upsert-tool.d.ts.map

package/lib/builtin/memory-upsert-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-upsert-tool.d.ts","sourceRoot":"","sources":["../../src/builtin/memory-upsert-tool.ts"],"names":[],"mappings":"AAkFA,wBAAgB,sBAAsB,sDAErC"}

package/lib/builtin/memory-upsert-tool.js

@@ -0,0 +1,75 @@
+import { resolveIMSessionIdFromToolContext } from '@zhin.js/ai';
+import { BuiltinBaseTool } from './builtin-base-tool.js';
+import { getMemoryEntryRepository } from '../memory-entry-registry.js';
+const PARAMS = {
+    type: 'object',
+    properties: {
+        key: { type: 'string', description: '记忆键（如 capability:hard_orchestration_v1）' },
+        content: { type: 'string', description: '记忆内容（简短事实陈述）' },
+        scope: {
+            type: 'string',
+            enum: ['global', 'platform', 'session', 'user'],
+            description: '范围，默认 global',
+        },
+        tags: {
+            type: 'array',
+            items: { type: 'string' },
+            description: '可选标签',
+        },
+        source: { type: 'string', description: '来源说明（如 skill:memory-consolidate）' },
+        confidence: { type: 'number', description: '置信度 0–1，默认 1' },
+    },
+    required: ['key', 'content'],
+};
+function sessionScopeKey(ctx) {
+    return resolveIMSessionIdFromToolContext({
+        platform: ctx.platform || '',
+        botId: ctx.botId || '',
+        scope: ctx.scope,
+        sceneId: ctx.sceneId || '',
+        senderId: ctx.senderId || '',
+    });
+}
+class MemoryUpsertTool extends BuiltinBaseTool {
+    name = 'memory_upsert';
+    description = '写入或更新一条语义记忆（memory_entries），供 memory_search 召回。';
+    parameters = PARAMS;
+    keywords = ['memory', 'remember', 'store', '记忆', '记住'];
+    async run(args, context) {
+        const repo = getMemoryEntryRepository();
+        if (!repo)
+            return '语义记忆未启用（ai.memory.semantic.enabled）或未初始化数据库。';
+        const key = String(args.key ?? '').trim();
+        const content = String(args.content ?? '').trim();
+        if (!key || !content)
+            return '请提供 key 与 content';
+        const scope = (typeof args.scope === 'string' ? args.scope : 'global');
+        let scopeKey = '';
+        if (scope === 'session' && context) {
+            scopeKey = sessionScopeKey(context);
+        }
+        else if (scope === 'platform' && context?.platform) {
+            scopeKey = context.platform;
+        }
+        else if (scope === 'user' && context?.senderId) {
+            scopeKey = context.senderId;
+        }
+        const tags = Array.isArray(args.tags) ? args.tags.map(String) : undefined;
+        const source = typeof args.source === 'string' ? args.source : 'tool:memory_upsert';
+        const confidence = typeof args.confidence === 'number' ? args.confidence : 1;
+        const record = await repo.upsert({
+            scope,
+            scope_key: scopeKey,
+            key,
+            content,
+            tags,
+            source,
+            confidence,
+        });
+        return `已写入记忆 ${record.id}: [${record.scope}] ${record.key}=${record.content}`;
+    }
+}
+export function createMemoryUpsertTool() {
+    return new MemoryUpsertTool().toTool();
+}
+//# sourceMappingURL=memory-upsert-tool.js.map

package/lib/builtin/memory-upsert-tool.js.map

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

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

@@ -0,0 +1,7 @@
+/**
+ * Project director orchestration tools — Agent Mesh hard orchestration v1.
+ */
+import type { AgentTool, ToolContext } from '@zhin.js/core';
+export declare function createOrchestrationTools(context: ToolContext): AgentTool[];
+export declare const ORCHESTRATION_TOOL_NAMES: readonly ["orchestration_start", "orchestration_add_task", "orchestration_status", "orchestration_complete", "orchestration_retry_task", "orchestration_skip_task", "orchestration_patch_state"];
+//# sourceMappingURL=orchestration-tools.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"orchestration-tools.d.ts","sourceRoot":"","sources":["../../src/builtin/orchestration-tools.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,OAAO,KAAK,EAAE,SAAS,EAAE,WAAW,EAAoC,MAAM,eAAe,CAAC;AAyR9F,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,WAAW,GAAG,SAAS,EAAE,CAU1E;AAED,eAAO,MAAM,wBAAwB,kMAQ3B,CAAC"}

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\u5F02\u6B65\u6267\u884C deferred \u5DE5\u5177\u4EFB\u52A1\uFF08github/mcp/\u63D2\u4EF6\u7B49\uFF09\u3002\u7ACB\u5373\u8FD4\u56DE\u59D4\u6D3E\u6001\uFF0C\u5B8C\u6210\u540E\u5355\u72EC\u63A8\u9001\u7ED3\u679C\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,0VACgF;IACpG,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,iGAAiG,CAAC;IAC3F,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"}