@downcity/plugins 1.0.216 → 1.0.236

package/src/chat/channels/BaseChatChannelSupport.ts

@@ -8,7 +8,7 @@
 
 import type { ChatDispatchChannel } from "@/chat/types/ChatDispatcher.js";
 import type { Logger } from "@downcity/agent";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { JsonObject, JsonValue } from "@downcity/agent";
 import {
   resolveSessionIdByChatTarget,
@@ -31,13 +31,13 @@ export type ChannelUserMessageMeta = {
 };
 
 /**
- * 基于渠道目标解析 sessionId 的输入。
+ * 基于渠道目标解析 session_id 的输入。
  */
 export interface ChannelSessionTargetParams {
   /**
    * 当前 execution runtime。
    */
-  context: AgentContext;
+  context: PluginContext;
   /**
    * 当前渠道。
    */
@@ -63,15 +63,15 @@ export interface ChannelChatMetaParams {
   /**
    * 当前 execution runtime。
    */
-  context: AgentContext;
+  context: PluginContext;
   /**
    * 当前渠道。
    */
   channel: ChatDispatchChannel;
   /**
-   * sessionId。
+   * session_id。
    */
-  sessionId: string;
+  session_id: string;
   /**
    * 平台 chatId。
    */
@@ -87,7 +87,7 @@ export interface ChannelChatMetaParams {
   /**
    * 可选消息 id。
    */
-  messageId?: string;
+  message_id?: string;
   /**
    * 可选用户 id。
    */
@@ -109,7 +109,7 @@ export interface ChannelInboundHistoryParams {
   /**
    * 当前 execution runtime。
    */
-  context: AgentContext;
+  context: PluginContext;
   /**
    * 日志器。
    */
@@ -119,9 +119,9 @@ export interface ChannelInboundHistoryParams {
    */
   channel: ChatDispatchChannel;
   /**
-   * sessionId。
+   * session_id。
    */
-  sessionId: string;
+  session_id: string;
   /**
    * 平台 chatId。
    */
@@ -145,7 +145,7 @@ export interface ChannelInboundHistoryParams {
   /**
    * 可选消息 id。
    */
-  messageId?: string;
+  message_id?: string;
   /**
    * 可选用户 id。
    */
@@ -175,7 +175,7 @@ export interface ChannelToolOutboundHistoryParams extends ChannelSessionTargetPa
   /**
    * 可选消息 id。
    */
-  messageId?: string;
+  message_id?: string;
 }
 
 /**
@@ -190,7 +190,7 @@ export function stripUndefinedMeta(meta: ChannelUserMessageMeta): JsonObject {
 }
 
 /**
- * 通过渠道目标解析或创建 sessionId。
+ * 通过渠道目标解析或创建 session_id。
  */
 export async function resolveOrCreateChannelSessionId(
   params: ChannelSessionTargetParams,
@@ -209,7 +209,7 @@ export async function resolveOrCreateChannelSessionId(
 }
 
 /**
- * 通过渠道目标解析已有 sessionId。
+ * 通过渠道目标解析已有 session_id。
  */
 export async function resolveChannelSessionId(
   params: ChannelSessionTargetParams,
@@ -235,12 +235,12 @@ export async function updateChannelChatMeta(
 ): Promise<void> {
   await upsertChatMetaBySessionId({
     context: params.context,
-    sessionId: params.sessionId,
+    session_id: params.session_id,
     channel: params.channel,
     chatId: params.chatId,
     targetType: params.targetType,
     threadId: params.threadId,
-    messageId: params.messageId,
+    message_id: params.message_id,
     actorId: params.actorId,
     actorName: params.actorName,
     chatTitle: params.chatTitle,
@@ -256,14 +256,14 @@ export async function appendInboundChannelHistory(
   try {
     await appendInboundChatHistory({
       context: params.context,
-      sessionId: params.sessionId,
+      session_id: params.session_id,
       channel: params.channel,
       chatId: params.chatId,
       ingressKind: params.ingressKind,
       text: params.text,
       targetType: params.targetType,
       threadId: params.threadId,
-      messageId: params.messageId,
+      message_id: params.message_id,
       actorId: params.actorId,
       actorName: params.actorName,
       extra: params.extra,
@@ -272,7 +272,7 @@ export async function appendInboundChannelHistory(
     params.logger.warn("Failed to append inbound chat history", {
       error: String(error),
       channel: params.channel,
-      sessionId: params.sessionId,
+      session_id: params.session_id,
       chatId: params.chatId,
       ingressKind: params.ingressKind,
     });
@@ -289,13 +289,13 @@ export async function appendToolOutboundChannelHistory(
   const text = String(params.text ?? "");
   if (!chatId || !text.trim()) return;
 
-  const sessionId = await resolveOrCreateChannelSessionId(params);
-  if (!sessionId) return;
+  const session_id = await resolveOrCreateChannelSessionId(params);
+  if (!session_id) return;
 
   try {
     await appendOutboundChatHistory({
       context: params.context,
-      sessionId,
+      session_id,
       channel: params.channel,
       chatId,
       text,
@@ -303,8 +303,8 @@ export async function appendToolOutboundChannelHistory(
       ...(typeof params.messageThreadId === "number"
         ? { threadId: params.messageThreadId }
         : {}),
-      ...(typeof params.messageId === "string" && params.messageId
-        ? { messageId: params.messageId }
+      ...(typeof params.message_id === "string" && params.message_id
+        ? { message_id: params.message_id }
         : {}),
       extra: {
         source: "channel_send_tool_text",
@@ -314,7 +314,7 @@ export async function appendToolOutboundChannelHistory(
     params.logger.warn("Failed to append outbound chat history", {
       error: String(error),
       channel: params.channel,
-      sessionId,
+      session_id,
       chatId,
     });
   }

package/src/chat/channels/RuntimeChannel.ts

@@ -4,14 +4,13 @@
  * 关键点（中文）
  * - channel 对象是 ChatPlugin 的运行态配置单元。
  * - env 由 channel 自己读取，ChatPlugin 不理解平台字段。
- * - channelAccountId 仅作为账号池绑定能力保留，不再是 ChatPlugin 顶层配置。
+ * - Resource 已由宿主解析为构造参数，channel 不访问账号池或其他外部 Store。
  */
 
-import type { AgentContext } from "@downcity/agent";
-import type { StoredChannelAccount } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { ChatChannelName } from "@/chat/types/ChannelStatus.js";
 import type { ChatChannel } from "@/chat/types/ChatPluginOptions.js";
-import { getStoredChannelAccountSync } from "@/chat/accounts/Store.js";
+import type { ChatRuntimeAccount } from "@/chat/types/ChatRuntimeAccount.js";
 
 /**
  * env 字典。
@@ -39,13 +38,9 @@ export interface BaseChatChannelOptions {
    */
   env?: ChatChannelEnv;
   /**
-   * 可选账号池绑定 ID。
-   *
-   * 说明（中文）
-   * - 仅在需要复用全局账号池时使用。
-   * - SDK 主路径推荐直接通过 `env` 传入凭据。
+   * Resource 或 SDK 调用方提供的稳定 ID。
    */
-  channelAccountId?: string;
+  id?: string;
   /**
    * 运行态展示名称。
    */
@@ -60,36 +55,29 @@ abstract class BaseRuntimeChatChannel implements ChatChannel {
 
   protected enabled: boolean;
   protected env: ChatChannelEnv;
-  protected channelAccountId: string;
-  protected displayName: string;
+  protected resource_id: string;
+  protected display_name: string;
 
   protected constructor(options: BaseChatChannelOptions = {}) {
     this.enabled = options.enabled !== false;
     this.env = options.env || {};
-    this.channelAccountId = String(options.channelAccountId || "").trim();
-    this.displayName = String(options.name || "").trim();
+    this.resource_id = String(options.id || "").trim();
+    this.display_name = String(options.name || "").trim();
   }
 
-  isEnabled(_context: AgentContext): boolean {
+  isEnabled(_context: PluginContext): boolean {
     return this.enabled;
   }
 
-  getChannelAccountId(_context: AgentContext): string {
-    return this.channelAccountId;
-  }
-
-  protected getStoredAccount(): StoredChannelAccount | null {
-    if (!this.channelAccountId) return null;
-    const account = getStoredChannelAccountSync(this.channelAccountId);
-    if (!account || account.channel !== this.name) return null;
-    return account;
+  getResourceId(_context: PluginContext): string {
+    return this.resource_id;
   }
 
   protected nowIso(): string {
     return new Date().toISOString();
   }
 
-  abstract getAccount(context: AgentContext): StoredChannelAccount | null;
+  abstract getAccount(context: PluginContext): ChatRuntimeAccount | null;
 }
 
 /**
@@ -102,7 +90,7 @@ export interface TelegramChannelOptions extends BaseChatChannelOptions {
    * 说明（中文）
    * - 优先级高于 `env.TELEGRAM_BOT_TOKEN`。
    */
-  botToken?: string;
+  bot_token?: string;
 }
 
 /**
@@ -110,27 +98,24 @@ export interface TelegramChannelOptions extends BaseChatChannelOptions {
  */
 export class TelegramChannel extends BaseRuntimeChatChannel {
   readonly name = "telegram" as const;
-  private readonly botToken?: string;
+  private readonly bot_token?: string;
 
   constructor(options: TelegramChannelOptions = {}) {
     super(options);
-    this.botToken = String(options.botToken || "").trim() || undefined;
+    this.bot_token = String(options.bot_token || "").trim() || undefined;
   }
 
-  getAccount(_context: AgentContext): StoredChannelAccount | null {
-    const storedAccount = this.getStoredAccount();
-    if (storedAccount) return storedAccount;
-
-    const token = String(this.botToken || this.env.TELEGRAM_BOT_TOKEN || "").trim();
+  getAccount(_context: PluginContext): ChatRuntimeAccount | null {
+    const token = String(this.bot_token || this.env.TELEGRAM_BOT_TOKEN || "").trim();
     if (!token) return null;
     const now = this.nowIso();
     return {
-      id: this.channelAccountId || "chat-sdk-telegram",
+      id: this.resource_id || "chat-sdk-telegram",
       channel: "telegram",
-      name: this.displayName || "telegram",
-      botToken: token,
-      createdAt: now,
-      updatedAt: now,
+      name: this.display_name || "telegram",
+      bot_token: token,
+      created_at: now,
+      updated_at: now,
     };
   }
 }
@@ -142,11 +127,11 @@ export interface FeishuChannelOptions extends BaseChatChannelOptions {
   /**
    * Feishu / Lark App ID。
    */
-  appId?: string;
+  app_id?: string;
   /**
    * Feishu / Lark App Secret。
    */
-  appSecret?: string;
+  app_secret?: string;
   /**
    * Feishu / Lark Open API 域名。
    */
@@ -158,37 +143,34 @@ export interface FeishuChannelOptions extends BaseChatChannelOptions {
  */
 export class FeishuChannel extends BaseRuntimeChatChannel {
   readonly name = "feishu" as const;
-  private readonly appId?: string;
-  private readonly appSecret?: string;
+  private readonly app_id?: string;
+  private readonly app_secret?: string;
   private readonly domain?: string;
 
   constructor(options: FeishuChannelOptions = {}) {
     super(options);
-    this.appId = String(options.appId || "").trim() || undefined;
-    this.appSecret = String(options.appSecret || "").trim() || undefined;
+    this.app_id = String(options.app_id || "").trim() || undefined;
+    this.app_secret = String(options.app_secret || "").trim() || undefined;
     this.domain = String(options.domain || "").trim() || undefined;
   }
 
-  getAccount(_context: AgentContext): StoredChannelAccount | null {
-    const storedAccount = this.getStoredAccount();
-    if (storedAccount) return storedAccount;
-
-    const appId = String(this.appId || this.env.FEISHU_APP_ID || "").trim();
+  getAccount(_context: PluginContext): ChatRuntimeAccount | null {
+    const appId = String(this.app_id || this.env.FEISHU_APP_ID || "").trim();
     const appSecret = String(
-      this.appSecret || this.env.FEISHU_APP_SECRET || "",
+      this.app_secret || this.env.FEISHU_APP_SECRET || "",
     ).trim();
     const domain = String(this.domain || this.env.FEISHU_DOMAIN || "").trim();
     if (!appId || !appSecret) return null;
     const now = this.nowIso();
     return {
-      id: this.channelAccountId || "chat-sdk-feishu",
+      id: this.resource_id || "chat-sdk-feishu",
       channel: "feishu",
-      name: this.displayName || "feishu",
-      appId,
-      appSecret,
+      name: this.display_name || "feishu",
+      app_id: appId,
+      app_secret: appSecret,
       ...(domain ? { domain } : {}),
-      createdAt: now,
-      updatedAt: now,
+      created_at: now,
+      updated_at: now,
     };
   }
 }
@@ -200,11 +182,11 @@ export interface QqChannelOptions extends BaseChatChannelOptions {
   /**
    * QQ Bot App ID。
    */
-  appId?: string;
+  app_id?: string;
   /**
    * QQ Bot App Secret。
    */
-  appSecret?: string;
+  app_secret?: string;
   /**
    * 是否使用 QQ 沙箱模式。
    */
@@ -216,37 +198,34 @@ export interface QqChannelOptions extends BaseChatChannelOptions {
  */
 export class QqChannel extends BaseRuntimeChatChannel {
   readonly name = "qq" as const;
-  private readonly appId?: string;
-  private readonly appSecret?: string;
+  private readonly app_id?: string;
+  private readonly app_secret?: string;
   private readonly sandbox?: boolean;
 
   constructor(options: QqChannelOptions = {}) {
     super(options);
-    this.appId = String(options.appId || "").trim() || undefined;
-    this.appSecret = String(options.appSecret || "").trim() || undefined;
+    this.app_id = String(options.app_id || "").trim() || undefined;
+    this.app_secret = String(options.app_secret || "").trim() || undefined;
     this.sandbox = options.sandbox === true;
   }
 
-  getAccount(_context: AgentContext): StoredChannelAccount | null {
-    const storedAccount = this.getStoredAccount();
-    if (storedAccount) return storedAccount;
-
-    const appId = String(this.appId || this.env.QQ_APP_ID || "").trim();
-    const appSecret = String(this.appSecret || this.env.QQ_APP_SECRET || "").trim();
+  getAccount(_context: PluginContext): ChatRuntimeAccount | null {
+    const appId = String(this.app_id || this.env.QQ_APP_ID || "").trim();
+    const appSecret = String(this.app_secret || this.env.QQ_APP_SECRET || "").trim();
     const sandbox =
       this.sandbox === true ||
       String(this.env.QQ_SANDBOX || "").trim().toLowerCase() === "true";
     if (!appId || !appSecret) return null;
     const now = this.nowIso();
     return {
-      id: this.channelAccountId || "chat-sdk-qq",
+      id: this.resource_id || "chat-sdk-qq",
       channel: "qq",
-      name: this.displayName || "qq",
-      appId,
-      appSecret,
+      name: this.display_name || "qq",
+      app_id: appId,
+      app_secret: appSecret,
       ...(sandbox ? { sandbox: true } : {}),
-      createdAt: now,
-      updatedAt: now,
+      created_at: now,
+      updated_at: now,
     };
   }
 }

package/src/chat/channels/feishu/Feishu.ts

@@ -14,7 +14,7 @@ import type {
   ChannelChatKeyParams,
   ChannelSendTextParams,
 } from "@/chat/channels/BaseChatChannel.js";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { JsonObject } from "@downcity/agent";
 import type { ChatChannelTestResult } from "@/chat/types/ChannelStatus.js";
 import type { ParsedFeishuAttachmentCommand } from "@/chat/types/FeishuAttachment.js";
@@ -55,7 +55,7 @@ export class FeishuBot extends BaseChatChannel {
   > = new Map();
 
   constructor(
-    context: AgentContext,
+    context: PluginContext,
     appId: string,
     appSecret: string,
     domain: string | undefined,
@@ -64,7 +64,7 @@ export class FeishuBot extends BaseChatChannel {
     this.appId = appId;
     this.appSecret = appSecret;
     this.domain = domain;
-    this.dedupeDir = get_feishu_dedupe_dir_path(context.rootPath);
+    this.dedupeDir = get_feishu_dedupe_dir_path(context.workspace_path);
     this.platform = new FeishuPlatformClient({
       context,
       config: {
@@ -91,13 +91,13 @@ export class FeishuBot extends BaseChatChannel {
     params: ChannelSendTextParams,
   ): Promise<void> {
     const chatType = typeof params.chatType === "string" ? params.chatType : "p2p";
-    const messageId =
-      typeof params.messageId === "string" ? params.messageId : undefined;
+    const message_id =
+      typeof params.message_id === "string" ? params.message_id : undefined;
     const text = String(params.text ?? "");
-    const shouldReplyToMessage = params.replyToMessage === true;
+    const shouldReplyToMessage = params.reply_to_message === true;
 
-    if (shouldReplyToMessage && messageId && chatType !== "p2p") {
-      await this.sendMessage(params.chatId, chatType, messageId, text);
+    if (shouldReplyToMessage && message_id && chatType !== "p2p") {
+      await this.sendMessage(params.chatId, chatType, message_id, text);
     } else {
       await this.sendChatMessage(params.chatId, chatType, text);
     }
@@ -222,14 +222,14 @@ export class FeishuBot extends BaseChatChannel {
       },
       buildAccessBlockedText: (params) =>
         this.buildAccessBlockedText(params),
-      runInChat: async (chatKey, fn) => {
-        await this.runInChat(chatKey, fn);
+      runInChat: async (chat_key, fn) => {
+        await this.runInChat(chat_key, fn);
       },
       handleCommand: async (params) => {
         await this.handleCommand(
           params.chatId,
           params.chatType,
-          params.messageId,
+          params.message_id,
           params.command,
         );
       },
@@ -237,7 +237,7 @@ export class FeishuBot extends BaseChatChannel {
         await this.executeAndReply(
           params.chatId,
           params.chatType,
-          params.messageId,
+          params.message_id,
           params.instructions,
           params.actorId,
           params.actorName,
@@ -249,7 +249,7 @@ export class FeishuBot extends BaseChatChannel {
         await this.sendErrorMessage(
           params.chatId,
           params.chatType,
-          params.messageId,
+          params.message_id,
           params.errorText,
         );
       },
@@ -262,7 +262,7 @@ export class FeishuBot extends BaseChatChannel {
   private async handleCommand(
     chatId: string,
     chatType: string,
-    messageId: string,
+    message_id: string,
     command: string,
   ): Promise<void> {
     this.logger.info(`Received Feishu command: ${command}`);
@@ -300,7 +300,7 @@ Available commands:
         responseText = `Unknown command: ${command}\nType /help to view available commands`;
     }
 
-    await this.sendMessage(chatId, chatType, messageId, responseText);
+    await this.sendMessage(chatId, chatType, message_id, responseText);
   }
 
   /**
@@ -309,7 +309,7 @@ Available commands:
   private async executeAndReply(
     chatId: string,
     chatType: string,
-    messageId: string,
+    message_id: string,
     instructions: string,
     actorId?: string,
     actorName?: string,
@@ -317,18 +317,18 @@ Available commands:
     extra?: JsonObject,
   ): Promise<void> {
     try {
-      const { chatKey } = await this.enqueueMessage({
+      const { chat_key } = await this.enqueueMessage({
         chatId,
         text: instructions,
         chatType,
-        messageId,
-        userId: actorId,
+        message_id,
+        user_id: actorId,
         username: actorName,
         chatTitle,
         ...(extra ? { extra } : {}),
       });
 
-      this.knownChats.set(chatKey, {
+      this.knownChats.set(chat_key, {
         chatId,
         chatType,
         ...(chatTitle ? { chatTitle } : {}),
@@ -337,7 +337,7 @@ Available commands:
       await this.sendErrorMessage(
         chatId,
         chatType,
-        messageId,
+        message_id,
         `Execution error: ${String(error)}`,
       );
     }
@@ -349,11 +349,11 @@ Available commands:
   async sendMessage(
     chatId: string,
     chatType: string,
-    messageId: string,
+    message_id: string,
     text: string,
   ): Promise<void> {
     const parsed = parseFeishuAttachments(text);
-    await this.sendParsedMessage(chatId, chatType, messageId, parsed.segments);
+    await this.sendParsedMessage(chatId, chatType, message_id, parsed.segments);
   }
 
   /**
@@ -374,7 +374,7 @@ Available commands:
   private async sendParsedMessage(
     chatId: string,
     chatType: string,
-    messageId: string | undefined,
+    message_id: string | undefined,
     segments: Array<
       | {
           kind: "text";
@@ -390,16 +390,16 @@ Available commands:
       if (segment.kind === "text") {
         const normalizedText = String(segment.text || "").trim();
         if (!normalizedText) continue;
-        await this.sendPlatformMessage(chatId, chatType, messageId, "text", {
+        await this.sendPlatformMessage(chatId, chatType, message_id, "text", {
           text: normalizedText,
         });
         continue;
       }
 
       try {
-        await this.sendAttachment(chatId, chatType, messageId, segment.attachment);
+        await this.sendAttachment(chatId, chatType, message_id, segment.attachment);
       } catch (error) {
-        await this.sendPlatformMessage(chatId, chatType, messageId, "text", {
+        await this.sendPlatformMessage(chatId, chatType, message_id, "text", {
           text: `❌ Failed to send attachment: ${segment.attachment.pathOrUrl}\n${String(error)}`,
         });
       }
@@ -412,10 +412,10 @@ Available commands:
   async sendAttachment(
     chatId: string,
     chatType: string,
-    messageId: string | undefined,
+    message_id: string | undefined,
     attachment: ParsedFeishuAttachmentCommand,
   ): Promise<void> {
-    await this.platform.sendAttachment(chatId, chatType, messageId, attachment);
+    await this.platform.sendAttachment(chatId, chatType, message_id, attachment);
   }
 
   /**
@@ -424,11 +424,11 @@ Available commands:
   async sendPlatformMessage(
     chatId: string,
     chatType: string,
-    messageId: string | undefined,
+    message_id: string | undefined,
     msgType: FeishuMessagePayloadType,
     content: Record<string, unknown> | string,
   ): Promise<void> {
-    await this.platform.sendPlatformMessage(chatId, chatType, messageId, msgType, content);
+    await this.platform.sendPlatformMessage(chatId, chatType, message_id, msgType, content);
   }
 
   /**
@@ -437,10 +437,10 @@ Available commands:
   private async sendErrorMessage(
     chatId: string,
     chatType: string,
-    messageId: string,
+    message_id: string,
     errorText: string,
   ): Promise<void> {
-    await this.sendMessage(chatId, chatType, messageId, `❌ ${errorText}`);
+    await this.sendMessage(chatId, chatType, message_id, `❌ ${errorText}`);
   }
 
   /**
@@ -452,7 +452,7 @@ Available commands:
   }
 
   /**
-   * 生成 chatKey。
+   * 生成 chat_key。
    */
   private buildChatKey(chatId: string): string {
     return `feishu-chat-${chatId}`;
@@ -464,7 +464,7 @@ Available commands:
  */
 export async function createFeishuBot(
   config: FeishuConfig,
-  context: AgentContext,
+  context: PluginContext,
 ): Promise<FeishuBot | null> {
   if (!config.enabled || !config.appId || !config.appSecret) {
     return null;

package/src/chat/channels/feishu/FeishuInbound.ts

@@ -19,9 +19,9 @@ export function extractFeishuSenderIdentity(
     return { senderId: openId, idType: "open_id" };
   }
 
-  const userId = String(data?.sender?.sender_id?.user_id || "").trim();
-  if (userId) {
-    return { senderId: userId, idType: "user_id" };
+  const user_id = String(data?.sender?.sender_id?.user_id || "").trim();
+  if (user_id) {
+    return { senderId: user_id, idType: "user_id" };
   }
 
   const unionId = String(data?.sender?.sender_id?.union_id || "").trim();