@terminals-tech/agent-zero 1.0.0

package/dist/channels/sms.js

@@ -0,0 +1,160 @@
+/**
+ * SMS Channel Adapter
+ *
+ * Twilio-backed SMS channel with webhook receiver and signature validation.
+ * Uses the same ChannelAdapter interface as WhatsApp.
+ */
+import { createServer } from 'http';
+import { createHmac } from 'crypto';
+import { randomUUID } from 'crypto';
+import { EventEmitter } from 'eventemitter3';
+// ============================================================================
+// SMS ADAPTER
+// ============================================================================
+export class SmsAdapter extends EventEmitter {
+    config;
+    status = 'disconnected';
+    handlers = [];
+    server;
+    constructor(config) {
+        super();
+        this.config = {
+            webhookPort: Number(process.env['SMS_WEBHOOK_PORT']) || 8080,
+            ...config,
+        };
+    }
+    async connect() {
+        if (this.status !== 'disconnected')
+            return;
+        this.status = 'connecting';
+        return new Promise((resolve, reject) => {
+            this.server = createServer((req, res) => {
+                this.handleRequest(req, res);
+            });
+            this.server.on('error', (err) => {
+                if (this.status === 'connecting') {
+                    this.status = 'disconnected';
+                    reject(err);
+                }
+            });
+            this.server.listen(this.config.webhookPort, '0.0.0.0', () => {
+                this.status = 'connected';
+                resolve();
+            });
+        });
+    }
+    async disconnect() {
+        if (!this.server)
+            return;
+        return new Promise((resolve) => {
+            this.server.close(() => {
+                this.status = 'disconnected';
+                this.server = undefined;
+                resolve();
+            });
+        });
+    }
+    async send(content, to) {
+        const url = `https://api.twilio.com/2010-04-01/Accounts/${this.config.twilioAccountSid}/Messages.json`;
+        const auth = Buffer.from(`${this.config.twilioAccountSid}:${this.config.twilioAuthToken}`).toString('base64');
+        const response = await fetch(url, {
+            method: 'POST',
+            headers: {
+                'Authorization': `Basic ${auth}`,
+                'Content-Type': 'application/x-www-form-urlencoded',
+            },
+            body: new URLSearchParams({
+                To: to,
+                From: this.config.phoneNumber,
+                Body: content,
+            }),
+        });
+        if (!response.ok) {
+            const text = await response.text();
+            throw new Error(`Twilio SMS send failed (${response.status}): ${text.slice(0, 200)}`);
+        }
+    }
+    onMessage(handler) {
+        this.handlers.push(handler);
+    }
+    getStatus() {
+        return this.status;
+    }
+    // ==========================================================================
+    // HTTP WEBHOOK
+    // ==========================================================================
+    handleRequest(req, res) {
+        // Health check
+        if (req.method === 'GET' && req.url === '/health') {
+            res.writeHead(200, { 'Content-Type': 'application/json' });
+            res.end(JSON.stringify({ status: 'ok', channel: 'sms' }));
+            return;
+        }
+        if (req.method !== 'POST' || !req.url?.startsWith('/sms/inbound')) {
+            res.writeHead(404);
+            res.end();
+            return;
+        }
+        let body = '';
+        req.on('data', (chunk) => { body += chunk; });
+        req.on('end', () => {
+            // Validate Twilio signature if webhook URL is configured
+            // TODO: re-enable after testing - temporarily disabled to debug flow
+            if (this.config.webhookUrl && process.env['SMS_SKIP_SIGNATURE'] !== 'true') {
+                const signature = req.headers['x-twilio-signature'];
+                if (!signature || !this.validateSignature(signature, body)) {
+                    console.log('[SMS] Signature validation failed — rejecting');
+                    res.writeHead(403);
+                    res.end();
+                    return;
+                }
+            }
+            const params = new URLSearchParams(body);
+            const from = params.get('From');
+            const messageBody = params.get('Body');
+            console.log(`[SMS] Inbound from ${from}: ${messageBody?.slice(0, 50) ?? '(empty)'}`);
+            if (from && messageBody) {
+                const msg = {
+                    id: randomUUID(),
+                    kind: 'percept',
+                    from: randomUUID(),
+                    payload: {
+                        content: messageBody,
+                        platform: 'sms',
+                        remoteJid: from,
+                        messageId: params.get('MessageSid') ?? randomUUID(),
+                    },
+                    timestamp: Date.now(),
+                };
+                for (const handler of this.handlers) {
+                    handler(msg);
+                }
+            }
+            // Return empty TwiML — replies sent via API
+            res.writeHead(200, { 'Content-Type': 'text/xml' });
+            res.end('<Response/>');
+        });
+    }
+    validateSignature(signature, body) {
+        if (!this.config.webhookUrl)
+            return true;
+        // Build sorted param string for Twilio signature validation
+        const params = new URLSearchParams(body);
+        const sortedParams = Array.from(params.entries())
+            .sort(([a], [b]) => a.localeCompare(b))
+            .map(([k, v]) => `${k}${v}`)
+            .join('');
+        const data = this.config.webhookUrl + sortedParams;
+        const expected = createHmac('sha1', this.config.twilioAuthToken)
+            .update(data)
+            .digest('base64');
+        return signature === expected;
+    }
+}
+// ============================================================================
+// FACTORY
+// ============================================================================
+export function createSmsAdapter(config) {
+    return new SmsAdapter(config);
+}
+//# sourceMappingURL=sms.js.map

package/dist/channels/sms.js.map

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

package/dist/channels/telegram.d.ts

@@ -0,0 +1,47 @@
+/**
+ * Telegram Channel Adapter
+ *
+ * Production-ready adapter from Telegram/grammY events to AXON messages.
+ * Rate limits: configurable messages/second (default: 30).
+ * Maintains stable userId → agentId mapping.
+ * Supports chat whitelist for security.
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { ChannelAdapter } from './whatsapp.js';
+import type { Message } from '../primitives/types.js';
+export interface TelegramConfig {
+    identityId: string;
+    /** Messages per second ceiling (default: 30) */
+    rateLimitPerSecond: number;
+    /** Bot token (optional - prefers vault retrieval) */
+    botToken?: string;
+    /** Allowed chat IDs whitelist (optional - if set, ignores other chats) */
+    allowedChatIds?: number[];
+    /** Vault passphrase for token retrieval (required if botToken not provided) */
+    vaultPassphrase?: string;
+}
+export declare class TelegramAdapter extends EventEmitter implements ChannelAdapter {
+    private config;
+    private status;
+    private handlers;
+    private bot?;
+    private vault?;
+    private sendLimiter;
+    private userIdToAgentId;
+    private reconnectAttempts;
+    private maxReconnectAttempts;
+    private reconnectDelayMs;
+    private firewall;
+    constructor(config: TelegramConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(content: string, to: string): Promise<void>;
+    sendPhoto(chatId: number, photoUrl: string, caption?: string): Promise<void>;
+    sendDocument(chatId: number, documentUrl: string, caption?: string): Promise<void>;
+    onMessage(handler: (msg: Message) => void): void;
+    getStatus(): 'connected' | 'disconnected' | 'connecting';
+    private handleIncomingMessage;
+    private handleReconnect;
+}
+export declare function createTelegramAdapter(config: Pick<TelegramConfig, 'identityId'> & Partial<TelegramConfig>): TelegramAdapter;
+//# sourceMappingURL=telegram.d.ts.map

package/dist/channels/telegram.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"telegram.d.ts","sourceRoot":"","sources":["../../src/channels/telegram.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,wBAAwB,CAAC;AAStD,MAAM,WAAW,cAAc;IAC7B,UAAU,EAAE,MAAM,CAAC;IACnB,gDAAgD;IAChD,kBAAkB,EAAE,MAAM,CAAC;IAC3B,qDAAqD;IACrD,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,0EAA0E;IAC1E,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,+EAA+E;IAC/E,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAmCD,qBAAa,eAAgB,SAAQ,YAAa,YAAW,cAAc;IACzE,OAAO,CAAC,MAAM,CAAiB;IAC/B,OAAO,CAAC,MAAM,CAA+D;IAC7E,OAAO,CAAC,QAAQ,CAAqC;IACrD,OAAO,CAAC,GAAG,CAAC,CAAM;IAClB,OAAO,CAAC,KAAK,CAAC,CAAQ;IACtB,OAAO,CAAC,WAAW,CAAuB;IAC1C,OAAO,CAAC,eAAe,CAAkC;IACzD,OAAO,CAAC,iBAAiB,CAAK;IAC9B,OAAO,CAAC,oBAAoB,CAAK;IACjC,OAAO,CAAC,gBAAgB,CAAQ;IAChC,OAAO,CAAC,QAAQ,CAAmE;gBAEvE,MAAM,EAAE,cAAc;IAM5B,OAAO,IAAI,OAAO,CAAC,IAAI,CAAC;IAwDxB,UAAU,IAAI,OAAO,CAAC,IAAI,CAAC;IAS3B,IAAI,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAyChD,SAAS,CAAC,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsB5E,YAAY,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAsBxF,SAAS,CAAC,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,GAAG,IAAI;IAIhD,SAAS,IAAI,WAAW,GAAG,cAAc,GAAG,YAAY;YAI1C,qBAAqB;YA8DrB,eAAe;CAqB9B;AAUD,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,IAAI,CAAC,cAAc,EAAE,YAAY,CAAC,GAAG,OAAO,CAAC,cAAc,CAAC,GACnE,eAAe,CAEjB"}

package/dist/channels/telegram.js

@@ -0,0 +1,276 @@
+/**
+ * Telegram Channel Adapter
+ *
+ * Production-ready adapter from Telegram/grammY events to AXON messages.
+ * Rate limits: configurable messages/second (default: 30).
+ * Maintains stable userId → agentId mapping.
+ * Supports chat whitelist for security.
+ */
+import { EventEmitter } from 'eventemitter3';
+import { Bot } from 'grammy';
+import { randomUUID } from 'crypto';
+import { createVault } from '../security/vault.js';
+import { createFirewallMiddleware } from '../security/channelFirewallMiddleware.js';
+// ============================================================================
+// RATE LIMITER
+// ============================================================================
+class SlidingWindowLimiter {
+    timestamps = [];
+    maxRequests;
+    windowMs;
+    constructor(maxRequests, windowMs) {
+        this.maxRequests = maxRequests;
+        this.windowMs = windowMs;
+    }
+    check() {
+        this.prune();
+        return this.timestamps.length < this.maxRequests;
+    }
+    record() {
+        this.timestamps.push(Date.now());
+    }
+    prune() {
+        const cutoff = Date.now() - this.windowMs;
+        this.timestamps = this.timestamps.filter(t => t > cutoff);
+    }
+}
+// ============================================================================
+// TELEGRAM ADAPTER
+// ============================================================================
+export class TelegramAdapter extends EventEmitter {
+    config;
+    status = 'disconnected';
+    handlers = [];
+    bot;
+    vault;
+    sendLimiter;
+    userIdToAgentId = new Map();
+    reconnectAttempts = 0;
+    maxReconnectAttempts = 5;
+    reconnectDelayMs = 5000;
+    firewall = createFirewallMiddleware('standard');
+    constructor(config) {
+        super();
+        this.config = config;
+        this.sendLimiter = new SlidingWindowLimiter(config.rateLimitPerSecond, 1000);
+    }
+    async connect() {
+        this.status = 'connecting';
+        try {
+            let botToken = this.config.botToken;
+            if (!botToken) {
+                if (!this.config.vaultPassphrase) {
+                    throw new Error('Either botToken or vaultPassphrase must be provided');
+                }
+                this.vault = await createVault(this.config.vaultPassphrase);
+                const vaultKey = `telegram:${this.config.identityId}`;
+                const retrieved = await this.vault.retrieve(vaultKey);
+                botToken = retrieved ?? undefined;
+                if (!botToken) {
+                    throw new Error(`Bot token not found in vault for key: ${vaultKey}`);
+                }
+            }
+            this.bot = new Bot(botToken);
+            this.bot.on('message:text', async (ctx) => {
+                try {
+                    await this.handleIncomingMessage(ctx);
+                }
+                catch (err) {
+                    console.error('Telegram message handler error:', err);
+                }
+            });
+            this.bot.catch((err) => {
+                console.error('Telegram bot error:', err);
+                this.emit('error', err);
+                if (this.status === 'connected') {
+                    void this.handleReconnect();
+                }
+            });
+            await this.bot.start({
+                onStart: (botInfo) => {
+                    console.log(`Telegram bot started: @${botInfo.username}`);
+                },
+            });
+            this.status = 'connected';
+            this.reconnectAttempts = 0;
+            this.emit('connected');
+        }
+        catch (err) {
+            this.status = 'disconnected';
+            console.error('Telegram connection error:', err);
+            throw err;
+        }
+    }
+    async disconnect() {
+        if (this.bot) {
+            await this.bot.stop();
+            this.bot = undefined;
+        }
+        this.status = 'disconnected';
+        this.emit('disconnected');
+    }
+    async send(content, to) {
+        if (this.status !== 'connected') {
+            throw new Error('Telegram adapter not connected');
+        }
+        if (!this.bot) {
+            throw new Error('Telegram bot not initialized');
+        }
+        if (!this.sendLimiter.check()) {
+            throw new Error(`Telegram rate limit (${this.config.rateLimitPerSecond}/sec) exceeded`);
+        }
+        const chatId = parseInt(to, 10);
+        if (isNaN(chatId)) {
+            throw new Error(`Invalid chat ID: ${to}`);
+        }
+        try {
+            await this.bot.api.sendMessage(chatId, content, {
+                parse_mode: 'Markdown',
+            });
+            this.sendLimiter.record();
+            const msg = {
+                id: randomUUID(),
+                kind: 'act',
+                from: this.config.identityId,
+                to: undefined,
+                payload: { content, chatId, platform: 'telegram' },
+                timestamp: Date.now(),
+            };
+            this.emit('send', msg);
+        }
+        catch (err) {
+            console.error(`Telegram send error to ${chatId}:`, err);
+            throw err;
+        }
+    }
+    async sendPhoto(chatId, photoUrl, caption) {
+        if (this.status !== 'connected' || !this.bot) {
+            throw new Error('Telegram adapter not connected');
+        }
+        if (!this.sendLimiter.check()) {
+            throw new Error(`Telegram rate limit (${this.config.rateLimitPerSecond}/sec) exceeded`);
+        }
+        try {
+            await this.bot.api.sendPhoto(chatId, photoUrl, {
+                caption,
+                parse_mode: 'Markdown',
+            });
+            this.sendLimiter.record();
+        }
+        catch (err) {
+            console.error(`Telegram sendPhoto error to ${chatId}:`, err);
+            throw err;
+        }
+    }
+    async sendDocument(chatId, documentUrl, caption) {
+        if (this.status !== 'connected' || !this.bot) {
+            throw new Error('Telegram adapter not connected');
+        }
+        if (!this.sendLimiter.check()) {
+            throw new Error(`Telegram rate limit (${this.config.rateLimitPerSecond}/sec) exceeded`);
+        }
+        try {
+            await this.bot.api.sendDocument(chatId, documentUrl, {
+                caption,
+                parse_mode: 'Markdown',
+            });
+            this.sendLimiter.record();
+        }
+        catch (err) {
+            console.error(`Telegram sendDocument error to ${chatId}:`, err);
+            throw err;
+        }
+    }
+    onMessage(handler) {
+        this.handlers.push(handler);
+    }
+    getStatus() {
+        return this.status;
+    }
+    async handleIncomingMessage(ctx) {
+        const chatId = ctx.chat?.id;
+        const chatType = ctx.chat?.type;
+        const userId = ctx.from?.id;
+        const username = ctx.from?.username;
+        const firstName = ctx.from?.first_name;
+        const text = ctx.message?.text;
+        const messageId = ctx.message?.message_id;
+        const timestamp = ctx.message?.date;
+        if (!text || !chatId || !userId)
+            return;
+        if (this.config.allowedChatIds && !this.config.allowedChatIds.includes(chatId)) {
+            console.log(`Telegram: Ignoring message from non-whitelisted chat ${chatId}`);
+            return;
+        }
+        const firewallResult = this.firewall.process(text, 'channel-bridged');
+        if (!firewallResult.safe) {
+            this.emit('message:blocked', {
+                reason: firewallResult.threats,
+                chatId,
+                userId,
+                timestamp: Date.now(),
+            });
+            console.log(`Telegram: Blocked message from ${userId} due to firewall threats:`, firewallResult.threats);
+            return;
+        }
+        let agentId = this.userIdToAgentId.get(userId);
+        if (!agentId) {
+            agentId = randomUUID();
+            this.userIdToAgentId.set(userId, agentId);
+        }
+        const msg = {
+            id: randomUUID(),
+            kind: 'percept',
+            from: agentId,
+            to: this.config.identityId,
+            payload: {
+                content: firewallResult.sanitized,
+                platform: 'telegram',
+                chatId,
+                chatType,
+                fromUsername: username,
+                fromName: firstName,
+                messageId,
+                userId,
+            },
+            timestamp: timestamp * 1000,
+        };
+        for (const handler of this.handlers) {
+            try {
+                handler(msg);
+            }
+            catch (err) {
+                console.error('Telegram message handler error:', err);
+            }
+        }
+    }
+    async handleReconnect() {
+        if (this.reconnectAttempts >= this.maxReconnectAttempts) {
+            console.error('Telegram: Max reconnect attempts reached, giving up');
+            this.status = 'disconnected';
+            this.emit('disconnected');
+            return;
+        }
+        this.reconnectAttempts++;
+        console.log(`Telegram: Reconnecting (attempt ${this.reconnectAttempts}/${this.maxReconnectAttempts})...`);
+        await new Promise(resolve => setTimeout(resolve, this.reconnectDelayMs));
+        try {
+            await this.disconnect();
+            await this.connect();
+        }
+        catch (err) {
+            console.error('Telegram reconnect failed:', err);
+            void this.handleReconnect();
+        }
+    }
+}
+// ============================================================================
+// FACTORY
+// ============================================================================
+const DEFAULT_CONFIG = {
+    rateLimitPerSecond: 30,
+};
+export function createTelegramAdapter(config) {
+    return new TelegramAdapter({ ...DEFAULT_CONFIG, ...config });
+}
+//# sourceMappingURL=telegram.js.map

package/dist/channels/telegram.js.map

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

package/dist/channels/twitter.d.ts

@@ -0,0 +1,93 @@
+/**
+ * Twitter/X Channel Adapter
+ *
+ * Thin adapter using agent-twitter-client (Scraper) to AXON messages.
+ * Rate limits: 50 tweets/day, 1 tweet/2min cooldown, mention polling every 60s.
+ */
+import { EventEmitter } from 'eventemitter3';
+import type { ChannelAdapter } from './whatsapp.js';
+import type { Message } from '../primitives/types.js';
+import { SearchMode, type Tweet } from 'agent-twitter-client';
+export interface TwitterConfig {
+    identityId: string;
+    username: string;
+    password: string;
+    email: string;
+    /** Optional cookies for session restore */
+    cookies?: string;
+    /** Poll interval for mentions/timeline (default: 60000ms = 1 minute) */
+    pollIntervalMs: number;
+    /** Daily tweet limit (default: 50) */
+    dailyTweetLimit: number;
+    /** Cooldown between tweets in ms (default: 120000 = 2 minutes) */
+    tweetCooldownMs: number;
+}
+export interface TwitterMention {
+    tweetId: string;
+    fromUsername: string;
+    fromUserId: string;
+    content: string;
+    timestamp: number;
+    isReply: boolean;
+    replyToTweetId?: string;
+}
+export declare class TwitterAdapter extends EventEmitter implements ChannelAdapter {
+    private config;
+    private status;
+    private handlers;
+    private scraper;
+    private pollTimer?;
+    private lastSeenMentionId?;
+    private dailyTweetLimiter;
+    private tweetCooldown;
+    private firewall;
+    constructor(config: TwitterConfig);
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    send(content: string, to?: string): Promise<void>;
+    onMessage(handler: (msg: Message) => void): void;
+    getStatus(): 'connected' | 'disconnected' | 'connecting';
+    /**
+     * Post a thread (chain of tweets replying to each other).
+     */
+    createThread(tweets: string[]): Promise<string[]>;
+    /**
+     * Like a tweet.
+     */
+    like(tweetId: string): Promise<void>;
+    /**
+     * Retweet a tweet.
+     */
+    retweet(tweetId: string): Promise<void>;
+    /**
+     * Follow a user.
+     */
+    follow(username: string): Promise<void>;
+    /**
+     * Get timeline tweets.
+     */
+    getTimeline(count?: number): Promise<Tweet[]>;
+    /**
+     * Search for tweets matching a query.
+     */
+    search(query: string, count?: number, mode?: SearchMode): Promise<Tweet[]>;
+    /**
+     * Get current session cookies (for persistence).
+     */
+    getCookies(): Promise<string>;
+    /**
+     * Poll for new mentions and translate to AXON percept messages.
+     */
+    private pollMentions;
+    /**
+     * Translate a Tweet object to AXON percept message.
+     */
+    private translateTweet;
+    /**
+     * Handle an incoming tweet (for webhook/push integration).
+     */
+    handleIncoming(tweet: Tweet): void;
+    private enforceRateLimits;
+}
+export declare function createTwitterAdapter(config: Pick<TwitterConfig, 'identityId' | 'username' | 'password' | 'email'> & Partial<TwitterConfig>): TwitterAdapter;
+//# sourceMappingURL=twitter.d.ts.map

package/dist/channels/twitter.d.ts.map

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