feat: add Signal provider support

src/commands/agent.ts

@@ -415,6 +415,7 @@ export async function agentCommand(
   const whatsappTarget = opts.to ? normalizeE164(opts.to) : allowFrom[0];
   const telegramTarget = opts.to?.trim() || undefined;
   const discordTarget = opts.to?.trim() || undefined;
+  const signalTarget = opts.to?.trim() || undefined;
 
   const logDeliveryError = (err: unknown) => {
     const deliveryTarget =
@@ -424,6 +425,8 @@ export async function agentCommand(
           ? whatsappTarget
           : deliveryProvider === "discord"
             ? discordTarget
+            : deliveryProvider === "signal"
+              ? signalTarget
             : undefined;
     const message = `Delivery failed (${deliveryProvider}${deliveryTarget ? ` to ${deliveryTarget}` : ""}): ${String(err)}`;
     runtime.error?.(message);
@@ -450,6 +453,13 @@ export async function agentCommand(
       if (!bestEffortDeliver) throw err;
       logDeliveryError(err);
     }
+    if (deliveryProvider === "signal" && !signalTarget) {
+      const err = new Error(
+        "Delivering to Signal requires --to <E.164|group:ID|signal:+E.164>",
+      );
+      if (!bestEffortDeliver) throw err;
+      logDeliveryError(err);
+    }
     if (deliveryProvider === "webchat") {
       const err = new Error(
         "Delivering to WebChat is not supported via `clawdis agent`; use WhatsApp/Telegram or run with --deliver=false.",
@@ -461,6 +471,7 @@ export async function agentCommand(
       deliveryProvider !== "whatsapp" &&
       deliveryProvider !== "telegram" &&
       deliveryProvider !== "discord" &&
+      deliveryProvider !== "signal" &&
       deliveryProvider !== "webchat"
     ) {
       const err = new Error(`Unknown provider: ${deliveryProvider}`);
@@ -574,5 +585,36 @@ export async function agentCommand(
         logDeliveryError(err);
       }
     }
+
+    if (deliveryProvider === "signal" && signalTarget) {
+      try {
+        if (media.length === 0) {
+          await deps.sendMessageSignal(signalTarget, text, {
+            maxBytes: cfg.signal?.mediaMaxMb
+              ? cfg.signal.mediaMaxMb * 1024 * 1024
+              : cfg.agent?.mediaMaxMb
+                ? cfg.agent.mediaMaxMb * 1024 * 1024
+                : undefined,
+          });
+        } else {
+          let first = true;
+          for (const url of media) {
+            const caption = first ? text : "";
+            first = false;
+            await deps.sendMessageSignal(signalTarget, caption, {
+              mediaUrl: url,
+              maxBytes: cfg.signal?.mediaMaxMb
+                ? cfg.signal.mediaMaxMb * 1024 * 1024
+                : cfg.agent?.mediaMaxMb
+                  ? cfg.agent.mediaMaxMb * 1024 * 1024
+                  : undefined,
+            });
+          }
+        }
+      } catch (err) {
+        if (!bestEffortDeliver) throw err;
+        logDeliveryError(err);
+      }
+    }
   }
 }

src/commands/send.test.ts

@@ -35,6 +35,7 @@ const makeDeps = (overrides: Partial<CliDeps> = {}): CliDeps => ({
   sendMessageWhatsApp: vi.fn(),
   sendMessageTelegram: vi.fn(),
   sendMessageDiscord: vi.fn(),
+  sendMessageSignal: vi.fn(),
   ...overrides,
 });
 
@@ -106,6 +107,23 @@ describe("sendCommand", () => {
     expect(deps.sendMessageWhatsApp).not.toHaveBeenCalled();
   });
 
+  it("routes to signal provider", async () => {
+    const deps = makeDeps({
+      sendMessageSignal: vi.fn().mockResolvedValue({ messageId: "s1" }),
+    });
+    await sendCommand(
+      { to: "+15551234567", message: "hi", provider: "signal" },
+      deps,
+      runtime,
+    );
+    expect(deps.sendMessageSignal).toHaveBeenCalledWith(
+      "+15551234567",
+      "hi",
+      expect.objectContaining({ mediaUrl: undefined }),
+    );
+    expect(deps.sendMessageWhatsApp).not.toHaveBeenCalled();
+  });
+
   it("emits json output", async () => {
     callGatewayMock.mockResolvedValueOnce({ messageId: "direct2" });
     const deps = makeDeps();

src/commands/send.ts

@@ -82,6 +82,31 @@ export async function sendCommand(
     return;
   }
 
+  if (provider === "signal") {
+    const result = await deps.sendMessageSignal(opts.to, opts.message, {
+      mediaUrl: opts.media,
+    });
+    runtime.log(
+      success(`✅ Sent via signal. Message ID: ${result.messageId}`),
+    );
+    if (opts.json) {
+      runtime.log(
+        JSON.stringify(
+          {
+            provider: "signal",
+            via: "direct",
+            to: opts.to,
+            messageId: result.messageId,
+            mediaUrl: opts.media ?? null,
+          },
+          null,
+          2,
+        ),
+      );
+    }
+    return;
+  }
+
   // Always send via gateway over WS to avoid multi-session corruption.
   const sendViaGateway = async () =>
     callGateway<{
@@ -93,6 +118,7 @@ export async function sendCommand(
         to: opts.to,
         message: opts.message,
         mediaUrl: opts.media,
+        provider,
         idempotencyKey: randomIdempotencyKey(),
       },
       timeoutMs: 10_000,