@downcity/agent 1.1.408 → 1.1.437

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

@@ -1 +1 @@
-{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../src/group/Group.ts"],"names":[],"mappings":"AAAA,uBAAuB;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,sCAAsC;AACtC,qBAAa,KAAM,YAAW,aAAa;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,UAAU,CAAC;IAC5B,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;gBAErB,OAAO,EAAE,YAAY;IAmBjC,4BAA4B;IACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAI/B"}
+{"version":3,"file":"Group.d.ts","sourceRoot":"","sources":["../../src/group/Group.ts"],"names":[],"mappings":"AAAA,uBAAuB;AAGvB,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,mCAAmC,CAAC;AAC1E,OAAO,KAAK,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,gBAAgB,CAAC;AACnE,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAC1E,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAGzD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oCAAoC,CAAC;AAE5E,sCAAsC;AACtC,qBAAa,KAAM,YAAW,aAAa;IACzC,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC9B,QAAQ,CAAC,KAAK,CAAC,EAAE,WAAW,CAAC;IAC7B,QAAQ,CAAC,OAAO,EAAE,SAAS,KAAK,EAAE,CAAC;IACnC,QAAQ,CAAC,iBAAiB,EAAE,gBAAgB,CAAC;IAC7C,QAAQ,CAAC,QAAQ,EAAE,aAAa,CAAC;IAEjC,wBAAwB;IACxB,OAAO,CAAC,gBAAgB,CAAqD;IAC7E,qBAAqB;IACrB,OAAO,CAAC,aAAa,CAAC,CAAS;IAC/B,oCAAoC;IACpC,OAAO,CAAC,aAAa,CAAC,CAAoB;IAC1C,iCAAiC;IACjC,OAAO,CAAC,sBAAsB,CAAS;gBAE3B,OAAO,EAAE,YAAY;IAkBjC,8CAA8C;IAC9C,MAAM,CAAC,KAAK,EAAE,MAAM,EAAE,gBAAgB,EAAE,eAAe,GAAG,IAAI;IAc9D,8BAA8B;IACxB,MAAM,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAO1C,qCAAqC;IACrC,iBAAiB,IAAI,iBAAiB;IAWtC,iCAAiC;IACjC,oBAAoB,IAAI,IAAI;IAI5B,+BAA+B;IACzB,qBAAqB,IAAI,OAAO,CAAC,IAAI,CAAC;IAK5C,4BAA4B;IACtB,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;CAG/B"}

package/bin/group/Group.js

@@ -1,7 +1,8 @@
 /** Group 群聊主体的本地实现。 */
 import { AiDispatchStrategy } from "../types/group/DispatchStrategy.js";
-import { GroupSessions } from "./GroupSessions.js";
-import { dispose_group_runtime, initialize_group_runtime } from "../internal/GroupRuntime.js";
+import { GroupSessions } from "../group/GroupSessions.js";
+import { AgentMemoryStorageProvider } from "../agent/AgentMemoryStorage.js";
+import { LocalGroupSessionStore } from "../group/storage/LocalGroupSessionStore.js";
 /** Group 主体：只持有身份、成员、资源引用和群聊上下文集合。 */
 export class Group {
     id;
@@ -11,6 +12,14 @@ export class Group {
     members;
     dispatch_strategy;
     sessions;
+    /** 未加入宿主时使用的隔离进程内存储。 */
+    storage_provider = new AgentMemoryStorageProvider();
+    /** 当前 Group 所属宿主。 */
+    storage_owner;
+    /** 延迟创建的 GroupSession 持久化 Store。 */
+    session_store;
+    /** 是否已经在无宿主存储中创建或恢复过 Session。 */
+    memory_session_started = false;
     constructor(options) {
         this.id = String(options.id || "").trim();
         if (!this.id)
@@ -30,13 +39,54 @@ export class Group {
         this.instruction = options.instruction?.trim() || undefined;
         this.model = options.model;
         this.dispatch_strategy = options.dispatch_strategy || new AiDispatchStrategy({ model: this.model });
-        initialize_group_runtime(this);
         this.sessions = new GroupSessions(this);
     }
+    /** 将宿主存储装配到 Group；必须在使用 GroupSessions 前完成。 */
+    attach(owner, storage_provider) {
+        if (this.storage_owner) {
+            if (this.storage_owner === owner)
+                return;
+            throw new Error(`Group "${this.id}" already belongs to another host`);
+        }
+        if (this.memory_session_started || this.session_store) {
+            throw new Error(`Group "${this.id}" already used standalone storage; attach it before using GroupSessions`);
+        }
+        this.storage_owner = owner;
+        this.storage_provider = storage_provider;
+    }
+    /** 解除指定宿主的存储装配并释放当前 Store。 */
+    async detach(owner) {
+        if (this.storage_owner !== owner)
+            return;
+        await this.dispose_session_store();
+        this.storage_owner = undefined;
+        this.storage_provider = new AgentMemoryStorageProvider();
+    }
+    /** 获取或创建 Group 唯一的 Session Store。 */
+    get_session_store() {
+        if (this.session_store)
+            return this.session_store;
+        const scope = this.storage_provider.open_scope(["groups", this.id]);
+        this.session_store = new LocalGroupSessionStore({
+            files: scope.files,
+            storage_root_path: scope.root_path,
+            group_id: this.id,
+        });
+        return this.session_store;
+    }
+    /** 标记 Group 已经创建或恢复过 Session。 */
+    mark_session_started() {
+        if (!this.storage_owner)
+            this.memory_session_started = true;
+    }
+    /** 释放当前 GroupSession Store。 */
+    async dispose_session_store() {
+        await this.session_store?.dispose();
+        this.session_store = undefined;
+    }
     /** 释放 Group 所拥有的全部群聊上下文。 */
     async dispose() {
         await this.sessions.dispose();
-        await dispose_group_runtime(this);
     }
 }
 //# sourceMappingURL=Group.js.map

package/bin/group/Group.js.map

@@ -1 +1 @@
-{"version":3,"file":"Group.js","sourceRoot":"","sources":["../../src/group/Group.ts"],"names":[],"mappings":"AAAA,uBAAuB;AAEvB,OAAO,EAAE,kBAAkB,EAAE,MAAM,mCAAmC,CAAC;AAKvE,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AACzD,OAAO,EAAE,qBAAqB,EAAE,wBAAwB,EAAE,MAAM,4BAA4B,CAAC;AAE7F,sCAAsC;AACtC,MAAM,OAAO,KAAK;IACP,EAAE,CAAS;IACX,IAAI,CAAS;IACb,WAAW,CAAU;IACrB,KAAK,CAAc;IACnB,OAAO,CAAmB;IAC1B,iBAAiB,CAAmB;IACpC,QAAQ,CAAgB;IAEjC,YAAY,OAAqB;QAC/B,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,OAAO,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,IAAI,CAAC,EAAE;YAAE,MAAM,IAAI,KAAK,CAAC,+BAA+B,CAAC,CAAC;QAC/D,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,MAAM;YAAE,MAAM,IAAI,KAAK,CAAC,oCAAoC,CAAC,CAAC;QACpF,MAAM,UAAU,GAAG,IAAI,GAAG,EAAU,CAAC;QACrC,IAAI,CAAC,OAAO,GAAG,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE;YAC1D,IAAI,CAAC,MAAM,EAAE,EAAE;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;YACnE,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC;gBAAE,MAAM,IAAI,KAAK,CAAC,gCAAgC,MAAM,CAAC,EAAE,EAAE,CAAC,CAAC;YAC5F,UAAU,CAAC,GAAG,CAAC,MAAM,CAAC,EAAE,CAAC,CAAC;YAC1B,OAAO,MAAM,CAAC;QAChB,CAAC,CAAC,CAAC,CAAC;QACJ,IAAI,CAAC,IAAI,GAAG,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,IAAI,EAAE,IAAI,IAAI,CAAC,EAAE,CAAC;QAC9D,IAAI,CAAC,WAAW,GAAG,OAAO,CAAC,WAAW,EAAE,IAAI,EAAE,IAAI,SAAS,CAAC;QAC5D,IAAI,CAAC,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC;QAC3B,IAAI,CAAC,iBAAiB,GAAG,OAAO,CAAC,iBAAiB,IAAI,IAAI,kBAAkB,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,KAAK,EAAE,CAAC,CAAC;QACpG,wBAAwB,CAAC,IAAI,CAAC,CAAC;QAC/B,IAAI,CAAC,QAAQ,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED,4BAA4B;IAC5B,KAAK,CAAC,OAAO;QACX,MAAM,IAAI,CAAC,QAAQ,CAAC,OAAO,EAAE,CAAC;QAC9B,MAAM,qBAAqB,CAAC,IAAI,CAAC,CAAC;IACpC,CAAC;CACF"}
+{"version":3,"file":"Group.js","sourceRoot":"","sources":["../../src/group/Group.ts"],"names":[],"mappings":"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"}

package/bin/group/GroupDispatchRuntime.d.ts

@@ -0,0 +1,37 @@
+/**
+ * GroupSession 私有调度运行器。
+ *
+ * 本模块只封装调度请求的串行执行、模型取消和 Turn 状态提交。共享消息、成员关系、
+ * 恢复检查点与整体生命周期仍由 GroupSession 统一拥有。
+ */
+import type { GroupDispatchInput, GroupDispatchResult, GroupDispatchRuntimeOptions } from "../types/group/GroupDispatch.js";
+import type { GroupSessionDataStore } from "../types/group/GroupSessionStore.js";
+/** 主动停止 Group 调度时使用的内部错误。 */
+export declare class GroupDispatchStoppedError extends Error {
+    constructor();
+}
+/** GroupSession 私有的调度运行机制，不构成独立 Session。 */
+export declare class GroupDispatchRuntime {
+    private readonly dispatch_strategy;
+    private store?;
+    private queue_tail;
+    private active_abort_controller?;
+    private stopping;
+    private disposed;
+    constructor(options: GroupDispatchRuntimeOptions);
+    /** 绑定 GroupSession Store，并把进程中断留下的运行态明确收口为 stopped。 */
+    initialize(store: GroupSessionDataStore): Promise<this>;
+    /** 按提交顺序执行一次调度，并在返回前持久化最终决定。 */
+    decide(input: GroupDispatchInput): Promise<GroupDispatchResult>;
+    /** 中断当前模型调用，并让尚未开始的调度 Turn 按队列顺序收口。 */
+    stop(): Promise<void>;
+    /** 永久释放当前调度运行器。 */
+    dispose(): Promise<void>;
+    /** 执行队首调度 Turn，确保成功、失败和停止都形成持久化终态。 */
+    private execute_turn;
+    /** 提交没有 decision 的失败或停止终态。 */
+    private persist_terminal_turn;
+    private require_store;
+    private assert_available;
+}
+//# sourceMappingURL=GroupDispatchRuntime.d.ts.map

package/bin/group/GroupDispatchRuntime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"GroupDispatchRuntime.d.ts","sourceRoot":"","sources":["../../src/group/GroupDispatchRuntime.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,EAE5B,MAAM,gCAAgC,CAAC;AAKxC,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,oCAAoC,CAAC;AAEhF,6BAA6B;AAC7B,qBAAa,yBAA0B,SAAQ,KAAK;;CAKnD;AAED,4CAA4C;AAC5C,qBAAa,oBAAoB;IAC/B,OAAO,CAAC,QAAQ,CAAC,iBAAiB,CAAmD;IACrF,OAAO,CAAC,KAAK,CAAC,CAAwB;IACtC,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,uBAAuB,CAAC,CAAkB;IAClD,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,QAAQ,CAAS;gBAEb,OAAO,EAAE,2BAA2B;IAIhD,uDAAuD;IACjD,UAAU,CAAC,KAAK,EAAE,qBAAqB,GAAG,OAAO,CAAC,IAAI,CAAC;IAoB7D,gCAAgC;IAChC,MAAM,CAAC,KAAK,EAAE,kBAAkB,GAAG,OAAO,CAAC,mBAAmB,CAAC;IAsB/D,uCAAuC;IACjC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,mBAAmB;IACb,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAO9B,sCAAsC;YACxB,YAAY;IAoD1B,8BAA8B;YAChB,qBAAqB;IAanC,OAAO,CAAC,aAAa;IAKrB,OAAO,CAAC,gBAAgB;CAIzB"}

package/bin/group/{GroupDispatchSession.js → GroupDispatchRuntime.js}

@@ -1,19 +1,19 @@
 /**
- * GroupDispatchSession：单个 GroupSession 独享的持久化调度执行边界。
+ * GroupSession 私有调度运行器。
  *
- * 本对象统一拥有调度队列、当前模型取消信号和调度 Turn 状态。调度策略只负责决策，
- * 不再自行拥有跨 GroupSession 的运行状态或停止语义。
+ * 本模块只封装调度请求的串行执行、模型取消和 Turn 状态提交。共享消息、成员关系、
+ * 恢复检查点与整体生命周期仍由 GroupSession 统一拥有。
  */
 import { nanoid } from "nanoid";
-/** 主动停止 Dispatch Session 时使用的内部错误。 */
+/** 主动停止 Group 调度时使用的内部错误。 */
 export class GroupDispatchStoppedError extends Error {
     constructor() {
         super("Group dispatch stopped");
         this.name = "GroupDispatchStoppedError";
     }
 }
-/** GroupSession 私有的调度 Session。 */
-export class GroupDispatchSession {
+/** GroupSession 私有的调度运行机制，不构成独立 Session。 */
+export class GroupDispatchRuntime {
     dispatch_strategy;
     store;
     queue_tail = Promise.resolve();
@@ -23,17 +23,17 @@ export class GroupDispatchSession {
     constructor(options) {
         this.dispatch_strategy = options.dispatch_strategy;
     }
-    /** 绑定持久化视图，并把进程中断留下的运行态明确收口为 stopped。 */
+    /** 绑定 GroupSession Store，并把进程中断留下的运行态明确收口为 stopped。 */
     async initialize(store) {
         if (this.store && this.store !== store) {
-            throw new Error("GroupDispatchSession is already initialized with another Store");
+            throw new Error("GroupDispatchRuntime is already initialized with another Store");
         }
         if (this.store === store)
             return this;
         this.store = store;
-        const interrupted_turns = (await store.list_turns()).filter((turn) => (turn.status === "queued" || turn.status === "running"));
+        const interrupted_turns = (await store.list_dispatch_turns()).filter((turn) => (turn.status === "queued" || turn.status === "running"));
         for (const turn of interrupted_turns) {
-            await store.append_turn({
+            await store.append_dispatch_turn({
                 ...turn,
                 status: "stopped",
                 error: "Group dispatch interrupted before recovery",
@@ -50,13 +50,13 @@ export class GroupDispatchSession {
         const queued_turn = {
             dispatch_id: `group-dispatch-${nanoid(12)}`,
             trigger: input.trigger,
-            message_id: input.message.id,
+            message_id: input.current_message.id,
             pending_message_ids: input.pending_messages.map((message) => message.id),
             status: "queued",
             created_at,
             updated_at: created_at,
         };
-        const persist_queued = store.append_turn(queued_turn);
+        const persist_queued = store.append_dispatch_turn(queued_turn);
         const operation = this.queue_tail.then(async () => {
             await persist_queued;
             return await this.execute_turn(input, queued_turn);
@@ -74,7 +74,7 @@ export class GroupDispatchSession {
         this.active_abort_controller = undefined;
         this.stopping = false;
     }
-    /** 永久释放当前 Dispatch Session。 */
+    /** 永久释放当前调度运行器。 */
     async dispose() {
         if (this.disposed)
             return;
@@ -91,20 +91,21 @@ export class GroupDispatchSession {
         }
         const abort_controller = new AbortController();
         this.active_abort_controller = abort_controller;
-        await store.append_turn({
+        await store.append_dispatch_turn({
             ...queued_turn,
             status: "running",
             updated_at: Date.now(),
         });
         try {
-            const decision = await this.dispatch_strategy.decide_dispatch({
+            const strategy_decision = await this.dispatch_strategy.decide_dispatch({
                 ...input,
                 abort_signal: abort_controller.signal,
             });
             if (this.stopping || this.disposed || abort_controller.signal.aborted) {
                 throw new GroupDispatchStoppedError();
             }
-            await store.append_turn({
+            const decision = normalize_dispatch_decision(strategy_decision, input.members);
+            await store.append_dispatch_turn({
                 ...queued_turn,
                 status: "completed",
                 decision,
@@ -132,7 +133,7 @@ export class GroupDispatchSession {
     }
     /** 提交没有 decision 的失败或停止终态。 */
     async persist_terminal_turn(turn, status, error) {
-        await this.require_store().append_turn({
+        await this.require_store().append_dispatch_turn({
             ...turn,
             status,
             error,
@@ -141,14 +142,69 @@ export class GroupDispatchSession {
     }
     require_store() {
         if (!this.store)
-            throw new Error("GroupDispatchSession is not initialized");
+            throw new Error("GroupDispatchRuntime is not initialized");
         return this.store;
     }
     assert_available() {
         if (this.disposed)
-            throw new Error("GroupDispatchSession is disposed");
+            throw new Error("GroupDispatchRuntime is disposed");
         if (this.stopping)
-            throw new Error("GroupDispatchSession is stopping");
+            throw new Error("GroupDispatchRuntime is stopping");
     }
 }
-//# sourceMappingURL=GroupDispatchSession.js.map
+/** 在持久化和执行之前统一校验自定义策略与 AI 策略的调度结果。 */
+function normalize_dispatch_decision(decision, members) {
+    if (typeof decision?.reason !== "string")
+        throw new Error("Group dispatch requires a reason");
+    const reason = decision.reason.trim();
+    if (!reason)
+        throw new Error("Group dispatch requires a non-empty reason");
+    if (!Array.isArray(decision.stages))
+        throw new Error("Group dispatch requires stages");
+    if (typeof decision.terminal !== "boolean")
+        throw new Error("Group dispatch requires terminal");
+    if (decision.stages.length === 0 && !decision.terminal) {
+        throw new Error("Group dispatch cannot continue without any stage");
+    }
+    const valid_member_ids = new Set(members.map((member) => member.agent_id));
+    const stage_ids = new Set();
+    const stages = decision.stages.map((stage) => {
+        if (typeof stage?.stage_id !== "string") {
+            throw new Error("Group dispatch requires a stage_id");
+        }
+        const stage_id = stage.stage_id.trim();
+        if (!stage_id)
+            throw new Error("Group dispatch requires a non-empty stage_id");
+        if (stage_ids.has(stage_id))
+            throw new Error(`Group dispatch contains duplicate stage "${stage_id}"`);
+        stage_ids.add(stage_id);
+        if (!Array.isArray(stage.assignments) || stage.assignments.length === 0) {
+            throw new Error(`Group dispatch stage "${stage_id}" requires assignments`);
+        }
+        const selected_member_ids = new Set();
+        const assignments = stage.assignments.map((assignment) => {
+            if (typeof assignment?.member_id !== "string") {
+                throw new Error(`Group dispatch stage "${stage_id}" requires assignment member_id`);
+            }
+            const member_id = assignment.member_id.trim();
+            if (!valid_member_ids.has(member_id)) {
+                throw new Error(`Group dispatch selected unknown member: ${member_id}`);
+            }
+            if (selected_member_ids.has(member_id)) {
+                throw new Error(`Group dispatch selected member more than once in stage "${stage_id}"`);
+            }
+            selected_member_ids.add(member_id);
+            if (typeof assignment.instruction !== "string") {
+                throw new Error(`Group dispatch assignment for "${member_id}" requires an instruction`);
+            }
+            const instruction = assignment.instruction.trim();
+            if (!instruction) {
+                throw new Error(`Group dispatch assignment for "${member_id}" requires an instruction`);
+            }
+            return { member_id, instruction };
+        });
+        return { stage_id, assignments };
+    });
+    return { reason, stages, terminal: decision.terminal };
+}
+//# sourceMappingURL=GroupDispatchRuntime.js.map

package/bin/group/GroupDispatchRuntime.js.map

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

package/bin/group/GroupSession.d.ts

@@ -3,9 +3,9 @@ import type { Agent } from "../agent/Agent.js";
 import type { GroupMessage } from "../types/group/Group.js";
 import type { GroupEventSubscriber, GroupEventUnsubscribe, GroupPromptInput, GroupPromptResult, GroupSessionContract } from "../types/group/GroupSession.js";
 import type { DispatchStrategy } from "../types/group/DispatchStrategy.js";
-import type { WorkspaceBase } from "@downcity/workspace";
+import type { ModelClient, WorkspaceRuntime } from "@downcity/type";
 import type { GroupSessionDataStore } from "../types/group/GroupSessionStore.js";
-import type { RespondSessionInteractionInput } from "../types/session/SessionInteraction.js";
+import type { RespondSessionInteractionInput } from "@downcity/type";
 /** GroupSession 的创建依赖。 */
 export interface GroupSessionOptions {
     /** 当前群聊上下文的稳定标识。 */
@@ -16,12 +16,14 @@ export interface GroupSessionOptions {
     readonly group_name: string;
     /** Group 协作说明。 */
     readonly instruction?: string;
+    /** GroupSession 用于生成标题的 Group 模型。 */
+    readonly model?: ModelClient;
     /** Group 成员。 */
     readonly members: readonly Agent[];
     /** Group 消息调度策略。 */
     readonly dispatch_strategy: DispatchStrategy;
     /** Group 为成员执行提供的共享 Workspace。 */
-    readonly workspace?: WorkspaceBase;
+    readonly workspace?: WorkspaceRuntime;
 }
 /** Group 的一个独立群聊上下文。 */
 export declare class GroupSession implements GroupSessionContract {
@@ -30,8 +32,10 @@ export declare class GroupSession implements GroupSessionContract {
     readonly workspace_id?: string;
     private readonly group_name;
     private readonly instruction?;
+    private readonly model?;
     private readonly members;
-    private readonly dispatch_session;
+    private readonly dispatch_runtime;
+    private readonly title_task;
     private readonly workspace?;
     private readonly messages_by_id;
     private readonly subscribers;
@@ -52,11 +56,14 @@ export declare class GroupSession implements GroupSessionContract {
     private auto_dispatch_requested;
     private stop_requested;
     private disposed;
+    private metadata_mutation_chain;
     constructor(options: GroupSessionOptions);
     /** 从持久化 Store 初始化当前 GroupSession 的消息历史。 */
     initialize(store: GroupSessionDataStore): Promise<this>;
     /** 立即追加用户消息，并异步触发本条消息的初始调度。 */
     prompt(input: GroupPromptInput): Promise<GroupPromptResult>;
+    /** 修改当前 GroupSession 的 canonical 用户可见标题。 */
+    rename(input: string): Promise<string>;
     /** 读取共享消息快照。 */
     messages(): Promise<readonly GroupMessage[]>;
     /** 订阅未来共享消息。 */
@@ -75,9 +82,10 @@ export declare class GroupSession implements GroupSessionContract {
     private request_auto_dispatch;
     private run_auto_dispatch;
     private decide_dispatch;
-    /** 执行当前响应图；节点依赖只影响投递顺序，不创建额外的调度循环。 */
+    /** 顺序执行有限阶段计划；任一阶段没有有效输出时不再执行后续阶段。 */
     private run_dispatch_plan;
-    private execute_dispatch_node;
+    /** 并行执行一个阶段内的成员专属任务。 */
+    private execute_dispatch_stage;
     /** 将消息提交给成员 Session，并返回已经接受的 Turn 句柄。 */
     private prepare_member_delivery;
     /** 等待成员 Turn 完成，并把有效回复写回 Group。 */
@@ -89,12 +97,18 @@ export declare class GroupSession implements GroupSessionContract {
     private ensure_member_session;
     /** 创建并登记一个成员专属的 AgentSession。 */
     private create_member_session;
+    /** 校验恢复的成员 Session 确实属于当前 GroupSession。 */
+    private assert_member_session_origin;
     private subscribe_member_session;
     private build_member_context;
     private get_member;
     /** 更新成员运行计数，并在可见状态发生变化时通知订阅者。 */
     private set_member_running;
     private append_message;
+    /** 基于首条用户消息异步生成标题，不阻塞 Group 调度主链路。 */
+    private schedule_title_generation;
+    /** 串行提交 GroupSession metadata，避免后台标题覆盖手动重命名。 */
+    private run_metadata_mutation;
     /** 持久化当前调度检查点；只记录可由消息事实安全恢复的状态。 */
     private persist_dispatch_checkpoint;
     /** 发布 Group 阶段和成员运行态；所有状态与消息共用同一订阅流。 */

package/bin/group/GroupSession.d.ts.map

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