@downcity/plugins 1.0.4

package/bin/chat/runtime/ChatSessionContextComposer.d.ts

@@ -0,0 +1,45 @@
+/**
+ * ChatSessionContextComposer：chat 专用 context composer。
+ *
+ * 关键点（中文）
+ * - 由 chat 层在 Session 实例化时注入，不再依赖 run 时层层传 callback。
+ * - step 合并消息读取自 ChatSession 当前绑定的 turn context。
+ * - 其余能力（tools / fallback assistant）继续复用默认本地实现。
+ */
+import type { ModelMessage, Tool } from "ai";
+import { LocalSessionContextComposer } from "@downcity/agent/internal/executor/composer/context/LocalSessionContextComposer.js";
+import type { SessionMessageV1 } from "@downcity/agent/internal/executor/types/SessionMessages.js";
+import type { SessionSystemMessage } from "@downcity/agent/internal/executor/types/SessionPrompts.js";
+import type { ChatSessionTurnState } from "../../chat/runtime/ChatSessionTypes.js";
+type ChatSessionContextComposerOptions = {
+    /**
+     * 当前 session 标识。
+     */
+    sessionId: string;
+    /**
+     * 读取当前可用工具集合。
+     */
+    getTools: () => Record<string, Tool>;
+    /**
+     * 读取当前已绑定的 chat turn 状态。
+     */
+    getTurnState: () => ChatSessionTurnState | null;
+};
+/**
+ * ChatSession 专用 context composer。
+ */
+export declare class ChatSessionContextComposer extends LocalSessionContextComposer {
+    private readonly getTurnState;
+    constructor(options: ChatSessionContextComposerOptions);
+    createPrepareStepHandler(input: {
+        system: SessionSystemMessage[];
+        appendMergedUserMessages: (messages: SessionMessageV1[]) => Promise<ModelMessage[]>;
+    }): (input: {
+        messages?: ModelMessage[];
+    }) => Promise<{
+        system: SessionSystemMessage[];
+        messages?: ModelMessage[];
+    }>;
+}
+export {};
+//# sourceMappingURL=ChatSessionContextComposer.d.ts.map

package/bin/chat/runtime/ChatSessionContextComposer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionContextComposer.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatSessionContextComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,IAAI,EAAE,MAAM,IAAI,CAAC;AAE7C,OAAO,EAAE,2BAA2B,EAAE,MAAM,mFAAmF,CAAC;AAChI,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,4DAA4D,CAAC;AACnG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,2DAA2D,CAAC;AACtG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,oCAAoC,CAAC;AAE/E,KAAK,iCAAiC,GAAG;IACvC;;OAEG;IACH,SAAS,EAAE,MAAM,CAAC;IAElB;;OAEG;IACH,QAAQ,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IAErC;;OAEG;IACH,YAAY,EAAE,MAAM,oBAAoB,GAAG,IAAI,CAAC;CACjD,CAAC;AAEF;;GAEG;AACH,qBAAa,0BAA2B,SAAQ,2BAA2B;IACzE,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAoD;gBAErE,OAAO,EAAE,iCAAiC;IAQtD,wBAAwB,CACtB,KAAK,EAAE;QACL,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,wBAAwB,EAAE,CACxB,QAAQ,EAAE,gBAAgB,EAAE,KACzB,OAAO,CAAC,YAAY,EAAE,CAAC,CAAC;KAC9B,GACA,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAA;KAAE,KAAK,OAAO,CAAC;QACnD,MAAM,EAAE,oBAAoB,EAAE,CAAC;QAC/B,QAAQ,CAAC,EAAE,YAAY,EAAE,CAAC;KAC3B,CAAC;CAgDH"}

package/bin/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 "@downcity/agent/internal/executor/SessionRunScope.js";
+import { LocalSessionContextComposer } from "@downcity/agent/internal/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/chat/runtime/ChatSessionContextComposer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionContextComposer.js","sourceRoot":"","sources":["../../../src/chat/runtime/ChatSessionContextComposer.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,yBAAyB,EAAE,MAAM,sDAAsD,CAAC;AACjG,OAAO,EAAE,2BAA2B,EAAE,MAAM,mFAAmF,CAAC;AAsBhI;;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/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 "@downcity/agent/internal/types/runtime/agent/AgentContext.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/chat/runtime/ChatSessionDelete.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionDelete.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatSessionDelete.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAIH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAQjG;;;;;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/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 "../../chat/runtime/ChatQueue.js";
+import { removeChatMetaBySessionId } from "../../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/chat/runtime/ChatSessionDelete.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionDelete.js","sourceRoot":"","sources":["../../../src/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,6BAA6B,CAAC;AACpE,OAAO,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,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/chat/runtime/ChatSessionTypes.d.ts

@@ -0,0 +1,30 @@
+/**
+ * ChatSession 相关类型定义。
+ *
+ * 关键点（中文）
+ * - Chat 专用 session 会把“队列消息合并 / step 回发”收敛到 chat 层自身。
+ * - 普通 Session 仍可复用基础 `run / append*` 能力，不强耦合 chat 语义。
+ */
+import type { SessionUserMessageV1 } from "@downcity/agent/internal/executor/types/SessionMessages.js";
+import type { SessionAssistantStepCallback } from "@downcity/agent/internal/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/chat/runtime/ChatSessionTypes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatSessionTypes.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatSessionTypes.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,4DAA4D,CAAC;AACvG,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uDAAuD,CAAC;AAE1G;;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/chat/runtime/ChatSessionTypes.js

@@ -0,0 +1,9 @@
+/**
+ * ChatSession 相关类型定义。
+ *
+ * 关键点（中文）
+ * - Chat 专用 session 会把“队列消息合并 / step 回发”收敛到 chat 层自身。
+ * - 普通 Session 仍可复用基础 `run / append*` 能力，不强耦合 chat 语义。
+ */
+export {};
+//# sourceMappingURL=ChatSessionTypes.js.map

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

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

package/bin/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 "../../chat/types/ChatDispatcher.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.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/chat/runtime/ChatkeySend.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatkeySend.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatkeySend.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAGH,OAAO,KAAK,EACV,kBAAkB,EAClB,mBAAmB,EACpB,MAAM,gCAAgC,CAAC;AACxC,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAGjG;;;;;;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/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/chat/runtime/ChatkeySend.js.map

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

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

@@ -0,0 +1,22 @@
+/**
+ * DirectDispatchParser：direct 模式 assistant 文本解析器。
+ *
+ * 关键点（中文）
+ * - 默认把 assistant 文本原样当作用户可见正文发送。
+ * - frontmatter metadata 语义与 `city chat send` 保持一致。
+ * - 额外保留 `react` 字段用于 direct 模式贴表情。
+ */
+import type { ResolvedDirectDispatchPlan } from "../../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/chat/runtime/DirectDispatchParser.d.ts.map

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