@downcity/agent 1.1.338 → 1.1.400

package/bin/group/Group.js

@@ -0,0 +1,42 @@
+/** Group 群聊主体的本地实现。 */
+import { AiDispatchStrategy } from "../types/group/DispatchStrategy.js";
+import { GroupSessions } from "./GroupSessions.js";
+import { dispose_group_runtime, initialize_group_runtime } from "../internal/GroupRuntime.js";
+/** Group 主体：只持有身份、成员、资源引用和群聊上下文集合。 */
+export class Group {
+    id;
+    name;
+    instruction;
+    model;
+    members;
+    dispatch_strategy;
+    sessions;
+    constructor(options) {
+        this.id = String(options.id || "").trim();
+        if (!this.id)
+            throw new Error("Group requires a non-empty id");
+        if (!options.members?.length)
+            throw new Error("Group requires at least one member");
+        const member_ids = new Set();
+        this.members = Object.freeze(options.members.map((member) => {
+            if (!member?.id)
+                throw new Error("Group member requires an Agent");
+            if (member_ids.has(member.id))
+                throw new Error(`Group member already exists: ${member.id}`);
+            member_ids.add(member.id);
+            return member;
+        }));
+        this.name = String(options.name || this.id).trim() || this.id;
+        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 所拥有的全部群聊上下文。 */
+    async dispose() {
+        await this.sessions.dispose();
+        await dispose_group_runtime(this);
+    }
+}
+//# sourceMappingURL=Group.js.map

package/bin/group/Group.js.map

@@ -0,0 +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"}

package/bin/group/GroupSession.d.ts

@@ -0,0 +1,103 @@
+/** GroupSession：一次 Group 群聊上下文的运行时实现。 */
+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 { GroupSessionDataStore } from "../types/group/GroupSessionStore.js";
+import type { RespondSessionInteractionInput } from "../types/session/SessionInteraction.js";
+/** GroupSession 的创建依赖。 */
+export interface GroupSessionOptions {
+    /** 当前群聊上下文的稳定标识。 */
+    readonly id: string;
+    /** 所属 Group 的稳定标识。 */
+    readonly group_id: string;
+    /** Group 展示名称。 */
+    readonly group_name: string;
+    /** Group 协作说明。 */
+    readonly instruction?: string;
+    /** Group 成员。 */
+    readonly members: readonly Agent[];
+    /** Group 消息调度策略。 */
+    readonly dispatch_strategy: DispatchStrategy;
+    /** Group 为成员执行提供的共享 Workspace。 */
+    readonly workspace?: WorkspaceBase;
+}
+/** Group 的一个独立群聊上下文。 */
+export declare class GroupSession implements GroupSessionContract {
+    readonly id: string;
+    readonly group_id: string;
+    readonly workspace_id?: string;
+    private readonly group_name;
+    private readonly instruction?;
+    private readonly members;
+    private readonly dispatch_strategy;
+    private readonly workspace?;
+    private readonly messages_by_id;
+    private readonly subscribers;
+    private readonly member_sessions;
+    private readonly member_session_ids;
+    private readonly member_session_promises;
+    private readonly member_session_unsubscribes;
+    private readonly interaction_sessions;
+    private readonly member_running_counts;
+    private readonly pending_deliveries;
+    private readonly active_member_deliveries;
+    private readonly group_turns_by_id;
+    private readonly consumed_auto_message_ids;
+    private readonly auto_dispatch_path_keys;
+    private auto_frontier_messages;
+    private store?;
+    private auto_dispatch_promise;
+    private auto_dispatch_requested;
+    private stop_requested;
+    private disposed;
+    constructor(options: GroupSessionOptions);
+    /** 从持久化 Store 初始化当前 GroupSession 的消息历史。 */
+    initialize(store: GroupSessionDataStore): Promise<this>;
+    /** 立即追加用户消息，并异步触发本条消息的初始调度。 */
+    prompt(input: GroupPromptInput): Promise<GroupPromptResult>;
+    /** 读取共享消息快照。 */
+    messages(): Promise<readonly GroupMessage[]>;
+    /** 订阅未来共享消息。 */
+    subscribe(subscriber: GroupEventSubscriber): GroupEventUnsubscribe;
+    respond_interaction(input: RespondSessionInteractionInput): Promise<void>;
+    /** 读取成员运行态快照；成员是否回复由成员自身决定。 */
+    private member_statuses;
+    /** 停止当前传播和成员执行。 */
+    stop(): Promise<void>;
+    /** 释放当前上下文及其成员 Session 引用。 */
+    dispose(): Promise<void>;
+    private run_user_dispatch;
+    /** GroupSession 唯一的自动调度循环，统一消费已完成成员产生的新消息。 */
+    private request_auto_dispatch;
+    private run_auto_dispatch;
+    private decide_dispatch;
+    /** 执行当前响应图；节点依赖只影响投递顺序，不创建额外的调度循环。 */
+    private run_dispatch_plan;
+    private execute_dispatch_node;
+    /** 将消息提交给成员 Session，并返回已经接受的 Turn 句柄。 */
+    private prepare_member_delivery;
+    /** 等待成员 Turn 完成，并把有效回复写回 Group。 */
+    private execute_member_delivery;
+    private append_dispatch_failure;
+    /** 把成员自身的投递或执行失败记录为共享事实，避免群聊静默。 */
+    private append_member_failure;
+    /** 获取或创建一个成员专属的 AgentSession。 */
+    private ensure_member_session;
+    /** 创建并登记一个成员专属的 AgentSession。 */
+    private create_member_session;
+    private subscribe_member_session;
+    private build_member_context;
+    private get_member;
+    /** 更新成员运行计数，并在可见状态发生变化时通知订阅者。 */
+    private set_member_running;
+    private append_message;
+    /** 持久化当前调度检查点；只记录可由消息事实安全恢复的状态。 */
+    private persist_dispatch_checkpoint;
+    /** 发布 Group 阶段和成员运行态；所有状态与消息共用同一订阅流。 */
+    private publish_status;
+    private publish_event;
+    private assert_available;
+}
+//# sourceMappingURL=GroupSession.d.ts.map

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

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