@downcity/agent 1.1.10 → 1.1.12

package/src/service/builtins/contact/Action.ts

@@ -1,9 +1,373 @@
 /**
- * contact action 兼容入口。
+ * contact action 注册表。
  *
  * 关键点（中文）
- * - 当前 contact action 直接内聚在 `ContactService` 中。
- * - 预留该文件，便于后续拆分更复杂的 action helper。
+ * - 这里只负责 CLI / HTTP action 映射，不承载 contact 业务实现。
+ * - 业务动作通过 handlers 注入，保持 `ContactService` 类本身更薄。
  */
 
-export {};
+import type { AgentContext } from "@/runtime/AgentContextTypes.js";
+import type { JsonObject, JsonValue } from "@/types/common/Json.js";
+import type { ServiceActions } from "@/service/types/Service.js";
+import type {
+  ContactApproveCommandPayload,
+  ContactChatCommandPayload,
+  ContactCheckCommandPayload,
+  ContactLinkCommandPayload,
+  ContactReceiveCommandPayload,
+  ContactShareCommandPayload,
+} from "@/service/builtins/contact/types/ContactCommand.js";
+import type {
+  ContactApproveLinkRequest,
+  ContactApproveLinkResponse,
+} from "@/service/builtins/contact/types/ContactLink.js";
+import type {
+  ContactConfirmRequest,
+  ContactConfirmResponse,
+} from "@/service/builtins/contact/types/ContactApproval.js";
+import type { ContactPingResponse } from "@/service/builtins/contact/types/ContactCheck.js";
+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 {
+  getContactHeaderToken,
+  readContactObject,
+  readContactString,
+} from "./runtime/ContactPayload.js";
+
+/**
+ * ContactService 注入给 action 注册表的业务动作。
+ */
+export type ContactActionHandlers = {
+  /**
+   * 生成一次性联系码。
+   */
+  link: (context: AgentContext, payload: ContactLinkCommandPayload) => Promise<JsonValue>;
+  /**
+   * 使用联系码建立 contact。
+   */
+  approve: (
+    context: AgentContext,
+    payload: ContactApproveCommandPayload,
+  ) => Promise<JsonValue>;
+  /**
+   * 检查 contact 或 endpoint 可用性。
+   */
+  check: (context: AgentContext, payload: ContactCheckCommandPayload) => Promise<JsonValue>;
+  /**
+   * 与 contact 对话或读取对话历史。
+   */
+  chat: (context: AgentContext, payload: ContactChatCommandPayload) => Promise<JsonValue>;
+  /**
+   * 向 contact 分享内容。
+   */
+  share: (context: AgentContext, payload: ContactShareCommandPayload) => Promise<JsonValue>;
+  /**
+   * 处理远端 ping 请求。
+   */
+  remotePing: (
+    context: AgentContext,
+    payload: { token?: string },
+  ) => Promise<ContactPingResponse>;
+  /**
+   * 处理远端 approve 请求。
+   */
+  remoteApprove: (
+    context: AgentContext,
+    request: ContactApproveLinkRequest,
+  ) => Promise<ContactApproveLinkResponse>;
+  /**
+   * 处理远端 confirm 请求。
+   */
+  remoteConfirm: (
+    context: AgentContext,
+    request: ContactConfirmRequest,
+  ) => Promise<ContactConfirmResponse>;
+  /**
+   * 处理远端 share 请求。
+   */
+  remoteShare: (context: AgentContext, rawPayload: JsonValue) => Promise<JsonValue>;
+};
+
+/**
+ * 创建 contact service action 表。
+ */
+export function createContactActions(handlers: ContactActionHandlers): ServiceActions {
+  return {
+    link: {
+      command: {
+        description: "生成一次性 contact link code，交给另一个 agent approve",
+        configure(command) {
+          command.option("--ttl-seconds <seconds>", "link 过期秒数，默认 600", Number);
+        },
+        mapInput({ opts }) {
+          const payload: JsonObject = {};
+          if (typeof opts.ttlSeconds === "number") payload.ttlSeconds = opts.ttlSeconds;
+          return payload;
+        },
+      },
+      execute: async (params) => ({
+        success: true,
+        data: await handlers.link(
+          params.context,
+          params.payload as ContactLinkCommandPayload,
+        ),
+      }),
+    },
+    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: JsonObject = { 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 as unknown as ContactApproveCommandPayload,
+        ),
+      }),
+    },
+    list: {
+      command: {
+        description: "列出已建立的 contact",
+        mapInput() {
+          return {};
+        },
+      },
+      execute: async (params) => ({
+        success: true,
+        data: {
+          contacts: await listContacts(params.context.rootPath),
+        } as unknown as JsonValue,
+      }),
+    },
+    check: {
+      command: {
+        description: "检查 contact 或 endpoint 当前是否在线可用",
+        configure(command) {
+          command
+            .argument("[target]")
+            .option("--to <endpoint>", "直接检查未保存的 endpoint");
+        },
+        mapInput({ args, opts }) {
+          const payload: JsonObject = {};
+          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 as ContactCheckCommandPayload,
+        ),
+      }),
+    },
+    chat: {
+      command: {
+        description: "和某个 contact 的长期对话线聊天",
+        configure(command) {
+          command.requiredOption("--to <contact>", "目标 contact").argument("[message...]");
+        },
+        mapInput({ args, opts }) {
+          const payload: JsonObject = {
+            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 as unknown as ContactChatCommandPayload,
+        ),
+      }),
+    },
+    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 as unknown as ContactShareCommandPayload,
+        ),
+      }),
+    },
+    inbox: {
+      command: {
+        description: "查看 contact inbox",
+        mapInput() {
+          return {};
+        },
+      },
+      execute: async (params) => ({
+        success: true,
+        data: {
+          shares: await listContactInboxShares(params.context.rootPath),
+        } as unknown as JsonValue,
+      }),
+    },
+    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 as unknown as ContactReceiveCommandPayload).shareId,
+        })) as unknown as JsonValue,
+      }),
+    },
+    remoteping: {
+      api: {
+        method: "POST",
+        path: "/api/contact/ping",
+        async mapInput(ctx) {
+          const body = (await ctx.req.json().catch(() => ({}))) as JsonValue;
+          return {
+            body,
+            token: getContactHeaderToken({
+              headers: ctx.req.raw.headers,
+              body: readContactObject(body),
+            }),
+          } as unknown as JsonValue;
+        },
+      },
+      execute: async (params) => ({
+        success: true,
+        data: (await handlers.remotePing(
+          params.context,
+          params.payload as unknown as { token?: string },
+        )) as unknown as JsonValue,
+      }),
+    },
+    remoteapprove: {
+      api: {
+        method: "POST",
+        path: "/api/contact/approve",
+        async mapInput(ctx) {
+          return (await ctx.req.json()) as JsonValue;
+        },
+      },
+      execute: async (params) => ({
+        success: true,
+        data: (await handlers.remoteApprove(
+          params.context,
+          readContactObject(params.payload) as unknown as ContactApproveLinkRequest,
+        )) as unknown as JsonValue,
+      }),
+    },
+    remoteconfirm: {
+      api: {
+        method: "POST",
+        path: "/api/contact/confirm",
+        async mapInput(ctx) {
+          return (await ctx.req.json()) as JsonValue;
+        },
+      },
+      execute: async (params) => ({
+        success: true,
+        data: (await handlers.remoteConfirm(
+          params.context,
+          readContactObject(params.payload) as unknown as ContactConfirmRequest,
+        )) as unknown as JsonValue,
+      }),
+    },
+    remotechat: {
+      api: {
+        method: "POST",
+        path: "/api/contact/chat",
+        async mapInput(ctx) {
+          const body = (await ctx.req.json()) as JsonValue;
+          return {
+            body,
+            token: getContactHeaderToken({
+              headers: ctx.req.raw.headers,
+              body: readContactObject(body),
+            }),
+          } as unknown as JsonValue;
+        },
+      },
+      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"),
+          })) as unknown as JsonValue,
+        };
+      },
+    },
+    remoteshare: {
+      api: {
+        method: "POST",
+        path: "/api/contact/share",
+        async mapInput(ctx) {
+          const body = (await ctx.req.json()) as JsonValue;
+          return {
+            body,
+            token: getContactHeaderToken({
+              headers: ctx.req.raw.headers,
+              body: readContactObject(body),
+            }),
+          } as unknown as JsonValue;
+        },
+      },
+      execute: async (params) => ({
+        success: true,
+        data: (await handlers.remoteShare(params.context, params.payload)) as unknown as JsonValue,
+      }),
+    },
+  };
+}