@downcity/plugins 1.0.4

package/bin/contact/runtime/ContactStore.js

@@ -0,0 +1,255 @@
+/**
+ * contact 存储。
+ *
+ * 关键点（中文）
+ * - 一个 contact 一个目录，目录内保存 `contact.json` 与 `messages.jsonl`。
+ * - 查找 contact 支持 id/name，方便 CLI 使用别名。
+ */
+import fs from "fs-extra";
+import path from "node:path";
+import { hashContactToken, toContactSlug } from "./Token.js";
+import { getContactDirectoryPath, getContactJsonPath, getContactMessagesPath, getContactsRootPath, } from "./Paths.js";
+function normalizeEndpoint(endpoint) {
+    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 isReachability(input) {
+    return input === "inbound" || input === "outbound" || input === "bidirectional";
+}
+function isContactStatus(input) {
+    return input === "trusted" || input === "blocked";
+}
+function normalizeOptionalEndpoint(input) {
+    if (input === undefined || input === null)
+        return null;
+    if (typeof input !== "string")
+        return undefined;
+    try {
+        return normalizeEndpoint(input);
+    }
+    catch {
+        return undefined;
+    }
+}
+function normalizeOptionalToken(input) {
+    if (input === undefined || input === null)
+        return null;
+    if (typeof input !== "string")
+        return undefined;
+    const value = input.trim();
+    return value || null;
+}
+function normalizeOptionalTimestamp(input) {
+    return typeof input === "number" && Number.isFinite(input) ? input : undefined;
+}
+function inferStoredReachability(params) {
+    if (params.endpoint && params.outboundToken && params.inboundTokenHash) {
+        return "bidirectional";
+    }
+    if (params.endpoint && params.outboundToken)
+        return "outbound";
+    return "inbound";
+}
+function isReachabilityStateValid(contact) {
+    if (contact.reachability !== "inbound" && (!contact.endpoint || !contact.outboundToken)) {
+        return false;
+    }
+    if (contact.reachability !== "outbound" && !contact.inboundTokenHash) {
+        return false;
+    }
+    return true;
+}
+function normalizeStoredContact(input) {
+    const item = input;
+    if (!item || typeof item.id !== "string" || typeof item.name !== "string") {
+        return null;
+    }
+    const endpoint = normalizeOptionalEndpoint(item.endpoint);
+    const outboundToken = normalizeOptionalToken(item.outboundToken);
+    const inboundTokenHash = normalizeOptionalToken(item.inboundTokenHash);
+    if (endpoint === undefined || outboundToken === undefined || inboundTokenHash === undefined) {
+        return null;
+    }
+    const contact = {
+        id: item.id,
+        name: item.name.trim(),
+        endpoint,
+        reachability: isReachability(item.reachability)
+            ? item.reachability
+            : inferStoredReachability({
+                endpoint,
+                outboundToken,
+                inboundTokenHash,
+            }),
+        status: isContactStatus(item.status) ? item.status : "trusted",
+        outboundToken,
+        inboundTokenHash,
+        createdAt: normalizeOptionalTimestamp(item.createdAt) ?? 0,
+        ...(normalizeOptionalTimestamp(item.lastSeenAt) !== undefined
+            ? { lastSeenAt: normalizeOptionalTimestamp(item.lastSeenAt) }
+            : {}),
+    };
+    if (!contact.name || !isReachabilityStateValid(contact))
+        return null;
+    return contact;
+}
+function resolveReachability(contact) {
+    if (contact.reachability)
+        return contact.reachability;
+    if (contact.endpoint && contact.outboundToken && contact.inboundTokenHash) {
+        return "bidirectional";
+    }
+    if (contact.endpoint && contact.outboundToken)
+        return "outbound";
+    return "inbound";
+}
+/**
+ * 创建 contact id。
+ */
+export function createStableContactId(name) {
+    return `contact_${toContactSlug(name)}`;
+}
+/**
+ * 归一化 endpoint。
+ */
+export function normalizeContactEndpoint(endpoint) {
+    return normalizeEndpoint(endpoint);
+}
+/**
+ * 保存 contact。
+ */
+export async function saveContact(projectRoot, contact) {
+    const normalized = {
+        ...contact,
+        id: contact.id || createStableContactId(contact.name),
+        name: String(contact.name || "").trim(),
+        endpoint: contact.endpoint ? normalizeEndpoint(contact.endpoint) : null,
+        reachability: resolveReachability(contact),
+        status: contact.status || "trusted",
+        outboundToken: contact.outboundToken || null,
+        inboundTokenHash: contact.inboundTokenHash || null,
+        createdAt: contact.createdAt || Date.now(),
+    };
+    if (!normalized.name)
+        throw new Error("contact name is required");
+    if (normalized.reachability !== "inbound" && !normalized.endpoint) {
+        throw new Error("contact endpoint is required for outbound contacts");
+    }
+    if (normalized.reachability !== "inbound" && !normalized.outboundToken) {
+        throw new Error("contact approve response did not include the peer token; generate a fresh link and approve again");
+    }
+    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, {
+        spaces: 2,
+    });
+    await fs.ensureFile(getContactMessagesPath(projectRoot, normalized.id));
+    return normalized;
+}
+/**
+ * 读取 contact。
+ */
+export async function readContact(projectRoot, contactId) {
+    const filePath = getContactJsonPath(projectRoot, contactId);
+    if (!(await fs.pathExists(filePath)))
+        return null;
+    const raw = await fs.readJson(filePath).catch(() => null);
+    // 关键点（中文）：读取时归一化可恢复字段，避免一次局部写入让已收到的 contact 在列表中消失。
+    return normalizeStoredContact(raw);
+}
+/**
+ * 列出全部 contact。
+ */
+export async function listContacts(projectRoot) {
+    const root = getContactsRootPath(projectRoot);
+    if (!(await fs.pathExists(root)))
+        return [];
+    const entries = await fs.readdir(root, { withFileTypes: true });
+    const contacts = [];
+    for (const entry of entries) {
+        if (!entry.isDirectory())
+            continue;
+        const contact = await readContact(projectRoot, entry.name);
+        if (contact)
+            contacts.push(contact);
+    }
+    return contacts.sort((a, b) => a.name.localeCompare(b.name));
+}
+/**
+ * 按 id/name 查找 contact。
+ */
+export async function findContact(projectRoot, query) {
+    const value = String(query || "").trim();
+    if (!value)
+        return null;
+    const contacts = await listContacts(projectRoot);
+    const lower = value.toLowerCase();
+    return (contacts.find((item) => item.id.toLowerCase() === lower) ||
+        contacts.find((item) => item.name.toLowerCase() === lower) ||
+        contacts.find((item) => item.name.toLowerCase().includes(lower)) ||
+        null);
+}
+/**
+ * 根据入站 token 查找 contact。
+ */
+export async function findContactByInboundToken(projectRoot, token) {
+    const tokenHash = hashContactToken(token);
+    const contacts = await listContacts(projectRoot);
+    return contacts.find((item) => item.inboundTokenHash === tokenHash) || null;
+}
+/**
+ * 更新 contact 最近在线时间。
+ */
+export async function touchContactSeen(projectRoot, contactId, seenAt = Date.now()) {
+    const contact = await readContact(projectRoot, contactId);
+    if (!contact)
+        return null;
+    return await saveContact(projectRoot, {
+        ...contact,
+        lastSeenAt: seenAt,
+    });
+}
+/**
+ * 追加 contact chat 消息。
+ */
+export async function appendContactMessage(projectRoot, contactId, message) {
+    const filePath = getContactMessagesPath(projectRoot, contactId);
+    await fs.ensureDir(path.dirname(filePath));
+    await fs.appendFile(filePath, `${JSON.stringify(message)}\n`, "utf-8");
+}
+/**
+ * 读取 contact chat 历史。
+ */
+export async function readContactMessages(projectRoot, contactId) {
+    const filePath = getContactMessagesPath(projectRoot, contactId);
+    if (!(await fs.pathExists(filePath)))
+        return [];
+    const text = await fs.readFile(filePath, "utf-8");
+    const out = [];
+    for (const line of text.split(/\r?\n/)) {
+        const trimmed = line.trim();
+        if (!trimmed)
+            continue;
+        try {
+            const parsed = JSON.parse(trimmed);
+            if ((parsed.role === "local" || parsed.role === "remote") &&
+                typeof parsed.text === "string") {
+                out.push(parsed);
+            }
+        }
+        catch {
+            // 忽略损坏的历史行，避免单条坏数据阻断整个 contact。
+        }
+    }
+    return out;
+}
+//# sourceMappingURL=ContactStore.js.map

package/bin/contact/runtime/ContactStore.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContactStore.js","sourceRoot":"","sources":["../../../src/contact/runtime/ContactStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAC1B,OAAO,IAAI,MAAM,WAAW,CAAC;AAM7B,OAAO,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC7D,OAAO,EACL,uBAAuB,EACvB,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,GACpB,MAAM,YAAY,CAAC;AAEpB,SAAS,iBAAiB,CAAC,QAAgB;IACzC,MAAM,GAAG,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC1C,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,KAAK,CAAC,sBAAsB,CAAC,CAAC;IAClD,MAAM,YAAY,GAAG,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,UAAU,GAAG,EAAE,CAAC;IACvE,MAAM,GAAG,GAAG,IAAI,GAAG,CAAC,YAAY,CAAC,CAAC;IAClC,GAAG,CAAC,QAAQ,GAAG,EAAE,CAAC;IAClB,GAAG,CAAC,MAAM,GAAG,EAAE,CAAC;IAChB,GAAG,CAAC,IAAI,GAAG,EAAE,CAAC;IACd,OAAO,GAAG,CAAC,QAAQ,EAAE,CAAC,OAAO,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAS,cAAc,CAAC,KAAc;IACpC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,UAAU,IAAI,KAAK,KAAK,eAAe,CAAC;AAClF,CAAC;AAED,SAAS,eAAe,CAAC,KAAc;IACrC,OAAO,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,SAAS,CAAC;AACpD,CAAC;AAED,SAAS,yBAAyB,CAAC,KAAc;IAC/C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,IAAI,CAAC;QACH,OAAO,iBAAiB,CAAC,KAAK,CAAC,CAAC;IAClC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChD,MAAM,KAAK,GAAG,KAAK,CAAC,IAAI,EAAE,CAAC;IAC3B,OAAO,KAAK,IAAI,IAAI,CAAC;AACvB,CAAC;AAED,SAAS,0BAA0B,CAAC,KAAc;IAChD,OAAO,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC;AACjF,CAAC;AAED,SAAS,uBAAuB,CAAC,MAIhC;IACC,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,aAAa,IAAI,MAAM,CAAC,gBAAgB,EAAE,CAAC;QACvE,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,aAAa;QAAE,OAAO,UAAU,CAAC;IAC/D,OAAO,SAAS,CAAC;AACnB,CAAC;AAED,SAAS,wBAAwB,CAAC,OAAqB;IACrD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,CAAC,OAAO,CAAC,QAAQ,IAAI,CAAC,OAAO,CAAC,aAAa,CAAC,EAAE,CAAC;QACxF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,IAAI,OAAO,CAAC,YAAY,KAAK,UAAU,IAAI,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;QACrE,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,sBAAsB,CAAC,KAAc;IAC5C,MAAM,IAAI,GAAG,KAAqC,CAAC;IACnD,IAAI,CAAC,IAAI,IAAI,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ,EAAE,CAAC;QAC1E,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,QAAQ,GAAG,yBAAyB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAC1D,MAAM,aAAa,GAAG,sBAAsB,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IACjE,MAAM,gBAAgB,GAAG,sBAAsB,CAAC,IAAI,CAAC,gBAAgB,CAAC,CAAC;IACvE,IAAI,QAAQ,KAAK,SAAS,IAAI,aAAa,KAAK,SAAS,IAAI,gBAAgB,KAAK,SAAS,EAAE,CAAC;QAC5F,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,OAAO,GAAiB;QAC5B,EAAE,EAAE,IAAI,CAAC,EAAE;QACX,IAAI,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE;QACtB,QAAQ;QACR,YAAY,EAAE,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC;YAC7C,CAAC,CAAC,IAAI,CAAC,YAAY;YACnB,CAAC,CAAC,uBAAuB,CAAC;gBACtB,QAAQ;gBACR,aAAa;gBACb,gBAAgB;aACjB,CAAC;QACN,MAAM,EAAE,eAAe,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS;QAC9D,aAAa;QACb,gBAAgB;QAChB,SAAS,EAAE,0BAA0B,CAAC,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1D,GAAG,CAAC,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,KAAK,SAAS;YAC3D,CAAC,CAAC,EAAE,UAAU,EAAE,0BAA0B,CAAC,IAAI,CAAC,UAAU,CAAC,EAAE;YAC7D,CAAC,CAAC,EAAE,CAAC;KACR,CAAC;IAEF,IAAI,CAAC,OAAO,CAAC,IAAI,IAAI,CAAC,wBAAwB,CAAC,OAAO,CAAC;QAAE,OAAO,IAAI,CAAC;IACrE,OAAO,OAAO,CAAC;AACjB,CAAC;AAED,SAAS,mBAAmB,CAAC,OAAqB;IAChD,IAAI,OAAO,CAAC,YAAY;QAAE,OAAO,OAAO,CAAC,YAAY,CAAC;IACtD,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,aAAa,IAAI,OAAO,CAAC,gBAAgB,EAAE,CAAC;QAC1E,OAAO,eAAe,CAAC;IACzB,CAAC;IACD,IAAI,OAAO,CAAC,QAAQ,IAAI,OAAO,CAAC,aAAa;QAAE,OAAO,UAAU,CAAC;IACjE,OAAO,SAAS,CAAC;AACnB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,IAAY;IAChD,OAAO,WAAW,aAAa,CAAC,IAAI,CAAC,EAAE,CAAC;AAC1C,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,QAAgB;IACvD,OAAO,iBAAiB,CAAC,QAAQ,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,OAAqB;IAErB,MAAM,UAAU,GAAiB;QAC/B,GAAG,OAAO;QACV,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,qBAAqB,CAAC,OAAO,CAAC,IAAI,CAAC;QACrD,IAAI,EAAE,MAAM,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE;QACvC,QAAQ,EAAE,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,iBAAiB,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI;QACvE,YAAY,EAAE,mBAAmB,CAAC,OAAO,CAAC;QAC1C,MAAM,EAAE,OAAO,CAAC,MAAM,IAAI,SAAS;QACnC,aAAa,EAAE,OAAO,CAAC,aAAa,IAAI,IAAI;QAC5C,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,IAAI,IAAI;QAClD,SAAS,EAAE,OAAO,CAAC,SAAS,IAAI,IAAI,CAAC,GAAG,EAAE;KAC3C,CAAC;IACF,IAAI,CAAC,UAAU,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IAClE,IAAI,UAAU,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,QAAQ,EAAE,CAAC;QAClE,MAAM,IAAI,KAAK,CAAC,oDAAoD,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,UAAU,CAAC,YAAY,KAAK,SAAS,IAAI,CAAC,UAAU,CAAC,aAAa,EAAE,CAAC;QACvE,MAAM,IAAI,KAAK,CAAC,kGAAkG,CAAC,CAAC;IACtH,CAAC;IACD,IAAI,UAAU,CAAC,YAAY,KAAK,UAAU,IAAI,CAAC,UAAU,CAAC,gBAAgB,EAAE,CAAC;QAC3E,MAAM,IAAI,KAAK,CAAC,6DAA6D,CAAC,CAAC;IACjF,CAAC;IACD,MAAM,EAAE,CAAC,SAAS,CAAC,uBAAuB,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,MAAM,EAAE,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,EAAE,UAAU,EAAE;QAC7E,MAAM,EAAE,CAAC;KACV,CAAC,CAAC;IACH,MAAM,EAAE,CAAC,UAAU,CAAC,sBAAsB,CAAC,WAAW,EAAE,UAAU,CAAC,EAAE,CAAC,CAAC,CAAC;IACxE,OAAO,UAAU,CAAC;AACpB,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC5D,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,IAAI,CAAC;IAClD,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,IAAI,CAAC,CAAC;IAC1D,oDAAoD;IACpD,OAAO,sBAAsB,CAAC,GAAG,CAAC,CAAC;AACrC,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,WAAmB;IACpD,MAAM,IAAI,GAAG,mBAAmB,CAAC,WAAW,CAAC,CAAC;IAC9C,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAC5C,MAAM,OAAO,GAAG,MAAM,EAAE,CAAC,OAAO,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;IAChE,MAAM,QAAQ,GAAmB,EAAE,CAAC;IACpC,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;YAAE,SAAS;QACnC,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;QAC3D,IAAI,OAAO;YAAE,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;AAC/D,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAC/B,WAAmB,EACnB,KAAa;IAEb,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACzC,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAC;IACxB,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,WAAW,EAAE,CAAC;IAClC,OAAO,CACL,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,EAAE,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC;QACxD,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,KAAK,KAAK,CAAC;QAC1D,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,EAAE,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChE,IAAI,CACL,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,yBAAyB,CAC7C,WAAmB,EACnB,KAAa;IAEb,MAAM,SAAS,GAAG,gBAAgB,CAAC,KAAK,CAAC,CAAC;IAC1C,MAAM,QAAQ,GAAG,MAAM,YAAY,CAAC,WAAW,CAAC,CAAC;IACjD,OAAO,QAAQ,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,gBAAgB,KAAK,SAAS,CAAC,IAAI,IAAI,CAAC;AAC9E,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CACpC,WAAmB,EACnB,SAAiB,EACjB,SAAiB,IAAI,CAAC,GAAG,EAAE;IAE3B,MAAM,OAAO,GAAG,MAAM,WAAW,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAC1D,IAAI,CAAC,OAAO;QAAE,OAAO,IAAI,CAAC;IAC1B,OAAO,MAAM,WAAW,CAAC,WAAW,EAAE;QACpC,GAAG,OAAO;QACV,UAAU,EAAE,MAAM;KACnB,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,oBAAoB,CACxC,WAAmB,EACnB,SAAiB,EACjB,OAA2B;IAE3B,MAAM,QAAQ,GAAG,sBAAsB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAChE,MAAM,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,QAAQ,CAAC,CAAC,CAAC;IAC3C,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,EAAE,GAAG,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;AACzE,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,mBAAmB,CACvC,WAAmB,EACnB,SAAiB;IAEjB,MAAM,QAAQ,GAAG,sBAAsB,CAAC,WAAW,EAAE,SAAS,CAAC,CAAC;IAChE,IAAI,CAAC,CAAC,MAAM,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;QAAE,OAAO,EAAE,CAAC;IAChD,MAAM,IAAI,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC,CAAC;IAClD,MAAM,GAAG,GAAyB,EAAE,CAAC;IACrC,KAAK,MAAM,IAAI,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC;QACvC,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,EAAE,CAAC;QAC5B,IAAI,CAAC,OAAO;YAAE,SAAS;QACvB,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAuB,CAAC;YACzD,IACE,CAAC,MAAM,CAAC,IAAI,KAAK,OAAO,IAAI,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC;gBACrD,OAAO,MAAM,CAAC,IAAI,KAAK,QAAQ,EAC/B,CAAC;gBACD,GAAG,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;YACnB,CAAC;QACH,CAAC;QAAC,MAAM,CAAC;YACP,gCAAgC;QAClC,CAAC;IACH,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/bin/contact/runtime/EndpointNotice.d.ts

@@ -0,0 +1,39 @@
+/**
+ * contact endpoint 用户提示。
+ *
+ * 关键点（中文）
+ * - `contact link` / `contact approve` 会被 agent 自己调用，返回结果必须直接说明可达性限制。
+ * - loopback/private endpoint 不是错误，但需要提醒用户不要拿给无法访问该地址的远端 agent。
+ */
+import type { ContactEndpointReachability } from "../../contact/types/ContactEndpoint.js";
+/**
+ * 判断 endpoint 的粗粒度可达范围。
+ */
+export declare function classifyContactEndpoint(endpoint: string): ContactEndpointReachability;
+/**
+ * 生成 `contact link` 返回提示。
+ */
+export declare function buildContactLinkNotes(params: {
+    /**
+     * link code 内写入的 endpoint。
+     */
+    endpoint: string;
+}): string[];
+/**
+ * 生成 `contact approve` 返回提示。
+ */
+export declare function buildContactApproveNotes(params: {
+    /**
+     * link code 中的目标 endpoint。
+     */
+    targetEndpoint: string;
+    /**
+     * approve 方随请求发送给对方的 endpoint。
+     */
+    requesterEndpoint?: string;
+    /**
+     * 对方是否已经主动 ping 回 approve 方并确认成功。
+     */
+    callbackConfirmed?: boolean;
+}): string[];
+//# sourceMappingURL=EndpointNotice.d.ts.map

package/bin/contact/runtime/EndpointNotice.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointNotice.d.ts","sourceRoot":"","sources":["../../../src/contact/runtime/EndpointNotice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,oCAAoC,CAAC;AAsBtF;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,GACf,2BAA2B,CAY7B;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C;;OAEG;IACH,QAAQ,EAAE,MAAM,CAAC;CAClB,GAAG,MAAM,EAAE,CAsBX;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CAAC,MAAM,EAAE;IAC/C;;OAEG;IACH,cAAc,EAAE,MAAM,CAAC;IACvB;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;OAEG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B,GAAG,MAAM,EAAE,CA2BX"}

package/bin/contact/runtime/EndpointNotice.js

@@ -0,0 +1,98 @@
+/**
+ * contact endpoint 用户提示。
+ *
+ * 关键点（中文）
+ * - `contact link` / `contact approve` 会被 agent 自己调用，返回结果必须直接说明可达性限制。
+ * - loopback/private endpoint 不是错误，但需要提醒用户不要拿给无法访问该地址的远端 agent。
+ */
+function readHostname(endpoint) {
+    const value = String(endpoint || "").trim();
+    if (!value)
+        return "";
+    try {
+        return new URL(value).hostname.toLowerCase().replace(/^\[|\]$/g, "");
+    }
+    catch {
+        return "";
+    }
+}
+function isPrivateIpv4(hostname) {
+    const parts = hostname.split(".").map((item) => Number.parseInt(item, 10));
+    if (parts.length !== 4 || parts.some((item) => Number.isNaN(item)))
+        return false;
+    if (parts[0] === 10)
+        return true;
+    if (parts[0] === 172 && parts[1] >= 16 && parts[1] <= 31)
+        return true;
+    if (parts[0] === 192 && parts[1] === 168)
+        return true;
+    if (parts[0] === 169 && parts[1] === 254)
+        return true;
+    return false;
+}
+/**
+ * 判断 endpoint 的粗粒度可达范围。
+ */
+export function classifyContactEndpoint(endpoint) {
+    const hostname = readHostname(endpoint);
+    if (!hostname)
+        return "unknown";
+    if (hostname === "localhost" ||
+        hostname === "::1" ||
+        hostname.startsWith("127.")) {
+        return "loopback";
+    }
+    if (isPrivateIpv4(hostname))
+        return "private";
+    return "public";
+}
+/**
+ * 生成 `contact link` 返回提示。
+ */
+export function buildContactLinkNotes(params) {
+    const reachability = classifyContactEndpoint(params.endpoint);
+    if (reachability === "loopback") {
+        return [
+            "This link endpoint is local-only. Only an agent on the same machine can approve it; a server agent cannot approve a link generated by this local agent.",
+            "Start city from a reachable environment before generating a new link; city start automatically writes the public host used by contact links when it can detect one.",
+        ];
+    }
+    if (reachability === "private") {
+        return [
+            "This link endpoint is private-network only. Agents must be on the same LAN/VPN to approve it; a public server agent may not be able to reach it.",
+        ];
+    }
+    if (reachability === "public") {
+        return [
+            "This link can be approved by agents that can reach this endpoint before the code expires.",
+            "Downcity cannot verify firewall or NAT reachability from here; if approval cannot connect, restart city from a reachable server, domain, or tunnel.",
+        ];
+    }
+    return [
+        "Downcity could not classify this link endpoint. Make sure the receiving agent can reach it before approving.",
+    ];
+}
+/**
+ * 生成 `contact approve` 返回提示。
+ */
+export function buildContactApproveNotes(params) {
+    const notes = [];
+    const targetReachability = classifyContactEndpoint(params.targetEndpoint);
+    if (targetReachability === "loopback") {
+        notes.push("The approved link points to a local-only endpoint. This only works when both agents run on the same machine.");
+    }
+    else if (targetReachability === "private") {
+        notes.push("The approved link points to a private-network endpoint. This only works when this agent can reach that LAN/VPN address.");
+    }
+    if (params.requesterEndpoint && params.callbackConfirmed) {
+        notes.push("This contact is bidirectional: the peer confirmed it can ping this agent back, so both agents can initiate check, chat, and share.");
+    }
+    else if (params.requesterEndpoint) {
+        notes.push("This contact is outbound-only for now: this agent sent a callback candidate, but the peer has not confirmed it can ping this agent back.");
+    }
+    else {
+        notes.push("This contact is outbound-only from this side: this agent can call the peer, but the peer cannot call back unless this agent was started with a reachable address that city start can provide to contact.");
+    }
+    return notes;
+}
+//# sourceMappingURL=EndpointNotice.js.map

package/bin/contact/runtime/EndpointNotice.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointNotice.js","sourceRoot":"","sources":["../../../src/contact/runtime/EndpointNotice.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,SAAS,YAAY,CAAC,QAAgB;IACpC,MAAM,KAAK,GAAG,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAC5C,IAAI,CAAC,KAAK;QAAE,OAAO,EAAE,CAAC;IACtB,IAAI,CAAC;QACH,OAAO,IAAI,GAAG,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,WAAW,EAAE,CAAC,OAAO,CAAC,UAAU,EAAE,EAAE,CAAC,CAAC;IACvE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,CAAC;IACZ,CAAC;AACH,CAAC;AAED,SAAS,aAAa,CAAC,QAAgB;IACrC,MAAM,KAAK,GAAG,QAAQ,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,CAAC;IAC3E,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAAE,OAAO,KAAK,CAAC;IACjF,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,EAAE;QAAE,OAAO,IAAI,CAAC;IACjC,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE,IAAI,KAAK,CAAC,CAAC,CAAC,IAAI,EAAE;QAAE,OAAO,IAAI,CAAC;IACtE,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACtD,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG,IAAI,KAAK,CAAC,CAAC,CAAC,KAAK,GAAG;QAAE,OAAO,IAAI,CAAC;IACtD,OAAO,KAAK,CAAC;AACf,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAAgB;IAEhB,MAAM,QAAQ,GAAG,YAAY,CAAC,QAAQ,CAAC,CAAC;IACxC,IAAI,CAAC,QAAQ;QAAE,OAAO,SAAS,CAAC;IAChC,IACE,QAAQ,KAAK,WAAW;QACxB,QAAQ,KAAK,KAAK;QAClB,QAAQ,CAAC,UAAU,CAAC,MAAM,CAAC,EAC3B,CAAC;QACD,OAAO,UAAU,CAAC;IACpB,CAAC;IACD,IAAI,aAAa,CAAC,QAAQ,CAAC;QAAE,OAAO,SAAS,CAAC;IAC9C,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,MAKrC;IACC,MAAM,YAAY,GAAG,uBAAuB,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IAC9D,IAAI,YAAY,KAAK,UAAU,EAAE,CAAC;QAChC,OAAO;YACL,yJAAyJ;YACzJ,qKAAqK;SACtK,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,KAAK,SAAS,EAAE,CAAC;QAC/B,OAAO;YACL,kJAAkJ;SACnJ,CAAC;IACJ,CAAC;IACD,IAAI,YAAY,KAAK,QAAQ,EAAE,CAAC;QAC9B,OAAO;YACL,2FAA2F;YAC3F,qJAAqJ;SACtJ,CAAC;IACJ,CAAC;IACD,OAAO;QACL,8GAA8G;KAC/G,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,wBAAwB,CAAC,MAaxC;IACC,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,MAAM,kBAAkB,GAAG,uBAAuB,CAAC,MAAM,CAAC,cAAc,CAAC,CAAC;IAC1E,IAAI,kBAAkB,KAAK,UAAU,EAAE,CAAC;QACtC,KAAK,CAAC,IAAI,CACR,8GAA8G,CAC/G,CAAC;IACJ,CAAC;SAAM,IAAI,kBAAkB,KAAK,SAAS,EAAE,CAAC;QAC5C,KAAK,CAAC,IAAI,CACR,yHAAyH,CAC1H,CAAC;IACJ,CAAC;IAED,IAAI,MAAM,CAAC,iBAAiB,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACzD,KAAK,CAAC,IAAI,CACR,oIAAoI,CACrI,CAAC;IACJ,CAAC;SAAM,IAAI,MAAM,CAAC,iBAAiB,EAAE,CAAC;QACpC,KAAK,CAAC,IAAI,CACR,0IAA0I,CAC3I,CAAC;IACJ,CAAC;SAAM,CAAC;QACN,KAAK,CAAC,IAAI,CACR,0MAA0M,CAC3M,CAAC;IACJ,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC"}

package/bin/contact/runtime/EndpointResolver.d.ts

@@ -0,0 +1,36 @@
+/**
+ * contact 自身 endpoint 解析。
+ *
+ * 关键点（中文）
+ * - endpoint 是 contact 协议内部字段，不暴露成普通用户命令参数。
+ * - 优先使用明确配置的公开地址，避免服务器 / 反向代理 / tunnel 场景被误判。
+ * - 监听 `0.0.0.0` 时只做本机网卡最佳努力探测，不访问外部网络。
+ */
+import os from "node:os";
+export interface ResolveContactSelfEndpointInput {
+    /**
+     * 运行时监听 host。
+     */
+    host?: string;
+    /**
+     * 运行时监听 port。
+     */
+    port?: number;
+    /**
+     * 环境变量读取来源，测试可注入。
+     */
+    env?: NodeJS.ProcessEnv | Record<string, string | undefined>;
+    /**
+     * 网卡信息读取来源，测试可注入。
+     */
+    interfaces?: NodeJS.Dict<os.NetworkInterfaceInfo[]>;
+    /**
+     * 公网 IPv4 解析器，测试可注入。
+     */
+    resolvePublicIpv4?: () => Promise<string | null> | string | null;
+}
+/**
+ * 解析 contact link code 中写入的自身 endpoint。
+ */
+export declare function resolveContactSelfEndpoint(input: ResolveContactSelfEndpointInput): Promise<string>;
+//# sourceMappingURL=EndpointResolver.d.ts.map

package/bin/contact/runtime/EndpointResolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointResolver.d.ts","sourceRoot":"","sources":["../../../src/contact/runtime/EndpointResolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,MAAM,SAAS,CAAC;AAEzB,MAAM,WAAW,+BAA+B;IAC9C;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,IAAI,CAAC,EAAE,MAAM,CAAC;IACd;;OAEG;IACH,GAAG,CAAC,EAAE,MAAM,CAAC,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;IAC7D;;OAEG;IACH,UAAU,CAAC,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,CAAC;IACpD;;OAEG;IACH,iBAAiB,CAAC,EAAE,MAAM,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,CAAC;CAClE;AAoFD;;GAEG;AACH,wBAAsB,0BAA0B,CAC9C,KAAK,EAAE,+BAA+B,GACrC,OAAO,CAAC,MAAM,CAAC,CAwBjB"}

package/bin/contact/runtime/EndpointResolver.js

@@ -0,0 +1,113 @@
+/**
+ * contact 自身 endpoint 解析。
+ *
+ * 关键点（中文）
+ * - endpoint 是 contact 协议内部字段，不暴露成普通用户命令参数。
+ * - 优先使用明确配置的公开地址，避免服务器 / 反向代理 / tunnel 场景被误判。
+ * - 监听 `0.0.0.0` 时只做本机网卡最佳努力探测，不访问外部网络。
+ */
+import os from "node:os";
+function normalizeUrl(value, fallbackPort) {
+    const raw = String(value || "").trim();
+    if (!raw)
+        return formatUrl("127.0.0.1", fallbackPort);
+    if (/^https?:\/\//i.test(raw))
+        return raw.replace(/\/$/, "");
+    return formatUrl(raw, fallbackPort);
+}
+function formatUrl(host, port) {
+    const normalizedHost = String(host || "").trim() || "127.0.0.1";
+    if (normalizedHost.startsWith("["))
+        return `http://${normalizedHost}:${String(port)}`;
+    if (normalizedHost.includes(":") && !normalizedHost.includes(".")) {
+        return `http://[${normalizedHost}]:${String(port)}`;
+    }
+    return `http://${normalizedHost}:${String(port)}`;
+}
+function isWildcardHost(host) {
+    const value = String(host || "").trim().toLowerCase();
+    return !value || value === "0.0.0.0" || value === "::";
+}
+function isLoopbackHost(host) {
+    const value = String(host || "").trim().toLowerCase();
+    return value === "127.0.0.1" || value === "::1" || value === "localhost";
+}
+function detectLanIpv4FromInterfaces(interfaces = os.networkInterfaces()) {
+    for (const entries of Object.values(interfaces)) {
+        const items = (entries || []);
+        for (const rawItem of items) {
+            const family = typeof rawItem.family === "string"
+                ? rawItem.family
+                : rawItem.family === 4
+                    ? "IPv4"
+                    : "unknown";
+            if (family !== "IPv4")
+                continue;
+            if (rawItem.internal)
+                continue;
+            const address = String(rawItem.address || "").trim();
+            if (address)
+                return address;
+        }
+    }
+    return null;
+}
+function isIpv4Address(value) {
+    const parts = String(value || "").trim().split(".");
+    if (parts.length !== 4)
+        return false;
+    return parts.every((part) => {
+        if (!/^\d+$/.test(part))
+            return false;
+        const value = Number.parseInt(part, 10);
+        return value >= 0 && value <= 255;
+    });
+}
+async function resolvePublicIpv4FromNetwork() {
+    if (typeof fetch !== "function")
+        return null;
+    const controller = new AbortController();
+    const timeout = setTimeout(() => controller.abort(), 800);
+    try {
+        const response = await fetch("https://api.ipify.org?format=json", {
+            signal: controller.signal,
+        });
+        if (!response.ok)
+            return null;
+        const data = (await response.json().catch(() => null));
+        const ip = String(data?.ip || "").trim();
+        return isIpv4Address(ip) ? ip : null;
+    }
+    catch {
+        return null;
+    }
+    finally {
+        clearTimeout(timeout);
+    }
+}
+/**
+ * 解析 contact link code 中写入的自身 endpoint。
+ */
+export async function resolveContactSelfEndpoint(input) {
+    const env = input.env || process.env;
+    const port = Number(input.port || env.DC_SERVER_PORT || 5314);
+    // 关键点（中文）：公开 URL 是最可靠来源，适配域名、反向代理和 tunnel。
+    const publicUrl = String(env.DOWNCITY_PUBLIC_URL || "").trim();
+    if (publicUrl)
+        return normalizeUrl(publicUrl, port);
+    const publicHost = String(env.DOWNCITY_PUBLIC_HOST || "").trim();
+    if (publicHost)
+        return formatUrl(publicHost, port);
+    const host = String(input.host || env.DC_SERVER_HOST || "127.0.0.1").trim();
+    if (!isWildcardHost(host) && !isLoopbackHost(host))
+        return formatUrl(host, port);
+    const lanIp = detectLanIpv4FromInterfaces(input.interfaces);
+    if (lanIp)
+        return formatUrl(lanIp, port);
+    // 关键点（中文）：云服务器公网 IP 可能不在网卡上，最后再做短超时公网探测。
+    const publicIp = String((await (input.resolvePublicIpv4 || resolvePublicIpv4FromNetwork)()) || "").trim();
+    if (isIpv4Address(publicIp))
+        return formatUrl(publicIp, port);
+    return formatUrl("127.0.0.1", port);
+}
+//# sourceMappingURL=EndpointResolver.js.map

package/bin/contact/runtime/EndpointResolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"EndpointResolver.js","sourceRoot":"","sources":["../../../src/contact/runtime/EndpointResolver.ts"],"names":[],"mappings":"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"}

package/bin/contact/runtime/InboxStore.d.ts

@@ -0,0 +1,33 @@
+/**
+ * contact inbox 存储。
+ *
+ * 关键点（中文）
+ * - 每条 share 都是独立目录，避免大内容堆进单个 JSON。
+ * - `inbox` 列表只读取 `meta.json`，保持轻量。
+ */
+import type { ContactInboxShareMeta, ContactInboxSharePayload, SaveContactInboxShareInput } from "../../contact/types/ContactShare.js";
+/**
+ * 保存 inbox share。
+ */
+export declare function saveContactInboxShare(projectRoot: string, input: SaveContactInboxShareInput): Promise<ContactInboxShareMeta>;
+/**
+ * 读取 inbox share meta。
+ */
+export declare function readContactInboxShareMeta(projectRoot: string, shareId: string): Promise<ContactInboxShareMeta | null>;
+/**
+ * 读取 inbox share payload。
+ */
+export declare function readContactInboxSharePayload(projectRoot: string, shareId: string): Promise<ContactInboxSharePayload | null>;
+/**
+ * 列出 inbox share。
+ */
+export declare function listContactInboxShares(projectRoot: string): Promise<ContactInboxShareMeta[]>;
+/**
+ * 标记 share 已接收，并复制轻量状态到 received。
+ */
+export declare function markContactInboxShareReceived(projectRoot: string, shareId: string): Promise<ContactInboxShareMeta>;
+/**
+ * 读取 share 文件根目录。
+ */
+export declare function getInboxShareFilesRoot(projectRoot: string, shareId: string): string;
+//# sourceMappingURL=InboxStore.d.ts.map

package/bin/contact/runtime/InboxStore.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"InboxStore.d.ts","sourceRoot":"","sources":["../../../src/contact/runtime/InboxStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,OAAO,KAAK,EACV,qBAAqB,EACrB,wBAAwB,EACxB,0BAA0B,EAC3B,MAAM,iCAAiC,CAAC;AAoCzC;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,KAAK,EAAE,0BAA0B,GAChC,OAAO,CAAC,qBAAqB,CAAC,CA2ChC;AAED;;GAEG;AACH,wBAAsB,yBAAyB,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,GAAG,IAAI,CAAC,CAKvC;AAED;;GAEG;AACH,wBAAsB,4BAA4B,CAChD,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,wBAAwB,GAAG,IAAI,CAAC,CAO1C;AAED;;GAEG;AACH,wBAAsB,sBAAsB,CAC1C,WAAW,EAAE,MAAM,GAClB,OAAO,CAAC,qBAAqB,EAAE,CAAC,CAWlC;AAED;;GAEG;AACH,wBAAsB,6BAA6B,CACjD,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,OAAO,CAAC,qBAAqB,CAAC,CAiBhC;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAEnF"}