@saccolabs/tars 1.7.0 → 1.7.1

package/README.md

@@ -66,7 +66,7 @@ npm install -g @saccolabs/tars
 
 ### Initial Setup
 
-Run the setup wizard to authorize Gemini and connect your Discord bot:
+Run the setup wizard to authorize Gemini and connect your communication channels (Discord, WhatsApp, or both):
 
 ```bash
 tars setup
@@ -87,9 +87,11 @@ tars setup
 
 ### Interaction
 
-Tars communicates primarily through a private Discord channel. It supports file uploads, long-running task management, and complex multi-step instructions.
+Tars communicates through a multi-channel architecture. You can interact via **Discord**, **WhatsApp**, or both simultaneously. It supports file uploads, long-running task management, and complex multi-step instructions.
 
-> **!tars** "Analyze the logs in /var/log/syslog and summarize any critical errors."
+> **Discord**: `!tars Analyze the logs in /var/log/syslog and summarize any critical errors.`
+>
+> **WhatsApp**: Just send a message directly — no prefix needed.
 
 ---
 
@@ -97,10 +99,11 @@ Tars communicates primarily through a private Discord channel. It supports file
 
 Tars utilizes a Supervisor-Orchestrator model:
 
-1. **Supervisor**: Manages persistent sessions and Discord communication.
-2. **Subagents**: Specialized expert agents invoked dynamically for specific technical domains.
-3. **Heartbeat**: Cron-based engine for autonomous execution and cleanup.
-4. **Extensions**: MCP servers that provide tool-level capabilities to the intelligence core.
+1. **Supervisor**: Manages persistent sessions and multi-channel communication.
+2. **Channel Manager**: Orchestrates communication across Discord and WhatsApp with automatic notification routing.
+3. **Subagents**: Specialized expert agents invoked dynamically for specific technical domains.
+4. **Heartbeat**: Cron-based engine for autonomous execution and cleanup.
+5. **Extensions**: MCP servers that provide tool-level capabilities to the intelligence core.
 
 ---
 

package/dist/channels/channel-manager.d.ts

@@ -0,0 +1,35 @@
+import { CommunicationChannel, ChannelMessage } from './types.js';
+/**
+ * Orchestrates all communication channels (Discord, WhatsApp, etc.)
+ */
+export declare class ChannelManager {
+    private readonly channels;
+    private readonly config;
+    private messageHandler?;
+    private lastActiveChannelId?;
+    constructor();
+    /**
+     * Initialize enabled channels based on configuration
+     */
+    private initializeChannels;
+    /**
+     * Start all enabled channels
+     */
+    start(): Promise<void>;
+    /**
+     * Stop all channels
+     */
+    stop(): Promise<void>;
+    /**
+     * Register a global handler for messages from any channel
+     */
+    onMessage(handler: (message: ChannelMessage) => Promise<void>): void;
+    /**
+     * Send a proactive notification
+     */
+    notify(content: string, attachments?: string[]): Promise<void>;
+    /**
+     * Get a specific channel by ID
+     */
+    getChannel(id: string): CommunicationChannel | undefined;
+}

package/dist/channels/channel-manager.js

@@ -0,0 +1,94 @@
+import { DiscordChannel } from './discord/discord-channel.js';
+import logger from '../utils/logger.js';
+import { Config } from '../config/config.js';
+/**
+ * Orchestrates all communication channels (Discord, WhatsApp, etc.)
+ */
+export class ChannelManager {
+    channels = new Map();
+    config;
+    messageHandler;
+    lastActiveChannelId;
+    constructor() {
+        this.config = Config.getInstance();
+        this.initializeChannels();
+    }
+    /**
+     * Initialize enabled channels based on configuration
+     */
+    initializeChannels() {
+        // 1. Initialize Discord
+        const discord = new DiscordChannel();
+        if (discord.isEnabled) {
+            this.channels.set(discord.id, discord);
+        }
+    }
+    /**
+     * Start all enabled channels
+     */
+    async start() {
+        if (this.channels.size === 0) {
+            logger.warn('⚠️ No communication channels enabled. Tars will be unreachable.');
+            return;
+        }
+        logger.info(`🚀 Starting ${this.channels.size} communication channel(s)...`);
+        for (const channel of this.channels.values()) {
+            try {
+                channel.onMessage(async (message) => {
+                    this.lastActiveChannelId = channel.id;
+                    if (this.messageHandler) {
+                        await this.messageHandler(message);
+                    }
+                });
+                await channel.start();
+            }
+            catch (error) {
+                logger.error(`Failed to start channel ${channel.id}: ${error.message}`);
+            }
+        }
+    }
+    /**
+     * Stop all channels
+     */
+    async stop() {
+        logger.info('Stopping all communication channels...');
+        for (const channel of this.channels.values()) {
+            await channel
+                .stop()
+                .catch((e) => logger.error(`Error stopping ${channel.id}: ${e.message}`));
+        }
+    }
+    /**
+     * Register a global handler for messages from any channel
+     */
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    /**
+     * Send a proactive notification
+     */
+    async notify(content, attachments) {
+        const primaryChannelId = this.lastActiveChannelId || this.config.primaryChannel || 'discord';
+        const channel = this.channels.get(primaryChannelId);
+        if (channel) {
+            await channel.notify(content, attachments);
+        }
+        else {
+            // Fallback to the first available channel if primary is not found
+            const fallback = Array.from(this.channels.values())[0];
+            if (fallback) {
+                await fallback.notify(content, attachments);
+            }
+            else {
+                logger.warn(`No active channels available for notification.`);
+            }
+        }
+    }
+    /**
+     * Get a specific channel by ID
+     */
+    getChannel(id) {
+        return this.channels.get(id);
+    }
+}
+//# sourceMappingURL=channel-manager.js.map

package/dist/channels/channel-manager.js.map

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

package/dist/channels/discord/discord-channel.d.ts

@@ -0,0 +1,41 @@
+import { CommunicationChannel, ChannelMessage } from '../types.js';
+/**
+ * Discord Channel Implementation for Tars
+ */
+export declare class DiscordChannel implements CommunicationChannel {
+    readonly id = "discord";
+    private readonly config;
+    private readonly client;
+    private readonly processor;
+    private messageHandler?;
+    constructor();
+    get isEnabled(): boolean;
+    /**
+     * Start the Discord bot
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the Discord bot
+     */
+    stop(): Promise<void>;
+    /**
+     * Send a proactive notification to the primary contact
+     */
+    notify(content: string, attachments?: string[]): Promise<void>;
+    /**
+     * Register message handler
+     */
+    onMessage(handler: (message: ChannelMessage) => Promise<void>): void;
+    /**
+     * Setup event handlers
+     */
+    private setupEventHandlers;
+    /**
+     * Internal handler for Discord-specific messages
+     */
+    private handleIncomingMessage;
+    /**
+     * Extract prompt and handle prefix
+     */
+    private extractPrompt;
+}

package/dist/channels/discord/discord-channel.js

@@ -0,0 +1,203 @@
+import { Client, GatewayIntentBits, ChannelType, Partials } from 'discord.js';
+import { Config } from '../../config/config.js';
+import logger from '../../utils/logger.js';
+import { MessageFormatter } from './message-formatter.js';
+import { AttachmentProcessor } from '../../utils/attachment-processor.js';
+/**
+ * Discord Channel Implementation for Tars
+ */
+export class DiscordChannel {
+    id = 'discord';
+    config;
+    client;
+    processor;
+    messageHandler;
+    constructor() {
+        this.config = Config.getInstance();
+        this.processor = new AttachmentProcessor(this.config);
+        this.client = new Client({
+            intents: [
+                GatewayIntentBits.Guilds,
+                GatewayIntentBits.GuildMessages,
+                GatewayIntentBits.MessageContent,
+                GatewayIntentBits.DirectMessages
+            ],
+            partials: [Partials.Channel, Partials.Message]
+        });
+        this.setupEventHandlers();
+    }
+    get isEnabled() {
+        // For backward compatibility, if no explicit channels are configured but discordToken exists, it's enabled.
+        // Once WhatsApp is added, we'll use structured config.
+        return !!this.config.discordToken;
+    }
+    /**
+     * Start the Discord bot
+     */
+    async start() {
+        if (!this.isEnabled) {
+            logger.info('Discord channel is disabled.');
+            return;
+        }
+        await this.client.login(this.config.discordToken);
+    }
+    /**
+     * Stop the Discord bot
+     */
+    async stop() {
+        this.client.destroy();
+    }
+    /**
+     * Send a proactive notification to the primary contact
+     */
+    async notify(content, attachments) {
+        if (!this.config.discordOwnerId || !content.trim())
+            return;
+        try {
+            const user = await this.client.users.fetch(this.config.discordOwnerId);
+            if (user) {
+                const formatted = MessageFormatter.format(content);
+                const files = attachments || [];
+                if (formatted.length > 8000) {
+                    const filePath = this.processor.saveResponse(content, 'md');
+                    await user.send({
+                        content: `🔔 **Task Notification** (Response too long, see attached):`,
+                        files: [filePath, ...files]
+                    });
+                }
+                else {
+                    const chunks = MessageFormatter.split(formatted);
+                    for (let i = 0; i < chunks.length; i++) {
+                        const prefix = i === 0 ? `🔔 **Task Notification:**\n` : ``;
+                        await user.send({
+                            content: prefix + chunks[i],
+                            files: i === chunks.length - 1 ? files : []
+                        });
+                    }
+                }
+            }
+        }
+        catch (e) {
+            logger.error(`Failed to send proactive notification via Discord: ${e.message}`);
+        }
+    }
+    /**
+     * Register message handler
+     */
+    onMessage(handler) {
+        this.messageHandler = handler;
+    }
+    /**
+     * Setup event handlers
+     */
+    setupEventHandlers() {
+        this.client.once('clientReady', (c) => {
+            logger.info(`🚀 Discord channel online as ${c.user.tag}`);
+            if (this.config.discordOwnerId) {
+                logger.info(`👤 Primary Discord Contact ID: ${this.config.discordOwnerId}`);
+            }
+            else {
+                logger.warn(`⚠️ No Primary Discord Contact ID set. Will bind to the first user who sends a message.`);
+            }
+        });
+        this.client.on('messageCreate', this.handleIncomingMessage.bind(this));
+    }
+    /**
+     * Internal handler for Discord-specific messages
+     */
+    async handleIncomingMessage(message) {
+        if (message.author.bot || !this.messageHandler)
+            return;
+        const userPrompt = this.extractPrompt(message);
+        if (userPrompt === null)
+            return;
+        // Auto-Bind on first interaction if not set
+        const wasAutoBound = !this.config.discordOwnerId;
+        if (wasAutoBound) {
+            this.config.discordOwnerId = message.author.id;
+            if (this.config.channels.discord) {
+                this.config.channels.discord.ownerId = message.author.id;
+            }
+            this.config.saveSettings();
+            logger.info(`🔒 Automatically bound Primary Contact to Discord user: ${message.author.id} (Channel: ${message.channelId})`);
+        }
+        if (!userPrompt && message.attachments.size === 0)
+            return;
+        // Handle Attachments
+        const attachments = [];
+        if (message.attachments.size > 0) {
+            for (const [id, attachment] of message.attachments) {
+                try {
+                    const filePath = await this.processor.download(attachment);
+                    if (attachment.contentType) {
+                        attachments.push({
+                            path: filePath,
+                            mimeType: attachment.contentType
+                        });
+                    }
+                }
+                catch (err) {
+                    logger.error(`Failed to download Discord attachment: ${err.message}`);
+                }
+            }
+        }
+        // Map to common ChannelMessage
+        const channelMessage = {
+            content: userPrompt,
+            senderId: message.author.id,
+            senderName: message.author.username,
+            channelId: message.channelId,
+            attachments,
+            metadata: { wasAutoBound },
+            reply: async (response, outAttachments) => {
+                const formatted = MessageFormatter.format(response);
+                if (formatted.length > 8000) {
+                    const filePath = this.processor.saveResponse(response, 'md');
+                    await message.reply({
+                        content: `📄 **Response too long** (${formatted.length} chars). See attached file:`,
+                        files: [filePath, ...(outAttachments || [])]
+                    });
+                }
+                else {
+                    const chunks = MessageFormatter.split(formatted);
+                    for (let i = 0; i < chunks.length; i++) {
+                        await message.reply({
+                            content: chunks[i],
+                            files: i === chunks.length - 1 ? outAttachments || [] : []
+                        });
+                    }
+                }
+            }
+        };
+        // Show typing indicator
+        if ('sendTyping' in message.channel) {
+            await message.channel.sendTyping().catch(() => { });
+        }
+        // Forward to the registered handler (Supervisor via ChannelManager)
+        await this.messageHandler(channelMessage);
+    }
+    /**
+     * Extract prompt and handle prefix
+     */
+    extractPrompt(message) {
+        const isDM = message.channel.type === ChannelType.DM;
+        const isMentioned = this.client.user && message.mentions.has(this.client.user);
+        const customPrefix = `!${this.config.assistantName.toLowerCase()}`;
+        const hasCustomCommand = message.content.toLowerCase().startsWith(customPrefix);
+        const hasLegacyCommand = message.content.toLowerCase().startsWith('!tars');
+        if (!isDM && !isMentioned && !hasCustomCommand && !hasLegacyCommand)
+            return null;
+        let prompt = message.content;
+        if (hasCustomCommand) {
+            prompt = prompt.substring(customPrefix.length);
+        }
+        else if (hasLegacyCommand) {
+            prompt = prompt.substring(6); // length of '!tars'
+        }
+        if (isMentioned && this.client.user) {
+            prompt = prompt.replace(new RegExp(`<@!?${this.client.user.id}>`, 'g'), '');
+        }
+        return prompt.trim();
+    }
+}
+//# sourceMappingURL=discord-channel.js.map

package/dist/channels/discord/discord-channel.js.map

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

package/dist/channels/discord/message-formatter.d.ts

@@ -0,0 +1,95 @@
+/**
+ * Discord Message Formatter
+ *
+ * Transforms Gemini CLI output (GitHub Flavored Markdown)
+ * into Discord-compatible formatting.
+ *
+ * Discord supports:
+ * - Bold: **text**
+ * - Italic: *text* or _text_
+ * - Underline: __text__
+ * - Strikethrough: ~~text~~
+ * - Code inline: `text`
+ * - Code block: ```lang\ncode\n```
+ * - Blockquotes: > text
+ * - Headers: # (only #, ##, ###)
+ *
+ * Discord does NOT support:
+ * - Markdown tables (we instruct the LLM to avoid these)
+ * - #### or deeper headers
+ * - Small text (-#)
+ */
+export declare class MessageFormatter {
+    private static readonly MAX_MESSAGE_LENGTH;
+    /**
+     * Format text for Discord
+     */
+    static format(text: string): string;
+    /**
+     * Fix critical spacing issues from LLM output
+     * These are the most common formatting bugs that break Discord rendering
+     */
+    private static fixSpacing;
+    /**
+     * Fix broken asterisks patterns
+     * Only fixes obviously broken patterns, avoids aggressive matching
+     */
+    private static fixAsterisks;
+    /**
+     * Normalize bullet points for Discord
+     */
+    private static normalizeBullets;
+    /**
+     * Normalize markdown headers to Discord-friendly format
+     * Discord supports #, ##, ### natively now.
+     */
+    private static normalizeHeaders;
+    /**
+     * Fix blockquote formatting
+     */
+    private static fixBlockquotes;
+    /**
+     * Detect and wrap JSON-like content in code blocks
+     */
+    private static formatJsonBlocks;
+    /**
+     * Strip markdown tables - they don't render well on mobile Discord
+     * This is a fallback; the LLM should be instructed not to generate tables
+     */
+    private static stripTables;
+    /**
+     * Fix small text markers (-#) that Discord doesn't support
+     */
+    private static fixSmallText;
+    /**
+     * Split long messages into Discord-safe chunks intelligently
+     * Respects semantic boundaries: headers, code blocks, paragraphs
+     */
+    static split(text: string, maxLength?: number): string[];
+    /**
+     * Find the optimal split point respecting semantic boundaries
+     * Priority: Header > Code block boundary > Paragraph > Sentence > Hard cut
+     */
+    private static findSemanticSplitPoint;
+    /**
+     * Format and split in one operation
+     * Ensures summary line (first line with actionable emoji) stays at the top
+     */
+    static formatAndSplit(text: string): string[];
+    /**
+     * Extract the summary line from the beginning of formatted text
+     * Summary lines start with key actionable emojis: 🎯 ⚖️ 📊 ⚠️ ✅ ❓
+     */
+    private static extractSummaryLine;
+    /**
+     * Parse markdown into sections based on headers (##)
+     */
+    static parseSections(text: string): {
+        title: string;
+        content: string;
+    }[];
+    /**
+     * Format a data object as a clean Discord-friendly list
+     */
+    static formatDataAsEmbed(title: string, data: Record<string, unknown>): string;
+}