@downcity/plugins 1.0.216 → 1.0.236

package/src/chat/runtime/ChatStorage.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - Chat Plugin 是 channel meta、chat history 与渠道缓存路径的唯一所有者。
- * - AgentContext 只提供项目根目录，不暴露任何 Chat 领域路径。
+ * - PluginContext 只提供项目根目录，不暴露任何 Chat 领域路径。
  * - CLI 离线维护通过本模块操作 Chat 存储，不复制内部 JSON 结构。
  */
 
@@ -117,7 +117,7 @@ function resolve_session_id(
   if (mapped) return mapped;
   for (const route of Object.values(meta.routesBySessionId || {})) {
     if (route && matches_target(route, input)) {
-      return normalize_text(route.sessionId);
+      return normalize_text(route.session_id);
     }
   }
   return "";
@@ -149,7 +149,7 @@ async function remove_route(
     {
       ...meta,
       v: 1,
-      updatedAt: Date.now(),
+      updated_at: Date.now(),
       routesBySessionId: routes_by_session_id,
       sessionIdByTargetKey: session_id_by_target_key,
     },

package/src/chat/runtime/ChatkeySend.ts

@@ -1,9 +1,9 @@
 /**
- * Send text to a target chat using chatKey.
+ * Send text to a target chat using chat_key.
  *
  * 设计动机（中文）
- * - Task runner / scheduler 需要在“非当前对话上下文”向指定 chatKey 投递消息
- * - 复用现有 dispatcher 与 chat meta（尤其 QQ 的被动回复依赖 messageId）
+ * - Task runner / scheduler 需要在“非当前对话上下文”向指定 chat_key 投递消息
+ * - 复用现有 dispatcher 与 chat meta（尤其 QQ 的被动回复依赖 message_id）
  *
  * 注意
  * - 这里是运行时内部能力（不是 tool）；tool `chat_contact_send` 也会复用本实现
@@ -14,7 +14,7 @@ import type {
   ChatDispatchAction,
   ChatDispatchChannel,
 } from "@/chat/types/ChatDispatcher.js";
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import { readChatMetaBySessionId } from "./ChatMetaStore.js";
 
 /**
@@ -22,21 +22,21 @@ import { readChatMetaBySessionId } from "./ChatMetaStore.js";
  *
  * 规则（中文）
  * - 仅使用 chat plugin runtime 维护的 session 路由映射。
- * - 不再支持 legacy chatKey 字符串解析回退。
+ * - 不再支持 legacy chat_key 字符串解析回退。
  */
 export async function resolveDispatchTargetByChatKey(params: {
-  context: AgentContext;
-  chatKey: string;
+  context: PluginContext;
+  chat_key: string;
 }): Promise<{
   channel: ChatDispatchChannel;
   chatId: string;
   chatType?: string;
   messageThreadId?: number;
-  messageId?: string;
+  message_id?: string;
 } | null> {
   const storedMeta = await readChatMetaBySessionId({
     context: params.context,
-    sessionId: params.chatKey,
+    session_id: params.chat_key,
   });
   const channel = storedMeta?.channel;
   const chatId = String(storedMeta?.chatId || "").trim();
@@ -51,9 +51,9 @@ export async function resolveDispatchTargetByChatKey(params: {
     Number.isFinite(storedMeta.threadId)
       ? storedMeta.threadId
       : undefined;
-  const messageId =
-    typeof storedMeta?.messageId === "string" && storedMeta.messageId
-      ? storedMeta.messageId
+  const message_id =
+    typeof storedMeta?.message_id === "string" && storedMeta.message_id
+      ? storedMeta.message_id
       : undefined;
 
   return {
@@ -61,36 +61,36 @@ export async function resolveDispatchTargetByChatKey(params: {
     chatId,
     ...(typeof chatType === "string" && chatType ? { chatType } : {}),
     ...(typeof messageThreadId === "number" ? { messageThreadId } : {}),
-    ...(typeof messageId === "string" && messageId ? { messageId } : {}),
+    ...(typeof message_id === "string" && message_id ? { message_id } : {}),
   };
 }
 
 /**
- * 按 chatKey 发送文本到对应平台。
+ * 按 chat_key 发送文本到对应平台。
  *
  * 流程（中文）
- * 1) 通过 sessionId 读取映射并定位 channel dispatcher
- * 2) 从 chat meta 回填 chatType/threadId/messageId
+ * 1) 通过 session_id 读取映射并定位 channel dispatcher
+ * 2) 从 chat meta 回填 chatType/threadId/message_id
  * 3) 合并参数后调用 dispatcher 发送
  */
 export async function sendTextByChatKey(params: {
-  context: AgentContext;
-  chatKey: string;
+  context: PluginContext;
+  chat_key: string;
   text: string;
-  replyToMessage?: boolean;
-  messageId?: string;
+  reply_to_message?: boolean;
+  message_id?: string;
 }): Promise<{ success: boolean; error?: string }> {
   const context = params.context;
-  const chatKey = String(params.chatKey || "").trim();
+  const chat_key = String(params.chat_key || "").trim();
   const text = String(params.text ?? "");
-  if (!chatKey) return { success: false, error: "Missing chatKey" };
+  if (!chat_key) return { success: false, error: "Missing chat_key" };
   if (!text.trim()) return { success: true };
 
-  const target = await resolveDispatchTargetByChatKey({ context, chatKey });
+  const target = await resolveDispatchTargetByChatKey({ context, chat_key });
   if (!target) {
     return {
       success: false,
-      error: `Unsupported sessionId for dispatch: ${chatKey}`,
+      error: `Unsupported session_id for dispatch: ${chat_key}`,
     };
   }
 
@@ -107,16 +107,16 @@ export async function sendTextByChatKey(params: {
 
   const chatType = target.chatType;
   const messageThreadId = target.messageThreadId;
-  const explicitMessageId = String(params.messageId || "").trim();
-  const messageId = explicitMessageId || target.messageId;
-  const shouldReplyToMessage = params.replyToMessage === true;
+  const explicitMessageId = String(params.message_id || "").trim();
+  const message_id = explicitMessageId || target.message_id;
+  const shouldReplyToMessage = params.reply_to_message === true;
 
   if (channel === "qq") {
-    if (!chatType || !messageId) {
+    if (!chatType || !message_id) {
       return {
         success: false,
         error:
-          "QQ requires chatType + messageId to send a reply. Ask the target user to send a message first so Downcity can record latest chat meta.",
+          "QQ requires chatType + message_id to send a reply. Ask the target user to send a message first so Downcity can record latest chat meta.",
       };
     }
   }
@@ -126,37 +126,37 @@ export async function sendTextByChatKey(params: {
     text,
     ...(typeof messageThreadId === "number" ? { messageThreadId } : {}),
     ...(typeof chatType === "string" && chatType ? { chatType } : {}),
-    ...(typeof messageId === "string" && messageId ? { messageId } : {}),
-    ...(shouldReplyToMessage ? { replyToMessage: true } : {}),
+    ...(typeof message_id === "string" && message_id ? { message_id } : {}),
+    ...(shouldReplyToMessage ? { reply_to_message: true } : {}),
   });
 }
 
 /**
- * 按 chatKey 发送平台动作（typing/react）。
+ * 按 chat_key 发送平台动作（typing/react）。
  *
  * 流程（中文）
- * 1) 通过 sessionId 读取映射并定位 channel dispatcher
- * 2) 合并目标元信息与显式参数（显式 messageId 优先）
+ * 1) 通过 session_id 读取映射并定位 channel dispatcher
+ * 2) 合并目标元信息与显式参数（显式 message_id 优先）
  * 3) 调用 dispatcher.sendAction
  */
 export async function sendActionByChatKey(params: {
-  context: AgentContext;
-  chatKey: string;
+  context: PluginContext;
+  chat_key: string;
   action: ChatDispatchAction;
-  messageId?: string;
+  message_id?: string;
   reactionEmoji?: string;
   reactionIsBig?: boolean;
 }): Promise<{ success: boolean; error?: string }> {
   const context = params.context;
-  const chatKey = String(params.chatKey || "").trim();
-  if (!chatKey) return { success: false, error: "Missing chatKey" };
+  const chat_key = String(params.chat_key || "").trim();
+  if (!chat_key) return { success: false, error: "Missing chat_key" };
   if (!params.action) return { success: false, error: "Missing action" };
 
-  const target = await resolveDispatchTargetByChatKey({ context, chatKey });
+  const target = await resolveDispatchTargetByChatKey({ context, chat_key });
   if (!target) {
     return {
       success: false,
-      error: `Unsupported sessionId for dispatch: ${chatKey}`,
+      error: `Unsupported session_id for dispatch: ${chat_key}`,
     };
   }
 
@@ -168,7 +168,7 @@ export async function sendActionByChatKey(params: {
     };
   }
 
-  const messageId = String(params.messageId || "").trim() || target.messageId;
+  const message_id = String(params.message_id || "").trim() || target.message_id;
   return dispatcher.sendAction({
     chatId: target.chatId,
     action: params.action,
@@ -178,7 +178,7 @@ export async function sendActionByChatKey(params: {
     ...(typeof target.chatType === "string" && target.chatType
       ? { chatType: target.chatType }
       : {}),
-    ...(typeof messageId === "string" && messageId ? { messageId } : {}),
+    ...(typeof message_id === "string" && message_id ? { message_id } : {}),
     ...(typeof params.reactionEmoji === "string" && params.reactionEmoji.trim()
       ? { reactionEmoji: params.reactionEmoji.trim() }
       : {}),

package/src/chat/runtime/DirectDispatchParser.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - 默认把 assistant 文本原样当作用户可见正文发送。
- * - frontmatter metadata 语义与 `downcity chat send` 保持一致。
+ * - frontmatter metadata 语义与 Chat send action 保持一致。
  * - 额外保留 `react` 字段用于 direct 模式贴表情。
  */
 
@@ -14,8 +14,8 @@ import type {
   ResolvedDirectTextPayload,
 } from "@/chat/types/DirectDispatch.js";
 import {
-  buildChatMessageText,
-  parseChatMessageMarkup,
+  build_chat_message_text,
+  parse_chat_message_markup,
 } from "@downcity/agent";
 import { parseChatSendOptionsFromMetadata } from "@/chat/runtime/ChatSendMetadata.js";
 import type { ChatMessageSegment } from "@downcity/agent";
@@ -72,24 +72,24 @@ function resolveTextPlan(params: {
     metadata: params.metadata,
     strict: false,
   });
-  const chatKey = normalizeText(sendOptions.chatKey || params.fallbackChatKey);
-  const text = buildChatMessageText({
+  const chat_key = normalizeText(sendOptions.chat_key || params.fallbackChatKey);
+  const text = build_chat_message_text({
     segments: params.segments,
   });
-  if (!chatKey || !text) return null;
+  if (!chat_key || !text) return null;
 
   return {
     text,
-    chatKey,
-    replyToMessage: sendOptions.replyToMessage === true,
-    ...(typeof sendOptions.messageId === "string" && sendOptions.messageId
-      ? { messageId: sendOptions.messageId }
+    chat_key,
+    reply_to_message: sendOptions.reply_to_message === true,
+    ...(typeof sendOptions.message_id === "string" && sendOptions.message_id
+      ? { message_id: sendOptions.message_id }
       : {}),
-    ...(typeof sendOptions.delayMs === "number"
-      ? { delayMs: sendOptions.delayMs }
+    ...(typeof sendOptions.delay_ms === "number"
+      ? { delay_ms: sendOptions.delay_ms }
       : {}),
-    ...(typeof sendOptions.sendAtMs === "number"
-      ? { sendAtMs: sendOptions.sendAtMs }
+    ...(typeof sendOptions.send_at_ms === "number"
+      ? { send_at_ms: sendOptions.send_at_ms }
       : {}),
   };
 }
@@ -104,17 +104,17 @@ function resolveReactionPlans(params: {
     metadata: params.metadata,
     strict: false,
   });
-  const chatKey = normalizeText(sendOptions.chatKey || params.fallbackChatKey);
-  const messageId = normalizeText(sendOptions.messageId);
-  if (!chatKey) return out;
+  const chat_key = normalizeText(sendOptions.chat_key || params.fallbackChatKey);
+  const message_id = normalizeText(sendOptions.message_id);
+  if (!chat_key) return out;
 
   for (const react of params.reacts) {
     const emoji = normalizeText(react.emoji);
     if (!emoji) continue;
     out.push({
       emoji,
-      chatKey,
-      ...(messageId ? { messageId } : {}),
+      chat_key,
+      ...(message_id ? { message_id } : {}),
       big: react.big === true,
     });
   }
@@ -125,7 +125,7 @@ function resolveReactionPlans(params: {
  * 从 assistant 文本中解析 direct 出站执行计划。
  *
  * 协议（中文）
- * - frontmatter metadata：与 `downcity chat send` 参数保持一致。
+ * - frontmatter metadata：与 Chat send action 输入保持一致。
  * - 附件统一使用 `<file type=\"document|photo|voice|audio|video\">path</file>`。
  * - `react` 仍仅用于 direct 模式的反应动作。
  */
@@ -137,7 +137,7 @@ export function parseDirectDispatchAssistantText(params: {
   const fallbackChatKey = normalizeText(params.fallbackChatKey);
   if (!normalizeText(source) || !fallbackChatKey) return null;
 
-  const parsed = parseChatMessageMarkup(source);
+  const parsed = parse_chat_message_markup(source);
   const reacts = parseReactionsFromMetadata(parsed.metadata);
   const textPlan = resolveTextPlan({
     fallbackChatKey,

package/src/chat/runtime/EnqueueDispatch.ts

@@ -6,7 +6,7 @@
  * - service 通过这里暴露 queue 生命周期，不直接散落调用细节。
  */
 
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type {
   ChatEnqueueEffectInput,
   ChatEnqueuePipelineInput,
@@ -22,7 +22,7 @@ function normalizeText(value: string): string {
  * 入队前增强。
  */
 export async function prepareChatEnqueue(params: {
-  context: AgentContext;
+  context: PluginContext;
   input: ChatEnqueuePipelineInput;
 }): Promise<ChatEnqueuePipelineInput> {
   const normalized: ChatEnqueuePipelineInput = {
@@ -39,7 +39,7 @@ export async function prepareChatEnqueue(params: {
  * 入队后通知。
  */
 export async function emitChatEnqueueEffect(params: {
-  context: AgentContext;
+  context: PluginContext;
   input: ChatEnqueueEffectInput;
 }): Promise<void> {
   await params.context.plugins.effect(

package/src/chat/runtime/InboundAugment.ts

@@ -3,10 +3,10 @@
  *
  * 关键点（中文）
  * - chat plugin runtime 先构造基础输入，再交给 plugin pipeline 做增强。
- * - 最终拼装顺序固定为：attachmentText -> pluginSections -> bodyText。
+ * - 最终拼装顺序固定为：attachmentText -> pluginSections -> body_text。
  */
 
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { ChatInboundAugmentInput } from "@/chat/types/ChatPlugin.js";
 import type { JsonValue } from "@downcity/agent";
 import { CHAT_PLUGIN_POINTS } from "@/chat/runtime/PluginPoints.js";
@@ -20,19 +20,19 @@ function normalizeText(value: string | undefined): string | undefined {
  * 执行 chat 入站增强 pipeline。
  */
 export async function augmentChatInboundInput(params: {
-  context: AgentContext;
+  context: PluginContext;
   input: ChatInboundAugmentInput;
 }): Promise<ChatInboundAugmentInput> {
   const normalized: ChatInboundAugmentInput = {
     ...params.input,
     ...(params.input.chatType ? { chatType: params.input.chatType } : {}),
-    ...(params.input.chatKey ? { chatKey: params.input.chatKey } : {}),
-    ...(params.input.messageId ? { messageId: params.input.messageId } : {}),
+    ...(params.input.chat_key ? { chat_key: params.input.chat_key } : {}),
+    ...(params.input.message_id ? { message_id: params.input.message_id } : {}),
     ...(normalizeText(params.input.attachmentText)
       ? { attachmentText: normalizeText(params.input.attachmentText) }
       : {}),
-    ...(normalizeText(params.input.bodyText)
-      ? { bodyText: normalizeText(params.input.bodyText) }
+    ...(normalizeText(params.input.body_text)
+      ? { body_text: normalizeText(params.input.body_text) }
       : {}),
     pluginSections: Array.isArray(params.input.pluginSections)
       ? params.input.pluginSections.map((item) => String(item || "").trim()).filter(Boolean)
@@ -55,7 +55,7 @@ export function buildChatInboundText(input: ChatInboundAugmentInput): string {
     ...(Array.isArray(input.pluginSections)
       ? input.pluginSections.map((item) => normalizeText(item)).filter(Boolean)
       : []),
-    normalizeText(input.bodyText),
+    normalizeText(input.body_text),
   ]
     .filter(Boolean)
     .join("\n\n")

package/src/chat/runtime/QueuedUserMessage.ts

@@ -9,8 +9,8 @@
 
 import type { QueuedUserInfoInput } from "@/chat/types/ChatPromptContext.js";
 import {
-  formatDateTimeInTimezone,
-  resolveRuntimeTimezone,
+  format_date_time_in_timezone,
+  resolve_runtime_timezone,
 } from "@downcity/agent";
 
 function normalizeInfoValue(value: unknown): string {
@@ -36,15 +36,15 @@ function normalizeReceivedAtIso(input: unknown): string {
 export function buildQueuedUserMessageWithInfo(params: {
   text: string;
 } & QueuedUserInfoInput): string {
-  const runtimeTimezone = resolveRuntimeTimezone();
+  const runtimeTimezone = resolve_runtime_timezone();
   const receivedAtIso = normalizeReceivedAtIso(params.receivedAt);
   const receivedAtDate = new Date(receivedAtIso);
   const infoLines = [
-    `message_id: ${normalizeInfoValue(params.messageId || "unknown")}`,
-    `user_id: ${normalizeInfoValue(params.userId || "unknown")}`,
+    `message_id: ${normalizeInfoValue(params.message_id || "unknown")}`,
+    `user_id: ${normalizeInfoValue(params.user_id || "unknown")}`,
     `username: ${normalizeInfoValue(params.username || "unknown")}`,
     `received_at: ${normalizeInfoValue(receivedAtIso)}`,
-    `received_at_local: ${normalizeInfoValue(formatDateTimeInTimezone(receivedAtDate, runtimeTimezone))}`,
+    `received_at_local: ${normalizeInfoValue(format_date_time_in_timezone(receivedAtDate, runtimeTimezone))}`,
     `runtime_timezone: ${normalizeInfoValue(runtimeTimezone)}`,
   ];
   if (normalizeInfoValue(params.userTimezone)) {

package/src/chat/runtime/ReplyContextFormatter.ts

@@ -29,19 +29,19 @@ export function buildReplyContextInstruction(params: {
   const replyContext = params.replyContext;
   if (!replyContext) return body;
 
-  const messageId = normalizeReplyValue(replyContext.messageId);
+  const message_id = normalizeReplyValue(replyContext.message_id);
   const actorName = normalizeReplyValue(replyContext.actorName);
   const quoteText = normalizeReplyValue(replyContext.quoteText);
   const replyText = normalizeReplyValue(replyContext.text);
   const normalizedQuote =
     quoteText && quoteText !== replyText ? quoteText : undefined;
 
-  if (!messageId && !actorName && !normalizedQuote && !replyText) {
+  if (!message_id && !actorName && !normalizedQuote && !replyText) {
     return body;
   }
 
   const lines: string[] = ["<reply_context>"];
-  if (messageId) lines.push(`reply_message_id: ${messageId}`);
+  if (message_id) lines.push(`reply_message_id: ${message_id}`);
   if (actorName) lines.push(`reply_actor_name: ${actorName}`);
   if (normalizedQuote) {
     lines.push("reply_quote:");
@@ -69,15 +69,15 @@ export function buildReplyContextExtra(
 ): JsonObject | undefined {
   if (!replyContext) return undefined;
 
-  const messageId = normalizeReplyValue(replyContext.messageId);
+  const message_id = normalizeReplyValue(replyContext.message_id);
   const actorName = normalizeReplyValue(replyContext.actorName);
   const text = normalizeReplyValue(replyContext.text);
   const quoteText = normalizeReplyValue(replyContext.quoteText);
-  if (!messageId && !actorName && !text && !quoteText) return undefined;
+  if (!message_id && !actorName && !text && !quoteText) return undefined;
 
   return {
     hasReplyContext: true,
-    ...(messageId ? { replyMessageId: messageId } : {}),
+    ...(message_id ? { replyMessageId: message_id } : {}),
     ...(actorName ? { replyActorName: actorName } : {}),
     ...(text ? { replyText: text } : {}),
     ...(quoteText ? { replyQuoteText: quoteText } : {}),

package/src/chat/runtime/ReplyDispatch.ts

@@ -6,7 +6,7 @@
  * - 仅服务 agent 执行生命周期，不覆盖手动 `chat send`。
  */
 
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { ChatReplyDispatchInput, ChatReplyEffectInput } from "@/chat/types/ChatPlugin.js";
 import type { JsonValue } from "@downcity/agent";
 import type { ChatDispatchChannel } from "@/chat/types/ChatDispatcher.js";
@@ -21,7 +21,7 @@ function normalizeText(value: string | undefined): string {
  * 回复前文本增强。
  */
 export async function prepareChatReplyText(params: {
-  context: AgentContext;
+  context: PluginContext;
   input: ChatReplyDispatchInput;
 }): Promise<string> {
   const input = {
@@ -45,7 +45,7 @@ export async function prepareChatReplyText(params: {
  * 回复后事件分发。
  */
 export async function emitChatReplyEffect(params: {
-  context: AgentContext;
+  context: PluginContext;
   input: ChatReplyEffectInput;
 }): Promise<void> {
   await params.context.plugins.effect(
@@ -55,24 +55,24 @@ export async function emitChatReplyEffect(params: {
 }
 
 /**
- * 基于 chatKey 补齐回复目标上下文。
+ * 基于 chat_key 补齐回复目标上下文。
  */
 export async function resolveChatReplyTarget(params: {
-  context: AgentContext;
-  chatKey: string;
+  context: PluginContext;
+  chat_key: string;
 }): Promise<{
   channel?: ChatDispatchChannel;
   chatId?: string;
-  messageId?: string;
+  message_id?: string;
 }> {
   const target = await resolveDispatchTargetByChatKey({
     context: params.context,
-    chatKey: params.chatKey,
+    chat_key: params.chat_key,
   });
   if (!target) return {};
   return {
     channel: target.channel,
     chatId: target.chatId,
-    ...(target.messageId ? { messageId: target.messageId } : {}),
+    ...(target.message_id ? { message_id: target.message_id } : {}),
   };
 }

package/src/chat/runtime/SystemPrompt.ts

@@ -7,8 +7,8 @@
  * - 统一从 request context + ChatMetaStore 读取当前 chat 元信息。
  */
 
-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 { ChatEnvironmentPromptInput } from "@/chat/types/ChatPromptContext.js";
 import { readChatMetaBySessionId } from "@/chat/runtime/ChatMetaStore.js";
 
@@ -24,21 +24,21 @@ function normalizePromptValue(value: unknown, fallback: string): string {
  * - 非 chat session 或尚未建立 chat route 时返回 `null`。
  */
 export async function resolveCurrentChatEnvironmentPromptInput(
-  context: AgentContext,
-  run_context?: PluginRunContext,
+  context: PluginContext,
+  execution_context?: PluginExecutionContext,
 ): Promise<ChatEnvironmentPromptInput | null> {
-  const sessionId = String(run_context?.sessionId || "").trim();
-  if (!sessionId) return null;
+  const session_id = String(execution_context?.session_id || "").trim();
+  if (!session_id) return null;
 
   const meta = await readChatMetaBySessionId({
     context,
-    sessionId,
+    session_id,
   }).catch(() => null);
   if (!meta?.channel || !meta.chatId) return null;
 
   return {
-    sessionId: meta.sessionId,
-    chatKey: meta.sessionId,
+    session_id: meta.session_id,
+    chat_key: meta.session_id,
     channel: meta.channel,
     chatId: meta.chatId,
     ...(meta.targetType ? { chatType: meta.targetType } : {}),
@@ -55,8 +55,8 @@ export function buildChatEnvironmentPrompt(input: ChatEnvironmentPromptInput): s
     "# Current Chat Environment",
     "以下字段只描述当前 chat 会话环境与路由，不是用户身份信息：",
     `- channel: ${normalizePromptValue(input.channel, "unknown")}`,
-    `- session_id: ${normalizePromptValue(input.sessionId, "unknown")}`,
-    `- chat_key: ${normalizePromptValue(input.chatKey, "unknown")}`,
+    `- session_id: ${normalizePromptValue(input.session_id, "unknown")}`,
+    `- chat_key: ${normalizePromptValue(input.chat_key, "unknown")}`,
     `- chat_id: ${normalizePromptValue(input.chatId, "unknown")}`,
     `- chat_type: ${normalizePromptValue(input.chatType, "unknown")}`,
     `- thread_id: ${normalizePromptValue(
@@ -77,12 +77,12 @@ export function buildChatEnvironmentPrompt(input: ChatEnvironmentPromptInput): s
  * 读取并渲染当前请求的 chat 环境 prompt。
  */
 export async function buildCurrentChatEnvironmentPrompt(
-  context: AgentContext,
-  run_context?: PluginRunContext,
+  context: PluginContext,
+  execution_context?: PluginExecutionContext,
 ): Promise<string> {
   const input = await resolveCurrentChatEnvironmentPromptInput(
     context,
-    run_context,
+    execution_context,
   );
   if (!input) return "";
   return buildChatEnvironmentPrompt(input);

package/src/chat/types/ChannelContext.ts

@@ -2,8 +2,8 @@
  * ChannelContext 类型定义。
  *
  * 关键点（中文）
- * - 描述渠道目标（platform target）与内部 sessionId 的映射结构。
- * - 映射由 chat plugin runtime 维护，sessionId 对外保持稳定但不可推导。
+ * - 描述渠道目标（platform target）与内部 session_id 的映射结构。
+ * - 映射由 chat plugin runtime 维护，session_id 对外保持稳定但不可推导。
  */
 
 import type { ChatDispatchChannel } from "./ChatDispatcher.js";
@@ -31,7 +31,7 @@ export type ChannelContextTarget = {
 };
 
 /**
- * `sessionId -> 渠道目标` 路由条目。
+ * `session_id -> 渠道目标` 路由条目。
  */
 export type ChannelContextRouteV1 = {
   /**
@@ -39,9 +39,9 @@ export type ChannelContextRouteV1 = {
    */
   v: 1;
   /**
-   * 内部 sessionId（随机生成，不可推导）。
+   * 内部 session_id（随机生成，不可推导）。
    */
-  sessionId: string;
+  session_id: string;
   /**
    * 渠道类型（telegram/feishu/qq）。
    */
@@ -59,9 +59,9 @@ export type ChannelContextRouteV1 = {
    */
   threadId?: number;
   /**
-   * 最近入站/出站相关 messageId（用于回复语义补全）。
+   * 最近入站/出站相关 message_id（用于回复语义补全）。
    */
-  messageId?: string;
+  message_id?: string;
   /**
    * 最近触发该会话的用户 ID。
    */
@@ -81,7 +81,7 @@ export type ChannelContextRouteV1 = {
   /**
    * 路由条目更新时间（毫秒时间戳）。
    */
-  updatedAt: number;
+  updated_at: number;
 };
 
 /**
@@ -95,16 +95,16 @@ export type ChannelContextMetaFileV1 = {
   /**
    * 文件更新时间（毫秒时间戳）。
    */
-  updatedAt: number;
+  updated_at: number;
   /**
-   * 目标键 -> sessionId 映射索引。
+   * 目标键 -> session_id 映射索引。
    *
    * 说明（中文）
    * - 目标键由 `channel/chatId/targetType/threadId` 归一化后拼接。
    */
   sessionIdByTargetKey: Record<string, string>;
   /**
-   * sessionId -> 路由信息映射索引。
+   * session_id -> 路由信息映射索引。
    */
   routesBySessionId: Record<string, ChannelContextRouteV1>;
 };