@downcity/agent 1.1.408 → 1.1.437

package/bin/types/executor/SessionTurnContext.d.ts

@@ -6,14 +6,18 @@
  * - 分区用于表达领域职责，不引入多套彼此独立的 Context。
  * - 可变状态只能通过行为方法更新，消费者不能直接操作内部数组、lease 或 callback。
  */
-import type { ShellApprovalGateway } from "@downcity/workspace";
-import type { SessionUserMessage } from "../session/SessionMessage.js";
-import type { SessionAssistantResultPart } from "../session/SessionContent.js";
-import type { SessionAssistantOutput } from "./SessionAssistantOutput.js";
-import type { AgentPluginExecutionLease } from "../plugin/PluginRuntime.js";
-import type { PluginExecutionContext } from "../plugin/PluginExecutionContext.js";
-import type { AgentSessionActionCallback, AgentSessionActionEvent, AgentSessionActionRecord } from "../sdk/AgentSessionAction.js";
-import type { SessionInteractionPort } from "../session/SessionInteraction.js";
+import type { RuntimeToolEffect } from "@downcity/type";
+import type { ShellApprovalGateway } from "@downcity/type";
+import type { SessionModelUserContent, SessionUserMessage } from "@downcity/type";
+import type { SessionAgentContent } from "@downcity/type";
+import type { SessionAssistantOutput } from "../../types/executor/SessionAssistantOutput.js";
+import type { SessionHookContext } from "@downcity/type";
+import type { SessionHookScopeRuntime } from "@downcity/type";
+import type { AgentSessionActionCallback, AgentSessionActionEvent, AgentSessionActionRecord } from "../../types/sdk/AgentSessionAction.js";
+import type { SessionInteractionPort } from "@downcity/type";
+import type { SessionOrigin } from "@downcity/type";
+import type { SessionHookContextBlock } from "@downcity/type";
+import type { ModelRequestFailureNotice } from "@downcity/type";
 /**
  * 创建一个 Session Turn 上下文所需的稳定输入。
  *
@@ -22,26 +26,32 @@ import type { SessionInteractionPort } from "../session/SessionInteraction.js";
 export interface SessionTurnContextInit {
     /** 当前执行所属的 Session 标识。 */
     session_id: string;
+    /** 当前执行所属 Session 的完整来源元数据。 */
+    session_origin: SessionOrigin;
     /** 当前执行所属的非空 Turn 标识。 */
     turn_id: string;
     /** 当前 Agent 绑定的项目根目录。 */
     project_root?: string;
     /** 上游取消信号；上下文会把它转发到自身拥有的运行生命周期。 */
     abort_signal?: AbortSignal;
-    /** 在 Step 检查点消费 Session 队列，并返回应并入模型上下文的 User 消息。 */
-    merge_step_input?: () => Promise<SessionUserMessage[]>;
+    /** 在 Step 检查点提交 Session 输入队列；持久化消息由 Composer 重新读取。 */
+    commit_step_input?: () => Promise<void>;
+    /** 将 Executor 产生的内部模型输入持久化为当前 Turn 的 canonical User Message。 */
+    append_internal_user_message?: (parts: readonly SessionModelUserContent[]) => Promise<SessionUserMessage>;
     /** 判断是否仍有等待下一个 Step 消费的 User prompt。 */
     has_pending_step_input?: () => boolean;
-    /** 消费一次 canonical history 重载请求。 */
-    consume_history_reload?: () => boolean;
     /** Executor 写入 canonical Assistant Message 使用的唯一输出端口。 */
     assistant_output?: SessionAssistantOutput;
     /** 当前 Session 执行面创建用户异步交互的端口。 */
     interactions?: SessionInteractionPort;
-    /** 当前 Session 拥有的 unrestricted Shell 审批网关。 */
+    /** 当前 Session 提供的 host Shell 审批网关。 */
     shell_approval_gateway?: ShellApprovalGateway;
+    /** 当前 Turn effects 追加后触发的实时观测回调，宿主可据此广播文件改动摘要。 */
+    on_effects_changed?: (effects: readonly RuntimeToolEffect[]) => void;
     /** 把辅助 Action 持久化并发布为 Session 事件的回调。 */
     publish_action?: AgentSessionActionCallback;
+    /** 把内部模型请求失败交给 Session 边界投影。 */
+    report_model_request_failure?: (notice: ModelRequestFailureNotice) => void;
 }
 /**
  * 一个 Session Turn 的执行上下文中台。
@@ -51,6 +61,8 @@ export interface SessionTurnContext {
     readonly session: {
         /** 当前执行所属的 Session 标识。 */
         readonly session_id: string;
+        /** 当前执行所属 Session 的完整来源元数据。 */
+        readonly origin: SessionOrigin;
         /** 当前执行所属的 Turn 标识。 */
         readonly turn_id: string;
         /** 当前 Agent 绑定的项目根目录。 */
@@ -71,8 +83,10 @@ export interface SessionTurnContext {
         readonly workspace_env?: Readonly<Record<string, string>>;
         /** 当前 Step 已提交生效的 Agent instruction 快照。 */
         readonly agent_systems: readonly string[];
-        /** 当前 Step 持有的 Plugin execution lease；仅供内核执行边界使用。 */
-        readonly plugins?: AgentPluginExecutionLease;
+        /** 当前 Step 持有的稳定 Hook 作用域。 */
+        readonly hooks?: SessionHookScopeRuntime;
+        /** 当前 Turn 首次解析后冻结的 Plugin 动态上下文。 */
+        readonly plugin_context_blocks: readonly SessionHookContextBlock[];
         /** 原子提交当前 Step 使用的 env 与 instruction 快照。 */
         commit(input: {
             /** 即将在当前 Step 生效的 Workspace env。 */
@@ -80,44 +94,53 @@ export interface SessionTurnContext {
             /** 即将在当前 Step 生效的 Agent instruction。 */
             agent_systems: readonly string[];
         }): void;
-        /** 切换当前 Step 的 Plugin lease，并先释放前一个 lease。 */
-        replace_plugins(plugins?: AgentPluginExecutionLease): Promise<void>;
-        /** 释放当前 Step 持有的 Plugin lease。 */
+        /** 切换当前 Step 的 Hook 作用域，并先关闭前一个作用域。 */
+        replace_hooks(hooks?: SessionHookScopeRuntime): Promise<void>;
+        /** 首次调用时解析并冻结动态上下文，后续 Step 与重试复用同一快照。 */
+        resolve_plugin_context_blocks(resolver: () => Promise<readonly SessionHookContextBlock[]>): Promise<readonly SessionHookContextBlock[]>;
+        /** 释放当前 Step 持有的 Plugin Hook 作用域。 */
         release(): Promise<void>;
-        /** 为 Plugin 生成只包含稳定、只读运行快照的新对象。 */
-        plugin_execution_context(call_id?: string): PluginExecutionContext;
+        /** 为 City Plugin 生成只包含稳定、只读运行快照的新对象。 */
+        hook_context(call_id?: string): SessionHookContext;
     };
-    /** 当前运行的动态 User 输入及延迟持久化输入。 */
+    /** 当前运行的动态 User 输入。 */
     readonly input: {
-        /** 在 Step 边界消费运行期注入消息与 Session 队列消息。 */
-        checkpoint(): Promise<SessionUserMessage[]>;
+        /** 登记已经持久化、属于本 Turn 的 canonical User Message。 */
+        observe_user_message(message: SessionUserMessage): void;
+        /** 返回本 Turn 已登记 User Message 的不可变快照。 */
+        user_messages(): readonly SessionUserMessage[];
+        /** 提交输入队列；下一 Step 由 Composer 重新读取 canonical history。 */
+        checkpoint(): Promise<void>;
         /** 判断是否有等待下一个 Step 消费的 Session prompt。 */
         has_pending(): boolean;
-        /** 注入一条只影响当前运行、在下一 Step 生效的 User 消息。 */
-        inject_user_message(message: SessionUserMessage): void;
-        /** 延迟到 Assistant 结果落盘后再持久化一条 User 消息。 */
-        defer_user_message(message: SessionUserMessage): void;
-        /** 返回延迟持久化 User 消息的不可变快照。 */
-        deferred_user_messages(): readonly SessionUserMessage[];
-        /** 消费一次 canonical history 重载请求。 */
-        consume_history_reload(): boolean;
+        /** 持久化一条只供模型消费的内部 canonical User Message。 */
+        append_internal(parts: readonly SessionModelUserContent[]): Promise<SessionUserMessage>;
     };
     /** 当前运行的 Assistant Message 与辅助 Action 输出能力。 */
     readonly output: {
         /** canonical Assistant Message 的唯一写入端口。 */
         readonly assistant?: SessionAssistantOutput;
         /** 把 Action 产生的 Assistant Parts 加入当前 Step 收口队列。 */
-        enqueue_assistant_parts(parts: readonly SessionAssistantResultPart[]): void;
+        enqueue_assistant_parts(parts: readonly SessionAgentContent[]): void;
         /** 消费当前 Step 中等待写入 canonical Assistant Message 的 Parts。 */
-        take_assistant_parts(): SessionAssistantResultPart[];
+        take_assistant_parts(): SessionAgentContent[];
         /** 发布一条不进入 LLM 输入的 Session Action。 */
         publish_action(event: AgentSessionActionEvent): Promise<void>;
+        /** 把当前 Turn 的内部模型请求失败交给 Session 边界。 */
+        report_model_request_failure(notice: ModelRequestFailureNotice): void;
+    };
+    /** 当前 Turn 已经发生、等待在收口检查点投影的 Tool 副作用。 */
+    readonly effects: {
+        /** 按实际发生顺序追加 Tool 副作用。 */
+        append(effects: readonly RuntimeToolEffect[]): void;
+        /** 返回当前 Turn 已收集副作用的不可变快照。 */
+        snapshot(): readonly RuntimeToolEffect[];
     };
     /** 当前 Session 执行面创建用户异步交互的端口。 */
     readonly interactions?: SessionInteractionPort;
     /** 当前运行可使用的 Shell 协作能力。 */
     readonly shell: {
-        /** 当前 Session 拥有的 unrestricted 审批网关。 */
+        /** 当前 Session 提供的 host 执行审批网关。 */
         readonly approval_gateway?: ShellApprovalGateway;
     };
 }

package/bin/types/executor/SessionTurnContext.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"SessionTurnContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionTurnContext.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"SessionTurnContext.d.ts","sourceRoot":"","sources":["../../../src/types/executor/SessionTurnContext.ts"],"names":[],"mappings":"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"}

package/bin/types/group/DispatchStrategy.d.ts

@@ -1,64 +1,90 @@
-/** Group 调度策略：为当前消息上下文生成一组有依赖关系的成员投递节点。 */
-import type { GroupMessage } from "./Group.js";
-import type { Agent } from "../../agent/Agent.js";
-import type { AgentModel } from "../../agent/AgentModel.js";
-/** 一个投递节点内成员的发言方式。 */
-export type DispatchResponseMode = "single" | "parallel";
+/**
+ * Group 调度策略：根据群聊语义与成员画像生成有限的阶段计划。
+ *
+ * 调度器只负责决定谁在什么阶段完成哪项工作，不接触 Agent 的执行能力、完整指令或
+ * Session 生命周期。GroupSession 负责执行计划，并在需要时用真实结果发起下一轮判断。
+ */
+import type { GroupMessage } from "../../types/group/Group.js";
+import type { ModelClient } from "@downcity/type";
 /** 本次调度的触发来源。 */
 export type DispatchTrigger = "user" | "auto";
-/** 调度图中的一个成员投递节点。 */
-export interface DispatchNode {
-    /** 当前调度图内的稳定节点标识。 */
-    readonly node_id: string;
-    /** 当前节点允许接收消息的成员标识。 */
-    readonly member_ids: readonly string[];
-    /** 当前节点只运行首个成员，还是允许全部成员并行运行。 */
-    readonly response_mode: DispatchResponseMode;
-    /** 当前节点依赖的前置节点标识；依赖完成后才能投递。 */
-    readonly depends_on_node_ids: readonly string[];
-    /** 注入成员 AgentSession 的发言约束。 */
+/** 调度器理解当前 Group 所需的最小身份信息。 */
+export interface DispatchGroupProfile {
+    /** 当前 Group 的稳定标识。 */
+    readonly group_id: string;
+    /** 当前 Group 的用户可见名称。 */
+    readonly name: string;
+    /** 当前 Group 的可选协作目标，用于判断任务是否已经完成。 */
+    readonly instruction?: string;
+}
+/** 调度器选择成员所需的最小 Agent 画像。 */
+export interface DispatchMemberProfile {
+    /** 当前成员 Agent 的稳定标识，也是调度协议引用该成员的键。 */
+    readonly agent_id: string;
+    /** 当前成员 Agent 的用户可见名称。 */
+    readonly name: string;
+    /** 当前成员 Agent 的能力描述，用于判断任务与成员是否匹配。 */
+    readonly description: string;
+}
+/** 一个阶段中交给单个成员的独立任务。 */
+export interface DispatchAssignment {
+    /** 接收当前任务的成员 Agent 标识。 */
+    readonly member_id: string;
+    /** 当前成员在本阶段需要直接完成的具体任务。 */
     readonly instruction: string;
 }
-/** 一次调度生成的当前最佳响应图。 */
+/** 调度计划中的一个顺序阶段；阶段内部的任务并行执行。 */
+export interface DispatchStage {
+    /** 当前计划内稳定、可持久化的阶段标识。 */
+    readonly stage_id: string;
+    /** 当前阶段需要并行执行的成员专属任务。 */
+    readonly assignments: readonly DispatchAssignment[];
+}
+/** 一次调度生成的有限阶段计划。 */
 export interface DispatchDecision {
-    /** 当前调度图中的投递节点。 */
-    readonly nodes: readonly DispatchNode[];
-    /** 当前图完成后是否允许唯一的 GroupSession auto dispatch 继续判断。 */
+    /** 调度器对成员选择、阶段安排和停止判断的简要说明。 */
+    readonly reason: string;
+    /** 按顺序执行的阶段；同一阶段内的任务并行执行。 */
+    readonly stages: readonly DispatchStage[];
+    /** 当前计划执行后是否已经可以结束，不再基于结果自动调度。 */
     readonly terminal: boolean;
 }
 /** Group 调度策略协议。 */
 export interface DispatchStrategy {
-    /** 根据触发来源、当前消息、历史和成员关系生成当前最佳响应图。 */
+    /** 根据触发来源、当前消息、历史、新增批次和成员画像生成当前最佳阶段计划。 */
     decide_dispatch(input: {
+        /** 当前 Group 的只读语义画像。 */
+        readonly group: DispatchGroupProfile;
         /** 本次调度由用户消息触发，还是由 GroupSession 自动收口触发。 */
         readonly trigger: DispatchTrigger;
-        /** 当前待调度的 Group 消息；auto dispatch 时为本批新增消息中的最后一条。 */
-        readonly message: GroupMessage;
-        /** 当前 auto dispatch 尚未消费的新增消息。 */
+        /** 当前待判断的 Group 消息；它在新增批次中以当前标记出现。 */
+        readonly current_message: GroupMessage;
+        /** 本批新增消息之前的最近 Group 对话，不包含 pending_messages。 */
+        readonly history: readonly GroupMessage[];
+        /** 当前调度尚未消费的新增 Group 消息批次。 */
         readonly pending_messages: readonly GroupMessage[];
-        /** 当前 Group 已存在的消息历史。 */
-        readonly messages: readonly GroupMessage[];
-        /** 当前 Group 成员快照。 */
-        readonly members: readonly Agent[];
-        /** 当前 Dispatch Session Turn 的取消信号。 */
+        /** 当前 Group 成员的只读语义画像。 */
+        readonly members: readonly DispatchMemberProfile[];
+        /** 当前 GroupSession 调度 Turn 的取消信号。 */
         readonly abort_signal: AbortSignal;
     }): Promise<DispatchDecision> | DispatchDecision;
 }
 /** AI 调度策略的构造参数。 */
 export interface AiDispatchStrategyOptions {
-    /** Group 用于理解群聊意图并生成调度图的模型。 */
-    readonly model?: AgentModel;
+    /** Group 用于理解群聊意图并生成阶段计划的模型。 */
+    readonly model?: ModelClient;
 }
-/** 使用 Group.model 理解群聊意图并通过内部 tool call 生成成员投递决定。 */
+/** 使用 Group.model 理解群聊意图并通过内部 tool call 生成阶段计划。 */
 export declare class AiDispatchStrategy implements DispatchStrategy {
     private readonly model?;
     constructor(options?: AiDispatchStrategyOptions);
     decide_dispatch(input: {
+        readonly group: DispatchGroupProfile;
         readonly trigger: DispatchTrigger;
-        readonly message: GroupMessage;
+        readonly current_message: GroupMessage;
+        readonly history: readonly GroupMessage[];
         readonly pending_messages: readonly GroupMessage[];
-        readonly messages: readonly GroupMessage[];
-        readonly members: readonly Agent[];
+        readonly members: readonly DispatchMemberProfile[];
         readonly abort_signal: AbortSignal;
     }): Promise<DispatchDecision>;
 }

package/bin/types/group/DispatchStrategy.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"DispatchStrategy.d.ts","sourceRoot":"","sources":["../../../src/types/group/DispatchStrategy.ts"],"names":[],"mappings":"AAAA,2CAA2C;AAE3C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAUxD,sBAAsB;AACtB,MAAM,MAAM,oBAAoB,GAAG,QAAQ,GAAG,UAAU,CAAC;AAEzD,iBAAiB;AACjB,MAAM,MAAM,eAAe,GAAG,MAAM,GAAG,MAAM,CAAC;AAE9C,qBAAqB;AACrB,MAAM,WAAW,YAAY;IAC3B,qBAAqB;IACrB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uBAAuB;IACvB,QAAQ,CAAC,UAAU,EAAE,SAAS,MAAM,EAAE,CAAC;IACvC,gCAAgC;IAChC,QAAQ,CAAC,aAAa,EAAE,oBAAoB,CAAC;IAC7C,+BAA+B;IAC/B,QAAQ,CAAC,mBAAmB,EAAE,SAAS,MAAM,EAAE,CAAC;IAChD,+BAA+B;IAC/B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,sBAAsB;AACtB,MAAM,WAAW,gBAAgB;IAC/B,mBAAmB;IACnB,QAAQ,CAAC,KAAK,EAAE,SAAS,YAAY,EAAE,CAAC;IACxC,qDAAqD;IACrD,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,oBAAoB;AACpB,MAAM,WAAW,gBAAgB;IAC/B,oCAAoC;IACpC,eAAe,CAAC,KAAK,EAAE;QACrB,2CAA2C;QAC3C,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;QAClC,oDAAoD;QACpD,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;QAC/B,kCAAkC;QAClC,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;QACnD,yBAAyB;QACzB,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;QAC3C,qBAAqB;QACrB,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;QACnC,sCAAsC;QACtC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;KACpC,GAAG,OAAO,CAAC,gBAAgB,CAAC,GAAG,gBAAgB,CAAC;CAClD;AAED,oBAAoB;AACpB,MAAM,WAAW,yBAAyB;IACxC,+BAA+B;IAC/B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;CAC7B;AAWD,qDAAqD;AACrD,qBAAa,kBAAmB,YAAW,gBAAgB;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAc;gBAEzB,OAAO,GAAE,yBAA8B;IAI7C,eAAe,CAAC,KAAK,EAAE;QAC3B,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;QAClC,QAAQ,CAAC,OAAO,EAAE,YAAY,CAAC;QAC/B,QAAQ,CAAC,gBAAgB,EAAE,SAAS,YAAY,EAAE,CAAC;QACnD,QAAQ,CAAC,QAAQ,EAAE,SAAS,YAAY,EAAE,CAAC;QAC3C,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;QACnC,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;KACpC,GAAG,OAAO,CAAC,gBAAgB,CAAC;CA2C9B"}
+{"version":3,"file":"DispatchStrategy.d.ts","sourceRoot":"","sources":["../../../src/types/group/DispatchStrategy.ts"],"names":[],"mappings":"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"}

package/bin/types/group/DispatchStrategy.js

@@ -1,14 +1,41 @@
-/** Group 调度策略：为当前消息上下文生成一组有依赖关系的成员投递节点。 */
+/**
+ * Group 调度策略：根据群聊语义与成员画像生成有限的阶段计划。
+ *
+ * 调度器只负责决定谁在什么阶段完成哪项工作，不接触 Agent 的执行能力、完整指令或
+ * Session 生命周期。GroupSession 负责执行计划，并在需要时用真实结果发起下一轮判断。
+ */
 import { generate_model } from "../../executor/model/ModelGenerate.js";
 import { z } from "zod";
-/** AI 调度工具的最小输入协议；外层阶段串行，阶段内成员并行。 */
+/** AI 调度工具的最小输入协议；阶段串行，阶段内 assignment 并行。 */
 const dispatch_group_input_schema = z.object({
-    steps: z.array(z.array(z.string().trim().min(1)).min(1).max(16)).max(16),
-    /** 当前响应图完成后是否交给唯一的 auto dispatch 继续判断。 */
+    /** 解释成员选择、阶段安排以及停止或继续的语义依据。 */
+    reason: z.string().trim().min(1).max(2_000),
+    /** 当前已经可以确定的有限工作阶段。 */
+    stages: z.array(z.object({
+        /** 当前阶段内可以独立并行的成员任务。 */
+        assignments: z.array(z.object({
+            /** 接收任务的真实成员 Agent 标识。 */
+            member_id: z.string().trim().min(1),
+            /** 该成员需要直接完成的具体任务。 */
+            instruction: z.string().trim().min(1).max(4_000),
+        })).min(1).max(16),
+    })).max(16),
+    /** 当前阶段执行完即可结束，还是必须依据实际结果再判断一次。 */
     next: z.enum(["stop", "continue"]),
 });
 const max_dispatch_model_steps = 3;
-/** 使用 Group.model 理解群聊意图并通过内部 tool call 生成成员投递决定。 */
+const dispatch_system_prompt = [
+    "你是 Group 的语义调度器，只能调用一次 dispatch_group，不得直接回答用户问题。",
+    "你的职责是用最少的必要成员和阶段满足用户意图，并在语义上已经完成时立即停止。",
+    "请根据 Group 目标、成员名称和能力描述选择成员；只能选择给出的真实 member_id。",
+    "普通任务默认只交给一个最匹配的成员。只有任务可独立并行，或用户明确要求多人分别回答时，才在同一阶段安排多个 assignment。",
+    "每个 assignment 必须写成员专属、可以直接执行的具体任务，不能只写‘回复用户’或重复成员身份。",
+    "stages 按顺序执行，同一 stage 内的 assignments 并行执行。已知的连续步骤应一次规划进多个 stages。",
+    "next=continue 仅用于下一步选择必须依赖本轮成员的实际输出；它不是邀请更多成员继续讨论。",
+    "若当前对话已经满足用户意图，返回 stages=[]、next=stop。若所列 stages 执行后即可满足意图，也使用 next=stop。",
+    "不得因为尚有其他成员、礼貌附和、重复总结、非必要 review 或维持对话而继续。",
+].join("\n");
+/** 使用 Group.model 理解群聊意图并通过内部 tool call 生成阶段计划。 */
 export class AiDispatchStrategy {
     model;
     constructor(options = {}) {
@@ -20,7 +47,7 @@ export class AiDispatchStrategy {
         }
         try {
             const messages = [
-                { role: "system", content: [{ type: "text", text: "你是群聊消息调度器。你只能调用 dispatch_group，不回答用户问题。普通任务默认只选择一个最合适的成员；只有用户明确要求多人分别回答，或确实存在并行的独立工作时，才把多个成员放在同一阶段。外层 steps 阶段按顺序执行，后一个阶段等待前一个阶段完成。只有真实存在的成员才能被选择。" }] },
+                { role: "system", content: [{ type: "text", text: dispatch_system_prompt }] },
                 { role: "user", content: [{ type: "text", text: build_dispatch_prompt(input) }] },
             ];
             let protocol_error = "Group dispatch model did not call dispatch_group";
@@ -29,13 +56,16 @@ export class AiDispatchStrategy {
                     messages,
                     tools: [{
                             name: "dispatch_group",
-                            description: "提交当前 Group 的成员投递路径。只调用一次；不要输出普通文本。没有成员需要回复时使用空 steps 和 next=stop。",
+                            description: "提交当前 Group 的有限阶段计划。已经完成时使用空 stages 和 next=stop；只有后续选择依赖实际结果时才使用 next=continue。",
                             input_schema: z.toJSONSchema(dispatch_group_input_schema),
                         }],
                     tool_choice: { type: "tool", tool_name: "dispatch_group" },
-                    max_output_tokens: 600,
+                    max_output_tokens: 1_200,
                     reasoning: { enabled: false },
-                }, input.abort_signal);
+                }, {
+                    request_kind: "group_dispatch",
+                    signal: input.abort_signal,
+                });
                 const dispatch_call = result.tool_calls.length === 1 && result.tool_calls[0]?.tool_name === "dispatch_group"
                     ? result.tool_calls[0]
                     : undefined;
@@ -91,50 +121,64 @@ function append_dispatch_retry_messages(messages, text, tool_calls, error) {
             }],
     });
 }
-/** 为 AI 调度器构造稳定、有限长度的群聊上下文。 */
+/** 为 AI 调度器构造稳定、有限且不重复当前消息的群聊上下文。 */
 function build_dispatch_prompt(input) {
-    const members = input.members.map((member) => `- ${member.id}`).join("\n");
-    const history = input.messages.slice(-20).map((message) => `${message.sender_type}:${message.sender_id}: ${message.text}`).join("\n");
+    const members = input.members.map((member) => [
+        `- ID: ${member.agent_id}`,
+        `  名称: ${member.name}`,
+        `  能力描述: ${member.description || "（未提供）"}`,
+    ].join("\n")).join("\n");
+    const history = input.history.slice(-20).map(format_group_message).join("\n");
+    const pending_messages = input.pending_messages.map((message) => (`${message.id === input.current_message.id ? "[当前] " : ""}${format_group_message(message)}`)).join("\n");
     return [
-        "成员：",
+        "Group:",
+        `- ID: ${input.group.group_id}`,
+        `- 名称: ${input.group.name}`,
+        `- 目标: ${input.group.instruction || "（未提供）"}`,
+        "成员:",
         members,
-        "最近群聊：",
+        "此前对话:",
         history || "（无）",
-        "本次新增消息：",
-        input.pending_messages.map((message) => `${message.sender_type}:${message.sender_id}: ${message.text}`).join("\n") || "（无）",
-        `调度触发来源：${input.trigger}`,
-        "当前消息：",
-        `${input.message.sender_type}:${input.message.sender_id}: ${input.message.text}`,
-        "请调用 dispatch_group，输入 steps 和 next。steps 是二维数组：外层阶段按顺序执行，同一阶段数组内的成员并行执行；没有成员需要回复时使用空 steps 和 next=stop。不要输出普通文本。",
+        "本批新增消息:",
+        pending_messages || "（无）",
+        `触发方式: ${input.trigger}`,
+        "请调用 dispatch_group，提交 reason、stages 和 next，不要输出普通文本。",
     ].join("\n");
 }
-/** 将 AI tool call 编译为内部执行图，并确保只引用真实成员。 */
+/** 将 GroupMessage 格式化为调度器可读、稳定的单行文本。 */
+function format_group_message(message) {
+    return `${message.sender_type}:${message.sender_id}: ${message.text}`;
+}
+/** 将 AI tool call 校验并编译为内部阶段计划。 */
 function normalize_dispatch_tool_input(value, members) {
     const parsed = dispatch_group_input_schema.parse(value);
-    const valid_ids = new Set(members.map((member) => member.id));
-    const nodes = parsed.steps.map((member_ids, index) => {
-        const unique_member_ids = [...new Set(member_ids)];
-        if (unique_member_ids.length !== member_ids.length) {
-            throw new Error(`Group dispatch selected member more than once in step ${index}`);
-        }
-        for (const member_id of unique_member_ids) {
-            if (!valid_ids.has(member_id)) {
-                throw new Error(`Group dispatch selected unknown member: ${member_id}`);
+    const valid_ids = new Set(members.map((member) => member.agent_id));
+    const stages = parsed.stages.map((stage, stage_index) => {
+        const selected_member_ids = new Set();
+        const assignments = stage.assignments.map((assignment) => {
+            if (!valid_ids.has(assignment.member_id)) {
+                throw new Error(`Group dispatch selected unknown member: ${assignment.member_id}`);
             }
-        }
+            if (selected_member_ids.has(assignment.member_id)) {
+                throw new Error(`Group dispatch selected member more than once in stage ${stage_index}`);
+            }
+            selected_member_ids.add(assignment.member_id);
+            return {
+                member_id: assignment.member_id,
+                instruction: assignment.instruction,
+            };
+        });
         return {
-            node_id: `step-${index}`,
-            member_ids: unique_member_ids,
-            response_mode: unique_member_ids.length > 1 ? "parallel" : "single",
-            depends_on_node_ids: index === 0 ? [] : [`step-${index - 1}`],
-            instruction: "你已被 Group 调度选中，请直接针对当前消息给出回复，并且只代表自己发言。",
+            stage_id: `stage-${stage_index}`,
+            assignments,
         };
     });
-    if (nodes.length === 0 && parsed.next === "continue") {
-        throw new Error("Group dispatch cannot continue without any member step");
+    if (stages.length === 0 && parsed.next === "continue") {
+        throw new Error("Group dispatch cannot continue without any stage");
     }
     return {
-        nodes,
+        reason: parsed.reason,
+        stages,
         terminal: parsed.next === "stop",
     };
 }

package/bin/types/group/DispatchStrategy.js.map

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

package/bin/types/group/Group.d.ts

@@ -1,8 +1,8 @@
 /** Group 的公开领域类型：Group 是持续存在的群聊主体。 */
 import type { Agent } from "../../agent/Agent.js";
-import type { AgentModel } from "../../agent/AgentModel.js";
-import type { DispatchStrategy } from "./DispatchStrategy.js";
-import type { GroupSessions } from "./GroupSession.js";
+import type { ModelClient } from "@downcity/type";
+import type { DispatchStrategy } from "../../types/group/DispatchStrategy.js";
+import type { GroupSessions } from "../../types/group/GroupSession.js";
 /** 创建 Group 的参数。 */
 export interface GroupOptions {
     /** Group 的稳定标识。 */
@@ -12,7 +12,7 @@ export interface GroupOptions {
     /** Group 的可选协作说明。 */
     readonly instruction?: string;
     /** Group 用于理解群聊意图并选择投递成员的模型。 */
-    readonly model?: AgentModel;
+    readonly model?: ModelClient;
     /** Group 成员列表。 */
     readonly members: readonly Agent[];
     /** Group 的消息调度策略；省略时使用 Group.model 驱动的 AI 调度。 */
@@ -36,8 +36,8 @@ export interface GroupMessage {
     readonly turn_id?: string;
     /** 可选的自动调度运行标识；自动调度产生的消息使用此标识。 */
     readonly dispatch_id?: string;
-    /** 可选的响应图节点标识。 */
-    readonly dispatch_node_id?: string;
+    /** 可选的调度计划阶段标识。 */
+    readonly dispatch_stage_id?: string;
     /** 创建时间的 Unix 毫秒时间戳。 */
     readonly created_at: number;
 }
@@ -49,8 +49,8 @@ export interface GroupContract {
     readonly name: string;
     /** Group 的协作说明。 */
     readonly instruction?: string;
-    /** Group 用于理解群聊意图并生成成员投递图的模型；未提供时首次调度会失败。 */
-    readonly model?: AgentModel;
+    /** Group 用于理解群聊意图并生成成员阶段计划的模型；未提供时首次调度会失败。 */
+    readonly model?: ModelClient;
     /** Group 成员快照。 */
     readonly members: readonly Agent[];
     /** Group 使用的消息调度策略。 */

package/bin/types/group/Group.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../../src/types/group/Group.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,oBAAoB;AACpB,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CAC/C;AAED,sBAAsB;AACtB,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,eAAe;IACf,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClD,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB;IAClB,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,wBAAwB;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,6CAA6C;IAC7C,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,uBAAuB;IACvB,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAC7C,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC"}
+{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../../src/types/group/Group.ts"],"names":[],"mappings":"AAAA,sCAAsC;AAEtC,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAClD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAEnE,oBAAoB;AACpB,MAAM,WAAW,YAAY;IAC3B,mBAAmB;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,qBAAqB;IACrB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,gCAAgC;IAChC,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,iDAAiD;IACjD,QAAQ,CAAC,iBAAiB,CAAC,EAAE,gBAAgB,CAAC;CAC/C;AAED,sBAAsB;AACtB,MAAM,WAAW,YAAY;IAC3B,cAAc;IACd,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,yCAAyC;IACzC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,eAAe;IACf,QAAQ,CAAC,WAAW,EAAE,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAClD,YAAY;IACZ,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,kBAAkB;IAClB,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAC3B,2CAA2C;IAC3C,QAAQ,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IAC1B,kCAAkC;IAClC,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,mBAAmB;IACnB,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,wBAAwB;IACxB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED,kBAAkB;AAClB,MAAM,WAAW,aAAa;IAC5B,mBAAmB;IACnB,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,mBAAmB;IACnB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,mBAAmB;IACnB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,uBAAuB;IACvB,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAC7C,6BAA6B;IAC7B,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;CAClC"}