@downcity/plugins 1.0.4

package/bin/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 "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { JsonObject } from "@downcity/agent/internal/types/common/Json.js";
+import type { ChatDispatchChannel } from "../../chat/types/ChatDispatcher.js";
+import type { ChatHistoryDirection, ChatHistoryEventV1, ChatHistoryIngressKind } from "../../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/chat/runtime/ChatHistoryStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatHistoryStore.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatHistoryStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EACV,oBAAoB,EAEpB,kBAAkB,EAElB,sBAAsB,EACvB,MAAM,6BAA6B,CAAC;AAwGrC;;;;;;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/chat/runtime/ChatHistoryStore.js

@@ -0,0 +1,219 @@
+/**
+ * ChatHistoryStore：聊天事件流持久化。
+ *
+ * 关键点（中文）
+ * - 写入 `.downcity/chat/<sessionId>/history.jsonl`（append-only）。
+ * - 记录 inbound（audit/exec）与 outbound 事件。
+ * - 与 session message history 分离，避免审计噪声进入模型上下文。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { generateId } from "@downcity/agent/internal/utils/Id.js";
+function normalizeTrimmedString(value) {
+    return String(value || "").trim();
+}
+function toOptionalTrimmedString(value) {
+    const out = normalizeTrimmedString(value);
+    return out ? out : undefined;
+}
+function toOptionalFiniteNumber(value) {
+    return typeof value === "number" && Number.isFinite(value) ? value : undefined;
+}
+function toOptionalObject(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return undefined;
+    return value;
+}
+function buildInboundEvent(params) {
+    return {
+        v: 1,
+        id: `chat:${generateId()}`,
+        ts: Date.now(),
+        direction: "inbound",
+        ingressKind: params.ingressKind,
+        sessionId: params.sessionId,
+        channel: params.channel,
+        chatId: params.chatId,
+        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 } : {}),
+        ...(params.extra ? { extra: params.extra } : {}),
+    };
+}
+function buildOutboundEvent(params) {
+    return {
+        v: 1,
+        id: `chat:${generateId()}`,
+        ts: Date.now(),
+        direction: "outbound",
+        sessionId: params.sessionId,
+        channel: params.channel,
+        chatId: params.chatId,
+        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 } : {}),
+        ...(params.extra ? { extra: params.extra } : {}),
+    };
+}
+function isValidHistoryDirection(value) {
+    return value === "inbound" || value === "outbound";
+}
+function isChatHistoryEventV1(value) {
+    if (!value || typeof value !== "object" || Array.isArray(value))
+        return false;
+    const obj = value;
+    if (obj.v !== 1)
+        return false;
+    if (!isValidHistoryDirection(obj.direction))
+        return false;
+    if (typeof obj.id !== "string" || !obj.id.trim())
+        return false;
+    if (typeof obj.sessionId !== "string" || !obj.sessionId.trim())
+        return false;
+    if (typeof obj.channel !== "string" || !obj.channel.trim())
+        return false;
+    if (typeof obj.chatId !== "string" || !obj.chatId.trim())
+        return false;
+    if (typeof obj.text !== "string")
+        return false;
+    if (typeof obj.ts !== "number" || !Number.isFinite(obj.ts))
+        return false;
+    if (obj.direction === "inbound") {
+        const ingressKind = obj.ingressKind;
+        if (ingressKind !== "audit" && ingressKind !== "exec")
+            return false;
+    }
+    return true;
+}
+/**
+ * 追加一条入站 chat 事件。
+ *
+ * 关键点（中文）
+ * - 该函数只做落盘，不做业务判定。
+ * - 调用方应在入队前调用，以满足“先审计后执行”链路。
+ */
+export async function appendInboundChatHistory(params) {
+    const rootPath = normalizeTrimmedString(params.context.rootPath);
+    const sessionId = normalizeTrimmedString(params.sessionId);
+    const chatId = normalizeTrimmedString(params.chatId);
+    if (!rootPath || !sessionId || !chatId)
+        return;
+    const event = buildInboundEvent({
+        sessionId,
+        channel: params.channel,
+        chatId,
+        ingressKind: params.ingressKind,
+        text: String(params.text ?? ""),
+        targetType: toOptionalTrimmedString(params.targetType),
+        threadId: toOptionalFiniteNumber(params.threadId),
+        messageId: toOptionalTrimmedString(params.messageId),
+        actorId: toOptionalTrimmedString(params.actorId),
+        actorName: toOptionalTrimmedString(params.actorName),
+        extra: toOptionalObject(params.extra),
+    });
+    const file = params.context.paths.getDowncityChatHistoryPath(sessionId);
+    await fs.ensureDir(path.dirname(file));
+    await fs.appendFile(file, JSON.stringify(event) + "\n", "utf8");
+}
+/**
+ * 追加一条出站 chat 事件。
+ *
+ * 关键点（中文）
+ * - 用于记录机器人主动发出的消息，便于后续审计与回放。
+ * - 该函数只做落盘，不影响实际发送链路。
+ */
+export async function appendOutboundChatHistory(params) {
+    const rootPath = normalizeTrimmedString(params.context.rootPath);
+    const sessionId = normalizeTrimmedString(params.sessionId);
+    const chatId = normalizeTrimmedString(params.chatId);
+    if (!rootPath || !sessionId || !chatId)
+        return;
+    const event = buildOutboundEvent({
+        sessionId,
+        channel: params.channel,
+        chatId,
+        text: String(params.text ?? ""),
+        targetType: toOptionalTrimmedString(params.targetType),
+        threadId: toOptionalFiniteNumber(params.threadId),
+        messageId: toOptionalTrimmedString(params.messageId),
+        actorId: toOptionalTrimmedString(params.actorId),
+        actorName: toOptionalTrimmedString(params.actorName),
+        extra: toOptionalObject(params.extra),
+    });
+    const file = params.context.paths.getDowncityChatHistoryPath(sessionId);
+    await fs.ensureDir(path.dirname(file));
+    await fs.appendFile(file, JSON.stringify(event) + "\n", "utf8");
+}
+/**
+ * 读取 chat 历史事件（按 sessionId）。
+ *
+ * 关键点（中文）
+ * - 默认返回最近 N 条（按时间升序）。
+ * - 仅做文件读取与过滤，不涉及任何业务 side-effect。
+ */
+export async function readChatHistory(params) {
+    const rootPath = normalizeTrimmedString(params.context.rootPath);
+    const sessionId = normalizeTrimmedString(params.sessionId);
+    const historyPath = params.context.paths.getDowncityChatHistoryPath(sessionId);
+    if (!rootPath || !sessionId) {
+        return {
+            historyPath,
+            events: [],
+        };
+    }
+    const exists = await fs.pathExists(historyPath);
+    if (!exists) {
+        return {
+            historyPath,
+            events: [],
+        };
+    }
+    const limitRaw = typeof params.limit === "number" && Number.isFinite(params.limit)
+        ? Math.floor(params.limit)
+        : 30;
+    const limit = Math.max(1, Math.min(limitRaw, 500));
+    const direction = params.direction === "inbound" || params.direction === "outbound"
+        ? params.direction
+        : "all";
+    const beforeTs = typeof params.beforeTs === "number" && Number.isFinite(params.beforeTs)
+        ? params.beforeTs
+        : undefined;
+    const afterTs = typeof params.afterTs === "number" && Number.isFinite(params.afterTs)
+        ? params.afterTs
+        : undefined;
+    const content = await fs.readFile(historyPath, "utf8");
+    const out = [];
+    const lines = content.split("\n");
+    for (const rawLine of lines) {
+        const line = String(rawLine || "").trim();
+        if (!line)
+            continue;
+        let parsed;
+        try {
+            parsed = JSON.parse(line);
+        }
+        catch {
+            continue;
+        }
+        if (!isChatHistoryEventV1(parsed))
+            continue;
+        if (direction !== "all" && parsed.direction !== direction)
+            continue;
+        if (typeof beforeTs === "number" && parsed.ts >= beforeTs)
+            continue;
+        if (typeof afterTs === "number" && parsed.ts <= afterTs)
+            continue;
+        out.push(parsed);
+    }
+    return {
+        historyPath,
+        events: out.slice(-limit),
+    };
+}
+//# sourceMappingURL=ChatHistoryStore.js.map

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

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

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatIngressStore.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatIngressStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+CAA+C,CAAC;AAChF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAG1E;;;;;;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/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/chat/runtime/ChatIngressStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatIngressStore.js","sourceRoot":"","sources":["../../../src/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/chat/runtime/ChatMetaStore.d.ts

@@ -0,0 +1,68 @@
+/**
+ * ChatMetaStore：按 sessionId 维护 chat 路由元信息。
+ *
+ * 关键点（中文）
+ * - 入站消息到达时由 chat plugin runtime 写入
+ * - 出站按 sessionId/chatKey 发送时由 chat plugin runtime 读取
+ * - 底层数据落在 `.downcity/channel/meta.json`，由 ChannelContextStore 统一维护
+ */
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { ChatMetaV1 } from "../../chat/types/ChatMeta.js";
+import type { ChatDispatchChannel } from "../../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/chat/runtime/ChatMetaStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ChatMetaStore.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatMetaStore.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AACjG,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAiB1E;;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"}

package/bin/chat/runtime/ChatMetaStore.js

@@ -0,0 +1,143 @@
+/**
+ * ChatMetaStore：按 sessionId 维护 chat 路由元信息。
+ *
+ * 关键点（中文）
+ * - 入站消息到达时由 chat plugin runtime 写入
+ * - 出站按 sessionId/chatKey 发送时由 chat plugin runtime 读取
+ * - 底层数据落在 `.downcity/channel/meta.json`，由 ChannelContextStore 统一维护
+ */
+import { removeChannelSessionRouteBySessionId, readChannelSessionRouteBySessionId, resolveChannelSessionIdByTarget, resolveOrCreateChannelSessionIdByTarget, upsertChannelSessionRouteBySessionId, } from "./ChannelContextStore.js";
+function normalizeSessionId(sessionId) {
+    return String(sessionId || "").trim();
+}
+function normalizeChatId(chatId) {
+    return String(chatId || "").trim();
+}
+/**
+ * 读取指定 sessionId 的 chat meta。
+ */
+export async function readChatMetaBySessionId(params) {
+    const sessionId = normalizeSessionId(params.sessionId);
+    if (!sessionId)
+        return null;
+    const route = await readChannelSessionRouteBySessionId({
+        context: params.context,
+        sessionId,
+    });
+    if (!route)
+        return null;
+    return {
+        v: 1,
+        updatedAt: route.updatedAt,
+        sessionId: route.sessionId,
+        channel: route.channel,
+        chatId: route.chatId,
+        ...(route.targetType ? { targetType: route.targetType } : {}),
+        ...(typeof route.threadId === "number" ? { threadId: route.threadId } : {}),
+        ...(route.messageId ? { messageId: route.messageId } : {}),
+        ...(route.actorId ? { actorId: route.actorId } : {}),
+        ...(route.actorName ? { actorName: route.actorName } : {}),
+        ...(route.chatTitle ? { chatTitle: route.chatTitle } : {}),
+    };
+}
+/**
+ * 更新指定 sessionId 的 chat meta（全量覆盖最近快照）。
+ */
+export async function upsertChatMetaBySessionId(params) {
+    const sessionId = normalizeSessionId(params.sessionId);
+    const chatId = normalizeChatId(params.chatId);
+    if (!sessionId || !chatId)
+        return;
+    await upsertChannelSessionRouteBySessionId({
+        context: params.context,
+        sessionId,
+        target: {
+            channel: params.channel,
+            chatId,
+            ...(typeof params.targetType === "string" ? { targetType: params.targetType } : {}),
+            ...(typeof params.threadId === "number" ? { threadId: params.threadId } : {}),
+        },
+        messageId: params.messageId,
+        actorId: params.actorId,
+        actorName: params.actorName,
+        chatTitle: params.chatTitle,
+    });
+}
+/**
+ * 通过渠道目标查找已有 sessionId。
+ */
+export async function resolveSessionIdByChatTarget(params) {
+    const chatId = normalizeChatId(params.chatId);
+    if (!chatId)
+        return null;
+    return await resolveChannelSessionIdByTarget({
+        context: params.context,
+        target: {
+            channel: params.channel,
+            chatId,
+            ...(typeof params.targetType === "string" ? { targetType: params.targetType } : {}),
+            ...(typeof params.threadId === "number" ? { threadId: params.threadId } : {}),
+        },
+    });
+}
+/**
+ * 通过渠道目标解析或创建 sessionId。
+ */
+export async function resolveOrCreateSessionIdByChatTarget(params) {
+    const chatId = normalizeChatId(params.chatId);
+    if (!chatId)
+        return null;
+    return await resolveOrCreateChannelSessionIdByTarget({
+        context: params.context,
+        target: {
+            channel: params.channel,
+            chatId,
+            ...(typeof params.targetType === "string" ? { targetType: params.targetType } : {}),
+            ...(typeof params.threadId === "number" ? { threadId: params.threadId } : {}),
+        },
+    });
+}
+/**
+ * 删除指定 sessionId 的 chat meta 映射。
+ *
+ * 关键点（中文）
+ * - 删除后该 sessionId 不再可用于 chatKey 路由发送。
+ * - 若同一 target 重新收到入站消息，会创建新的 sessionId。
+ */
+export async function removeChatMetaBySessionId(params) {
+    const sessionId = normalizeSessionId(params.sessionId);
+    if (!sessionId) {
+        return {
+            removed: false,
+            route: null,
+        };
+    }
+    const result = await removeChannelSessionRouteBySessionId({
+        context: params.context,
+        sessionId,
+    });
+    const route = result.route;
+    if (!route) {
+        return {
+            removed: false,
+            route: null,
+        };
+    }
+    return {
+        removed: result.removed,
+        route: {
+            v: 1,
+            updatedAt: route.updatedAt,
+            sessionId: route.sessionId,
+            channel: route.channel,
+            chatId: route.chatId,
+            ...(route.targetType ? { targetType: route.targetType } : {}),
+            ...(typeof route.threadId === "number" ? { threadId: route.threadId } : {}),
+            ...(route.messageId ? { messageId: route.messageId } : {}),
+            ...(route.actorId ? { actorId: route.actorId } : {}),
+            ...(route.actorName ? { actorName: route.actorName } : {}),
+            ...(route.chatTitle ? { chatTitle: route.chatTitle } : {}),
+        },
+    };
+}
+//# sourceMappingURL=ChatMetaStore.js.map

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

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

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

@@ -0,0 +1,17 @@
+/**
+ * ChatPluginActions：chat plugin runtime 的 action 注册表模块。
+ *
+ * 关键点（中文）
+ * - 这里专门负责把 chat 的 CLI/execute 定义装配成 `PluginActions`。
+ * - `ChatPlugin` 本体只保留实例状态与 lifecycle，不再承载大段 action 声明。
+ * - action 执行仍然复用各 runtime 模块，确保行为与现有实现保持一致。
+ */
+import type { PluginActions } from "@downcity/agent/internal/plugin/types/Plugin.js";
+import type { ChatChannelState } from "../../chat/types/ChatRuntime.js";
+/**
+ * 创建 chat plugin runtime 的 action 定义表。
+ */
+export declare function createChatPluginActions(params: {
+    channelState: ChatChannelState;
+}): PluginActions;
+//# sourceMappingURL=ChatPluginActionRegistry.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"ChatPluginActionRegistry.d.ts","sourceRoot":"","sources":["../../../src/chat/runtime/ChatPluginActionRegistry.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AAiBrF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,6BAA6B,CAAC;AAqEpE;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,MAAM,EAAE;IAC9C,YAAY,EAAE,gBAAgB,CAAC;CAChC,GAAG,aAAa,CAyQhB"}