@elizaos/plugin-whatsapp 2.0.0-alpha.9 → 2.0.0-beta.1

package/dist/accounts.d.ts

@@ -0,0 +1,205 @@
+import type { IAgentRuntime } from "@elizaos/core";
+/**
+ * Default account identifier used when no specific account is configured
+ */
+export declare const DEFAULT_ACCOUNT_ID = "default";
+/**
+ * Token source indicator
+ */
+export type WhatsAppTokenSource = "config" | "env" | "character" | "none";
+/**
+ * Group-specific runtime configuration (for account resolution)
+ */
+export interface WhatsAppGroupRuntimeConfig {
+    /** If false, ignore messages from this group */
+    enabled?: boolean;
+    /** Allowlist for users in this group */
+    allowFrom?: Array<string | number>;
+    /** Require bot mention to respond */
+    requireMention?: boolean;
+    /** Custom system prompt for this group */
+    systemPrompt?: string;
+    /** Skills enabled for this group */
+    skills?: string[];
+}
+/**
+ * Configuration for a single WhatsApp account (runtime resolution)
+ */
+export interface WhatsAppAccountRuntimeConfig {
+    /** Optional display name for this account */
+    name?: string;
+    /** If false, do not start this WhatsApp account */
+    enabled?: boolean;
+    /** Transport implementation for this account */
+    transport?: "cloudapi" | "baileys";
+    /** Baileys auth/session directory */
+    authDir?: string;
+    /** WhatsApp Cloud API access token */
+    accessToken?: string;
+    /** Phone number ID from WhatsApp Business */
+    phoneNumberId?: string;
+    /** Business account ID */
+    businessAccountId?: string;
+    /** Webhook verification token */
+    webhookVerifyToken?: string;
+    /** API version to use */
+    apiVersion?: string;
+    /** Allowlist for DM senders */
+    allowFrom?: Array<string | number>;
+    /** Allowlist for groups */
+    groupAllowFrom?: Array<string | number>;
+    /** DM access policy */
+    dmPolicy?: "open" | "allowlist" | "pairing" | "disabled";
+    /** Group message access policy */
+    groupPolicy?: "open" | "allowlist" | "disabled";
+    /** Max media size in MB */
+    mediaMaxMb?: number;
+    /** Text chunk limit for messages */
+    textChunkLimit?: number;
+    /** Group-specific configurations */
+    groups?: Record<string, WhatsAppGroupRuntimeConfig>;
+}
+/**
+ * Multi-account WhatsApp configuration structure
+ */
+export interface WhatsAppMultiAccountConfig {
+    /** Default/base configuration applied to all accounts */
+    enabled?: boolean;
+    transport?: "cloudapi" | "baileys";
+    authDir?: string;
+    accessToken?: string;
+    phoneNumberId?: string;
+    businessAccountId?: string;
+    webhookVerifyToken?: string;
+    apiVersion?: string;
+    dmPolicy?: "open" | "allowlist" | "pairing" | "disabled";
+    groupPolicy?: "open" | "allowlist" | "disabled";
+    mediaMaxMb?: number;
+    textChunkLimit?: number;
+    /** Per-account configuration overrides */
+    accounts?: Record<string, WhatsAppAccountRuntimeConfig>;
+    /** Group configurations at base level */
+    groups?: Record<string, WhatsAppGroupRuntimeConfig>;
+}
+/**
+ * Token resolution result
+ */
+export interface WhatsAppTokenResolution {
+    token: string;
+    source: WhatsAppTokenSource;
+}
+/**
+ * Resolved WhatsApp account with all configuration merged
+ */
+export interface ResolvedWhatsAppAccount {
+    accountId: string;
+    enabled: boolean;
+    name?: string;
+    accessToken: string;
+    phoneNumberId: string;
+    businessAccountId?: string;
+    tokenSource: WhatsAppTokenSource;
+    configured: boolean;
+    config: WhatsAppAccountRuntimeConfig;
+}
+/**
+ * Normalizes an account ID, returning the default if not provided
+ */
+export declare function normalizeAccountId(accountId?: string | null): string;
+/**
+ * Gets the multi-account configuration from runtime settings
+ */
+export declare function getMultiAccountConfig(runtime: IAgentRuntime): WhatsAppMultiAccountConfig;
+/**
+ * Lists all configured account IDs
+ */
+export declare function listWhatsAppAccountIds(runtime: IAgentRuntime): string[];
+/**
+ * Resolves the default account ID to use
+ */
+export declare function resolveDefaultWhatsAppAccountId(runtime: IAgentRuntime): string;
+/**
+ * Resolves the access token for a WhatsApp account
+ */
+export declare function resolveWhatsAppToken(runtime: IAgentRuntime, accountId: string): WhatsAppTokenResolution;
+/**
+ * Resolves a complete WhatsApp account configuration
+ */
+export declare function resolveWhatsAppAccount(runtime: IAgentRuntime, accountId?: string | null): ResolvedWhatsAppAccount;
+/**
+ * Lists all enabled WhatsApp accounts
+ */
+export declare function listEnabledWhatsAppAccounts(runtime: IAgentRuntime): ResolvedWhatsAppAccount[];
+/**
+ * Checks if multi-account mode is enabled
+ */
+export declare function isMultiAccountEnabled(runtime: IAgentRuntime): boolean;
+/**
+ * Resolves group configuration for a specific group
+ */
+export declare function resolveWhatsAppGroupConfig(runtime: IAgentRuntime, accountId: string, groupId: string): WhatsAppGroupRuntimeConfig | undefined;
+/**
+ * Checks if a user is allowed based on policy and allowlist
+ */
+export declare function isWhatsAppUserAllowed(params: {
+    identifier: string;
+    accountConfig: WhatsAppAccountRuntimeConfig;
+    isGroup: boolean;
+    groupId?: string;
+    groupConfig?: WhatsAppGroupRuntimeConfig;
+}): boolean;
+/**
+ * Checks if mention is required in a group
+ */
+export declare function isWhatsAppMentionRequired(params: {
+    accountConfig: WhatsAppAccountRuntimeConfig;
+    groupConfig?: WhatsAppGroupRuntimeConfig;
+}): boolean;
+/**
+ * Result of an async WhatsApp access check
+ */
+export interface WhatsAppAccessCheckResult {
+    /** Whether the sender is allowed to proceed */
+    allowed: boolean;
+    /** If not allowed (pairing policy), the pairing code */
+    pairingCode?: string;
+    /** Whether a new pairing request was created */
+    newPairingRequest?: boolean;
+    /** Human-readable message to send to the user when blocked */
+    replyMessage?: string;
+}
+/**
+ * Checks if a user is allowed based on policy and allowlist, with async pairing support.
+ *
+ * For non-pairing policies, this behaves identically to `isWhatsAppUserAllowed`.
+ * For the "pairing" policy, this actually checks the PairingService allowlist
+ * and creates pairing requests when needed.
+ *
+ * @example
+ * ```typescript
+ * const result = await checkWhatsAppUserAccess({
+ *   runtime,
+ *   identifier: message.from,
+ *   accountConfig,
+ *   isGroup: false,
+ *   metadata: { name: contact.name },
+ * });
+ *
+ * if (!result.allowed) {
+ *   if (result.replyMessage) {
+ *     await sendMessage(result.replyMessage);
+ *   }
+ *   return; // Block message processing
+ * }
+ * ```
+ */
+export declare function checkWhatsAppUserAccess(params: {
+    runtime: IAgentRuntime;
+    identifier: string;
+    accountConfig: WhatsAppAccountRuntimeConfig;
+    isGroup: boolean;
+    groupId?: string;
+    groupConfig?: WhatsAppGroupRuntimeConfig;
+    metadata?: Record<string, string>;
+}): Promise<WhatsAppAccessCheckResult>;
+//# sourceMappingURL=accounts.d.ts.map

package/dist/accounts.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"accounts.d.ts","sourceRoot":"","sources":["../src/accounts.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAGnD;;GAEG;AACH,eAAO,MAAM,kBAAkB,YAAY,CAAC;AAE5C;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,QAAQ,GAAG,KAAK,GAAG,WAAW,GAAG,MAAM,CAAC;AAE1E;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,gDAAgD;IAChD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,wCAAwC;IACxC,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnC,qCAAqC;IACrC,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,0CAA0C;IAC1C,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,4BAA4B;IAC3C,6CAA6C;IAC7C,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,mDAAmD;IACnD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gDAAgD;IAChD,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,qCAAqC;IACrC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,sCAAsC;IACtC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,6CAA6C;IAC7C,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,0BAA0B;IAC1B,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,iCAAiC;IACjC,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,yBAAyB;IACzB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,+BAA+B;IAC/B,SAAS,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACnC,2BAA2B;IAC3B,cAAc,CAAC,EAAE,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,CAAC;IACxC,uBAAuB;IACvB,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IACzD,kCAAkC;IAClC,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAChD,2BAA2B;IAC3B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oCAAoC;IACpC,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,oCAAoC;IACpC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,yDAAyD;IACzD,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,SAAS,CAAC,EAAE,UAAU,GAAG,SAAS,CAAC;IACnC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,SAAS,GAAG,UAAU,CAAC;IACzD,WAAW,CAAC,EAAE,MAAM,GAAG,WAAW,GAAG,UAAU,CAAC;IAChD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,0CAA0C;IAC1C,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,4BAA4B,CAAC,CAAC;IACxD,yCAAyC;IACzC,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;CACrD;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,mBAAmB,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,WAAW,uBAAuB;IACtC,SAAS,EAAE,MAAM,CAAC;IAClB,OAAO,EAAE,OAAO,CAAC;IACjB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,WAAW,EAAE,mBAAmB,CAAC;IACjC,UAAU,EAAE,OAAO,CAAC;IACpB,MAAM,EAAE,4BAA4B,CAAC;CACtC;AAED;;GAEG;AACH,wBAAgB,kBAAkB,CAAC,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CASpE;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,0BAA0B,CAqBxF;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,EAAE,CAmCvE;AAED;;GAEG;AACH,wBAAgB,+BAA+B,CAAC,OAAO,EAAE,aAAa,GAAG,MAAM,CAM9E;AA4BD;;GAEG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,GAChB,uBAAuB,CAuBzB;AAoDD;;GAEG;AACH,wBAAgB,sBAAsB,CACpC,OAAO,EAAE,aAAa,EACtB,SAAS,CAAC,EAAE,MAAM,GAAG,IAAI,GACxB,uBAAuB,CA0BzB;AAED;;GAEG;AACH,wBAAgB,2BAA2B,CAAC,OAAO,EAAE,aAAa,GAAG,uBAAuB,EAAE,CAI7F;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,aAAa,GAAG,OAAO,CAGrE;AAED;;GAEG;AACH,wBAAgB,0BAA0B,CACxC,OAAO,EAAE,aAAa,EACtB,SAAS,EAAE,MAAM,EACjB,OAAO,EAAE,MAAM,GACd,0BAA0B,GAAG,SAAS,CAYxC;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,MAAM,EAAE;IAC5C,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,4BAA4B,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,0BAA0B,CAAC;CAC1C,GAAG,OAAO,CA8CV;AAED;;GAEG;AACH,wBAAgB,yBAAyB,CAAC,MAAM,EAAE;IAChD,aAAa,EAAE,4BAA4B,CAAC;IAC5C,WAAW,CAAC,EAAE,0BAA0B,CAAC;CAC1C,GAAG,OAAO,CAGV;AAED;;GAEG;AACH,MAAM,WAAW,yBAAyB;IACxC,+CAA+C;IAC/C,OAAO,EAAE,OAAO,CAAC;IACjB,wDAAwD;IACxD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,gDAAgD;IAChD,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B,8DAA8D;IAC9D,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,uBAAuB,CAAC,MAAM,EAAE;IACpD,OAAO,EAAE,aAAa,CAAC;IACvB,UAAU,EAAE,MAAM,CAAC;IACnB,aAAa,EAAE,4BAA4B,CAAC;IAC5C,OAAO,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,0BAA0B,CAAC;IACzC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC,GAAG,OAAO,CAAC,yBAAyB,CAAC,CAkErC"}

package/dist/actions/index.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=index.d.ts.map

package/dist/actions/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/actions/index.ts"],"names":[],"mappings":""}

package/dist/api/whatsapp-routes.d.ts

@@ -0,0 +1,53 @@
+import type { IncomingMessage, ServerResponse } from "node:http";
+import type { WhatsAppPairingEvent } from "../services/whatsapp-pairing.js";
+export type WhatsAppPairingEventLike = WhatsAppPairingEvent;
+export interface WhatsAppPairingSessionLike {
+    start(): Promise<void>;
+    stop(): void;
+    getStatus(): string;
+}
+export interface WhatsAppRouteState {
+    whatsappPairingSessions: Map<string, WhatsAppPairingSessionLike>;
+    broadcastWs?: (data: object) => void;
+    config: WhatsAppPluginConfig;
+    runtime?: {
+        getService(type: string): unknown | null;
+    };
+    saveConfig: () => void;
+    workspaceDir: string;
+}
+type OwnerContactEntry = {
+    entityId?: string;
+    channelId?: string;
+    roomId?: string;
+};
+type WhatsAppPluginConfig = Record<string, unknown> & {
+    connectors?: Record<string, unknown>;
+    agents?: {
+        defaults?: {
+            ownerContacts?: Record<string, OwnerContactEntry>;
+            [key: string]: unknown;
+        };
+        [key: string]: unknown;
+    };
+};
+export interface WhatsAppRouteDeps {
+    sanitizeAccountId: (accountId: string) => string;
+    whatsappAuthExists: (workspaceDir: string, accountId: string) => boolean;
+    whatsappLogout: (workspaceDir: string, accountId: string) => Promise<void>;
+    createWhatsAppPairingSession: (options: {
+        authDir: string;
+        accountId: string;
+        onEvent: (event: WhatsAppPairingEventLike) => void;
+    }) => WhatsAppPairingSessionLike;
+}
+export declare const MAX_PAIRING_SESSIONS = 10;
+export declare function handleWhatsAppRoute(req: IncomingMessage, res: ServerResponse, pathname: string, method: string, state: WhatsAppRouteState, deps: WhatsAppRouteDeps): Promise<boolean>;
+export declare function applyWhatsAppQrOverride(plugins: {
+    id: string;
+    validationErrors: unknown[];
+    configured: boolean;
+    qrConnected?: boolean;
+}[], workspaceDir: string): void;
+export {};
+//# sourceMappingURL=whatsapp-routes.d.ts.map

package/dist/api/whatsapp-routes.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"whatsapp-routes.d.ts","sourceRoot":"","sources":["../../src/api/whatsapp-routes.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjE,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,iCAAiC,CAAC;AAE5E,MAAM,MAAM,wBAAwB,GAAG,oBAAoB,CAAC;AAE5D,MAAM,WAAW,0BAA0B;IACzC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,IAAI,CAAC;IACb,SAAS,IAAI,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,kBAAkB;IACjC,uBAAuB,EAAE,GAAG,CAAC,MAAM,EAAE,0BAA0B,CAAC,CAAC;IACjE,WAAW,CAAC,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,IAAI,CAAC;IACrC,MAAM,EAAE,oBAAoB,CAAC;IAC7B,OAAO,CAAC,EAAE;QACR,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC;KAC1C,CAAC;IACF,UAAU,EAAE,MAAM,IAAI,CAAC;IACvB,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,KAAK,iBAAiB,GAAG;IACvB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,MAAM,CAAC,EAAE;QACP,QAAQ,CAAC,EAAE;YACT,aAAa,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;YAClD,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;SACxB,CAAC;QACF,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;KACxB,CAAC;CACH,CAAC;AAEF,MAAM,WAAW,iBAAiB;IAChC,iBAAiB,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,MAAM,CAAC;IACjD,kBAAkB,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC;IACzE,cAAc,EAAE,CAAC,YAAY,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,KAAK,OAAO,CAAC,IAAI,CAAC,CAAC;IAC3E,4BAA4B,EAAE,CAAC,OAAO,EAAE;QACtC,OAAO,EAAE,MAAM,CAAC;QAChB,SAAS,EAAE,MAAM,CAAC;QAClB,OAAO,EAAE,CAAC,KAAK,EAAE,wBAAwB,KAAK,IAAI,CAAC;KACpD,KAAK,0BAA0B,CAAC;CAClC;AAWD,eAAO,MAAM,oBAAoB,KAAK,CAAC;AAiHvC,wBAAsB,mBAAmB,CACvC,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,KAAK,EAAE,kBAAkB,EACzB,IAAI,EAAE,iBAAiB,GACtB,OAAO,CAAC,OAAO,CAAC,CA6QlB;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE;IACP,EAAE,EAAE,MAAM,CAAC;IACX,gBAAgB,EAAE,OAAO,EAAE,CAAC;IAC5B,UAAU,EAAE,OAAO,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB,EAAE,EACH,YAAY,EAAE,MAAM,GACnB,IAAI,CAcN"}

package/dist/baileys/auth.d.ts

@@ -0,0 +1,10 @@
+import type { AuthenticationState } from "@whiskeysockets/baileys";
+export declare class BaileysAuthManager {
+    private readonly authDir;
+    private state?;
+    private saveCreds?;
+    constructor(authDir: string);
+    initialize(): Promise<AuthenticationState>;
+    save(): Promise<void>;
+}
+//# sourceMappingURL=auth.d.ts.map

package/dist/baileys/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../../src/baileys/auth.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,yBAAyB,CAAC;AAGnE,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;IACjC,OAAO,CAAC,KAAK,CAAC,CAAsB;IACpC,OAAO,CAAC,SAAS,CAAC,CAAsB;gBAE5B,OAAO,EAAE,MAAM;IAIrB,UAAU,IAAI,OAAO,CAAC,mBAAmB,CAAC;IAO1C,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;CAK5B"}

package/dist/baileys/connection.d.ts

@@ -0,0 +1,19 @@
+import { EventEmitter } from "node:events";
+import { type WASocket } from "@whiskeysockets/baileys";
+import type { ConnectionStatus } from "../types";
+import type { BaileysAuthManager } from "./auth";
+export declare class BaileysConnection extends EventEmitter {
+    private socket?;
+    private readonly authManager;
+    private connectionStatus;
+    private reconnecting;
+    private reconnectAttempts;
+    private readonly maxReconnectAttempts;
+    constructor(authManager: BaileysAuthManager);
+    connect(): Promise<WASocket>;
+    private setupEventHandlers;
+    getSocket(): WASocket | undefined;
+    getStatus(): ConnectionStatus;
+    disconnect(): Promise<void>;
+}
+//# sourceMappingURL=connection.d.ts.map

package/dist/baileys/connection.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"connection.d.ts","sourceRoot":"","sources":["../../src/baileys/connection.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,OAAqB,EAAoB,KAAK,QAAQ,EAAE,MAAM,yBAAyB,CAAC;AAExF,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,UAAU,CAAC;AACjD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,QAAQ,CAAC;AAEjD,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,OAAO,CAAC,MAAM,CAAC,CAAW;IAC1B,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,gBAAgB,CAA6B;IACrD,OAAO,CAAC,YAAY,CAAS;IAC7B,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,QAAQ,CAAC,oBAAoB,CAAM;gBAE/B,WAAW,EAAE,kBAAkB;IAKrC,OAAO,IAAI,OAAO,CAAC,QAAQ,CAAC;IAgBlC,OAAO,CAAC,kBAAkB;IAsE1B,SAAS,IAAI,QAAQ,GAAG,SAAS;IAIjC,SAAS,IAAI,gBAAgB;IAIvB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;CAelC"}

package/dist/baileys/message-adapter.d.ts

@@ -0,0 +1,14 @@
+import type { proto } from "@whiskeysockets/baileys";
+import type { NormalizedMessage, WhatsAppMessage } from "../types";
+export declare class MessageAdapter {
+    toNormalized(msg: proto.IWebMessageInfo): NormalizedMessage;
+    toBaileys(msg: WhatsAppMessage): Record<string, unknown>;
+    private mediaWithCaption;
+    private mediaNoCaption;
+    private mediaWithFilename;
+    private detectType;
+    private extractContent;
+    private extractReplyToId;
+    private renderTemplate;
+}
+//# sourceMappingURL=message-adapter.d.ts.map

package/dist/baileys/message-adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"message-adapter.d.ts","sourceRoot":"","sources":["../../src/baileys/message-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,yBAAyB,CAAC;AACrD,OAAO,KAAK,EACV,iBAAiB,EAEjB,eAAe,EAEhB,MAAM,UAAU,CAAC;AAElB,qBAAa,cAAc;IACzB,YAAY,CAAC,GAAG,EAAE,KAAK,CAAC,eAAe,GAAG,iBAAiB;IAgB3D,SAAS,CAAC,GAAG,EAAE,eAAe,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAmBxD,OAAO,CAAC,gBAAgB;IAaxB,OAAO,CAAC,cAAc;IAOtB,OAAO,CAAC,iBAAiB;IAWzB,OAAO,CAAC,UAAU;IAqBlB,OAAO,CAAC,cAAc;IAWtB,OAAO,CAAC,gBAAgB;IAUxB,OAAO,CAAC,cAAc;CAMvB"}

package/dist/baileys/qr-code.d.ts

@@ -0,0 +1,6 @@
+import type { QRCodeData } from "../types";
+export declare class QRCodeGenerator {
+    generate(qrString: string): Promise<QRCodeData>;
+    private generateTerminal;
+}
+//# sourceMappingURL=qr-code.d.ts.map

package/dist/baileys/qr-code.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"qr-code.d.ts","sourceRoot":"","sources":["../../src/baileys/qr-code.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AAE3C,qBAAa,eAAe;IACpB,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC;YAQvC,gBAAgB;CAO/B"}

package/dist/client.d.ts

@@ -0,0 +1,99 @@
+import { EventEmitter } from "node:events";
+import type { IWhatsAppClient } from "./clients/interface";
+import type { CloudAPIConfig, ConnectionStatus, SendReactionParams, SendReactionResult, WhatsAppMessage, WhatsAppMessageResponse } from "./types";
+interface WhatsAppApiResponse<T> {
+    data: T;
+    status: number;
+    statusText: string;
+    headers: Headers;
+}
+export declare class WhatsAppClient extends EventEmitter implements IWhatsAppClient {
+    private baseUrl;
+    private headers;
+    private config;
+    private connectionStatus;
+    constructor(config: CloudAPIConfig);
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    getConnectionStatus(): ConnectionStatus;
+    /**
+     * Get the configured phone number ID.
+     */
+    getPhoneNumberId(): string;
+    /**
+     * Send a message of any supported type.
+     */
+    sendMessage(message: WhatsAppMessage): Promise<WhatsAppApiResponse<WhatsAppMessageResponse>>;
+    /**
+     * Send a text message.
+     */
+    sendTextMessage(to: string, text: string, _previewUrl?: boolean): Promise<WhatsAppApiResponse<WhatsAppMessageResponse>>;
+    /**
+     * Send a reaction to a message.
+     */
+    sendReaction(params: SendReactionParams): Promise<SendReactionResult>;
+    /**
+     * Remove a reaction from a message (send empty emoji).
+     */
+    removeReaction(to: string, messageId: string): Promise<SendReactionResult>;
+    /**
+     * Send an image message.
+     */
+    sendImage(to: string, imageUrl: string, caption?: string): Promise<WhatsAppApiResponse<WhatsAppMessageResponse>>;
+    /**
+     * Send a video message.
+     */
+    sendVideo(to: string, videoUrl: string, caption?: string): Promise<WhatsAppApiResponse<WhatsAppMessageResponse>>;
+    /**
+     * Send an audio message.
+     */
+    sendAudio(to: string, audioUrl: string): Promise<WhatsAppApiResponse<WhatsAppMessageResponse>>;
+    /**
+     * Send a document message.
+     */
+    sendDocument(to: string, documentUrl: string, filename?: string, caption?: string): Promise<WhatsAppApiResponse<WhatsAppMessageResponse>>;
+    /**
+     * Send a location message.
+     */
+    sendLocation(to: string, latitude: number, longitude: number, name?: string, address?: string): Promise<WhatsAppApiResponse<WhatsAppMessageResponse>>;
+    /**
+     * Send an interactive button message.
+     */
+    sendButtonMessage(to: string, bodyText: string, buttons: Array<{
+        id: string;
+        title: string;
+    }>, headerText?: string, footerText?: string): Promise<WhatsAppApiResponse<WhatsAppMessageResponse>>;
+    /**
+     * Send an interactive list message.
+     */
+    sendListMessage(to: string, bodyText: string, buttonText: string, sections: Array<{
+        title?: string;
+        rows: Array<{
+            id: string;
+            title: string;
+            description?: string;
+        }>;
+    }>, headerText?: string, footerText?: string): Promise<WhatsAppApiResponse<WhatsAppMessageResponse>>;
+    /**
+     * Mark a message as read.
+     */
+    markMessageAsRead(messageId: string): Promise<boolean>;
+    /**
+     * Download media by ID.
+     */
+    getMediaUrl(mediaId: string): Promise<string | null>;
+    /**
+     * Verify webhook token.
+     */
+    verifyWebhook(token: string): Promise<boolean>;
+    private get;
+    private post;
+    private request;
+    private parseResponseBody;
+    /**
+     * Build the message payload based on message type.
+     */
+    private buildMessagePayload;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/client.d.ts.map

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

package/dist/clients/baileys-client.d.ts

@@ -0,0 +1,18 @@
+import { EventEmitter } from "node:events";
+import type { BaileysConfig, ConnectionStatus, WhatsAppMessage, WhatsAppMessageResponse } from "../types";
+import type { IWhatsAppClient } from "./interface";
+export declare class BaileysClient extends EventEmitter implements IWhatsAppClient {
+    private readonly config;
+    private readonly authManager;
+    private readonly connection;
+    private readonly qrGenerator;
+    private readonly adapter;
+    constructor(config: BaileysConfig);
+    private setupEventForwarding;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendMessage(message: WhatsAppMessage): Promise<WhatsAppMessageResponse>;
+    getConnectionStatus(): ConnectionStatus;
+    getPhoneNumber(): string | null;
+}
+//# sourceMappingURL=baileys-client.d.ts.map

package/dist/clients/baileys-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"baileys-client.d.ts","sourceRoot":"","sources":["../../src/clients/baileys-client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAK3C,OAAO,KAAK,EACV,aAAa,EACb,gBAAgB,EAChB,eAAe,EACf,uBAAuB,EACxB,MAAM,UAAU,CAAC;AAClB,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,qBAAa,aAAc,SAAQ,YAAa,YAAW,eAAe;IACxE,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAgB;IACvC,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAqB;IACjD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;IAC/C,OAAO,CAAC,QAAQ,CAAC,WAAW,CAAkB;IAC9C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAiB;gBAE7B,MAAM,EAAE,aAAa;IAUjC,OAAO,CAAC,oBAAoB;IAyCtB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAItB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAIrB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAoB7E,mBAAmB,IAAI,gBAAgB;IAIvC,cAAc,IAAI,MAAM,GAAG,IAAI;CAGhC"}

package/dist/clients/factory.d.ts

@@ -0,0 +1,6 @@
+import type { WhatsAppConfig } from "../types";
+import type { IWhatsAppClient } from "./interface";
+export declare const ClientFactory: {
+    create(config: WhatsAppConfig): IWhatsAppClient;
+};
+//# sourceMappingURL=factory.d.ts.map

package/dist/clients/factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"factory.d.ts","sourceRoot":"","sources":["../../src/clients/factory.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAiC,cAAc,EAAE,MAAM,UAAU,CAAC;AAG9E,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,aAAa,CAAC;AAEnD,eAAO,MAAM,aAAa;mBACT,cAAc,GAAG,eAAe;CAOhD,CAAC"}

package/dist/clients/interface.d.ts

@@ -0,0 +1,10 @@
+import type { EventEmitter } from "node:events";
+import type { ConnectionStatus, WhatsAppMessage } from "../types";
+export interface IWhatsAppClient extends EventEmitter {
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    sendMessage(message: WhatsAppMessage): Promise<unknown>;
+    verifyWebhook?(token: string): Promise<boolean>;
+    getConnectionStatus(): ConnectionStatus;
+}
+//# sourceMappingURL=interface.d.ts.map

package/dist/clients/interface.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"interface.d.ts","sourceRoot":"","sources":["../../src/clients/interface.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,KAAK,EAAE,gBAAgB,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAElE,MAAM,WAAW,eAAgB,SAAQ,YAAY;IACnD,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACtB,WAAW,CAAC,OAAO,EAAE,eAAe,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACxD,aAAa,CAAC,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAChD,mBAAmB,IAAI,gBAAgB,CAAC;CACzC"}

package/dist/config.d.ts

@@ -0,0 +1,135 @@
+/**
+ * WhatsApp plugin configuration types.
+ *
+ * These types define the configuration schema for the WhatsApp plugin.
+ * Shared base types are imported from @elizaos/core.
+ */
+import type { BlockStreamingCoalesceConfig, ChannelHeartbeatVisibilityConfig, DmConfig, DmPolicy, GroupPolicy, GroupToolPolicyBySenderConfig, GroupToolPolicyConfig, MarkdownConfig } from "@elizaos/core";
+export type WhatsAppActionConfig = {
+    reactions?: boolean;
+    sendMessage?: boolean;
+    polls?: boolean;
+};
+export type WhatsAppAckReactionConfig = {
+    /** Emoji to use for acknowledgment (e.g., "👀"). Empty = disabled. */
+    emoji?: string;
+    /** Send reactions in direct chats. Default: true. */
+    direct?: boolean;
+    /**
+     * Send reactions in group chats:
+     * - "always": react to all group messages
+     * - "mentions": react only when bot is mentioned
+     * - "never": never react in groups
+     * Default: "mentions"
+     */
+    group?: "always" | "mentions" | "never";
+};
+export type WhatsAppGroupConfig = {
+    requireMention?: boolean;
+    tools?: GroupToolPolicyConfig;
+    toolsBySender?: GroupToolPolicyBySenderConfig;
+};
+export type WhatsAppAccountConfig = {
+    /** Optional display name for this account (used in CLI/UI lists). */
+    name?: string;
+    /** Optional provider capability tags used for agent/runtime guidance. */
+    capabilities?: string[];
+    /** Markdown formatting overrides (tables). */
+    markdown?: MarkdownConfig;
+    /** Allow channel-initiated config writes (default: true). */
+    configWrites?: boolean;
+    /** If false, do not start this WhatsApp account provider. Default: true. */
+    enabled?: boolean;
+    /** Send read receipts for incoming messages (default true). */
+    sendReadReceipts?: boolean;
+    /** Inbound message prefix override for this account (WhatsApp only). */
+    messagePrefix?: string;
+    /** Override auth directory (Baileys multi-file auth state). */
+    authDir?: string;
+    /** Direct message access policy (default: pairing). */
+    dmPolicy?: DmPolicy;
+    /** Same-phone setup for this account (bot uses your personal WhatsApp number). */
+    selfChatMode?: boolean;
+    allowFrom?: string[];
+    groupAllowFrom?: string[];
+    groupPolicy?: GroupPolicy;
+    /** Max group messages to keep as history context (0 disables). */
+    historyLimit?: number;
+    /** Max DM turns to keep as history context. */
+    dmHistoryLimit?: number;
+    /** Per-DM config overrides keyed by user ID. */
+    dms?: Record<string, DmConfig>;
+    textChunkLimit?: number;
+    /** Chunking mode: "length" (default) splits by size; "newline" splits on every newline. */
+    chunkMode?: "length" | "newline";
+    mediaMaxMb?: number;
+    blockStreaming?: boolean;
+    /** Merge streamed block replies before sending. */
+    blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
+    groups?: Record<string, WhatsAppGroupConfig>;
+    /** Acknowledgment reaction sent immediately upon message receipt. */
+    ackReaction?: WhatsAppAckReactionConfig;
+    /** Debounce window (ms) for batching rapid consecutive messages from the same sender (0 to disable). */
+    debounceMs?: number;
+    /** Heartbeat visibility settings for this account. */
+    heartbeat?: ChannelHeartbeatVisibilityConfig;
+};
+export type WhatsAppChannelConfig = {
+    /** Optional per-account WhatsApp configuration (multi-account). */
+    accounts?: Record<string, WhatsAppAccountConfig>;
+    /** Optional provider capability tags used for agent/runtime guidance. */
+    capabilities?: string[];
+    /** Markdown formatting overrides (tables). */
+    markdown?: MarkdownConfig;
+    /** Allow channel-initiated config writes (default: true). */
+    configWrites?: boolean;
+    /** Send read receipts for incoming messages (default true). */
+    sendReadReceipts?: boolean;
+    /**
+     * Inbound message prefix (WhatsApp only).
+     * Default: `[{agents.list[].identity.name}]` (or `[otto]`) when allowFrom is empty, else `""`.
+     */
+    messagePrefix?: string;
+    /** Direct message access policy (default: pairing). */
+    dmPolicy?: DmPolicy;
+    /** Same-phone setup (bot uses your personal WhatsApp number). */
+    selfChatMode?: boolean;
+    /** Optional allowlist for WhatsApp direct chats (E.164). */
+    allowFrom?: string[];
+    /** Optional allowlist for WhatsApp group senders (E.164). */
+    groupAllowFrom?: string[];
+    /**
+     * Controls how group messages are handled:
+     * - "open": groups bypass allowFrom, only mention-gating applies
+     * - "disabled": block all group messages entirely
+     * - "allowlist": only allow group messages from senders in groupAllowFrom/allowFrom
+     */
+    groupPolicy?: GroupPolicy;
+    /** Max group messages to keep as history context (0 disables). */
+    historyLimit?: number;
+    /** Max DM turns to keep as history context. */
+    dmHistoryLimit?: number;
+    /** Per-DM config overrides keyed by user ID. */
+    dms?: Record<string, DmConfig>;
+    /** Outbound text chunk size (chars). Default: 4000. */
+    textChunkLimit?: number;
+    /** Chunking mode: "length" (default) splits by size; "newline" splits on every newline. */
+    chunkMode?: "length" | "newline";
+    /** Maximum media file size in MB. Default: 50. */
+    mediaMaxMb?: number;
+    /** Disable block streaming for this account. */
+    blockStreaming?: boolean;
+    /** Merge streamed block replies before sending. */
+    blockStreamingCoalesce?: BlockStreamingCoalesceConfig;
+    /** Per-action tool gating (default: true for all). */
+    actions?: WhatsAppActionConfig;
+    groups?: Record<string, WhatsAppGroupConfig>;
+    /** Acknowledgment reaction sent immediately upon message receipt. */
+    ackReaction?: WhatsAppAckReactionConfig;
+    /** Debounce window (ms) for batching rapid consecutive messages from the same sender (0 to disable). */
+    debounceMs?: number;
+    /** Heartbeat visibility settings for this channel. */
+    heartbeat?: ChannelHeartbeatVisibilityConfig;
+};
+export type { WhatsAppChannelConfig as WhatsAppConfig };
+//# sourceMappingURL=config.d.ts.map

package/dist/config.d.ts.map

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