@downcity/agent 1.1.25 → 1.1.35

package/bin/plugin/builtins/chat/runtime/ChatSessionContextComposer.js

@@ -0,0 +1,60 @@
+/**
+ * ChatSessionContextComposer：chat 专用 context composer。
+ *
+ * 关键点（中文）
+ * - 由 chat 层在 Session 实例化时注入，不再依赖 run 时层层传 callback。
+ * - step 合并消息读取自 ChatSession 当前绑定的 turn context。
+ * - 其余能力（tools / fallback assistant）继续复用默认本地实现。
+ */
+import { drainInjectedUserMessages } from "../../../../executor/SessionRunScope.js";
+import { LocalSessionContextComposer } from "../../../../executor/composer/context/LocalSessionContextComposer.js";
+/**
+ * ChatSession 专用 context composer。
+ */
+export class ChatSessionContextComposer extends LocalSessionContextComposer {
+    getTurnState;
+    constructor(options) {
+        super({
+            sessionId: options.sessionId,
+            getTools: options.getTools,
+        });
+        this.getTurnState = options.getTurnState;
+    }
+    createPrepareStepHandler(input) {
+        return async ({ messages, }) => {
+            const injectedMessages = drainInjectedUserMessages();
+            const turnState = this.getTurnState();
+            const onStepCallback = turnState?.onStepCallback;
+            if (typeof onStepCallback !== "function" &&
+                injectedMessages.length === 0) {
+                return { system: input.system };
+            }
+            const incomingMessages = Array.isArray(messages)
+                ? messages
+                : [];
+            let outMessages;
+            try {
+                const mergedMessages = typeof onStepCallback === "function"
+                    ? await onStepCallback()
+                    : [];
+                const mergedWithInjected = [
+                    ...injectedMessages,
+                    ...(Array.isArray(mergedMessages) ? mergedMessages : []),
+                ];
+                const mergedModelMessages = await input.appendMergedUserMessages(mergedWithInjected);
+                if (mergedModelMessages.length > 0) {
+                    // 关键点（中文）：保持当前 step 顺序，仅把新增 chat user 消息追加到末尾。
+                    outMessages = [...incomingMessages, ...mergedModelMessages];
+                }
+            }
+            catch {
+                // ignore merge hook failures
+            }
+            return {
+                system: input.system,
+                ...(Array.isArray(outMessages) ? { messages: outMessages } : {}),
+            };
+        };
+    }
+}
+//# sourceMappingURL=ChatSessionContextComposer.js.map

package/bin/plugin/builtins/chat/runtime/ChatSessionContextComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionContextComposer.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatSessionContextComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,8BAA8B,CAAC;AACzE,OAAO,EAAE,2BAA2B,EAAE,MAAM,2DAA2D,CAAC;AAsBxG;;GAEG;AACH,MAAM,OAAO,0BAA2B,SAAQ,2BAA2B;IACxD,YAAY,CAAoD;IAEjF,YAAY,OAA0C;QACpD,KAAK,CAAC;YACJ,SAAS,EAAE,OAAO,CAAC,SAAS;YAC5B,QAAQ,EAAE,OAAO,CAAC,QAAQ;SAC3B,CAAC,CAAC;QACH,IAAI,CAAC,YAAY,GAAG,OAAO,CAAC,YAAY,CAAC;IAC3C,CAAC;IAED,wBAAwB,CACtB,KAKC;QAKD,OAAO,KAAK,EAAE,EACZ,QAAQ,GAGT,EAGE,EAAE;YACH,MAAM,gBAAgB,GAAG,yBAAyB,EAAE,CAAC;YACrD,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,EAAE,CAAC;YACtC,MAAM,cAAc,GAAG,SAAS,EAAE,cAAc,CAAC;YACjD,IACE,OAAO,cAAc,KAAK,UAAU;gBACpC,gBAAgB,CAAC,MAAM,KAAK,CAAC,EAC7B,CAAC;gBACD,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC;YAClC,CAAC;YAED,MAAM,gBAAgB,GAAmB,KAAK,CAAC,OAAO,CAAC,QAAQ,CAAC;gBAC9D,CAAC,CAAC,QAAQ;gBACV,CAAC,CAAC,EAAE,CAAC;YACP,IAAI,WAAuC,CAAC;YAC5C,IAAI,CAAC;gBACH,MAAM,cAAc,GAClB,OAAO,cAAc,KAAK,UAAU;oBAClC,CAAC,CAAC,MAAM,cAAc,EAAE;oBACxB,CAAC,CAAC,EAAE,CAAC;gBACT,MAAM,kBAAkB,GAAG;oBACzB,GAAG,gBAAgB;oBACnB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,cAAc,CAAC,CAAC,CAAC,EAAE,CAAC;iBACzD,CAAC;gBACF,MAAM,mBAAmB,GAAG,MAAM,KAAK,CAAC,wBAAwB,CAC9D,kBAAkB,CACnB,CAAC;gBACF,IAAI,mBAAmB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;oBACnC,+CAA+C;oBAC/C,WAAW,GAAG,CAAC,GAAG,gBAAgB,EAAE,GAAG,mBAAmB,CAAC,CAAC;gBAC9D,CAAC;YACH,CAAC;YAAC,MAAM,CAAC;gBACP,6BAA6B;YAC/B,CAAC;YACD,OAAO;gBACL,MAAM,EAAE,KAAK,CAAC,MAAM;gBACpB,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACjE,CAAC;QACJ,CAAC,CAAC;IACJ,CAAC;CACF"}

package/bin/plugin/builtins/chat/runtime/ChatSessionDelete.d.ts

@@ -0,0 +1,29 @@
+/**
+ * ChatSessionDelete：按 sessionId 彻底删除 chat 会话数据。
+ *
+ * 关键点（中文）
+ * - 删除路由映射（`.downcity/channel/meta.json`）
+ * - 删除 chat 审计目录（`.downcity/chat/<sessionId>/`）
+ * - 删除 core session 目录（`.downcity/agents/<agentId>/sessions/<sessionId>/`）
+ * - 清理运行中 agent 与队列，避免残留任务继续执行
+ */
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+/**
+ * 彻底删除一个 chat session。
+ *
+ * 关键点（中文）
+ * - 幂等：目标不存在时返回 success + deleted=false，避免上层重试复杂化。
+ */
+export declare function deleteChatSessionById(params: {
+    context: AgentContext;
+    sessionId: string;
+}): Promise<{
+    success: boolean;
+    sessionId: string;
+    deleted: boolean;
+    removedMeta: boolean;
+    removedChatDir: boolean;
+    removedSessionDir: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=ChatSessionDelete.d.ts.map

package/bin/plugin/builtins/chat/runtime/ChatSessionDelete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionDelete.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatSessionDelete.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAQhE;;;;;GAKG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,OAAO,CAAC;IACrB,cAAc,EAAE,OAAO,CAAC;IACxB,iBAAiB,EAAE,OAAO,CAAC;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;CAChB,CAAC,CAyDD"}

package/bin/plugin/builtins/chat/runtime/ChatSessionDelete.js

@@ -0,0 +1,76 @@
+/**
+ * ChatSessionDelete：按 sessionId 彻底删除 chat 会话数据。
+ *
+ * 关键点（中文）
+ * - 删除路由映射（`.downcity/channel/meta.json`）
+ * - 删除 chat 审计目录（`.downcity/chat/<sessionId>/`）
+ * - 删除 core session 目录（`.downcity/agents/<agentId>/sessions/<sessionId>/`）
+ * - 清理运行中 agent 与队列，避免残留任务继续执行
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { resolveChatQueueStore } from "../../../../plugin/builtins/chat/runtime/ChatQueue.js";
+import { removeChatMetaBySessionId } from "../../../../plugin/builtins/chat/runtime/ChatMetaStore.js";
+function normalizeSessionId(sessionId) {
+    return String(sessionId || "").trim();
+}
+/**
+ * 彻底删除一个 chat session。
+ *
+ * 关键点（中文）
+ * - 幂等：目标不存在时返回 success + deleted=false，避免上层重试复杂化。
+ */
+export async function deleteChatSessionById(params) {
+    const sessionId = normalizeSessionId(params.sessionId);
+    if (!sessionId) {
+        return {
+            success: false,
+            sessionId: "",
+            deleted: false,
+            removedMeta: false,
+            removedChatDir: false,
+            removedSessionDir: false,
+            error: "Missing sessionId",
+        };
+    }
+    try {
+        // 关键点（中文）：先停执行，再删文件，避免删除过程中仍有任务写入。
+        params.context.session.get(sessionId).clearExecutor();
+        resolveChatQueueStore(params.context).clear(sessionId);
+        const removedMetaResult = await removeChatMetaBySessionId({
+            context: params.context,
+            sessionId,
+        });
+        const chatDir = path.join(params.context.rootPath, ".downcity", "chat", sessionId);
+        const sessionDir = params.context.paths.getDowncitySessionDirPath(sessionId);
+        const hadChatDir = await fs.pathExists(chatDir);
+        const hadSessionDir = await fs.pathExists(sessionDir);
+        if (hadChatDir) {
+            await fs.remove(chatDir);
+        }
+        if (hadSessionDir) {
+            await fs.remove(sessionDir);
+        }
+        const deleted = removedMetaResult.removed || hadChatDir || hadSessionDir;
+        return {
+            success: true,
+            sessionId,
+            deleted,
+            removedMeta: removedMetaResult.removed,
+            removedChatDir: hadChatDir,
+            removedSessionDir: hadSessionDir,
+        };
+    }
+    catch (error) {
+        return {
+            success: false,
+            sessionId,
+            deleted: false,
+            removedMeta: false,
+            removedChatDir: false,
+            removedSessionDir: false,
+            error: String(error),
+        };
+    }
+}
+//# sourceMappingURL=ChatSessionDelete.js.map

package/bin/plugin/builtins/chat/runtime/ChatSessionDelete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionDelete.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatSessionDelete.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAE7B,OAAO,EAAE,qBAAqB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,EAAE,yBAAyB,EAAE,MAAM,iDAAiD,CAAC;AAE5F,SAAS,kBAAkB,CAAC,SAAiB;IAC3C,OAAO,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;AACxC,CAAC;AAED;;;;;GAKG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CAAC,MAG3C;IASC,MAAM,SAAS,GAAG,kBAAkB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IACvD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,SAAS,EAAE,EAAE;YACb,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,KAAK;YAClB,cAAc,EAAE,KAAK;YACrB,iBAAiB,EAAE,KAAK;YACxB,KAAK,EAAE,mBAAmB;SAC3B,CAAC;IACJ,CAAC;IAED,IAAI,CAAC;QACH,mCAAmC;QACnC,MAAM,CAAC,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,aAAa,EAAE,CAAC;QACtD,qBAAqB,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC;QAEvD,MAAM,iBAAiB,GAAG,MAAM,yBAAyB,CAAC;YACxD,OAAO,EAAE,MAAM,CAAC,OAAO;YACvB,SAAS;SACV,CAAC,CAAC;QAEH,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,QAAQ,EAAE,WAAW,EAAE,MAAM,EAAE,SAAS,CAAC,CAAC;QACnF,MAAM,UAAU,GAAG,MAAM,CAAC,OAAO,CAAC,KAAK,CAAC,yBAAyB,CAAC,SAAS,CAAC,CAAC;QAC7E,MAAM,UAAU,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC;QAChD,MAAM,aAAa,GAAG,MAAM,EAAE,CAAC,UAAU,CAAC,UAAU,CAAC,CAAC;QACtD,IAAI,UAAU,EAAE,CAAC;YACf,MAAM,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;QAC3B,CAAC;QACD,IAAI,aAAa,EAAE,CAAC;YAClB,MAAM,EAAE,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC;QAC9B,CAAC;QAED,MAAM,OAAO,GACX,iBAAiB,CAAC,OAAO,IAAI,UAAU,IAAI,aAAa,CAAC;QAE3D,OAAO;YACL,OAAO,EAAE,IAAI;YACb,SAAS;YACT,OAAO;YACP,WAAW,EAAE,iBAAiB,CAAC,OAAO;YACtC,cAAc,EAAE,UAAU;YAC1B,iBAAiB,EAAE,aAAa;SACjC,CAAC;IACJ,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO;YACL,OAAO,EAAE,KAAK;YACd,SAAS;YACT,OAAO,EAAE,KAAK;YACd,WAAW,EAAE,KAAK;YAClB,cAAc,EAAE,KAAK;YACrB,iBAAiB,EAAE,KAAK;YACxB,KAAK,EAAE,MAAM,CAAC,KAAK,CAAC;SACrB,CAAC;IACJ,CAAC;AACH,CAAC"}

package/bin/plugin/builtins/chat/runtime/ChatSessionTypes.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ChatSession 相关类型定义。
+ *
+ * 关键点（中文）
+ * - Chat 专用 session 会把“队列消息合并 / step 回发”收敛到 chat 层自身。
+ * - 普通 Session 仍可复用基础 `run / append*` 能力，不强耦合 chat 语义。
+ */
+import type { SessionUserMessageV1 } from "../../../../executor/types/SessionMessages.js";
+import type { SessionAssistantStepCallback } from "../../../../executor/types/SessionRun.js";
+/**
+ * ChatSession 单次 turn 绑定的运行态。
+ */
+export interface ChatSessionTurnState {
+    /**
+     * 提取本轮 step 边界新增的 user 消息。
+     *
+     * 关键点（中文）
+     * - 该回调用于把同一 chat lane 后续到达的消息并入当前推理。
+     * - 若未提供，则表示当前 turn 不启用 step 合并。
+     */
+    onStepCallback?: () => Promise<SessionUserMessageV1[]>;
+    /**
+     * assistant step 回发钩子。
+     *
+     * 关键点（中文）
+     * - ChatSession 内部会先完成 step 持久化，再调用该钩子做真实渠道发送。
+     */
+    onAssistantStepCallback?: SessionAssistantStepCallback;
+}
+//# sourceMappingURL=ChatSessionTypes.d.ts.map

package/bin/plugin/builtins/chat/runtime/ChatSessionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionTypes.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatSessionTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,qCAAqC,CAAC;AAChF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,gCAAgC,CAAC;AAEnF;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;;;;OAMG;IACH,cAAc,CAAC,EAAE,MAAM,OAAO,CAAC,oBAAoB,EAAE,CAAC,CAAC;IAEvD;;;;;OAKG;IACH,uBAAuB,CAAC,EAAE,4BAA4B,CAAC;CACxD"}

package/bin/plugin/builtins/chat/runtime/ChatSessionTypes.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionTypes.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatSessionTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/bin/plugin/builtins/chat/runtime/ChatkeySend.d.ts

@@ -0,0 +1,67 @@
+/**
+ * Send text to a target chat using chatKey.
+ *
+ * 设计动机（中文）
+ * - Task runner / scheduler 需要在“非当前对话上下文”向指定 chatKey 投递消息
+ * - 复用现有 dispatcher 与 chat meta（尤其 QQ 的被动回复依赖 messageId）
+ *
+ * 注意
+ * - 这里是运行时内部能力（不是 tool）；tool `chat_contact_send` 也会复用本实现
+ */
+import type { ChatDispatchAction, ChatDispatchChannel } from "../../../../plugin/builtins/chat/types/ChatDispatcher.js";
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+/**
+ * 解析实际分发目标。
+ *
+ * 规则（中文）
+ * - 仅使用 chat plugin runtime 维护的 session 路由映射。
+ * - 不再支持 legacy chatKey 字符串解析回退。
+ */
+export declare function resolveDispatchTargetByChatKey(params: {
+    context: AgentContext;
+    chatKey: string;
+}): Promise<{
+    channel: ChatDispatchChannel;
+    chatId: string;
+    chatType?: string;
+    messageThreadId?: number;
+    messageId?: string;
+} | null>;
+/**
+ * 按 chatKey 发送文本到对应平台。
+ *
+ * 流程（中文）
+ * 1) 通过 sessionId 读取映射并定位 channel dispatcher
+ * 2) 从 chat meta 回填 chatType/threadId/messageId
+ * 3) 合并参数后调用 dispatcher 发送
+ */
+export declare function sendTextByChatKey(params: {
+    context: AgentContext;
+    chatKey: string;
+    text: string;
+    replyToMessage?: boolean;
+    messageId?: string;
+}): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+/**
+ * 按 chatKey 发送平台动作（typing/react）。
+ *
+ * 流程（中文）
+ * 1) 通过 sessionId 读取映射并定位 channel dispatcher
+ * 2) 合并目标元信息与显式参数（显式 messageId 优先）
+ * 3) 调用 dispatcher.sendAction
+ */
+export declare function sendActionByChatKey(params: {
+    context: AgentContext;
+    chatKey: string;
+    action: ChatDispatchAction;
+    messageId?: string;
+    reactionEmoji?: string;
+    reactionIsBig?: boolean;
+}): Promise<{
+    success: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=ChatkeySend.d.ts.map

package/bin/plugin/builtins/chat/runtime/ChatkeySend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatkeySend.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatkeySend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,gDAAgD,CAAC;AACxD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAGhE;;;;;;GAMG;AACH,wBAAsB,8BAA8B,CAAC,MAAM,EAAE;IAC3D,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;CACjB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,IAAI,CAAC,CA8BR;AAED;;;;;;;GAOG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAkDhD;AAED;;;;;;;GAOG;AACH,wBAAsB,mBAAmB,CAAC,MAAM,EAAE;IAChD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,kBAAkB,CAAC;IAC3B,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB,GAAG,OAAO,CAAC;IAAE,OAAO,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAsChD"}

package/bin/plugin/builtins/chat/runtime/ChatkeySend.js

@@ -0,0 +1,147 @@
+/**
+ * Send text to a target chat using chatKey.
+ *
+ * 设计动机（中文）
+ * - Task runner / scheduler 需要在“非当前对话上下文”向指定 chatKey 投递消息
+ * - 复用现有 dispatcher 与 chat meta（尤其 QQ 的被动回复依赖 messageId）
+ *
+ * 注意
+ * - 这里是运行时内部能力（不是 tool）；tool `chat_contact_send` 也会复用本实现
+ */
+import { getChatSender } from "./ChatSendRegistry.js";
+import { readChatMetaBySessionId } from "./ChatMetaStore.js";
+/**
+ * 解析实际分发目标。
+ *
+ * 规则（中文）
+ * - 仅使用 chat plugin runtime 维护的 session 路由映射。
+ * - 不再支持 legacy chatKey 字符串解析回退。
+ */
+export async function resolveDispatchTargetByChatKey(params) {
+    const storedMeta = await readChatMetaBySessionId({
+        context: params.context,
+        sessionId: params.chatKey,
+    });
+    const channel = storedMeta?.channel;
+    const chatId = String(storedMeta?.chatId || "").trim();
+    if (!channel || !chatId)
+        return null;
+    const chatType = typeof storedMeta?.targetType === "string" && storedMeta.targetType
+        ? storedMeta.targetType
+        : undefined;
+    const messageThreadId = typeof storedMeta?.threadId === "number" &&
+        Number.isFinite(storedMeta.threadId)
+        ? storedMeta.threadId
+        : undefined;
+    const messageId = typeof storedMeta?.messageId === "string" && storedMeta.messageId
+        ? storedMeta.messageId
+        : undefined;
+    return {
+        channel: channel,
+        chatId,
+        ...(typeof chatType === "string" && chatType ? { chatType } : {}),
+        ...(typeof messageThreadId === "number" ? { messageThreadId } : {}),
+        ...(typeof messageId === "string" && messageId ? { messageId } : {}),
+    };
+}
+/**
+ * 按 chatKey 发送文本到对应平台。
+ *
+ * 流程（中文）
+ * 1) 通过 sessionId 读取映射并定位 channel dispatcher
+ * 2) 从 chat meta 回填 chatType/threadId/messageId
+ * 3) 合并参数后调用 dispatcher 发送
+ */
+export async function sendTextByChatKey(params) {
+    const context = params.context;
+    const chatKey = String(params.chatKey || "").trim();
+    const text = String(params.text ?? "");
+    if (!chatKey)
+        return { success: false, error: "Missing chatKey" };
+    if (!text.trim())
+        return { success: true };
+    const target = await resolveDispatchTargetByChatKey({ context, chatKey });
+    if (!target) {
+        return {
+            success: false,
+            error: `Unsupported sessionId for dispatch: ${chatKey}`,
+        };
+    }
+    const channel = target.channel;
+    const chatId = target.chatId;
+    const dispatcher = getChatSender(channel);
+    if (!dispatcher) {
+        return {
+            success: false,
+            error: `No dispatcher registered for channel: ${channel}`,
+        };
+    }
+    const chatType = target.chatType;
+    const messageThreadId = target.messageThreadId;
+    const explicitMessageId = String(params.messageId || "").trim();
+    const messageId = explicitMessageId || target.messageId;
+    const shouldReplyToMessage = params.replyToMessage === true;
+    if (channel === "qq") {
+        if (!chatType || !messageId) {
+            return {
+                success: false,
+                error: "QQ requires chatType + messageId to send a reply. Ask the target user to send a message first so Downcity can record latest chat meta.",
+            };
+        }
+    }
+    return dispatcher.sendText({
+        chatId,
+        text,
+        ...(typeof messageThreadId === "number" ? { messageThreadId } : {}),
+        ...(typeof chatType === "string" && chatType ? { chatType } : {}),
+        ...(typeof messageId === "string" && messageId ? { messageId } : {}),
+        ...(shouldReplyToMessage ? { replyToMessage: true } : {}),
+    });
+}
+/**
+ * 按 chatKey 发送平台动作（typing/react）。
+ *
+ * 流程（中文）
+ * 1) 通过 sessionId 读取映射并定位 channel dispatcher
+ * 2) 合并目标元信息与显式参数（显式 messageId 优先）
+ * 3) 调用 dispatcher.sendAction
+ */
+export async function sendActionByChatKey(params) {
+    const context = params.context;
+    const chatKey = String(params.chatKey || "").trim();
+    if (!chatKey)
+        return { success: false, error: "Missing chatKey" };
+    if (!params.action)
+        return { success: false, error: "Missing action" };
+    const target = await resolveDispatchTargetByChatKey({ context, chatKey });
+    if (!target) {
+        return {
+            success: false,
+            error: `Unsupported sessionId for dispatch: ${chatKey}`,
+        };
+    }
+    const dispatcher = getChatSender(target.channel);
+    if (!dispatcher || typeof dispatcher.sendAction !== "function") {
+        return {
+            success: false,
+            error: `No action dispatcher registered for channel: ${target.channel}`,
+        };
+    }
+    const messageId = String(params.messageId || "").trim() || target.messageId;
+    return dispatcher.sendAction({
+        chatId: target.chatId,
+        action: params.action,
+        ...(typeof target.messageThreadId === "number"
+            ? { messageThreadId: target.messageThreadId }
+            : {}),
+        ...(typeof target.chatType === "string" && target.chatType
+            ? { chatType: target.chatType }
+            : {}),
+        ...(typeof messageId === "string" && messageId ? { messageId } : {}),
+        ...(typeof params.reactionEmoji === "string" && params.reactionEmoji.trim()
+            ? { reactionEmoji: params.reactionEmoji.trim() }
+            : {}),
+        ...(params.reactionIsBig === true ? { reactionIsBig: true } : {}),
+    });
+}
+//# sourceMappingURL=ChatkeySend.js.map

package/bin/plugin/builtins/chat/runtime/ChatkeySend.js.map

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

package/bin/plugin/builtins/chat/runtime/DirectDispatchParser.d.ts

@@ -0,0 +1,22 @@
+/**
+ * DirectDispatchParser：direct 模式 assistant 文本解析器。
+ *
+ * 关键点（中文）
+ * - 默认把 assistant 文本原样当作用户可见正文发送。
+ * - frontmatter metadata 语义与 `city chat send` 保持一致。
+ * - 额外保留 `react` 字段用于 direct 模式贴表情。
+ */
+import type { ResolvedDirectDispatchPlan } from "../../../../plugin/builtins/chat/types/DirectDispatch.js";
+/**
+ * 从 assistant 文本中解析 direct 出站执行计划。
+ *
+ * 协议（中文）
+ * - frontmatter metadata：与 `city chat send` 参数保持一致。
+ * - 附件统一使用 `<file type=\"document|photo|voice|audio|video\">path</file>`。
+ * - `react` 仍仅用于 direct 模式的反应动作。
+ */
+export declare function parseDirectDispatchAssistantText(params: {
+    assistantText: string;
+    fallbackChatKey: string;
+}): ResolvedDirectDispatchPlan | null;
+//# sourceMappingURL=DirectDispatchParser.d.ts.map

package/bin/plugin/builtins/chat/runtime/DirectDispatchParser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"DirectDispatchParser.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/DirectDispatchParser.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAEV,0BAA0B,EAG3B,MAAM,gDAAgD,CAAC;AA6GxD;;;;;;;GAOG;AACH,wBAAgB,gCAAgC,CAAC,MAAM,EAAE;IACvD,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB,GAAG,0BAA0B,GAAG,IAAI,CAuBpC"}

package/bin/plugin/builtins/chat/runtime/DirectDispatchParser.js

@@ -0,0 +1,133 @@
+/**
+ * DirectDispatchParser：direct 模式 assistant 文本解析器。
+ *
+ * 关键点（中文）
+ * - 默认把 assistant 文本原样当作用户可见正文发送。
+ * - frontmatter metadata 语义与 `city chat send` 保持一致。
+ * - 额外保留 `react` 字段用于 direct 模式贴表情。
+ */
+import { buildChatMessageText, parseChatMessageMarkup, } from "../../../../plugin/builtins/chat/runtime/ChatMessageMarkup.js";
+import { parseChatSendOptionsFromMetadata } from "../../../../plugin/builtins/chat/runtime/ChatSendMetadata.js";
+function normalizeText(value) {
+    return String(value ?? "").trim();
+}
+function parseBoolean(value) {
+    if (typeof value === "boolean")
+        return value;
+    const text = normalizeText(value).toLowerCase();
+    return text === "true" || text === "1" || text === "yes";
+}
+function parseReactionFromMetadata(value) {
+    if (typeof value === "string") {
+        const emoji = normalizeText(value);
+        return emoji ? { emoji } : null;
+    }
+    if (!value || typeof value !== "object" || Array.isArray(value)) {
+        return null;
+    }
+    const raw = value;
+    const emoji = normalizeText(raw.emoji);
+    if (!emoji)
+        return null;
+    const big = parseBoolean(raw.big);
+    return {
+        emoji,
+        ...(big ? { big: true } : {}),
+    };
+}
+function parseReactionsFromMetadata(metadata) {
+    const out = [];
+    const raw = metadata.react;
+    if (!raw)
+        return out;
+    const list = Array.isArray(raw) ? raw : [raw];
+    for (const item of list) {
+        const parsed = parseReactionFromMetadata(item);
+        if (!parsed)
+            continue;
+        out.push(parsed);
+    }
+    return out;
+}
+function resolveTextPlan(params) {
+    const sendOptions = parseChatSendOptionsFromMetadata({
+        metadata: params.metadata,
+        strict: false,
+    });
+    const chatKey = normalizeText(sendOptions.chatKey || params.fallbackChatKey);
+    const text = buildChatMessageText({
+        segments: params.segments,
+    });
+    if (!chatKey || !text)
+        return null;
+    return {
+        text,
+        chatKey,
+        replyToMessage: sendOptions.replyToMessage === true,
+        ...(typeof sendOptions.messageId === "string" && sendOptions.messageId
+            ? { messageId: sendOptions.messageId }
+            : {}),
+        ...(typeof sendOptions.delayMs === "number"
+            ? { delayMs: sendOptions.delayMs }
+            : {}),
+        ...(typeof sendOptions.sendAtMs === "number"
+            ? { sendAtMs: sendOptions.sendAtMs }
+            : {}),
+    };
+}
+function resolveReactionPlans(params) {
+    const out = [];
+    const sendOptions = parseChatSendOptionsFromMetadata({
+        metadata: params.metadata,
+        strict: false,
+    });
+    const chatKey = normalizeText(sendOptions.chatKey || params.fallbackChatKey);
+    const messageId = normalizeText(sendOptions.messageId);
+    if (!chatKey)
+        return out;
+    for (const react of params.reacts) {
+        const emoji = normalizeText(react.emoji);
+        if (!emoji)
+            continue;
+        out.push({
+            emoji,
+            chatKey,
+            ...(messageId ? { messageId } : {}),
+            big: react.big === true,
+        });
+    }
+    return out;
+}
+/**
+ * 从 assistant 文本中解析 direct 出站执行计划。
+ *
+ * 协议（中文）
+ * - frontmatter metadata：与 `city chat send` 参数保持一致。
+ * - 附件统一使用 `<file type=\"document|photo|voice|audio|video\">path</file>`。
+ * - `react` 仍仅用于 direct 模式的反应动作。
+ */
+export function parseDirectDispatchAssistantText(params) {
+    const source = String(params.assistantText ?? "");
+    const fallbackChatKey = normalizeText(params.fallbackChatKey);
+    if (!normalizeText(source) || !fallbackChatKey)
+        return null;
+    const parsed = parseChatMessageMarkup(source);
+    const reacts = parseReactionsFromMetadata(parsed.metadata);
+    const textPlan = resolveTextPlan({
+        fallbackChatKey,
+        metadata: parsed.metadata,
+        segments: parsed.segments,
+    });
+    const reactionPlans = resolveReactionPlans({
+        fallbackChatKey,
+        metadata: parsed.metadata,
+        reacts,
+    });
+    if (!textPlan && reactionPlans.length === 0)
+        return null;
+    return {
+        text: textPlan,
+        reactions: reactionPlans,
+    };
+}
+//# sourceMappingURL=DirectDispatchParser.js.map

package/bin/plugin/builtins/chat/runtime/DirectDispatchParser.js.map

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

package/bin/plugin/builtins/chat/runtime/EnqueueDispatch.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Chat enqueue dispatch helper。
+ *
+ * 关键点（中文）
+ * - 统一封装入队前/后的扩展点调用。
+ * - service 通过这里暴露 queue 生命周期，不直接散落调用细节。
+ */
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+import type { ChatEnqueueEffectInput, ChatEnqueuePipelineInput } from "../../../../plugin/builtins/chat/types/ChatPlugin.js";
+/**
+ * 入队前增强。
+ */
+export declare function prepareChatEnqueue(params: {
+    context: AgentContext;
+    input: ChatEnqueuePipelineInput;
+}): Promise<ChatEnqueuePipelineInput>;
+/**
+ * 入队后通知。
+ */
+export declare function emitChatEnqueueEffect(params: {
+    context: AgentContext;
+    input: ChatEnqueueEffectInput;
+}): Promise<void>;
+//# sourceMappingURL=EnqueueDispatch.d.ts.map

package/bin/plugin/builtins/chat/runtime/EnqueueDispatch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EnqueueDispatch.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/EnqueueDispatch.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EACV,sBAAsB,EACtB,wBAAwB,EACzB,MAAM,4CAA4C,CAAC;AAQpD;;GAEG;AACH,wBAAsB,kBAAkB,CAAC,MAAM,EAAE;IAC/C,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,wBAAwB,CAAC;CACjC,GAAG,OAAO,CAAC,wBAAwB,CAAC,CASpC;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CAAC,MAAM,EAAE;IAClD,OAAO,EAAE,YAAY,CAAC;IACtB,KAAK,EAAE,sBAAsB,CAAC;CAC/B,GAAG,OAAO,CAAC,IAAI,CAAC,CAKhB"}