@downcity/plugins 1.0.4

package/bin/contact/Action.js

@@ -0,0 +1,221 @@
+/**
+ * contact action 注册表。
+ *
+ * 关键点（中文）
+ * - 这里只负责 CLI action 与内部远端 command action 映射，不承载 contact 业务实现。
+ * - 业务动作通过 handlers 注入，保持 `ContactPlugin` 类本身更薄。
+ */
+import { listContacts } from "./runtime/ContactStore.js";
+import { receiveContactChatMessage } from "./runtime/ChatRuntime.js";
+import { listContactInboxShares } from "./runtime/InboxStore.js";
+import { receiveShare } from "./runtime/ShareBundle.js";
+import { readContactObject, readContactString, } from "./runtime/ContactPayload.js";
+/**
+ * 创建 contact plugin action 表。
+ */
+export function createContactActions(handlers) {
+    return {
+        link: {
+            command: {
+                description: "生成一次性 contact link code，交给另一个 agent approve",
+                configure(command) {
+                    command.option("--ttl-seconds <seconds>", "link 过期秒数，默认 600", Number);
+                },
+                mapInput({ opts }) {
+                    const payload = {};
+                    if (typeof opts.ttlSeconds === "number")
+                        payload.ttlSeconds = opts.ttlSeconds;
+                    return payload;
+                },
+            },
+            execute: async (params) => ({
+                success: true,
+                data: await handlers.link(params.context, params.payload),
+            }),
+        },
+        approve: {
+            command: {
+                description: "使用 contact link code 建立点对点联系",
+                configure(command) {
+                    command
+                        .argument("<code>")
+                        .option("--name <alias>", "本地 contact 别名");
+                },
+                mapInput({ args, opts }) {
+                    const code = String(args[0] || "").trim();
+                    if (!code)
+                        throw new Error("Missing link code");
+                    const payload = { code };
+                    if (typeof opts.name === "string")
+                        payload.name = opts.name;
+                    return payload;
+                },
+            },
+            execute: async (params) => ({
+                success: true,
+                data: await handlers.approve(params.context, params.payload),
+            }),
+        },
+        list: {
+            command: {
+                description: "列出已建立的 contact",
+                mapInput() {
+                    return {};
+                },
+            },
+            execute: async (params) => ({
+                success: true,
+                data: {
+                    contacts: await listContacts(params.context.rootPath),
+                },
+            }),
+        },
+        check: {
+            command: {
+                description: "检查 contact 或 endpoint 当前是否在线可用",
+                configure(command) {
+                    command
+                        .argument("[target]")
+                        .option("--to <endpoint>", "直接检查未保存的 endpoint");
+                },
+                mapInput({ args, opts }) {
+                    const payload = {};
+                    const target = String(args[0] || "").trim();
+                    if (target)
+                        payload.target = target;
+                    if (typeof opts.to === "string")
+                        payload.endpoint = opts.to;
+                    return payload;
+                },
+            },
+            execute: async (params) => ({
+                success: true,
+                data: await handlers.check(params.context, params.payload),
+            }),
+        },
+        chat: {
+            command: {
+                description: "和某个 contact 的长期对话线聊天",
+                configure(command) {
+                    command.requiredOption("--to <contact>", "目标 contact").argument("[message...]");
+                },
+                mapInput({ args, opts }) {
+                    const payload = {
+                        to: String(opts.to || "").trim(),
+                    };
+                    const message = args.join(" ").trim();
+                    if (message)
+                        payload.message = message;
+                    return payload;
+                },
+            },
+            execute: async (params) => ({
+                success: true,
+                data: await handlers.chat(params.context, params.payload),
+            }),
+        },
+        share: {
+            command: {
+                description: "向 contact 分享文本、链接、文件或目录",
+                configure(command) {
+                    command
+                        .requiredOption("--to <contact>", "目标 contact")
+                        .option("--text <text>", "分享文本")
+                        .option("--link <url...>", "分享链接")
+                        .argument("[paths...]");
+                },
+                mapInput({ args, opts }) {
+                    const links = Array.isArray(opts.link)
+                        ? opts.link.map((item) => String(item || "").trim()).filter(Boolean)
+                        : typeof opts.link === "string"
+                            ? [opts.link]
+                            : [];
+                    return {
+                        to: String(opts.to || "").trim(),
+                        ...(typeof opts.text === "string" ? { text: opts.text } : {}),
+                        ...(links.length > 0 ? { links } : {}),
+                        paths: args.map((item) => String(item || "").trim()).filter(Boolean),
+                    };
+                },
+            },
+            execute: async (params) => ({
+                success: true,
+                data: await handlers.share(params.context, params.payload),
+            }),
+        },
+        inbox: {
+            command: {
+                description: "查看 contact inbox",
+                mapInput() {
+                    return {};
+                },
+            },
+            execute: async (params) => ({
+                success: true,
+                data: {
+                    shares: await listContactInboxShares(params.context.rootPath),
+                },
+            }),
+        },
+        receive: {
+            command: {
+                description: "接收 inbox 中的 share",
+                configure(command) {
+                    command.argument("<shareId>");
+                },
+                mapInput({ args }) {
+                    const shareId = String(args[0] || "").trim();
+                    if (!shareId)
+                        throw new Error("Missing shareId");
+                    return { shareId };
+                },
+            },
+            execute: async (params) => ({
+                success: true,
+                data: (await receiveShare({
+                    projectRoot: params.context.rootPath,
+                    shareId: params.payload.shareId,
+                })),
+            }),
+        },
+        remoteping: {
+            execute: async (params) => ({
+                success: true,
+                data: (await handlers.remotePing(params.context, params.payload)),
+            }),
+        },
+        remoteapprove: {
+            execute: async (params) => ({
+                success: true,
+                data: (await handlers.remoteApprove(params.context, readContactObject(params.payload))),
+            }),
+        },
+        remoteconfirm: {
+            execute: async (params) => ({
+                success: true,
+                data: (await handlers.remoteConfirm(params.context, readContactObject(params.payload))),
+            }),
+        },
+        remotechat: {
+            execute: async (params) => {
+                const payload = readContactObject(params.payload);
+                const body = readContactObject(payload.body);
+                return {
+                    success: true,
+                    data: (await receiveContactChatMessage({
+                        context: params.context,
+                        token: readContactString(payload, "token"),
+                        message: readContactString(body, "message"),
+                    })),
+                };
+            },
+        },
+        remoteshare: {
+            execute: async (params) => ({
+                success: true,
+                data: (await handlers.remoteShare(params.context, params.payload)),
+            }),
+        },
+    };
+}
+//# sourceMappingURL=Action.js.map

package/bin/contact/Action.js.map

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

package/bin/contact/ContactPlugin.d.ts

@@ -0,0 +1,39 @@
+/**
+ * ContactPlugin：agent 点对点关系与分享插件。
+ *
+ * 关键点（中文）
+ * - `link/approve` 建立可信 contact，支持 outbound/inbound/bidirectional 三种可达方向。
+ * - 每个 contact 固定一条长期 chat history。
+ * - `share` 分享文本、链接、文件和目录，并进入对方 inbox。
+ */
+import type { AgentRuntime } from "@downcity/agent/internal/types/runtime/agent/AgentRuntime.js";
+import type { PluginActions } from "@downcity/agent/internal/plugin/types/Plugin.js";
+import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
+/**
+ * Contact plugin 类实现。
+ */
+export declare class ContactPlugin extends BasePlugin {
+    /**
+     * plugin 名称。
+     */
+    readonly name = "contact";
+    /**
+     * 当前 plugin action 定义表。
+     */
+    readonly actions: PluginActions;
+    constructor(agent: AgentRuntime | null);
+    /**
+     * contact system 文本。
+     */
+    system(): string;
+    private link;
+    private approve;
+    private check;
+    private chat;
+    private share;
+    private remotePing;
+    private remoteApprove;
+    private remoteConfirm;
+    private remoteShare;
+}
+//# sourceMappingURL=ContactPlugin.d.ts.map

package/bin/contact/ContactPlugin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ContactPlugin.d.ts","sourceRoot":"","sources":["../../src/contact/ContactPlugin.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8DAA8D,CAAC;AAGjG,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,iDAAiD,CAAC;AACrF,OAAO,EAAE,UAAU,EAAE,MAAM,oDAAoD,CAAC;AAyHhF;;GAEG;AACH,qBAAa,aAAc,SAAQ,UAAU;IAC3C;;OAEG;IACH,QAAQ,CAAC,IAAI,aAAa;IAE1B;;OAEG;IACH,QAAQ,CAAC,OAAO,EAAE,aAAa,CAAC;gBAEpB,KAAK,EAAE,YAAY,GAAG,IAAI;IA0BtC;;OAEG;IACH,MAAM,IAAI,MAAM;YAIF,IAAI;YAsCJ,OAAO;YAuGP,KAAK;YAwCL,IAAI;YAmCJ,KAAK;YA4BL,UAAU;YAqBV,aAAa;YAYb,aAAa;YAkBb,WAAW;CA0B1B"}

package/bin/contact/ContactPlugin.js

@@ -0,0 +1,407 @@
+/**
+ * ContactPlugin：agent 点对点关系与分享插件。
+ *
+ * 关键点（中文）
+ * - `link/approve` 建立可信 contact，支持 outbound/inbound/bidirectional 三种可达方向。
+ * - 每个 contact 固定一条长期 chat history。
+ * - `share` 分享文本、链接、文件和目录，并进入对方 inbox。
+ */
+import { BasePlugin } from "@downcity/agent/internal/plugin/core/BasePlugin.js";
+import { appendContactMessage, createStableContactId, findContact, findContactByInboundToken, normalizeContactEndpoint, readContactMessages, saveContact, touchContactSeen, } from "./runtime/ContactStore.js";
+import { createContactLinkCode, parseContactLinkCode, } from "./runtime/LinkCode.js";
+import { saveContactLinkRecord, } from "./runtime/LinkStore.js";
+import { createContactId, createContactToken, hashContactToken, } from "./runtime/Token.js";
+import { callContactApprove, callContactChat, callContactConfirm, callContactPing, callContactShare, } from "./runtime/RemoteClient.js";
+import { saveContactInboxShare } from "./runtime/InboxStore.js";
+import { createShareInput } from "./runtime/ShareBundle.js";
+import { buildContactPluginSystemText } from "./runtime/SystemProvider.js";
+import { resolveContactSelfEndpoint } from "./runtime/EndpointResolver.js";
+import { buildContactApproveNotes, buildContactLinkNotes, classifyContactEndpoint, } from "./runtime/EndpointNotice.js";
+import { approveContactLinkRequest, confirmContactLinkRequest, } from "./runtime/LinkApproval.js";
+import { buildContactApproveCallbackDecision } from "./runtime/ApproveCallback.js";
+import { createContactActions } from "./Action.js";
+import { readContactObject, readContactString, } from "./runtime/ContactPayload.js";
+async function resolveSelfEndpoint(context, endpointOverride) {
+    const explicit = String(endpointOverride || "").trim();
+    if (explicit)
+        return normalizeContactEndpoint(explicit);
+    const start = context.config.start || {};
+    const env = {
+        ...process.env,
+        ...context.env,
+    };
+    const runtimePort = Number(process.env.DC_SERVER_PORT || env.DC_SERVER_PORT || "");
+    // 关键点（中文）：link code 必须写入当前 runtime 的真实监听端口，不能使用可能已经过期的配置端口。
+    const port = Number.isFinite(runtimePort) && runtimePort > 0 ? runtimePort : start.port;
+    const runtimeHost = String(process.env.DC_SERVER_HOST || env.DC_SERVER_HOST || "").trim();
+    return normalizeContactEndpoint(await resolveContactSelfEndpoint({
+        host: runtimeHost || start.host,
+        port,
+        env,
+    }));
+}
+function hasRuntimePublicEndpointEnv(context) {
+    const env = {
+        ...process.env,
+        ...context.env,
+    };
+    return Boolean(String(env.DOWNCITY_PUBLIC_URL || "").trim() ||
+        String(env.DOWNCITY_PUBLIC_HOST || "").trim());
+}
+function getAgentName(context) {
+    return String(context.config.name || "downcity-agent").trim() || "downcity-agent";
+}
+function requireOutboundContact(contact) {
+    if (!contact.endpoint || !contact.outboundToken) {
+        throw new Error(`Contact is inbound-only and cannot be called directly: ${contact.name}`);
+    }
+    return {
+        endpoint: contact.endpoint,
+        token: contact.outboundToken,
+    };
+}
+/**
+ * Contact plugin 类实现。
+ */
+export class ContactPlugin extends BasePlugin {
+    /**
+     * plugin 名称。
+     */
+    name = "contact";
+    /**
+     * 当前 plugin action 定义表。
+     */
+    actions;
+    constructor(agent) {
+        super(agent);
+        this.actions = createContactActions({
+            link: async (context, payload) => (await this.link(context, payload)),
+            approve: async (context, payload) => (await this.approve(context, payload)),
+            check: async (context, payload) => (await this.check(context, payload)),
+            chat: async (context, payload) => (await this.chat(context, payload)),
+            share: async (context, payload) => (await this.share(context, payload)),
+            remotePing: (context, payload) => this.remotePing(context, payload),
+            remoteApprove: (context, request) => this.remoteApprove(context, request),
+            remoteConfirm: (context, request) => this.remoteConfirm(context, request),
+            remoteShare: async (context, payload) => (await this.remoteShare(context, payload)),
+        });
+        this.lifecycle = {
+            start: () => undefined,
+            stop: () => undefined,
+        };
+    }
+    /**
+     * contact system 文本。
+     */
+    system() {
+        return buildContactPluginSystemText();
+    }
+    async link(context, payload) {
+        const now = Date.now();
+        const ttlSeconds = Math.max(60, Number(payload.ttlSeconds || 600));
+        const linkId = createContactId("link");
+        const secret = createContactToken();
+        const endpoint = await resolveSelfEndpoint(context, payload.endpoint);
+        const agentName = getAgentName(context);
+        await saveContactLinkRecord(context.rootPath, {
+            id: linkId,
+            agentName,
+            endpoint,
+            secretHash: hashContactToken(secret),
+            createdAt: now,
+            expiresAt: now + ttlSeconds * 1000,
+            usedAt: null,
+        });
+        const code = createContactLinkCode({
+            version: 1,
+            linkId,
+            agentName,
+            endpoint,
+            secret,
+            createdAt: now,
+            expiresAt: now + ttlSeconds * 1000,
+        });
+        return {
+            code,
+            linkId,
+            agentName,
+            endpoint,
+            endpointReachability: classifyContactEndpoint(endpoint),
+            notes: buildContactLinkNotes({ endpoint }),
+            expiresAt: now + ttlSeconds * 1000,
+        };
+    }
+    async approve(context, payload) {
+        const parsed = parseContactLinkCode(payload.code);
+        // 关键点（中文）：approve 端不使用本机时钟预判过期，避免两台机器时钟不一致时把本来可用的 link 提前拦截。
+        // 是否过期统一交给 link 持有方在远端按本地记录判断。
+        const targetReachability = classifyContactEndpoint(parsed.endpoint);
+        const shouldResolveRequesterEndpoint = payload.endpoint ||
+            hasRuntimePublicEndpointEnv(context) ||
+            targetReachability === "loopback" ||
+            targetReachability === "private";
+        const requesterEndpointCandidate = shouldResolveRequesterEndpoint
+            ? await resolveSelfEndpoint(context, payload.endpoint)
+            : undefined;
+        const callbackDecision = buildContactApproveCallbackDecision({
+            targetEndpoint: parsed.endpoint,
+            requesterEndpoint: requesterEndpointCandidate,
+        });
+        const requesterEndpoint = callbackDecision.callbackOffered
+            ? callbackDecision.endpoint
+            : undefined;
+        const tokenForRequester = requesterEndpoint ? createContactToken() : undefined;
+        const approveNotes = buildContactApproveNotes({
+            targetEndpoint: parsed.endpoint,
+        });
+        let response;
+        try {
+            response = await callContactApprove({
+                endpoint: parsed.endpoint,
+                body: {
+                    linkId: parsed.linkId,
+                    secret: parsed.secret,
+                    agentName: getAgentName(context),
+                    callbackOffered: callbackDecision.callbackOffered,
+                    callbackReason: callbackDecision.reason,
+                    ...(requesterEndpoint ? { endpoint: requesterEndpoint } : {}),
+                    ...(tokenForRequester ? { tokenForRequester } : {}),
+                },
+            });
+        }
+        catch (error) {
+            throw new Error(`${String(error)}\n${approveNotes.join("\n")}`);
+        }
+        if (!response.success)
+            throw new Error(response.error || "Contact approve failed");
+        const name = String(payload.name || response.agentName || parsed.agentName).trim();
+        const contact = await saveContact(context.rootPath, {
+            id: createStableContactId(name),
+            name,
+            endpoint: response.endpoint || parsed.endpoint,
+            reachability: "outbound",
+            status: "trusted",
+            outboundToken: response.tokenForOwner,
+            inboundTokenHash: tokenForRequester ? hashContactToken(tokenForRequester) : null,
+            createdAt: Date.now(),
+            lastSeenAt: Date.now(),
+        });
+        let confirmed = false;
+        let confirmError;
+        if (requesterEndpoint && tokenForRequester) {
+            try {
+                const confirm = await callContactConfirm({
+                    endpoint: parsed.endpoint,
+                    body: {
+                        linkId: parsed.linkId,
+                        secret: parsed.secret,
+                        agentName: getAgentName(context),
+                        endpoint: requesterEndpoint,
+                        tokenForRequester,
+                    },
+                });
+                confirmed = Boolean(confirm.success && confirm.confirmed);
+                if (!confirmed && confirm.error)
+                    confirmError = confirm.error;
+            }
+            catch (error) {
+                // 关键点（中文）：confirm 只决定是否升级双向；approve 已成功时仍保留 outbound contact。
+                confirmError = String(error);
+            }
+        }
+        const finalContact = confirmed
+            ? await saveContact(context.rootPath, {
+                ...contact,
+                reachability: "bidirectional",
+                inboundTokenHash: tokenForRequester ? hashContactToken(tokenForRequester) : null,
+                lastSeenAt: Date.now(),
+            })
+            : contact;
+        const finalNotes = buildContactApproveNotes({
+            targetEndpoint: parsed.endpoint,
+            requesterEndpoint,
+            callbackConfirmed: confirmed,
+        });
+        return {
+            contact: finalContact,
+            reachability: finalContact.reachability,
+            targetEndpointReachability: classifyContactEndpoint(parsed.endpoint),
+            callbackOffered: callbackDecision.callbackOffered,
+            callbackConfirmed: confirmed,
+            callbackReason: callbackDecision.reason,
+            ...(requesterEndpoint ? { requesterEndpoint } : {}),
+            ...(confirmError ? { confirmError } : {}),
+            notes: finalNotes,
+        };
+    }
+    async check(context, payload) {
+        const startedAt = Date.now();
+        const endpointInput = String(payload.endpoint || "").trim();
+        const contact = endpointInput
+            ? null
+            : await findContact(context.rootPath, String(payload.target || "").trim());
+        const endpoint = endpointInput || contact?.endpoint || "";
+        if (!endpoint)
+            throw new Error("contact target or --to endpoint is required");
+        if (contact && !contact.outboundToken) {
+            throw new Error(`Contact is inbound-only and cannot be checked directly: ${contact.name}`);
+        }
+        try {
+            const pong = await callContactPing({
+                endpoint,
+                token: contact?.outboundToken || undefined,
+            });
+            if (contact && pong.success) {
+                await touchContactSeen(context.rootPath, contact.id);
+            }
+            return {
+                target: contact?.name || endpoint,
+                endpoint: normalizeContactEndpoint(endpoint),
+                reachable: Boolean(pong.success),
+                authenticated: pong.authenticated,
+                latencyMs: Date.now() - startedAt,
+                agentName: pong.agentName,
+                ...(pong.error ? { error: pong.error } : {}),
+            };
+        }
+        catch (error) {
+            return {
+                target: contact?.name || endpoint,
+                endpoint: normalizeContactEndpoint(endpoint),
+                reachable: false,
+                latencyMs: Date.now() - startedAt,
+                error: String(error),
+            };
+        }
+    }
+    async chat(context, payload) {
+        const contact = await findContact(context.rootPath, payload.to);
+        if (!contact)
+            throw new Error(`Contact not found: ${payload.to}`);
+        const message = String(payload.message || "").trim();
+        if (!message) {
+            return {
+                contact,
+                messages: await readContactMessages(context.rootPath, contact.id),
+            };
+        }
+        await appendContactMessage(context.rootPath, contact.id, {
+            role: "local",
+            text: message,
+            createdAt: Date.now(),
+        });
+        const outbound = requireOutboundContact(contact);
+        const response = await callContactChat({
+            endpoint: outbound.endpoint,
+            token: outbound.token,
+            body: {
+                senderContactId: contact.id,
+                message,
+                createdAt: Date.now(),
+            },
+        });
+        if (!response.success)
+            throw new Error(response.error || "Contact chat failed");
+        await appendContactMessage(context.rootPath, contact.id, {
+            role: "remote",
+            text: response.reply,
+            createdAt: Date.now(),
+        });
+        return response;
+    }
+    async share(context, payload) {
+        const contact = await findContact(context.rootPath, payload.to);
+        if (!contact)
+            throw new Error(`Contact not found: ${payload.to}`);
+        const outbound = requireOutboundContact(contact);
+        const share = await createShareInput({
+            context,
+            fromContactId: contact.id,
+            fromAgentName: getAgentName(context),
+            text: payload.text,
+            links: payload.links,
+            paths: payload.paths,
+        });
+        const response = await callContactShare({
+            endpoint: outbound.endpoint,
+            token: outbound.token,
+            body: share,
+        });
+        if (!response.success)
+            throw new Error(response.error || "Contact share failed");
+        return {
+            shareId: response.shareId || share.meta.id,
+            to: contact.name,
+            items: share.payload.items.map((item) => ({
+                type: item.type,
+                title: item.title,
+            })),
+        };
+    }
+    async remotePing(context, payload) {
+        const token = String(payload.token || "").trim();
+        if (!token) {
+            return {
+                success: true,
+                agentName: getAgentName(context),
+                plugin: "contact",
+            };
+        }
+        const contact = await findContactByInboundToken(context.rootPath, token);
+        return {
+            success: true,
+            agentName: getAgentName(context),
+            plugin: "contact",
+            authenticated: Boolean(contact && contact.status === "trusted"),
+        };
+    }
+    async remoteApprove(context, request) {
+        return await approveContactLinkRequest({
+            projectRoot: context.rootPath,
+            ownerAgentName: getAgentName(context),
+            ownerEndpoint: await resolveSelfEndpoint(context),
+            request,
+        });
+    }
+    async remoteConfirm(context, request) {
+        return await confirmContactLinkRequest({
+            projectRoot: context.rootPath,
+            ownerAgentName: getAgentName(context),
+            request,
+            verifyCallback: async ({ endpoint, token }) => {
+                const pong = await callContactPing({
+                    endpoint,
+                    token,
+                });
+                return Boolean(pong.success && pong.authenticated);
+            },
+        });
+    }
+    async remoteShare(context, rawPayload) {
+        const payload = readContactObject(rawPayload);
+        const token = readContactString(payload, "token");
+        const body = readContactObject(payload.body);
+        const contact = await findContactByInboundToken(context.rootPath, token);
+        if (!contact || contact.status !== "trusted") {
+            throw new Error("Invalid contact token");
+        }
+        const share = body;
+        const meta = {
+            ...share.meta,
+            fromContactId: contact.id,
+            fromAgentName: contact.name,
+            receivedAt: Date.now(),
+            status: "pending",
+        };
+        await saveContactInboxShare(context.rootPath, {
+            meta,
+            payload: share.payload,
+            files: Array.isArray(share.files) ? share.files : [],
+        });
+        return {
+            success: true,
+            shareId: meta.id,
+        };
+    }
+}
+//# sourceMappingURL=ContactPlugin.js.map