@framers/agentos-ext-channel-whatsapp 0.1.0

package/dist/WhatsAppChannelAdapter.d.ts

@@ -0,0 +1,23 @@
+/**
+ * @fileoverview IChannelAdapter implementation for WhatsApp via Baileys.
+ */
+import type { IChannelAdapter, ChannelPlatform, ChannelCapability, ChannelAuthConfig, ChannelConnectionInfo, ChannelSendResult, MessageContent, ChannelEventHandler, ChannelEventType } from '@framers/agentos';
+import { WhatsAppService } from './WhatsAppService';
+export declare class WhatsAppChannelAdapter implements IChannelAdapter {
+    private readonly service;
+    readonly platform: ChannelPlatform;
+    readonly displayName = "WhatsApp";
+    readonly capabilities: readonly ChannelCapability[];
+    private handlers;
+    private msgHandler;
+    constructor(service: WhatsAppService);
+    initialize(auth: ChannelAuthConfig): Promise<void>;
+    shutdown(): Promise<void>;
+    getConnectionInfo(): ChannelConnectionInfo;
+    sendMessage(conversationId: string, content: MessageContent): Promise<ChannelSendResult>;
+    sendTypingIndicator(conversationId: string, isTyping: boolean): Promise<void>;
+    on(handler: ChannelEventHandler, eventTypes?: ChannelEventType[]): () => void;
+    private handleInboundMessage;
+    private emit;
+}
+//# sourceMappingURL=WhatsAppChannelAdapter.d.ts.map

package/dist/WhatsAppChannelAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhatsAppChannelAdapter.d.ts","sourceRoot":"","sources":["../src/WhatsAppChannelAdapter.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,iBAAiB,EACjB,iBAAiB,EACjB,qBAAqB,EACrB,iBAAiB,EACjB,cAAc,EACd,mBAAmB,EACnB,gBAAgB,EAKjB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,EAAE,eAAe,EAAE,MAAM,mBAAmB,CAAC;AAEpD,qBAAa,sBAAuB,YAAW,eAAe;IAkBhD,OAAO,CAAC,QAAQ,CAAC,OAAO;IAjBpC,QAAQ,CAAC,QAAQ,EAAE,eAAe,CAAc;IAChD,QAAQ,CAAC,WAAW,cAAc;IAClC,QAAQ,CAAC,YAAY,EAAE,SAAS,iBAAiB,EAAE,CAQxC;IAEX,OAAO,CAAC,QAAQ,CAAkE;IAGlF,OAAO,CAAC,UAAU,CAA2D;gBAEhD,OAAO,EAAE,eAAe;IAE/C,UAAU,CAAC,IAAI,EAAE,iBAAiB,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlD,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ/B,iBAAiB,IAAI,qBAAqB;IAMpC,WAAW,CAAC,cAAc,EAAE,MAAM,EAAE,OAAO,EAAE,cAAc,GAAG,OAAO,CAAC,iBAAiB,CAAC;IAgCxF,mBAAmB,CAAC,cAAc,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IAInF,EAAE,CAAC,OAAO,EAAE,mBAAmB,EAAE,UAAU,CAAC,EAAE,gBAAgB,EAAE,GAAG,MAAM,IAAI;IAS7E,OAAO,CAAC,oBAAoB;IAmD5B,OAAO,CAAC,IAAI;CASb"}

package/dist/WhatsAppChannelAdapter.js

@@ -0,0 +1,128 @@
+"use strict";
+/**
+ * @fileoverview IChannelAdapter implementation for WhatsApp via Baileys.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsAppChannelAdapter = void 0;
+class WhatsAppChannelAdapter {
+    constructor(service) {
+        this.service = service;
+        this.platform = 'whatsapp';
+        this.displayName = 'WhatsApp';
+        this.capabilities = [
+            'text',
+            'images',
+            'audio',
+            'documents',
+            'typing_indicator',
+            'read_receipts',
+            'group_chat',
+        ];
+        this.handlers = new Map();
+        // Baileys is an optional peer dependency. Keep types loose so this package can
+        // compile in environments where Baileys isn't installed.
+        this.msgHandler = null;
+    }
+    async initialize(auth) {
+        // Service is initialized by the extension pack lifecycle, but
+        // if called directly (e.g., standalone usage), we wire up here.
+        this.msgHandler = (message, isGroup) => this.handleInboundMessage(message, isGroup);
+        this.service.onMessage(this.msgHandler);
+    }
+    async shutdown() {
+        if (this.msgHandler) {
+            this.service.offMessage(this.msgHandler);
+            this.msgHandler = null;
+        }
+        this.handlers.clear();
+    }
+    getConnectionInfo() {
+        return {
+            status: this.service.isRunning ? 'connected' : 'disconnected',
+        };
+    }
+    async sendMessage(conversationId, content) {
+        const textBlock = content.blocks.find((b) => b.type === 'text');
+        const imageBlock = content.blocks.find((b) => b.type === 'image');
+        const documentBlock = content.blocks.find((b) => b.type === 'document');
+        let messageId;
+        if (imageBlock && imageBlock.type === 'image') {
+            const result = await this.service.sendImage(conversationId, imageBlock.url, imageBlock.caption ?? (textBlock?.type === 'text' ? textBlock.text : undefined));
+            messageId = result.key.id;
+        }
+        else if (documentBlock && documentBlock.type === 'document') {
+            const result = await this.service.sendDocument(conversationId, documentBlock.url, documentBlock.filename);
+            messageId = result.key.id;
+        }
+        else {
+            const text = textBlock?.type === 'text' ? textBlock.text : '';
+            const result = await this.service.sendMessage(conversationId, text, {
+                quotedMessageId: content.replyToMessageId ?? undefined,
+            });
+            messageId = result.key.id;
+        }
+        return { messageId, timestamp: new Date().toISOString() };
+    }
+    async sendTypingIndicator(conversationId, isTyping) {
+        await this.service.sendPresenceUpdate(conversationId, isTyping ? 'composing' : 'paused');
+    }
+    on(handler, eventTypes) {
+        this.handlers.set(handler, eventTypes);
+        return () => {
+            this.handlers.delete(handler);
+        };
+    }
+    // ── Private ──
+    handleInboundMessage(msg, isGroup) {
+        const jid = msg.key.remoteJid ?? '';
+        const participantJid = msg.key.participant ?? jid;
+        // Extract the text content from the message
+        const textContent = msg.message?.conversation ??
+            msg.message?.extendedTextMessage?.text ??
+            msg.message?.imageMessage?.caption ??
+            '';
+        // Extract sender information
+        const pushName = msg.pushName ?? undefined;
+        const senderNumber = participantJid.replace(/@s\.whatsapp\.net$/, '').replace(/@.*$/, '');
+        const sender = {
+            id: participantJid,
+            displayName: pushName,
+            username: senderNumber,
+        };
+        const conversationType = isGroup ? 'group' : 'direct';
+        const timestamp = typeof msg.messageTimestamp === 'number'
+            ? msg.messageTimestamp
+            : Number(msg.messageTimestamp ?? Math.floor(Date.now() / 1000));
+        const channelMessage = {
+            messageId: msg.key.id ?? '',
+            platform: 'whatsapp',
+            conversationId: jid,
+            conversationType,
+            sender,
+            content: [{ type: 'text', text: textContent }],
+            text: textContent,
+            timestamp: new Date(timestamp * 1000).toISOString(),
+            replyToMessageId: msg.message?.extendedTextMessage?.contextInfo?.stanzaId ?? undefined,
+            rawEvent: msg,
+        };
+        const event = {
+            type: 'message',
+            platform: 'whatsapp',
+            conversationId: jid,
+            timestamp: channelMessage.timestamp,
+            data: channelMessage,
+        };
+        this.emit(event);
+    }
+    emit(event) {
+        for (const [handler, filter] of this.handlers) {
+            if (!filter || filter.includes(event.type)) {
+                Promise.resolve(handler(event)).catch((err) => {
+                    console.error('[WhatsAppChannelAdapter] Handler error:', err);
+                });
+            }
+        }
+    }
+}
+exports.WhatsAppChannelAdapter = WhatsAppChannelAdapter;
+//# sourceMappingURL=WhatsAppChannelAdapter.js.map

package/dist/WhatsAppChannelAdapter.js.map

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

package/dist/WhatsAppService.d.ts

@@ -0,0 +1,60 @@
+/**
+ * @fileoverview WhatsApp SDK wrapper using @whiskeysockets/baileys.
+ * Handles socket lifecycle, message sending, and rate limiting.
+ */
+type WAMessage = any;
+export interface WhatsAppChannelConfig {
+    sessionData: string;
+    phoneNumber?: string;
+    reconnect?: {
+        maxRetries: number;
+        delayMs: number;
+    };
+    rateLimit?: {
+        maxRequests: number;
+        windowMs: number;
+    };
+}
+type MessageHandler = (message: WAMessage, isGroup: boolean) => void;
+export declare class WhatsAppService {
+    private sock;
+    private running;
+    private messageHandlers;
+    private rateMap;
+    private readonly config;
+    constructor(config: WhatsAppChannelConfig);
+    initialize(): Promise<void>;
+    shutdown(): Promise<void>;
+    get isRunning(): boolean;
+    onMessage(handler: MessageHandler): void;
+    offMessage(handler: MessageHandler): void;
+    sendMessage(jid: string, text: string, options?: {
+        quotedMessageId?: string;
+    }): Promise<{
+        key: {
+            id: string;
+        };
+        messageTimestamp: number;
+    }>;
+    sendImage(jid: string, url: string, caption?: string): Promise<{
+        key: {
+            id: string;
+        };
+    }>;
+    sendDocument(jid: string, url: string, filename?: string): Promise<{
+        key: {
+            id: string;
+        };
+    }>;
+    sendPresenceUpdate(jid: string, type: 'composing' | 'paused'): Promise<void>;
+    /**
+     * Determines whether a JID represents a group conversation.
+     * Groups end with `@g.us`, DMs end with `@s.whatsapp.net`.
+     */
+    isGroupJid(jid: string): boolean;
+    private ensureSocket;
+    private parseSessionData;
+    private checkRateLimit;
+}
+export {};
+//# sourceMappingURL=WhatsAppService.d.ts.map

package/dist/WhatsAppService.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"WhatsAppService.d.ts","sourceRoot":"","sources":["../src/WhatsAppService.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAuBH,KAAK,SAAS,GAAG,GAAG,CAAC;AAGrB,MAAM,WAAW,qBAAqB;IACpC,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,SAAS,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CACvD;AAOD,KAAK,cAAc,GAAG,CAAC,OAAO,EAAE,SAAS,EAAE,OAAO,EAAE,OAAO,KAAK,IAAI,CAAC;AAErE,qBAAa,eAAe;IAC1B,OAAO,CAAC,IAAI,CAAyB;IACrC,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,eAAe,CAA6B;IACpD,OAAO,CAAC,OAAO,CAAgC;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAEG;gBAEd,MAAM,EAAE,qBAAqB;IAQnC,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IA4D3B,QAAQ,IAAI,OAAO,CAAC,IAAI,CAAC;IAS/B,IAAI,SAAS,IAAI,OAAO,CAEvB;IAED,SAAS,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAIxC,UAAU,CAAC,OAAO,EAAE,cAAc,GAAG,IAAI;IAKnC,WAAW,CACf,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,CAAC,EAAE;QACR,eAAe,CAAC,EAAE,MAAM,CAAC;KAC1B,GACA,OAAO,CAAC;QAAE,GAAG,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAC;QAAC,gBAAgB,EAAE,MAAM,CAAA;KAAE,CAAC;IAiBvD,SAAS,CACb,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;QAAE,GAAG,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAY7B,YAAY,CAChB,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,MAAM,EACX,QAAQ,CAAC,EAAE,MAAM,GAChB,OAAO,CAAC;QAAE,GAAG,EAAE;YAAE,EAAE,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC;IAY7B,kBAAkB,CAAC,GAAG,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlF;;;OAGG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAMhC,OAAO,CAAC,YAAY;IAIpB,OAAO,CAAC,gBAAgB;YAWV,cAAc;CAe7B"}

package/dist/WhatsAppService.js

@@ -0,0 +1,182 @@
+"use strict";
+/**
+ * @fileoverview WhatsApp SDK wrapper using @whiskeysockets/baileys.
+ * Handles socket lifecycle, message sending, and rate limiting.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsAppService = void 0;
+// Baileys depends on git-hosted packages. To keep `pnpm install` usable in offline
+// and minimal environments, this extension treats Baileys as a peer dependency
+// and loads it lazily at runtime.
+let cachedBaileys = null;
+function loadBaileys() {
+    if (cachedBaileys)
+        return cachedBaileys;
+    try {
+        // eslint-disable-next-line @typescript-eslint/no-var-requires
+        cachedBaileys = require('@whiskeysockets/baileys');
+        return cachedBaileys;
+    }
+    catch (error) {
+        cachedBaileys = null;
+        const details = error instanceof Error ? error.message : String(error);
+        throw new Error(`Missing peer dependency "@whiskeysockets/baileys". Install it to enable WhatsApp support (e.g. \`pnpm add @whiskeysockets/baileys\`). Original error: ${details}`);
+    }
+}
+class WhatsAppService {
+    constructor(config) {
+        this.sock = null;
+        this.running = false;
+        this.messageHandlers = [];
+        this.rateMap = new Map();
+        this.config = {
+            ...config,
+            reconnect: config.reconnect ?? { maxRetries: 5, delayMs: 3000 },
+            rateLimit: config.rateLimit ?? { maxRequests: 30, windowMs: 1000 },
+        };
+    }
+    async initialize() {
+        if (this.running)
+            return;
+        // Parse session data into auth state
+        const authState = this.parseSessionData(this.config.sessionData);
+        const baileys = loadBaileys();
+        const makeWASocket = baileys?.default ?? baileys;
+        const DisconnectReason = baileys?.DisconnectReason;
+        this.sock = makeWASocket({
+            auth: authState,
+            printQRInTerminal: false,
+        });
+        // Wire up connection updates
+        this.sock.ev.on('connection.update', (update) => {
+            const { connection, lastDisconnect } = update;
+            if (connection === 'close') {
+                const statusCode = lastDisconnect?.error?.output?.statusCode;
+                const loggedOutCode = DisconnectReason?.loggedOut;
+                const shouldReconnect = loggedOutCode == null ? true : statusCode !== loggedOutCode;
+                if (shouldReconnect && this.config.reconnect.maxRetries > 0) {
+                    setTimeout(() => {
+                        this.initialize().catch((err) => {
+                            console.error('[WhatsAppService] Reconnect failed:', err);
+                        });
+                    }, this.config.reconnect.delayMs);
+                }
+                else {
+                    this.running = false;
+                }
+            }
+            else if (connection === 'open') {
+                this.running = true;
+            }
+        });
+        // Wire up inbound message handler
+        this.sock.ev.on('messages.upsert', ({ messages, type }) => {
+            if (type !== 'notify')
+                return;
+            for (const msg of messages) {
+                if (!msg.message || msg.key.fromMe)
+                    continue;
+                const jid = msg.key.remoteJid ?? '';
+                const isGroup = this.isGroupJid(jid);
+                for (const handler of this.messageHandlers) {
+                    handler(msg, isGroup);
+                }
+            }
+        });
+        this.running = true;
+    }
+    async shutdown() {
+        if (!this.running || !this.sock)
+            return;
+        this.sock.ev.removeAllListeners('messages.upsert');
+        this.sock.ev.removeAllListeners('connection.update');
+        this.sock.end(undefined);
+        this.running = false;
+        this.sock = null;
+    }
+    get isRunning() {
+        return this.running;
+    }
+    onMessage(handler) {
+        this.messageHandlers.push(handler);
+    }
+    offMessage(handler) {
+        const idx = this.messageHandlers.indexOf(handler);
+        if (idx >= 0)
+            this.messageHandlers.splice(idx, 1);
+    }
+    async sendMessage(jid, text, options) {
+        this.ensureSocket();
+        await this.checkRateLimit(jid);
+        const quoted = options?.quotedMessageId
+            ? { key: { remoteJid: jid, id: options.quotedMessageId } }
+            : undefined;
+        const result = await this.sock.sendMessage(jid, { text }, { quoted });
+        return {
+            key: { id: result?.key?.id ?? '' },
+            messageTimestamp: typeof result?.messageTimestamp === 'number'
+                ? result.messageTimestamp
+                : Math.floor(Date.now() / 1000),
+        };
+    }
+    async sendImage(jid, url, caption) {
+        this.ensureSocket();
+        await this.checkRateLimit(jid);
+        const result = await this.sock.sendMessage(jid, {
+            image: { url },
+            caption: caption ?? undefined,
+        });
+        return { key: { id: result?.key?.id ?? '' } };
+    }
+    async sendDocument(jid, url, filename) {
+        this.ensureSocket();
+        await this.checkRateLimit(jid);
+        const result = await this.sock.sendMessage(jid, {
+            document: { url },
+            fileName: filename ?? 'document',
+        });
+        return { key: { id: result?.key?.id ?? '' } };
+    }
+    async sendPresenceUpdate(jid, type) {
+        this.ensureSocket();
+        await this.sock.sendPresenceUpdate(type, jid);
+    }
+    /**
+     * Determines whether a JID represents a group conversation.
+     * Groups end with `@g.us`, DMs end with `@s.whatsapp.net`.
+     */
+    isGroupJid(jid) {
+        return jid.endsWith('@g.us');
+    }
+    // ── Private ──
+    ensureSocket() {
+        if (!this.sock)
+            throw new Error('WhatsAppService not initialized');
+    }
+    parseSessionData(sessionData) {
+        try {
+            const parsed = JSON.parse(sessionData);
+            return parsed;
+        }
+        catch {
+            throw new Error('Invalid sessionData: must be a valid JSON string representing WhatsApp auth state.');
+        }
+    }
+    async checkRateLimit(key) {
+        const now = Date.now();
+        const state = this.rateMap.get(key);
+        if (!state || now >= state.resetAt) {
+            this.rateMap.set(key, { count: 1, resetAt: now + this.config.rateLimit.windowMs });
+            return;
+        }
+        if (state.count >= this.config.rateLimit.maxRequests) {
+            const waitMs = state.resetAt - now;
+            await new Promise((resolve) => setTimeout(resolve, waitMs));
+            this.rateMap.set(key, { count: 1, resetAt: Date.now() + this.config.rateLimit.windowMs });
+            return;
+        }
+        state.count++;
+    }
+}
+exports.WhatsAppService = WhatsAppService;
+//# sourceMappingURL=WhatsAppService.js.map

package/dist/WhatsAppService.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,32 @@
+/**
+ * @fileoverview WhatsApp Channel Extension for AgentOS.
+ *
+ * Provides a bidirectional messaging channel adapter using @whiskeysockets/baileys,
+ * plus ITool descriptors for programmatic message sending.
+ *
+ * @module @framers/agentos-ext-channel-whatsapp
+ */
+import type { ExtensionContext, ExtensionPack } from '@framers/agentos';
+import { WhatsAppService, type WhatsAppChannelConfig } from './WhatsAppService';
+import { WhatsAppChannelAdapter } from './WhatsAppChannelAdapter';
+import { WhatsAppSendMessageTool } from './tools/sendMessage';
+import { WhatsAppSendMediaTool } from './tools/sendMedia';
+export interface WhatsAppChannelOptions {
+    sessionData?: string;
+    sessionDataEnv?: string;
+    phoneNumber?: string;
+    reconnect?: {
+        maxRetries: number;
+        delayMs: number;
+    };
+    rateLimit?: {
+        maxRequests: number;
+        windowMs: number;
+    };
+    priority?: number;
+}
+export declare function createExtensionPack(context: ExtensionContext): ExtensionPack;
+export { WhatsAppService, WhatsAppChannelAdapter, WhatsAppSendMessageTool, WhatsAppSendMediaTool };
+export type { WhatsAppChannelConfig };
+export default createExtensionPack;
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,eAAe,EAAE,KAAK,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAChF,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAClE,OAAO,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAC9D,OAAO,EAAE,qBAAqB,EAAE,MAAM,mBAAmB,CAAC;AAE1D,MAAM,WAAW,sBAAsB;IACrC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE;QAAE,UAAU,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE,CAAC;IACpD,SAAS,CAAC,EAAE;QAAE,WAAW,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;IACtD,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAuBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,gBAAgB,GAAG,aAAa,CAsC5E;AAED,OAAO,EAAE,eAAe,EAAE,sBAAsB,EAAE,uBAAuB,EAAE,qBAAqB,EAAE,CAAC;AACnG,YAAY,EAAE,qBAAqB,EAAE,CAAC;AACtC,eAAe,mBAAmB,CAAC"}

package/dist/index.js

@@ -0,0 +1,75 @@
+"use strict";
+/**
+ * @fileoverview WhatsApp Channel Extension for AgentOS.
+ *
+ * Provides a bidirectional messaging channel adapter using @whiskeysockets/baileys,
+ * plus ITool descriptors for programmatic message sending.
+ *
+ * @module @framers/agentos-ext-channel-whatsapp
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsAppSendMediaTool = exports.WhatsAppSendMessageTool = exports.WhatsAppChannelAdapter = exports.WhatsAppService = void 0;
+exports.createExtensionPack = createExtensionPack;
+const WhatsAppService_1 = require("./WhatsAppService");
+Object.defineProperty(exports, "WhatsAppService", { enumerable: true, get: function () { return WhatsAppService_1.WhatsAppService; } });
+const WhatsAppChannelAdapter_1 = require("./WhatsAppChannelAdapter");
+Object.defineProperty(exports, "WhatsAppChannelAdapter", { enumerable: true, get: function () { return WhatsAppChannelAdapter_1.WhatsAppChannelAdapter; } });
+const sendMessage_1 = require("./tools/sendMessage");
+Object.defineProperty(exports, "WhatsAppSendMessageTool", { enumerable: true, get: function () { return sendMessage_1.WhatsAppSendMessageTool; } });
+const sendMedia_1 = require("./tools/sendMedia");
+Object.defineProperty(exports, "WhatsAppSendMediaTool", { enumerable: true, get: function () { return sendMedia_1.WhatsAppSendMediaTool; } });
+function resolveSessionData(options, secrets) {
+    if (options.sessionData)
+        return options.sessionData;
+    // Check secrets map from registry
+    if (secrets?.['whatsapp.sessionData'])
+        return secrets['whatsapp.sessionData'];
+    // Environment variable fallback
+    const envName = options.sessionDataEnv ?? 'WHATSAPP_SESSION_DATA';
+    const envValue = process.env[envName];
+    if (envValue)
+        return envValue;
+    // Common variations
+    for (const v of ['WHATSAPP_SESSION_DATA', 'WHATSAPP_AUTH_STATE']) {
+        if (process.env[v])
+            return process.env[v];
+    }
+    throw new Error('WhatsApp session data not found. Provide via options.sessionData, secrets["whatsapp.sessionData"], or WHATSAPP_SESSION_DATA env var.');
+}
+function createExtensionPack(context) {
+    const options = (context.options ?? {});
+    const sessionData = resolveSessionData(options, options.secrets);
+    const config = {
+        sessionData,
+        phoneNumber: options.phoneNumber,
+        reconnect: options.reconnect ?? { maxRetries: 5, delayMs: 3000 },
+        rateLimit: options.rateLimit ?? { maxRequests: 30, windowMs: 1000 },
+    };
+    const service = new WhatsAppService_1.WhatsAppService(config);
+    const adapter = new WhatsAppChannelAdapter_1.WhatsAppChannelAdapter(service);
+    const sendMessageTool = new sendMessage_1.WhatsAppSendMessageTool(service);
+    const sendMediaTool = new sendMedia_1.WhatsAppSendMediaTool(service);
+    const priority = options.priority ?? 50;
+    return {
+        name: '@framers/agentos-ext-channel-whatsapp',
+        version: '0.1.0',
+        descriptors: [
+            { id: 'whatsappChannelSendMessage', kind: 'tool', priority, payload: sendMessageTool },
+            { id: 'whatsappChannelSendMedia', kind: 'tool', priority, payload: sendMediaTool },
+            { id: 'whatsappChannel', kind: 'messaging-channel', priority, payload: adapter },
+        ],
+        onActivate: async () => {
+            await service.initialize();
+            // Wire adapter event listeners after service is running
+            await adapter.initialize({ platform: 'whatsapp', credential: sessionData });
+            context.logger?.info('[WhatsAppChannel] Extension activated');
+        },
+        onDeactivate: async () => {
+            await adapter.shutdown();
+            await service.shutdown();
+            context.logger?.info('[WhatsAppChannel] Extension deactivated');
+        },
+    };
+}
+exports.default = createExtensionPack;
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

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

package/dist/tools/sendMedia.d.ts

@@ -0,0 +1,64 @@
+/**
+ * @fileoverview ITool for sending media (image, document) via the WhatsApp channel adapter.
+ */
+import type { ITool, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import type { WhatsAppService } from '../WhatsAppService';
+export declare class WhatsAppSendMediaTool implements ITool {
+    private readonly service;
+    readonly id = "whatsappChannelSendMedia";
+    readonly name = "whatsappChannelSendMedia";
+    readonly displayName = "Send WhatsApp Media";
+    readonly description = "Send an image or document to a WhatsApp chat via the channel adapter.";
+    readonly category = "communication";
+    readonly version = "0.1.0";
+    readonly hasSideEffects = true;
+    readonly inputSchema: {
+        type: "object";
+        required: readonly ["jid", "mediaType", "url"];
+        properties: {
+            jid: {
+                type: string;
+                description: string;
+            };
+            mediaType: {
+                type: string;
+                enum: string[];
+                description: string;
+            };
+            url: {
+                type: string;
+                description: string;
+            };
+            caption: {
+                type: string;
+                description: string;
+            };
+            filename: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    readonly outputSchema: {
+        type: "object";
+        properties: {
+            messageId: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    constructor(service: WhatsAppService);
+    execute(args: {
+        jid: string;
+        mediaType: 'image' | 'document';
+        url: string;
+        caption?: string;
+        filename?: string;
+    }, _context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    validateArgs(args: Record<string, any>): {
+        isValid: boolean;
+        errors?: string[];
+    };
+}
+//# sourceMappingURL=sendMedia.d.ts.map

package/dist/tools/sendMedia.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendMedia.d.ts","sourceRoot":"","sources":["../../src/tools/sendMedia.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,qBAAa,qBAAsB,YAAW,KAAK;IA4BrC,OAAO,CAAC,QAAQ,CAAC,OAAO;IA3BpC,SAAgB,EAAE,8BAA8B;IAChD,SAAgB,IAAI,8BAA8B;IAClD,SAAgB,WAAW,yBAAyB;IACpD,SAAgB,WAAW,2EAA2E;IACtG,SAAgB,QAAQ,mBAAmB;IAC3C,SAAgB,OAAO,WAAW;IAClC,SAAgB,cAAc,QAAQ;IAEtC,SAAgB,WAAW;;;;;;;;;;;;;;;;;;;;;;;;;;MAUzB;IAEF,SAAgB,YAAY;;;;;;;;MAK1B;gBAE2B,OAAO,EAAE,eAAe;IAE/C,OAAO,CACX,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,OAAO,GAAG,UAAU,CAAC;QAAC,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,EACxG,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAgB/B,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CASjF"}

package/dist/tools/sendMedia.js

@@ -0,0 +1,63 @@
+"use strict";
+/**
+ * @fileoverview ITool for sending media (image, document) via the WhatsApp channel adapter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsAppSendMediaTool = void 0;
+class WhatsAppSendMediaTool {
+    constructor(service) {
+        this.service = service;
+        this.id = 'whatsappChannelSendMedia';
+        this.name = 'whatsappChannelSendMedia';
+        this.displayName = 'Send WhatsApp Media';
+        this.description = 'Send an image or document to a WhatsApp chat via the channel adapter.';
+        this.category = 'communication';
+        this.version = '0.1.0';
+        this.hasSideEffects = true;
+        this.inputSchema = {
+            type: 'object',
+            required: ['jid', 'mediaType', 'url'],
+            properties: {
+                jid: { type: 'string', description: 'Target JID (e.g., 1234567890@s.whatsapp.net or group-id@g.us)' },
+                mediaType: { type: 'string', enum: ['image', 'document'], description: 'Type of media to send' },
+                url: { type: 'string', description: 'URL of the media file' },
+                caption: { type: 'string', description: 'Optional caption (images only)' },
+                filename: { type: 'string', description: 'Filename (documents only)' },
+            },
+        };
+        this.outputSchema = {
+            type: 'object',
+            properties: {
+                messageId: { type: 'string', description: 'Sent message ID' },
+            },
+        };
+    }
+    async execute(args, _context) {
+        try {
+            let result;
+            if (args.mediaType === 'image') {
+                result = await this.service.sendImage(args.jid, args.url, args.caption);
+            }
+            else {
+                result = await this.service.sendDocument(args.jid, args.url, args.filename);
+            }
+            return { success: true, output: { messageId: result.key.id } };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+    validateArgs(args) {
+        const errors = [];
+        if (!args.jid)
+            errors.push('jid is required');
+        if (!args.mediaType || !['image', 'document'].includes(args.mediaType)) {
+            errors.push('mediaType must be "image" or "document"');
+        }
+        if (!args.url)
+            errors.push('url is required');
+        return { isValid: errors.length === 0, errors };
+    }
+}
+exports.WhatsAppSendMediaTool = WhatsAppSendMediaTool;
+//# sourceMappingURL=sendMedia.js.map

package/dist/tools/sendMedia.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendMedia.js","sourceRoot":"","sources":["../../src/tools/sendMedia.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,MAAa,qBAAqB;IA4BhC,YAA6B,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;QA3BrC,OAAE,GAAG,0BAA0B,CAAC;QAChC,SAAI,GAAG,0BAA0B,CAAC;QAClC,gBAAW,GAAG,qBAAqB,CAAC;QACpC,gBAAW,GAAG,uEAAuE,CAAC;QACtF,aAAQ,GAAG,eAAe,CAAC;QAC3B,YAAO,GAAG,OAAO,CAAC;QAClB,mBAAc,GAAG,IAAI,CAAC;QAEtB,gBAAW,GAAG;YAC5B,IAAI,EAAE,QAAiB;YACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,WAAW,EAAE,KAAK,CAAU;YAC9C,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;gBACrG,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,OAAO,EAAE,UAAU,CAAC,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBAChG,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE;gBAC7D,OAAO,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,gCAAgC,EAAE;gBAC1E,QAAQ,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,2BAA2B,EAAE;aACvE;SACF,CAAC;QAEc,iBAAY,GAAG;YAC7B,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;aAC9D;SACF,CAAC;IAEsD,CAAC;IAEzD,KAAK,CAAC,OAAO,CACX,IAAwG,EACxG,QAA8B;QAE9B,IAAI,CAAC;YACH,IAAI,MAA+B,CAAC;YAEpC,IAAI,IAAI,CAAC,SAAS,KAAK,OAAO,EAAE,CAAC;gBAC/B,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,OAAO,CAAC,CAAC;YAC1E,CAAC;iBAAM,CAAC;gBACN,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;YAC9E,CAAC;YAED,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,EAAE,CAAC;QACjE,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,YAAY,CAAC,IAAyB;QACpC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9C,IAAI,CAAC,IAAI,CAAC,SAAS,IAAI,CAAC,CAAC,OAAO,EAAE,UAAU,CAAC,CAAC,QAAQ,CAAC,IAAI,CAAC,SAAS,CAAC,EAAE,CAAC;YACvE,MAAM,CAAC,IAAI,CAAC,yCAAyC,CAAC,CAAC;QACzD,CAAC;QACD,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;QAC9C,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC;CACF;AA1DD,sDA0DC"}

package/dist/tools/sendMessage.d.ts

@@ -0,0 +1,52 @@
+/**
+ * @fileoverview ITool for sending text messages via the WhatsApp channel adapter.
+ */
+import type { ITool, ToolExecutionContext, ToolExecutionResult } from '@framers/agentos';
+import type { WhatsAppService } from '../WhatsAppService';
+export declare class WhatsAppSendMessageTool implements ITool {
+    private readonly service;
+    readonly id = "whatsappChannelSendMessage";
+    readonly name = "whatsappChannelSendMessage";
+    readonly displayName = "Send WhatsApp Message";
+    readonly description = "Send a text message to a WhatsApp chat via the channel adapter.";
+    readonly category = "communication";
+    readonly version = "0.1.0";
+    readonly hasSideEffects = true;
+    readonly inputSchema: {
+        type: "object";
+        required: readonly ["jid", "text"];
+        properties: {
+            jid: {
+                type: string;
+                description: string;
+            };
+            text: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    readonly outputSchema: {
+        type: "object";
+        properties: {
+            messageId: {
+                type: string;
+                description: string;
+            };
+            jid: {
+                type: string;
+                description: string;
+            };
+        };
+    };
+    constructor(service: WhatsAppService);
+    execute(args: {
+        jid: string;
+        text: string;
+    }, _context: ToolExecutionContext): Promise<ToolExecutionResult>;
+    validateArgs(args: Record<string, any>): {
+        isValid: boolean;
+        errors?: string[];
+    };
+}
+//# sourceMappingURL=sendMessage.d.ts.map

package/dist/tools/sendMessage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendMessage.d.ts","sourceRoot":"","sources":["../../src/tools/sendMessage.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,oBAAoB,CAAC;AAE1D,qBAAa,uBAAwB,YAAW,KAAK;IA0BvC,OAAO,CAAC,QAAQ,CAAC,OAAO;IAzBpC,SAAgB,EAAE,gCAAgC;IAClD,SAAgB,IAAI,gCAAgC;IACpD,SAAgB,WAAW,2BAA2B;IACtD,SAAgB,WAAW,qEAAqE;IAChG,SAAgB,QAAQ,mBAAmB;IAC3C,SAAgB,OAAO,WAAW;IAClC,SAAgB,cAAc,QAAQ;IAEtC,SAAgB,WAAW;;;;;;;;;;;;;MAOzB;IAEF,SAAgB,YAAY;;;;;;;;;;;;MAM1B;gBAE2B,OAAO,EAAE,eAAe;IAE/C,OAAO,CACX,IAAI,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,EACnC,QAAQ,EAAE,oBAAoB,GAC7B,OAAO,CAAC,mBAAmB,CAAC;IAa/B,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG;QAAE,OAAO,EAAE,OAAO,CAAC;QAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;KAAE;CAQjF"}

package/dist/tools/sendMessage.js

@@ -0,0 +1,59 @@
+"use strict";
+/**
+ * @fileoverview ITool for sending text messages via the WhatsApp channel adapter.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.WhatsAppSendMessageTool = void 0;
+class WhatsAppSendMessageTool {
+    constructor(service) {
+        this.service = service;
+        this.id = 'whatsappChannelSendMessage';
+        this.name = 'whatsappChannelSendMessage';
+        this.displayName = 'Send WhatsApp Message';
+        this.description = 'Send a text message to a WhatsApp chat via the channel adapter.';
+        this.category = 'communication';
+        this.version = '0.1.0';
+        this.hasSideEffects = true;
+        this.inputSchema = {
+            type: 'object',
+            required: ['jid', 'text'],
+            properties: {
+                jid: { type: 'string', description: 'Target JID (e.g., 1234567890@s.whatsapp.net or group-id@g.us)' },
+                text: { type: 'string', description: 'Message text' },
+            },
+        };
+        this.outputSchema = {
+            type: 'object',
+            properties: {
+                messageId: { type: 'string', description: 'Sent message ID' },
+                jid: { type: 'string', description: 'Target JID' },
+            },
+        };
+    }
+    async execute(args, _context) {
+        try {
+            const result = await this.service.sendMessage(args.jid, args.text);
+            return {
+                success: true,
+                output: { messageId: result.key.id, jid: args.jid },
+            };
+        }
+        catch (error) {
+            return { success: false, error: error.message };
+        }
+    }
+    validateArgs(args) {
+        const errors = [];
+        if (!args.jid)
+            errors.push('jid is required');
+        else if (typeof args.jid !== 'string')
+            errors.push('jid must be a string');
+        if (!args.text)
+            errors.push('text is required');
+        else if (typeof args.text !== 'string')
+            errors.push('text must be a string');
+        return { isValid: errors.length === 0, errors };
+    }
+}
+exports.WhatsAppSendMessageTool = WhatsAppSendMessageTool;
+//# sourceMappingURL=sendMessage.js.map

package/dist/tools/sendMessage.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sendMessage.js","sourceRoot":"","sources":["../../src/tools/sendMessage.ts"],"names":[],"mappings":";AAAA;;GAEG;;;AAKH,MAAa,uBAAuB;IA0BlC,YAA6B,OAAwB;QAAxB,YAAO,GAAP,OAAO,CAAiB;QAzBrC,OAAE,GAAG,4BAA4B,CAAC;QAClC,SAAI,GAAG,4BAA4B,CAAC;QACpC,gBAAW,GAAG,uBAAuB,CAAC;QACtC,gBAAW,GAAG,iEAAiE,CAAC;QAChF,aAAQ,GAAG,eAAe,CAAC;QAC3B,YAAO,GAAG,OAAO,CAAC;QAClB,mBAAc,GAAG,IAAI,CAAC;QAEtB,gBAAW,GAAG;YAC5B,IAAI,EAAE,QAAiB;YACvB,QAAQ,EAAE,CAAC,KAAK,EAAE,MAAM,CAAU;YAClC,UAAU,EAAE;gBACV,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,+DAA+D,EAAE;gBACrG,IAAI,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,cAAc,EAAE;aACtD;SACF,CAAC;QAEc,iBAAY,GAAG;YAC7B,IAAI,EAAE,QAAiB;YACvB,UAAU,EAAE;gBACV,SAAS,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,iBAAiB,EAAE;gBAC7D,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,YAAY,EAAE;aACnD;SACF,CAAC;IAEsD,CAAC;IAEzD,KAAK,CAAC,OAAO,CACX,IAAmC,EACnC,QAA8B;QAE9B,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;YAEnE,OAAO;gBACL,OAAO,EAAE,IAAI;gBACb,MAAM,EAAE,EAAE,SAAS,EAAE,MAAM,CAAC,GAAG,CAAC,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,EAAE;aACpD,CAAC;QACJ,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC;QAClD,CAAC;IACH,CAAC;IAED,YAAY,CAAC,IAAyB;QACpC,MAAM,MAAM,GAAa,EAAE,CAAC;QAC5B,IAAI,CAAC,IAAI,CAAC,GAAG;YAAE,MAAM,CAAC,IAAI,CAAC,iBAAiB,CAAC,CAAC;aACzC,IAAI,OAAO,IAAI,CAAC,GAAG,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,sBAAsB,CAAC,CAAC;QAC3E,IAAI,CAAC,IAAI,CAAC,IAAI;YAAE,MAAM,CAAC,IAAI,CAAC,kBAAkB,CAAC,CAAC;aAC3C,IAAI,OAAO,IAAI,CAAC,IAAI,KAAK,QAAQ;YAAE,MAAM,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;QAC7E,OAAO,EAAE,OAAO,EAAE,MAAM,CAAC,MAAM,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IAClD,CAAC;CACF;AApDD,0DAoDC"}

package/manifest.json

@@ -0,0 +1,37 @@
+{
+  "$schema": "https://agentos.sh/schemas/extension-manifest-v1.json",
+  "id": "com.framers.channels.whatsapp",
+  "name": "WhatsApp Channel Extension",
+  "version": "0.1.0",
+  "description": "Bidirectional WhatsApp messaging via Baileys — supports text, images, documents, typing indicators, and groups.",
+  "categories": ["channel", "communication"],
+  "platforms": ["whatsapp"],
+  "sdk": "@whiskeysockets/baileys",
+  "extensions": [
+    {
+      "kind": "tool",
+      "id": "whatsappChannelSendMessage",
+      "displayName": "Send WhatsApp Message"
+    },
+    {
+      "kind": "tool",
+      "id": "whatsappChannelSendMedia",
+      "displayName": "Send WhatsApp Media"
+    },
+    {
+      "kind": "messaging-channel",
+      "id": "whatsappChannel",
+      "displayName": "WhatsApp Channel Adapter"
+    }
+  ],
+  "requiredSecrets": ["whatsapp.sessionData"],
+  "features": [
+    "Text messages",
+    "Image and document sending",
+    "Rate limiting with queue management",
+    "Group chat support",
+    "Typing indicators (composing/paused)",
+    "Read receipts",
+    "Audio message support"
+  ]
+}

package/package.json

@@ -0,0 +1,29 @@
+{
+  "name": "@framers/agentos-ext-channel-whatsapp",
+  "version": "0.1.0",
+  "description": "WhatsApp messaging channel adapter for AgentOS — bidirectional messaging via Baileys",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "dev": "tsc --watch",
+    "test": "vitest run",
+    "test:watch": "vitest watch",
+    "clean": "rm -rf dist"
+  },
+  "keywords": ["agentos", "extension", "channel", "whatsapp", "baileys", "messaging"],
+  "author": { "name": "Framers AI", "url": "https://frame.dev" },
+  "license": "MIT",
+  "files": ["dist", "manifest.json"],
+  "peerDependencies": {
+    "@framers/agentos": "^0.1.0",
+    "@whiskeysockets/baileys": ">=6.0.0"
+  },
+  "devDependencies": {
+    "@framers/agentos": "workspace:*",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.0.0",
+    "vitest": "^1.0.0"
+  },
+  "engines": { "node": ">=18.0.0" }
+}