@downcity/plugins 1.0.254 → 1.0.280

package/src/chat/runtime/ChannelContextStore.ts

@@ -2,7 +2,7 @@
  * ChannelContextStore：渠道目标与 session_id 映射存储。
  *
  * 关键点（中文）
- * - 映射文件位于 `.downcity/channel/meta.json`。
+ * - 映射文件位于当前 Agent private runtime directory 数据目录的 `channel/meta.json`。
  * - session_id 由服务端随机生成并持久化，不依赖字符串拼接规则。
  * - 统一提供“按目标找 session_id / 按 session_id 找目标”能力。
  */
@@ -169,11 +169,11 @@ export async function readChannelSessionRouteBySessionId(params: {
   context: PluginContext;
   session_id: string;
 }): Promise<ChannelContextRouteV1 | null> {
-  const rootPath = String(params.context.workspace_path || "").trim();
+  const rootPath = String(params.context.data_path || "").trim();
   const session_id = toOptionalTrimmedString(params.session_id);
   if (!rootPath || !session_id) return null;
   const file = await readMetaFile({
-    filePath: get_chat_channel_meta_path(params.context.workspace_path),
+    filePath: get_chat_channel_meta_path(params.context.data_path),
   });
   return normalizeRoute(file.routesBySessionId[session_id]);
 }
@@ -182,7 +182,7 @@ export async function readChannelSessionRouteBySessionId(params: {
  * 列出当前 agent 已记录的所有渠道路由条目。
  *
  * 关键点（中文）
- * - 数据源为 `.downcity/channel/meta.json` 的 `routesBySessionId`。
+ * - 数据源为当前 Agent private runtime directory 数据目录下 `channel/meta.json` 的 `routesBySessionId`。
  * - 默认按 `updated_at` 倒序返回，便于展示“最近活跃”会话。
  */
 export async function listChannelSessionRoutes(params: {
@@ -191,7 +191,7 @@ export async function listChannelSessionRoutes(params: {
   updated_at: number;
   routes: ChannelContextRouteV1[];
 }> {
-  const rootPath = String(params.context.workspace_path || "").trim();
+  const rootPath = String(params.context.data_path || "").trim();
   if (!rootPath) {
     return {
       updated_at: Date.now(),
@@ -199,7 +199,7 @@ export async function listChannelSessionRoutes(params: {
     };
   }
   const file = await readMetaFile({
-    filePath: get_chat_channel_meta_path(params.context.workspace_path),
+    filePath: get_chat_channel_meta_path(params.context.data_path),
   });
   const routes = Object.values(file.routesBySessionId)
     .map((route) => normalizeRoute(route))
@@ -218,12 +218,12 @@ export async function resolveChannelSessionIdByTarget(params: {
   context: PluginContext;
   target: ChannelContextTarget;
 }): Promise<string | null> {
-  const rootPath = String(params.context.workspace_path || "").trim();
+  const rootPath = String(params.context.data_path || "").trim();
   if (!rootPath) return null;
   const targetKey = buildChannelTargetKey(params.target);
   if (!targetKey) return null;
   const file = await readMetaFile({
-    filePath: get_chat_channel_meta_path(params.context.workspace_path),
+    filePath: get_chat_channel_meta_path(params.context.data_path),
   });
   const session_id = toOptionalTrimmedString(file.sessionIdByTargetKey[targetKey]);
   if (!session_id) return null;
@@ -237,7 +237,7 @@ export async function resolveOrCreateChannelSessionIdByTarget(params: {
   context: PluginContext;
   target: ChannelContextTarget;
 }): Promise<string | null> {
-  const rootPath = String(params.context.workspace_path || "").trim();
+  const rootPath = String(params.context.data_path || "").trim();
   if (!rootPath) return null;
   const normalizedTarget = normalizeTarget(params.target);
   if (!normalizedTarget) return null;
@@ -245,7 +245,7 @@ export async function resolveOrCreateChannelSessionIdByTarget(params: {
   if (!targetKey) return null;
 
   const file = await readMetaFile({
-    filePath: get_chat_channel_meta_path(params.context.workspace_path),
+    filePath: get_chat_channel_meta_path(params.context.data_path),
   });
   const existingSessionId = toOptionalTrimmedString(file.sessionIdByTargetKey[targetKey]);
   if (
@@ -271,8 +271,8 @@ export async function resolveOrCreateChannelSessionIdByTarget(params: {
   };
   file.updated_at = Date.now();
   await writeMetaFile({
-    dirPath: get_chat_channel_dir_path(params.context.workspace_path),
-    filePath: get_chat_channel_meta_path(params.context.workspace_path),
+    dirPath: get_chat_channel_dir_path(params.context.data_path),
+    filePath: get_chat_channel_meta_path(params.context.data_path),
     file,
   });
   return nextSessionId;
@@ -290,7 +290,7 @@ export async function upsertChannelSessionRouteBySessionId(params: {
   actorName?: string;
   chatTitle?: string;
 }): Promise<void> {
-  const rootPath = String(params.context.workspace_path || "").trim();
+  const rootPath = String(params.context.data_path || "").trim();
   const session_id = toOptionalTrimmedString(params.session_id);
   const normalizedTarget = normalizeTarget(params.target);
   if (!rootPath || !session_id || !normalizedTarget) return;
@@ -298,7 +298,7 @@ export async function upsertChannelSessionRouteBySessionId(params: {
   if (!targetKey) return;
 
   const file = await readMetaFile({
-    filePath: get_chat_channel_meta_path(params.context.workspace_path),
+    filePath: get_chat_channel_meta_path(params.context.data_path),
   });
   const prev = normalizeRoute(file.routesBySessionId[session_id]);
   const nextRoute: ChannelContextRouteV1 = {
@@ -337,8 +337,8 @@ export async function upsertChannelSessionRouteBySessionId(params: {
   file.sessionIdByTargetKey[targetKey] = session_id;
   file.updated_at = Date.now();
   await writeMetaFile({
-    dirPath: get_chat_channel_dir_path(params.context.workspace_path),
-    filePath: get_chat_channel_meta_path(params.context.workspace_path),
+    dirPath: get_chat_channel_dir_path(params.context.data_path),
+    filePath: get_chat_channel_meta_path(params.context.data_path),
     file,
   });
 }
@@ -357,7 +357,7 @@ export async function removeChannelSessionRouteBySessionId(params: {
   removed: boolean;
   route: ChannelContextRouteV1 | null;
 }> {
-  const rootPath = String(params.context.workspace_path || "").trim();
+  const rootPath = String(params.context.data_path || "").trim();
   const session_id = toOptionalTrimmedString(params.session_id);
   if (!rootPath || !session_id) {
     return {
@@ -367,7 +367,7 @@ export async function removeChannelSessionRouteBySessionId(params: {
   }
 
   const file = await readMetaFile({
-    filePath: get_chat_channel_meta_path(params.context.workspace_path),
+    filePath: get_chat_channel_meta_path(params.context.data_path),
   });
   const route = normalizeRoute(file.routesBySessionId[session_id]);
   if (!route) {
@@ -388,8 +388,8 @@ export async function removeChannelSessionRouteBySessionId(params: {
 
   file.updated_at = Date.now();
   await writeMetaFile({
-    dirPath: get_chat_channel_dir_path(params.context.workspace_path),
-    filePath: get_chat_channel_meta_path(params.context.workspace_path),
+    dirPath: get_chat_channel_dir_path(params.context.data_path),
+    filePath: get_chat_channel_meta_path(params.context.data_path),
     file,
   });
   return {

package/src/chat/runtime/ChatActionExecution.ts

@@ -55,7 +55,7 @@ export async function execute_chat_history_clear_action(params: {
       error: "Missing session_id",
     };
   }
-  const cleared = await clear_chat_history(params.context.workspace_path, session_id);
+  const cleared = await clear_chat_history(params.context.data_path, session_id);
   return {
     success: true,
     data: {
@@ -193,16 +193,16 @@ export async function executeChatInfoAction(params: {
   });
 
   const toPosixRelativePath = (absPath: string): string =>
-    path.relative(params.context.workspace_path, absPath).split(path.sep).join("/");
+    path.relative(params.context.data_path, absPath).split(path.sep).join("/");
 
   const channelMetaPath = toPosixRelativePath(
-    get_chat_channel_meta_path(params.context.workspace_path),
+    get_chat_channel_meta_path(params.context.data_path),
   );
   const chatDirPath = toPosixRelativePath(
-    get_chat_session_dir_path(params.context.workspace_path, session_id),
+    get_chat_session_dir_path(params.context.data_path, session_id),
   );
   const historyPath = toPosixRelativePath(
-    get_chat_history_path(params.context.workspace_path, session_id),
+    get_chat_history_path(params.context.data_path, session_id),
   );
 
   return {
@@ -259,7 +259,7 @@ export async function executeChatHistoryAction(params: {
     afterTs: payload.afterTs,
   });
   const historyPath = historyResult.historyPath
-    .replace(`${params.context.workspace_path}/`, "")
+    .replace(`${params.context.data_path}/`, "")
     .split("\\")
     .join("/");
 

package/src/chat/runtime/ChatChannelConfig.ts

@@ -6,7 +6,6 @@
  * - Plugin 只读取宿主构造时传入的 channel 配置，不负责修改或持久化。
  */
 
-import type { JsonObject } from "@downcity/agent";
 import type { PluginContext } from "@downcity/agent";
 import type { ChatRuntimeAccount } from "@/chat/types/ChatRuntimeAccount.js";
 import type {
@@ -14,7 +13,6 @@ import type {
   ChatChannelStateSnapshot,
 } from "@/chat/types/ChannelStatus.js";
 import type { ChatChannelState } from "@/chat/types/ChatRuntime.js";
-import { get_chat_plugin_resource_json_schema } from "@/chat/config/ChatPluginConfig.js";
 import {
   getChatChannelBot,
   isChatChannelEnabled,
@@ -23,10 +21,6 @@ import {
   resolveChannelAccountId,
 } from "./ChatChannelCore.js";
 
-function toJsonObject(input: unknown): JsonObject {
-  return JSON.parse(JSON.stringify(input)) as JsonObject;
-}
-
 /**
  * 生成可安全暴露给 UI 的渠道配置摘要。
  *
@@ -40,26 +34,26 @@ export function buildChatChannelConfigSummary(
   accountInput?: ChatRuntimeAccount | null,
 ): Record<string, string | number | boolean | null> {
   const account = accountInput ?? resolveChannelAccount(context, channel);
-  const resource_id = resolveChannelAccountId(context, channel);
+  const channel_id = resolveChannelAccountId(context, channel);
   const configured = isChannelAccountConfigured(channel, account);
   if (channel === "telegram") {
     return {
       enabled: isChatChannelEnabled(context, channel),
-      resource_id: resource_id || null,
-      resource_configured: configured,
+      channel_id: channel_id || null,
+      channel_configured: configured,
     };
   }
   if (channel === "feishu") {
     return {
       enabled: isChatChannelEnabled(context, channel),
-      resource_id: resource_id || null,
-      resource_configured: configured,
+      channel_id: channel_id || null,
+      channel_configured: configured,
     };
   }
   return {
     enabled: isChatChannelEnabled(context, channel),
-    resource_id: resource_id || null,
-    resource_configured: configured,
+    channel_id: channel_id || null,
+    channel_configured: configured,
   };
 }
 
@@ -97,7 +91,6 @@ export function getChatChannelStatus(
     detail: {
       ...(runtime?.detail || {}),
       config: buildChatChannelConfigSummary(context, channel, channelAccount),
-      resource_schema: toJsonObject(get_chat_plugin_resource_json_schema(channel)),
     },
   };
 }

package/src/chat/runtime/ChatChannelCore.ts

@@ -14,8 +14,8 @@ import type { ChatChannelState } from "@/chat/types/ChatRuntime.js";
 
 const CHAT_CHANNEL_NAMES: ChatChannelName[] = ["telegram", "feishu", "qq"];
 
-export type ChatRuntimeBindings = {
-  getResourceId?(context: PluginContext, channel: ChatChannelName): string;
+export type ChatPluginRuntimeApi = {
+  get_channel_id?(context: PluginContext, channel: ChatChannelName): string;
   resolveChannelAccount?(
     context: PluginContext,
     channel: ChatChannelName,
@@ -23,11 +23,11 @@ export type ChatRuntimeBindings = {
   isChannelEnabled?(context: PluginContext, channel: ChatChannelName): boolean;
 };
 
-export function resolveChatPluginBindings(
+export function resolveChatPluginRuntimeApi(
   context: PluginContext,
-): ChatRuntimeBindings | null {
+): ChatPluginRuntimeApi | null {
   const candidate = context.plugins.get("chat") as
-    | ChatRuntimeBindings
+    | ChatPluginRuntimeApi
     | undefined;
   return candidate || null;
 }
@@ -74,8 +74,8 @@ export function resolveChannelAccountId(
   context: PluginContext,
   channel: ChatChannelName,
 ): string {
-  const plugin = resolveChatPluginBindings(context);
-  const explicit = String(plugin?.getResourceId?.(context, channel) || "").trim();
+  const plugin = resolveChatPluginRuntimeApi(context);
+  const explicit = String(plugin?.get_channel_id?.(context, channel) || "").trim();
   if (explicit) return explicit;
   return "";
 }
@@ -91,7 +91,7 @@ export function resolveChannelAccount(
   context: PluginContext,
   channel: ChatChannelName,
 ): ChatRuntimeAccount | null {
-  const plugin = resolveChatPluginBindings(context);
+  const plugin = resolveChatPluginRuntimeApi(context);
   const explicit = plugin?.resolveChannelAccount?.(context, channel);
   return explicit?.channel === channel ? explicit : null;
 }
@@ -117,7 +117,7 @@ export function isChatChannelEnabled(
   context: PluginContext,
   channel: ChatChannelName,
 ): boolean {
-  const plugin = resolveChatPluginBindings(context);
+  const plugin = resolveChatPluginRuntimeApi(context);
   if (typeof plugin?.isChannelEnabled === "function") {
     return plugin.isChannelEnabled(context, channel);
   }

package/src/chat/runtime/ChatHistoryStore.ts

@@ -2,7 +2,7 @@
  * ChatHistoryStore：聊天事件流持久化。
  *
  * 关键点（中文）
- * - 写入 `.downcity/chat/<session_id>/history.jsonl`（append-only）。
+ * - 写入 Agent private runtime directory 数据目录的 `chat/<session_id>/history.jsonl`（append-only）。
  * - 记录 inbound（audit/exec）与 outbound 事件。
  * - 与 session message history 分离，避免审计噪声进入模型上下文。
  */
@@ -145,7 +145,7 @@ export async function appendInboundChatHistory(params: {
   actorName?: string;
   extra?: JsonObject;
 }): Promise<void> {
-  const rootPath = normalizeTrimmedString(params.context.workspace_path);
+  const rootPath = normalizeTrimmedString(params.context.data_path);
   const session_id = normalizeTrimmedString(params.session_id);
   const chatId = normalizeTrimmedString(params.chatId);
   if (!rootPath || !session_id || !chatId) return;
@@ -164,7 +164,7 @@ export async function appendInboundChatHistory(params: {
     extra: toOptionalObject(params.extra),
   });
 
-  const file = get_chat_history_path(params.context.workspace_path, session_id);
+  const file = get_chat_history_path(params.context.data_path, session_id);
   await fs.ensureDir(path.dirname(file));
   await fs.appendFile(file, JSON.stringify(event) + "\n", "utf8");
 }
@@ -189,7 +189,7 @@ export async function appendOutboundChatHistory(params: {
   actorName?: string;
   extra?: JsonObject;
 }): Promise<void> {
-  const rootPath = normalizeTrimmedString(params.context.workspace_path);
+  const rootPath = normalizeTrimmedString(params.context.data_path);
   const session_id = normalizeTrimmedString(params.session_id);
   const chatId = normalizeTrimmedString(params.chatId);
   if (!rootPath || !session_id || !chatId) return;
@@ -207,7 +207,7 @@ export async function appendOutboundChatHistory(params: {
     extra: toOptionalObject(params.extra),
   });
 
-  const file = get_chat_history_path(params.context.workspace_path, session_id);
+  const file = get_chat_history_path(params.context.data_path, session_id);
   await fs.ensureDir(path.dirname(file));
   await fs.appendFile(file, JSON.stringify(event) + "\n", "utf8");
 }
@@ -227,9 +227,9 @@ export async function readChatHistory(params: {
   beforeTs?: number;
   afterTs?: number;
 }): Promise<{ historyPath: string; events: ChatHistoryEventV1[] }> {
-  const rootPath = normalizeTrimmedString(params.context.workspace_path);
+  const rootPath = normalizeTrimmedString(params.context.data_path);
   const session_id = normalizeTrimmedString(params.session_id);
-  const historyPath = get_chat_history_path(params.context.workspace_path, session_id);
+  const historyPath = get_chat_history_path(params.context.data_path, session_id);
   if (!rootPath || !session_id) {
     return {
       historyPath,

package/src/chat/runtime/ChatMetaStore.ts

@@ -4,7 +4,7 @@
  * 关键点（中文）
  * - 入站消息到达时由 chat plugin runtime 写入
  * - 出站按 session_id/chat_key 发送时由 chat plugin runtime 读取
- * - 底层数据落在 `.downcity/channel/meta.json`，由 ChannelContextStore 统一维护
+ * - 底层数据落在 Agent private runtime directory 数据目录的 `channel/meta.json`，由 ChannelContextStore 统一维护
  */
 
 import type { PluginContext } from "@downcity/agent";

package/src/chat/runtime/ChatPluginActionRegistry.ts

@@ -87,7 +87,7 @@ function attachCommandHelpText(command: Command, text: string): void {
  * 创建 chat plugin runtime 的 action 定义表。
  */
 export function createChatPluginActions(params: {
-  channelState: ChatChannelState;
+  resolve_channel_state: (context: import("@downcity/agent").PluginContext) => ChatChannelState;
 }): PluginActions {
   return {
     status: create_action({
@@ -105,7 +105,7 @@ export function createChatPluginActions(params: {
       },
       execute: async (actionParams) => {
         return executeChatStatusAction({
-          state: params.channelState,
+          state: params.resolve_channel_state(actionParams.context),
           context: actionParams.context,
           payload: actionParams.input as ChatStatusActionPayload,
         });
@@ -126,7 +126,7 @@ export function createChatPluginActions(params: {
       },
       execute: async (actionParams) => {
         return executeChatTestAction({
-          state: params.channelState,
+          state: params.resolve_channel_state(actionParams.context),
           context: actionParams.context,
           payload: actionParams.input as ChatTestActionPayload,
         });
@@ -147,7 +147,7 @@ export function createChatPluginActions(params: {
       },
       execute: async (actionParams) => {
         return executeChatReconnectAction({
-          state: params.channelState,
+          state: params.resolve_channel_state(actionParams.context),
           context: actionParams.context,
           payload: actionParams.input as ChatReconnectActionPayload,
         });
@@ -195,7 +195,7 @@ export function createChatPluginActions(params: {
         return executeChatInfoAction({
           context: actionParams.context,
           payload: actionParams.input as ChatInfoActionPayload,
-          execution_context: actionParams.execution_context,
+          execution_context: actionParams.execution.snapshot,
         });
       },
     }),
@@ -226,7 +226,7 @@ export function createChatPluginActions(params: {
         return executeChatSendAction({
           context: actionParams.context,
           payload: actionParams.input as ChatSendActionPayload,
-          execution_context: actionParams.execution_context,
+          execution_context: actionParams.execution.snapshot,
         });
       },
     }),
@@ -255,7 +255,7 @@ export function createChatPluginActions(params: {
         return executeChatReactAction({
           context: actionParams.context,
           payload: actionParams.input as ChatReactActionPayload,
-          execution_context: actionParams.execution_context,
+          execution_context: actionParams.execution.snapshot,
         });
       },
     }),
@@ -282,7 +282,7 @@ export function createChatPluginActions(params: {
         return executeChatContextAction({
           context: actionParams.context,
           payload: actionParams.input as ChatSessionActionPayload,
-          execution_context: actionParams.execution_context,
+          execution_context: actionParams.execution.snapshot,
         });
       },
     }),
@@ -305,7 +305,7 @@ export function createChatPluginActions(params: {
         return executeChatDeleteAction({
           context: actionParams.context,
           payload: actionParams.input as ChatDeleteActionPayload,
-          execution_context: actionParams.execution_context,
+          execution_context: actionParams.execution.snapshot,
         });
       },
     }),
@@ -335,7 +335,7 @@ export function createChatPluginActions(params: {
         return executeChatHistoryAction({
           context: actionParams.context,
           payload: actionParams.input as ChatHistoryActionPayload,
-          execution_context: actionParams.execution_context,
+          execution_context: actionParams.execution.snapshot,
         });
       },
     }),

package/src/chat/runtime/ChatQueue.ts

@@ -1,77 +1,10 @@
-/**
- * ChatQueue 共享门面。
- *
- * 关键点（中文）
- * - 迁移阶段保留旧函数式 API，内部委托给共享 `ChatQueueStore`。
- * - 新代码应优先通过 `ChatQueueStore` 实例或 `resolveChatQueueStore(runtime)` 使用队列。
- */
-
-import type {
-  ChatQueueEnqueueParams,
-  ChatQueueEnqueueResult,
-  ChatQueueItem,
-} from "@/chat/types/ChatQueue.js";
+/** Chat Queue 对外类型与显式运行时解析入口。 */
 import {
   ChatQueueStore,
-  getSharedChatQueueStore,
   resolveChatQueueStore,
   type ChatQueueEnqueueListener,
   type ChatQueueStorePort,
 } from "./ChatQueueStore.js";
 
-export { ChatQueueStore, getSharedChatQueueStore, resolveChatQueueStore };
+export { ChatQueueStore, resolveChatQueueStore };
 export type { ChatQueueEnqueueListener, ChatQueueStorePort };
-
-/**
- * 订阅共享 queue 的入队事件。
- */
-export function onChatQueueEnqueue(listener: ChatQueueEnqueueListener): () => void {
-  return getSharedChatQueueStore().onEnqueue(listener);
-}
-
-/**
- * 向共享 queue 入队。
- */
-export function enqueueChatQueue(
-  params: ChatQueueEnqueueParams,
-): ChatQueueEnqueueResult {
-  return getSharedChatQueueStore().enqueue(params);
-}
-
-/**
- * 从共享 queue 弹出一条消息。
- */
-export function shiftChatQueueItem(laneKey: string): ChatQueueItem | null {
-  return getSharedChatQueueStore().shift(laneKey);
-}
-
-/**
- * 从共享 queue drain 某个 lane。
- */
-export function drainChatQueueLane(
-  laneKey: string,
-  maxItems?: number,
-): ChatQueueItem[] {
-  return getSharedChatQueueStore().drain(laneKey, maxItems);
-}
-
-/**
- * 列出共享 queue 当前积压的 lane keys。
- */
-export function listChatQueueLanes(): string[] {
-  return getSharedChatQueueStore().listLanes();
-}
-
-/**
- * 查询共享 queue 某个 lane 的长度。
- */
-export function getChatQueueLaneSize(laneKey: string): number {
-  return getSharedChatQueueStore().getLaneSize(laneKey);
-}
-
-/**
- * 清空共享 queue 某个 lane。
- */
-export function clearChatQueueLane(laneKey: string): void {
-  getSharedChatQueueStore().clear(laneKey);
-}

package/src/chat/runtime/ChatQueueStore.ts

@@ -3,8 +3,8 @@
  *
  * 关键点（中文）
  * - 这是 chat queue 的实例级状态容器。
- * - 允许 `ChatPlugin` 持有自己的 queue store，而不是完全依赖模块级全局状态。
- * - 旧的 `ChatQueue.ts` 会保留共享门面，逐步迁移到显式实例注入。
+ * - `ChatPlugin` 为每个 Workspace Context 持有独立 queue store。
+ * - 队列必须通过显式 Context 解析，不允许模块级共享状态。
  */
 
 import type { PluginContext } from "@downcity/agent";
@@ -53,13 +53,6 @@ export interface ChatQueueStorePort {
   clear(laneKey: string): void;
 }
 
-/**
- * 共享 queue store。
- *
- * 关键点（中文）
- * - 迁移阶段仍保留一份共享实例，避免一次性改动所有旧入口。
- * - 新代码应优先通过 `PluginContext.agent` 解析显式 queue store。
- */
 /**
  * Chat queue 实例级存储。
  */
@@ -158,28 +151,19 @@ export class ChatQueueStore implements ChatQueueStorePort {
   }
 }
 
-const sharedChatQueueStore = new ChatQueueStore();
-
-/**
- * 读取共享 chat queue store。
- */
-export function getSharedChatQueueStore(): ChatQueueStore {
-  return sharedChatQueueStore;
-}
-
 /**
  * 从运行时解析 chat queue store。
  *
  * 关键点（中文）
- * - 新路径优先读取当前 Agent 注册的 ChatPlugin 实例。
- * - 迁移阶段若拿不到，则回退到共享 queue store，保证旧入口可继续工作。
+ * - 只读取当前 Agent 注册的 ChatPlugin 实例。
+ * - 缺少 Context 或对应 Workspace runtime 时立即失败，避免跨 Agent/Workspace 串队列。
  */
-export function resolveChatQueueStore(context?: PluginContext): ChatQueueStorePort {
-  const chatService = context?.plugins.get("chat") as
-    | { queueStore?: ChatQueueStorePort }
+export function resolveChatQueueStore(context: PluginContext): ChatQueueStorePort {
+  const chatService = context.plugins.get("chat") as
+    | { queue_store?: (context: PluginContext) => ChatQueueStorePort }
     | undefined;
-  if (chatService?.queueStore) {
-    return chatService.queueStore;
+  if (!chatService?.queue_store) {
+    throw new Error("Chat queue requires an active ChatPlugin for the current Workspace");
   }
-  return sharedChatQueueStore;
+  return chatService.queue_store(context);
 }

package/src/chat/runtime/ChatQueueWorker.ts

@@ -13,9 +13,6 @@ import type { ChatQueueWorkerConfig } from "@/chat/types/ChatQueueWorker.js";
 import type { ChatQueueItem } from "@/chat/types/ChatQueue.js";
 import type { SessionMutation } from "@downcity/agent";
 import type { AgentSessionTurnResult } from "@downcity/agent";
-import {
-  getSharedChatQueueStore,
-} from "./ChatQueue.js";
 import { getChatSender } from "./ChatSendRegistry.js";
 import {
   buildChannelErrorText,
@@ -61,13 +58,13 @@ export class ChatQueueWorker {
   constructor(params: {
     logger: Logger;
     context: PluginContext;
-    queueStore?: ChatQueueStorePort;
+    queueStore: ChatQueueStorePort;
     config?: Partial<ChatQueueWorkerConfig>;
   }) {
     this.logger = params.logger;
     this.context = params.context;
     this.config = normalizeChatQueueWorkerConfig(params.config);
-    this.queueStore = params.queueStore || getSharedChatQueueStore();
+    this.queueStore = params.queueStore;
   }
 
   /**

package/src/chat/runtime/ChatSessionDelete.ts

@@ -2,9 +2,9 @@
  * ChatSessionDelete：按 session_id 彻底删除 chat 会话数据。
  *
  * 关键点（中文）
- * - 删除路由映射（`.downcity/channel/meta.json`）
- * - 删除 chat 审计目录（`.downcity/chat/<session_id>/`）
- * - 删除 core session 目录（`.downcity/agents/<agent_id>/sessions/<session_id>/`）
+ * - 删除路由映射（Agent private runtime directory 数据目录的 `channel/meta.json`）
+ * - 删除 chat 审计目录（Agent private runtime directory 数据目录的 `chat/<session_id>/`）
+ * - 删除 core session 目录（Agent private runtime directory 数据目录的 `sessions/<session_id>/`）
  * - 清理运行中 agent 与队列，避免残留任务继续执行
  */
 
@@ -52,7 +52,7 @@ export async function deleteChatSessionById(params: {
     resolveChatQueueStore(params.context).clear(session_id);
 
     const chat_result = await clean_chat_storage({
-      root_path: params.context.workspace_path,
+      data_path: params.context.data_path,
       session_id: session_id,
     });
     const removed_session_dir = await params.context.sessions.remove(session_id);