feat: Add WhatsApp poll support (#248)

Implements issue #123 - WhatsApp Poll Support

## Gateway Protocol
- Add `poll` RPC method with params: to, question, options (2-12), selectableCount

## ActiveWebListener
- Add `sendPoll(to, poll)` method to interface
- Implementation uses Baileys poll message type

## CLI Command
- `clawdbot poll --to <jid> -q <question> -o <opt1> -o <opt2> [-s count]`
- Supports --dry-run, --json, --verbose flags
- Validates 2-12 options

## Changes
- src/gateway/protocol/schema.ts: Add PollParamsSchema
- src/gateway/protocol/index.ts: Export validator and types
- src/web/active-listener.ts: Add sendPoll to interface
- src/web/inbound.ts: Implement sendPoll using Baileys
- src/web/outbound.ts: Add sendPollWhatsApp function
- src/gateway/server-methods/send.ts: Add poll handler
- src/commands/poll.ts: New CLI command
- src/cli/program.ts: Register poll command

Closes #123

src/gateway/server-methods/send.ts

@@ -6,11 +6,12 @@ import { sendMessageSignal } from "../../signal/index.js";
 import { sendMessageSlack } from "../../slack/send.js";
 import { sendMessageTelegram } from "../../telegram/send.js";
 import { resolveTelegramToken } from "../../telegram/token.js";
-import { sendMessageWhatsApp } from "../../web/outbound.js";
+import { sendMessageWhatsApp, sendPollWhatsApp } from "../../web/outbound.js";
 import {
   ErrorCodes,
   errorShape,
   formatValidationErrors,
+  validatePollParams,
   validateSendParams,
 } from "../protocol/index.js";
 import { formatForLog } from "../ws-log.js";
@@ -178,4 +179,69 @@ export const sendHandlers: GatewayRequestHandlers = {
       });
     }
   },
+
+  poll: async ({ params, respond, context }) => {
+    const p = params as Record<string, unknown>;
+    if (!validatePollParams(p)) {
+      respond(
+        false,
+        undefined,
+        errorShape(
+          ErrorCodes.INVALID_REQUEST,
+          `invalid poll params: ${formatValidationErrors(validatePollParams.errors)}`,
+        ),
+      );
+      return;
+    }
+    const request = p as {
+      to: string;
+      question: string;
+      options: string[];
+      selectableCount?: number;
+      idempotencyKey: string;
+    };
+    const idem = request.idempotencyKey;
+    const cached = context.dedupe.get(`poll:${idem}`);
+    if (cached) {
+      respond(cached.ok, cached.payload, cached.error, {
+        cached: true,
+      });
+      return;
+    }
+    const to = request.to.trim();
+    const question = request.question.trim();
+    const options = request.options.map((o) => o.trim());
+    const selectableCount = request.selectableCount ?? 1;
+
+    try {
+      const result = await sendPollWhatsApp(
+        to,
+        { question, options, selectableCount },
+        { verbose: shouldLogVerbose() },
+      );
+      const payload = {
+        runId: idem,
+        messageId: result.messageId,
+        toJid: result.toJid ?? `${to}@s.whatsapp.net`,
+        provider: "whatsapp",
+      };
+      context.dedupe.set(`poll:${idem}`, {
+        ts: Date.now(),
+        ok: true,
+        payload,
+      });
+      respond(true, payload, undefined, { provider: "whatsapp" });
+    } catch (err) {
+      const error = errorShape(ErrorCodes.UNAVAILABLE, String(err));
+      context.dedupe.set(`poll:${idem}`, {
+        ts: Date.now(),
+        ok: false,
+        error,
+      });
+      respond(false, undefined, error, {
+        provider: "whatsapp",
+        error: formatForLog(err),
+      });
+    }
+  },
 };