@kodelyth/discord 2026.5.39 → 2026.5.42

package/src/channel-actions.test.ts

@@ -0,0 +1,504 @@
+import type { ChannelMessageActionContext } from "klaw/plugin-sdk/channel-contract";
+import type { KlawConfig } from "klaw/plugin-sdk/config-contracts";
+import { withEnv } from "klaw/plugin-sdk/test-env";
+import { describe, expect, it, vi } from "vitest";
+
+const handleDiscordMessageActionMock = vi.hoisted(() =>
+  vi.fn(async () => ({ content: [], details: { ok: true } })),
+);
+
+const handleActionModule = await import("./actions/handle-action.js");
+vi.spyOn(handleActionModule, "handleDiscordMessageAction").mockImplementation(
+  handleDiscordMessageActionMock,
+);
+const { discordMessageActions } = await import("./channel-actions.js");
+
+describe("discordMessageActions", () => {
+  it("returns no tool actions when no token-sourced Discord accounts are enabled", () => {
+    withEnv({ DISCORD_BOT_TOKEN: undefined }, () => {
+      const discovery = discordMessageActions.describeMessageTool?.({
+        cfg: {
+          channels: {
+            discord: {
+              enabled: true,
+            },
+          },
+        } as KlawConfig,
+      });
+
+      expect(discovery).toEqual({
+        actions: [],
+        capabilities: [],
+        schema: null,
+      });
+    });
+  });
+
+  it("describes enabled Discord actions for token-backed accounts", () => {
+    const discovery = discordMessageActions.describeMessageTool?.({
+      cfg: {
+        channels: {
+          discord: {
+            token: "Bot token-main",
+            actions: {
+              polls: true,
+              reactions: true,
+              permissions: true,
+              channels: false,
+              roles: false,
+            },
+          },
+        },
+      } as KlawConfig,
+    });
+
+    expect(discovery?.capabilities).toEqual(["presentation"]);
+    expect(discovery?.schema).toBeUndefined();
+    expect(discovery?.actions).toEqual([
+      "send",
+      "poll",
+      "react",
+      "reactions",
+      "emoji-list",
+      "upload-file",
+      "read",
+      "edit",
+      "delete",
+      "pin",
+      "unpin",
+      "list-pins",
+      "permissions",
+      "thread-create",
+      "thread-list",
+      "thread-reply",
+      "search",
+      "sticker",
+      "member-info",
+      "role-info",
+      "emoji-upload",
+      "sticker-upload",
+      "channel-info",
+      "channel-list",
+      "voice-status",
+      "event-list",
+      "event-create",
+    ]);
+  });
+
+  it("describes actions when the Discord token is an unresolved SecretRef", () => {
+    const discovery = discordMessageActions.describeMessageTool?.({
+      cfg: {
+        channels: {
+          discord: {
+            token: { source: "env", provider: "default", id: "DISCORD_BOT_TOKEN" },
+            actions: {
+              polls: true,
+              reactions: true,
+            },
+          },
+        },
+      } as unknown as KlawConfig,
+    });
+
+    expect(discovery?.capabilities).toEqual(["presentation"]);
+    expect(discovery?.actions).toEqual([
+      "send",
+      "poll",
+      "react",
+      "reactions",
+      "emoji-list",
+      "upload-file",
+      "read",
+      "edit",
+      "delete",
+      "pin",
+      "unpin",
+      "list-pins",
+      "permissions",
+      "thread-create",
+      "thread-list",
+      "thread-reply",
+      "search",
+      "sticker",
+      "member-info",
+      "role-info",
+      "emoji-upload",
+      "sticker-upload",
+      "channel-info",
+      "channel-list",
+      "channel-create",
+      "channel-edit",
+      "channel-delete",
+      "channel-move",
+      "category-create",
+      "category-edit",
+      "category-delete",
+      "voice-status",
+      "event-list",
+      "event-create",
+    ]);
+  });
+
+  it("describes scoped account actions when only the account token is an unresolved SecretRef", () => {
+    const discovery = discordMessageActions.describeMessageTool?.({
+      cfg: {
+        channels: {
+          discord: {
+            actions: {
+              polls: true,
+              reactions: false,
+            },
+            accounts: {
+              ops: {
+                token: { source: "file", provider: "filemain", id: "/DISCORD_BOT_TOKEN" },
+                actions: {
+                  polls: false,
+                  reactions: true,
+                },
+              },
+            },
+          },
+        },
+      } as unknown as KlawConfig,
+      accountId: "ops",
+    });
+
+    expect(discovery?.actions).toEqual([
+      "send",
+      "react",
+      "reactions",
+      "emoji-list",
+      "upload-file",
+      "read",
+      "edit",
+      "delete",
+      "pin",
+      "unpin",
+      "list-pins",
+      "permissions",
+      "thread-create",
+      "thread-list",
+      "thread-reply",
+      "search",
+      "sticker",
+      "member-info",
+      "role-info",
+      "emoji-upload",
+      "sticker-upload",
+      "channel-info",
+      "channel-list",
+      "channel-create",
+      "channel-edit",
+      "channel-delete",
+      "channel-move",
+      "category-create",
+      "category-edit",
+      "category-delete",
+      "voice-status",
+      "event-list",
+      "event-create",
+    ]);
+  });
+
+  it("honors account-scoped action gates during discovery", () => {
+    const cfg = {
+      channels: {
+        discord: {
+          token: "Bot token-main",
+          actions: {
+            reactions: false,
+            polls: true,
+          },
+          accounts: {
+            work: {
+              token: "Bot token-work",
+              actions: {
+                reactions: true,
+                polls: false,
+              },
+            },
+          },
+        },
+      },
+    } as KlawConfig;
+
+    const defaultDiscovery = discordMessageActions.describeMessageTool?.({
+      cfg,
+      accountId: "default",
+    });
+    const workDiscovery = discordMessageActions.describeMessageTool?.({
+      cfg,
+      accountId: "work",
+    });
+
+    expect(defaultDiscovery?.actions).toEqual([
+      "send",
+      "poll",
+      "upload-file",
+      "read",
+      "edit",
+      "delete",
+      "pin",
+      "unpin",
+      "list-pins",
+      "permissions",
+      "thread-create",
+      "thread-list",
+      "thread-reply",
+      "search",
+      "sticker",
+      "member-info",
+      "role-info",
+      "emoji-upload",
+      "sticker-upload",
+      "channel-info",
+      "channel-list",
+      "channel-create",
+      "channel-edit",
+      "channel-delete",
+      "channel-move",
+      "category-create",
+      "category-edit",
+      "category-delete",
+      "voice-status",
+      "event-list",
+      "event-create",
+    ]);
+    expect(workDiscovery?.actions).toEqual([
+      "send",
+      "react",
+      "reactions",
+      "emoji-list",
+      "upload-file",
+      "read",
+      "edit",
+      "delete",
+      "pin",
+      "unpin",
+      "list-pins",
+      "permissions",
+      "thread-create",
+      "thread-list",
+      "thread-reply",
+      "search",
+      "sticker",
+      "member-info",
+      "role-info",
+      "emoji-upload",
+      "sticker-upload",
+      "channel-info",
+      "channel-list",
+      "channel-create",
+      "channel-edit",
+      "channel-delete",
+      "channel-move",
+      "category-create",
+      "category-edit",
+      "category-delete",
+      "voice-status",
+      "event-list",
+      "event-create",
+    ]);
+  });
+
+  it("hides upload-file when Discord message actions are disabled", () => {
+    const discovery = discordMessageActions.describeMessageTool?.({
+      cfg: {
+        channels: {
+          discord: {
+            token: "Bot token-main",
+            actions: {
+              messages: false,
+            },
+          },
+        },
+      } as KlawConfig,
+    });
+
+    expect(discovery?.actions).toContain("send");
+    expect(discovery?.actions).not.toContain("upload-file");
+    expect(discovery?.actions).not.toContain("read");
+    expect(discovery?.actions).not.toContain("edit");
+    expect(discovery?.actions).not.toContain("delete");
+  });
+
+  it("does not expose Discord-native message tool schema", () => {
+    const discovery = discordMessageActions.describeMessageTool?.({
+      cfg: {
+        channels: {
+          discord: {
+            token: "Bot token-main",
+          },
+        },
+      } as KlawConfig,
+    });
+    expect(discovery?.schema).toBeUndefined();
+  });
+
+  it.each(["read", "search"])("routes %s actions through gateway execution mode", (action) => {
+    expect(discordMessageActions.resolveExecutionMode?.({ action: action as never })).toBe(
+      "gateway",
+    );
+  });
+
+  it.each(["send", "upload-file", "edit", "delete", "react", "pin", "poll"])(
+    "routes %s actions through local execution mode",
+    (action) => {
+      expect(discordMessageActions.resolveExecutionMode?.({ action: action as never })).toBe(
+        "local",
+      );
+    },
+  );
+
+  it("extracts send targets for message and thread reply actions", () => {
+    expect(
+      discordMessageActions.extractToolSend?.({
+        args: { action: "sendMessage", to: "channel:123" },
+      }),
+    ).toEqual({ to: "channel:123" });
+
+    expect(
+      discordMessageActions.extractToolSend?.({
+        args: { action: "threadReply", channelId: "987" },
+      }),
+    ).toEqual({ to: "channel:987" });
+
+    expect(
+      discordMessageActions.extractToolSend?.({
+        args: { action: "threadReply", channelId: "   " },
+      }),
+    ).toBeNull();
+  });
+
+  it("prepares Discord send payload channel data for durable core delivery", async () => {
+    const prepared = await discordMessageActions.prepareSendPayload?.({
+      ctx: {
+        channel: "discord",
+        action: "send",
+        cfg: {} as KlawConfig,
+        params: {
+          components: {
+            text: "Choose",
+            blocks: [
+              {
+                type: "actions",
+                buttons: [{ label: "Yes", callbackData: "yes" }],
+              },
+            ],
+          },
+          embeds: undefined,
+          filename: "photo.png",
+        },
+      },
+      to: "channel:123",
+      payload: { text: "hello", mediaUrl: "/tmp/photo.png" },
+    });
+
+    expect(prepared).toEqual({
+      text: "hello",
+      mediaUrl: "/tmp/photo.png",
+      channelData: {
+        discord: {
+          components: {
+            text: "Choose",
+            blocks: [
+              {
+                type: "actions",
+                buttons: [{ label: "Yes", callbackData: "yes" }],
+              },
+            ],
+          },
+          filename: "photo.png",
+        },
+      },
+    });
+  });
+
+  it("prepares inbound event delivery metadata for durable core sends", async () => {
+    const prepared = await discordMessageActions.prepareSendPayload?.({
+      ctx: {
+        channel: "discord",
+        action: "send",
+        cfg: {} as KlawConfig,
+        params: {},
+        sessionKey: "agent:main:discord:channel:c1",
+        inboundEventKind: "room_event",
+      },
+      to: "channel:123",
+      payload: { text: "hello" },
+    });
+
+    expect(prepared).toEqual({
+      text: "hello",
+      channelData: {
+        discord: {
+          __klawInboundEventDelivery: {
+            sessionKey: "agent:main:discord:channel:c1",
+            inboundEventKind: "room_event",
+          },
+        },
+      },
+    });
+  });
+
+  it("keeps non-serializable Discord component sends on the legacy action path", async () => {
+    const prepared = await discordMessageActions.prepareSendPayload?.({
+      ctx: {
+        channel: "discord",
+        action: "send",
+        cfg: {} as KlawConfig,
+        params: {
+          components: () => [],
+        },
+      },
+      to: "channel:123",
+      payload: { text: "hello" },
+    });
+
+    expect(prepared).toBeNull();
+  });
+
+  it("delegates action handling to the Discord action handler", async () => {
+    const cfg = {
+      channels: {
+        discord: {
+          token: "Bot token-main",
+        },
+      },
+    } as KlawConfig;
+    const toolContext: ChannelMessageActionContext["toolContext"] = {
+      currentChannelProvider: "discord",
+    };
+    const mediaReadFile = vi.fn(async () => Buffer.from("image"));
+    const mediaAccess: NonNullable<ChannelMessageActionContext["mediaAccess"]> = {
+      localRoots: ["/tmp/media"],
+      readFile: mediaReadFile,
+    };
+    const mediaLocalRoots = ["/tmp/media"];
+
+    await discordMessageActions.handleAction?.({
+      channel: "discord",
+      action: "send",
+      params: { to: "channel:123", message: "hello" },
+      cfg,
+      accountId: "ops",
+      requesterSenderId: "user-1",
+      toolContext,
+      mediaAccess,
+      mediaLocalRoots,
+      mediaReadFile,
+    });
+
+    expect(handleDiscordMessageActionMock).toHaveBeenCalledWith({
+      action: "send",
+      params: { to: "channel:123", message: "hello" },
+      cfg,
+      accountId: "ops",
+      requesterSenderId: "user-1",
+      toolContext,
+      mediaAccess,
+      mediaLocalRoots,
+      mediaReadFile,
+    });
+  });
+});