@downcity/city 1.1.1 → 1.1.4

package/src/services/contact/runtime/LinkCode.ts

@@ -1,70 +0,0 @@
-/**
- * contact link code 编码。
- *
- * 关键点（中文）
- * - link code 是 `dc-link-v1.<base64url-json>`。
- * - 这里只负责编码/解析，不负责落盘状态校验。
- */
-
-import type { ContactLinkCodePayload } from "@/types/contact/ContactLink.js";
-
-const CONTACT_LINK_PREFIX = "dc-link-v1.";
-
-function encodeJson(input: ContactLinkCodePayload): string {
-  return Buffer.from(JSON.stringify(input), "utf-8").toString("base64url");
-}
-
-function decodeJson(input: string): ContactLinkCodePayload {
-  const text = Buffer.from(input, "base64url").toString("utf-8");
-  const parsed = JSON.parse(text) as Partial<ContactLinkCodePayload>;
-  if (parsed.version !== 1) throw new Error("Unsupported contact link version");
-  const linkId = String(parsed.linkId || "").trim();
-  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);
-  if (!linkId || !agentName || !endpoint || !secret) {
-    throw new Error("Invalid contact link code");
-  }
-  if (!Number.isFinite(createdAt) || !Number.isFinite(expiresAt)) {
-    throw new Error("Invalid contact link timestamps");
-  }
-  return {
-    version: 1,
-    linkId,
-    agentName,
-    endpoint,
-    secret,
-    createdAt,
-    expiresAt,
-  };
-}
-
-/**
- * 创建 contact link code。
- */
-export function createContactLinkCode(payload: ContactLinkCodePayload): string {
-  return `${CONTACT_LINK_PREFIX}${encodeJson(payload)}`;
-}
-
-/**
- * 解析 contact link code。
- */
-export function parseContactLinkCode(code: string): ContactLinkCodePayload {
-  const value = String(code || "").trim();
-  if (!value.startsWith(CONTACT_LINK_PREFIX)) {
-    throw new Error("Invalid contact link code prefix");
-  }
-  return decodeJson(value.slice(CONTACT_LINK_PREFIX.length));
-}
-
-/**
- * 判断 link code 是否过期。
- */
-export function isContactLinkExpired(
-  payload: Pick<ContactLinkCodePayload, "expiresAt">,
-  nowMs: number = Date.now(),
-): boolean {
-  return Number(payload.expiresAt) <= nowMs;
-}

package/src/services/contact/runtime/LinkStore.ts

@@ -1,50 +0,0 @@
-/**
- * contact link 本地状态存储。
- *
- * 关键点（中文）
- * - link code 明文只展示给用户；本地落盘只保存 secret hash。
- * - approve 成功后写入 usedAt 和恢复元数据，确保一次性语义并支持同一 agent 幂等重试。
- */
-
-import fs from "fs-extra";
-import type { ContactLinkRecord } from "@/types/contact/ContactLink.js";
-import { getContactLinkPath, getContactLinksRootPath } from "./Paths.js";
-
-function isLinkRecord(input: unknown): input is ContactLinkRecord {
-  const item = input as Partial<ContactLinkRecord> | null;
-  return Boolean(
-    item &&
-      typeof item.id === "string" &&
-      typeof item.agentName === "string" &&
-      typeof item.endpoint === "string" &&
-      typeof item.secretHash === "string" &&
-      typeof item.createdAt === "number" &&
-      typeof item.expiresAt === "number",
-  );
-}
-
-/**
- * 保存 link 记录。
- */
-export async function saveContactLinkRecord(
-  projectRoot: string,
-  record: ContactLinkRecord,
-): Promise<void> {
-  await fs.ensureDir(getContactLinksRootPath(projectRoot));
-  await fs.writeJson(getContactLinkPath(projectRoot, record.id), record, {
-    spaces: 2,
-  });
-}
-
-/**
- * 读取 link 记录。
- */
-export async function readContactLinkRecord(
-  projectRoot: string,
-  linkId: string,
-): Promise<ContactLinkRecord | null> {
-  const filePath = getContactLinkPath(projectRoot, linkId);
-  if (!(await fs.pathExists(filePath))) return null;
-  const raw = await fs.readJson(filePath).catch(() => null);
-  return isLinkRecord(raw) ? raw : null;
-}

package/src/services/contact/runtime/Paths.ts

@@ -1,139 +0,0 @@
-/**
- * contact service 路径规则。
- *
- * 关键点（中文）
- * - 所有 contact 运行时状态都收敛在 `.downcity/contact`。
- * - 每个 contact 一个目录；每条 inbox share 一个目录。
- */
-
-import path from "node:path";
-
-function cleanSegment(input: string, label: string): string {
-  const value = String(input || "").trim();
-  if (!/^[a-zA-Z0-9._-]+$/.test(value)) {
-    throw new Error(`Invalid ${label}: ${input}`);
-  }
-  if (value === "." || value === ".." || value.includes("..")) {
-    throw new Error(`Invalid ${label}: ${input}`);
-  }
-  return value;
-}
-
-/**
- * contact 根目录。
- */
-export function getContactRootPath(projectRoot: string): string {
-  return path.join(projectRoot, ".downcity", "contact");
-}
-
-/**
- * contacts 根目录。
- */
-export function getContactsRootPath(projectRoot: string): string {
-  return path.join(getContactRootPath(projectRoot), "contacts");
-}
-
-/**
- * 单个 contact 目录。
- */
-export function getContactDirectoryPath(
-  projectRoot: string,
-  contactId: string,
-): string {
-  return path.join(getContactsRootPath(projectRoot), cleanSegment(contactId, "contactId"));
-}
-
-/**
- * 单个 contact 元信息文件。
- */
-export function getContactJsonPath(projectRoot: string, contactId: string): string {
-  return path.join(getContactDirectoryPath(projectRoot, contactId), "contact.json");
-}
-
-/**
- * 单个 contact 的长期对话历史文件。
- */
-export function getContactMessagesPath(
-  projectRoot: string,
-  contactId: string,
-): string {
-  return path.join(getContactDirectoryPath(projectRoot, contactId), "messages.jsonl");
-}
-
-/**
- * link 根目录。
- */
-export function getContactLinksRootPath(projectRoot: string): string {
-  return path.join(getContactRootPath(projectRoot), "links");
-}
-
-/**
- * 单个 link 记录文件。
- */
-export function getContactLinkPath(projectRoot: string, linkId: string): string {
-  return path.join(getContactLinksRootPath(projectRoot), `${cleanSegment(linkId, "linkId")}.json`);
-}
-
-/**
- * inbox 根目录。
- */
-export function getContactInboxRootPath(projectRoot: string): string {
-  return path.join(getContactRootPath(projectRoot), "inbox");
-}
-
-/**
- * 单个 inbox share 目录。
- */
-export function getContactInboxSharePath(
-  projectRoot: string,
-  shareId: string,
-): string {
-  return path.join(getContactInboxRootPath(projectRoot), cleanSegment(shareId, "shareId"));
-}
-
-/**
- * 单个 inbox share 元信息文件。
- */
-export function getContactInboxShareMetaPath(
-  projectRoot: string,
-  shareId: string,
-): string {
-  return path.join(getContactInboxSharePath(projectRoot, shareId), "meta.json");
-}
-
-/**
- * 单个 inbox share payload 文件。
- */
-export function getContactInboxSharePayloadPath(
-  projectRoot: string,
-  shareId: string,
-): string {
-  return path.join(getContactInboxSharePath(projectRoot, shareId), "payload.json");
-}
-
-/**
- * 单个 inbox share 文件根目录。
- */
-export function getContactInboxShareFilesPath(
-  projectRoot: string,
-  shareId: string,
-): string {
-  return path.join(getContactInboxSharePath(projectRoot, shareId), "files");
-}
-
-/**
- * received 根目录。
- */
-export function getContactReceivedRootPath(projectRoot: string): string {
-  return path.join(getContactRootPath(projectRoot), "received");
-}
-
-/**
- * 单个 received share 目录。
- */
-export function getContactReceivedSharePath(
-  projectRoot: string,
-  shareId: string,
-): string {
-  return path.join(getContactReceivedRootPath(projectRoot), cleanSegment(shareId, "shareId"));
-}

package/src/services/contact/runtime/RemoteClient.ts

@@ -1,137 +0,0 @@
-/**
- * contact 远端 HTTP 客户端。
- *
- * 关键点（中文）
- * - contact 的 agent-to-agent 调用走独立轻量路由，不依赖用户 CLI auth。
- * - 已建联后的敏感调用必须携带 contact token。
- */
-
-import type { JsonValue } from "@/shared/types/Json.js";
-
-type JsonRecord = Record<string, unknown>;
-
-function isRecord(value: unknown): value is JsonRecord {
-  return Boolean(value && typeof value === "object" && !Array.isArray(value));
-}
-
-function normalizeEndpoint(endpoint: string): string {
-  const raw = String(endpoint || "").trim();
-  if (!raw) throw new Error("endpoint is required");
-  const withProtocol = /^https?:\/\//i.test(raw) ? raw : `http://${raw}`;
-  const url = new URL(withProtocol);
-  url.pathname = "";
-  url.search = "";
-  url.hash = "";
-  return url.toString().replace(/\/$/, "");
-}
-
-function unwrapServiceActionEnvelope<T>(value: T): T {
-  if (!isRecord(value)) return value;
-  const inner = value.data;
-  if (typeof value.success === "boolean" && isRecord(inner)) {
-    // 关键点（中文）：远端 contact API 挂在统一 service action route 下，HTTP 返回会包一层 { success, data }。
-    return inner as T;
-  }
-  return value;
-}
-
-async function postJson<T>(params: {
-  endpoint: string;
-  path: string;
-  body?: JsonValue;
-  token?: string;
-}): Promise<T> {
-  const url = new URL(params.path, normalizeEndpoint(params.endpoint)).toString();
-  const headers: Record<string, string> = {
-    "Content-Type": "application/json",
-  };
-  if (params.token) headers["X-Downcity-Contact-Token"] = params.token;
-
-  const response = await fetch(url, {
-    method: "POST",
-    headers,
-    body: JSON.stringify(params.body ?? {}),
-  });
-  const data = (await response.json().catch(() => null)) as T & {
-    error?: string;
-    message?: string;
-  };
-  if (!response.ok) {
-    throw new Error(data?.error || data?.message || `HTTP ${response.status}`);
-  }
-  return unwrapServiceActionEnvelope<T>(data);
-}
-
-/**
- * 调用远端 ping。
- */
-export async function callContactPing<T>(params: {
-  endpoint: string;
-  token?: string;
-}): Promise<T> {
-  return await postJson<T>({
-    endpoint: params.endpoint,
-    path: "/api/contact/ping",
-    token: params.token,
-  });
-}
-
-/**
- * 调用远端 approve。
- */
-export async function callContactApprove<T>(params: {
-  endpoint: string;
-  body: JsonValue;
-}): Promise<T> {
-  return await postJson<T>({
-    endpoint: params.endpoint,
-    path: "/api/contact/approve",
-    body: params.body,
-  });
-}
-
-/**
- * 调用远端 confirm。
- */
-export async function callContactConfirm<T>(params: {
-  endpoint: string;
-  body: JsonValue;
-}): Promise<T> {
-  return await postJson<T>({
-    endpoint: params.endpoint,
-    path: "/api/contact/confirm",
-    body: params.body,
-  });
-}
-
-/**
- * 调用远端 chat。
- */
-export async function callContactChat<T>(params: {
-  endpoint: string;
-  token: string;
-  body: JsonValue;
-}): Promise<T> {
-  return await postJson<T>({
-    endpoint: params.endpoint,
-    path: "/api/contact/chat",
-    token: params.token,
-    body: params.body,
-  });
-}
-
-/**
- * 调用远端 share。
- */
-export async function callContactShare<T>(params: {
-  endpoint: string;
-  token: string;
-  body: JsonValue;
-}): Promise<T> {
-  return await postJson<T>({
-    endpoint: params.endpoint,
-    path: "/api/contact/share",
-    token: params.token,
-    body: params.body,
-  });
-}

package/src/services/contact/runtime/ShareBundle.ts

@@ -1,286 +0,0 @@
-/**
- * contact 通用 share 打包与接收。
- *
- * 关键点（中文）
- * - share 不理解 skill，只处理文本、链接、文件和目录。
- * - receive 不自动安装或执行内容，只把 share 标记为已接收并复制到 received 区。
- */
-
-import crypto from "node:crypto";
-import fs from "fs-extra";
-import path from "node:path";
-import type { AgentContext } from "@/types/agent/AgentContext.js";
-import type {
-  ContactInboxShareFileInput,
-  ContactInboxShareMeta,
-  ContactReceiveShareRequest,
-  ContactShareFileManifest,
-  ContactShareItem,
-  ContactSharePayload,
-  SaveContactInboxShareInput,
-} from "@/types/contact/ContactShare.js";
-import { createContactId } from "./Token.js";
-import {
-  getInboxShareFilesRoot,
-  markContactInboxShareReceived,
-  readContactInboxSharePayload,
-} from "./InboxStore.js";
-import { getContactReceivedSharePath } from "./Paths.js";
-
-function hashContent(content: Buffer): string {
-  return crypto.createHash("sha256").update(content).digest("hex");
-}
-
-function assertSafeRelativePath(relativePath: string): string {
-  const value = String(relativePath || "").trim();
-  if (!value) throw new Error("relativePath is required");
-  if (path.isAbsolute(value)) throw new Error(`Absolute path is not allowed: ${value}`);
-  const normalized = path.normalize(value);
-  if (normalized.startsWith("..") || normalized.includes(`${path.sep}..${path.sep}`)) {
-    throw new Error(`Unsafe relative path: ${value}`);
-  }
-  return normalized;
-}
-
-function createItemRoot(itemPath: string): string {
-  const base = path.basename(itemPath).replace(/[^a-zA-Z0-9._-]+/g, "_") || "item";
-  return `${createContactId("item")}_${base}`;
-}
-
-async function collectPathFiles(params: {
-  /**
-   * 要分享的文件或目录。
-   */
-  sourcePath: string;
-  /**
-   * share files 下的 item 根目录。
-   */
-  itemRoot: string;
-}): Promise<{
-  /**
-   * share 附带文件内容。
-   */
-  files: ContactInboxShareFileInput[];
-  /**
-   * item manifest 文件列表。
-   */
-  manifest: ContactShareFileManifest[];
-  /**
-   * item 类型。
-   */
-  itemType: "file" | "directory";
-}> {
-  const stat = await fs.stat(params.sourcePath);
-  const files: ContactInboxShareFileInput[] = [];
-  const manifest: ContactShareFileManifest[] = [];
-
-  const pushFile = async (absPath: string, relativePath: string): Promise<void> => {
-    const safeRelative = assertSafeRelativePath(relativePath);
-    const content = await fs.readFile(absPath);
-    files.push({
-      relativePath: path.join(params.itemRoot, safeRelative),
-      content: content.toString("base64"),
-      encoding: "base64",
-    });
-    manifest.push({
-      path: safeRelative,
-      sha256: hashContent(content),
-    });
-  };
-
-  if (stat.isFile()) {
-    await pushFile(params.sourcePath, path.basename(params.sourcePath));
-    return { files, manifest, itemType: "file" };
-  }
-
-  if (!stat.isDirectory()) {
-    throw new Error(`Only files and directories can be shared: ${params.sourcePath}`);
-  }
-
-  const walk = async (dir: string): Promise<void> => {
-    const entries = await fs.readdir(dir, { withFileTypes: true });
-    for (const entry of entries) {
-      const absPath = path.join(dir, entry.name);
-      if (entry.isDirectory()) {
-        await walk(absPath);
-        continue;
-      }
-      if (!entry.isFile()) continue;
-      await pushFile(absPath, path.relative(params.sourcePath, absPath));
-    }
-  };
-  await walk(params.sourcePath);
-  return { files, manifest, itemType: "directory" };
-}
-
-function normalizeLinks(input: string[] | undefined): string[] {
-  const values = Array.isArray(input) ? input : [];
-  return values
-    .map((item) => String(item || "").trim())
-    .filter(Boolean);
-}
-
-/**
- * 创建通用 share。
- */
-export async function createShareInput(params: {
-  /**
-   * 当前 agent context。
-   */
-  context: AgentContext;
-  /**
-   * 发送方 contact id。
-   */
-  fromContactId: string;
-  /**
-   * 发送方 agent 名称。
-   */
-  fromAgentName: string;
-  /**
-   * 分享文本。
-   */
-  text?: string;
-  /**
-   * 分享链接。
-   */
-  links?: string[];
-  /**
-   * 分享文件或目录路径。
-   */
-  paths?: string[];
-}): Promise<SaveContactInboxShareInput> {
-  const items: ContactShareItem[] = [];
-  const files: ContactInboxShareFileInput[] = [];
-
-  const text = String(params.text || "").trim();
-  if (text) {
-    items.push({
-      id: createContactId("item"),
-      type: "text",
-      title: "Text",
-      text,
-    });
-  }
-
-  for (const link of normalizeLinks(params.links)) {
-    items.push({
-      id: createContactId("item"),
-      type: "link",
-      title: link,
-      url: link,
-    });
-  }
-
-  for (const rawPath of Array.isArray(params.paths) ? params.paths : []) {
-    const sourcePath = path.resolve(params.context.rootPath, String(rawPath || "").trim());
-    const itemRoot = createItemRoot(sourcePath);
-    const collected = await collectPathFiles({
-      sourcePath,
-      itemRoot,
-    });
-    files.push(...collected.files);
-    items.push({
-      id: createContactId("item"),
-      type: collected.itemType,
-      title: path.basename(sourcePath),
-      root: itemRoot,
-      files: collected.manifest,
-    });
-  }
-
-  if (items.length === 0) {
-    throw new Error("Share requires at least one text, link, file, or directory item");
-  }
-
-  const sizeBytes =
-    files.reduce((sum, file) => {
-      if (file.encoding === "base64") return sum + Buffer.byteLength(file.content, "base64");
-      return sum + Buffer.byteLength(file.content, "utf-8");
-    }, 0) +
-    Buffer.byteLength(text, "utf-8") +
-    normalizeLinks(params.links).reduce(
-      (sum, link) => sum + Buffer.byteLength(link, "utf-8"),
-      0,
-    );
-  const title = items
-    .slice(0, 3)
-    .map((item) => item.title)
-    .join(", ");
-  const meta: ContactInboxShareMeta = {
-    id: createContactId("share"),
-    fromContactId: params.fromContactId,
-    fromAgentName: params.fromAgentName,
-    title: title || "Share",
-    status: "pending",
-    receivedAt: Date.now(),
-    sizeBytes,
-    itemCount: items.length,
-  };
-  const payload: ContactSharePayload = {
-    kind: "share",
-    items,
-  };
-
-  return {
-    meta,
-    payload,
-    files,
-  };
-}
-
-/**
- * 接收通用 share。
- */
-export async function receiveShare(params: {
-  /**
-   * 项目根目录。
-   */
-  projectRoot: string;
-  /**
-   * share id。
-   */
-  shareId: string;
-}): Promise<{
-  /**
-   * 接收后的 item 数量。
-   */
-  itemCount: number;
-  /**
-   * received 目录。
-   */
-  receivedPath: string;
-}> {
-  const payload = await readContactInboxSharePayload(params.projectRoot, params.shareId);
-  if (!payload) throw new Error(`Share payload not found: ${params.shareId}`);
-  if (payload.kind !== "share") throw new Error(`Unsupported share payload: ${payload.kind}`);
-
-  const receivedPath = getContactReceivedSharePath(params.projectRoot, params.shareId);
-  await fs.ensureDir(receivedPath);
-  await fs.writeJson(path.join(receivedPath, "payload.json"), payload, { spaces: 2 });
-
-  const filesRoot = getInboxShareFilesRoot(params.projectRoot, params.shareId);
-  if (await fs.pathExists(filesRoot)) {
-    await fs.copy(filesRoot, path.join(receivedPath, "files"), {
-      overwrite: true,
-    });
-  }
-
-  await markContactInboxShareReceived(params.projectRoot, params.shareId);
-  return {
-    itemCount: payload.items.length,
-    receivedPath,
-  };
-}
-
-/**
- * 构造远端 receive share 请求。
- */
-export function createReceiveShareRequest(
-  input: SaveContactInboxShareInput,
-  senderContactId: string,
-): ContactReceiveShareRequest {
-  return {
-    ...input,
-    senderContactId,
-  };
-}

package/src/services/contact/runtime/SystemProvider.ts

@@ -1,22 +0,0 @@
-/**
- * contact service system prompt 提供器。
- *
- * 关键点（中文）
- * - session system composer 通过静态 provider 清单读取 service system。
- * - contact prompt 在这里统一读取，避免 service 实例和 system 域产生耦合。
- */
-
-import { readFileSync } from "node:fs";
-
-const CONTACT_PROMPT_FILE_URL = new URL("../PROMPT.txt", import.meta.url);
-
-/**
- * 构建 contact service system 文本。
- */
-export function buildContactServiceSystemText(): string {
-  try {
-    return readFileSync(CONTACT_PROMPT_FILE_URL, "utf-8").trim();
-  } catch {
-    return "";
-  }
-}