@downcity/agent 1.1.23 → 1.1.32

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

@@ -0,0 +1,106 @@
+/**
+ * ChatChannelCore：chat 渠道状态的核心共享辅助模块。
+ *
+ * 关键点（中文）
+ * - 这里只放最基础的渠道状态/名称/account 解析能力。
+ * - 生命周期、配置写入、action 执行分别放到更细的模块中。
+ * - 目标是让 chat channel 子模块共享同一套最小公共基元。
+ */
+const CHAT_CHANNEL_NAMES = ["telegram", "feishu", "qq"];
+function resolveChatServiceBindings(context) {
+    const candidate = context.agent?.runtimePlugins?.get?.("chat");
+    return candidate || null;
+}
+/**
+ * 创建 chat 渠道状态对象。
+ */
+export function createChatChannelState() {
+    return {
+        telegram: null,
+        feishu: null,
+        qq: null,
+    };
+}
+/**
+ * 解析并校验渠道名。
+ */
+export function resolveChatChannelNameOrThrow(value) {
+    const normalized = String(value || "")
+        .trim()
+        .toLowerCase();
+    if (normalized === "telegram" ||
+        normalized === "feishu" ||
+        normalized === "qq") {
+        return normalized;
+    }
+    throw new Error(`Invalid channel: ${value}. Use telegram|feishu|qq.`);
+}
+/**
+ * 解析目标渠道列表。
+ */
+export function resolveTargetChannels(channel) {
+    return channel ? [channel] : [...CHAT_CHANNEL_NAMES];
+}
+/**
+ * 读取渠道绑定的 bot account id。
+ */
+export function resolveChannelAccountId(context, channel) {
+    const service = resolveChatServiceBindings(context);
+    const explicit = String(service?.getChannelAccountId?.(context, channel) || "").trim();
+    if (explicit)
+        return explicit;
+    const config = context.config.services?.chat?.channels?.[channel];
+    return String(config?.channelAccountId || "").trim();
+}
+/**
+ * 从宿主平台能力中解析渠道 account。
+ */
+export function resolveChannelAccount(context, channel) {
+    const service = resolveChatServiceBindings(context);
+    const explicit = service?.resolveChannelAccount?.(context, channel);
+    if (explicit)
+        return explicit;
+    const channelAccountId = resolveChannelAccountId(context, channel);
+    const account = context.platform.resolveChannelAccount?.({
+        projectRoot: context.rootPath,
+        channel,
+        ...(channelAccountId ? { channelAccountId } : {}),
+    }) || (channelAccountId ? context.platform.getChannelAccount(channelAccountId) : null);
+    if (!account)
+        return null;
+    if (account.channel !== channel)
+        return null;
+    return account;
+}
+/**
+ * 判断渠道 credentials 是否已经配置完整。
+ */
+export function isChannelAccountConfigured(channel, account) {
+    if (!account)
+        return false;
+    if (channel === "telegram") {
+        return !!String(account.botToken || "").trim();
+    }
+    return !!String(account.appId || "").trim() && !!String(account.appSecret || "").trim();
+}
+/**
+ * 判断指定渠道当前是否启用。
+ */
+export function isChatChannelEnabled(context, channel) {
+    const service = resolveChatServiceBindings(context);
+    if (typeof service?.isChannelEnabled === "function") {
+        return service.isChannelEnabled(context, channel);
+    }
+    return context.config.services?.chat?.channels?.[channel]?.enabled === true;
+}
+/**
+ * 读取当前渠道 bot 实例。
+ */
+export function getChatChannelBot(state, channel) {
+    if (channel === "telegram")
+        return state.telegram;
+    if (channel === "feishu")
+        return state.feishu;
+    return state.qq;
+}
+//# sourceMappingURL=ChatChannelCore.js.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelFacade.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatChannelFacade.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelFacade.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatChannelFacade.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EACL,sBAAsB,EACtB,6BAA6B,GAC9B,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,2BAA2B,CAAC;AAChF,OAAO,EACL,uBAAuB,EACvB,qBAAqB,EACrB,0BAA0B,EAC1B,qBAAqB,EACrB,sBAAsB,EACtB,8BAA8B,EAC9B,0BAA0B,GAC3B,MAAM,yBAAyB,CAAC"}

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

@@ -0,0 +1,28 @@
+/**
+ * ChatChannelLifecycle：chat 渠道生命周期模块。
+ *
+ * 关键点（中文）
+ * - 渠道 bot 的创建、启动、停止逻辑统一收敛在这里。
+ * - bot 实例状态归属于 ChatService 实例持有的 ChatChannelState。
+ * - 本模块不处理 downcity.json 写入，也不负责 action 输入输出包装。
+ */
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+import type { ChatChannelState } from "../../../../plugin/builtins/chat/types/ChatRuntime.js";
+import type { ChatChannelName } from "../../../../plugin/builtins/chat/types/ChannelStatus.js";
+/**
+ * 启动单个渠道。
+ */
+export declare function startSingleChatChannel(state: ChatChannelState, context: AgentContext, channel: ChatChannelName): Promise<void>;
+/**
+ * 停止单个渠道。
+ */
+export declare function stopSingleChatChannel(state: ChatChannelState, channel: ChatChannelName): Promise<void>;
+/**
+ * 启动全部已启用的 chat 渠道。
+ */
+export declare function startChatChannels(state: ChatChannelState, context: AgentContext): Promise<void>;
+/**
+ * 停止全部 chat 渠道。
+ */
+export declare function stopChatChannels(state: ChatChannelState): Promise<void>;
+//# sourceMappingURL=ChatChannelLifecycle.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatChannelLifecycle.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatChannelLifecycle.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6CAA6C,CAAC;AACpF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,+CAA+C,CAAC;AA+ErF;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,YAAY,EACrB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAUf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,eAAe,GACvB,OAAO,CAAC,IAAI,CAAC,CAkBf;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CACrC,KAAK,EAAE,gBAAgB,EACvB,OAAO,EAAE,YAAY,GACpB,OAAO,CAAC,IAAI,CAAC,CAOf;AAED;;GAEG;AACH,wBAAsB,gBAAgB,CAAC,KAAK,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC,CAe7E"}

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

@@ -0,0 +1,132 @@
+/**
+ * ChatChannelLifecycle：chat 渠道生命周期模块。
+ *
+ * 关键点（中文）
+ * - 渠道 bot 的创建、启动、停止逻辑统一收敛在这里。
+ * - bot 实例状态归属于 ChatService 实例持有的 ChatChannelState。
+ * - 本模块不处理 downcity.json 写入，也不负责 action 输入输出包装。
+ */
+import { createTelegramBot } from "../../../../plugin/builtins/chat/channels/telegram/Bot.js";
+import { createFeishuBot } from "../../../../plugin/builtins/chat/channels/feishu/Feishu.js";
+import { createQQBot } from "../../../../plugin/builtins/chat/channels/qq/QQ.js";
+import { isChatChannelEnabled, resolveChannelAccount, resolveTargetChannels, } from "./ChatChannelCore.js";
+async function startTelegramChannel(state, context) {
+    if (!isChatChannelEnabled(context, "telegram"))
+        return;
+    context.logger.info("Telegram channel enabled");
+    const account = resolveChannelAccount(context, "telegram");
+    const token = String(account?.botToken || "").trim();
+    if (!token)
+        return;
+    state.telegram = createTelegramBot({
+        enabled: true,
+        botToken: token,
+    }, context);
+    if (state.telegram) {
+        await state.telegram.start();
+    }
+}
+async function startFeishuChannel(state, context) {
+    if (!isChatChannelEnabled(context, "feishu"))
+        return;
+    context.logger.info("Feishu channel enabled");
+    const account = resolveChannelAccount(context, "feishu");
+    const appId = String(account?.appId || "").trim();
+    const appSecret = String(account?.appSecret || "").trim();
+    if (!appId || !appSecret)
+        return;
+    state.feishu = await createFeishuBot({
+        enabled: true,
+        appId,
+        appSecret,
+        domain: String(account?.domain || "").trim() || "https://open.feishu.cn",
+    }, context);
+    if (state.feishu) {
+        await state.feishu.start();
+    }
+}
+async function startQQChannel(state, context) {
+    if (!isChatChannelEnabled(context, "qq"))
+        return;
+    context.logger.info("QQ channel enabled");
+    const account = resolveChannelAccount(context, "qq");
+    const appId = String(account?.appId || "").trim();
+    const appSecret = String(account?.appSecret || "").trim();
+    if (!appId || !appSecret)
+        return;
+    state.qq = await createQQBot({
+        enabled: true,
+        appId,
+        appSecret,
+        sandbox: account?.sandbox === true,
+    }, context);
+    if (state.qq) {
+        await state.qq.start();
+    }
+}
+/**
+ * 启动单个渠道。
+ */
+export async function startSingleChatChannel(state, context, channel) {
+    if (channel === "telegram") {
+        await startTelegramChannel(state, context);
+        return;
+    }
+    if (channel === "feishu") {
+        await startFeishuChannel(state, context);
+        return;
+    }
+    await startQQChannel(state, context);
+}
+/**
+ * 停止单个渠道。
+ */
+export async function stopSingleChatChannel(state, channel) {
+    if (channel === "telegram" && state.telegram) {
+        const bot = state.telegram;
+        state.telegram = null;
+        await bot.stop();
+        return;
+    }
+    if (channel === "feishu" && state.feishu) {
+        const bot = state.feishu;
+        state.feishu = null;
+        await bot.stop();
+        return;
+    }
+    if (channel === "qq" && state.qq) {
+        const bot = state.qq;
+        state.qq = null;
+        await bot.stop();
+    }
+}
+/**
+ * 启动全部已启用的 chat 渠道。
+ */
+export async function startChatChannels(state, context) {
+    if (state.telegram || state.feishu || state.qq) {
+        await stopChatChannels(state);
+    }
+    for (const channel of resolveTargetChannels()) {
+        await startSingleChatChannel(state, context, channel);
+    }
+}
+/**
+ * 停止全部 chat 渠道。
+ */
+export async function stopChatChannels(state) {
+    const current = { ...state };
+    state.telegram = null;
+    state.feishu = null;
+    state.qq = null;
+    if (current.telegram) {
+        await current.telegram.stop();
+    }
+    if (current.feishu) {
+        await current.feishu.stop();
+    }
+    if (current.qq) {
+        await current.qq.stop();
+    }
+}
+//# sourceMappingURL=ChatChannelLifecycle.js.map

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

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

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

@@ -0,0 +1,72 @@
+/**
+ * ChatHistoryStore：聊天事件流持久化。
+ *
+ * 关键点（中文）
+ * - 写入 `.downcity/chat/<sessionId>/history.jsonl`（append-only）。
+ * - 记录 inbound（audit/exec）与 outbound 事件。
+ * - 与 session message history 分离，避免审计噪声进入模型上下文。
+ */
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+import type { JsonObject } from "../../../../types/common/Json.js";
+import type { ChatDispatchChannel } from "../../../../plugin/builtins/chat/types/ChatDispatcher.js";
+import type { ChatHistoryDirection, ChatHistoryEventV1, ChatHistoryIngressKind } from "../../../../plugin/builtins/chat/types/ChatHistory.js";
+/**
+ * 追加一条入站 chat 事件。
+ *
+ * 关键点（中文）
+ * - 该函数只做落盘，不做业务判定。
+ * - 调用方应在入队前调用，以满足“先审计后执行”链路。
+ */
+export declare function appendInboundChatHistory(params: {
+    context: AgentContext;
+    sessionId: string;
+    channel: ChatDispatchChannel;
+    chatId: string;
+    ingressKind: ChatHistoryIngressKind;
+    text: string;
+    targetType?: string;
+    threadId?: number;
+    messageId?: string;
+    actorId?: string;
+    actorName?: string;
+    extra?: JsonObject;
+}): Promise<void>;
+/**
+ * 追加一条出站 chat 事件。
+ *
+ * 关键点（中文）
+ * - 用于记录机器人主动发出的消息，便于后续审计与回放。
+ * - 该函数只做落盘，不影响实际发送链路。
+ */
+export declare function appendOutboundChatHistory(params: {
+    context: AgentContext;
+    sessionId: string;
+    channel: ChatDispatchChannel;
+    chatId: string;
+    text: string;
+    targetType?: string;
+    threadId?: number;
+    messageId?: string;
+    actorId?: string;
+    actorName?: string;
+    extra?: JsonObject;
+}): Promise<void>;
+/**
+ * 读取 chat 历史事件（按 sessionId）。
+ *
+ * 关键点（中文）
+ * - 默认返回最近 N 条（按时间升序）。
+ * - 仅做文件读取与过滤，不涉及任何业务 side-effect。
+ */
+export declare function readChatHistory(params: {
+    context: AgentContext;
+    sessionId: string;
+    limit?: number;
+    direction?: ChatHistoryDirection | "all";
+    beforeTs?: number;
+    afterTs?: number;
+}): Promise<{
+    historyPath: string;
+    events: ChatHistoryEventV1[];
+}>;
+//# sourceMappingURL=ChatHistoryStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatHistoryStore.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatHistoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAC1F,OAAO,KAAK,EACV,oBAAoB,EAEpB,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,6CAA6C,CAAC;AAwGrD;;;;;;GAMG;AACH,wBAAsB,wBAAwB,CAAC,MAAM,EAAE;IACrD,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,sBAAsB,CAAC;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAuBhB;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAsBhB;AAED;;;;;;GAMG;AACH,wBAAsB,eAAe,CAAC,MAAM,EAAE;IAC5C,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,oBAAoB,GAAG,KAAK,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB,GAAG,OAAO,CAAC;IAAE,WAAW,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,kBAAkB,EAAE,CAAA;CAAE,CAAC,CA6DjE"}

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

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

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

@@ -0,0 +1,44 @@
+/**
+ * ChatIngressStore：统一处理 chat 入站消息的持久化。
+ *
+ * 关键点（中文）
+ * - `exec` 入站的审计记录写到 `chat history`
+ * - 正常 turn 的 session history 落盘统一交给 `session.prompt()`
+ * - 只有极少数非 turn 场景才允许显式补写 `session messages`
+ */
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+import type { JsonObject } from "../../../../types/common/Json.js";
+import type { ChatDispatchChannel } from "../../../../plugin/builtins/chat/types/ChatDispatcher.js";
+/**
+ * 统一补齐 exec 入站的 context extra。
+ *
+ * 关键点（中文）
+ * - `ingressKind=exec` 是模型上下文需要的最小语义标记
+ * - 调用方原有 extra 保持透传
+ */
+export declare function buildExecIngressExtra(extra?: JsonObject): JsonObject;
+/**
+ * 写入完整 exec 入站记录。
+ *
+ * 流程（中文）
+ * 1. 写 `chat history` 审计流
+ * 2. 不在 ingress 边界提前写 `session messages`
+ *
+ * 说明（中文）
+ * - 这样正常对话 history 会统一在 `session.prompt()` 内部完成落盘。
+ * - 可避免 queue / control / transport 在 session 外重复持久化 user 消息。
+ */
+export declare function appendExecIngress(params: {
+    context: AgentContext;
+    sessionId: string;
+    channel: ChatDispatchChannel;
+    chatId: string;
+    text: string;
+    targetType?: string;
+    threadId?: number;
+    messageId?: string;
+    actorId?: string;
+    actorName?: string;
+    extra?: JsonObject;
+}): Promise<void>;
+//# sourceMappingURL=ChatIngressStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatIngressStore.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatIngressStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AACzD,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAG1F;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,KAAK,CAAC,EAAE,UAAU,GAAG,UAAU,CAKpE;AAED;;;;;;;;;;GAUG;AACH,wBAAsB,iBAAiB,CAAC,MAAM,EAAE;IAC9C,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,UAAU,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAgBhB"}

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

@@ -0,0 +1,51 @@
+/**
+ * ChatIngressStore：统一处理 chat 入站消息的持久化。
+ *
+ * 关键点（中文）
+ * - `exec` 入站的审计记录写到 `chat history`
+ * - 正常 turn 的 session history 落盘统一交给 `session.prompt()`
+ * - 只有极少数非 turn 场景才允许显式补写 `session messages`
+ */
+import { appendInboundChatHistory } from "./ChatHistoryStore.js";
+/**
+ * 统一补齐 exec 入站的 context extra。
+ *
+ * 关键点（中文）
+ * - `ingressKind=exec` 是模型上下文需要的最小语义标记
+ * - 调用方原有 extra 保持透传
+ */
+export function buildExecIngressExtra(extra) {
+    return {
+        ...(extra && typeof extra === "object" ? extra : {}),
+        ingressKind: "exec",
+    };
+}
+/**
+ * 写入完整 exec 入站记录。
+ *
+ * 流程（中文）
+ * 1. 写 `chat history` 审计流
+ * 2. 不在 ingress 边界提前写 `session messages`
+ *
+ * 说明（中文）
+ * - 这样正常对话 history 会统一在 `session.prompt()` 内部完成落盘。
+ * - 可避免 queue / control / transport 在 session 外重复持久化 user 消息。
+ */
+export async function appendExecIngress(params) {
+    const execExtra = buildExecIngressExtra(params.extra);
+    await appendInboundChatHistory({
+        context: params.context,
+        sessionId: params.sessionId,
+        channel: params.channel,
+        chatId: params.chatId,
+        ingressKind: "exec",
+        text: params.text,
+        ...(params.targetType ? { targetType: params.targetType } : {}),
+        ...(typeof params.threadId === "number" ? { threadId: params.threadId } : {}),
+        ...(params.messageId ? { messageId: params.messageId } : {}),
+        ...(params.actorId ? { actorId: params.actorId } : {}),
+        ...(params.actorName ? { actorName: params.actorName } : {}),
+        extra: execExtra,
+    });
+}
+//# sourceMappingURL=ChatIngressStore.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatIngressStore.js","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatIngressStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,EAAE,wBAAwB,EAAE,MAAM,uBAAuB,CAAC;AAEjE;;;;;;GAMG;AACH,MAAM,UAAU,qBAAqB,CAAC,KAAkB;IACtD,OAAO;QACL,GAAG,CAAC,KAAK,IAAI,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,WAAW,EAAE,MAAM;KACpB,CAAC;AACJ,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,CAAC,KAAK,UAAU,iBAAiB,CAAC,MAYvC;IACC,MAAM,SAAS,GAAG,qBAAqB,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IACtD,MAAM,wBAAwB,CAAC;QAC7B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,SAAS,EAAE,MAAM,CAAC,SAAS;QAC3B,OAAO,EAAE,MAAM,CAAC,OAAO;QACvB,MAAM,EAAE,MAAM,CAAC,MAAM;QACrB,WAAW,EAAE,MAAM;QACnB,IAAI,EAAE,MAAM,CAAC,IAAI;QACjB,GAAG,CAAC,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,GAAG,CAAC,OAAO,MAAM,CAAC,QAAQ,KAAK,QAAQ,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7E,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtD,GAAG,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC5D,KAAK,EAAE,SAAS;KACjB,CAAC,CAAC;AACL,CAAC"}

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

@@ -0,0 +1,54 @@
+/**
+ * Chat 消息标记语法解析工具。
+ *
+ * 关键点（中文）
+ * - 统一处理 frontmatter metadata 与 `<file>` 附件标签。
+ * - 解析结果保留 `segments[]`，用于按正文与附件的真实顺序发送。
+ */
+import type { ChatMessageFileTag, ChatMessageFileType, ChatMessageSegment, ParsedChatMessageMarkup } from "../../../../plugin/builtins/chat/types/ChatMessageMarkup.js";
+/**
+ * 归一化附件类型。
+ */
+export declare function normalizeChatMessageFileType(value: unknown): ChatMessageFileType;
+/**
+ * 提取 frontmatter metadata。
+ */
+export declare function extractChatMessageFrontmatter(params: {
+    source: string;
+}): {
+    metadata: Record<string, unknown>;
+    body: string;
+};
+/**
+ * 提取 `<file>` 标签，并保留正文/附件的真实顺序。
+ */
+export declare function extractChatMessageSegments(source: string): ChatMessageSegment[];
+/**
+ * 提取 `<file>` 标签列表。
+ */
+export declare function extractChatMessageFileTags(source: string): ChatMessageFileTag[];
+/**
+ * 移除正文中的 `<file>` 标签，仅保留文本段。
+ */
+export declare function stripChatMessageFileTags(source: string): string;
+/**
+ * 渲染一条标准化 `<file>` 标签。
+ */
+export declare function renderChatMessageFileTag(file: ChatMessageFileTag): string;
+/**
+ * 把附件列表渲染回统一的 `<file>` 文本块。
+ */
+export declare function buildChatMessageFileBlock(files: ChatMessageFileTag[]): string;
+/**
+ * 把片段重建成统一消息文本。
+ */
+export declare function buildChatMessageText(params: {
+    bodyText?: string;
+    files?: ChatMessageFileTag[];
+    segments?: ChatMessageSegment[];
+}): string;
+/**
+ * 统一解析一段 chat 消息文本。
+ */
+export declare function parseChatMessageMarkup(source: string): ParsedChatMessageMarkup;
+//# sourceMappingURL=ChatMessageMarkup.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMessageMarkup.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatMessageMarkup.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAEV,kBAAkB,EAClB,mBAAmB,EACnB,kBAAkB,EAElB,uBAAuB,EACxB,MAAM,mDAAmD,CAAC;AA6B3D;;GAEG;AACH,wBAAgB,4BAA4B,CAAC,KAAK,EAAE,OAAO,GAAG,mBAAmB,CAOhF;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAAC,MAAM,EAAE;IACpD,MAAM,EAAE,MAAM,CAAC;CAChB,GAAG;IACF,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;CACd,CA4BA;AA0BD;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,CA6B/E;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,MAAM,EAAE,MAAM,GAAG,kBAAkB,EAAE,CAI/E;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAM/D;AASD;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,kBAAkB,GAAG,MAAM,CAWzE;AAOD;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,KAAK,EAAE,kBAAkB,EAAE,GAAG,MAAM,CAK7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,MAAM,EAAE;IAC3C,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;IAC7B,QAAQ,CAAC,EAAE,kBAAkB,EAAE,CAAC;CACjC,GAAG,MAAM,CAsBT;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,MAAM,EAAE,MAAM,GAAG,uBAAuB,CAiB9E"}

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

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

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

@@ -0,0 +1,68 @@
+/**
+ * ChatMetaStore：按 sessionId 维护 chat 路由元信息。
+ *
+ * 关键点（中文）
+ * - 入站消息到达时由 service/builtins/chat 写入
+ * - 出站按 sessionId/chatKey 发送时由 service/builtins/chat 读取
+ * - 底层数据落在 `.downcity/channel/meta.json`，由 ChannelContextStore 统一维护
+ */
+import type { AgentContext } from "../../../../core/AgentContextTypes.js";
+import type { ChatMetaV1 } from "../../../../plugin/builtins/chat/types/ChatMeta.js";
+import type { ChatDispatchChannel } from "../../../../plugin/builtins/chat/types/ChatDispatcher.js";
+/**
+ * 读取指定 sessionId 的 chat meta。
+ */
+export declare function readChatMetaBySessionId(params: {
+    context: AgentContext;
+    sessionId: string;
+}): Promise<ChatMetaV1 | null>;
+/**
+ * 更新指定 sessionId 的 chat meta（全量覆盖最近快照）。
+ */
+export declare function upsertChatMetaBySessionId(params: {
+    context: AgentContext;
+    sessionId: string;
+    channel: ChatDispatchChannel;
+    chatId: string;
+    targetType?: string;
+    threadId?: number;
+    messageId?: string;
+    actorId?: string;
+    actorName?: string;
+    chatTitle?: string;
+}): Promise<void>;
+/**
+ * 通过渠道目标查找已有 sessionId。
+ */
+export declare function resolveSessionIdByChatTarget(params: {
+    context: AgentContext;
+    channel: ChatDispatchChannel;
+    chatId: string;
+    targetType?: string;
+    threadId?: number;
+}): Promise<string | null>;
+/**
+ * 通过渠道目标解析或创建 sessionId。
+ */
+export declare function resolveOrCreateSessionIdByChatTarget(params: {
+    context: AgentContext;
+    channel: ChatDispatchChannel;
+    chatId: string;
+    targetType?: string;
+    threadId?: number;
+}): Promise<string | null>;
+/**
+ * 删除指定 sessionId 的 chat meta 映射。
+ *
+ * 关键点（中文）
+ * - 删除后该 sessionId 不再可用于 chatKey 路由发送。
+ * - 若同一 target 重新收到入站消息，会创建新的 sessionId。
+ */
+export declare function removeChatMetaBySessionId(params: {
+    context: AgentContext;
+    sessionId: string;
+}): Promise<{
+    removed: boolean;
+    route: ChatMetaV1 | null;
+}>;
+//# sourceMappingURL=ChatMetaStore.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMetaStore.d.ts","sourceRoot":"","sources":["../../../../../src/plugin/builtins/chat/runtime/ChatMetaStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAChE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0CAA0C,CAAC;AAC3E,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gDAAgD,CAAC;AAiB1F;;GAEG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CAqB7B;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB,GAAG,OAAO,CAAC,IAAI,CAAC,CAkBhB;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAAC,MAAM,EAAE;IACzD,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYzB;AAED;;GAEG;AACH,wBAAsB,oCAAoC,CAAC,MAAM,EAAE;IACjE,OAAO,EAAE,YAAY,CAAC;IACtB,OAAO,EAAE,mBAAmB,CAAC;IAC7B,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,CAYzB;AAED;;;;;;GAMG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE;IACtD,OAAO,EAAE,YAAY,CAAC;IACtB,SAAS,EAAE,MAAM,CAAC;CACnB,GAAG,OAAO,CAAC;IACV,OAAO,EAAE,OAAO,CAAC;IACjB,KAAK,EAAE,UAAU,GAAG,IAAI,CAAC;CAC1B,CAAC,CAmCD"}