@downcity/plugins 1.0.4

package/bin/chat/channels/BaseChatChannel.d.ts

@@ -0,0 +1,201 @@
+/**
+ * Chat channel 基类。
+ *
+ * 关键点（中文）
+ * - 通过 context 显式注入 runtime 依赖。
+ * - 统一注册 dispatcher，暴露 sendText/sendAction 能力。
+ * - 基类只保留授权、工具发送与入站编排；存储/队列细节已下沉到辅助模块。
+ */
+import type { ChatDispatchAction, ChatDispatchChannel, ChatDispatchSendActionParams } from "../../chat/types/ChatDispatcher.js";
+import type { Logger } from "@downcity/agent/internal/utils/logger/Logger.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import { type ChannelUserMessageMeta } from "./BaseChatChannelSupport.js";
+/**
+ * Channel chatKey 计算入参。
+ *
+ * 说明（中文）
+ * - chatId 必填；其余字段用于区分 topic/thread/消息上下文。
+ * - 不同平台可按需消费这些字段。
+ */
+export type ChannelChatKeyParams = {
+    chatId: string;
+    messageThreadId?: number;
+    chatType?: string;
+    messageId?: string;
+};
+export type ChannelSendTextParams = ChannelChatKeyParams & {
+    text: string;
+    replyToMessage?: boolean;
+};
+export type ChannelSendActionParams = ChannelChatKeyParams & {
+    action: ChatDispatchAction;
+    reactionEmoji?: string;
+    reactionIsBig?: boolean;
+};
+/**
+ * 入站消息统一结构（跨平台最小公共字段）。
+ *
+ * 说明（中文）
+ * - chatId 是平台原始会话标识（非 sessionId）。
+ * - messageThreadId 用于支持 topic / thread 细粒度并发。
+ * - 该结构只描述“接收侧”，不包含平台发送参数。
+ */
+export type IncomingChatMessage = {
+    chatId: string;
+    text: string;
+    chatType?: string;
+    messageId?: string;
+    messageThreadId?: number;
+    userId?: string;
+    username?: string;
+    /**
+     * 用户时区。
+     *
+     * 说明（中文）
+     * - 仅在上游显式提供时传入。
+     * - 第三方 IM 平台 bot 通常不会直接提供该字段。
+     */
+    userTimezone?: string;
+    /**
+     * 会话展示名（群名/频道名/私聊对象名）。
+     *
+     * 说明（中文）
+     * - 由各平台适配器 best-effort 提供。
+     * - 用于 Context 列表展示，不参与路由。
+     */
+    chatTitle?: string;
+    /**
+     * 入站附加元信息。
+     *
+     * 说明（中文）
+     * - 用于透传 reply 上下文等平台特有信息。
+     * - 会进入 history / context metadata，但不改变基础路由语义。
+     */
+    extra?: ChannelUserMessageMeta;
+};
+/**
+ * 入站授权判定输入。
+ */
+export type IncomingAuthorizationParams = {
+    chatId: string;
+    chatType?: string;
+    userId?: string;
+    username?: string;
+    chatTitle?: string;
+};
+/**
+ * 入站授权判定结果。
+ */
+export type IncomingAuthorizationResult = {
+    decision: "allow" | "block";
+    reason: string;
+};
+/**
+ * Chat channel 基类。
+ */
+export declare abstract class BaseChatChannel {
+    readonly channel: ChatDispatchChannel;
+    protected readonly context: AgentContext;
+    protected readonly rootPath: string;
+    protected readonly logger: Logger;
+    protected constructor(params: {
+        channel: ChatDispatchChannel;
+        context: AgentContext;
+    });
+    protected abstract getChatKey(params: ChannelChatKeyParams): string;
+    protected abstract sendTextToPlatform(params: ChannelSendTextParams): Promise<void>;
+    protected sendActionToPlatform?(params: ChannelSendActionParams): Promise<void>;
+    /**
+     * 发送授权提示文本。
+     *
+     * 关键点（中文）
+     * - 一律按普通消息发送，不挂 reply，避免把“权限提示”误挂到某条消息下面。
+     */
+    protected sendAuthorizationText(params: {
+        chatId: string;
+        text: string;
+        chatType?: string;
+        messageThreadId?: number;
+    }): Promise<void>;
+    /**
+     * 记录入站观测主体。
+     */
+    protected observeIncomingAuthorization(params: IncomingAuthorizationParams): Promise<void>;
+    /**
+     * 执行入站授权判定。
+     */
+    protected evaluateIncomingAuthorization(params: IncomingAuthorizationParams): Promise<IncomingAuthorizationResult>;
+    /**
+     * 生成未授权提示文案。
+     */
+    protected buildUnauthorizedBlockedText(params?: {
+        userId?: string;
+        chatId?: string;
+        chatType?: string;
+    }): string;
+    /**
+     * 是否在 `sendToolText` 成功后自动写入 outbound chat history。
+     *
+     * 关键点（中文）
+     * - 默认开启，覆盖 QQ / Feishu 等未自行写 outbound history 的渠道。
+     * - 已有独立 outbound 落盘逻辑的渠道（如 Telegram）应覆写为 false，避免重复记录。
+     */
+    protected shouldAppendOutboundHistoryOnSend(): boolean;
+    /**
+     * 供工具层调用的文本发送统一入口。
+     *
+     * 设计点（中文）
+     * - 空 chatId 视为参数错误。
+     * - 空文本视为幂等 no-op（返回 success）。
+     * - 平台异常收敛为 `{ success: false, error }`，避免抛出破坏工具协议。
+     */
+    sendToolText(params: ChannelSendTextParams): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * 供工具层调用的动作发送入口（如 typing）。
+     *
+     * 设计点（中文）
+     * - action 可选，缺失时按 no-op 处理。
+     * - 若平台未实现 sendActionToPlatform，返回明确 not supported。
+     */
+    sendToolAction(params: ChatDispatchSendActionParams): Promise<{
+        success: boolean;
+        error?: string;
+    }>;
+    /**
+     * 清理某个 sessionId 对应的 agent 会话状态。
+     *
+     * 说明（中文）
+     * - 只清理 runtime / context 层状态，不直接删历史文件。
+     * - 常用于用户触发“重置对话”类命令。
+     */
+    clearChat(sessionId: string): void;
+    /**
+     * 按渠道目标清理会话（映射到内部 sessionId）。
+     */
+    protected clearChatByTarget(params: ChannelChatKeyParams): Promise<void>;
+    /**
+     * 入站消息写入队列（审计用途，不触发执行）。
+     */
+    protected enqueueAuditMessage(params: {
+        chatId: string;
+        messageId?: string;
+        userId?: string;
+        text: string;
+        meta?: ChannelUserMessageMeta;
+    }): Promise<void>;
+    /**
+     * 将消息送入会话调度器队列。
+     *
+     * 返回值语义（中文）
+     * - chatKey: lane 归属键（同 key 串行）。
+     * - position: 当前 lane 中排队位置（便于日志与观测）。
+     */
+    protected enqueueMessage(msg: IncomingChatMessage): Promise<{
+        chatKey: string;
+        position: number;
+    }>;
+}
+//# sourceMappingURL=BaseChatChannel.d.ts.map

package/bin/chat/channels/BaseChatChannel.d.ts.map

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

package/bin/chat/channels/BaseChatChannel.js

@@ -0,0 +1,294 @@
+/**
+ * Chat channel 基类。
+ *
+ * 关键点（中文）
+ * - 通过 context 显式注入 runtime 依赖。
+ * - 统一注册 dispatcher，暴露 sendText/sendAction 能力。
+ * - 基类只保留授权、工具发送与入站编排；存储/队列细节已下沉到辅助模块。
+ */
+import { registerChatSender } from "../../chat/runtime/ChatSendRegistry.js";
+import { resolveChatQueueStore } from "../../chat/runtime/ChatQueue.js";
+import { deleteChatSessionById } from "../../chat/runtime/ChatSessionDelete.js";
+import { guardIncomingChat, observeIncomingChatPrincipal, } from "../../chat/runtime/PluginDispatch.js";
+import { appendToolOutboundChannelHistory, resolveChannelSessionId, } from "./BaseChatChannelSupport.js";
+import { enqueueAuditChannelMessage, enqueueExecChannelMessage, } from "./BaseChatChannelQueue.js";
+/**
+ * Chat channel 基类。
+ */
+export class BaseChatChannel {
+    channel;
+    context;
+    rootPath;
+    logger;
+    constructor(params) {
+        this.channel = params.channel;
+        this.context = params.context;
+        this.rootPath = params.context.rootPath;
+        this.logger = params.context.logger;
+        const dispatcher = {
+            sendText: async (p) => this.sendToolText(p),
+        };
+        if (typeof this.sendActionToPlatform === "function") {
+            dispatcher.sendAction = async (p) => this.sendToolAction(p);
+        }
+        registerChatSender(this.channel, dispatcher);
+    }
+    /**
+     * 发送授权提示文本。
+     *
+     * 关键点（中文）
+     * - 一律按普通消息发送，不挂 reply，避免把“权限提示”误挂到某条消息下面。
+     */
+    async sendAuthorizationText(params) {
+        await this.sendTextToPlatform({
+            chatId: params.chatId,
+            text: params.text,
+            ...(typeof params.chatType === "string" ? { chatType: params.chatType } : {}),
+            ...(typeof params.messageThreadId === "number"
+                ? { messageThreadId: params.messageThreadId }
+                : {}),
+        });
+    }
+    /**
+     * 记录入站观测主体。
+     */
+    async observeIncomingAuthorization(params) {
+        await observeIncomingChatPrincipal({
+            context: this.context,
+            channel: this.channel,
+            chatId: params.chatId,
+            chatType: params.chatType,
+            chatTitle: params.chatTitle,
+            userId: params.userId,
+            username: params.username,
+        });
+    }
+    /**
+     * 执行入站授权判定。
+     */
+    async evaluateIncomingAuthorization(params) {
+        try {
+            await guardIncomingChat({
+                context: this.context,
+                channel: this.channel,
+                input: {
+                    channel: this.channel,
+                    chatId: params.chatId,
+                    chatType: params.chatType,
+                    userId: params.userId,
+                    username: params.username,
+                    chatTitle: params.chatTitle,
+                },
+            });
+            return {
+                decision: "allow",
+                reason: "allow",
+            };
+        }
+        catch (error) {
+            return {
+                decision: "block",
+                reason: String(error || "blocked"),
+            };
+        }
+    }
+    /**
+     * 生成未授权提示文案。
+     */
+    buildUnauthorizedBlockedText(params) {
+        const userId = String(params?.userId || "").trim();
+        const chatId = String(params?.chatId || "").trim();
+        const chatType = String(params?.chatType || "").trim();
+        const lines = [
+            "当前会话权限不足，已拒绝处理。请联系管理员调整你的角色。",
+        ];
+        if (userId) {
+            lines.push("", "请把下面命令发给管理员：", `city chat auth set ${this.channel}:${userId}`);
+        }
+        if (chatId || chatType) {
+            lines.push("", "来源信息：");
+            if (chatId)
+                lines.push(`chatId: ${chatId}`);
+            if (chatType)
+                lines.push(`chatType: ${chatType}`);
+        }
+        return lines.join("\n");
+    }
+    /**
+     * 是否在 `sendToolText` 成功后自动写入 outbound chat history。
+     *
+     * 关键点（中文）
+     * - 默认开启，覆盖 QQ / Feishu 等未自行写 outbound history 的渠道。
+     * - 已有独立 outbound 落盘逻辑的渠道（如 Telegram）应覆写为 false，避免重复记录。
+     */
+    shouldAppendOutboundHistoryOnSend() {
+        return true;
+    }
+    /**
+     * 供工具层调用的文本发送统一入口。
+     *
+     * 设计点（中文）
+     * - 空 chatId 视为参数错误。
+     * - 空文本视为幂等 no-op（返回 success）。
+     * - 平台异常收敛为 `{ success: false, error }`，避免抛出破坏工具协议。
+     */
+    async sendToolText(params) {
+        const chatId = String(params.chatId || "").trim();
+        const text = String(params.text ?? "");
+        if (!chatId)
+            return { success: false, error: "Missing chatId" };
+        if (!text.trim())
+            return { success: true };
+        try {
+            const normalized = { ...params, chatId, text };
+            await this.sendTextToPlatform(normalized);
+            if (this.shouldAppendOutboundHistoryOnSend()) {
+                await appendToolOutboundChannelHistory({
+                    context: this.context,
+                    logger: this.logger,
+                    channel: this.channel,
+                    chatId: normalized.chatId,
+                    chatType: normalized.chatType,
+                    messageThreadId: normalized.messageThreadId,
+                    text: normalized.text,
+                    ...(typeof normalized.messageId === "string"
+                        ? { messageId: normalized.messageId }
+                        : {}),
+                });
+            }
+            return { success: true };
+        }
+        catch (e) {
+            return { success: false, error: String(e) };
+        }
+    }
+    /**
+     * 供工具层调用的动作发送入口（如 typing）。
+     *
+     * 设计点（中文）
+     * - action 可选，缺失时按 no-op 处理。
+     * - 若平台未实现 sendActionToPlatform，返回明确 not supported。
+     */
+    async sendToolAction(params) {
+        const chatId = String(params.chatId || "").trim();
+        if (!chatId)
+            return { success: false, error: "Missing chatId" };
+        const action = params.action;
+        if (!action)
+            return { success: true };
+        const send = this.sendActionToPlatform;
+        if (typeof send !== "function") {
+            return { success: false, error: "sendAction not supported" };
+        }
+        try {
+            await send.call(this, {
+                chatId,
+                action,
+                messageThreadId: params.messageThreadId,
+                chatType: params.chatType,
+                messageId: params.messageId,
+                reactionEmoji: params.reactionEmoji,
+                reactionIsBig: params.reactionIsBig,
+            });
+            return { success: true };
+        }
+        catch (e) {
+            return { success: false, error: String(e) };
+        }
+    }
+    /**
+     * 清理某个 sessionId 对应的 agent 会话状态。
+     *
+     * 说明（中文）
+     * - 只清理 runtime / context 层状态，不直接删历史文件。
+     * - 常用于用户触发“重置对话”类命令。
+     */
+    clearChat(sessionId) {
+        const key = String(sessionId || "").trim();
+        if (!key)
+            return;
+        resolveChatQueueStore(this.context).enqueue({
+            kind: "control",
+            channel: this.channel,
+            targetId: key,
+            sessionId: key,
+            text: "",
+            control: { type: "clear" },
+        });
+        this.logger.info(`Cleared chat: ${key}`);
+    }
+    /**
+     * 按渠道目标清理会话（映射到内部 sessionId）。
+     */
+    async clearChatByTarget(params) {
+        const chatId = String(params.chatId || "").trim();
+        if (!chatId)
+            return;
+        const sessionId = await resolveChannelSessionId({
+            context: this.context,
+            channel: this.channel,
+            chatId,
+            chatType: params.chatType,
+            messageThreadId: params.messageThreadId,
+        });
+        if (!sessionId) {
+            this.logger.info("Skip clear chat: context mapping not found", {
+                channel: this.channel,
+                chatId,
+                chatType: params.chatType,
+                messageThreadId: params.messageThreadId,
+            });
+            return;
+        }
+        const deleted = await deleteChatSessionById({
+            context: this.context,
+            sessionId,
+        });
+        if (!deleted.success) {
+            this.logger.warn("Failed to delete chat context by target", {
+                channel: this.channel,
+                chatId,
+                sessionId,
+                error: deleted.error || "delete failed",
+            });
+            return;
+        }
+        this.logger.info("Deleted chat context by target", {
+            channel: this.channel,
+            chatId,
+            sessionId,
+            removedMeta: deleted.removedMeta,
+            removedChatDir: deleted.removedChatDir,
+            removedSessionDir: deleted.removedSessionDir,
+        });
+    }
+    /**
+     * 入站消息写入队列（审计用途，不触发执行）。
+     */
+    async enqueueAuditMessage(params) {
+        await enqueueAuditChannelMessage({
+            context: this.context,
+            channel: this.channel,
+            chatId: params.chatId,
+            text: params.text,
+            ...(typeof params.messageId === "string" ? { messageId: params.messageId } : {}),
+            ...(typeof params.userId === "string" ? { userId: params.userId } : {}),
+            ...(params.meta ? { meta: params.meta } : {}),
+        });
+    }
+    /**
+     * 将消息送入会话调度器队列。
+     *
+     * 返回值语义（中文）
+     * - chatKey: lane 归属键（同 key 串行）。
+     * - position: 当前 lane 中排队位置（便于日志与观测）。
+     */
+    async enqueueMessage(msg) {
+        return await enqueueExecChannelMessage({
+            context: this.context,
+            channel: this.channel,
+            message: msg,
+        });
+    }
+}
+//# sourceMappingURL=BaseChatChannel.js.map

package/bin/chat/channels/BaseChatChannel.js.map

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

package/bin/chat/channels/BaseChatChannelQueue.d.ts

@@ -0,0 +1,73 @@
+/**
+ * BaseChatChannel 队列编排辅助函数。
+ *
+ * 关键点（中文）
+ * - audit / exec 入队都需要走同一套 prepare + emit 流程。
+ * - 这些逻辑抽离后，`BaseChatChannel` 只负责渠道层输入整理与授权判断。
+ */
+import type { ChatDispatchChannel } from "../../chat/types/ChatDispatcher.js";
+import type { AgentContext } from "@downcity/agent/internal/types/runtime/agent/AgentContext.js";
+import type { IncomingChatMessage } from "./BaseChatChannel.js";
+import { type ChannelUserMessageMeta } from "./BaseChatChannelSupport.js";
+/**
+ * audit 入队输入。
+ */
+export interface EnqueueAuditChannelMessageParams {
+    /**
+     * 当前 execution runtime。
+     */
+    context: AgentContext;
+    /**
+     * 当前渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 平台 chatId。
+     */
+    chatId: string;
+    /**
+     * 文本内容。
+     */
+    text: string;
+    /**
+     * 可选消息 id。
+     */
+    messageId?: string;
+    /**
+     * 可选用户 id。
+     */
+    userId?: string;
+    /**
+     * 可选扩展 meta。
+     */
+    meta?: ChannelUserMessageMeta;
+}
+/**
+ * exec 入队输入。
+ */
+export interface EnqueueExecChannelMessageParams {
+    /**
+     * 当前 execution runtime。
+     */
+    context: AgentContext;
+    /**
+     * 当前渠道。
+     */
+    channel: ChatDispatchChannel;
+    /**
+     * 标准化后的入站消息。
+     */
+    message: IncomingChatMessage;
+}
+/**
+ * 写入 audit 消息并送入 chat queue。
+ */
+export declare function enqueueAuditChannelMessage(params: EnqueueAuditChannelMessageParams): Promise<void>;
+/**
+ * 写入 exec ingress 并送入 chat queue。
+ */
+export declare function enqueueExecChannelMessage(params: EnqueueExecChannelMessageParams): Promise<{
+    chatKey: string;
+    position: number;
+}>;
+//# sourceMappingURL=BaseChatChannelQueue.d.ts.map

package/bin/chat/channels/BaseChatChannelQueue.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BaseChatChannelQueue.d.ts","sourceRoot":"","sources":["../../../src/chat/channels/BaseChatChannelQueue.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAUH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,gCAAgC,CAAC;AAC1E,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAEjG,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,EAIL,KAAK,sBAAsB,EAE5B,MAAM,6BAA6B,CAAC;AAErC;;GAEG;AACH,MAAM,WAAW,gCAAgC;IAC/C;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;OAEG;IACH,MAAM,EAAE,MAAM,CAAC;IACf;;OAEG;IACH,IAAI,EAAE,MAAM,CAAC;IACb;;OAEG;IACH,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB;;OAEG;IACH,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB;;OAEG;IACH,IAAI,CAAC,EAAE,sBAAsB,CAAC;CAC/B;AAED;;GAEG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,OAAO,EAAE,YAAY,CAAC;IACtB;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;IAC7B;;OAEG;IACH,OAAO,EAAE,mBAAmB,CAAC;CAC9B;AAED;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,MAAM,EAAE,gCAAgC,GACvC,OAAO,CAAC,IAAI,CAAC,CAkGf;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,MAAM,EAAE,+BAA+B,GACtC,OAAO,CAAC;IAAE,OAAO,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,CAiIhD"}