@downcity/plugins 1.0.215 → 1.0.233

package/src/chat/Action.ts

@@ -2,12 +2,12 @@
  * Chat command services.
  *
  * 关键点（中文）
- * - chat 语义（chatKey 与 sessionId 映射）统一收口在本模块
+ * - chat 语义（chat_key 与 session_id 映射）统一收口在本模块
  * - Session 运行上下文由 action 入口显式传入
  */
 
-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 {
   sendActionByChatKey,
   sendTextByChatKey,
@@ -51,22 +51,23 @@ function readEnvNumber(name: string): number | undefined {
  *
  * 优先级（中文）
  * 1) 显式参数
- * 2) 显式 PluginRunContext
+ * 2) 显式 PluginExecutionContext
  * 3) 环境变量回退
  */
 export function resolveChatSessionSnapshot(input?: {
-  sessionId?: string;
-  chatKey?: string;
-  context?: AgentContext;
-  run_context?: PluginRunContext;
+  session_id?: string;
+  chat_key?: string;
+  context?: PluginContext;
+  execution_context?: PluginExecutionContext;
 }): ChatSessionSnapshot {
-  const run_context = input?.run_context;
+  const execution_context = input?.execution_context;
 
-  const explicitSessionId = String(input?.sessionId || "").trim();
-  const explicitChatKey = String(input?.chatKey || "").trim();
+  const explicitSessionId = String(input?.session_id || "").trim();
+  const explicitChatKey = String(input?.chat_key || "").trim();
   const requestSessionId =
-    typeof run_context?.sessionId === "string" && run_context.sessionId.trim()
-      ? run_context.sessionId.trim()
+    typeof execution_context?.session_id === "string" &&
+      execution_context.session_id.trim()
+      ? execution_context.session_id.trim()
       : undefined;
   const envSessionId = readEnvString("DC_SESSION_ID");
   const envChatKey = readEnvString("DC_CTX_CHAT_KEY");
@@ -79,116 +80,116 @@ export function resolveChatSessionSnapshot(input?: {
   const chatType =
     readEnvString("DC_CTX_TARGET_TYPE") ||
     readEnvString("DC_CTX_CHAT_TYPE");
-  const userId =
+  const user_id =
     readEnvString("DC_CTX_ACTOR_ID") ||
     readEnvString("DC_CTX_USER_ID");
-  const messageId = readEnvString("DC_CTX_MESSAGE_ID");
-  const sessionId =
+  const message_id = readEnvString("DC_CTX_MESSAGE_ID");
+  const session_id =
     explicitSessionId ||
     requestSessionId ||
     envSessionId ||
     explicitChatKey ||
     envChatKey;
-  const chatKey =
+  const chat_key =
     explicitChatKey ||
-    mapSessionIdToChatKey(sessionId) ||
+    mapSessionIdToChatKey(session_id) ||
     envChatKey;
 
   const snapshot: ChatSessionSnapshot = {
-    ...(sessionId ? { sessionId } : {}),
-    ...(chatKey ? { chatKey } : {}),
+    ...(session_id ? { session_id } : {}),
+    ...(chat_key ? { chat_key } : {}),
     channel,
     chatId,
     messageThreadId,
     chatType,
-    userId,
-    messageId,
+    user_id,
+    message_id,
   };
 
   return snapshot;
 }
 
 /**
- * 将 sessionId 映射为可发送的 chatKey。
+ * 将 session_id 映射为可发送的 chat_key。
  *
  * 关键点（中文）
- * - 当前实现下：chat plugin runtime 内部把 sessionId 视作可发送 chatKey。
- * - 不再依赖字符串规则推导（sessionId 可为随机值）。
+ * - 当前实现下：chat plugin runtime 内部把 session_id 视作可发送 chat_key。
+ * - 不再依赖字符串规则推导（session_id 可为随机值）。
  */
-export function mapSessionIdToChatKey(sessionId?: string): string | undefined {
-  const key = String(sessionId || "").trim();
+export function mapSessionIdToChatKey(session_id?: string): string | undefined {
+  const key = String(session_id || "").trim();
   if (!key) return undefined;
   return key;
 }
 
 /**
- * 提取最终 sessionId。
+ * 提取最终 session_id。
  */
-export function resolveSessionId(input?: {
-  sessionId?: string;
-  chatKey?: string;
-  context?: AgentContext;
-  run_context?: PluginRunContext;
+export function resolve_session_id(input?: {
+  session_id?: string;
+  chat_key?: string;
+  context?: PluginContext;
+  execution_context?: PluginExecutionContext;
 }): string | undefined {
   const snapshot = resolveChatSessionSnapshot({
-    sessionId: input?.sessionId,
-    chatKey: input?.chatKey,
+    session_id: input?.session_id,
+    chat_key: input?.chat_key,
     context: input?.context,
-    run_context: input?.run_context,
+    execution_context: input?.execution_context,
   });
-  const key = String(snapshot.sessionId || "").trim();
+  const key = String(snapshot.session_id || "").trim();
   return key ? key : undefined;
 }
 
 /**
- * 提取最终 chatKey（用于发送路径）。
+ * 提取最终 chat_key（用于发送路径）。
  */
 export function resolveChatKey(input?: {
-  chatKey?: string;
-  sessionId?: string;
-  context?: AgentContext;
-  run_context?: PluginRunContext;
+  chat_key?: string;
+  session_id?: string;
+  context?: PluginContext;
+  execution_context?: PluginExecutionContext;
 }): string | undefined {
   const snapshot = resolveChatSessionSnapshot({
-    chatKey: input?.chatKey,
-    sessionId: input?.sessionId,
+    chat_key: input?.chat_key,
+    session_id: input?.session_id,
     context: input?.context,
-    run_context: input?.run_context,
+    execution_context: input?.execution_context,
   });
-  const key = String(snapshot.chatKey || "").trim();
+  const key = String(snapshot.chat_key || "").trim();
   return key ? key : undefined;
 }
 
 /**
- * 解析当前发送应绑定的 reply messageId。
+ * 解析当前发送应绑定的 reply message_id。
  *
  * 关键点（中文）
- * - 只有显式 reply 且未手动传入 messageId 时才尝试补全。
- * - 仅在目标 chatKey 与当前显式请求上下文一致时，才复用 `DC_CTX_MESSAGE_ID`。
- * - 这样可把一次 run 固定到触发它的那条消息，避免处理中被后续新消息覆盖。
+ * - 只有显式 reply 且未手动传入 message_id 时才尝试补全。
+ * - 仅在目标 chat_key 与当前显式请求上下文一致时，才复用 `DC_CTX_MESSAGE_ID`。
+ * - 这样可把一次处理固定到触发它的那条消息，避免处理中被后续新消息覆盖。
  */
 function resolveReplyMessageIdForChatSend(params: {
-  chatKey: string;
-  context: AgentContext;
-  replyToMessage: boolean;
+  chat_key: string;
+  context: PluginContext;
+  reply_to_message: boolean;
   explicitMessageId?: string;
-  run_context?: PluginRunContext;
+  execution_context?: PluginExecutionContext;
 }): string | undefined {
   const explicitMessageId =
     typeof params.explicitMessageId === "string" && params.explicitMessageId.trim()
       ? params.explicitMessageId.trim()
       : undefined;
   if (explicitMessageId) return explicitMessageId;
-  if (params.replyToMessage !== true) return undefined;
+  if (params.reply_to_message !== true) return undefined;
 
   const snapshot = resolveChatSessionSnapshot({
     context: params.context,
-    run_context: params.run_context,
+    execution_context: params.execution_context,
   });
-  const snapshotChatKey = String(snapshot.chatKey || "").trim();
-  const snapshotMessageId = String(snapshot.messageId || "").trim();
+  const snapshotChatKey = String(snapshot.chat_key || "").trim();
+  const snapshotMessageId = String(snapshot.message_id || "").trim();
   if (!snapshotChatKey || !snapshotMessageId) return undefined;
-  return snapshotChatKey === params.chatKey ? snapshotMessageId : undefined;
+  return snapshotChatKey === params.chat_key ? snapshotMessageId : undefined;
 }
 
 /**
@@ -223,17 +224,17 @@ export function normalizeChatSendText(raw: string): string {
  * 发送前延迟。
  *
  * 关键点（中文）
- * - 支持延迟毫秒（delayMs）或绝对时间（sendAtMs）
+ * - 支持延迟毫秒（delay_ms）或绝对时间（send_at_ms）
  * - 超长等待按分片 setTimeout，避免超出 Node 单次定时器上限
  */
 function resolveTargetWaitMs(params: {
-  delayMs: number;
-  sendAtMs?: number;
+  delay_ms: number;
+  send_at_ms?: number;
 }): number {
-  const delayMs = params.delayMs;
-  const sendAtMs = params.sendAtMs;
+  const delay_ms = params.delay_ms;
+  const send_at_ms = params.send_at_ms;
   const rawWaitMs =
-    typeof sendAtMs === "number" ? Math.max(0, sendAtMs - Date.now()) : delayMs;
+    typeof send_at_ms === "number" ? Math.max(0, send_at_ms - Date.now()) : delay_ms;
   if (!Number.isFinite(rawWaitMs) || Number.isNaN(rawWaitMs) || rawWaitMs <= 0) return 0;
   return Math.trunc(rawWaitMs);
 }
@@ -252,25 +253,25 @@ async function waitByTimeoutChunks(waitMs: number): Promise<void> {
 }
 
 async function waitBeforeSend(params: {
-  delayMs: number;
-  sendAtMs?: number;
+  delay_ms: number;
+  send_at_ms?: number;
 }): Promise<void> {
   await waitByTimeoutChunks(resolveTargetWaitMs(params));
 }
 
 /**
- * 按 chatKey 发送文本。
+ * 按 chat_key 发送文本。
  *
  * 关键点（中文）
  * - chat plugin runtime 不关心具体平台；由 runtime sender 做 channel 分发。
  * - 返回统一结构，便于上层链路做可观测与错误汇总。
  */
 export async function sendChatTextByChatKey(params: {
-  context: AgentContext;
-  chatKey: string;
+  context: PluginContext;
+  chat_key: string;
   text: string;
-  delayMs?: number;
-  sendAtMs?: number;
+  delay_ms?: number;
+  send_at_ms?: number;
   /**
    * 延迟发送是否异步调度（不阻塞当前调用）。
    *
@@ -279,43 +280,43 @@ export async function sendChatTextByChatKey(params: {
    * - 默认 false，保持 CLI/API 的阻塞行为不变。
    */
   nonBlockingDelay?: boolean;
-  replyToMessage?: boolean;
-  messageId?: string;
-  run_context?: PluginRunContext;
+  reply_to_message?: boolean;
+  message_id?: string;
+  execution_context?: PluginExecutionContext;
 }): Promise<ChatSendResponse> {
-  const chatKey = String(params.chatKey || "").trim();
+  const chat_key = String(params.chat_key || "").trim();
   const text = normalizeChatSendText(String(params.text ?? ""));
-  const delayMs =
-    typeof params.delayMs === "number" && Number.isFinite(params.delayMs)
-      ? Math.max(0, Math.trunc(params.delayMs))
+  const delay_ms =
+    typeof params.delay_ms === "number" && Number.isFinite(params.delay_ms)
+      ? Math.max(0, Math.trunc(params.delay_ms))
       : 0;
-  const sendAtMs =
-    typeof params.sendAtMs === "number" && Number.isFinite(params.sendAtMs)
-      ? Math.max(0, Math.trunc(params.sendAtMs))
+  const send_at_ms =
+    typeof params.send_at_ms === "number" && Number.isFinite(params.send_at_ms)
+      ? Math.max(0, Math.trunc(params.send_at_ms))
       : undefined;
-  if (!chatKey) {
+  if (!chat_key) {
     return {
       success: false,
-      error: "Missing chatKey",
+      error: "Missing chat_key",
     };
   }
-  if (delayMs > 0 && typeof sendAtMs === "number") {
+  if (delay_ms > 0 && typeof send_at_ms === "number") {
     return {
       success: false,
-      chatKey,
-      error: "delayMs and sendAtMs cannot be used together",
+      chat_key,
+      error: "delay_ms and send_at_ms cannot be used together",
     };
   }
 
-  const replyToMessage = params.replyToMessage === true;
-  const messageId = resolveReplyMessageIdForChatSend({
+  const reply_to_message = params.reply_to_message === true;
+  const message_id = resolveReplyMessageIdForChatSend({
     context: params.context,
-    chatKey,
-    replyToMessage,
-    explicitMessageId: params.messageId,
-    run_context: params.run_context,
+    chat_key,
+    reply_to_message,
+    explicitMessageId: params.message_id,
+    execution_context: params.execution_context,
   });
-  const targetWaitMs = resolveTargetWaitMs({ delayMs, sendAtMs });
+  const targetWaitMs = resolveTargetWaitMs({ delay_ms, send_at_ms });
   if (params.nonBlockingDelay === true && targetWaitMs > 0) {
     // 关键点（中文）：异步调度延迟发送，让调用方可立即结束当前 run。
     void (async () => {
@@ -323,162 +324,162 @@ export async function sendChatTextByChatKey(params: {
         await waitByTimeoutChunks(targetWaitMs);
         const delayed = await sendTextByChatKey({
           context: params.context,
-          chatKey,
+          chat_key,
           text,
-          replyToMessage,
-          ...(messageId ? { messageId } : {}),
+          reply_to_message,
+          ...(message_id ? { message_id } : {}),
         });
         if (!delayed.success) {
           params.context.logger.warn("Delayed chat send failed", {
-            chatKey,
+            chat_key,
             error: delayed.error || "chat send failed",
           });
         }
       } catch (error) {
         params.context.logger.warn("Delayed chat send failed", {
-          chatKey,
+          chat_key,
           error: String(error),
         });
       }
     })();
     return {
       success: true,
-      chatKey,
+      chat_key,
     };
   }
 
-  await waitBeforeSend({ delayMs, sendAtMs });
+  await waitBeforeSend({ delay_ms, send_at_ms });
 
   const result = await sendTextByChatKey({
     context: params.context,
-    chatKey,
+    chat_key,
     text,
-    replyToMessage,
-    ...(messageId ? { messageId } : {}),
+    reply_to_message,
+    ...(message_id ? { message_id } : {}),
   });
   return {
     success: Boolean(result.success),
-    chatKey,
+    chat_key,
     ...(result.success ? {} : { error: result.error || "chat send failed" }),
   };
 }
 
 /**
- * 按 chatKey 发送平台动作（typing/react）。
+ * 按 chat_key 发送平台动作（typing/react）。
  *
  * 关键点（中文）
- * - 动作分发与文本发送复用同一 chatKey 解析与 channel dispatcher。
+ * - 动作分发与文本发送复用同一 chat_key 解析与 channel dispatcher。
  */
 export async function sendChatActionByChatKey(params: {
-  context: AgentContext;
-  chatKey: string;
+  context: PluginContext;
+  chat_key: string;
   action: ChatDispatchAction;
-  messageId?: string;
+  message_id?: string;
   reactionEmoji?: string;
   reactionIsBig?: boolean;
 }): Promise<ChatReactResponse> {
-  const chatKey = String(params.chatKey || "").trim();
-  if (!chatKey) {
+  const chat_key = String(params.chat_key || "").trim();
+  if (!chat_key) {
     return {
       success: false,
-      error: "Missing chatKey",
+      error: "Missing chat_key",
     };
   }
 
   const result = await sendActionByChatKey({
     context: params.context,
-    chatKey,
+    chat_key,
     action: params.action,
-    messageId: params.messageId,
+    message_id: params.message_id,
     reactionEmoji: params.reactionEmoji,
     reactionIsBig: params.reactionIsBig,
   });
-  const messageId = String(params.messageId || "").trim();
+  const message_id = String(params.message_id || "").trim();
   return {
     success: Boolean(result.success),
-    chatKey,
-    ...(messageId ? { messageId } : {}),
+    chat_key,
+    ...(message_id ? { message_id } : {}),
     ...(result.success ? {} : { error: result.error || "chat action failed" }),
   };
 }
 
 /**
- * 按 sessionId 发送文本。
+ * 按 session_id 发送文本。
  *
  * 关键点（中文）
- * - sessionId -> chatKey 映射关系只在 chat plugin runtime 内部维护。
+ * - session_id -> chat_key 映射关系只在 chat plugin runtime 内部维护。
  */
 export async function sendChatTextBySessionId(params: {
-  context: AgentContext;
-  sessionId: string;
+  context: PluginContext;
+  session_id: string;
   text: string;
-  delayMs?: number;
-  sendAtMs?: number;
-  replyToMessage?: boolean;
-  messageId?: string;
-}): Promise<{ success: boolean; sessionId: string; error?: string }> {
-  const sessionId = String(params.sessionId || "").trim();
-  if (!sessionId) {
+  delay_ms?: number;
+  send_at_ms?: number;
+  reply_to_message?: boolean;
+  message_id?: string;
+}): Promise<{ success: boolean; session_id: string; error?: string }> {
+  const session_id = String(params.session_id || "").trim();
+  if (!session_id) {
     return {
       success: false,
-      sessionId: "",
-      error: "Missing sessionId",
+      session_id: "",
+      error: "Missing session_id",
     };
   }
 
   const result = await sendChatTextByChatKey({
     context: params.context,
-    chatKey: sessionId,
+    chat_key: session_id,
     text: params.text,
-    delayMs: params.delayMs,
-    sendAtMs: params.sendAtMs,
-    replyToMessage: params.replyToMessage === true,
-    ...(typeof params.messageId === "string" && params.messageId.trim()
-      ? { messageId: params.messageId.trim() }
+    delay_ms: params.delay_ms,
+    send_at_ms: params.send_at_ms,
+    reply_to_message: params.reply_to_message === true,
+    ...(typeof params.message_id === "string" && params.message_id.trim()
+      ? { message_id: params.message_id.trim() }
       : {}),
   });
   return {
     success: Boolean(result.success),
-    sessionId,
+    session_id,
     ...(result.success ? {} : { error: result.error || "chat send failed" }),
   };
 }
 
 /**
- * 按 chatKey/sessionId 彻底删除 chat 会话。
+ * 按 chat_key/session_id 彻底删除 chat 会话。
  *
  * 关键点（中文）
- * - chatKey 与 sessionId 在 chat plugin runtime 内部等价使用。
+ * - chat_key 与 session_id 在 chat plugin runtime 内部等价使用。
  * - 删除包含：路由映射 + chat 审计目录 + session 目录 + 渠道状态清理。
  */
 export async function deleteChatByChatKey(params: {
-  context: AgentContext;
-  chatKey?: string;
-  sessionId?: string;
-  run_context?: PluginRunContext;
+  context: PluginContext;
+  chat_key?: string;
+  session_id?: string;
+  execution_context?: PluginExecutionContext;
 }): Promise<ChatDeleteResponse> {
-  const chatKey = resolveChatKey({
+  const chat_key = resolveChatKey({
     context: params.context,
-    chatKey: params.chatKey,
-    sessionId: params.sessionId,
-    run_context: params.run_context,
+    chat_key: params.chat_key,
+    session_id: params.session_id,
+    execution_context: params.execution_context,
   });
-  const sessionId = String(chatKey || "").trim();
-  if (!sessionId) {
+  const session_id = String(chat_key || "").trim();
+  if (!session_id) {
     return {
       success: false,
       error:
-        "Missing chatKey/sessionId. Provide --chat-key or --session-id, or ensure DC_CTX_CHAT_KEY/DC_SESSION_ID is injected.",
+        "Missing chat_key/session_id. Provide --chat-key or --session-id, or ensure DC_CTX_CHAT_KEY/DC_SESSION_ID is injected.",
     };
   }
 
   const result = await deleteChatSessionById({
     context: params.context,
-    sessionId,
+    session_id,
   });
   return {
     success: result.success,
-    sessionId: result.sessionId,
+    session_id: result.session_id,
     deleted: result.deleted,
     removedMeta: result.removedMeta,
     removedChatDir: result.removedChatDir,

package/src/chat/ChatPlugin.ts

@@ -10,8 +10,8 @@
 
 import { BasePlugin } from "@downcity/agent";
 import type { PluginActions } from "@downcity/agent";
-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 type { ChatChannelState } from "@/chat/types/ChatRuntime.js";
 import type { ChatQueueWorkerConfig } from "@/chat/types/ChatQueueWorker.js";
 import type {
@@ -89,10 +89,10 @@ export class ChatPlugin extends BasePlugin {
    * 当前 plugin 的 system 文本构建器。
    */
   readonly system = async (
-    context: AgentContext,
-    run_context?: PluginRunContext,
+    context: PluginContext,
+    execution_context?: PluginExecutionContext,
   ): Promise<string> => {
-    return await buildChatPluginSystem(context, run_context);
+    return await buildChatPluginSystem(context, execution_context);
   };
 
   /**
@@ -103,7 +103,7 @@ export class ChatPlugin extends BasePlugin {
   /**
    * 启动当前实例的 queue worker。
    */
-  private startQueueWorker(context: AgentContext): void {
+  private startQueueWorker(context: PluginContext): void {
     if (this.queueWorker) return;
     const worker = new ChatQueueWorker({
       logger: context.logger,
@@ -153,7 +153,7 @@ export class ChatPlugin extends BasePlugin {
    * 读取 queue worker 配置。
    */
   getQueueWorkerConfig(
-    context: AgentContext,
+    context: PluginContext,
   ): Partial<ChatQueueWorkerConfig> | undefined {
     void context;
     return this.options.queue;
@@ -162,25 +162,25 @@ export class ChatPlugin extends BasePlugin {
   /**
    * 判断指定渠道是否启用。
    */
-  isChannelEnabled(context: AgentContext, channel: ChatChannelName): boolean {
+  isChannelEnabled(context: PluginContext, channel: ChatChannelName): boolean {
     return this.getChannel(channel)?.isEnabled(context) === true;
   }
 
   /**
    * 读取指定渠道的显式账户 ID。
    */
-  getChannelAccountId(
-    context: AgentContext,
+  getResourceId(
+    context: PluginContext,
     channel: ChatChannelName,
   ): string {
-    return String(this.getChannel(channel)?.getChannelAccountId(context) || "").trim();
+    return String(this.getChannel(channel)?.getResourceId(context) || "").trim();
   }
 
   /**
    * 解析指定渠道当前应使用的账户。
    */
   resolveChannelAccount(
-    context: AgentContext,
+    context: PluginContext,
     channel: ChatChannelName,
   ) {
     return this.getChannel(channel)?.getAccount(context) || null;

package/src/chat/Index.ts

@@ -11,6 +11,16 @@ export {
   QqChannel,
   TelegramChannel,
 } from "./channels/RuntimeChannel.js";
+export {
+  CHAT_PLUGIN_CONFIG_JSON_SCHEMA,
+  CHAT_PLUGIN_RESOURCE_JSON_SCHEMA,
+  chat_plugin_config_schema,
+  chat_plugin_resource_schema,
+  get_chat_plugin_resource_json_schema,
+  parse_chat_plugin_config,
+  parse_chat_plugin_resource,
+  resolve_chat_plugin_resource,
+} from "./config/ChatPluginConfig.js";
 export type {
   BaseChatChannelOptions,
   ChatChannelEnv,
@@ -22,3 +32,5 @@ export type {
   ChatChannel,
   ChatPluginOptions,
 } from "./types/ChatPluginOptions.js";
+export type { ChatPluginConfig } from "./config/ChatPluginConfig.js";
+export type { ChatPluginResource } from "./types/ChatPluginResource.js";

package/src/chat/PROMPT.direct.ts

@@ -4,6 +4,6 @@
  */
 
 // Source: src/chat/PROMPT.direct.ts.txt
-const TEXT_MODULE_CONTENT = "# Chat Plugin Instructions\n\n## User-Visible Reply Rules\n\n- In the current mode, your direct assistant output is sent as a message to the user's corresponding channel.\n\n## Output Protocol\n\n- For a normal reply, output plain text directly. Optional frontmatter metadata may appear at the very top of the text. Field semantics match the chat plugin direct-send protocol:\n\n- `delay` / `delayMs`: delay before sending, in milliseconds.\n- `time` / `sendAt` / `sendAtMs`: scheduled send time.\n- `reply`: whether to send with reply semantics.\n- `messageId`: target `message_id`, recommended for group chats.\n- `react`: send an emoji reaction.\n  - Single string: `react: \"thumbs up\"`\n  - Or an object/array: `emoji/big`\n  - When `messageId` is set, `react` reuses that message as the target first.\n- Attachments use `<file type=\"...\">path</file>` and support `document/photo/voice/audio/video`.\n- Attachment paths must be relative paths accessible inside the project. For multiple attachments, output multiple `<file>` tags.\n\n### Example\n\n```text\n---\nreply: true\nmessageId: \"128\"\nreact:\n  - emoji: \"done\"\n---\nHere is today's report.\n<file type=\"document\">reports/daily.md</file>\n```\n\n### Protocol Constraints\n\n- Frontmatter must be at the very beginning of the text and wrapped with `---`.\n- Except for `<file>` attachment tags, do not use angle-bracket syntax for control parameters.\n\n## Cross-Protocol Or Cross-Platform Operations\n\n- For replies inside the current conversation, prefer outputting text directly. The system will send it to the current channel automatically.\n- When a task needs cross-conversation, cross-platform, or complex routing, use chat plugin actions.\n- If `plugin_call` is available, call `plugin_call({ plugin: \"chat\", action: \"send\", payload })` or `plugin_call({ plugin: \"chat\", action: \"react\", payload })`.\n- Metadata applies only to direct outbound messages in the current conversation. Do not use metadata for cross-chat routing.\n- If cross-chat routing parameters are unclear, first read the current chat context or call chat plugin query actions instead of guessing.\n\n## Inbound Message Structure\n\n- Each queued user message contains an `<info>...</info>` metadata block plus the user text.\n- `<info>` keeps only user/request metadata such as `user_id`, `username`, `message_id`, and `received_at`.\n- The current chat routing environment, such as `channel`, `session_id`, `chat_key`, and `chat_id`, is injected separately through the system prompt and is no longer mixed into `<info>`.\n- Do not echo `<info>` back to the user.\n";
+const TEXT_MODULE_CONTENT = "# Chat Plugin Instructions\n\n## User-Visible Reply Rules\n\n- In the current mode, your direct assistant output is sent as a message to the user's corresponding channel.\n\n## Output Protocol\n\n- For a normal reply, output plain text directly. Optional frontmatter metadata may appear at the very top of the text. Field semantics match the chat plugin direct-send protocol:\n\n- `delay` / `delay_ms`: delay before sending, in milliseconds.\n- `time` / `sendAt` / `send_at_ms`: scheduled send time.\n- `reply`: whether to send with reply semantics.\n- `message_id`: target `message_id`, recommended for group chats.\n- `react`: send an emoji reaction.\n  - Single string: `react: \"thumbs up\"`\n  - Or an object/array: `emoji/big`\n  - When `message_id` is set, `react` reuses that message as the target first.\n- Attachments use `<file type=\"...\">path</file>` and support `document/photo/voice/audio/video`.\n- Attachment paths must be relative paths accessible inside the project. For multiple attachments, output multiple `<file>` tags.\n\n### Example\n\n```text\n---\nreply: true\nmessageId: \"128\"\nreact:\n  - emoji: \"done\"\n---\nHere is today's report.\n<file type=\"document\">reports/daily.md</file>\n```\n\n### Protocol Constraints\n\n- Frontmatter must be at the very beginning of the text and wrapped with `---`.\n- Except for `<file>` attachment tags, do not use angle-bracket syntax for control parameters.\n\n## Cross-Protocol Or Cross-Platform Operations\n\n- For replies inside the current conversation, prefer outputting text directly. The system will send it to the current channel automatically.\n- When a task needs cross-conversation, cross-platform, or complex routing, use chat plugin actions.\n- If `plugin_call` is available, call `plugin_call({ plugin: \"chat\", action: \"send\", payload })` or `plugin_call({ plugin: \"chat\", action: \"react\", payload })`.\n- Metadata applies only to direct outbound messages in the current conversation. Do not use metadata for cross-chat routing.\n- If cross-chat routing parameters are unclear, first read the current chat context or call chat plugin query actions instead of guessing.\n\n## Inbound Message Structure\n\n- Each queued user message contains an `<info>...</info>` metadata block plus the user text.\n- `<info>` keeps only user/request metadata such as `user_id`, `username`, `message_id`, and `received_at`.\n- The current chat routing environment, such as `channel`, `session_id`, `chat_key`, and `chat_id`, is injected separately through the system prompt and is no longer mixed into `<info>`.\n- Do not echo `<info>` back to the user.\n";
 
 export default TEXT_MODULE_CONTENT;