@downcity/plugins 1.0.216 → 1.0.233

package/src/chat/runtime/ChatPluginActionRegistry.ts

@@ -9,7 +9,7 @@
 
 import type { Command } from "commander";
 import type { PluginActions } from "@downcity/agent";
-import { createAction } from "@downcity/agent";
+import { create_action } from "@downcity/agent";
 import { z } from "zod";
 import type {
   ChatDeleteActionPayload,
@@ -53,34 +53,28 @@ import {
 const CHAT_SEND_HELP_TEXT = [
   "",
   "消息协议：",
-  "  frontmatter metadata 字段语义与 `downcity chat send` 参数一致。",
+  "  frontmatter metadata 字段语义与 Chat send action 输入一致。",
   "  附件使用 `<file type=\"...\">path</file>`，支持 `document/photo/voice/audio/video`。",
   "  正文与 `<file>` 可以交错出现，运行时会按原顺序发送。",
   "",
   "常用示例：",
-  "  downcity chat send --text 'done'",
-  "  downcity chat send --chat-key <chatKey> --text 'done'",
-  "  cat <<'EOF' | downcity chat send --stdin --chat-key <chatKey>",
-  "  第一行",
-  "  第二行",
-  "  EOF",
-  "  downcity chat send --text-file ./result.md --chat-key <chatKey>",
+  "  city plugin action chat send <agent_id> --input '{\"text\":\"done\"}' --token <token>",
+  "  city plugin action chat send <agent_id> --input '{\"chat_key\":\"<chat_key>\",\"text\":\"done\"}' --token <token>",
   "",
   "说明：",
   "  当前会话可省略 `--chat-key`；跨 chat 发送时必须显式传 `--chat-key`。",
-  "  `--delay` 与 `--time` 互斥；ISO 时间必须带时区。",
+  "  `delay` 与 `time` 互斥；ISO 时间必须带时区。",
 ].join("\n");
 
 const CHAT_REACT_HELP_TEXT = [
   "",
   "常用示例：",
-  "  downcity chat react --emoji '👍'",
-  "  downcity chat react --emoji '✅' --message-id <messageId>",
-  "  downcity chat react --chat-key <chatKey> --message-id <messageId> --emoji '🔥'",
+  "  city plugin action chat react <agent_id> --input '{\"emoji\":\"👍\"}' --token <token>",
+  "  city plugin action chat react <agent_id> --input '{\"chat_key\":\"<chat_key>\",\"message_id\":\"<message_id>\",\"emoji\":\"🔥\"}' --token <token>",
   "",
   "说明：",
   "  当前会话可省略 `--chat-key`；跨 chat 操作时显式传 `--chat-key`。",
-  "  `react` 需要目标消息，优先使用显式 `--message-id`。",
+  "  `react` 需要目标消息，优先使用显式 `message_id`。",
 ].join("\n");
 
 function attachCommandHelpText(command: Command, text: string): void {
@@ -96,7 +90,7 @@ export function createChatPluginActions(params: {
   channelState: ChatChannelState;
 }): PluginActions {
   return {
-    status: createAction({
+    status: create_action({
       description: "View chat channel connection status.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -107,7 +101,7 @@ export function createChatPluginActions(params: {
         configure(command: Command) {
           command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
-        mapInput: mapChatChannelCommandInput,
+        map_input: mapChatChannelCommandInput,
       },
       execute: async (actionParams) => {
         return executeChatStatusAction({
@@ -117,7 +111,7 @@ export function createChatPluginActions(params: {
         });
       },
     }),
-    test: createAction({
+    test: create_action({
       description: "Test chat channel connectivity.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -128,7 +122,7 @@ export function createChatPluginActions(params: {
         configure(command: Command) {
           command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
-        mapInput: mapChatChannelCommandInput,
+        map_input: mapChatChannelCommandInput,
       },
       execute: async (actionParams) => {
         return executeChatTestAction({
@@ -138,7 +132,7 @@ export function createChatPluginActions(params: {
         });
       },
     }),
-    reconnect: createAction({
+    reconnect: create_action({
       description: "Reconnect chat channels, all by default.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -149,7 +143,7 @@ export function createChatPluginActions(params: {
         configure(command: Command) {
           command.option("--channel <name>", "Specify channel (telegram|feishu|qq).");
         },
-        mapInput: mapChatChannelCommandInput,
+        map_input: mapChatChannelCommandInput,
       },
       execute: async (actionParams) => {
         return executeChatReconnectAction({
@@ -159,21 +153,21 @@ export function createChatPluginActions(params: {
         });
       },
     }),
-    list: createAction({
+    list: create_action({
       description: "List chat conversations recorded by the current agent.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "List chat conversations recorded by the current agent (chatTitle/chatKey).",
+        description: "List chat conversations recorded by the current agent (chatTitle/chat_key).",
         configure(command: Command) {
           command
             .option("--channel <name>", "Filter by channel (telegram|feishu|qq).")
             .option("--limit <n>", "Return the latest N records, default 50.")
-            .option("--q <text>", "Keyword filter (title/chatId/sessionId/actor).");
+            .option("--q <text>", "Keyword filter (title/chatId/session_id/actor).");
         },
-        mapInput: mapChatListCommandInput,
+        map_input: mapChatListCommandInput,
       },
       execute: async (actionParams) => {
         return executeChatListAction({
@@ -182,7 +176,7 @@ export function createChatPluginActions(params: {
         });
       },
     }),
-    info: createAction({
+    info: create_action({
       description: "View route, paths, and context snapshot for a specified chat conversation.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -192,27 +186,27 @@ export function createChatPluginActions(params: {
         description: "View specified chat conversation info (route/local paths/context snapshot).",
         configure(command: Command) {
           command
-            .option("--chat-key <chatKey>", "Target chatKey; reads DC_CTX_CHAT_KEY if omitted.")
-            .option("--session-id <sessionId>", "Explicit sessionId, with higher priority.");
+            .option("--chat-key <chat_key>", "Target chat_key; reads DC_CTX_CHAT_KEY if omitted.")
+            .option("--session-id <session_id>", "Explicit session_id, with higher priority.");
         },
-        mapInput: mapChatInfoCommandInput,
+        map_input: mapChatInfoCommandInput,
       },
       execute: async (actionParams) => {
         return executeChatInfoAction({
           context: actionParams.context,
           payload: actionParams.input as ChatInfoActionPayload,
-          run_context: actionParams.run_context,
+          execution_context: actionParams.execution_context,
         });
       },
     }),
-    send: createAction({
-      description: "Send a message to the target chatKey, supporting text, attachments, and delay.",
+    send: create_action({
+      description: "Send a message to the target chat_key, supporting text, attachments, and delay.",
       input_schema: {
         zod: z.object({}).passthrough(),
         json_schema: { type: "object", properties: {}, additionalProperties: true },
       },
       command: {
-        description: "Send a message to the target chatKey.",
+        description: "Send a message to the target chat_key.",
         configure(command: Command) {
           command
             .option("--text <text>", "Message body.")
@@ -221,22 +215,22 @@ export function createChatPluginActions(params: {
             .option("--reply", "Explicitly reply to the target message with reply_to_message.", false)
             .option("--message-id <id>", "Explicit reply target message ID.")
             .option(
-              "--chat-key <chatKey>",
-              "Target chatKey; reads DC_CTX_CHAT_KEY if omitted.",
+              "--chat-key <chat_key>",
+              "Target chat_key; reads DC_CTX_CHAT_KEY if omitted.",
             );
           attachCommandHelpText(command, CHAT_SEND_HELP_TEXT);
         },
-        mapInput: mapChatSendCommandInput,
+        map_input: mapChatSendCommandInput,
       },
       execute: async (actionParams) => {
         return executeChatSendAction({
           context: actionParams.context,
           payload: actionParams.input as ChatSendActionPayload,
-          run_context: actionParams.run_context,
+          execution_context: actionParams.execution_context,
         });
       },
     }),
-    react: createAction({
+    react: create_action({
       description: "React to a target message, currently supported only by Telegram.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -250,22 +244,22 @@ export function createChatPluginActions(params: {
             .option("--big", "Use large reaction effect (Telegram is_big).", false)
             .option("--message-id <id>", "Target message ID; defaults to chat meta when available.")
             .option(
-              "--chat-key <chatKey>",
-              "Target chatKey; reads DC_CTX_CHAT_KEY if omitted.",
+              "--chat-key <chat_key>",
+              "Target chat_key; reads DC_CTX_CHAT_KEY if omitted.",
             );
           attachCommandHelpText(command, CHAT_REACT_HELP_TEXT);
         },
-        mapInput: mapChatReactCommandInput,
+        map_input: mapChatReactCommandInput,
       },
       execute: async (actionParams) => {
         return executeChatReactAction({
           context: actionParams.context,
           payload: actionParams.input as ChatReactActionPayload,
-          run_context: actionParams.run_context,
+          execution_context: actionParams.execution_context,
         });
       },
     }),
-    context: createAction({
+    context: create_action({
       description: "View current conversation context snapshot.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -274,13 +268,13 @@ export function createChatPluginActions(params: {
       command: {
         description: "View current conversation context snapshot.",
         configure(command: Command) {
-          command.option("--chat-key <chatKey>", "Explicitly override chatKey.");
+          command.option("--chat-key <chat_key>", "Explicitly override chat_key.");
         },
-        mapInput(input) {
-          const chatKey =
-            typeof input.opts.chatKey === "string" ? String(input.opts.chatKey).trim() : "";
+        map_input(input) {
+          const chat_key =
+            typeof input.opts.chat_key === "string" ? String(input.opts.chat_key).trim() : "";
           return {
-            ...(chatKey ? { chatKey } : {}),
+            ...(chat_key ? { chat_key } : {}),
           };
         },
       },
@@ -288,11 +282,11 @@ export function createChatPluginActions(params: {
         return executeChatContextAction({
           context: actionParams.context,
           payload: actionParams.input as ChatSessionActionPayload,
-          run_context: actionParams.run_context,
+          execution_context: actionParams.execution_context,
         });
       },
     }),
-    delete: createAction({
+    delete: create_action({
       description: "Permanently delete a specified chat conversation, including mapping, history, and context.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -302,20 +296,20 @@ export function createChatPluginActions(params: {
         description: "Permanently delete a specified chat conversation, including mapping, history, and context.",
         configure(command: Command) {
           command
-            .option("--chat-key <chatKey>", "Explicit chatKey.")
-            .option("--session-id <sessionId>", "Explicit sessionId.");
+            .option("--chat-key <chat_key>", "Explicit chat_key.")
+            .option("--session-id <session_id>", "Explicit session_id.");
         },
-        mapInput: mapChatDeleteCommandInput,
+        map_input: mapChatDeleteCommandInput,
       },
       execute: async (actionParams) => {
         return executeChatDeleteAction({
           context: actionParams.context,
           payload: actionParams.input as ChatDeleteActionPayload,
-          run_context: actionParams.run_context,
+          execution_context: actionParams.execution_context,
         });
       },
     }),
-    history: createAction({
+    history: create_action({
       description: "Read chat history messages.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -325,8 +319,8 @@ export function createChatPluginActions(params: {
         description: "Read chat history messages, defaulting to the latest 30.",
         configure(command: Command) {
           command
-            .option("--chat-key <chatKey>", "Explicitly override chatKey.")
-            .option("--session-id <sessionId>", "Explicitly override sessionId.")
+            .option("--chat-key <chat_key>", "Explicitly override chat_key.")
+            .option("--session-id <session_id>", "Explicitly override session_id.")
             .option("--limit <n>", "Return the latest N records, default 30.")
             .option(
               "--direction <direction>",
@@ -335,24 +329,24 @@ export function createChatPluginActions(params: {
             .option("--before-ts <ts>", "Return only records with ts lower than this value, in milliseconds.")
             .option("--after-ts <ts>", "Return only records with ts greater than this value, in milliseconds.");
         },
-        mapInput: mapChatHistoryCommandInput,
+        map_input: mapChatHistoryCommandInput,
       },
       execute: async (actionParams) => {
         return executeChatHistoryAction({
           context: actionParams.context,
           payload: actionParams.input as ChatHistoryActionPayload,
-          run_context: actionParams.run_context,
+          execution_context: actionParams.execution_context,
         });
       },
     }),
-    history_clear: createAction({
+    history_clear: create_action({
       description: "Clear the Chat Plugin event history for one Session.",
       input_schema: {
-        zod: z.object({ sessionId: z.string().min(1) }),
+        zod: z.object({ session_id: z.string().min(1) }),
         json_schema: {
           type: "object",
-          properties: { sessionId: { type: "string" } },
-          required: ["sessionId"],
+          properties: { session_id: { type: "string" } },
+          required: ["session_id"],
           additionalProperties: false,
         },
       },

package/src/chat/runtime/ChatPluginSystem.ts

@@ -6,8 +6,8 @@
  * - 当前请求只注入当前 chat platform 的 prompt，避免平台规则串味。
  * - 该模块只负责 prompt 解析与拼装，不承担运行态控制职责。
  */
-import type { AgentContext } from "@downcity/agent";
-import type { PluginRunContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
+import type { PluginExecutionContext } from "@downcity/agent";
 import {
   buildCurrentChatEnvironmentPrompt,
   resolveCurrentChatEnvironmentPromptInput,
@@ -42,12 +42,12 @@ function resolveCurrentChatPromptChannel(
  * - 若当前 context 不是 chat platform（如 Console UI）或尚无路由元信息，则不注入 platform prompt。
  */
 export async function buildCurrentChannelPrompts(
-  context: AgentContext,
-  run_context?: PluginRunContext,
+  context: PluginContext,
+  execution_context?: PluginExecutionContext,
 ): Promise<string[]> {
   const chatEnvironment = await resolveCurrentChatEnvironmentPromptInput(
     context,
-    run_context,
+    execution_context,
   );
   if (!chatEnvironment) return [];
   const channel = resolveCurrentChatPromptChannel(
@@ -63,13 +63,13 @@ export async function buildCurrentChannelPrompts(
  * 构建 chat plugin 注入到 session 的 system 文本。
  */
 export async function buildChatPluginSystem(
-  context: AgentContext,
-  run_context?: PluginRunContext,
+  context: PluginContext,
+  execution_context?: PluginExecutionContext,
 ): Promise<string> {
   return [
     CHAT_PLUGIN_PROMPT,
-    await buildCurrentChatEnvironmentPrompt(context, run_context),
-    ...(await buildCurrentChannelPrompts(context, run_context)),
+    await buildCurrentChatEnvironmentPrompt(context, execution_context),
+    ...(await buildCurrentChannelPrompts(context, execution_context)),
   ]
     .filter(Boolean)
     .join("\n\n");

package/src/chat/runtime/ChatQueueReplyDispatch.ts

@@ -7,7 +7,7 @@
  */
 
 import type { Logger } from "@downcity/agent";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import { parseDirectDispatchAssistantText } from "./DirectDispatchParser.js";
 import { sendActionByChatKey } from "./ChatkeySend.js";
 import { sendChatTextByChatKey } from "../Action.js";
@@ -22,14 +22,14 @@ import {
  */
 export async function dispatchAssistantTextDirect(params: {
   logger: Logger;
-  context: AgentContext;
-  sessionId: string;
+  context: PluginContext;
+  session_id: string;
   assistantText: string;
   phase?: "step" | "final" | "error";
 }): Promise<boolean> {
   const plan = parseDirectDispatchAssistantText({
     assistantText: params.assistantText,
-    fallbackChatKey: params.sessionId,
+    fallbackChatKey: params.session_id,
   });
   if (!plan) return false;
   let textDispatchSucceeded = false;
@@ -37,18 +37,18 @@ export async function dispatchAssistantTextDirect(params: {
   if (plan.text) {
     const target = await resolveChatReplyTarget({
       context: params.context,
-      chatKey: plan.text.chatKey,
+      chat_key: plan.text.chat_key,
     });
     const preparedText = await prepareChatReplyText({
       context: params.context,
       input: {
-        chatKey: plan.text.chatKey,
+        chat_key: plan.text.chat_key,
         ...(target.channel ? { channel: target.channel } : {}),
         ...(typeof target.chatId === "string" ? { chatId: target.chatId } : {}),
-        ...(typeof plan.text.messageId === "string"
-          ? { messageId: plan.text.messageId }
-          : typeof target.messageId === "string"
-            ? { messageId: target.messageId }
+        ...(typeof plan.text.message_id === "string"
+          ? { message_id: plan.text.message_id }
+          : typeof target.message_id === "string"
+            ? { message_id: target.message_id }
             : {}),
         text: plan.text.text,
         phase: params.phase || "final",
@@ -57,27 +57,27 @@ export async function dispatchAssistantTextDirect(params: {
     });
     const textResult = await sendChatTextByChatKey({
       context: params.context,
-      chatKey: plan.text.chatKey,
+      chat_key: plan.text.chat_key,
       text: preparedText,
-      replyToMessage: plan.text.replyToMessage,
-      messageId: plan.text.messageId,
-      ...(typeof plan.text.delayMs === "number"
-        ? { delayMs: plan.text.delayMs }
+      reply_to_message: plan.text.reply_to_message,
+      message_id: plan.text.message_id,
+      ...(typeof plan.text.delay_ms === "number"
+        ? { delay_ms: plan.text.delay_ms }
         : {}),
-      ...(typeof plan.text.sendAtMs === "number"
-        ? { sendAtMs: plan.text.sendAtMs }
+      ...(typeof plan.text.send_at_ms === "number"
+        ? { send_at_ms: plan.text.send_at_ms }
         : {}),
     });
     await emitChatReplyEffect({
       context: params.context,
       input: {
-        chatKey: plan.text.chatKey,
+        chat_key: plan.text.chat_key,
         ...(target.channel ? { channel: target.channel } : {}),
         ...(typeof target.chatId === "string" ? { chatId: target.chatId } : {}),
-        ...(typeof plan.text.messageId === "string"
-          ? { messageId: plan.text.messageId }
-          : typeof target.messageId === "string"
-            ? { messageId: target.messageId }
+        ...(typeof plan.text.message_id === "string"
+          ? { message_id: plan.text.message_id }
+          : typeof target.message_id === "string"
+            ? { message_id: target.message_id }
             : {}),
         text: preparedText,
         phase: params.phase || "final",
@@ -88,8 +88,8 @@ export async function dispatchAssistantTextDirect(params: {
     });
     if (!textResult.success) {
       params.logger.warn("Direct chat text dispatch failed", {
-        sessionId: params.sessionId,
-        targetChatKey: plan.text.chatKey,
+        session_id: params.session_id,
+        targetChatKey: plan.text.chat_key,
         error: textResult.error || "chat send failed",
       });
     } else {
@@ -100,16 +100,16 @@ export async function dispatchAssistantTextDirect(params: {
   for (const reaction of plan.reactions) {
     const reactResult = await sendActionByChatKey({
       context: params.context,
-      chatKey: reaction.chatKey,
+      chat_key: reaction.chat_key,
       action: "react",
-      messageId: reaction.messageId,
+      message_id: reaction.message_id,
       reactionEmoji: reaction.emoji,
       reactionIsBig: reaction.big,
     });
     if (!reactResult.success) {
       params.logger.warn("Direct chat reaction dispatch failed", {
-        sessionId: params.sessionId,
-        targetChatKey: reaction.chatKey,
+        session_id: params.session_id,
+        targetChatKey: reaction.chat_key,
         error: reactResult.error || "chat react failed",
       });
     }
@@ -123,28 +123,28 @@ export async function dispatchAssistantTextDirect(params: {
  */
 export async function dispatchTextToChannel(params: {
   logger: Logger;
-  context: AgentContext;
-  sessionId: string;
+  context: PluginContext;
+  session_id: string;
   text: string;
-  messageId?: string;
+  message_id?: string;
   phase?: "step" | "final" | "error";
 }): Promise<boolean> {
   const text = String(params.text || "").trim();
   if (!text) return false;
   const target = await resolveChatReplyTarget({
     context: params.context,
-    chatKey: params.sessionId,
+    chat_key: params.session_id,
   });
   const preparedText = await prepareChatReplyText({
     context: params.context,
     input: {
-      chatKey: params.sessionId,
+      chat_key: params.session_id,
       ...(target.channel ? { channel: target.channel } : {}),
       ...(typeof target.chatId === "string" ? { chatId: target.chatId } : {}),
-      ...(typeof params.messageId === "string"
-        ? { messageId: params.messageId }
-        : typeof target.messageId === "string"
-          ? { messageId: target.messageId }
+      ...(typeof params.message_id === "string"
+        ? { message_id: params.message_id }
+        : typeof target.message_id === "string"
+          ? { message_id: target.message_id }
           : {}),
       text,
       phase: params.phase || "final",
@@ -154,23 +154,23 @@ export async function dispatchTextToChannel(params: {
 
   const result = await sendChatTextByChatKey({
     context: params.context,
-    chatKey: params.sessionId,
+    chat_key: params.session_id,
     text: preparedText,
-    replyToMessage: true,
-    ...(typeof params.messageId === "string" && params.messageId
-      ? { messageId: params.messageId }
+    reply_to_message: true,
+    ...(typeof params.message_id === "string" && params.message_id
+      ? { message_id: params.message_id }
       : {}),
   });
   await emitChatReplyEffect({
     context: params.context,
     input: {
-      chatKey: params.sessionId,
+      chat_key: params.session_id,
       ...(target.channel ? { channel: target.channel } : {}),
       ...(typeof target.chatId === "string" ? { chatId: target.chatId } : {}),
-      ...(typeof params.messageId === "string"
-        ? { messageId: params.messageId }
-        : typeof target.messageId === "string"
-          ? { messageId: target.messageId }
+      ...(typeof params.message_id === "string"
+        ? { message_id: params.message_id }
+        : typeof target.message_id === "string"
+          ? { message_id: target.message_id }
           : {}),
       text: preparedText,
       phase: params.phase || "final",
@@ -182,7 +182,7 @@ export async function dispatchTextToChannel(params: {
 
   if (!result.success) {
     params.logger.warn("ChatQueueWorker forced channel dispatch failed", {
-      sessionId: params.sessionId,
+      session_id: params.session_id,
       error: result.error || "chat send failed",
     });
     return false;

package/src/chat/runtime/ChatQueueStore.ts

@@ -7,7 +7,7 @@
  * - 旧的 `ChatQueue.ts` 会保留共享门面，逐步迁移到显式实例注入。
  */
 
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type {
   ChatQueueEnqueueParams,
   ChatQueueEnqueueResult,
@@ -58,7 +58,7 @@ export interface ChatQueueStorePort {
  *
  * 关键点（中文）
  * - 迁移阶段仍保留一份共享实例，避免一次性改动所有旧入口。
- * - 新代码应优先通过 `AgentContext.agent` 解析显式 queue store。
+ * - 新代码应优先通过 `PluginContext.agent` 解析显式 queue store。
  */
 /**
  * Chat queue 实例级存储。
@@ -96,7 +96,7 @@ export class ChatQueueStore implements ChatQueueStorePort {
   }
 
   enqueue(params: ChatQueueEnqueueParams): ChatQueueEnqueueResult {
-    const laneKey = this.normalizeLaneKey(params.sessionId);
+    const laneKey = this.normalizeLaneKey(params.session_id);
     const lane = this.getLane(laneKey);
     const item: ChatQueueItem = {
       ...params,
@@ -174,7 +174,7 @@ export function getSharedChatQueueStore(): ChatQueueStore {
  * - 新路径优先读取当前 Agent 注册的 ChatPlugin 实例。
  * - 迁移阶段若拿不到，则回退到共享 queue store，保证旧入口可继续工作。
  */
-export function resolveChatQueueStore(context?: AgentContext): ChatQueueStorePort {
+export function resolveChatQueueStore(context?: PluginContext): ChatQueueStorePort {
   const chatService = context?.plugins.get("chat") as
     | { queueStore?: ChatQueueStorePort }
     | undefined;