@downcity/city 1.1.1 → 1.1.4

package/bin/services/contact/runtime/LinkApproval.js

@@ -1,317 +0,0 @@
-/**
- * contact link approve 状态机。
- *
- * 关键点（中文）
- * - 远端 approve 只有一个入口：校验 link -> 保存 contact -> 消费 link。
- * - 同一个 agent 在 link 有效期内可重试，用于恢复“远端已保存、本地保存失败”的半建联。
- * - contact token 由协议自动交换，不依赖用户手动配置环境变量。
- */
-import { createStableContactId, listContacts, normalizeContactEndpoint, readContact, saveContact, } from "./ContactStore.js";
-import { readContactLinkRecord, saveContactLinkRecord, } from "./LinkStore.js";
-import { createContactToken, hashContactToken, } from "./Token.js";
-export const CONTACT_LINK_NOT_FOUND_ERROR = "Contact link not found. This runtime does not have that link record. This usually means the approve request reached the wrong endpoint or port, the link was generated by another agent/project, or the local link store was cleared. If the code is expired, the remote agent returns Contact link expired instead.";
-function failure(params) {
-    return {
-        success: false,
-        agentName: params.ownerAgentName,
-        endpoint: params.endpoint,
-        tokenForOwner: "",
-        error: params.error,
-    };
-}
-function confirmFailure(params) {
-    return {
-        success: false,
-        agentName: params.ownerAgentName,
-        confirmed: false,
-        reachability: "inbound",
-        error: params.error,
-    };
-}
-function readCallbackCandidate(request) {
-    if (request.callbackOffered !== true) {
-        return {
-            endpoint: null,
-            token: null,
-        };
-    }
-    const token = String(request.tokenForRequester || "").trim();
-    if (!request.endpoint || !token) {
-        return {
-            endpoint: null,
-            token: null,
-            error: "Contact approve request is missing the peer callback token",
-        };
-    }
-    try {
-        return {
-            endpoint: normalizeContactEndpoint(request.endpoint),
-            token,
-        };
-    }
-    catch {
-        return {
-            endpoint: null,
-            token: null,
-            error: "Contact approve request has an invalid peer callback endpoint",
-        };
-    }
-}
-async function findApprovedContact(params) {
-    const stable = await readContact(params.projectRoot, createStableContactId(params.agentName));
-    if (stable)
-        return stable;
-    const contacts = await listContacts(params.projectRoot);
-    const lower = params.agentName.trim().toLowerCase();
-    return contacts.find((item) => item.name.toLowerCase() === lower) || null;
-}
-async function saveApprovedInboundContact(params) {
-    const existing = await findApprovedContact({
-        projectRoot: params.projectRoot,
-        agentName: params.agentName,
-    });
-    const hasOutboundSide = Boolean(existing?.endpoint && existing?.outboundToken);
-    await saveContact(params.projectRoot, {
-        id: existing?.id || createStableContactId(params.agentName),
-        name: existing?.name || params.agentName,
-        endpoint: existing?.endpoint || null,
-        reachability: hasOutboundSide ? "bidirectional" : "inbound",
-        status: "trusted",
-        outboundToken: existing?.outboundToken || null,
-        inboundTokenHash: hashContactToken(params.tokenForOwner),
-        createdAt: existing?.createdAt || params.nowMs,
-        lastSeenAt: params.nowMs,
-    });
-}
-/**
- * 执行远端 link approve 状态转换。
- */
-export async function approveContactLinkRequest(input) {
-    const nowMs = input.nowMs ?? Date.now();
-    const link = await readContactLinkRecord(input.projectRoot, input.request.linkId);
-    if (!link) {
-        return failure({
-            ownerAgentName: input.ownerAgentName,
-            endpoint: input.ownerEndpoint,
-            error: CONTACT_LINK_NOT_FOUND_ERROR,
-        });
-    }
-    if (link.expiresAt <= nowMs) {
-        return failure({
-            ownerAgentName: input.ownerAgentName,
-            endpoint: link.endpoint,
-            error: "Contact link expired",
-        });
-    }
-    if (hashContactToken(input.request.secret) !== link.secretHash) {
-        return failure({
-            ownerAgentName: input.ownerAgentName,
-            endpoint: link.endpoint,
-            error: "Invalid contact link secret",
-        });
-    }
-    const callbackCandidate = readCallbackCandidate(input.request);
-    if (link.usedAt) {
-        if (link.approvedAgentName === input.request.agentName &&
-            link.tokenForOwner) {
-            let nextLink = link;
-            if (!link.confirmedAt &&
-                !callbackCandidate.error &&
-                callbackCandidate.endpoint &&
-                callbackCandidate.token) {
-                nextLink = {
-                    ...link,
-                    approvedEndpoint: callbackCandidate.endpoint,
-                    tokenForRequester: callbackCandidate.token,
-                    callbackReason: input.request.callbackReason || link.callbackReason || null,
-                };
-                await saveContactLinkRecord(input.projectRoot, nextLink);
-            }
-            await saveApprovedInboundContact({
-                projectRoot: input.projectRoot,
-                agentName: input.request.agentName,
-                tokenForOwner: link.tokenForOwner,
-                nowMs,
-            });
-            return {
-                success: true,
-                agentName: input.ownerAgentName,
-                endpoint: link.endpoint,
-                tokenForOwner: link.tokenForOwner,
-            };
-        }
-        return failure({
-            ownerAgentName: input.ownerAgentName,
-            endpoint: link.endpoint,
-            error: "Contact link already used",
-        });
-    }
-    const tokenForOwner = createContactToken();
-    const approvedLink = {
-        ...link,
-        usedAt: nowMs,
-        approvedAgentName: input.request.agentName,
-        approvedEndpoint: callbackCandidate.endpoint,
-        tokenForOwner,
-        tokenForRequester: callbackCandidate.token,
-        callbackReason: callbackCandidate.error ? null : input.request.callbackReason || null,
-    };
-    // 先消费 link，再派生 contact；重试时以 link 记录为来源修复 contact，避免孤儿 trusted contact。
-    await saveContactLinkRecord(input.projectRoot, approvedLink);
-    await saveApprovedInboundContact({
-        projectRoot: input.projectRoot,
-        agentName: input.request.agentName,
-        tokenForOwner,
-        nowMs,
-    });
-    return {
-        success: true,
-        agentName: input.ownerAgentName,
-        endpoint: link.endpoint,
-        tokenForOwner,
-    };
-}
-/**
- * 执行远端 confirm 状态转换。
- */
-export async function confirmContactLinkRequest(input) {
-    const nowMs = input.nowMs ?? Date.now();
-    const link = await readContactLinkRecord(input.projectRoot, input.request.linkId);
-    if (!link) {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: CONTACT_LINK_NOT_FOUND_ERROR,
-        });
-    }
-    if (!link.usedAt && link.expiresAt <= nowMs) {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Contact link expired",
-        });
-    }
-    if (hashContactToken(input.request.secret) !== link.secretHash) {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Invalid contact link secret",
-        });
-    }
-    if (!link.usedAt || link.approvedAgentName !== input.request.agentName) {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Contact link is not approved by this agent",
-        });
-    }
-    let endpoint;
-    try {
-        endpoint = normalizeContactEndpoint(input.request.endpoint);
-    }
-    catch {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Contact confirm request has an invalid peer callback endpoint",
-        });
-    }
-    const token = String(input.request.tokenForRequester || "").trim();
-    if (!token) {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Contact confirm request is missing the peer callback token",
-        });
-    }
-    if (!link.tokenForRequester) {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Contact link has no callback token to confirm",
-        });
-    }
-    if (link.tokenForRequester !== token) {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Contact confirm callback token does not match the approved token",
-        });
-    }
-    if (!link.approvedEndpoint) {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Contact link has no callback endpoint to confirm",
-        });
-    }
-    if (normalizeContactEndpoint(link.approvedEndpoint) !== endpoint) {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Contact confirm callback endpoint does not match the approved endpoint",
-        });
-    }
-    const contact = await findApprovedContact({
-        projectRoot: input.projectRoot,
-        agentName: input.request.agentName,
-    });
-    if (!contact || contact.status !== "trusted") {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Contact not found for approved link",
-        });
-    }
-    if (!link.tokenForOwner || contact.inboundTokenHash !== hashContactToken(link.tokenForOwner)) {
-        return confirmFailure({
-            ownerAgentName: input.ownerAgentName,
-            error: "Contact token state does not match the approved link",
-        });
-    }
-    if (contact.reachability === "bidirectional" &&
-        contact.endpoint === endpoint &&
-        contact.outboundToken === token) {
-        if (!link.confirmedAt) {
-            // contact 已经完成双向升级时，重试 confirm 需要补齐 link 状态，避免最终状态分裂。
-            await saveContactLinkRecord(input.projectRoot, {
-                ...link,
-                approvedEndpoint: endpoint,
-                tokenForRequester: token,
-                confirmedAt: nowMs,
-            });
-        }
-        return {
-            success: true,
-            agentName: input.ownerAgentName,
-            confirmed: true,
-            reachability: "bidirectional",
-        };
-    }
-    let callbackOk = false;
-    try {
-        callbackOk = await input.verifyCallback({ endpoint, token });
-    }
-    catch {
-        callbackOk = false;
-    }
-    if (!callbackOk) {
-        return {
-            success: true,
-            agentName: input.ownerAgentName,
-            confirmed: false,
-            reachability: "inbound",
-            error: "Contact callback ping failed",
-        };
-    }
-    await saveContact(input.projectRoot, {
-        ...contact,
-        endpoint,
-        reachability: "bidirectional",
-        outboundToken: token,
-        inboundTokenHash: contact.inboundTokenHash,
-        lastSeenAt: nowMs,
-    });
-    await saveContactLinkRecord(input.projectRoot, {
-        ...link,
-        approvedEndpoint: endpoint,
-        tokenForRequester: token,
-        confirmedAt: nowMs,
-    });
-    return {
-        success: true,
-        agentName: input.ownerAgentName,
-        confirmed: true,
-        reachability: "bidirectional",
-    };
-}
-//# sourceMappingURL=LinkApproval.js.map

package/bin/services/contact/runtime/LinkApproval.js.map

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

package/bin/services/contact/runtime/LinkCode.d.ts

@@ -1,21 +0,0 @@
-/**
- * contact link code 编码。
- *
- * 关键点（中文）
- * - link code 是 `dc-link-v1.<base64url-json>`。
- * - 这里只负责编码/解析，不负责落盘状态校验。
- */
-import type { ContactLinkCodePayload } from "../../../types/contact/ContactLink.js";
-/**
- * 创建 contact link code。
- */
-export declare function createContactLinkCode(payload: ContactLinkCodePayload): string;
-/**
- * 解析 contact link code。
- */
-export declare function parseContactLinkCode(code: string): ContactLinkCodePayload;
-/**
- * 判断 link code 是否过期。
- */
-export declare function isContactLinkExpired(payload: Pick<ContactLinkCodePayload, "expiresAt">, nowMs?: number): boolean;
-//# sourceMappingURL=LinkCode.d.ts.map

package/bin/services/contact/runtime/LinkCode.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LinkCode.d.ts","sourceRoot":"","sources":["../../../../src/services/contact/runtime/LinkCode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,sBAAsB,EAAE,MAAM,gCAAgC,CAAC;AAmC7E;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,sBAAsB,GAAG,MAAM,CAE7E;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,sBAAsB,CAMzE;AAED;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,IAAI,CAAC,sBAAsB,EAAE,WAAW,CAAC,EAClD,KAAK,GAAE,MAAmB,GACzB,OAAO,CAET"}

package/bin/services/contact/runtime/LinkCode.js

@@ -1,61 +0,0 @@
-/**
- * contact link code 编码。
- *
- * 关键点（中文）
- * - link code 是 `dc-link-v1.<base64url-json>`。
- * - 这里只负责编码/解析，不负责落盘状态校验。
- */
-const CONTACT_LINK_PREFIX = "dc-link-v1.";
-function encodeJson(input) {
-    return Buffer.from(JSON.stringify(input), "utf-8").toString("base64url");
-}
-function decodeJson(input) {
-    const text = Buffer.from(input, "base64url").toString("utf-8");
-    const parsed = JSON.parse(text);
-    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) {
-    return `${CONTACT_LINK_PREFIX}${encodeJson(payload)}`;
-}
-/**
- * 解析 contact link code。
- */
-export function parseContactLinkCode(code) {
-    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, nowMs = Date.now()) {
-    return Number(payload.expiresAt) <= nowMs;
-}
-//# sourceMappingURL=LinkCode.js.map

package/bin/services/contact/runtime/LinkCode.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LinkCode.js","sourceRoot":"","sources":["../../../../src/services/contact/runtime/LinkCode.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH,MAAM,mBAAmB,GAAG,aAAa,CAAC;AAE1C,SAAS,UAAU,CAAC,KAA6B;IAC/C,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC,CAAC,QAAQ,CAAC,WAAW,CAAC,CAAC;AAC3E,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,MAAM,IAAI,GAAG,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,WAAW,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC;IAC/D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAoC,CAAC;IACnE,IAAI,MAAM,CAAC,OAAO,KAAK,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IAC9E,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,CAAC,MAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACtD,MAAM,MAAM,GAAG,MAAM,CAAC,MAAM,CAAC,MAAM,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IAClD,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3C,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAC3C,IAAI,CAAC,MAAM,IAAI,CAAC,SAAS,IAAI,CAAC,QAAQ,IAAI,CAAC,MAAM,EAAE,CAAC;QAClD,MAAM,IAAI,KAAK,CAAC,2BAA2B,CAAC,CAAC;IAC/C,CAAC;IACD,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,QAAQ,CAAC,SAAS,CAAC,EAAE,CAAC;QAC/D,MAAM,IAAI,KAAK,CAAC,iCAAiC,CAAC,CAAC;IACrD,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC;QACV,MAAM;QACN,SAAS;QACT,QAAQ;QACR,MAAM;QACN,SAAS;QACT,SAAS;KACV,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAA+B;IACnE,OAAO,GAAG,mBAAmB,GAAG,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;AACxD,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAAC,IAAY;IAC/C,MAAM,KAAK,GAAG,MAAM,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,IAAI,EAAE,CAAC;IACxC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,mBAAmB,CAAC,EAAE,CAAC;QAC3C,MAAM,IAAI,KAAK,CAAC,kCAAkC,CAAC,CAAC;IACtD,CAAC;IACD,OAAO,UAAU,CAAC,KAAK,CAAC,KAAK,CAAC,mBAAmB,CAAC,MAAM,CAAC,CAAC,CAAC;AAC7D,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,oBAAoB,CAClC,OAAkD,EAClD,QAAgB,IAAI,CAAC,GAAG,EAAE;IAE1B,OAAO,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,KAAK,CAAC;AAC5C,CAAC"}

package/bin/services/contact/runtime/LinkStore.d.ts

@@ -1,17 +0,0 @@
-/**
- * contact link 本地状态存储。
- *
- * 关键点（中文）
- * - link code 明文只展示给用户；本地落盘只保存 secret hash。
- * - approve 成功后写入 usedAt 和恢复元数据，确保一次性语义并支持同一 agent 幂等重试。
- */
-import type { ContactLinkRecord } from "../../../types/contact/ContactLink.js";
-/**
- * 保存 link 记录。
- */
-export declare function saveContactLinkRecord(projectRoot: string, record: ContactLinkRecord): Promise<void>;
-/**
- * 读取 link 记录。
- */
-export declare function readContactLinkRecord(projectRoot: string, linkId: string): Promise<ContactLinkRecord | null>;
-//# sourceMappingURL=LinkStore.d.ts.map

package/bin/services/contact/runtime/LinkStore.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"LinkStore.d.ts","sourceRoot":"","sources":["../../../../src/services/contact/runtime/LinkStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,gCAAgC,CAAC;AAgBxE;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,iBAAiB,GACxB,OAAO,CAAC,IAAI,CAAC,CAKf;AAED;;GAEG;AACH,wBAAsB,qBAAqB,CACzC,WAAW,EAAE,MAAM,EACnB,MAAM,EAAE,MAAM,GACb,OAAO,CAAC,iBAAiB,GAAG,IAAI,CAAC,CAKnC"}

package/bin/services/contact/runtime/LinkStore.js

@@ -1,39 +0,0 @@
-/**
- * contact link 本地状态存储。
- *
- * 关键点（中文）
- * - link code 明文只展示给用户；本地落盘只保存 secret hash。
- * - approve 成功后写入 usedAt 和恢复元数据，确保一次性语义并支持同一 agent 幂等重试。
- */
-import fs from "fs-extra";
-import { getContactLinkPath, getContactLinksRootPath } from "./Paths.js";
-function isLinkRecord(input) {
-    const item = input;
-    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, record) {
-    await fs.ensureDir(getContactLinksRootPath(projectRoot));
-    await fs.writeJson(getContactLinkPath(projectRoot, record.id), record, {
-        spaces: 2,
-    });
-}
-/**
- * 读取 link 记录。
- */
-export async function readContactLinkRecord(projectRoot, linkId) {
-    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;
-}
-//# sourceMappingURL=LinkStore.js.map

package/bin/services/contact/runtime/LinkStore.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"LinkStore.js","sourceRoot":"","sources":["../../../../src/services/contact/runtime/LinkStore.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,MAAM,UAAU,CAAC;AAE1B,OAAO,EAAE,kBAAkB,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAEzE,SAAS,YAAY,CAAC,KAAc;IAClC,MAAM,IAAI,GAAG,KAA0C,CAAC;IACxD,OAAO,OAAO,CACZ,IAAI;QACF,OAAO,IAAI,CAAC,EAAE,KAAK,QAAQ;QAC3B,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAClC,OAAO,IAAI,CAAC,QAAQ,KAAK,QAAQ;QACjC,OAAO,IAAI,CAAC,UAAU,KAAK,QAAQ;QACnC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ;QAClC,OAAO,IAAI,CAAC,SAAS,KAAK,QAAQ,CACrC,CAAC;AACJ,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,WAAmB,EACnB,MAAyB;IAEzB,MAAM,EAAE,CAAC,SAAS,CAAC,uBAAuB,CAAC,WAAW,CAAC,CAAC,CAAC;IACzD,MAAM,EAAE,CAAC,SAAS,CAAC,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,EAAE,CAAC,EAAE,MAAM,EAAE;QACrE,MAAM,EAAE,CAAC;KACV,CAAC,CAAC;AACL,CAAC;AAED;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,qBAAqB,CACzC,WAAmB,EACnB,MAAc;IAEd,MAAM,QAAQ,GAAG,kBAAkB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;IACzD,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,OAAO,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,CAAC;AACxC,CAAC"}

package/bin/services/contact/runtime/Paths.d.ts

@@ -1,64 +0,0 @@
-/**
- * contact service 路径规则。
- *
- * 关键点（中文）
- * - 所有 contact 运行时状态都收敛在 `.downcity/contact`。
- * - 每个 contact 一个目录；每条 inbox share 一个目录。
- */
-/**
- * contact 根目录。
- */
-export declare function getContactRootPath(projectRoot: string): string;
-/**
- * contacts 根目录。
- */
-export declare function getContactsRootPath(projectRoot: string): string;
-/**
- * 单个 contact 目录。
- */
-export declare function getContactDirectoryPath(projectRoot: string, contactId: string): string;
-/**
- * 单个 contact 元信息文件。
- */
-export declare function getContactJsonPath(projectRoot: string, contactId: string): string;
-/**
- * 单个 contact 的长期对话历史文件。
- */
-export declare function getContactMessagesPath(projectRoot: string, contactId: string): string;
-/**
- * link 根目录。
- */
-export declare function getContactLinksRootPath(projectRoot: string): string;
-/**
- * 单个 link 记录文件。
- */
-export declare function getContactLinkPath(projectRoot: string, linkId: string): string;
-/**
- * inbox 根目录。
- */
-export declare function getContactInboxRootPath(projectRoot: string): string;
-/**
- * 单个 inbox share 目录。
- */
-export declare function getContactInboxSharePath(projectRoot: string, shareId: string): string;
-/**
- * 单个 inbox share 元信息文件。
- */
-export declare function getContactInboxShareMetaPath(projectRoot: string, shareId: string): string;
-/**
- * 单个 inbox share payload 文件。
- */
-export declare function getContactInboxSharePayloadPath(projectRoot: string, shareId: string): string;
-/**
- * 单个 inbox share 文件根目录。
- */
-export declare function getContactInboxShareFilesPath(projectRoot: string, shareId: string): string;
-/**
- * received 根目录。
- */
-export declare function getContactReceivedRootPath(projectRoot: string): string;
-/**
- * 单个 received share 目录。
- */
-export declare function getContactReceivedSharePath(projectRoot: string, shareId: string): string;
-//# sourceMappingURL=Paths.d.ts.map

package/bin/services/contact/runtime/Paths.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"Paths.d.ts","sourceRoot":"","sources":["../../../../src/services/contact/runtime/Paths.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAeH;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE9D;AAED;;GAEG;AACH,wBAAgB,mBAAmB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAE/D;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CACrC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,MAAM,CAEjF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,WAAW,EAAE,MAAM,EACnB,SAAS,EAAE,MAAM,GAChB,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,GAAG,MAAM,CAE9E;AAED;;GAEG;AACH,wBAAgB,uBAAuB,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEnE;AAED;;GAEG;AACH,wBAAgB,wBAAwB,CACtC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,4BAA4B,CAC1C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAC7C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,6BAA6B,CAC3C,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAER;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CAAC,WAAW,EAAE,MAAM,GAAG,MAAM,CAEtE;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CACzC,WAAW,EAAE,MAAM,EACnB,OAAO,EAAE,MAAM,GACd,MAAM,CAER"}

package/bin/services/contact/runtime/Paths.js

@@ -1,103 +0,0 @@
-/**
- * contact service 路径规则。
- *
- * 关键点（中文）
- * - 所有 contact 运行时状态都收敛在 `.downcity/contact`。
- * - 每个 contact 一个目录；每条 inbox share 一个目录。
- */
-import path from "node:path";
-function cleanSegment(input, label) {
-    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) {
-    return path.join(projectRoot, ".downcity", "contact");
-}
-/**
- * contacts 根目录。
- */
-export function getContactsRootPath(projectRoot) {
-    return path.join(getContactRootPath(projectRoot), "contacts");
-}
-/**
- * 单个 contact 目录。
- */
-export function getContactDirectoryPath(projectRoot, contactId) {
-    return path.join(getContactsRootPath(projectRoot), cleanSegment(contactId, "contactId"));
-}
-/**
- * 单个 contact 元信息文件。
- */
-export function getContactJsonPath(projectRoot, contactId) {
-    return path.join(getContactDirectoryPath(projectRoot, contactId), "contact.json");
-}
-/**
- * 单个 contact 的长期对话历史文件。
- */
-export function getContactMessagesPath(projectRoot, contactId) {
-    return path.join(getContactDirectoryPath(projectRoot, contactId), "messages.jsonl");
-}
-/**
- * link 根目录。
- */
-export function getContactLinksRootPath(projectRoot) {
-    return path.join(getContactRootPath(projectRoot), "links");
-}
-/**
- * 单个 link 记录文件。
- */
-export function getContactLinkPath(projectRoot, linkId) {
-    return path.join(getContactLinksRootPath(projectRoot), `${cleanSegment(linkId, "linkId")}.json`);
-}
-/**
- * inbox 根目录。
- */
-export function getContactInboxRootPath(projectRoot) {
-    return path.join(getContactRootPath(projectRoot), "inbox");
-}
-/**
- * 单个 inbox share 目录。
- */
-export function getContactInboxSharePath(projectRoot, shareId) {
-    return path.join(getContactInboxRootPath(projectRoot), cleanSegment(shareId, "shareId"));
-}
-/**
- * 单个 inbox share 元信息文件。
- */
-export function getContactInboxShareMetaPath(projectRoot, shareId) {
-    return path.join(getContactInboxSharePath(projectRoot, shareId), "meta.json");
-}
-/**
- * 单个 inbox share payload 文件。
- */
-export function getContactInboxSharePayloadPath(projectRoot, shareId) {
-    return path.join(getContactInboxSharePath(projectRoot, shareId), "payload.json");
-}
-/**
- * 单个 inbox share 文件根目录。
- */
-export function getContactInboxShareFilesPath(projectRoot, shareId) {
-    return path.join(getContactInboxSharePath(projectRoot, shareId), "files");
-}
-/**
- * received 根目录。
- */
-export function getContactReceivedRootPath(projectRoot) {
-    return path.join(getContactRootPath(projectRoot), "received");
-}
-/**
- * 单个 received share 目录。
- */
-export function getContactReceivedSharePath(projectRoot, shareId) {
-    return path.join(getContactReceivedRootPath(projectRoot), cleanSegment(shareId, "shareId"));
-}
-//# sourceMappingURL=Paths.js.map