@downcity/plugins 1.0.215 → 1.0.233

package/bin/chat/Action.d.ts

@@ -2,11 +2,11 @@
  * 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 type { ChatDispatchAction } from "./types/ChatDispatcher.js";
 import type { ChatSessionSnapshot, ChatDeleteResponse, ChatReactResponse, ChatSendResponse } from "./types/ChatCommand.js";
 /**
@@ -14,40 +14,40 @@ import type { ChatSessionSnapshot, ChatDeleteResponse, ChatReactResponse, ChatSe
  *
  * 优先级（中文）
  * 1) 显式参数
- * 2) 显式 PluginRunContext
+ * 2) 显式 PluginExecutionContext
  * 3) 环境变量回退
  */
 export declare function resolveChatSessionSnapshot(input?: {
-    sessionId?: string;
-    chatKey?: string;
-    context?: AgentContext;
-    run_context?: PluginRunContext;
+    session_id?: string;
+    chat_key?: string;
+    context?: PluginContext;
+    execution_context?: PluginExecutionContext;
 }): ChatSessionSnapshot;
 /**
- * 将 sessionId 映射为可发送的 chatKey。
+ * 将 session_id 映射为可发送的 chat_key。
  *
  * 关键点（中文）
- * - 当前实现下：chat plugin runtime 内部把 sessionId 视作可发送 chatKey。
- * - 不再依赖字符串规则推导（sessionId 可为随机值）。
+ * - 当前实现下：chat plugin runtime 内部把 session_id 视作可发送 chat_key。
+ * - 不再依赖字符串规则推导（session_id 可为随机值）。
  */
-export declare function mapSessionIdToChatKey(sessionId?: string): string | undefined;
+export declare function mapSessionIdToChatKey(session_id?: string): string | undefined;
 /**
- * 提取最终 sessionId。
+ * 提取最终 session_id。
  */
-export declare function resolveSessionId(input?: {
-    sessionId?: string;
-    chatKey?: string;
-    context?: AgentContext;
-    run_context?: PluginRunContext;
+export declare function resolve_session_id(input?: {
+    session_id?: string;
+    chat_key?: string;
+    context?: PluginContext;
+    execution_context?: PluginExecutionContext;
 }): string | undefined;
 /**
- * 提取最终 chatKey（用于发送路径）。
+ * 提取最终 chat_key（用于发送路径）。
  */
 export declare 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;
 /**
  * 规范化 `chat send` 文本。
@@ -58,18 +58,18 @@ export declare function resolveChatKey(input?: {
  */
 export declare function normalizeChatSendText(raw: string): string;
 /**
- * 按 chatKey 发送文本。
+ * 按 chat_key 发送文本。
  *
  * 关键点（中文）
  * - chat plugin runtime 不关心具体平台；由 runtime sender 做 channel 分发。
  * - 返回统一结构，便于上层链路做可观测与错误汇总。
  */
 export declare 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;
     /**
      * 延迟发送是否异步调度（不阻塞当前调用）。
      *
@@ -78,54 +78,54 @@ export declare 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>;
 /**
- * 按 chatKey 发送平台动作（typing/react）。
+ * 按 chat_key 发送平台动作（typing/react）。
  *
  * 关键点（中文）
- * - 动作分发与文本发送复用同一 chatKey 解析与 channel dispatcher。
+ * - 动作分发与文本发送复用同一 chat_key 解析与 channel dispatcher。
  */
 export declare 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>;
 /**
- * 按 sessionId 发送文本。
+ * 按 session_id 发送文本。
  *
  * 关键点（中文）
- * - sessionId -> chatKey 映射关系只在 chat plugin runtime 内部维护。
+ * - session_id -> chat_key 映射关系只在 chat plugin runtime 内部维护。
  */
 export declare function sendChatTextBySessionId(params: {
-    context: AgentContext;
-    sessionId: string;
+    context: PluginContext;
+    session_id: string;
     text: string;
-    delayMs?: number;
-    sendAtMs?: number;
-    replyToMessage?: boolean;
-    messageId?: string;
+    delay_ms?: number;
+    send_at_ms?: number;
+    reply_to_message?: boolean;
+    message_id?: string;
 }): Promise<{
     success: boolean;
-    sessionId: string;
+    session_id: string;
     error?: string;
 }>;
 /**
- * 按 chatKey/sessionId 彻底删除 chat 会话。
+ * 按 chat_key/session_id 彻底删除 chat 会话。
  *
  * 关键点（中文）
- * - chatKey 与 sessionId 在 chat plugin runtime 内部等价使用。
+ * - chat_key 与 session_id 在 chat plugin runtime 内部等价使用。
  * - 删除包含：路由映射 + chat 审计目录 + session 目录 + 渠道状态清理。
  */
 export declare 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>;
 //# sourceMappingURL=Action.d.ts.map

package/bin/chat/Action.d.ts.map

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

package/bin/chat/Action.js

@@ -2,7 +2,7 @@
  * Chat command services.
  *
  * 关键点（中文）
- * - chat 语义（chatKey 与 sessionId 映射）统一收口在本模块
+ * - chat 语义（chat_key 与 session_id 映射）统一收口在本模块
  * - Session 运行上下文由 action 入口显式传入
  */
 import { sendActionByChatKey, sendTextByChatKey, } from "./runtime/ChatkeySend.js";
@@ -37,15 +37,16 @@ function readEnvNumber(name) {
  *
  * 优先级（中文）
  * 1) 显式参数
- * 2) 显式 PluginRunContext
+ * 2) 显式 PluginExecutionContext
  * 3) 环境变量回退
  */
 export function resolveChatSessionSnapshot(input) {
-    const run_context = input?.run_context;
-    const explicitSessionId = String(input?.sessionId || "").trim();
-    const explicitChatKey = String(input?.chatKey || "").trim();
-    const requestSessionId = typeof run_context?.sessionId === "string" && run_context.sessionId.trim()
-        ? run_context.sessionId.trim()
+    const execution_context = input?.execution_context;
+    const explicitSessionId = String(input?.session_id || "").trim();
+    const explicitChatKey = String(input?.chat_key || "").trim();
+    const requestSessionId = 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");
@@ -55,75 +56,75 @@ export function resolveChatSessionSnapshot(input) {
         readEnvNumber("DC_CTX_MESSAGE_THREAD_ID");
     const chatType = readEnvString("DC_CTX_TARGET_TYPE") ||
         readEnvString("DC_CTX_CHAT_TYPE");
-    const userId = readEnvString("DC_CTX_ACTOR_ID") ||
+    const user_id = readEnvString("DC_CTX_ACTOR_ID") ||
         readEnvString("DC_CTX_USER_ID");
-    const messageId = readEnvString("DC_CTX_MESSAGE_ID");
-    const sessionId = explicitSessionId ||
+    const message_id = readEnvString("DC_CTX_MESSAGE_ID");
+    const session_id = explicitSessionId ||
         requestSessionId ||
         envSessionId ||
         explicitChatKey ||
         envChatKey;
-    const chatKey = explicitChatKey ||
-        mapSessionIdToChatKey(sessionId) ||
+    const chat_key = explicitChatKey ||
+        mapSessionIdToChatKey(session_id) ||
         envChatKey;
     const snapshot = {
-        ...(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) {
-    const key = String(sessionId || "").trim();
+export function mapSessionIdToChatKey(session_id) {
+    const key = String(session_id || "").trim();
     if (!key)
         return undefined;
     return key;
 }
 /**
- * 提取最终 sessionId。
+ * 提取最终 session_id。
  */
-export function resolveSessionId(input) {
+export function resolve_session_id(input) {
     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) {
     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) {
     const explicitMessageId = typeof params.explicitMessageId === "string" && params.explicitMessageId.trim()
@@ -131,17 +132,17 @@ function resolveReplyMessageIdForChatSend(params) {
         : undefined;
     if (explicitMessageId)
         return explicitMessageId;
-    if (params.replyToMessage !== true)
+    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;
 }
 /**
  * 规范化 `chat send` 文本。
@@ -170,13 +171,13 @@ export function normalizeChatSendText(raw) {
  * 发送前延迟。
  *
  * 关键点（中文）
- * - 支持延迟毫秒（delayMs）或绝对时间（sendAtMs）
+ * - 支持延迟毫秒（delay_ms）或绝对时间（send_at_ms）
  * - 超长等待按分片 setTimeout，避免超出 Node 单次定时器上限
  */
 function resolveTargetWaitMs(params) {
-    const delayMs = params.delayMs;
-    const sendAtMs = params.sendAtMs;
-    const rawWaitMs = typeof sendAtMs === "number" ? Math.max(0, sendAtMs - Date.now()) : delayMs;
+    const delay_ms = params.delay_ms;
+    const send_at_ms = params.send_at_ms;
+    const rawWaitMs = 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);
@@ -198,43 +199,43 @@ async function waitBeforeSend(params) {
     await waitByTimeoutChunks(resolveTargetWaitMs(params));
 }
 /**
- * 按 chatKey 发送文本。
+ * 按 chat_key 发送文本。
  *
  * 关键点（中文）
  * - chat plugin runtime 不关心具体平台；由 runtime sender 做 channel 分发。
  * - 返回统一结构，便于上层链路做可观测与错误汇总。
  */
 export async function sendChatTextByChatKey(params) {
-    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 () => {
@@ -242,134 +243,134 @@ 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) {
-    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) {
-    const sessionId = String(params.sessionId || "").trim();
-    if (!sessionId) {
+    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) {
-    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.",
+            error: "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,