@downcity/agent 1.1.338 → 1.1.400

package/bin/types/group/DispatchStrategy.js

@@ -0,0 +1,93 @@
+/** Group 调度策略：为当前消息上下文生成一组有依赖关系的成员投递节点。 */
+import { generate_model } from "../../executor/model/ModelGenerate.js";
+import { z } from "zod";
+/** AI 调度工具的最小输入协议；外层阶段串行，阶段内成员并行。 */
+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 继续判断。 */
+    next: z.enum(["stop", "continue"]),
+});
+/** 使用 Group.model 理解群聊意图并通过内部 tool call 生成成员投递决定。 */
+export class AiDispatchStrategy {
+    model;
+    constructor(options = {}) {
+        this.model = options.model;
+    }
+    async decide_dispatch(input) {
+        if (!this.model) {
+            throw new Error("Group requires a configured model for dispatch");
+        }
+        try {
+            const result = await generate_model(this.model, {
+                messages: [
+                    { role: "system", content: [{ type: "text", text: "你是群聊消息调度器。你只能调用 dispatch_group，不回答用户问题。普通任务默认只选择一个最合适的成员；只有用户明确要求多人分别回答，或确实存在并行的独立工作时，才把多个成员放在同一阶段。外层 steps 阶段按顺序执行，后一个阶段等待前一个阶段完成。只有真实存在的成员才能被选择。" }] },
+                    { role: "user", content: [{ type: "text", text: build_dispatch_prompt(input) }] },
+                ],
+                tools: [{
+                        name: "dispatch_group",
+                        description: "提交当前 Group 的成员投递路径。只调用一次；不要输出普通文本。没有成员需要回复时使用空 steps 和 next=stop。",
+                        input_schema: z.toJSONSchema(dispatch_group_input_schema),
+                    }],
+                tool_choice: { type: "tool", tool_name: "dispatch_group" },
+                max_output_tokens: 600,
+                reasoning: { enabled: false },
+            });
+            if (result.tool_calls.length !== 1 || result.tool_calls[0]?.tool_name !== "dispatch_group") {
+                throw new Error("Group dispatch model did not call dispatch_group");
+            }
+            return normalize_dispatch_tool_input(result.tool_calls[0].input, input.members);
+        }
+        catch (error) {
+            const detail = error instanceof Error ? error.message : String(error);
+            throw new Error(`Group dispatch model failed: ${detail}`, { cause: error });
+        }
+    }
+}
+/** 为 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");
+    return [
+        "成员：",
+        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。不要输出普通文本。",
+    ].join("\n");
+}
+/** 将 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}`);
+            }
+        }
+        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 上下文判断是否需要回复，只代表自己发言；不需要时返回空内容。",
+        };
+    });
+    if (nodes.length === 0 && parsed.next === "continue") {
+        throw new Error("Group dispatch cannot continue without any member step");
+    }
+    return {
+        nodes,
+        terminal: parsed.next === "stop",
+    };
+}
+//# sourceMappingURL=DispatchStrategy.js.map

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

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

@@ -0,0 +1,61 @@
+/** 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";
+/** 创建 Group 的参数。 */
+export interface GroupOptions {
+    /** Group 的稳定标识。 */
+    readonly id: string;
+    /** Group 的展示名称；省略时使用 id。 */
+    readonly name?: string;
+    /** Group 的可选协作说明。 */
+    readonly instruction?: string;
+    /** Group 用于理解群聊意图并选择投递成员的模型。 */
+    readonly model?: AgentModel;
+    /** Group 成员列表。 */
+    readonly members: readonly Agent[];
+    /** Group 的消息调度策略；省略时使用 Group.model 驱动的 AI 调度。 */
+    readonly dispatch_strategy?: DispatchStrategy;
+}
+/** Group 中的一条共享消息。 */
+export interface GroupMessage {
+    /** 消息稳定标识。 */
+    readonly id: string;
+    /** 所属 Group 标识。 */
+    readonly group_id: string;
+    /** 消息发送者标识；用户消息使用 user，系统消息使用 system。 */
+    readonly sender_id: string;
+    /** 消息发送者类型。 */
+    readonly sender_type: "user" | "agent" | "system";
+    /** 消息正文。 */
+    readonly text: string;
+    /** 可选的被回复消息标识。 */
+    readonly reply_to?: string;
+    /** 可选的用户 GroupTurn 标识；同一用户请求产生的消息共享此标识。 */
+    readonly turn_id?: string;
+    /** 可选的自动调度运行标识；自动调度产生的消息使用此标识。 */
+    readonly dispatch_id?: string;
+    /** 可选的响应图节点标识。 */
+    readonly dispatch_node_id?: string;
+    /** 创建时间的 Unix 毫秒时间戳。 */
+    readonly created_at: number;
+}
+/** Group 公开能力。 */
+export interface GroupContract {
+    /** Group 的稳定标识。 */
+    readonly id: string;
+    /** Group 的展示名称。 */
+    readonly name: string;
+    /** Group 的协作说明。 */
+    readonly instruction?: string;
+    /** Group 用于理解群聊意图并生成成员投递图的模型；未提供时首次调度会失败。 */
+    readonly model?: AgentModel;
+    /** Group 成员快照。 */
+    readonly members: readonly Agent[];
+    /** Group 使用的消息调度策略。 */
+    readonly dispatch_strategy: DispatchStrategy;
+    /** 当前 Group 创建的独立群聊上下文集合。 */
+    readonly sessions: GroupSessions;
+}
+//# sourceMappingURL=Group.d.ts.map

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

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

package/bin/types/group/Group.js

@@ -0,0 +1,3 @@
+/** Group 的公开领域类型：Group 是持续存在的群聊主体。 */
+export {};
+//# sourceMappingURL=Group.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"Group.js","sourceRoot":"","sources":["../../../src/types/group/Group.ts"],"names":[],"mappings":"AAAA,sCAAsC"}

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

@@ -0,0 +1,149 @@
+/** GroupSession 的公开领域类型：一次 Group 的独立群聊上下文。 */
+import type { AgentSession } from "../agent/SessionActor.js";
+import type { GroupMessage } from "./Group.js";
+import type { Agent } from "../../agent/Agent.js";
+import type { WorkspaceBase } from "@downcity/workspace";
+import type { RespondSessionInteractionInput, SessionInteractionRequest } from "../session/SessionInteraction.js";
+/** Group 成员运行态。 */
+export interface GroupMemberRuntime {
+    /** 成员 Agent 标识。 */
+    readonly agent_id: string;
+    /** 当前是否正在执行。 */
+    readonly running: boolean;
+}
+/** Group 运行阶段。 */
+export type GroupStatusPhase = "idle" | "dispatching" | "dispatched" | "executing" | "stopped" | "failed";
+/** GroupSession 的统一实时事件。 */
+export type GroupEvent = {
+    readonly type: "message"; /** 新增的共享消息。 */
+    readonly message: GroupMessage;
+} | {
+    readonly type: "interaction"; /** 发起交互的成员 Agent。 */
+    readonly agent_id: string; /** 成员 Session 的交互请求。 */
+    readonly request: SessionInteractionRequest;
+} | {
+    readonly type: "status"; /** 当前群聊轮次。 */
+    readonly turn_id?: string; /** 当前轮次对应的消息标识。 */
+    readonly message_id?: string; /** 当前运行阶段。 */
+    readonly phase: GroupStatusPhase; /** Dispatch 完成后实际接受消息的成员标识。 */
+    readonly dispatched_member_ids?: readonly string[]; /** 成员运行态快照。 */
+    readonly members: readonly GroupMemberRuntime[];
+};
+/** Group 事件订阅回调。 */
+export type GroupEventSubscriber = (event: GroupEvent) => void | Promise<void>;
+/** 取消 Group 消息订阅。 */
+export type GroupEventUnsubscribe = () => void;
+/** GroupSession 接收一条用户消息后的异步调度回执。 */
+export interface GroupPromptResult {
+    /** 当前用户消息对应的 GroupTurn 标识。 */
+    readonly turn_id: string;
+    /** 用户消息是否已经成功写入并开始调度；不代表成员已经完成回复。 */
+    readonly success: boolean;
+    /** 回执生成时共享消息总数。 */
+    readonly message_count: number;
+}
+/** 向 GroupSession 发言的输入。 */
+export interface GroupPromptInput {
+    /** 用户消息正文。 */
+    readonly query: string;
+}
+/** GroupSession 列表使用的轻量摘要，不加载消息历史。 */
+export interface GroupSessionSummary {
+    /** GroupSession 稳定标识。 */
+    readonly id: string;
+    /** 所属 Group 稳定标识。 */
+    readonly group_id: string;
+    /** 首次创建时间戳。 */
+    readonly created_at: number;
+    /** 最近更新时间戳。 */
+    readonly updated_at: number;
+    /** 已持久化消息数量。 */
+    readonly message_count: number;
+    /** 当前 GroupSession 绑定的 Workspace 标识。 */
+    readonly workspace_id?: string;
+    /** 最后一条消息的用户可见预览。 */
+    readonly preview_text?: string;
+}
+/** GroupSession 的创建输入；第一阶段不允许调用方指定 session_id。 */
+export interface GroupSessionCreateInput {
+    /** 当前群聊使用的 Workspace；省略时使用内存执行上下文。 */
+    readonly workspace?: WorkspaceBase;
+}
+/** 恢复 GroupSession 时的上下文输入。 */
+export interface GroupSessionGetInput {
+    /** 当前群聊使用的 Workspace；必须与持久化 metadata 一致。 */
+    readonly workspace?: WorkspaceBase;
+}
+/** GroupSession 列表过滤条件。 */
+export interface GroupSessionListInput {
+    /** 只返回绑定到指定 Workspace 的群聊上下文。 */
+    readonly workspace_id?: string;
+}
+/** GroupSession 公开能力。 */
+export interface GroupSessionContract {
+    /** 当前群聊上下文的稳定标识。 */
+    readonly id: string;
+    /** 所属 Group 的稳定标识。 */
+    readonly group_id: string;
+    /** 当前 GroupSession 绑定的 Workspace ID；未绑定时为空。 */
+    readonly workspace_id?: string;
+    /** 立即追加用户消息并开始异步群聊调度。 */
+    prompt(input: GroupPromptInput): Promise<GroupPromptResult>;
+    /** 读取共享消息事实快照。 */
+    messages(): Promise<readonly GroupMessage[]>;
+    /** 订阅共享消息。 */
+    subscribe(subscriber: GroupEventSubscriber): GroupEventUnsubscribe;
+    /** 响应成员 Agent Session 当前等待的 Interaction。 */
+    respond_interaction(input: RespondSessionInteractionInput): Promise<void>;
+    /** 停止当前传播和成员执行；停止完成后可再次 prompt。 */
+    stop(): Promise<void>;
+    /** 释放当前上下文，不再接受新的 prompt。 */
+    dispose(): Promise<void>;
+}
+/** GroupSession 的公开实例类型。 */
+export interface GroupSession extends GroupSessionContract {
+}
+/** GroupSession 集合公开能力。 */
+export interface GroupSessions {
+    /** 创建一个新的群聊上下文，标识由集合内部生成。 */
+    create(input?: GroupSessionCreateInput): Promise<GroupSession>;
+    /** 从 Storage 恢复当前 Group 的一个群聊上下文。 */
+    get(session_id: string, input?: GroupSessionGetInput): Promise<GroupSession | null>;
+    /** 从 Storage 恢复当前 Group 的全部群聊上下文。 */
+    list(input?: GroupSessionListInput): Promise<readonly GroupSessionSummary[]>;
+    /** 释放并移除指定群聊上下文。 */
+    remove(session_id: string, input?: GroupSessionGetInput): Promise<GroupSession | null>;
+}
+/** GroupSession 的内部依赖快照。 */
+export interface GroupSessionRuntimeContext {
+    /** 当前 Group 的成员。 */
+    readonly members: readonly Agent[];
+    /** 当前 Group 的协作说明。 */
+    readonly instruction?: string;
+    /** 当前 Group 的消息调度策略。 */
+    readonly dispatch_strategy: import("./DispatchStrategy.js").DispatchStrategy;
+    /** 当前 Group 的稳定标识。 */
+    readonly group_id: string;
+    /** 当前 Group 的展示名称。 */
+    readonly group_name: string;
+}
+/** 当前群聊上下文中由 Agent 持有的成员 Session。 */
+export type GroupMemberSession = AgentSession;
+/** GroupSession 内部维护的一次用户请求运行记录。 */
+export interface GroupTurnRuntime {
+    /** 用户请求对应的 GroupTurn 标识。 */
+    readonly turn_id: string;
+    /** 用户根消息标识。 */
+    readonly root_message_id: string;
+    /** 用户消息写入时冻结的上下文消息标识。 */
+    readonly context_message_ids: readonly string[];
+    /** 当前 GroupTurn 的异步 user dispatch。 */
+    user_dispatch?: Promise<void>;
+    /** 当前 GroupTurn 是否等待 GroupSession 的 auto dispatch。 */
+    auto_pending: boolean;
+    /** 当前 GroupTurn 是否已经停止或失败。 */
+    stopped: boolean;
+    /** 当前 GroupTurn 是否由持久化检查点恢复，只等待统一 auto dispatch 收口。 */
+    readonly recovered?: boolean;
+}
+//# sourceMappingURL=GroupSession.d.ts.map

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

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

package/bin/types/group/GroupSession.js

@@ -0,0 +1,3 @@
+/** GroupSession 的公开领域类型：一次 Group 的独立群聊上下文。 */
+export {};
+//# sourceMappingURL=GroupSession.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GroupSession.js","sourceRoot":"","sources":["../../../src/types/group/GroupSession.ts"],"names":[],"mappings":"AAAA,8CAA8C"}

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

@@ -0,0 +1,77 @@
+/** GroupSession 持久化协议：只描述 GroupSession 所需的底层数据能力。 */
+import type { GroupMessage } from "./Group.js";
+import type { FileSystem } from "@downcity/workspace";
+/** GroupSession 的持久化元数据。 */
+export interface GroupSessionHistoryMeta {
+    /** metadata schema 版本。 */
+    readonly v: 1;
+    /** 当前 GroupSession 标识。 */
+    readonly session_id: string;
+    /** 所属 Group 标识。 */
+    readonly group_id: string;
+    /** 当前 GroupSession 绑定的 Workspace 标识；未绑定时为空。 */
+    readonly workspace_id?: string;
+    /** 首次创建时间戳。 */
+    readonly created_at: number;
+    /** 最近更新时间戳。 */
+    readonly updated_at: number;
+    /** 已持久化消息数量。 */
+    readonly message_count: number;
+    /** 最后一条消息的用户可见预览。 */
+    readonly preview_text?: string;
+    /** GroupSession 为每个成员 Agent 复用的 AgentSession 标识。 */
+    readonly member_session_ids?: Readonly<Record<string, string>>;
+    /** 尚未完成收口的 GroupTurn 检查点；进程重启后仅据此恢复 auto dispatch。 */
+    readonly pending_turns?: readonly GroupSessionTurnCheckpoint[];
+    /** 进程中断前尚未消费的 auto dispatch frontier 消息标识。 */
+    readonly auto_frontier_message_ids?: readonly string[];
+}
+/** GroupSession 可恢复的最小运行检查点。 */
+export interface GroupSessionTurnCheckpoint {
+    /** 用户请求对应的 GroupTurn 标识。 */
+    readonly turn_id: string;
+    /** 用户根消息标识。 */
+    readonly root_message_id: string;
+    /** 用户消息写入时冻结的上下文消息标识。 */
+    readonly context_message_ids: readonly string[];
+}
+/** 单个 GroupSession 的持久化数据视图。 */
+export interface GroupSessionDataStore {
+    /** 当前 GroupSession 标识。 */
+    readonly session_id: string;
+    /** 初始化当前 GroupSession 的存储布局。 */
+    initialize(): Promise<void>;
+    /** 读取完整共享消息历史。 */
+    list_messages(): Promise<GroupMessage[]>;
+    /** 追加一条消息并同步更新 metadata。 */
+    append_message(message: GroupMessage): Promise<void>;
+    /** 读取当前 GroupSession metadata。 */
+    read_metadata(): Promise<GroupSessionHistoryMeta>;
+    /** 写入当前 GroupSession metadata。 */
+    write_metadata(metadata: GroupSessionHistoryMeta): Promise<void>;
+    /** 在文件锁内合并更新当前 GroupSession metadata。 */
+    update_metadata(patch: Partial<GroupSessionHistoryMeta>): Promise<GroupSessionHistoryMeta>;
+}
+/** Group 所拥有的全部 GroupSession 持久化入口。 */
+export interface GroupSessionStore {
+    /** 返回指定 GroupSession 的持久化视图。 */
+    session(session_id: string): GroupSessionDataStore;
+    /** 判断指定 GroupSession 是否存在。 */
+    has_session(session_id: string): Promise<boolean>;
+    /** 列出当前 Group 的持久化 Session metadata。 */
+    list_session_metadata(): Promise<GroupSessionHistoryMeta[]>;
+    /** 删除指定 GroupSession 的全部数据。 */
+    remove_session(session_id: string): Promise<boolean>;
+    /** 释放当前 Store 持有的资源。 */
+    dispose(): Promise<void>;
+}
+/** 创建基于 City StorageScope 的 GroupSession Store。 */
+export interface GroupSessionStoreOptions {
+    /** City StorageScope 提供的受控文件能力。 */
+    readonly files: FileSystem;
+    /** 当前 Group 的存储作用域根目录。 */
+    readonly storage_root_path: string;
+    /** 当前 Group 稳定标识。 */
+    readonly group_id: string;
+}
+//# sourceMappingURL=GroupSessionStore.d.ts.map

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

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

package/bin/types/group/GroupSessionStore.js

@@ -0,0 +1,3 @@
+/** GroupSession 持久化协议：只描述 GroupSession 所需的底层数据能力。 */
+export {};
+//# sourceMappingURL=GroupSessionStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"GroupSessionStore.js","sourceRoot":"","sources":["../../../src/types/group/GroupSessionStore.ts"],"names":[],"mappings":"AAAA,qDAAqD"}

package/bin/types/plugin/AgentPluginContext.d.ts

@@ -0,0 +1,25 @@
+/**
+ * AgentPluginContext：Plugin 在 Agent 级生命周期中可访问的最小能力。
+ *
+ * 边界说明（中文）
+ * - 该上下文不包含 Workspace，避免 Agent 级资源意外绑定第一个项目。
+ * - 该上下文不暴露完整 City，只暴露宿主明确注入的 Embassy 能力。
+ * - Plugin 是否需要 Agent 级生命周期，由 Plugin 自己是否实现 start/stop 决定。
+ */
+import type { Logger } from "../../utils/logger/Logger.js";
+import type { PluginWebServices } from "./PluginServices.js";
+import type { Embassy } from "@downcity/federation";
+/** Plugin 的 Agent 级生命周期上下文。 */
+export interface AgentPluginContext {
+    /** 当前 Agent 的稳定标识。 */
+    readonly agent_id: string;
+    /** 当前 Agent 的全局日志器，不绑定任何 Workspace 文件系统。 */
+    readonly logger: Logger;
+    /** 当前 Agent 持有的 Web 搜索与文档能力。 */
+    readonly web?: PluginWebServices;
+    /** City 注入的 Embassy 能力；Agent 未加入 City 时为空。 */
+    readonly embassy?: Embassy;
+    /** 动态读取当前 Agent 静态指令的只读快照。 */
+    readonly instructions: readonly string[];
+}
+//# sourceMappingURL=AgentPluginContext.d.ts.map

package/bin/types/plugin/AgentPluginContext.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPluginContext.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/AgentPluginContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAC;AACvD,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,kCAAkC,CAAC;AAC1E,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,sBAAsB,CAAC;AAEpD,+BAA+B;AAC/B,MAAM,WAAW,kBAAkB;IACjC,sBAAsB;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAE1B,4CAA4C;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAExB,gCAAgC;IAChC,QAAQ,CAAC,GAAG,CAAC,EAAE,iBAAiB,CAAC;IAEjC,8CAA8C;IAC9C,QAAQ,CAAC,OAAO,CAAC,EAAE,OAAO,CAAC;IAE3B,8BAA8B;IAC9B,QAAQ,CAAC,YAAY,EAAE,SAAS,MAAM,EAAE,CAAC;CAC1C"}

package/bin/types/plugin/AgentPluginContext.js

@@ -0,0 +1,10 @@
+/**
+ * AgentPluginContext：Plugin 在 Agent 级生命周期中可访问的最小能力。
+ *
+ * 边界说明（中文）
+ * - 该上下文不包含 Workspace，避免 Agent 级资源意外绑定第一个项目。
+ * - 该上下文不暴露完整 City，只暴露宿主明确注入的 Embassy 能力。
+ * - Plugin 是否需要 Agent 级生命周期，由 Plugin 自己是否实现 start/stop 决定。
+ */
+export {};
+//# sourceMappingURL=AgentPluginContext.js.map

package/bin/types/plugin/AgentPluginContext.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"AgentPluginContext.js","sourceRoot":"","sources":["../../../src/types/plugin/AgentPluginContext.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/types/plugin/PluginAction.d.ts

@@ -8,10 +8,10 @@
 import type { Command } from "commander";
 import type { Context as HonoContext } from "hono";
 import type { z } from "zod";
-import type { PluginContext } from "../../types/plugin/PluginContext.js";
-import type { PluginExecutionContext } from "../../types/plugin/PluginExecutionContext.js";
-import type { JsonObject, JsonValue } from "../../types/common/Json.js";
-import type { ActionResultMessage } from "../../types/action/ActionResult.js";
+import type { PluginContext } from "./PluginContext.js";
+import type { PluginActionExecutionContext } from "./PluginActionExecution.js";
+import type { JsonObject, JsonValue } from "../common/Json.js";
+import type { ActionResultMessage } from "../action/ActionResult.js";
 /**
  * Plugin action 调用参数。
  */
@@ -121,6 +121,8 @@ export interface PluginActionMetadata<P extends JsonValue = JsonValue> {
     input_schema?: PluginActionInputSchema<P>;
     /** Action 调用示例。 */
     examples?: PluginActionExample<P>[];
+    /** Action 的协作式超时上限（毫秒）；Action 必须监听 execution.abort_signal。 */
+    timeout_ms?: number;
 }
 /**
  * Plugin Action 定义。
@@ -132,16 +134,16 @@ export interface PluginAction<P extends JsonValue = JsonValue, R extends JsonVal
     api?: PluginActionApi<P>;
     /** Action 执行器。 */
     execute: (params: {
-        /** 当前执行上下文。 */
+        /** WorkspaceEntry 创建的稳定 Plugin 能力视图。 */
         context: PluginContext;
         /**
          * 当前 action 所属 Session Turn 的只读 Plugin 执行快照。
          *
          * 关键点（中文）
-         * - 模型 tool 调用时必定提供。
-         * - CLI、HTTP 或定时任务等非 Session 入口可能不提供。
+         * - 模型 tool 调用复用对应 tool call ID 和 Turn 取消信号。
+         * - CLI、HTTP 与定时任务等非 Session 入口由 Registry 补齐调用身份和取消信号。
          */
-        execution_context?: PluginExecutionContext;
+        execution: PluginActionExecutionContext;
         /** 已通过 schema 校验后的输入。 */
         input: P;
         /** 当前插件名称。 */

package/bin/types/plugin/PluginAction.d.ts.map

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

package/bin/types/plugin/PluginActionExecution.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Plugin Action 单次执行上下文。
+ *
+ * 关键点（中文）
+ * - 每次 Action 调用都获得独立、只读的身份与取消快照。
+ * - Agent 与 Workspace 的稳定身份只保留在 PluginContext，不复制到单次执行对象。
+ * - Session 字段来自可选的 PluginExecutionContext；HTTP、CLI 与 Schedule 调用可以没有 Session。
+ */
+import type { PluginExecutionContext } from "./PluginExecutionContext.js";
+import type { SessionInteractionPort } from "../session/SessionInteraction.js";
+/** 当前 Action 所属 Session 的执行范围。 */
+export interface PluginSessionExecutionScope {
+    /** 当前 Session 标识。 */
+    readonly session_id: string;
+    /** 当前 Turn 标识。 */
+    readonly turn_id: string;
+    /** 当前 Session 的用户交互端口；当前入口未开放交互能力时为空。 */
+    readonly interactions?: SessionInteractionPort;
+}
+/** Plugin Action 执行器传给业务 Action 的完整只读上下文。 */
+export interface PluginActionExecutionContext {
+    /** 当前 Action 调用的稳定标识；模型 Tool 调用时等于对应 tool call ID。 */
+    readonly call_id: string;
+    /** 当前 Action 必须监听的取消信号；可同时承载 Turn 取消和 Action 超时。 */
+    readonly abort_signal: AbortSignal;
+    /** 当前调用所属的 Session；非 Session 入口时为空。 */
+    readonly session?: PluginSessionExecutionScope;
+    /** 当前调用开始时捕获的只读 Step 快照。 */
+    readonly snapshot: PluginExecutionContext;
+}
+//# sourceMappingURL=PluginActionExecution.d.ts.map

package/bin/types/plugin/PluginActionExecution.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginActionExecution.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginActionExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,0CAA0C,CAAC;AACvF,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,uCAAuC,CAAC;AAEpF,kCAAkC;AAClC,MAAM,WAAW,2BAA2B;IAC1C,qBAAqB;IACrB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,kBAAkB;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,yCAAyC;IACzC,QAAQ,CAAC,YAAY,CAAC,EAAE,sBAAsB,CAAC;CAChD;AAED,6CAA6C;AAC7C,MAAM,WAAW,4BAA4B;IAC3C,sDAAsD;IACtD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IAEzB,oDAAoD;IACpD,QAAQ,CAAC,YAAY,EAAE,WAAW,CAAC;IAEnC,uCAAuC;IACvC,QAAQ,CAAC,OAAO,CAAC,EAAE,2BAA2B,CAAC;IAE/C,4BAA4B;IAC5B,QAAQ,CAAC,QAAQ,EAAE,sBAAsB,CAAC;CAC3C"}

package/bin/types/plugin/PluginActionExecution.js

@@ -0,0 +1,10 @@
+/**
+ * Plugin Action 单次执行上下文。
+ *
+ * 关键点（中文）
+ * - 每次 Action 调用都获得独立、只读的身份与取消快照。
+ * - Agent 与 Workspace 的稳定身份只保留在 PluginContext，不复制到单次执行对象。
+ * - Session 字段来自可选的 PluginExecutionContext；HTTP、CLI 与 Schedule 调用可以没有 Session。
+ */
+export {};
+//# sourceMappingURL=PluginActionExecution.js.map

package/bin/types/plugin/PluginActionExecution.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"PluginActionExecution.js","sourceRoot":"","sources":["../../../src/types/plugin/PluginActionExecution.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/bin/types/plugin/PluginCommand.d.ts

@@ -3,12 +3,12 @@
  *
  * 关键点（中文）：生命周期只负责启动和停止；所有显式能力调用统一使用 Action。
  */
-import type { PluginContext } from "../../types/plugin/PluginContext.js";
+import type { AgentPluginContext } from "./AgentPluginContext.js";
 /** Plugin 生命周期定义。 */
 export interface PluginLifecycle {
-    /** Plugin 启动钩子。 */
-    start?(context: PluginContext): Promise<void> | void;
-    /** Plugin 停止钩子。 */
-    stop?(context: PluginContext): Promise<void> | void;
+    /** Plugin 随 Agent 启动的钩子；不得假设存在 Workspace。 */
+    start?(context: AgentPluginContext): Promise<void> | void;
+    /** Plugin 随 Agent 停止的钩子。 */
+    stop?(context: AgentPluginContext): Promise<void> | void;
 }
 //# sourceMappingURL=PluginCommand.d.ts.map

package/bin/types/plugin/PluginCommand.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"PluginCommand.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,qBAAqB;AACrB,MAAM,WAAW,eAAe;IAC9B,mBAAmB;IACnB,KAAK,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IACrD,mBAAmB;IACnB,IAAI,CAAC,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CACrD"}
+{"version":3,"file":"PluginCommand.d.ts","sourceRoot":"","sources":["../../../src/types/plugin/PluginCommand.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sCAAsC,CAAC;AAE/E,qBAAqB;AACrB,MAAM,WAAW,eAAe;IAC9B,6CAA6C;IAC7C,KAAK,CAAC,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;IAC1D,4BAA4B;IAC5B,IAAI,CAAC,CAAC,OAAO,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC;CAC1D"}