@gamalan/pi-gateway 1.0.0

package/dist/adapters/websocket.js

@@ -0,0 +1,132 @@
+/**
+ * WebSocket Adapter - For web clients and other WebSocket-based platforms
+ */
+import { BaseAdapter } from "./base.js";
+import { logger } from "../logger.js";
+export class WebSocketAdapter extends BaseAdapter {
+    platform = "websocket";
+    config;
+    client = null;
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 5;
+    reconnectDelay = 1000;
+    constructor(config) {
+        super();
+        this.config = config;
+    }
+    async initialize() {
+        logger.info(`[WebSocket] Adapter initialized for client ${this.config.clientId}`);
+    }
+    async start(callbacks) {
+        await super.start(callbacks);
+        // For server-side: this would be handled by the main gateway
+        // This adapter is more for client-side connections
+    }
+    async connect(url, token) {
+        return new Promise((resolve, reject) => {
+            const headers = {};
+            if (token) {
+                headers["Authorization"] = `Bearer ${token}`;
+            }
+            this.client = new WebSocket(url, { headers });
+            this.client.onopen = () => {
+                logger.info(`[WebSocket] Connected to ${url}`);
+                this.reconnectAttempts = 0;
+                resolve();
+            };
+            this.client.onmessage = (event) => {
+                try {
+                    const data = JSON.parse(event.data);
+                    if (data.type === "message") {
+                        const message = {
+                            id: this.generateMessageId(),
+                            platform: this.platform,
+                            channelId: this.config.clientId,
+                            userId: this.config.clientId,
+                            content: data.content,
+                            timestamp: Date.now(),
+                            metadata: data.metadata,
+                        };
+                        this.emitMessage(message);
+                    }
+                }
+                catch (err) {
+                    logger.error("[WebSocket] Failed to parse message:", err);
+                }
+            };
+            this.client.onclose = () => {
+                logger.info("[WebSocket] Connection closed");
+                this.callbacks?.onDisconnect?.();
+                this.attemptReconnect(url, token);
+            };
+            this.client.onerror = (err) => {
+                logger.error("[WebSocket] Error:", err);
+                reject(err);
+            };
+        });
+    }
+    attemptReconnect(url, token) {
+        if (this.reconnectAttempts < this.maxReconnectAttempts) {
+            this.reconnectAttempts++;
+            const delay = this.reconnectDelay * Math.pow(2, this.reconnectAttempts - 1);
+            logger.info(`[WebSocket] Reconnecting in ${delay}ms (attempt ${this.reconnectAttempts})`);
+            setTimeout(() => this.connect(url, token), delay);
+        }
+    }
+    async sendMessage(channelId, content) {
+        if (!this.client || this.client.readyState !== WebSocket.OPEN) {
+            throw new Error("WebSocket not connected");
+        }
+        const id = this.generateMessageId();
+        this.client.send(JSON.stringify({
+            type: "message",
+            id,
+            content,
+            channelId,
+        }));
+        return id;
+    }
+    async editMessage(channelId, messageId, content) {
+        if (!this.client || this.client.readyState !== WebSocket.OPEN) {
+            throw new Error("WebSocket not connected");
+        }
+        this.client.send(JSON.stringify({
+            type: "edit",
+            id: messageId,
+            content,
+            channelId,
+        }));
+    }
+    async deleteMessage(channelId, messageId) {
+        if (!this.client || this.client.readyState !== WebSocket.OPEN) {
+            throw new Error("WebSocket not connected");
+        }
+        this.client.send(JSON.stringify({
+            type: "delete",
+            id: messageId,
+            channelId,
+        }));
+    }
+    async setTyping(channelId, isTyping) {
+        if (!this.client || this.client.readyState !== WebSocket.OPEN)
+            return;
+        this.client.send(JSON.stringify({
+            type: "typing",
+            channelId,
+            isTyping,
+        }));
+    }
+    async getStatus() {
+        return {
+            connected: this.client?.readyState === WebSocket.OPEN,
+        };
+    }
+    async stop() {
+        if (this.client) {
+            this.client.close();
+            this.client = null;
+        }
+        await super.stop();
+    }
+}
+//# sourceMappingURL=websocket.js.map

package/dist/adapters/websocket.js.map

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

package/dist/adapters/whatsapp.d.ts

@@ -0,0 +1,49 @@
+/**
+ * WhatsApp Adapter - Hermes-style WhatsApp platform adapter
+ *
+ * Features:
+ * - WhatsApp Web protocol via Baileys
+ * - QR code authentication
+ * - Contact and group management
+ * - Media messaging
+ */
+import { BaseAdapter, type PlatformConfig } from "./base.js";
+export interface WhatsAppConfig extends PlatformConfig {
+    platform: "whatsapp";
+    sessionPath?: string;
+    printQr?: boolean;
+    maxMessageLength?: number;
+}
+interface WhatsAppContact {
+    id: string;
+    name?: string;
+    isGroup: boolean;
+}
+export declare class WhatsAppAdapter extends BaseAdapter {
+    readonly platform: "whatsapp";
+    config: WhatsAppConfig;
+    private sock;
+    private connected;
+    private qrCode;
+    constructor(config: WhatsAppConfig);
+    initialize(): Promise<void>;
+    private handleMessages;
+    start(callbacks: any): Promise<void>;
+    private sleep;
+    stop(): Promise<void>;
+    sendMessage(channelId: string, content: string): Promise<string>;
+    sendImage(channelId: string, imageUrl: string, caption?: string): Promise<string>;
+    sendReaction(channelId: string, messageId: string, emoji: string): Promise<void>;
+    reply(channelId: string, content: string, messageId: string): Promise<string>;
+    editMessage(channelId: string, messageId: string, content: string): Promise<void>;
+    deleteMessage(channelId: string, messageId: string): Promise<void>;
+    setTyping(channelId: string, isTyping: boolean): Promise<void>;
+    getStatus(): Promise<{
+        connected: boolean;
+        latency?: number;
+    }>;
+    getContacts(): Promise<WhatsAppContact[]>;
+    getContact(jid: string): Promise<WhatsAppContact | null>;
+    getQrCode(): string | null;
+}
+export {};

package/dist/adapters/whatsapp.js

@@ -0,0 +1,251 @@
+/**
+ * WhatsApp Adapter - Hermes-style WhatsApp platform adapter
+ *
+ * Features:
+ * - WhatsApp Web protocol via Baileys
+ * - QR code authentication
+ * - Contact and group management
+ * - Media messaging
+ */
+import { BaseAdapter } from "./base.js";
+import { logger } from "../logger.js";
+export class WhatsAppAdapter extends BaseAdapter {
+    platform = "whatsapp";
+    config;
+    sock = null;
+    connected = false;
+    qrCode = null;
+    constructor(config) {
+        super();
+        this.config = {
+            enabled: true,
+            platform: "whatsapp",
+            sessionPath: "./whatsapp-session",
+            printQr: true,
+            maxMessageLength: 4096,
+            ...config,
+        };
+    }
+    async initialize() {
+        try {
+            const baileys = await import("@whiskeysockets/baileys");
+            const { state, saveCreds } = await baileys.useMultiFileAuthState(this.config.sessionPath || "./whatsapp-session");
+            this.sock = baileys.makeWASocket({
+                auth: state,
+                printQRInTerminal: this.config.printQr,
+                defaultQueryTimeoutMs: 60 * 1000,
+            });
+            // Handle QR code
+            this.sock.ev.on("qr", (qr) => {
+                this.qrCode = qr;
+                logger.info("[WhatsApp] QR Code received - scan with WhatsApp app");
+                logger.info(qr);
+            });
+            // Handle connection update
+            this.sock.ev.on("connection.update", ({ qr, connection }) => {
+                if (qr) {
+                    this.qrCode = qr;
+                }
+                if (connection === "open") {
+                    this.connected = true;
+                    this.qrCode = null;
+                    logger.info("[WhatsApp] Connected!");
+                }
+                if (connection === "close") {
+                    this.connected = false;
+                    logger.info("[WhatsApp] Disconnected");
+                }
+            });
+            // Handle credentials update
+            this.sock.ev.on("creds.update", saveCreds);
+            // Handle messages
+            this.sock.ev.on("messages.upsert", ({ messages }) => {
+                this.handleMessages(messages);
+            });
+            logger.info("[WhatsApp] Initializing...");
+        }
+        catch (err) {
+            logger.error("[WhatsApp] Failed to initialize:", err);
+            throw err;
+        }
+    }
+    handleMessages(messages) {
+        for (const msg of messages) {
+            // Skip messages sent by us
+            if (msg.key.fromMe)
+                continue;
+            const jid = msg.key.remoteJid;
+            const isGroup = jid?.endsWith("@g.us");
+            // Get message content
+            const content = msg.message?.conversation ||
+                msg.message?.extendedTextMessage?.text ||
+                msg.message?.imageMessage?.caption ||
+                "";
+            if (!content)
+                continue;
+            const message = {
+                id: msg.key.id || this.generateMessageId(),
+                platform: "whatsapp",
+                channelId: jid,
+                userId: msg.key.participant || jid,
+                content,
+                timestamp: msg.messageTimestamp ? msg.messageTimestamp * 1000 : Date.now(),
+                metadata: {
+                    isGroup,
+                    messageType: msg.message ? Object.keys(msg.message)[0] : "unknown",
+                    pushName: msg.pushName,
+                },
+            };
+            this.emitMessage(message);
+        }
+    }
+    async start(callbacks) {
+        await super.start(callbacks);
+        // Wait for connection
+        let attempts = 0;
+        while (!this.connected && attempts < 30) {
+            await this.sleep(1000);
+            attempts++;
+        }
+        if (!this.connected) {
+            logger.warn("[WhatsApp] Not yet connected - waiting for QR scan");
+        }
+    }
+    sleep(ms) {
+        return new Promise(resolve => setTimeout(resolve, ms));
+    }
+    async stop() {
+        if (this.sock) {
+            await this.sock.logout();
+            this.sock = null;
+        }
+        this.connected = false;
+        await super.stop();
+    }
+    async sendMessage(channelId, content) {
+        if (!this.sock || !this.connected) {
+            throw new Error("WhatsApp not connected");
+        }
+        // Truncate if too long
+        const text = content.length > (this.config.maxMessageLength || 4096)
+            ? content.slice(0, this.config.maxMessageLength - 3) + "..."
+            : content;
+        try {
+            const result = await this.sock.sendMessage(channelId, { text });
+            return result?.key?.id || this.generateMessageId();
+        }
+        catch (err) {
+            logger.error("[WhatsApp] Send error:", err);
+            throw err;
+        }
+    }
+    async sendImage(channelId, imageUrl, caption) {
+        if (!this.sock || !this.connected) {
+            throw new Error("WhatsApp not connected");
+        }
+        try {
+            const result = await this.sock.sendMessage(channelId, {
+                image: { url: imageUrl },
+                caption,
+            });
+            return result?.key?.id || this.generateMessageId();
+        }
+        catch (err) {
+            logger.error("[WhatsApp] Send image error:", err);
+            throw err;
+        }
+    }
+    async sendReaction(channelId, messageId, emoji) {
+        if (!this.sock || !this.connected) {
+            throw new Error("WhatsApp not connected");
+        }
+        try {
+            await this.sock.sendMessage(channelId, {
+                react: { text: emoji, key: { remoteJid: channelId, id: messageId } },
+            });
+        }
+        catch (err) {
+            logger.error("[WhatsApp] Reaction error:", err);
+        }
+    }
+    async reply(channelId, content, messageId) {
+        if (!this.sock || !this.connected) {
+            throw new Error("WhatsApp not connected");
+        }
+        try {
+            const result = await this.sock.sendMessage(channelId, {
+                text: content,
+                contextInfo: {
+                    stanzaId: messageId,
+                    remoteJid: channelId,
+                },
+            });
+            return result?.key?.id || this.generateMessageId();
+        }
+        catch (err) {
+            logger.error("[WhatsApp] Reply error:", err);
+            throw err;
+        }
+    }
+    async editMessage(channelId, messageId, content) {
+        if (!this.sock || !this.connected) {
+            throw new Error("WhatsApp not connected");
+        }
+        try {
+            await this.sock.relayMessage(channelId, {
+                protocolMessage: {
+                    type: 6, // MESSAGE_EDIT
+                    key: { remoteJid: channelId, id: messageId },
+                    editedMessage: { conversation: [{ text: content }] },
+                },
+            }, {});
+        }
+        catch (err) {
+            logger.error("[WhatsApp] Edit error:", err);
+        }
+    }
+    async deleteMessage(channelId, messageId) {
+        if (!this.sock || !this.connected) {
+            throw new Error("WhatsApp not connected");
+        }
+        try {
+            await this.sock.sendMessage(channelId, {
+                delete: { remoteJid: channelId, id: messageId },
+            });
+        }
+        catch (err) {
+            logger.error("[WhatsApp] Delete error:", err);
+        }
+    }
+    async setTyping(channelId, isTyping) {
+        if (!this.sock || !this.connected)
+            return;
+        try {
+            await this.sock.sendPresenceUpdate(isTyping ? "composing" : "available", channelId);
+        }
+        catch (err) {
+            // Ignore presence errors
+        }
+    }
+    async getStatus() {
+        return { connected: this.connected };
+    }
+    async getContacts() {
+        if (!this.sock?.store?.contacts) {
+            return [];
+        }
+        return Object.entries(this.sock.store.contacts).map(([id, contact]) => ({
+            id,
+            name: contact?.name || contact?.notify || id.split("@")[0],
+            isGroup: id.endsWith("@g.us"),
+        }));
+    }
+    async getContact(jid) {
+        const contacts = await this.getContacts();
+        return contacts.find(c => c.id === jid) || null;
+    }
+    getQrCode() {
+        return this.qrCode;
+    }
+}
+//# sourceMappingURL=whatsapp.js.map

package/dist/adapters/whatsapp.js.map

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

package/dist/background/index.d.ts

@@ -0,0 +1 @@
+export { initBackgroundTasks, startBackgroundTask, getPendingResultsForSession, markTaskDelivered, listTasks, cancelTask, type BackgroundTask, type BackgroundStatus } from "./manager.js";

package/dist/background/index.js

@@ -0,0 +1,2 @@
+export { initBackgroundTasks, startBackgroundTask, getPendingResultsForSession, markTaskDelivered, listTasks, cancelTask } from "./manager.js";
+//# sourceMappingURL=index.js.map

package/dist/background/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/background/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,mBAAmB,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,iBAAiB,EAAE,SAAS,EAAE,UAAU,EAA8C,MAAM,cAAc,CAAC"}

package/dist/background/manager.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Background Task Manager - Hermes-style background session handling
+ *
+ * Features:
+ * - Isolated sessions for background tasks
+ * - Result delivery to parent session
+ * - Progress notifications
+ * - Timeout handling
+ */
+import Database from "better-sqlite3";
+export type BackgroundStatus = "running" | "completed" | "failed" | "timeout" | "delivered";
+export interface BackgroundTask {
+    id: string;
+    sessionId: string;
+    parentSessionId: string;
+    command: string;
+    status: BackgroundStatus;
+    progress: number;
+    progressMessage?: string;
+    result?: unknown;
+    error?: string;
+    createdAt: number;
+    startedAt?: number;
+    completedAt?: number;
+    deliveredAt?: number;
+}
+/**
+ * Initialize background tasks database
+ */
+export declare function initBackgroundTasks(): Database.Database;
+/**
+ * Start a background task
+ */
+export declare function startBackgroundTask(parentSessionId: string, command: string, onProgress?: (task: BackgroundTask) => void): BackgroundTask;
+/**
+ * Update task progress
+ */
+export declare function updateTaskProgress(taskId: string, progress: number, message?: string): void;
+/**
+ * Complete a task successfully
+ */
+export declare function completeTask(taskId: string, result: unknown): void;
+/**
+ * Fail a task
+ */
+export declare function failTask(taskId: string, error: string): void;
+/**
+ * Mark task as delivered to user
+ */
+export declare function markTaskDelivered(taskId: string): void;
+/**
+ * Get task by ID
+ */
+export declare function getTask(taskId: string): BackgroundTask | null;
+/**
+ * Get pending results for parent session
+ */
+export declare function getPendingResultsForSession(parentSessionId: string): BackgroundTask[];
+/**
+ * List all tasks
+ */
+export declare function listTasks(status?: BackgroundStatus): BackgroundTask[];
+/**
+ * Cancel a running task
+ */
+export declare function cancelTask(taskId: string): boolean;
+/**
+ * Clean up old tasks
+ */
+export declare function cleanupOldTasks(maxAgeMs?: number): number;