@downcity/plugins 1.0.215 → 1.0.233

package/src/contact/runtime/ChatRuntime.ts

@@ -6,29 +6,13 @@
  * - 远端收到 chat 后运行本地 agent session，并返回 assistant 文本。
  */
 
-import type { AgentContext } from "@downcity/agent";
+import type { PluginContext } from "@downcity/agent";
 import type { ContactChatResponse } from "@/contact/types/ContactChat.js";
-import type { SessionRecordV1 } from "@downcity/agent";
 import {
   appendContactMessage,
   findContactByInboundToken,
 } from "./ContactStore.js";
 
-function extractMessageText(message: SessionRecordV1 | null | undefined): string {
-  const parts = Array.isArray((message as { parts?: unknown } | null)?.parts)
-    ? ((message as { parts: unknown[] }).parts)
-    : [];
-  return parts
-    .map((part) => {
-      if (!part || typeof part !== "object") return "";
-      const item = part as { type?: unknown; text?: unknown };
-      return item.type === "text" ? String(item.text || "") : "";
-    })
-    .filter(Boolean)
-    .join("\n")
-    .trim();
-}
-
 /**
  * 处理远端 contact chat 消息。
  */
@@ -36,7 +20,7 @@ export async function receiveContactChatMessage(params: {
   /**
    * 当前 agent context。
    */
-  context: AgentContext;
+  context: PluginContext;
   /**
    * 入站 contact token。
    */
@@ -46,7 +30,7 @@ export async function receiveContactChatMessage(params: {
    */
   message: string;
 }): Promise<ContactChatResponse> {
-  const contact = await findContactByInboundToken(params.context.rootPath, params.token);
+  const contact = await findContactByInboundToken(params.context.workspace_path, params.token);
   if (!contact || contact.status !== "trusted") {
     return {
       success: false,
@@ -57,22 +41,22 @@ export async function receiveContactChatMessage(params: {
   }
 
   const now = Date.now();
-  await appendContactMessage(params.context.rootPath, contact.id, {
+  await appendContactMessage(params.context.workspace_path, contact.id, {
     role: "remote",
     text: params.message,
-    createdAt: now,
+    created_at: now,
   });
 
-  const sessionId = `contact_${contact.id}`;
-  const turn = await params.context.sessions.runtime(sessionId).prompt({
+  const session_id = `contact_${contact.id}`;
+  const turn = await params.context.sessions.runtime(session_id).prompt({
     query: params.message,
   });
   const result = await turn.finished;
-  const reply = extractMessageText(result.assistantMessage);
-  await appendContactMessage(params.context.rootPath, contact.id, {
+  const reply = result.text.trim();
+  await appendContactMessage(params.context.workspace_path, contact.id, {
     role: "local",
     text: reply,
-    createdAt: Date.now(),
+    created_at: Date.now(),
   });
 
   return {

package/src/contact/runtime/ContactStore.ts

@@ -110,7 +110,7 @@ function normalizeStoredContact(input: unknown): AgentContact | null {
     status: isContactStatus(item.status) ? item.status : "trusted",
     outboundToken,
     inboundTokenHash,
-    createdAt: normalizeOptionalTimestamp(item.createdAt) ?? 0,
+    created_at: normalizeOptionalTimestamp(item.created_at) ?? 0,
     ...(normalizeOptionalTimestamp(item.lastSeenAt) !== undefined
       ? { lastSeenAt: normalizeOptionalTimestamp(item.lastSeenAt) }
       : {}),
@@ -147,7 +147,7 @@ export function normalizeContactEndpoint(endpoint: string): string {
  * 保存 contact。
  */
 export async function saveContact(
-  projectRoot: string,
+  project_root: string,
   contact: AgentContact,
 ): Promise<AgentContact> {
   const normalized: AgentContact = {
@@ -159,7 +159,7 @@ export async function saveContact(
     status: contact.status || "trusted",
     outboundToken: contact.outboundToken || null,
     inboundTokenHash: contact.inboundTokenHash || null,
-    createdAt: contact.createdAt || Date.now(),
+    created_at: contact.created_at || Date.now(),
   };
   if (!normalized.name) throw new Error("contact name is required");
   if (normalized.reachability !== "inbound" && !normalized.endpoint) {
@@ -171,11 +171,11 @@ export async function saveContact(
   if (normalized.reachability !== "outbound" && !normalized.inboundTokenHash) {
     throw new Error("contact inbound token hash is required for inbound contacts");
   }
-  await fs.ensureDir(getContactDirectoryPath(projectRoot, normalized.id));
-  await fs.writeJson(getContactJsonPath(projectRoot, normalized.id), normalized, {
+  await fs.ensureDir(getContactDirectoryPath(project_root, normalized.id));
+  await fs.writeJson(getContactJsonPath(project_root, normalized.id), normalized, {
     spaces: 2,
   });
-  await fs.ensureFile(getContactMessagesPath(projectRoot, normalized.id));
+  await fs.ensureFile(getContactMessagesPath(project_root, normalized.id));
   return normalized;
 }
 
@@ -183,10 +183,10 @@ export async function saveContact(
  * 读取 contact。
  */
 export async function readContact(
-  projectRoot: string,
+  project_root: string,
   contactId: string,
 ): Promise<AgentContact | null> {
-  const filePath = getContactJsonPath(projectRoot, contactId);
+  const filePath = getContactJsonPath(project_root, contactId);
   if (!(await fs.pathExists(filePath))) return null;
   const raw = await fs.readJson(filePath).catch(() => null);
   // 关键点（中文）：读取时归一化可恢复字段，避免一次局部写入让已收到的 contact 在列表中消失。
@@ -196,14 +196,14 @@ export async function readContact(
 /**
  * 列出全部 contact。
  */
-export async function listContacts(projectRoot: string): Promise<AgentContact[]> {
-  const root = getContactsRootPath(projectRoot);
+export async function listContacts(project_root: string): Promise<AgentContact[]> {
+  const root = getContactsRootPath(project_root);
   if (!(await fs.pathExists(root))) return [];
   const entries = await fs.readdir(root, { withFileTypes: true });
   const contacts: AgentContact[] = [];
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
-    const contact = await readContact(projectRoot, entry.name);
+    const contact = await readContact(project_root, entry.name);
     if (contact) contacts.push(contact);
   }
   return contacts.sort((a, b) => a.name.localeCompare(b.name));
@@ -213,12 +213,12 @@ export async function listContacts(projectRoot: string): Promise<AgentContact[]>
  * 按 id/name 查找 contact。
  */
 export async function findContact(
-  projectRoot: string,
+  project_root: string,
   query: string,
 ): Promise<AgentContact | null> {
   const value = String(query || "").trim();
   if (!value) return null;
-  const contacts = await listContacts(projectRoot);
+  const contacts = await listContacts(project_root);
   const lower = value.toLowerCase();
   return (
     contacts.find((item) => item.id.toLowerCase() === lower) ||
@@ -232,25 +232,25 @@ export async function findContact(
  * 根据入站 token 查找 contact。
  */
 export async function findContactByInboundToken(
-  projectRoot: string,
+  project_root: string,
   token: string,
 ): Promise<AgentContact | null> {
-  const tokenHash = hashContactToken(token);
-  const contacts = await listContacts(projectRoot);
-  return contacts.find((item) => item.inboundTokenHash === tokenHash) || null;
+  const token_hash = hashContactToken(token);
+  const contacts = await listContacts(project_root);
+  return contacts.find((item) => item.inboundTokenHash === token_hash) || null;
 }
 
 /**
  * 更新 contact 最近在线时间。
  */
 export async function touchContactSeen(
-  projectRoot: string,
+  project_root: string,
   contactId: string,
   seenAt: number = Date.now(),
 ): Promise<AgentContact | null> {
-  const contact = await readContact(projectRoot, contactId);
+  const contact = await readContact(project_root, contactId);
   if (!contact) return null;
-  return await saveContact(projectRoot, {
+  return await saveContact(project_root, {
     ...contact,
     lastSeenAt: seenAt,
   });
@@ -260,11 +260,11 @@ export async function touchContactSeen(
  * 追加 contact chat 消息。
  */
 export async function appendContactMessage(
-  projectRoot: string,
+  project_root: string,
   contactId: string,
   message: ContactChatMessage,
 ): Promise<void> {
-  const filePath = getContactMessagesPath(projectRoot, contactId);
+  const filePath = getContactMessagesPath(project_root, contactId);
   await fs.ensureDir(path.dirname(filePath));
   await fs.appendFile(filePath, `${JSON.stringify(message)}\n`, "utf-8");
 }
@@ -273,10 +273,10 @@ export async function appendContactMessage(
  * 读取 contact chat 历史。
  */
 export async function readContactMessages(
-  projectRoot: string,
+  project_root: string,
   contactId: string,
 ): Promise<ContactChatMessage[]> {
-  const filePath = getContactMessagesPath(projectRoot, contactId);
+  const filePath = getContactMessagesPath(project_root, contactId);
   if (!(await fs.pathExists(filePath))) return [];
   const text = await fs.readFile(filePath, "utf-8");
   const out: ContactChatMessage[] = [];

package/src/contact/runtime/InboxStore.ts

@@ -52,11 +52,11 @@ function isMeta(input: unknown): input is ContactInboxShareMeta {
  * 保存 inbox share。
  */
 export async function saveContactInboxShare(
-  projectRoot: string,
+  project_root: string,
   input: SaveContactInboxShareInput,
 ): Promise<ContactInboxShareMeta> {
-  const inboxRoot = getContactInboxRootPath(projectRoot);
-  const sharePath = getContactInboxSharePath(projectRoot, input.meta.id);
+  const inboxRoot = getContactInboxRootPath(project_root);
+  const sharePath = getContactInboxSharePath(project_root, input.meta.id);
   const tempRoot = path.join(path.dirname(inboxRoot), ".inbox-tmp");
   const tempPath = path.join(
     tempRoot,
@@ -103,10 +103,10 @@ export async function saveContactInboxShare(
  * 读取 inbox share meta。
  */
 export async function readContactInboxShareMeta(
-  projectRoot: string,
+  project_root: string,
   shareId: string,
 ): Promise<ContactInboxShareMeta | null> {
-  const filePath = getContactInboxShareMetaPath(projectRoot, shareId);
+  const filePath = getContactInboxShareMetaPath(project_root, shareId);
   if (!(await fs.pathExists(filePath))) return null;
   const raw = await fs.readJson(filePath).catch(() => null);
   return isMeta(raw) ? raw : null;
@@ -116,10 +116,10 @@ export async function readContactInboxShareMeta(
  * 读取 inbox share payload。
  */
 export async function readContactInboxSharePayload(
-  projectRoot: string,
+  project_root: string,
   shareId: string,
 ): Promise<ContactInboxSharePayload | null> {
-  const filePath = getContactInboxSharePayloadPath(projectRoot, shareId);
+  const filePath = getContactInboxSharePayloadPath(project_root, shareId);
   if (!(await fs.pathExists(filePath))) return null;
   const raw = await fs.readJson(filePath).catch(() => null);
   if (!raw || typeof raw !== "object" || Array.isArray(raw)) return null;
@@ -131,15 +131,15 @@ export async function readContactInboxSharePayload(
  * 列出 inbox share。
  */
 export async function listContactInboxShares(
-  projectRoot: string,
+  project_root: string,
 ): Promise<ContactInboxShareMeta[]> {
-  const root = getContactInboxRootPath(projectRoot);
+  const root = getContactInboxRootPath(project_root);
   if (!(await fs.pathExists(root))) return [];
   const entries = await fs.readdir(root, { withFileTypes: true });
   const shares: ContactInboxShareMeta[] = [];
   for (const entry of entries) {
     if (!entry.isDirectory()) continue;
-    const meta = await readContactInboxShareMeta(projectRoot, entry.name);
+    const meta = await readContactInboxShareMeta(project_root, entry.name);
     if (meta) shares.push(meta);
   }
   return shares.sort((a, b) => b.receivedAt - a.receivedAt);
@@ -149,22 +149,22 @@ export async function listContactInboxShares(
  * 标记 share 已接收，并复制轻量状态到 received。
  */
 export async function markContactInboxShareReceived(
-  projectRoot: string,
+  project_root: string,
   shareId: string,
 ): Promise<ContactInboxShareMeta> {
-  const meta = await readContactInboxShareMeta(projectRoot, shareId);
+  const meta = await readContactInboxShareMeta(project_root, shareId);
   if (!meta) throw new Error(`Share not found: ${shareId}`);
   const next: ContactInboxShareMeta = {
     ...meta,
     status: "received",
   };
-  const receivedPath = getContactReceivedSharePath(projectRoot, shareId);
+  const receivedPath = getContactReceivedSharePath(project_root, shareId);
   await fs.ensureDir(receivedPath);
   await fs.writeJson(path.join(receivedPath, "meta.json"), next, {
     spaces: 2,
   });
   // received 区先完整写入，最后再更新 inbox meta，避免列表状态提前变成 received。
-  await fs.writeJson(getContactInboxShareMetaPath(projectRoot, shareId), next, {
+  await fs.writeJson(getContactInboxShareMetaPath(project_root, shareId), next, {
     spaces: 2,
   });
   return next;
@@ -173,6 +173,6 @@ export async function markContactInboxShareReceived(
 /**
  * 读取 share 文件根目录。
  */
-export function getInboxShareFilesRoot(projectRoot: string, shareId: string): string {
-  return getContactInboxShareFilesPath(projectRoot, shareId);
+export function getInboxShareFilesRoot(project_root: string, shareId: string): string {
+  return getContactInboxShareFilesPath(project_root, shareId);
 }

package/src/contact/runtime/LinkApproval.ts

@@ -99,31 +99,31 @@ function readCallbackCandidate(
 }
 
 async function findApprovedContact(params: {
-  projectRoot: string;
+  project_root: string;
   agentName: string;
 }) {
   const stable = await readContact(
-    params.projectRoot,
+    params.project_root,
     createStableContactId(params.agentName),
   );
   if (stable) return stable;
-  const contacts = await listContacts(params.projectRoot);
+  const contacts = await listContacts(params.project_root);
   const lower = params.agentName.trim().toLowerCase();
   return contacts.find((item) => item.name.toLowerCase() === lower) || null;
 }
 
 async function saveApprovedInboundContact(params: {
-  projectRoot: string;
+  project_root: string;
   agentName: string;
   tokenForOwner: string;
   nowMs: number;
 }) {
   const existing = await findApprovedContact({
-    projectRoot: params.projectRoot,
+    project_root: params.project_root,
     agentName: params.agentName,
   });
   const hasOutboundSide = Boolean(existing?.endpoint && existing?.outboundToken);
-  await saveContact(params.projectRoot, {
+  await saveContact(params.project_root, {
     id: existing?.id || createStableContactId(params.agentName),
     name: existing?.name || params.agentName,
     endpoint: existing?.endpoint || null,
@@ -131,7 +131,7 @@ async function saveApprovedInboundContact(params: {
     status: "trusted",
     outboundToken: existing?.outboundToken || null,
     inboundTokenHash: hashContactToken(params.tokenForOwner),
-    createdAt: existing?.createdAt || params.nowMs,
+    created_at: existing?.created_at || params.nowMs,
     lastSeenAt: params.nowMs,
   });
 }
@@ -143,7 +143,7 @@ export async function approveContactLinkRequest(
   input: ApproveContactLinkRequestInput,
 ): Promise<ContactApproveLinkResponse> {
   const nowMs = input.nowMs ?? Date.now();
-  const link = await readContactLinkRecord(input.projectRoot, input.request.linkId);
+  const link = await readContactLinkRecord(input.project_root, input.request.linkId);
   if (!link) {
     return failure({
       ownerAgentName: input.ownerAgentName,
@@ -151,7 +151,7 @@ export async function approveContactLinkRequest(
       error: CONTACT_LINK_NOT_FOUND_ERROR,
     });
   }
-  if (link.expiresAt <= nowMs) {
+  if (link.expires_at <= nowMs) {
     return failure({
       ownerAgentName: input.ownerAgentName,
       endpoint: link.endpoint,
@@ -185,10 +185,10 @@ export async function approveContactLinkRequest(
           tokenForRequester: callbackCandidate.token,
           callbackReason: input.request.callbackReason || link.callbackReason || null,
         };
-        await saveContactLinkRecord(input.projectRoot, nextLink);
+        await saveContactLinkRecord(input.project_root, nextLink);
       }
       await saveApprovedInboundContact({
-        projectRoot: input.projectRoot,
+        project_root: input.project_root,
         agentName: input.request.agentName,
         tokenForOwner: link.tokenForOwner,
         nowMs,
@@ -219,9 +219,9 @@ export async function approveContactLinkRequest(
   };
 
   // 先消费 link，再派生 contact；重试时以 link 记录为来源修复 contact，避免孤儿 trusted contact。
-  await saveContactLinkRecord(input.projectRoot, approvedLink);
+  await saveContactLinkRecord(input.project_root, approvedLink);
   await saveApprovedInboundContact({
-    projectRoot: input.projectRoot,
+    project_root: input.project_root,
     agentName: input.request.agentName,
     tokenForOwner,
     nowMs,
@@ -242,14 +242,14 @@ export async function confirmContactLinkRequest(
   input: ConfirmContactLinkRequestInput,
 ): Promise<ContactConfirmResponse> {
   const nowMs = input.nowMs ?? Date.now();
-  const link = await readContactLinkRecord(input.projectRoot, input.request.linkId);
+  const link = await readContactLinkRecord(input.project_root, input.request.linkId);
   if (!link) {
     return confirmFailure({
       ownerAgentName: input.ownerAgentName,
       error: CONTACT_LINK_NOT_FOUND_ERROR,
     });
   }
-  if (!link.usedAt && link.expiresAt <= nowMs) {
+  if (!link.usedAt && link.expires_at <= nowMs) {
     return confirmFailure({
       ownerAgentName: input.ownerAgentName,
       error: "Contact link expired",
@@ -309,7 +309,7 @@ export async function confirmContactLinkRequest(
     });
   }
   const contact = await findApprovedContact({
-    projectRoot: input.projectRoot,
+    project_root: input.project_root,
     agentName: input.request.agentName,
   });
   if (!contact || contact.status !== "trusted") {
@@ -332,7 +332,7 @@ export async function confirmContactLinkRequest(
   ) {
     if (!link.confirmedAt) {
       // contact 已经完成双向升级时，重试 confirm 需要补齐 link 状态，避免最终状态分裂。
-      await saveContactLinkRecord(input.projectRoot, {
+      await saveContactLinkRecord(input.project_root, {
         ...link,
         approvedEndpoint: endpoint,
         tokenForRequester: token,
@@ -363,7 +363,7 @@ export async function confirmContactLinkRequest(
     };
   }
 
-  await saveContact(input.projectRoot, {
+  await saveContact(input.project_root, {
     ...contact,
     endpoint,
     reachability: "bidirectional",
@@ -371,7 +371,7 @@ export async function confirmContactLinkRequest(
     inboundTokenHash: contact.inboundTokenHash,
     lastSeenAt: nowMs,
   });
-  await saveContactLinkRecord(input.projectRoot, {
+  await saveContactLinkRecord(input.project_root, {
     ...link,
     approvedEndpoint: endpoint,
     tokenForRequester: token,

package/src/contact/runtime/LinkCode.ts

@@ -22,12 +22,12 @@ function decodeJson(input: string): ContactLinkCodePayload {
   const agentName = String(parsed.agentName || "").trim();
   const endpoint = String(parsed.endpoint || "").trim();
   const secret = String(parsed.secret || "").trim();
-  const createdAt = Number(parsed.createdAt);
-  const expiresAt = Number(parsed.expiresAt);
+  const created_at = Number(parsed.created_at);
+  const expires_at = Number(parsed.expires_at);
   if (!linkId || !agentName || !endpoint || !secret) {
     throw new Error("Invalid contact link code");
   }
-  if (!Number.isFinite(createdAt) || !Number.isFinite(expiresAt)) {
+  if (!Number.isFinite(created_at) || !Number.isFinite(expires_at)) {
     throw new Error("Invalid contact link timestamps");
   }
   return {
@@ -36,8 +36,8 @@ function decodeJson(input: string): ContactLinkCodePayload {
     agentName,
     endpoint,
     secret,
-    createdAt,
-    expiresAt,
+    created_at,
+    expires_at,
   };
 }
 
@@ -63,8 +63,8 @@ export function parseContactLinkCode(code: string): ContactLinkCodePayload {
  * 判断 link code 是否过期。
  */
 export function isContactLinkExpired(
-  payload: Pick<ContactLinkCodePayload, "expiresAt">,
+  payload: Pick<ContactLinkCodePayload, "expires_at">,
   nowMs: number = Date.now(),
 ): boolean {
-  return Number(payload.expiresAt) <= nowMs;
+  return Number(payload.expires_at) <= nowMs;
 }

package/src/contact/runtime/LinkStore.ts

@@ -18,8 +18,8 @@ function isLinkRecord(input: unknown): input is ContactLinkRecord {
       typeof item.agentName === "string" &&
       typeof item.endpoint === "string" &&
       typeof item.secretHash === "string" &&
-      typeof item.createdAt === "number" &&
-      typeof item.expiresAt === "number",
+      typeof item.created_at === "number" &&
+      typeof item.expires_at === "number",
   );
 }
 
@@ -27,11 +27,11 @@ function isLinkRecord(input: unknown): input is ContactLinkRecord {
  * 保存 link 记录。
  */
 export async function saveContactLinkRecord(
-  projectRoot: string,
+  project_root: string,
   record: ContactLinkRecord,
 ): Promise<void> {
-  await fs.ensureDir(getContactLinksRootPath(projectRoot));
-  await fs.writeJson(getContactLinkPath(projectRoot, record.id), record, {
+  await fs.ensureDir(getContactLinksRootPath(project_root));
+  await fs.writeJson(getContactLinkPath(project_root, record.id), record, {
     spaces: 2,
   });
 }
@@ -40,10 +40,10 @@ export async function saveContactLinkRecord(
  * 读取 link 记录。
  */
 export async function readContactLinkRecord(
-  projectRoot: string,
+  project_root: string,
   linkId: string,
 ): Promise<ContactLinkRecord | null> {
-  const filePath = getContactLinkPath(projectRoot, linkId);
+  const filePath = getContactLinkPath(project_root, linkId);
   if (!(await fs.pathExists(filePath))) return null;
   const raw = await fs.readJson(filePath).catch(() => null);
   return isLinkRecord(raw) ? raw : null;