@downcity/plugins 1.0.174 → 1.0.194

package/src/chat/Action.ts

@@ -3,11 +3,11 @@
  *
  * 关键点（中文）
  * - chat 语义（chatKey 与 sessionId 映射）统一收口在本模块
- * - 通过 SessionRunScope（ALS）读取当前请求上下文
+ * - Session 运行上下文由 action 入口显式传入
  */
 
 import type { AgentContext } from "@downcity/agent";
-import { getSessionRunContext } from "@downcity/agent";
+import type { PluginRunContext } from "@downcity/agent";
 import {
   sendActionByChatKey,
   sendTextByChatKey,
@@ -51,15 +51,16 @@ function readEnvNumber(name: string): number | undefined {
  *
  * 优先级（中文）
  * 1) 显式参数
- * 2) SessionRunScope（ALS）
+ * 2) 显式 PluginRunContext
  * 3) 环境变量回退
  */
 export function resolveChatSessionSnapshot(input?: {
   sessionId?: string;
   chatKey?: string;
   context?: AgentContext;
+  run_context?: PluginRunContext;
 }): ChatSessionSnapshot {
-  const run_context = getSessionRunContext();
+  const run_context = input?.run_context;
 
   const explicitSessionId = String(input?.sessionId || "").trim();
   const explicitChatKey = String(input?.chatKey || "").trim();
@@ -127,11 +128,13 @@ export function resolveSessionId(input?: {
   sessionId?: string;
   chatKey?: string;
   context?: AgentContext;
+  run_context?: PluginRunContext;
 }): string | undefined {
   const snapshot = resolveChatSessionSnapshot({
     sessionId: input?.sessionId,
     chatKey: input?.chatKey,
     context: input?.context,
+    run_context: input?.run_context,
   });
   const key = String(snapshot.sessionId || "").trim();
   return key ? key : undefined;
@@ -144,11 +147,13 @@ export function resolveChatKey(input?: {
   chatKey?: string;
   sessionId?: string;
   context?: AgentContext;
+  run_context?: PluginRunContext;
 }): string | undefined {
   const snapshot = resolveChatSessionSnapshot({
     chatKey: input?.chatKey,
     sessionId: input?.sessionId,
     context: input?.context,
+    run_context: input?.run_context,
   });
   const key = String(snapshot.chatKey || "").trim();
   return key ? key : undefined;
@@ -159,7 +164,7 @@ export function resolveChatKey(input?: {
  *
  * 关键点（中文）
  * - 只有显式 reply 且未手动传入 messageId 时才尝试补全。
- * - 仅在目标 chatKey 与当前请求上下文一致时，才复用 `DC_CTX_MESSAGE_ID` / ALS 快照。
+ * - 仅在目标 chatKey 与当前显式请求上下文一致时，才复用 `DC_CTX_MESSAGE_ID`。
  * - 这样可把一次 run 固定到触发它的那条消息，避免处理中被后续新消息覆盖。
  */
 function resolveReplyMessageIdForChatSend(params: {
@@ -167,6 +172,7 @@ function resolveReplyMessageIdForChatSend(params: {
   context: AgentContext;
   replyToMessage: boolean;
   explicitMessageId?: string;
+  run_context?: PluginRunContext;
 }): string | undefined {
   const explicitMessageId =
     typeof params.explicitMessageId === "string" && params.explicitMessageId.trim()
@@ -177,6 +183,7 @@ function resolveReplyMessageIdForChatSend(params: {
 
   const snapshot = resolveChatSessionSnapshot({
     context: params.context,
+    run_context: params.run_context,
   });
   const snapshotChatKey = String(snapshot.chatKey || "").trim();
   const snapshotMessageId = String(snapshot.messageId || "").trim();
@@ -274,6 +281,7 @@ export async function sendChatTextByChatKey(params: {
   nonBlockingDelay?: boolean;
   replyToMessage?: boolean;
   messageId?: string;
+  run_context?: PluginRunContext;
 }): Promise<ChatSendResponse> {
   const chatKey = String(params.chatKey || "").trim();
   const text = normalizeChatSendText(String(params.text ?? ""));
@@ -305,6 +313,7 @@ export async function sendChatTextByChatKey(params: {
     chatKey,
     replyToMessage,
     explicitMessageId: params.messageId,
+    run_context: params.run_context,
   });
   const targetWaitMs = resolveTargetWaitMs({ delayMs, sendAtMs });
   if (params.nonBlockingDelay === true && targetWaitMs > 0) {
@@ -446,11 +455,13 @@ export async function deleteChatByChatKey(params: {
   context: AgentContext;
   chatKey?: string;
   sessionId?: string;
+  run_context?: PluginRunContext;
 }): Promise<ChatDeleteResponse> {
   const chatKey = resolveChatKey({
     context: params.context,
     chatKey: params.chatKey,
     sessionId: params.sessionId,
+    run_context: params.run_context,
   });
   const sessionId = String(chatKey || "").trim();
   if (!sessionId) {

package/src/chat/ChatPlugin.ts

@@ -11,6 +11,7 @@
 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 { ChatChannelState } from "@/chat/types/ChatRuntime.js";
 import type { ChatQueueWorkerConfig } from "@/chat/types/ChatQueueWorker.js";
 import type {
@@ -87,8 +88,11 @@ export class ChatPlugin extends BasePlugin {
   /**
    * 当前 plugin 的 system 文本构建器。
    */
-  readonly system = async (context: AgentContext): Promise<string> => {
-    return await buildChatPluginSystem(context);
+  readonly system = async (
+    context: AgentContext,
+    run_context?: PluginRunContext,
+  ): Promise<string> => {
+    return await buildChatPluginSystem(context, run_context);
   };
 
   /**
@@ -172,39 +176,6 @@ export class ChatPlugin extends BasePlugin {
     return String(this.getChannel(channel)?.getChannelAccountId(context) || "").trim();
   }
 
-  /**
-   * 更新当前实例的渠道运行态配置。
-   *
-   * 关键点（中文）
-   * - chat.open/close/configure 由 action 先调用宿主持久化能力，再修改当前实例。
-   * - 当前运行态只允许更新 `enabled` 与 `channelAccountId`，密钥仍来自 constructor 或账号池。
-   */
-  applyChannelRuntimePatch(params: {
-    /**
-     * 目标渠道。
-     */
-    channel: ChatChannelName;
-    /**
-     * 是否启用该渠道。
-     */
-    enabled?: boolean;
-    /**
-     * 绑定的账号池记录 ID；传入 null 表示清空绑定。
-     */
-    channelAccountId?: string | null;
-  }): void {
-    const channel = this.getChannel(params.channel);
-    if (!channel) {
-      throw new Error(`Chat channel is not registered: ${params.channel}`);
-    }
-    channel.applyRuntimePatch({
-      ...(typeof params.enabled === "boolean" ? { enabled: params.enabled } : {}),
-      ...(Object.prototype.hasOwnProperty.call(params, "channelAccountId")
-        ? { channelAccountId: params.channelAccountId ?? null }
-        : {}),
-    });
-  }
-
   /**
    * 解析指定渠道当前应使用的账户。
    */

package/src/chat/Index.ts

@@ -20,6 +20,5 @@ export type {
 } from "./channels/RuntimeChannel.js";
 export type {
   ChatChannel,
-  ChatChannelRuntimePatch,
   ChatPluginOptions,
 } from "./types/ChatPluginOptions.js";

package/src/chat/channels/BaseChatChannel.ts

@@ -245,7 +245,7 @@ export abstract class BaseChatChannel {
   protected buildAccessBlockedText(params: {
     result: IncomingChatAccessResult;
   }): string {
-    const agent_id = String(this.context.config.id || "agent").trim() || "agent";
+    const agent_id = String(this.context.agent_id || "agent").trim() || "agent";
     const displayed_agent_id = this.format_access_code(agent_id);
     if (params.result.reason === "identity_missing") {
       return "当前平台身份无法识别，请联系管理员检查 Chat 账号配置。";

package/src/chat/channels/Configuration.ts

@@ -27,7 +27,7 @@ export abstract class ChatChannelConfiguration {
   abstract describe(): ChatChannelConfigurationDescriptor;
 
   /**
-   * 返回可通过 `chat.configure` 更新的运行态字段定义。
+   * 返回允许上游产品编辑的 Agent 配置字段定义。
    */
   get_writable_agent_config_fields(): ChatChannelConfigurationField[] {
     return this.describe().fields.agent_config.filter((field) => field.writable);

package/src/chat/channels/RuntimeChannel.ts

@@ -10,10 +10,7 @@
 import type { AgentContext } from "@downcity/agent";
 import type { StoredChannelAccount } from "@downcity/agent";
 import type { ChatChannelName } from "@/chat/types/ChannelStatus.js";
-import type {
-  ChatChannel,
-  ChatChannelRuntimePatch,
-} from "@/chat/types/ChatPluginOptions.js";
+import type { ChatChannel } from "@/chat/types/ChatPluginOptions.js";
 import { getStoredChannelAccountSync } from "@/chat/accounts/Store.js";
 
 /**
@@ -30,7 +27,7 @@ export interface BaseChatChannelOptions {
    *
    * 说明（中文）
    * - 默认值为 `true`，因为传入 channel 对象通常表示希望启用它。
-   * - 可通过 chat.open / chat.close 在运行态修改。
+   * - 该值由宿主构造 channel 时传入，运行期间保持不变。
    */
   enabled?: boolean;
   /**
@@ -81,15 +78,6 @@ abstract class BaseRuntimeChatChannel implements ChatChannel {
     return this.channelAccountId;
   }
 
-  applyRuntimePatch(patch: ChatChannelRuntimePatch): void {
-    if (typeof patch.enabled === "boolean") {
-      this.enabled = patch.enabled;
-    }
-    if (Object.prototype.hasOwnProperty.call(patch, "channelAccountId")) {
-      this.channelAccountId = String(patch.channelAccountId || "").trim();
-    }
-  }
-
   protected getStoredAccount(): StoredChannelAccount | null {
     if (!this.channelAccountId) return null;
     const account = getStoredChannelAccountSync(this.channelAccountId);

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

@@ -27,6 +27,7 @@ import { parseFeishuAttachments } from "./Shared.js";
 import { FeishuPlatformClient } from "./FeishuPlatformClient.js";
 import { handleFeishuMessage } from "./FeishuMessageHandler.js";
 import { isMissingFeishuSdkDependencyError } from "./FeishuSdk.js";
+import { get_feishu_dedupe_dir_path } from "@/chat/runtime/ChatStorage.js";
 
 /**
  * 飞书入站确认 reaction 类型。
@@ -63,7 +64,7 @@ export class FeishuBot extends BaseChatChannel {
     this.appId = appId;
     this.appSecret = appSecret;
     this.domain = domain;
-    this.dedupeDir = path.join(context.paths.getCacheDirPath(), "feishu", "dedupe");
+    this.dedupeDir = get_feishu_dedupe_dir_path(context.rootPath);
     this.platform = new FeishuPlatformClient({
       context,
       config: {

package/src/chat/runtime/ChannelContextStore.ts

@@ -15,6 +15,10 @@ import type {
   ChannelContextRouteV1,
   ChannelContextTarget,
 } from "@/chat/types/ChannelContext.js";
+import {
+  get_chat_channel_dir_path,
+  get_chat_channel_meta_path,
+} from "@/chat/runtime/ChatStorage.js";
 
 function toOptionalTrimmedString(input: unknown): string | undefined {
   const value = String(input || "").trim();
@@ -169,7 +173,7 @@ export async function readChannelSessionRouteBySessionId(params: {
   const sessionId = toOptionalTrimmedString(params.sessionId);
   if (!rootPath || !sessionId) return null;
   const file = await readMetaFile({
-    filePath: params.context.paths.getDowncityChannelMetaPath(),
+    filePath: get_chat_channel_meta_path(params.context.rootPath),
   });
   return normalizeRoute(file.routesBySessionId[sessionId]);
 }
@@ -195,7 +199,7 @@ export async function listChannelSessionRoutes(params: {
     };
   }
   const file = await readMetaFile({
-    filePath: params.context.paths.getDowncityChannelMetaPath(),
+    filePath: get_chat_channel_meta_path(params.context.rootPath),
   });
   const routes = Object.values(file.routesBySessionId)
     .map((route) => normalizeRoute(route))
@@ -219,7 +223,7 @@ export async function resolveChannelSessionIdByTarget(params: {
   const targetKey = buildChannelTargetKey(params.target);
   if (!targetKey) return null;
   const file = await readMetaFile({
-    filePath: params.context.paths.getDowncityChannelMetaPath(),
+    filePath: get_chat_channel_meta_path(params.context.rootPath),
   });
   const sessionId = toOptionalTrimmedString(file.sessionIdByTargetKey[targetKey]);
   if (!sessionId) return null;
@@ -241,7 +245,7 @@ export async function resolveOrCreateChannelSessionIdByTarget(params: {
   if (!targetKey) return null;
 
   const file = await readMetaFile({
-    filePath: params.context.paths.getDowncityChannelMetaPath(),
+    filePath: get_chat_channel_meta_path(params.context.rootPath),
   });
   const existingSessionId = toOptionalTrimmedString(file.sessionIdByTargetKey[targetKey]);
   if (
@@ -267,8 +271,8 @@ export async function resolveOrCreateChannelSessionIdByTarget(params: {
   };
   file.updatedAt = Date.now();
   await writeMetaFile({
-    dirPath: params.context.paths.getDowncityChannelDirPath(),
-    filePath: params.context.paths.getDowncityChannelMetaPath(),
+    dirPath: get_chat_channel_dir_path(params.context.rootPath),
+    filePath: get_chat_channel_meta_path(params.context.rootPath),
     file,
   });
   return nextSessionId;
@@ -294,7 +298,7 @@ export async function upsertChannelSessionRouteBySessionId(params: {
   if (!targetKey) return;
 
   const file = await readMetaFile({
-    filePath: params.context.paths.getDowncityChannelMetaPath(),
+    filePath: get_chat_channel_meta_path(params.context.rootPath),
   });
   const prev = normalizeRoute(file.routesBySessionId[sessionId]);
   const nextRoute: ChannelContextRouteV1 = {
@@ -333,8 +337,8 @@ export async function upsertChannelSessionRouteBySessionId(params: {
   file.sessionIdByTargetKey[targetKey] = sessionId;
   file.updatedAt = Date.now();
   await writeMetaFile({
-    dirPath: params.context.paths.getDowncityChannelDirPath(),
-    filePath: params.context.paths.getDowncityChannelMetaPath(),
+    dirPath: get_chat_channel_dir_path(params.context.rootPath),
+    filePath: get_chat_channel_meta_path(params.context.rootPath),
     file,
   });
 }
@@ -363,7 +367,7 @@ export async function removeChannelSessionRouteBySessionId(params: {
   }
 
   const file = await readMetaFile({
-    filePath: params.context.paths.getDowncityChannelMetaPath(),
+    filePath: get_chat_channel_meta_path(params.context.rootPath),
   });
   const route = normalizeRoute(file.routesBySessionId[sessionId]);
   if (!route) {
@@ -384,8 +388,8 @@ export async function removeChannelSessionRouteBySessionId(params: {
 
   file.updatedAt = Date.now();
   await writeMetaFile({
-    dirPath: params.context.paths.getDowncityChannelDirPath(),
-    filePath: params.context.paths.getDowncityChannelMetaPath(),
+    dirPath: get_chat_channel_dir_path(params.context.rootPath),
+    filePath: get_chat_channel_meta_path(params.context.rootPath),
     file,
   });
   return {

package/src/chat/runtime/ChatActionExecution.ts

@@ -10,9 +10,11 @@
 import path from "node:path";
 import type { JsonObject } from "@downcity/agent";
 import type { AgentContext } from "@downcity/agent";
+import type { PluginRunContext } from "@downcity/agent";
 import type {
   ChatDeleteActionPayload,
   ChatHistoryActionPayload,
+  ChatHistoryClearActionPayload,
   ChatInfoActionPayload,
   ChatListActionPayload,
   ChatReactActionPayload,
@@ -32,6 +34,36 @@ import { listChannelSessionRoutes } from "@/chat/runtime/ChannelContextStore.js"
 import { readChatHistory } from "@/chat/runtime/ChatHistoryStore.js";
 import { readChatMetaBySessionId } from "@/chat/runtime/ChatMetaStore.js";
 import { resolveChatChannelNameOrThrow } from "@/chat/runtime/ChatChannelFacade.js";
+import {
+  clear_chat_history,
+  get_chat_channel_meta_path,
+  get_chat_history_path,
+  get_chat_session_dir_path,
+} from "@/chat/runtime/ChatStorage.js";
+
+/**
+ * 执行 `chat.history_clear` action。
+ */
+export async function execute_chat_history_clear_action(params: {
+  context: AgentContext;
+  payload: ChatHistoryClearActionPayload;
+}) {
+  const session_id = String(params.payload.sessionId || "").trim();
+  if (!session_id) {
+    return {
+      success: false,
+      error: "Missing sessionId",
+    };
+  }
+  const cleared = await clear_chat_history(params.context.rootPath, session_id);
+  return {
+    success: true,
+    data: {
+      sessionId: session_id,
+      cleared,
+    },
+  };
+}
 
 function toChatHistoryView(events: ChatHistoryEventV1[]): JsonObject[] {
   return events.map((event) => ({
@@ -46,9 +78,11 @@ function toChatHistoryView(events: ChatHistoryEventV1[]): JsonObject[] {
 export async function executeChatContextAction(params: {
   context: AgentContext;
   payload: ChatSessionActionPayload;
+  run_context?: PluginRunContext;
 }) {
   const snapshot = resolveChatSessionSnapshot({
     context: params.context,
+    run_context: params.run_context,
     ...(params.payload.chatKey ? { chatKey: params.payload.chatKey } : {}),
     ...(params.payload.sessionId ? { sessionId: params.payload.sessionId } : {}),
   });
@@ -132,11 +166,13 @@ export async function executeChatListAction(params: {
 export async function executeChatInfoAction(params: {
   context: AgentContext;
   payload: ChatInfoActionPayload;
+  run_context?: PluginRunContext;
 }) {
   const explicitSessionId = String(params.payload.sessionId || "").trim();
   const explicitChatKey = String(params.payload.chatKey || "").trim();
   const snapshot = resolveChatSessionSnapshot({
     context: params.context,
+    run_context: params.run_context,
     ...(explicitSessionId ? { sessionId: explicitSessionId } : {}),
     ...(explicitChatKey ? { chatKey: explicitChatKey } : {}),
   });
@@ -160,13 +196,13 @@ export async function executeChatInfoAction(params: {
     path.relative(params.context.rootPath, absPath).split(path.sep).join("/");
 
   const channelMetaPath = toPosixRelativePath(
-    params.context.paths.getDowncityChannelMetaPath(),
+    get_chat_channel_meta_path(params.context.rootPath),
   );
   const chatDirPath = toPosixRelativePath(
-    path.join(params.context.rootPath, ".downcity", "chat", sessionId),
+    get_chat_session_dir_path(params.context.rootPath, sessionId),
   );
   const historyPath = toPosixRelativePath(
-    params.context.paths.getDowncityChatHistoryPath(sessionId),
+    get_chat_history_path(params.context.rootPath, sessionId),
   );
 
   return {
@@ -192,10 +228,12 @@ export async function executeChatInfoAction(params: {
 export async function executeChatHistoryAction(params: {
   context: AgentContext;
   payload: ChatHistoryActionPayload;
+  run_context?: PluginRunContext;
 }) {
   const payload = params.payload;
   const snapshot = resolveChatSessionSnapshot({
     context: params.context,
+    run_context: params.run_context,
     ...(payload.chatKey ? { chatKey: payload.chatKey } : {}),
     ...(payload.sessionId ? { sessionId: payload.sessionId } : {}),
   });
@@ -242,10 +280,12 @@ export async function executeChatHistoryAction(params: {
 export async function executeChatSendAction(params: {
   context: AgentContext;
   payload: ChatSendActionPayload;
+  run_context?: PluginRunContext;
 }) {
   const chatKey = resolveChatKey({
     chatKey: params.payload.chatKey,
     context: params.context,
+    run_context: params.run_context,
   });
   if (!chatKey) {
     return {
@@ -270,6 +310,7 @@ export async function executeChatSendAction(params: {
     ...(typeof params.payload.messageId === "string" && params.payload.messageId.trim()
       ? { messageId: params.payload.messageId.trim() }
       : {}),
+    run_context: params.run_context,
   });
   if (!result.success) {
     return {
@@ -291,10 +332,12 @@ export async function executeChatSendAction(params: {
 export async function executeChatReactAction(params: {
   context: AgentContext;
   payload: ChatReactActionPayload;
+  run_context?: PluginRunContext;
 }) {
   const chatKey = resolveChatKey({
     chatKey: params.payload.chatKey,
     context: params.context,
+    run_context: params.run_context,
   });
   if (!chatKey) {
     return {
@@ -337,9 +380,11 @@ export async function executeChatReactAction(params: {
 export async function executeChatDeleteAction(params: {
   context: AgentContext;
   payload: ChatDeleteActionPayload;
+  run_context?: PluginRunContext;
 }) {
   const result = await deleteChatByChatKey({
     context: params.context,
+    run_context: params.run_context,
     ...(params.payload.chatKey ? { chatKey: params.payload.chatKey } : {}),
     ...(params.payload.sessionId ? { sessionId: params.payload.sessionId } : {}),
   });

package/src/chat/runtime/ChatActionInput.ts

@@ -7,10 +7,8 @@
  * - `chat send` 的 frontmatter / <file> 协议也在这里完成标准化解析。
  */
 
-import type { JsonObject, JsonValue } from "@downcity/agent";
 import type { PluginActionCommandInput } from "@downcity/agent";
 import type {
-  ChatConfigureActionPayload,
   ChatDeleteActionPayload,
   ChatHistoryActionPayload,
   ChatInfoActionPayload,
@@ -22,7 +20,6 @@ import { resolveChatChannelNameOrThrow } from "@/chat/runtime/ChatChannelFacade.
 import {
   getBooleanOpt,
   getStringOpt,
-  isJsonObject,
   parseOptionalTimestampOrThrow,
   parsePositiveIntOptionOrThrow,
   readHistoryDirectionOrThrow,
@@ -67,34 +64,6 @@ export function mapChatInfoCommandInput(
   };
 }
 
-export function mapChatConfigureCommandInput(
-  input: PluginActionCommandInput,
-): ChatConfigureActionPayload {
-  const channelRaw = getStringOpt(input.opts, "channel");
-  if (!channelRaw) {
-    throw new Error("Missing --channel. Use telegram|feishu|qq.");
-  }
-  const channel = resolveChatChannelNameOrThrow(channelRaw);
-  const rawConfigJson = getStringOpt(input.opts, "configJson");
-  if (!rawConfigJson) {
-    throw new Error("Missing --config-json.");
-  }
-  let parsed: JsonValue = {};
-  try {
-    parsed = JSON.parse(rawConfigJson) as JsonValue;
-  } catch (error) {
-    throw new Error(`Invalid --config-json: ${String(error)}`);
-  }
-  if (!isJsonObject(parsed)) {
-    throw new Error("--config-json must be a JSON object");
-  }
-  return {
-    channel,
-    config: parsed as Record<string, JsonValue>,
-    restart: getBooleanOpt(input.opts, "restart"),
-  };
-}
-
 export function mapChatHistoryCommandInput(
   input: PluginActionCommandInput,
 ): ChatHistoryActionPayload {