@downcity/plugins 1.0.254 → 1.0.280

package/src/chat/runtime/ChatStorage.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - Chat Plugin 是 channel meta、chat history 与渠道缓存路径的唯一所有者。
- * - PluginContext 只提供项目根目录，不暴露任何 Chat 领域路径。
+ * - PluginContext 提供 Agent 数据根，Chat 不再写入项目目录。
  * - CLI 离线维护通过本模块操作 Chat 存储，不复制内部 JSON 结构。
  */
 
@@ -28,27 +28,27 @@ function normalize_thread_id(input: unknown): number | undefined {
   return Math.trunc(value);
 }
 
-function get_downcity_path(root_path: string): string {
-  return path.join(root_path, ".downcity");
+function get_chat_data_path(data_path: string): string {
+  return path.resolve(data_path);
 }
 
 /** 返回 Chat 渠道路由目录。 */
-export function get_chat_channel_dir_path(root_path: string): string {
-  return path.join(get_downcity_path(root_path), "channel");
+export function get_chat_channel_dir_path(data_path: string): string {
+  return path.join(get_chat_data_path(data_path), "channel");
 }
 
 /** 返回 Chat 渠道路由文件。 */
-export function get_chat_channel_meta_path(root_path: string): string {
-  return path.join(get_chat_channel_dir_path(root_path), "meta.json");
+export function get_chat_channel_meta_path(data_path: string): string {
+  return path.join(get_chat_channel_dir_path(data_path), "meta.json");
 }
 
 /** 返回单个 Chat 会话的事件目录。 */
 export function get_chat_session_dir_path(
-  root_path: string,
+  data_path: string,
   session_id: string,
 ): string {
   return path.join(
-    get_downcity_path(root_path),
+    get_chat_data_path(data_path),
     "chat",
     encodeURIComponent(normalize_text(session_id)),
   );
@@ -56,21 +56,21 @@ export function get_chat_session_dir_path(
 
 /** 返回单个 Chat 会话的事件流文件。 */
 export function get_chat_history_path(
-  root_path: string,
+  data_path: string,
   session_id: string,
 ): string {
-  return path.join(get_chat_session_dir_path(root_path, session_id), "history.jsonl");
+  return path.join(get_chat_session_dir_path(data_path, session_id), "history.jsonl");
 }
 
 /** 返回飞书渠道的消息去重目录。 */
-export function get_feishu_dedupe_dir_path(root_path: string): string {
-  return path.join(get_downcity_path(root_path), ".cache", "feishu", "dedupe");
+export function get_feishu_dedupe_dir_path(data_path: string): string {
+  return path.join(get_chat_data_path(data_path), ".cache", "feishu", "dedupe");
 }
 
 async function read_channel_meta(
-  root_path: string,
+  data_path: string,
 ): Promise<Partial<ChannelContextMetaFileV1>> {
-  const raw = await fs.readJson(get_chat_channel_meta_path(root_path)).catch(() => null);
+  const raw = await fs.readJson(get_chat_channel_meta_path(data_path)).catch(() => null);
   return raw && typeof raw === "object"
     ? raw as Partial<ChannelContextMetaFileV1>
     : {};
@@ -124,7 +124,7 @@ function resolve_session_id(
 }
 
 async function remove_route(
-  root_path: string,
+  data_path: string,
   meta: Partial<ChannelContextMetaFileV1>,
   session_id: string,
 ): Promise<boolean> {
@@ -143,9 +143,9 @@ async function remove_route(
     removed = true;
   }
   if (!removed) return false;
-  await fs.ensureDir(get_chat_channel_dir_path(root_path));
+  await fs.ensureDir(get_chat_channel_dir_path(data_path));
   await fs.writeJson(
-    get_chat_channel_meta_path(root_path),
+    get_chat_channel_meta_path(data_path),
     {
       ...meta,
       v: 1,
@@ -162,10 +162,10 @@ async function remove_route(
  * 清空单个 Chat 会话的事件历史。
  */
 export async function clear_chat_history(
-  root_path: string,
+  data_path: string,
   session_id: string,
 ): Promise<boolean> {
-  const history_path = get_chat_history_path(root_path, session_id);
+  const history_path = get_chat_history_path(data_path, session_id);
   const existed = await fs.pathExists(history_path);
   if (existed) await fs.remove(history_path);
   return existed;
@@ -181,8 +181,8 @@ export async function clear_chat_history(
 export async function clean_chat_storage(
   input: ChatStorageCleanInput,
 ): Promise<ChatStorageCleanResult> {
-  const root_path = path.resolve(normalize_text(input.root_path) || ".");
-  const meta = await read_channel_meta(root_path);
+  const data_path = path.resolve(normalize_text(input.data_path) || ".");
+  const meta = await read_channel_meta(data_path);
   const session_id = resolve_session_id(meta, input);
   if (!session_id) {
     return {
@@ -191,10 +191,10 @@ export async function clean_chat_storage(
       removed_route: false,
     };
   }
-  const chat_dir_path = get_chat_session_dir_path(root_path, session_id);
+  const chat_dir_path = get_chat_session_dir_path(data_path, session_id);
   const removed_chat_dir = await fs.pathExists(chat_dir_path);
   if (removed_chat_dir) await fs.remove(chat_dir_path);
-  const removed_route = await remove_route(root_path, meta, session_id);
+  const removed_route = await remove_route(data_path, meta, session_id);
   return {
     session_id,
     removed_chat_dir,

package/src/chat/types/ChatAccess.ts

@@ -208,8 +208,8 @@ export interface RevokeChatAccessGrantInput {
 
 /** ChatAccessService 构造参数。 */
 export interface ChatAccessServiceOptions {
-  /** 当前 Agent 项目根目录。 */
-  project_root: string;
+  /** 当前 Agent private runtime directory 私有数据根目录。 */
+  data_path: string;
 }
 
 /** 直接设置 Principal Grant 的输入。 */

package/src/chat/types/ChatCommand.ts

@@ -76,7 +76,7 @@ export type ChatHistoryRequest = {
  * Chat 会话列表请求。
  *
  * 关键点（中文）
- * - 仅列出当前 agent 本地已记录的 chat context（来自 `.downcity/channel/meta.json`）。
+ * - 仅列出当前 Agent private runtime directory 已记录的 chat context（来自其数据目录的 `channel/meta.json`）。
  * - 不会向外部平台拉取“全部会话”，因为平台侧通常需要额外权限且成本高。
  */
 export type ChatListRequest = {

package/src/chat/types/ChatPluginChannelConfig.ts

@@ -0,0 +1,63 @@
+/** Chat Plugin profile 中的渠道配置类型。 */
+
+/** Telegram Bot 渠道配置。 */
+export interface TelegramPluginChannelConfig {
+  /** profile 内稳定渠道 ID。 */
+  id: string;
+  /** 渠道判别字段。 */
+  type: "telegram";
+  /** 用户可见渠道名称。 */
+  name: string;
+  /** Telegram Bot API Token。 */
+  bot_token: string;
+  /** 可选 Telegram username。 */
+  username?: string;
+  /** 可选 Telegram Bot 用户 ID。 */
+  bot_user_id?: string;
+}
+
+/** Feishu / Lark Bot 渠道配置。 */
+export interface FeishuPluginChannelConfig {
+  /** profile 内稳定渠道 ID。 */
+  id: string;
+  /** 渠道判别字段。 */
+  type: "feishu";
+  /** 用户可见渠道名称。 */
+  name: string;
+  /** Feishu / Lark App ID。 */
+  app_id: string;
+  /** Feishu / Lark App Secret。 */
+  app_secret: string;
+  /** 可选 Open API Domain。 */
+  domain?: string;
+  /** 可选 Bot 身份。 */
+  identity?: string;
+  /** 可选 Bot 用户 ID。 */
+  bot_user_id?: string;
+}
+
+/** QQ Bot 渠道配置。 */
+export interface QqPluginChannelConfig {
+  /** profile 内稳定渠道 ID。 */
+  id: string;
+  /** 渠道判别字段。 */
+  type: "qq";
+  /** 用户可见渠道名称。 */
+  name: string;
+  /** QQ Bot App ID。 */
+  app_id: string;
+  /** QQ Bot App Secret。 */
+  app_secret: string;
+  /** 是否使用 QQ 沙箱环境。 */
+  sandbox?: boolean;
+  /** 可选 Bot 身份。 */
+  identity?: string;
+  /** 可选 Bot 用户 ID。 */
+  bot_user_id?: string;
+}
+
+/** Chat Plugin profile 支持的完整渠道配置。 */
+export type ChatPluginChannelConfig =
+  | TelegramPluginChannelConfig
+  | FeishuPluginChannelConfig
+  | QqPluginChannelConfig;

package/src/chat/types/ChatPluginConfig.ts

@@ -0,0 +1,21 @@
+/** Chat Plugin 的完整 profile 类型。 */
+
+import type { ChatPluginChannelConfig } from "@/chat/types/ChatPluginChannelConfig.js";
+
+/** Chat 消息队列与合并策略。 */
+export interface ChatPluginQueueConfig {
+  /** 同时执行的最大 Chat lane 数。 */
+  max_concurrency?: number;
+  /** 合并连续入站消息的防抖窗口，单位为毫秒。 */
+  merge_debounce_ms?: number;
+  /** 入站消息等待合并的最长时间，单位为毫秒。 */
+  merge_max_wait_ms?: number;
+}
+
+/** Chat Plugin 的完整结构化 profile。 */
+export interface ChatPluginConfig {
+  /** 可选的消息队列与合并策略。 */
+  queue?: ChatPluginQueueConfig;
+  /** 当前 profile 拥有的消息渠道。 */
+  channels?: ChatPluginChannelConfig[];
+}

package/src/chat/types/ChatPluginOptions.ts

@@ -3,7 +3,7 @@
  *
  * 关键点（中文）
  * - ChatPlugin 只接收 queue 行为与 channels 列表。
- * - 每个 channel 对象自己负责 env / 凭据 / 账号池绑定解析。
+ * - 每个 channel 对象自己负责 env、凭据与运行账号解析。
  * - 这样 ChatPlugin 不再理解 Telegram、Feishu、QQ 的具体配置字段。
  */
 
@@ -25,9 +25,9 @@ export interface ChatChannel {
    */
   isEnabled(context: PluginContext): boolean;
   /**
-   * 当前 channel 来源 Resource 的稳定 ID。
+   * 当前 channel 的稳定 ID。
    */
-  getResourceId(context: PluginContext): string;
+  get_channel_id(context: PluginContext): string;
   /**
    * 解析当前 channel 的运行态账号。
    */
@@ -50,7 +50,7 @@ export interface ChatPluginOptions {
    * 当前 agent 持有的 chat channels。
    *
    * 说明（中文）
-   * - 每个 channel 对象自己负责 env、凭据与账号池绑定解析。
+   * - 每个 channel 对象自己负责 env、凭据与运行账号解析。
    * - 未传入时不启用任何 chat channel。
    */
   channels?: ChatChannel[];

package/src/chat/types/ChatPluginProfile.ts

@@ -0,0 +1,52 @@
+/** Chat Plugin Mainview 使用的 Profile 公开配置类型。 */
+
+/** Mainview 可见的 Chat 队列配置。 */
+export interface ChatPluginPublicQueueConfig {
+  /** 同时处理的最大 Chat 任务数量。 */
+  max_concurrency?: number;
+
+  /** 合并连续入站消息前等待的毫秒数。 */
+  merge_debounce_ms?: number;
+
+  /** 一组入站消息允许等待合并的最大毫秒数。 */
+  merge_max_wait_ms?: number;
+}
+
+/** Mainview 可见的单个 Chat Channel。 */
+export interface ChatPluginPublicChannelConfig {
+  /** Channel 在当前 Profile 内的稳定 ID。 */
+  id: string;
+
+  /** Channel 类型。 */
+  type: "telegram" | "feishu" | "qq";
+
+  /** 用户可见名称。 */
+  name: string;
+
+  /** Telegram Bot Token；读取时不返回已有值。 */
+  bot_token?: string;
+
+  /** 飞书或 QQ App ID。 */
+  app_id?: string;
+
+  /** 飞书或 QQ App Secret；读取时不返回已有值。 */
+  app_secret?: string;
+
+  /** 飞书 API Domain。 */
+  domain?: string;
+
+  /** QQ 是否使用沙箱环境。 */
+  sandbox?: boolean;
+
+  /** 当前 Channel 是否已经保存凭据。 */
+  secret_configured: boolean;
+}
+
+/** Mainview 可见的完整 Chat Profile。 */
+export interface ChatPluginPublicProfile {
+  /** Chat 队列行为。 */
+  queue: ChatPluginPublicQueueConfig;
+
+  /** 当前 Profile 拥有的全部 Channel。 */
+  channels: ChatPluginPublicChannelConfig[];
+}

package/src/chat/types/ChatPluginRenderer.ts

@@ -0,0 +1,25 @@
+/** Chat Plugin React Mainview 的内部组件属性类型。 */
+
+import type { PluginRendererUiComponents } from "@downcity/plugin/react";
+import type { ChatPluginPublicChannelConfig } from "./ChatPluginProfile.js";
+
+/** 单个 Chat Channel 编辑分组的属性。 */
+export interface ChatPluginChannelEditorProps {
+  /** 当前 Channel 草稿。 */
+  readonly channel: ChatPluginPublicChannelConfig;
+
+  /** 当前 Profile 中已经被其他 Channel 使用的类型。 */
+  readonly used_types: ReadonlySet<ChatPluginPublicChannelConfig["type"]>;
+
+  /** 当前 Mainview 使用的宿主 UI Components。 */
+  readonly components: Pick<
+    PluginRendererUiComponents,
+    "Button" | "Group" | "Input" | "Row" | "Select" | "Switch"
+  >;
+
+  /** 替换当前 Channel 草稿。 */
+  update(channel: ChatPluginPublicChannelConfig): void;
+
+  /** 删除当前 Channel 草稿。 */
+  remove(): void;
+}

package/src/chat/types/ChatRuntime.ts

@@ -9,6 +9,8 @@
 import type { FeishuBot } from "@/chat/channels/feishu/Feishu.js";
 import type { QQBot } from "@/chat/channels/qq/QQ.js";
 import type { TelegramBot } from "@/chat/channels/telegram/Bot.js";
+import type { ChatQueueWorker } from "@/chat/runtime/ChatQueueWorker.js";
+import type { ChatQueueStore } from "@/chat/runtime/ChatQueueStore.js";
 
 /**
  * `ChatPlugin` 实例持有的渠道状态。
@@ -31,3 +33,15 @@ export type ChatChannelState = {
    */
   qq: QQBot | null;
 };
+
+/** ChatPlugin 在单个 Workspace 中持有的全部长期运行态。 */
+export interface ChatWorkspaceRuntime {
+  /** 当前 Workspace 的渠道连接状态。 */
+  readonly channel_state: ChatChannelState;
+
+  /** 当前 Workspace 的消息队列存储。 */
+  readonly queue_store: ChatQueueStore;
+
+  /** 当前 Workspace 的消息队列消费 worker。 */
+  readonly queue_worker: ChatQueueWorker;
+}

package/src/chat/types/ChatRuntimeAccount.ts

@@ -3,15 +3,15 @@
  *
  * 关键点（中文）
  * - 该类型只用于 Channel Adapter 消费宿主已解析的构造参数。
- * - 它不表达存储、账号池或 Resource 查询能力。
- * - 生命周期字段用于现有状态与访问控制逻辑，不是 Plugin Resource 的持久化协议。
+ * - 它不表达存储、账号池或独立配置查询能力。
+ * - 生命周期字段仅用于现有状态与访问控制逻辑，不表达独立持久化领域。
  */
 
 import type { ChatChannelName } from "@/chat/types/ChannelStatus.js";
 
 /** 一个 Channel 启动所需的完整运行时账号快照。 */
 export interface ChatRuntimeAccount {
-  /** 来源 Resource 或 SDK 调用方提供的稳定 ID。 */
+  /** Plugin profile 或 SDK 调用方提供的稳定 Channel ID。 */
   id: string;
 
   /** 账号对应的 Chat Channel 类型。 */

package/src/chat/types/ChatStorage.ts

@@ -10,8 +10,8 @@
  * 清理单个 Chat 会话存储的输入。
  */
 export interface ChatStorageCleanInput {
-  /** 当前 Agent 项目根目录。 */
-  root_path: string;
+  /** 当前 Agent private runtime directory 内部数据根目录。 */
+  data_path: string;
   /** 已知的 Session 标识；提供时优先使用。 */
   session_id?: string;
   /** Chat 渠道名称；未提供 Session 标识时用于解析目标会话。 */

package/src/chat.ts

@@ -2,7 +2,7 @@
  * `@downcity/plugins/chat` 独立公开入口。
  *
  * 关键点（中文）
- * - 汇总 ChatPlugin、Resource Schema、运行渠道与 Chat Access 公开能力。
+ * - 汇总 ChatPlugin、运行渠道与 Chat Access 公开能力。
  * - 不加载其他内建 plugin 的入口模块。
  */
 
@@ -21,17 +21,6 @@ export {
 export { get_chat_access_db_path } from "./chat/access/ChatAccessStore.js";
 export { CHAT_ACCESS_ACTIONS } from "./chat/types/ChatAccess.js";
 export { clean_chat_storage } from "./chat/runtime/ChatStorage.js";
-export {
-  CHAT_PLUGIN_CONFIG_JSON_SCHEMA,
-  CHAT_PLUGIN_RESOURCE_JSON_SCHEMA,
-  chat_plugin_config_schema,
-  chat_plugin_resource_schema,
-  get_chat_plugin_resource_json_schema,
-  parse_chat_plugin_config,
-  parse_chat_plugin_resource,
-  resolve_chat_plugin_resource,
-} from "./chat/config/ChatPluginConfig.js";
-
 export type {
   ChatStorageCleanInput,
   ChatStorageCleanResult,
@@ -47,8 +36,11 @@ export type {
   ChatChannel,
   ChatPluginOptions,
 } from "./chat/types/ChatPluginOptions.js";
-export type { ChatPluginConfig } from "./chat/config/ChatPluginConfig.js";
-export type { ChatPluginResource } from "./chat/types/ChatPluginResource.js";
+export type {
+  ChatPluginConfig,
+  ChatPluginQueueConfig,
+} from "./chat/types/ChatPluginConfig.js";
+export type { ChatPluginChannelConfig } from "./chat/types/ChatPluginChannelConfig.js";
 export type {
   ApproveChatAccessRequestInput,
   ChatAccessDecision,

package/src/contact/Action.ts

@@ -130,7 +130,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         data: await handlers.link(
           params.context,
           params.input as ContactLinkCommandPayload,
-          params.execution_context,
+          params.execution.snapshot,
         ),
       }),
     }),
@@ -173,7 +173,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         data: await handlers.approve(
           params.context,
           params.input as unknown as ContactApproveCommandPayload,
-          params.execution_context,
+          params.execution.snapshot,
         ),
       }),
     }),
@@ -193,7 +193,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       execute: async (params) => ({
         success: true,
         data: {
-          contacts: await listContacts(params.context.workspace_path),
+          contacts: await listContacts(params.context.data_path),
         } as unknown as JsonValue,
       }),
     }),
@@ -354,7 +354,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       execute: async (params) => ({
         success: true,
         data: {
-          shares: await listContactInboxShares(params.context.workspace_path),
+          shares: await listContactInboxShares(params.context.data_path),
         } as unknown as JsonValue,
       }),
     }),
@@ -385,7 +385,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       execute: async (params) => ({
         success: true,
         data: (await receiveShare({
-          project_root: params.context.workspace_path,
+          data_path: params.context.data_path,
           shareId: (params.input as unknown as ContactReceiveCommandPayload).shareId,
         })) as unknown as JsonValue,
       }),

package/src/contact/ContactPlugin.ts

@@ -209,7 +209,7 @@ export class ContactPlugin extends BasePlugin {
     );
     const agentName = getAgentName(context);
 
-    await saveContactLinkRecord(context.workspace_path, {
+    await saveContactLinkRecord(context.data_path, {
       id: linkId,
       agentName,
       endpoint,
@@ -293,7 +293,7 @@ export class ContactPlugin extends BasePlugin {
     if (!response.success) throw new Error(response.error || "Contact approve failed");
 
     const name = String(payload.name || response.agentName || parsed.agentName).trim();
-    const contact = await saveContact(context.workspace_path, {
+    const contact = await saveContact(context.data_path, {
       id: createStableContactId(name),
       name,
       endpoint: response.endpoint || parsed.endpoint,
@@ -326,7 +326,7 @@ export class ContactPlugin extends BasePlugin {
       }
     }
     const finalContact = confirmed
-      ? await saveContact(context.workspace_path, {
+      ? await saveContact(context.data_path, {
           ...contact,
           reachability: "bidirectional",
           inboundTokenHash: tokenForRequester ? hashContactToken(tokenForRequester) : null,
@@ -356,7 +356,7 @@ export class ContactPlugin extends BasePlugin {
     const endpointInput = String(payload.endpoint || "").trim();
     const contact = endpointInput
       ? null
-      : await findContact(context.workspace_path, String(payload.target || "").trim());
+      : await findContact(context.data_path, String(payload.target || "").trim());
     const endpoint = endpointInput || contact?.endpoint || "";
     if (!endpoint) throw new Error("contact target or --to endpoint is required");
     if (contact && !contact.outboundToken) {
@@ -369,7 +369,7 @@ export class ContactPlugin extends BasePlugin {
         token: contact?.outboundToken || undefined,
       });
       if (contact && pong.success) {
-        await touchContactSeen(context.workspace_path, contact.id);
+        await touchContactSeen(context.data_path, contact.id);
       }
       return {
         target: contact?.name || endpoint,
@@ -392,17 +392,17 @@ export class ContactPlugin extends BasePlugin {
   }
 
   private async chat(context: PluginContext, payload: ContactChatCommandPayload) {
-    const contact = await findContact(context.workspace_path, payload.to);
+    const contact = await findContact(context.data_path, payload.to);
     if (!contact) throw new Error(`Contact not found: ${payload.to}`);
     const message = String(payload.message || "").trim();
     if (!message) {
       return {
         contact,
-        messages: await readContactMessages(context.workspace_path, contact.id),
+        messages: await readContactMessages(context.data_path, contact.id),
       };
     }
 
-    await appendContactMessage(context.workspace_path, contact.id, {
+    await appendContactMessage(context.data_path, contact.id, {
       role: "local",
       text: message,
       created_at: Date.now(),
@@ -418,7 +418,7 @@ export class ContactPlugin extends BasePlugin {
       } as unknown as JsonValue,
     });
     if (!response.success) throw new Error(response.error || "Contact chat failed");
-    await appendContactMessage(context.workspace_path, contact.id, {
+    await appendContactMessage(context.data_path, contact.id, {
       role: "remote",
       text: response.reply,
       created_at: Date.now(),
@@ -427,7 +427,7 @@ export class ContactPlugin extends BasePlugin {
   }
 
   private async share(context: PluginContext, payload: ContactShareCommandPayload) {
-    const contact = await findContact(context.workspace_path, payload.to);
+    const contact = await findContact(context.data_path, payload.to);
     if (!contact) throw new Error(`Contact not found: ${payload.to}`);
     const outbound = requireOutboundContact(contact);
     const share = await createShareInput({
@@ -466,7 +466,7 @@ export class ContactPlugin extends BasePlugin {
         plugin: "contact",
       };
     }
-    const contact = await findContactByInboundToken(context.workspace_path, token);
+    const contact = await findContactByInboundToken(context.data_path, token);
     return {
       success: true,
       agentName: getAgentName(context),
@@ -480,7 +480,7 @@ export class ContactPlugin extends BasePlugin {
     request: ContactApproveLinkRequest,
   ): Promise<ContactApproveLinkResponse> {
     return await approveContactLinkRequest({
-      project_root: context.workspace_path,
+      data_path: context.data_path,
       ownerAgentName: getAgentName(context),
       ownerEndpoint: await resolveSelfEndpoint(context, this.options),
       request,
@@ -492,7 +492,7 @@ export class ContactPlugin extends BasePlugin {
     request: ContactConfirmRequest,
   ): Promise<ContactConfirmResponse> {
     return await confirmContactLinkRequest({
-      project_root: context.workspace_path,
+      data_path: context.data_path,
       ownerAgentName: getAgentName(context),
       request,
       verifyCallback: async ({ endpoint, token }) => {
@@ -509,7 +509,7 @@ export class ContactPlugin extends BasePlugin {
     const payload = readContactObject(rawPayload);
     const token = readContactString(payload, "token");
     const body = readContactObject(payload.body);
-    const contact = await findContactByInboundToken(context.workspace_path, token);
+    const contact = await findContactByInboundToken(context.data_path, token);
     if (!contact || contact.status !== "trusted") {
       throw new Error("Invalid contact token");
     }
@@ -521,7 +521,7 @@ export class ContactPlugin extends BasePlugin {
       receivedAt: Date.now(),
       status: "pending" as const,
     };
-    await saveContactInboxShare(context.workspace_path, {
+    await saveContactInboxShare(context.data_path, {
       meta,
       payload: share.payload,
       files: Array.isArray(share.files) ? share.files : [],

package/src/contact/runtime/ChatRuntime.ts

@@ -30,7 +30,7 @@ export async function receiveContactChatMessage(params: {
    */
   message: string;
 }): Promise<ContactChatResponse> {
-  const contact = await findContactByInboundToken(params.context.workspace_path, params.token);
+  const contact = await findContactByInboundToken(params.context.data_path, params.token);
   if (!contact || contact.status !== "trusted") {
     return {
       success: false,
@@ -41,7 +41,7 @@ export async function receiveContactChatMessage(params: {
   }
 
   const now = Date.now();
-  await appendContactMessage(params.context.workspace_path, contact.id, {
+  await appendContactMessage(params.context.data_path, contact.id, {
     role: "remote",
     text: params.message,
     created_at: now,
@@ -53,7 +53,7 @@ export async function receiveContactChatMessage(params: {
   });
   const result = await turn.finished;
   const reply = result.text.trim();
-  await appendContactMessage(params.context.workspace_path, contact.id, {
+  await appendContactMessage(params.context.data_path, contact.id, {
     role: "local",
     text: reply,
     created_at: Date.now(),