@downcity/plugins 1.0.216 → 1.0.236

package/src/chat/types/FeishuInboundAttachment.ts

@@ -101,7 +101,7 @@ export interface FeishuIncomingAttachmentDescriptor {
    * 说明（中文）
    * - 会传给消息资源下载接口。
    */
-  resourceType: FeishuInboundResourceType;
+  resource_type: FeishuInboundResourceType;
 
   /**
    * 飞书消息资源 key。

package/src/chat/types/QqInboundDedupe.ts

@@ -6,7 +6,7 @@
  */
 export interface QqInboundDedupeSnapshotV1 {
   v: 1;
-  updatedAt: number;
+  updated_at: number;
   ids: string[];
 }
 

package/src/chat/types/ReplyContext.ts

@@ -18,7 +18,7 @@ export interface InboundReplyContext {
    * - 该值来自平台原始 reply 目标。
    * - 主要用于审计与调试，模型通常不会直接依赖它做推理。
    */
-  messageId?: string;
+  message_id?: string;
 
   /**
    * 被引用消息发送者的展示名。

package/src/chat.ts

@@ -2,7 +2,7 @@
  * `@downcity/plugins/chat` 独立公开入口。
  *
  * 关键点（中文）
- * - 汇总 ChatPlugin、运行渠道、账号管理与 Chat Access 公开能力。
+ * - 汇总 ChatPlugin、Resource Schema、运行渠道与 Chat Access 公开能力。
  * - 不加载其他内建 plugin 的入口模块。
  */
 
@@ -12,7 +12,6 @@ export {
   QqChannel,
   TelegramChannel,
 } from "./chat/channels/RuntimeChannel.js";
-export { ChatChannelAccountManager } from "./chat/accounts/ChannelAccountManager.js";
 export {
   ChatAccessService,
   is_chat_access_channel,
@@ -22,8 +21,17 @@ 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 { ChatChannelAccountListItem } from "./chat/types/ChannelAccount.js";
 export type {
   ChatStorageCleanInput,
   ChatStorageCleanResult,
@@ -39,6 +47,8 @@ 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 {
   ApproveChatAccessRequestInput,
   ChatAccessDecision,

package/src/contact/Action.ts

@@ -6,11 +6,11 @@
  * - 业务动作通过 handlers 注入，保持 `ContactPlugin` 类本身更薄。
  */
 
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { JsonObject, JsonValue } from "@downcity/agent";
 import type { PluginActions } from "@downcity/agent";
-import type { PluginRunContext } from "@downcity/agent";
-import { createAction } from "@downcity/agent";
+import type { PluginExecutionContext } from "@downcity/agent";
+import { create_action } from "@downcity/agent";
 import { z } from "zod";
 import type {
   ContactApproveCommandPayload,
@@ -46,55 +46,55 @@ export type ContactActionHandlers = {
    * 生成一次性联系码。
    */
   link: (
-    context: AgentContext,
+    context: PluginContext,
     payload: ContactLinkCommandPayload,
-    run_context?: PluginRunContext,
+    execution_context?: PluginExecutionContext,
   ) => Promise<JsonValue>;
   /**
    * 使用联系码建立 contact。
    */
   approve: (
-    context: AgentContext,
+    context: PluginContext,
     payload: ContactApproveCommandPayload,
-    run_context?: PluginRunContext,
+    execution_context?: PluginExecutionContext,
   ) => Promise<JsonValue>;
   /**
    * 检查 contact 或 endpoint 可用性。
    */
-  check: (context: AgentContext, payload: ContactCheckCommandPayload) => Promise<JsonValue>;
+  check: (context: PluginContext, payload: ContactCheckCommandPayload) => Promise<JsonValue>;
   /**
    * 与 contact 对话或读取对话历史。
    */
-  chat: (context: AgentContext, payload: ContactChatCommandPayload) => Promise<JsonValue>;
+  chat: (context: PluginContext, payload: ContactChatCommandPayload) => Promise<JsonValue>;
   /**
    * 向 contact 分享内容。
    */
-  share: (context: AgentContext, payload: ContactShareCommandPayload) => Promise<JsonValue>;
+  share: (context: PluginContext, payload: ContactShareCommandPayload) => Promise<JsonValue>;
   /**
    * 处理远端 ping 请求。
    */
   remotePing: (
-    context: AgentContext,
+    context: PluginContext,
     payload: { token?: string },
   ) => Promise<ContactPingResponse>;
   /**
    * 处理远端 approve 请求。
    */
   remoteApprove: (
-    context: AgentContext,
+    context: PluginContext,
     request: ContactApproveLinkRequest,
   ) => Promise<ContactApproveLinkResponse>;
   /**
    * 处理远端 confirm 请求。
    */
   remoteConfirm: (
-    context: AgentContext,
+    context: PluginContext,
     request: ContactConfirmRequest,
   ) => Promise<ContactConfirmResponse>;
   /**
    * 处理远端 share 请求。
    */
-  remoteShare: (context: AgentContext, rawPayload: JsonValue) => Promise<JsonValue>;
+  remoteShare: (context: PluginContext, rawPayload: JsonValue) => Promise<JsonValue>;
 };
 
 /**
@@ -102,7 +102,7 @@ export type ContactActionHandlers = {
  */
 export function createContactActions(handlers: ContactActionHandlers): PluginActions {
   return {
-    link: createAction({
+    link: create_action({
       description: "Create a one-time contact link code for another agent to approve.",
       input_schema: {
         zod: z.object({ ttlSeconds: z.number().optional() }),
@@ -119,7 +119,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         configure(command) {
           command.option("--ttl-seconds <seconds>", "Link expiration in seconds, defaulting to 600.", Number);
         },
-        mapInput({ opts }) {
+        map_input({ opts }) {
           const payload: JsonObject = {};
           if (typeof opts.ttlSeconds === "number") payload.ttlSeconds = opts.ttlSeconds;
           return payload;
@@ -130,11 +130,11 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         data: await handlers.link(
           params.context,
           params.input as ContactLinkCommandPayload,
-          params.run_context,
+          params.execution_context,
         ),
       }),
     }),
-    approve: createAction({
+    approve: create_action({
       description: "Use a contact link code to establish a peer-to-peer contact.",
       input_schema: {
         zod: z.object({
@@ -160,7 +160,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
             .argument("<code>")
             .option("--name <alias>", "Local contact alias.");
         },
-        mapInput({ args, opts }) {
+        map_input({ args, opts }) {
           const code = String(args[0] || "").trim();
           if (!code) throw new Error("Missing link code");
           const payload: JsonObject = { code };
@@ -173,11 +173,11 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         data: await handlers.approve(
           params.context,
           params.input as unknown as ContactApproveCommandPayload,
-          params.run_context,
+          params.execution_context,
         ),
       }),
     }),
-    list: createAction({
+    list: create_action({
       description: "List established contacts.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -186,18 +186,18 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       examples: [{ title: "List contacts", payload: {} }],
       command: {
         description: "List established contacts.",
-        mapInput() {
+        map_input() {
           return {};
         },
       },
       execute: async (params) => ({
         success: true,
         data: {
-          contacts: await listContacts(params.context.rootPath),
+          contacts: await listContacts(params.context.workspace_path),
         } as unknown as JsonValue,
       }),
     }),
-    check: createAction({
+    check: create_action({
       description: "Check whether a contact or endpoint is currently online and reachable.",
       input_schema: {
         zod: z.object({
@@ -223,7 +223,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
             .argument("[target]")
             .option("--to <endpoint>", "Directly check an unsaved endpoint.");
         },
-        mapInput({ args, opts }) {
+        map_input({ args, opts }) {
           const payload: JsonObject = {};
           const target = String(args[0] || "").trim();
           if (target) payload.target = target;
@@ -239,7 +239,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         ),
       }),
     }),
-    chat: createAction({
+    chat: create_action({
       description: "Chat with a contact in its long-lived conversation thread, or read conversation history.",
       input_schema: {
         zod: z.object({
@@ -264,7 +264,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         configure(command) {
           command.requiredOption("--to <contact>", "Target contact.").argument("[message...]");
         },
-        mapInput({ args, opts }) {
+        map_input({ args, opts }) {
           const payload: JsonObject = {
             to: String(opts.to || "").trim(),
           };
@@ -281,7 +281,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         ),
       }),
     }),
-    share: createAction({
+    share: create_action({
       description: "Share text, links, files, or directories with a contact.",
       input_schema: {
         zod: z.object({
@@ -316,7 +316,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
             .option("--link <url...>", "Links to share.")
             .argument("[paths...]");
         },
-        mapInput({ args, opts }) {
+        map_input({ args, opts }) {
           const links = Array.isArray(opts.link)
             ? opts.link.map((item) => String(item || "").trim()).filter(Boolean)
             : typeof opts.link === "string"
@@ -338,7 +338,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         ),
       }),
     }),
-    inbox: createAction({
+    inbox: create_action({
       description: "View the contact inbox.",
       input_schema: {
         zod: z.object({}).passthrough(),
@@ -347,18 +347,18 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       examples: [{ title: "View inbox", payload: {} }],
       command: {
         description: "View the contact inbox.",
-        mapInput() {
+        map_input() {
           return {};
         },
       },
       execute: async (params) => ({
         success: true,
         data: {
-          shares: await listContactInboxShares(params.context.rootPath),
+          shares: await listContactInboxShares(params.context.workspace_path),
         } as unknown as JsonValue,
       }),
     }),
-    receive: createAction({
+    receive: create_action({
       description: "Receive a share from the inbox.",
       input_schema: {
         zod: z.object({ shareId: z.string() }),
@@ -376,7 +376,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         configure(command) {
           command.argument("<shareId>");
         },
-        mapInput({ args }) {
+        map_input({ args }) {
           const shareId = String(args[0] || "").trim();
           if (!shareId) throw new Error("Missing shareId");
           return { shareId };
@@ -385,12 +385,12 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
       execute: async (params) => ({
         success: true,
         data: (await receiveShare({
-          projectRoot: params.context.rootPath,
+          project_root: params.context.workspace_path,
           shareId: (params.input as unknown as ContactReceiveCommandPayload).shareId,
         })) as unknown as JsonValue,
       }),
     }),
-    remoteping: createAction({
+    remoteping: create_action({
       description: "Handle a remote ping request (internal endpoint).",
       execute: async (params) => ({
         success: true,
@@ -400,7 +400,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         )) as unknown as JsonValue,
       }),
     }),
-    remoteapprove: createAction({
+    remoteapprove: create_action({
       description: "Handle a remote approve request (internal endpoint).",
       execute: async (params) => ({
         success: true,
@@ -410,7 +410,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         )) as unknown as JsonValue,
       }),
     }),
-    remoteconfirm: createAction({
+    remoteconfirm: create_action({
       description: "Handle a remote confirm request (internal endpoint).",
       execute: async (params) => ({
         success: true,
@@ -420,7 +420,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         )) as unknown as JsonValue,
       }),
     }),
-    remotechat: createAction({
+    remotechat: create_action({
       description: "Handle a remote chat request (internal endpoint).",
       execute: async (params) => {
         const payload = readContactObject(params.input);
@@ -435,7 +435,7 @@ export function createContactActions(handlers: ContactActionHandlers): PluginAct
         };
       },
     }),
-    remoteshare: createAction({
+    remoteshare: create_action({
       description: "Handle a remote share request (internal endpoint).",
       execute: async (params) => ({
         success: true,

package/src/contact/ContactPlugin.ts

@@ -7,8 +7,8 @@
  * - `share` 分享文本、链接、文件和目录，并进入对方 inbox。
  */
 
-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 { JsonValue } from "@downcity/agent";
 import type { PluginActions } from "@downcity/agent";
 import { BasePlugin } from "@downcity/agent";
@@ -82,7 +82,7 @@ import {
 } from "./runtime/ContactPayload.js";
 
 async function resolveSelfEndpoint(
-  context: AgentContext,
+  context: PluginContext,
   options: ContactPluginOptions,
   endpointOverride?: string,
   effective_env?: Readonly<Record<string, string>>,
@@ -91,7 +91,7 @@ async function resolveSelfEndpoint(
   if (explicit) return normalizeContactEndpoint(explicit);
   const env = {
     ...process.env,
-    ...context.env,
+    ...context.workspace_env,
     ...effective_env,
   };
   const runtimePort = Number(process.env.DC_CITY_PORT || env.DC_CITY_PORT || "");
@@ -110,12 +110,12 @@ async function resolveSelfEndpoint(
 }
 
 function hasRuntimePublicEndpointEnv(
-  context: AgentContext,
+  context: PluginContext,
   effective_env?: Readonly<Record<string, string>>,
 ): boolean {
   const env = {
     ...process.env,
-    ...context.env,
+    ...context.workspace_env,
     ...effective_env,
   };
   return Boolean(
@@ -124,7 +124,7 @@ function hasRuntimePublicEndpointEnv(
   );
 }
 
-function getAgentName(context: AgentContext): string {
+function getAgentName(context: PluginContext): string {
   return String(context.agent_id || "downcity-agent").trim() || "downcity-agent";
 }
 
@@ -164,10 +164,10 @@ export class ContactPlugin extends BasePlugin {
     super();
     this.options = options || {};
     this.actions = createContactActions({
-      link: async (context, payload, run_context) =>
-        (await this.link(context, payload, run_context)) as unknown as JsonValue,
-      approve: async (context, payload, run_context) =>
-        (await this.approve(context, payload, run_context)) as unknown as JsonValue,
+      link: async (context, payload, execution_context) =>
+        (await this.link(context, payload, execution_context)) as unknown as JsonValue,
+      approve: async (context, payload, execution_context) =>
+        (await this.approve(context, payload, execution_context)) as unknown as JsonValue,
       check: async (context, payload) =>
         (await this.check(context, payload)) as unknown as JsonValue,
       chat: async (context, payload) =>
@@ -190,9 +190,9 @@ export class ContactPlugin extends BasePlugin {
   }
 
   private async link(
-    context: AgentContext,
+    context: PluginContext,
     payload: ContactLinkCommandPayload,
-    run_context?: PluginRunContext,
+    execution_context?: PluginExecutionContext,
   ) {
     const now = Date.now();
     const ttlSeconds = Math.max(
@@ -205,17 +205,17 @@ export class ContactPlugin extends BasePlugin {
       context,
       this.options,
       payload.endpoint || this.options.endpoint,
-      run_context?.agentEnv,
+      execution_context?.workspace_env,
     );
     const agentName = getAgentName(context);
 
-    await saveContactLinkRecord(context.rootPath, {
+    await saveContactLinkRecord(context.workspace_path, {
       id: linkId,
       agentName,
       endpoint,
       secretHash: hashContactToken(secret),
-      createdAt: now,
-      expiresAt: now + ttlSeconds * 1000,
+      created_at: now,
+      expires_at: now + ttlSeconds * 1000,
       usedAt: null,
     });
 
@@ -225,8 +225,8 @@ export class ContactPlugin extends BasePlugin {
       agentName,
       endpoint,
       secret,
-      createdAt: now,
-      expiresAt: now + ttlSeconds * 1000,
+      created_at: now,
+      expires_at: now + ttlSeconds * 1000,
     });
     return {
       code,
@@ -235,14 +235,14 @@ export class ContactPlugin extends BasePlugin {
       endpoint,
       endpointReachability: classifyContactEndpoint(endpoint),
       notes: buildContactLinkNotes({ endpoint }),
-      expiresAt: now + ttlSeconds * 1000,
+      expires_at: now + ttlSeconds * 1000,
     };
   }
 
   private async approve(
-    context: AgentContext,
+    context: PluginContext,
     payload: ContactApproveCommandPayload,
-    run_context?: PluginRunContext,
+    execution_context?: PluginExecutionContext,
   ) {
     const parsed = parseContactLinkCode(payload.code);
     // 关键点（中文）：approve 端不使用本机时钟预判过期，避免两台机器时钟不一致时把本来可用的 link 提前拦截。
@@ -251,7 +251,7 @@ export class ContactPlugin extends BasePlugin {
     const targetReachability = classifyContactEndpoint(parsed.endpoint);
     const shouldResolveRequesterEndpoint =
       payload.endpoint ||
-      hasRuntimePublicEndpointEnv(context, run_context?.agentEnv) ||
+      hasRuntimePublicEndpointEnv(context, execution_context?.workspace_env) ||
       targetReachability === "loopback" ||
       targetReachability === "private";
     const requesterEndpointCandidate = shouldResolveRequesterEndpoint
@@ -259,7 +259,7 @@ export class ContactPlugin extends BasePlugin {
           context,
           this.options,
           payload.endpoint || this.options.endpoint,
-          run_context?.agentEnv,
+          execution_context?.workspace_env,
         )
       : undefined;
     const callbackDecision = buildContactApproveCallbackDecision({
@@ -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.rootPath, {
+    const contact = await saveContact(context.workspace_path, {
       id: createStableContactId(name),
       name,
       endpoint: response.endpoint || parsed.endpoint,
@@ -301,7 +301,7 @@ export class ContactPlugin extends BasePlugin {
       status: "trusted",
       outboundToken: response.tokenForOwner,
       inboundTokenHash: tokenForRequester ? hashContactToken(tokenForRequester) : null,
-      createdAt: Date.now(),
+      created_at: Date.now(),
       lastSeenAt: Date.now(),
     });
     let confirmed = false;
@@ -326,7 +326,7 @@ export class ContactPlugin extends BasePlugin {
       }
     }
     const finalContact = confirmed
-      ? await saveContact(context.rootPath, {
+      ? await saveContact(context.workspace_path, {
           ...contact,
           reachability: "bidirectional",
           inboundTokenHash: tokenForRequester ? hashContactToken(tokenForRequester) : null,
@@ -351,12 +351,12 @@ export class ContactPlugin extends BasePlugin {
     };
   }
 
-  private async check(context: AgentContext, payload: ContactCheckCommandPayload) {
+  private async check(context: PluginContext, payload: ContactCheckCommandPayload) {
     const startedAt = Date.now();
     const endpointInput = String(payload.endpoint || "").trim();
     const contact = endpointInput
       ? null
-      : await findContact(context.rootPath, String(payload.target || "").trim());
+      : await findContact(context.workspace_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.rootPath, contact.id);
+        await touchContactSeen(context.workspace_path, contact.id);
       }
       return {
         target: contact?.name || endpoint,
@@ -391,21 +391,21 @@ export class ContactPlugin extends BasePlugin {
     }
   }
 
-  private async chat(context: AgentContext, payload: ContactChatCommandPayload) {
-    const contact = await findContact(context.rootPath, payload.to);
+  private async chat(context: PluginContext, payload: ContactChatCommandPayload) {
+    const contact = await findContact(context.workspace_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.rootPath, contact.id),
+        messages: await readContactMessages(context.workspace_path, contact.id),
       };
     }
 
-    await appendContactMessage(context.rootPath, contact.id, {
+    await appendContactMessage(context.workspace_path, contact.id, {
       role: "local",
       text: message,
-      createdAt: Date.now(),
+      created_at: Date.now(),
     });
     const outbound = requireOutboundContact(contact);
     const response = await callContactChat<ContactChatResponse>({
@@ -414,20 +414,20 @@ export class ContactPlugin extends BasePlugin {
       body: {
         senderContactId: contact.id,
         message,
-        createdAt: Date.now(),
+        created_at: Date.now(),
       } as unknown as JsonValue,
     });
     if (!response.success) throw new Error(response.error || "Contact chat failed");
-    await appendContactMessage(context.rootPath, contact.id, {
+    await appendContactMessage(context.workspace_path, contact.id, {
       role: "remote",
       text: response.reply,
-      createdAt: Date.now(),
+      created_at: Date.now(),
     });
     return response;
   }
 
-  private async share(context: AgentContext, payload: ContactShareCommandPayload) {
-    const contact = await findContact(context.rootPath, payload.to);
+  private async share(context: PluginContext, payload: ContactShareCommandPayload) {
+    const contact = await findContact(context.workspace_path, payload.to);
     if (!contact) throw new Error(`Contact not found: ${payload.to}`);
     const outbound = requireOutboundContact(contact);
     const share = await createShareInput({
@@ -455,7 +455,7 @@ export class ContactPlugin extends BasePlugin {
   }
 
   private async remotePing(
-    context: AgentContext,
+    context: PluginContext,
     payload: { token?: string },
   ): Promise<ContactPingResponse> {
     const token = String(payload.token || "").trim();
@@ -466,7 +466,7 @@ export class ContactPlugin extends BasePlugin {
         plugin: "contact",
       };
     }
-    const contact = await findContactByInboundToken(context.rootPath, token);
+    const contact = await findContactByInboundToken(context.workspace_path, token);
     return {
       success: true,
       agentName: getAgentName(context),
@@ -476,11 +476,11 @@ export class ContactPlugin extends BasePlugin {
   }
 
   private async remoteApprove(
-    context: AgentContext,
+    context: PluginContext,
     request: ContactApproveLinkRequest,
   ): Promise<ContactApproveLinkResponse> {
     return await approveContactLinkRequest({
-      projectRoot: context.rootPath,
+      project_root: context.workspace_path,
       ownerAgentName: getAgentName(context),
       ownerEndpoint: await resolveSelfEndpoint(context, this.options),
       request,
@@ -488,11 +488,11 @@ export class ContactPlugin extends BasePlugin {
   }
 
   private async remoteConfirm(
-    context: AgentContext,
+    context: PluginContext,
     request: ContactConfirmRequest,
   ): Promise<ContactConfirmResponse> {
     return await confirmContactLinkRequest({
-      projectRoot: context.rootPath,
+      project_root: context.workspace_path,
       ownerAgentName: getAgentName(context),
       request,
       verifyCallback: async ({ endpoint, token }) => {
@@ -505,11 +505,11 @@ export class ContactPlugin extends BasePlugin {
     });
   }
 
-  private async remoteShare(context: AgentContext, rawPayload: JsonValue) {
+  private async remoteShare(context: PluginContext, rawPayload: JsonValue) {
     const payload = readContactObject(rawPayload);
     const token = readContactString(payload, "token");
     const body = readContactObject(payload.body);
-    const contact = await findContactByInboundToken(context.rootPath, token);
+    const contact = await findContactByInboundToken(context.workspace_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.rootPath, {
+    await saveContactInboxShare(context.workspace_path, {
       meta,
       payload: share.payload,
       files: Array.isArray(share.files) ? share.files : [],