@downcity/agent 1.1.401 → 1.1.408

package/bin/workspace/store/LocalGroupDispatchSessionDataStore.js

@@ -0,0 +1,102 @@
+/**
+ * LocalGroupDispatchSessionDataStore：Group Dispatch Session 的追加式 Turn 日志。
+ *
+ * 每次状态迁移都追加完整快照；读取时按 dispatch_id 选择最后一条记录，因此中断前
+ * 已提交的状态不会被覆盖，文件尾部的非完整写入也可以安全修复。
+ */
+import path from "node:path";
+const dispatch_turn_statuses = new Set([
+    "queued",
+    "running",
+    "completed",
+    "failed",
+    "stopped",
+]);
+/** 基于 GroupSession 私有目录的 Dispatch Session Store。 */
+export class LocalGroupDispatchSessionDataStore {
+    files;
+    dispatch_root_path;
+    turns_file_path;
+    transaction_lock_path;
+    constructor(options) {
+        this.files = options.files;
+        this.dispatch_root_path = path.join(options.session_root_path, "dispatch");
+        this.turns_file_path = path.join(this.dispatch_root_path, "turns.jsonl");
+        this.transaction_lock_path = path.join(this.dispatch_root_path, ".lock");
+    }
+    /** 读取每个调度 Turn 最后一次成功提交的状态。 */
+    async list_turns() {
+        if (!(await this.files.path_exists(this.turns_file_path)))
+            return [];
+        await this.files.ensure_directory(this.dispatch_root_path);
+        return await this.files.with_file_lock(this.transaction_lock_path, async () => {
+            const records = await this.read_records(true);
+            const turns_by_id = new Map();
+            for (const record of records) {
+                turns_by_id.delete(record.dispatch_id);
+                turns_by_id.set(record.dispatch_id, record);
+            }
+            return [...turns_by_id.values()];
+        });
+    }
+    /** 追加一个完整状态快照，状态提交与其它调度 Turn 串行。 */
+    async append_turn(turn) {
+        assert_dispatch_turn(turn);
+        await this.files.ensure_directory(this.dispatch_root_path);
+        await this.files.with_file_lock(this.transaction_lock_path, async () => {
+            await this.files.append_file(this.turns_file_path, `${JSON.stringify(turn)}\n`);
+        });
+    }
+    /** 读取状态日志；只允许修复进程中断产生的最后一条残缺记录。 */
+    async read_records(repair_tail) {
+        const content = (await this.files.read_file(this.turns_file_path)).toString("utf8");
+        const lines = content.split("\n");
+        const records = [];
+        for (let line_index = 0; line_index < lines.length; line_index += 1) {
+            const line = lines[line_index];
+            if (!line.trim())
+                continue;
+            try {
+                const record = JSON.parse(line);
+                assert_dispatch_turn(record);
+                records.push(record);
+            }
+            catch (error) {
+                const is_tail = lines.slice(line_index + 1).every((item) => !item.trim());
+                if (!repair_tail || !is_tail)
+                    throw error;
+                const repaired = records.map((record) => JSON.stringify(record)).join("\n");
+                await this.files.write_file_atomically(this.turns_file_path, repaired ? `${repaired}\n` : "");
+                break;
+            }
+        }
+        return records;
+    }
+}
+/** 防止损坏的持久化记录进入 Dispatch Session 恢复流程。 */
+function assert_dispatch_turn(value) {
+    if (!value || typeof value !== "object")
+        throw new Error("Invalid Group dispatch turn record");
+    if (typeof value.dispatch_id !== "string" || !value.dispatch_id.trim()) {
+        throw new Error("Invalid Group dispatch turn id");
+    }
+    if (value.trigger !== "user" && value.trigger !== "auto") {
+        throw new Error(`Invalid Group dispatch trigger: ${String(value.trigger)}`);
+    }
+    if (typeof value.message_id !== "string" || !value.message_id.trim()) {
+        throw new Error(`Invalid Group dispatch message id: ${value.dispatch_id}`);
+    }
+    if (!Array.isArray(value.pending_message_ids) || value.pending_message_ids.some((item) => typeof item !== "string" || !item.trim())) {
+        throw new Error(`Invalid Group dispatch pending messages: ${value.dispatch_id}`);
+    }
+    if (!dispatch_turn_statuses.has(value.status)) {
+        throw new Error(`Invalid Group dispatch status: ${String(value.status)}`);
+    }
+    if (!Number.isFinite(value.created_at) || !Number.isFinite(value.updated_at)) {
+        throw new Error(`Invalid Group dispatch timestamps: ${value.dispatch_id}`);
+    }
+    if (value.status === "completed" && !value.decision) {
+        throw new Error(`Completed Group dispatch is missing its decision: ${value.dispatch_id}`);
+    }
+}
+//# sourceMappingURL=LocalGroupDispatchSessionDataStore.js.map

package/bin/workspace/store/LocalGroupDispatchSessionDataStore.js.map

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

package/bin/workspace/store/LocalGroupSessionDataStore.d.ts

@@ -1,10 +1,12 @@
 /** LocalGroupSessionDataStore：GroupSession 的 metadata 与消息 JSONL 存储。 */
 import type { FileSystem } from "@downcity/workspace";
 import type { GroupMessage } from "../../types/group/Group.js";
+import type { GroupDispatchSessionDataStore } from "../../types/group/GroupDispatchSession.js";
 import type { GroupSessionDataStore, GroupSessionHistoryMeta } from "../../types/group/GroupSessionStore.js";
 /** 单个 GroupSession 的本地文件存储。 */
 export declare class LocalGroupSessionDataStore implements GroupSessionDataStore {
     readonly session_id: string;
+    readonly dispatch_session: GroupDispatchSessionDataStore;
     private readonly files;
     private readonly group_id;
     private readonly session_root_path;

package/bin/workspace/store/LocalGroupSessionDataStore.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"LocalGroupSessionDataStore.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/LocalGroupSessionDataStore.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAGvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EAExB,MAAM,oCAAoC,CAAC;AAE5C,+BAA+B;AAC/B,qBAAa,0BAA2B,YAAW,qBAAqB;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAEnC,OAAO,EAAE;QACnB,kCAAkC;QAClC,KAAK,EAAE,UAAU,CAAC;QAClB,iCAAiC;QACjC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,0BAA0B;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,mBAAmB;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAeD,uCAAuC;IACjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,kBAAkB;IACZ,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI9C,0BAA0B;IACpB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1D,qBAAqB;IACf,aAAa,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAOvD,+BAA+B;YACjB,sBAAsB;IAkCpC,uBAAuB;IACjB,cAAc,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE,+BAA+B;YACjB,uBAAuB;IAWrC,wCAAwC;IAClC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAehG,8BAA8B;YAChB,wBAAwB;IActC,kCAAkC;YACpB,aAAa;IA0B3B,OAAO,CAAC,uBAAuB;CAWhC"}
+{"version":3,"file":"LocalGroupSessionDataStore.d.ts","sourceRoot":"","sources":["../../../src/workspace/store/LocalGroupSessionDataStore.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAGvE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,qBAAqB,CAAC;AACtD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC3D,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,uCAAuC,CAAC;AAE3F,OAAO,KAAK,EACV,qBAAqB,EACrB,uBAAuB,EAExB,MAAM,oCAAoC,CAAC;AAE5C,+BAA+B;AAC/B,qBAAa,0BAA2B,YAAW,qBAAqB;IACtE,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,gBAAgB,EAAE,6BAA6B,CAAC;IACzD,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAa;IACnC,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAS;IAClC,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAS;IAC3C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,kBAAkB,CAAS;IAC5C,OAAO,CAAC,QAAQ,CAAC,qBAAqB,CAAS;gBAEnC,OAAO,EAAE;QACnB,kCAAkC;QAClC,KAAK,EAAE,UAAU,CAAC;QAClB,iCAAiC;QACjC,iBAAiB,EAAE,MAAM,CAAC;QAC1B,0BAA0B;QAC1B,UAAU,EAAE,MAAM,CAAC;QACnB,mBAAmB;QACnB,QAAQ,EAAE,MAAM,CAAC;KAClB;IAmBD,uCAAuC;IACjC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAUjC,kBAAkB;IACZ,aAAa,IAAI,OAAO,CAAC,YAAY,EAAE,CAAC;IAI9C,0BAA0B;IACpB,cAAc,CAAC,OAAO,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAiB1D,qBAAqB;IACf,aAAa,IAAI,OAAO,CAAC,uBAAuB,CAAC;IAUvD,+BAA+B;YACjB,sBAAsB;IA0CpC,uBAAuB;IACjB,cAAc,CAAC,QAAQ,EAAE,uBAAuB,GAAG,OAAO,CAAC,IAAI,CAAC;IAMtE,+BAA+B;YACjB,uBAAuB;IAWrC,wCAAwC;IAClC,eAAe,CAAC,KAAK,EAAE,OAAO,CAAC,uBAAuB,CAAC,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAehG,8BAA8B;YAChB,wBAAwB;IActC,kCAAkC;YACpB,aAAa;IA0B3B,OAAO,CAAC,uBAAuB;CAWhC"}

package/bin/workspace/store/LocalGroupSessionDataStore.js

@@ -1,8 +1,10 @@
 /** LocalGroupSessionDataStore：GroupSession 的 metadata 与消息 JSONL 存储。 */
 import path from "node:path";
+import { LocalGroupDispatchSessionDataStore } from "./LocalGroupDispatchSessionDataStore.js";
 /** 单个 GroupSession 的本地文件存储。 */
 export class LocalGroupSessionDataStore {
     session_id;
+    dispatch_session;
     files;
     group_id;
     session_root_path;
@@ -16,6 +18,10 @@ export class LocalGroupSessionDataStore {
         if (!this.session_id)
             throw new Error("GroupSession store requires a non-empty session_id");
         this.session_root_path = path.join(path.resolve(options.storage_root_path), "sessions", encodeURIComponent(this.session_id));
+        this.dispatch_session = new LocalGroupDispatchSessionDataStore({
+            files: this.files,
+            session_root_path: this.session_root_path,
+        });
         this.metadata_file_path = path.join(this.session_root_path, "meta.json");
         this.messages_file_path = path.join(this.session_root_path, "messages.jsonl");
         this.transaction_lock_path = path.join(this.session_root_path, ".lock");
@@ -56,7 +62,7 @@ export class LocalGroupSessionDataStore {
         if (!(await this.files.path_exists(this.metadata_file_path))) {
             return this.create_initial_metadata();
         }
-        return await this.read_metadata_unlocked();
+        return await this.files.with_file_lock(this.transaction_lock_path, async () => await this.read_metadata_unlocked());
     }
     /** 在调用方已经持有事务锁时读取 metadata。 */
     async read_metadata_unlocked() {
@@ -64,14 +70,17 @@ export class LocalGroupSessionDataStore {
             return this.create_initial_metadata();
         }
         const raw = JSON.parse((await this.files.read_file(this.metadata_file_path)).toString("utf8"));
+        if (raw.v !== 1 && raw.v !== 2) {
+            throw new Error(`Unsupported GroupSession metadata version: ${String(raw.v)}`);
+        }
         if (raw.session_id !== this.session_id) {
             throw new Error(`Invalid GroupSession ownership metadata: ${this.session_id}`);
         }
         if (raw.group_id && raw.group_id !== this.group_id) {
             throw new Error(`GroupSession "${this.session_id}" belongs to another Group`);
         }
-        return {
-            v: 1,
+        const metadata = {
+            v: 2,
             session_id: this.session_id,
             group_id: String(raw.group_id || this.group_id),
             ...(typeof raw.workspace_id === "string" && raw.workspace_id.trim() ? { workspace_id: raw.workspace_id.trim() } : {}),
@@ -83,12 +92,15 @@ export class LocalGroupSessionDataStore {
                 ? { member_session_ids: normalize_member_session_ids(raw.member_session_ids) }
                 : {}),
             ...(Array.isArray(raw.pending_turns)
-                ? { pending_turns: normalize_pending_turns(raw.pending_turns) }
+                ? { pending_turns: normalize_pending_turns(raw.pending_turns, raw.v === 1 ? "auto" : undefined) }
                 : {}),
             ...(Array.isArray(raw.auto_frontier_message_ids)
                 ? { auto_frontier_message_ids: normalize_message_ids(raw.auto_frontier_message_ids) }
                 : {}),
         };
+        if (raw.v === 1)
+            await this.write_metadata_unlocked(metadata);
+        return metadata;
     }
     /** 原子写入当前 metadata。 */
     async write_metadata(metadata) {
@@ -113,7 +125,7 @@ export class LocalGroupSessionDataStore {
                 ...patch,
                 session_id: this.session_id,
                 group_id: this.group_id,
-                v: 1,
+                v: 2,
             };
             await this.write_metadata_unlocked(next_metadata);
             return next_metadata;
@@ -166,7 +178,7 @@ export class LocalGroupSessionDataStore {
     create_initial_metadata() {
         const created_at = Date.now();
         return {
-            v: 1,
+            v: 2,
             session_id: this.session_id,
             group_id: this.group_id,
             created_at,
@@ -178,7 +190,7 @@ export class LocalGroupSessionDataStore {
 function normalize_member_session_ids(input) {
     return Object.fromEntries(Object.entries(input).filter(([agent_id, session_id]) => Boolean(agent_id.trim()) && typeof session_id === "string" && session_id.trim()));
 }
-function normalize_pending_turns(input) {
+function normalize_pending_turns(input, default_dispatch_stage) {
     return input.flatMap((item) => {
         if (!item || typeof item !== "object")
             return [];
@@ -188,7 +200,12 @@ function normalize_pending_turns(input) {
         const context_message_ids = Array.isArray(candidate.context_message_ids)
             ? normalize_message_ids(candidate.context_message_ids)
             : [];
-        return turn_id && root_message_id ? [{ turn_id, root_message_id, context_message_ids }] : [];
+        const dispatch_stage = candidate.dispatch_stage === "user" || candidate.dispatch_stage === "auto"
+            ? candidate.dispatch_stage
+            : default_dispatch_stage;
+        return turn_id && root_message_id && dispatch_stage
+            ? [{ turn_id, root_message_id, context_message_ids, dispatch_stage }]
+            : [];
     });
 }
 function normalize_message_ids(input) {

package/bin/workspace/store/LocalGroupSessionDataStore.js.map

@@ -1 +1 @@
-{"version":3,"file":"LocalGroupSessionDataStore.js","sourceRoot":"","sources":["../../../src/workspace/store/LocalGroupSessionDataStore.ts"],"names":[],"mappings":"AAAA,uEAAuE;AAEvE,OAAO,IAAI,MAAM,WAAW,CAAC;AAS7B,+BAA+B;AAC/B,MAAM,OAAO,0BAA0B;IAC5B,UAAU,CAAS;IACX,KAAK,CAAa;IAClB,QAAQ,CAAS;IACjB,iBAAiB,CAAS;IAC1B,kBAAkB,CAAS;IAC3B,kBAAkB,CAAS;IAC3B,qBAAqB,CAAS;IAE/C,YAAY,OASX;QACC,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,QAAQ,GAAG,OAAO,CAAC,QAAQ,CAAC;QACjC,IAAI,CAAC,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,UAAU,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1D,IAAI,CAAC,IAAI,CAAC,UAAU;YAAE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;QAC5F,IAAI,CAAC,iBAAiB,GAAG,IAAI,CAAC,IAAI,CAChC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,iBAAiB,CAAC,EACvC,UAAU,EACV,kBAAkB,CAAC,IAAI,CAAC,UAAU,CAAC,CACpC,CAAC;QACF,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,WAAW,CAAC,CAAC;QACzE,IAAI,CAAC,kBAAkB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAAC;QAC9E,IAAI,CAAC,qBAAqB,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,OAAO,CAAC,CAAC;IAC1E,CAAC;IAED,uCAAuC;IACvC,KAAK,CAAC,UAAU;QACd,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;YACrE,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;gBAC7D,MAAM,IAAI,CAAC,uBAAuB,CAAC,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC;YACrE,CAAC;YACD,MAAM,IAAI,CAAC,wBAAwB,EAAE,CAAC;QACxC,CAAC,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB;IAClB,KAAK,CAAC,aAAa;QACjB,OAAO,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IACpC,CAAC;IAED,0BAA0B;IAC1B,KAAK,CAAC,cAAc,CAAC,OAAqB;QACxC,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,kDAAkD,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACvF,CAAC;QACD,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;YACrE,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;YACtF,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;YACrD,MAAM,IAAI,CAAC,uBAAuB,CAAC;gBACjC,GAAG,QAAQ;gBACX,UAAU,EAAE,OAAO,CAAC,UAAU;gBAC9B,aAAa,EAAE,QAAQ,CAAC,aAAa,GAAG,CAAC;gBACzC,YAAY,EAAE,OAAO,CAAC,IAAI;aAC3B,CAAC,CAAC;QACL,CAAC,CAAC,CAAC;IACL,CAAC;IAED,qBAAqB;IACrB,KAAK,CAAC,aAAa;QACjB,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACxC,CAAC;QACD,OAAO,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;IAC7C,CAAC;IAED,+BAA+B;IACvB,KAAK,CAAC,sBAAsB;QAClC,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,EAAE,CAAC;YAC7D,OAAO,IAAI,CAAC,uBAAuB,EAAE,CAAC;QACxC,CAAC;QACD,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CACpB,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CACnC,CAAC;QACtC,IAAI,GAAG,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,IAAI,GAAG,CAAC,QAAQ,IAAI,GAAG,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnD,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,CAAC,UAAU,4BAA4B,CAAC,CAAC;QAChF,CAAC;QACD,OAAO;YACL,CAAC,EAAE,CAAC;YACJ,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,MAAM,CAAC,GAAG,CAAC,QAAQ,IAAI,IAAI,CAAC,QAAQ,CAAC;YAC/C,GAAG,CAAC,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACrH,UAAU,EAAE,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE;YAC5E,UAAU,EAAE,OAAO,GAAG,CAAC,UAAU,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC;YACnE,aAAa,EAAE,OAAO,GAAG,CAAC,aAAa,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;YAC5E,GAAG,CAAC,OAAO,GAAG,CAAC,YAAY,KAAK,QAAQ,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACvG,GAAG,CAAC,GAAG,CAAC,kBAAkB,IAAI,OAAO,GAAG,CAAC,kBAAkB,KAAK,QAAQ;gBACtE,CAAC,CAAC,EAAE,kBAAkB,EAAE,4BAA4B,CAAC,GAAG,CAAC,kBAAkB,CAAC,EAAE;gBAC9E,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,aAAa,CAAC;gBAClC,CAAC,CAAC,EAAE,aAAa,EAAE,uBAAuB,CAAC,GAAG,CAAC,aAAa,CAAC,EAAE;gBAC/D,CAAC,CAAC,EAAE,CAAC;YACP,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,yBAAyB,CAAC;gBAC9C,CAAC,CAAC,EAAE,yBAAyB,EAAE,qBAAqB,CAAC,GAAG,CAAC,yBAAyB,CAAC,EAAE;gBACrF,CAAC,CAAC,EAAE,CAAC;SACR,CAAC;IACJ,CAAC;IAED,uBAAuB;IACvB,KAAK,CAAC,cAAc,CAAC,QAAiC;QACpD,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;YACrE,MAAM,IAAI,CAAC,uBAAuB,CAAC,QAAQ,CAAC,CAAC;QAC/C,CAAC,CAAC,CAAC;IACL,CAAC;IAED,+BAA+B;IACvB,KAAK,CAAC,uBAAuB,CAAC,QAAiC;QACrE,IAAI,QAAQ,CAAC,UAAU,KAAK,IAAI,CAAC,UAAU,IAAI,QAAQ,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnF,MAAM,IAAI,KAAK,CAAC,4CAA4C,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;QACjF,CAAC;QACD,MAAM,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC1D,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CACpC,IAAI,CAAC,kBAAkB,EACvB,GAAG,IAAI,CAAC,SAAS,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,CACzC,CAAC;IACJ,CAAC;IAED,wCAAwC;IACxC,KAAK,CAAC,eAAe,CAAC,KAAuC;QAC3D,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;QACxB,OAAO,MAAM,IAAI,CAAC,KAAK,CAAC,cAAc,CAAC,IAAI,CAAC,qBAAqB,EAAE,KAAK,IAAI,EAAE;YAC5E,MAAM,aAAa,GAAG;gBACpB,GAAG,CAAC,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;gBACxC,GAAG,KAAK;gBACR,UAAU,EAAE,IAAI,CAAC,UAAU;gBAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;gBACvB,CAAC,EAAE,CAAU;aACd,CAAC;YACF,MAAM,IAAI,CAAC,uBAAuB,CAAC,aAAa,CAAC,CAAC;YAClD,OAAO,aAAa,CAAC;QACvB,CAAC,CAAC,CAAC;IACL,CAAC;IAED,8BAA8B;IACtB,KAAK,CAAC,wBAAwB;QACpC,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;QAChD,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,sBAAsB,EAAE,CAAC;QACrD,MAAM,aAAa,GAAG,QAAQ,CAAC,CAAC,CAAC,CAAC;QAClC,MAAM,YAAY,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QACnD,MAAM,IAAI,CAAC,uBAAuB,CAAC;YACjC,GAAG,QAAQ;YACX,UAAU,EAAE,aAAa,EAAE,UAAU,IAAI,QAAQ,CAAC,UAAU;YAC5D,UAAU,EAAE,YAAY,EAAE,UAAU,IAAI,QAAQ,CAAC,UAAU;YAC3D,aAAa,EAAE,QAAQ,CAAC,MAAM;YAC9B,GAAG,CAAC,YAAY,EAAE,IAAI,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,YAAY,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACnE,CAAC,CAAC;IACL,CAAC;IAED,kCAAkC;IAC1B,KAAK,CAAC,aAAa,CAAC,WAAW,GAAG,KAAK;QAC7C,IAAI,CAAC,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,WAAW,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;YAAE,OAAO,EAAE,CAAC;QACxE,MAAM,OAAO,GAAG,CAAC,MAAM,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;QACvF,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAClC,MAAM,QAAQ,GAAmB,EAAE,CAAC;QACpC,KAAK,IAAI,UAAU,GAAG,CAAC,EAAE,UAAU,GAAG,KAAK,CAAC,MAAM,EAAE,UAAU,IAAI,CAAC,EAAE,CAAC;YACpE,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC;YAC/B,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;gBAAE,SAAS;YAC3B,IAAI,OAAqB,CAAC;YAC1B,IAAI,CAAC;gBACH,OAAO,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAiB,CAAC;YAC7C,CAAC;YAAC,OAAO,KAAK,EAAE,CAAC;gBACf,MAAM,OAAO,GAAG,KAAK,CAAC,KAAK,CAAC,UAAU,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC;gBAC1E,IAAI,CAAC,WAAW,IAAI,CAAC,OAAO;oBAAE,MAAM,KAAK,CAAC;gBAC1C,MAAM,gBAAgB,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;gBACjF,MAAM,IAAI,CAAC,KAAK,CAAC,qBAAqB,CAAC,IAAI,CAAC,kBAAkB,EAAE,gBAAgB,CAAC,CAAC,CAAC,GAAG,gBAAgB,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC;gBACjH,MAAM;YACR,CAAC;YACD,IAAI,OAAO,CAAC,QAAQ,KAAK,IAAI,CAAC,QAAQ,EAAE,CAAC;gBACvC,MAAM,IAAI,KAAK,CAAC,kDAAkD,IAAI,CAAC,UAAU,EAAE,CAAC,CAAC;YACvF,CAAC;YACD,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;QACzB,CAAC;QACD,OAAO,QAAQ,CAAC;IAClB,CAAC;IAEO,uBAAuB;QAC7B,MAAM,UAAU,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;QAC9B,OAAO;YACL,CAAC,EAAE,CAAC;YACJ,UAAU,EAAE,IAAI,CAAC,UAAU;YAC3B,QAAQ,EAAE,IAAI,CAAC,QAAQ;YACvB,UAAU;YACV,UAAU,EAAE,UAAU;YACtB,aAAa,EAAE,CAAC;SACjB,CAAC;IACJ,CAAC;CACF;AAED,SAAS,4BAA4B,CAAC,KAAa;IACjD,OAAO,MAAM,CAAC,WAAW,CAAC,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE,UAAU,CAAC,EAAE,EAAE,CAAC,OAAO,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;AACvK,CAAC;AAED,SAAS,uBAAuB,CAAC,KAAgB;IAC/C,OAAO,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QAC5B,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC;QACjD,MAAM,SAAS,GAAG,IAA2C,CAAC;QAC9D,MAAM,OAAO,GAAG,OAAO,SAAS,CAAC,OAAO,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtF,MAAM,eAAe,GAAG,OAAO,SAAS,CAAC,eAAe,KAAK,QAAQ,CAAC,CAAC,CAAC,SAAS,CAAC,eAAe,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC9G,MAAM,mBAAmB,GAAG,KAAK,CAAC,OAAO,CAAC,SAAS,CAAC,mBAAmB,CAAC;YACtE,CAAC,CAAC,qBAAqB,CAAC,SAAS,CAAC,mBAAmB,CAAC;YACtD,CAAC,CAAC,EAAE,CAAC;QACP,OAAO,OAAO,IAAI,eAAe,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,eAAe,EAAE,mBAAmB,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC/F,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,qBAAqB,CAAC,KAAgB;IAC7C,OAAO,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAkB,EAAE,CAAC,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;AACnI,CAAC"}
+{"version":3,"file":"LocalGroupSessionDataStore.js","sourceRoot":"","sources":["../../../src/workspace/store/LocalGroupSessionDataStore.ts"],"names":[],"mappings":"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"}

package/city-test/group.test.mjs

@@ -116,6 +116,8 @@ test("Group.model uses AI dispatch to select only the returned members", async (
   await group_session.prompt({ query: "请审查这个变更" });
   await wait_for_group_idle(group_session);
   assert.deepEqual(RecordingSession.created.map((entry) => entry.agent_id), ["reviewer"]);
+  assert.match(RecordingSession.created[0].query, /你已被 Group 调度选中，必须直接回复当前消息/);
+  assert.doesNotMatch(RecordingSession.created[0].query, /判断是否需要回复|如果不需要你发言/);
   await city.close();
 });
 
@@ -208,6 +210,50 @@ test("AI Dispatch 未调用 dispatch_group 时记录协议错误", async () => {
   await city.close();
 });
 
+test("AI Dispatch 在同一调度 Turn 内纠正未调用工具的响应", async () => {
+  RecordingSession.created = [];
+  let dispatch_calls = 0;
+  const dispatch_model = new MockModelClient({
+    modelId: "recovering-dispatch-model",
+    doGenerate: async (call) => {
+      dispatch_calls += 1;
+      if (dispatch_calls === 1) {
+        return {
+          content: [{ type: "text", text: "我建议让 responder 回复。" }],
+          finishReason: { unified: "stop", raw: "stop" },
+          usage: { inputTokens: 1, outputTokens: 1, totalTokens: 2 },
+          warnings: [],
+        };
+      }
+      assert.equal(call.messages.some((message) => (
+        message.role === "user" && message.content.some((part) => (
+          part.type === "text" && part.text.includes("上一响应不符合调度协议")
+        ))
+      )), true);
+      return {
+        content: [create_dispatch_tool_call({ steps: [["responder"]], next: "stop" })],
+        finishReason: { unified: "tool-calls", raw: "tool_calls" },
+        usage: { inputTokens: 1, outputTokens: 1, totalTokens: 2 },
+        warnings: [],
+      };
+    },
+  });
+  const city = new City();
+  const agent = new Agent({ id: "responder", session_class: RecordingSession });
+  city.agents.add(agent);
+  const group = new Group({ id: "recovering-dispatch-group", model: dispatch_model, members: [agent] });
+  city.groups.add(group);
+  const group_session = await group.sessions.create();
+
+  await group_session.prompt({ query: "请回答" });
+  await wait_for_group_idle(group_session);
+
+  assert.equal(dispatch_calls, 2);
+  assert.deepEqual(RecordingSession.created.map((entry) => entry.agent_id), ["responder"]);
+  assert.equal((await group_session.messages()).some((message) => message.sender_type === "system"), false);
+  await city.close();
+});
+
 test("AI Dispatch 拒绝未知成员并允许跨阶段重复投递", async () => {
   const inputs = [
     { input: { steps: [["unknown"]], next: "stop" }, expected_agent_ids: [] },
@@ -414,6 +460,157 @@ test("GroupSession 使用 City Storage 持久化并可恢复", async () => {
   await fs.rm(root_path, { recursive: true, force: true });
 });
 
+test("GroupSession 持久化独享 Dispatch Session 的调度 Turn", async () => {
+  RecordingSession.created = [];
+  const root_path = await fs.mkdtemp(path.join(os.tmpdir(), "downcity-group-dispatch-session-"));
+  const city = new City({ storage: new LocalStorageProvider(root_path) });
+  const agent = new Agent({ id: "dispatch-member", session_class: RecordingSession });
+  city.agents.add(agent);
+  const group = new Group({ id: "dispatch-session-group", members: [agent], dispatch_strategy: test_dispatch_strategy });
+  city.groups.add(group);
+  const session = await group.sessions.create();
+
+  await session.prompt({ query: "persist dispatch" });
+  await wait_for_group_idle(session);
+
+  const turns_path = path.join(
+    root_path,
+    "groups",
+    "dispatch-session-group",
+    "sessions",
+    encodeURIComponent(session.id),
+    "dispatch",
+    "turns.jsonl",
+  );
+  const records = (await fs.readFile(turns_path, "utf8"))
+    .trim()
+    .split("\n")
+    .map((line) => JSON.parse(line));
+  const user_records = records.filter((record) => record.trigger === "user");
+  assert.deepEqual(user_records.map((record) => record.status), ["queued", "running", "completed"]);
+  assert.deepEqual(user_records.at(-1).decision.nodes[0].member_ids, ["dispatch-member"]);
+  assert.equal(
+    (await session.messages()).find((message) => message.sender_type === "agent").dispatch_id,
+    user_records.at(-1).dispatch_id,
+  );
+  await city.close();
+  await fs.rm(root_path, { recursive: true, force: true });
+});
+
+test("GroupSession stop 会中断 Dispatch Session 且不记录失败消息", async () => {
+  const root_path = await fs.mkdtemp(path.join(os.tmpdir(), "downcity-group-dispatch-stop-"));
+  let dispatch_started = false;
+  let dispatch_aborted = false;
+  let dispatch_invocations = 0;
+  const strategy = {
+    async decide_dispatch({ abort_signal }) {
+      dispatch_invocations += 1;
+      dispatch_started = true;
+      await new Promise((resolve, reject) => {
+        const abort = () => {
+          dispatch_aborted = true;
+          reject(abort_signal.reason);
+        };
+        if (abort_signal.aborted) abort();
+        else abort_signal.addEventListener("abort", abort, { once: true });
+      });
+      return { nodes: [], terminal: true };
+    },
+  };
+  const city = new City({ storage: new LocalStorageProvider(root_path) });
+  const agent = new Agent({ id: "unused-member", session_class: RecordingSession });
+  city.agents.add(agent);
+  const group = new Group({ id: "dispatch-stop-group", members: [agent], dispatch_strategy: strategy });
+  city.groups.add(group);
+  const session = await group.sessions.create();
+  await session.prompt({ query: "stop dispatch" });
+  await session.prompt({ query: "cancel queued dispatch" });
+  for (let attempt = 0; attempt < 200 && !dispatch_started; attempt += 1) {
+    await new Promise((resolve) => setTimeout(resolve, 5));
+  }
+
+  await session.stop();
+
+  assert.equal(dispatch_aborted, true);
+  assert.equal(dispatch_invocations, 1);
+  assert.deepEqual((await session.messages()).map((message) => message.text), [
+    "stop dispatch",
+    "cancel queued dispatch",
+  ]);
+  const turns_path = path.join(
+    root_path,
+    "groups",
+    "dispatch-stop-group",
+    "sessions",
+    encodeURIComponent(session.id),
+    "dispatch",
+    "turns.jsonl",
+  );
+  const records = (await fs.readFile(turns_path, "utf8"))
+    .trim()
+    .split("\n")
+    .map((line) => JSON.parse(line));
+  const latest_records = new Map(records.map((record) => [record.dispatch_id, record]));
+  assert.equal(latest_records.size, 2);
+  assert.deepEqual([...latest_records.values()].map((record) => record.status), ["stopped", "stopped"]);
+  await city.close();
+  await fs.rm(root_path, { recursive: true, force: true });
+});
+
+test("GroupSession 恢复时重新执行中断的用户调度", async () => {
+  RecordingSession.created = [];
+  const root_path = await fs.mkdtemp(path.join(os.tmpdir(), "downcity-group-dispatch-recovery-"));
+  let original_abort_signal;
+  let original_dispatch_started = false;
+  const original_city = new City({ storage: new LocalStorageProvider(root_path) });
+  const original_agent = new Agent({ id: "recovery-member", session_class: RecordingSession });
+  original_city.agents.add(original_agent);
+  const original_group = new Group({
+    id: "dispatch-recovery-group",
+    members: [original_agent],
+    dispatch_strategy: {
+      async decide_dispatch({ abort_signal }) {
+        original_abort_signal = abort_signal;
+        original_dispatch_started = true;
+        await new Promise((resolve, reject) => {
+          abort_signal.addEventListener("abort", () => reject(abort_signal.reason), { once: true });
+        });
+        return { nodes: [], terminal: true };
+      },
+    },
+  });
+  original_city.groups.add(original_group);
+  const original_session = await original_group.sessions.create();
+  await original_session.prompt({ query: "recover dispatch" });
+  for (let attempt = 0; attempt < 200 && !original_dispatch_started; attempt += 1) {
+    await new Promise((resolve) => setTimeout(resolve, 5));
+  }
+
+  const restored_city = new City({ storage: new LocalStorageProvider(root_path) });
+  const restored_agent = new Agent({ id: "recovery-member", session_class: RecordingSession });
+  restored_city.agents.add(restored_agent);
+  const restored_group = new Group({
+    id: "dispatch-recovery-group",
+    members: [restored_agent],
+    dispatch_strategy: test_dispatch_strategy,
+  });
+  restored_city.groups.add(restored_group);
+  const restored_session = await restored_group.sessions.get(original_session.id);
+  assert.ok(restored_session);
+  await wait_for_group_idle(restored_session);
+
+  assert.deepEqual(RecordingSession.created.map((entry) => entry.agent_id), ["recovery-member"]);
+  assert.deepEqual((await restored_session.messages()).map((message) => message.text), [
+    "recover dispatch",
+    "reply:recovery-member",
+  ]);
+  await original_session.stop();
+  assert.equal(original_abort_signal.aborted, true);
+  await restored_city.close();
+  await original_city.close();
+  await fs.rm(root_path, { recursive: true, force: true });
+});
+
 test("GroupSession 持久化调度检查点并在收口后清理", async () => {
   const root_path = await fs.mkdtemp(path.join(os.tmpdir(), "downcity-group-checkpoint-"));
   const storage = new LocalStorageProvider(root_path);
@@ -450,6 +647,56 @@ test("GroupSession 持久化调度检查点并在收口后清理", async () => {
   await fs.rm(root_path, { recursive: true, force: true });
 });
 
+test("GroupSession 列表首次读取时将 v1 metadata 原子迁移为 v2", async () => {
+  const root_path = await fs.mkdtemp(path.join(os.tmpdir(), "downcity-group-metadata-migration-"));
+  const group_id = "metadata-migration-group";
+  const session_id = "legacy-session";
+  const session_path = path.join(root_path, "groups", group_id, "sessions", session_id);
+  const meta_path = path.join(session_path, "meta.json");
+  await fs.mkdir(session_path, { recursive: true });
+  await fs.writeFile(meta_path, `${JSON.stringify({
+    v: 1,
+    session_id,
+    group_id,
+    created_at: 1,
+    updated_at: 2,
+    message_count: 1,
+    preview_text: "legacy message",
+    pending_turns: [{
+      turn_id: "legacy-turn",
+      root_message_id: "legacy-message",
+      context_message_ids: [],
+    }],
+    auto_frontier_message_ids: ["legacy-reply"],
+  }, null, 2)}\n`);
+
+  const city = new City({ storage: new LocalStorageProvider(root_path) });
+  const agent = new Agent({ id: "metadata-agent", session_class: RecordingSession });
+  city.agents.add(agent);
+  const group = new Group({ id: group_id, members: [agent], dispatch_strategy: test_dispatch_strategy });
+  city.groups.add(group);
+
+  assert.deepEqual(await group.sessions.list(), [{
+    id: session_id,
+    group_id,
+    created_at: 1,
+    updated_at: 2,
+    message_count: 1,
+    preview_text: "legacy message",
+  }]);
+  const migrated_metadata = JSON.parse(await fs.readFile(meta_path, "utf8"));
+  assert.equal(migrated_metadata.v, 2);
+  assert.deepEqual(migrated_metadata.pending_turns, [{
+    turn_id: "legacy-turn",
+    root_message_id: "legacy-message",
+    context_message_ids: [],
+    dispatch_stage: "auto",
+  }]);
+  assert.deepEqual(migrated_metadata.auto_frontier_message_ids, ["legacy-reply"]);
+  await city.close();
+  await fs.rm(root_path, { recursive: true, force: true });
+});
+
 test("GroupSession 恢复时修复尾部损坏的消息记录", async () => {
   const root_path = await fs.mkdtemp(path.join(os.tmpdir(), "downcity-group-tail-"));
   const storage = new LocalStorageProvider(root_path);
@@ -628,7 +875,7 @@ test("唯一 auto dispatch 等待并合并并发输入批次", async () => {
   await city.close();
 });
 
-test("响应图依赖没有有效回复时不会继续投递下游节点", async () => {
+test("成员返回空内容时记录失败且不继续投递下游节点", async () => {
   RecordingSession.created = [];
   class EmptySession extends Session {
     async prompt() {
@@ -665,6 +912,10 @@ test("响应图依赖没有有效回复时不会继续投递下游节点", async
   await group_session.prompt({ query: "请分析并审查" });
   await wait_for_group_idle(group_session);
   assert.deepEqual(RecordingSession.created.map((entry) => entry.agent_id), ["architect"]);
+  assert.deepEqual((await group_session.messages()).map((message) => [message.sender_type, message.text]), [
+    ["user", "请分析并审查"],
+    ["system", "architect 执行失败：未生成有效回复"],
+  ]);
   await city.close();
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@downcity/agent",
-  "version": "1.1.401",
+  "version": "1.1.408",
   "type": "module",
   "description": "Downcity 单 Agent SDK 与执行运行时",
   "main": "./bin/index.js",
@@ -28,9 +28,9 @@
     }
   },
   "dependencies": {
-    "@downcity/workspace": "^0.1.6",
-    "@downcity/type": "0.1.200",
-    "@downcity/federation": "^0.1.10",
+    "@downcity/workspace": "^0.1.7",
+    "@downcity/type": "0.1.202",
+    "@downcity/federation": "^0.1.15",
     "commander": "^15.0.0",
     "dotenv": "^17.4.2",
     "execa": "^9.6.1",