@saccolabs/tars 1.0.7

package/dist/cli/commands/uninstall.js

@@ -0,0 +1,91 @@
+import pm2 from 'pm2';
+import chalk from 'chalk';
+import inquirer from 'inquirer';
+import fs from 'fs/promises';
+import { existsSync } from 'fs';
+import os from 'os';
+import path from 'path';
+import { execSync } from 'child_process';
+import ora from 'ora';
+export async function uninstall() {
+    console.log(chalk.red.bold('\n⚠️  DANGER ZONE: Uninstall Tars ⚠️\n'));
+    console.log(chalk.white('This action will:'));
+    console.log(chalk.red('  1. Stop and remove the Tars background supervisor'));
+    console.log(chalk.red('  2. PERMANENTLY DELETE ~/.tars (Your Brain, Memories, and Data)'));
+    console.log(chalk.red('  3. Remove all configuration and logs\n'));
+    const { confirm } = await inquirer.prompt([
+        {
+            type: 'confirm',
+            name: 'confirm',
+            message: 'Are you absolutely sure you want to proceed?',
+            default: false
+        }
+    ]);
+    if (!confirm) {
+        console.log(chalk.cyan('\nUninstall cancelled.'));
+        return;
+    }
+    const { finalConfirm } = await inquirer.prompt([
+        {
+            type: 'input',
+            name: 'finalConfirm',
+            message: 'Type "delete" to confirm complete removal:',
+            validate: (input) => (input === 'delete' ? true : 'You must type "delete" to confirm.')
+        }
+    ]);
+    if (finalConfirm !== 'delete') {
+        console.log(chalk.cyan('\nUninstall cancelled.'));
+        return;
+    }
+    console.log('\nStarting uninstallation...\n');
+    // 1. Stop Tars
+    const stopSpinner = ora('Stopping Tars services...').start();
+    await new Promise((resolve) => {
+        pm2.connect((err) => {
+            if (err) {
+                // If PM2 fails, we just try to kill manually
+                forceKill();
+                resolve();
+                return;
+            }
+            pm2.delete('tars-supervisor', (delErr) => {
+                pm2.disconnect();
+                // Even if delete fails (e.g. not running), force kill
+                forceKill();
+                resolve();
+            });
+        });
+    });
+    stopSpinner.succeed('Tars services stopped.');
+    // 2. Remove ~/.tars
+    const cleanSpinner = ora('Removing ~/.tars directory...').start();
+    const tarsHome = process.env.TARS_HOME || path.join(process.env.REAL_HOME || os.homedir(), '.tars');
+    if (existsSync(tarsHome)) {
+        try {
+            await fs.rm(tarsHome, { recursive: true, force: true });
+            cleanSpinner.succeed('Data directory (~/.tars) permanently removed.');
+        }
+        catch (error) {
+            cleanSpinner.fail(`Failed to remove ~/.tars: ${error.message}`);
+            console.log(chalk.yellow('\nYou may need to manually remove the directory using: rm -rf ~/.tars'));
+        }
+    }
+    else {
+        cleanSpinner.info('~/.tars directory not found (already clean).');
+    }
+    // 3. Final message
+    console.log(chalk.green.bold('\n✅ Tars has been scrubbed from this system.'));
+    console.log(chalk.white('\nTo complete the removal, uninstall the CLI package:'));
+    console.log(chalk.cyan('  npm uninstall -g @saccolabs/tars'));
+    console.log(chalk.dim('\nGoodbye! 👋'));
+    process.exit(0);
+}
+function forceKill() {
+    try {
+        execSync('pkill -9 -f "supervisor/main.js" || true', { stdio: 'ignore' });
+    }
+    catch (e) {
+        // Ignore
+    }
+}
+//# sourceMappingURL=uninstall.js.map

package/dist/cli/commands/uninstall.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/dist/cli/index.js

@@ -0,0 +1,54 @@
+#!/usr/bin/env node
+import { Command } from 'commander';
+import { setup } from './commands/setup.js';
+import { start } from './commands/start.js';
+import { stop } from './commands/stop.js';
+import { status } from './commands/status.js';
+import { exportBrain } from './commands/export.js';
+import { importBrain } from './commands/import.js';
+import { logs } from './commands/logs.js';
+import { discord } from './commands/discord.js';
+import { secret } from './commands/secret.js';
+import { memory } from './commands/memory.js';
+import { uninstall } from './commands/uninstall.js';
+import { versionString } from '../utils/version.js';
+const program = new Command();
+program.name('tars').description('Tars — Personal AI Assistant').version(versionString);
+program
+    .command('setup')
+    .description('Interactive onboarding wizard to configure Tars')
+    .action(setup);
+program.command('start').description('Start Tars supervisor in the background').action(start);
+program.command('stop').description('Stop the Tars supervisor').action(stop);
+program.command('status').description('Check the status of Tars supervisor').action(status);
+program
+    .command('export')
+    .description('Export your brain (memories, tasks, extensions)')
+    .option('-o, --output <path>', 'Output path for the archive')
+    .action(exportBrain);
+program
+    .command('import')
+    .description('Import a brain from an archive')
+    .argument('<path>', 'Path to the brain archive (.tar.gz)')
+    .action(importBrain);
+program.command('logs').description('View real-time logs from the Tars supervisor').action(logs);
+program
+    .command('discord')
+    .description('View instructions for Discord bot setup and invitation')
+    .action(discord);
+program
+    .command('secret')
+    .description('Manage secure environment variables for extensions')
+    .argument('<action>', 'Action to perform (set, list, remove)')
+    .argument('[key]', 'Secret key')
+    .argument('[value]', 'Secret value (required for set)')
+    .action(secret);
+program
+    .command('memory')
+    .description('Search or sync your brain knowledge')
+    .argument('<action>', 'Action to perform (search, sync)')
+    .argument('[query...]', 'Search query')
+    .action((action, queryArgs) => memory(action, ...queryArgs));
+program.command('uninstall').description('Uninstall Tars and remove all data').action(uninstall);
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

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

package/dist/config/config.d.ts

@@ -0,0 +1,14 @@
+export declare class Config {
+    private static instance;
+    readonly homeDir: string;
+    readonly taskFilePath: string;
+    readonly sessionFilePath: string;
+    readonly configFilePath: string;
+    readonly memoryDbPath: string;
+    readonly discordToken: string;
+    readonly geminiModel: string;
+    readonly heartbeatIntervalMs: number;
+    readonly systemPromptPath: string;
+    private constructor();
+    static getInstance(): Config;
+}

package/dist/config/config.js

@@ -0,0 +1,69 @@
+import path from 'path';
+import os from 'os';
+import fs from 'fs';
+import dotenv from 'dotenv';
+import logger from '../utils/logger.js';
+import { SecretsManager } from '../utils/secrets-manager.js';
+dotenv.config();
+export class Config {
+    static instance;
+    // Paths
+    homeDir;
+    taskFilePath;
+    sessionFilePath;
+    configFilePath;
+    memoryDbPath;
+    // Discord
+    discordToken;
+    // Gemini
+    geminiModel;
+    heartbeatIntervalMs;
+    // System Prompt
+    systemPromptPath;
+    constructor() {
+        // 1. Establish Home Directory (~/.tars)
+        // Hardcode the base to be the real user home to avoid recursion if HOME is changed for subprocesses
+        const realUserHome = process.env.REAL_HOME || os.homedir();
+        this.homeDir =
+            process.env.TARS_HOME || path.join(realUserHome.replace('/.tars', ''), '.tars');
+        this.configFilePath = path.join(this.homeDir, 'config.json');
+        // 1.5 Load Secrets into environment
+        const secretsManager = new SecretsManager(this.homeDir);
+        const secrets = secretsManager.load();
+        for (const [key, value] of Object.entries(secrets)) {
+            // Load into process.env so they are available globally
+            process.env[key] = value;
+        }
+        // 2. Load JSON Config if exists
+        let jsonConfig = {};
+        try {
+            if (fs.existsSync(this.configFilePath)) {
+                jsonConfig = JSON.parse(fs.readFileSync(this.configFilePath, 'utf-8'));
+            }
+        }
+        catch (error) {
+            logger.warn(`Could not read config file: ${this.configFilePath}`);
+        }
+        // 3. Set values (Env vars override JSON config)
+        this.discordToken = process.env.DISCORD_TOKEN || jsonConfig.discordToken || '';
+        this.geminiModel = process.env.GEMINI_MODEL || jsonConfig.geminiModel || 'auto';
+        const hbSec = process.env.HEARTBEAT_INTERVAL_SEC || jsonConfig.heartbeatIntervalSec || '300';
+        this.heartbeatIntervalMs = parseInt(String(hbSec), 10) * 1000;
+        // 4. Derived Paths
+        this.taskFilePath = path.join(this.homeDir, 'data', 'tasks.json');
+        this.sessionFilePath = path.join(this.homeDir, 'data', 'session.json');
+        this.systemPromptPath = path.join(this.homeDir, '.gemini', 'system.md');
+        this.memoryDbPath = path.join(this.homeDir, 'data', 'knowledge.db');
+        // Note: validation happens in specific services if needed, but we can do a basic check
+        if (!this.discordToken) {
+            logger.warn('⚠️ No Discord Token found. Please run `tars setup`.');
+        }
+    }
+    static getInstance() {
+        if (!Config.instance) {
+            Config.instance = new Config();
+        }
+        return Config.instance;
+    }
+}
+//# sourceMappingURL=config.js.map

package/dist/config/config.js.map

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

package/dist/discord/discord-bot.d.ts

@@ -0,0 +1,32 @@
+import { Config } from '../config/config.js';
+import { Supervisor } from '../supervisor/supervisor.js';
+/**
+ * Discord bot wrapper for Tars
+ */
+export declare class DiscordBot {
+    private readonly config;
+    private readonly client;
+    private readonly supervisor;
+    private readonly processor;
+    constructor(supervisor: Supervisor, config: Config);
+    /**
+     * Start the Discord bot
+     */
+    start(): Promise<void>;
+    /**
+     * Stop the Discord bot
+     */
+    stop(): Promise<void>;
+    /**
+     * Setup event handlers
+     */
+    private setupEventHandlers;
+    /**
+     * Handle incoming messages
+     */
+    private handleMessage;
+    /**
+     * Extract prompt and handle prefix !tars
+     */
+    private extractPrompt;
+}

package/dist/discord/discord-bot.js

@@ -0,0 +1,151 @@
+import { Client, GatewayIntentBits, ChannelType, Partials } from 'discord.js';
+import logger from '../utils/logger.js';
+import { MessageFormatter } from './message-formatter.js';
+import { AttachmentProcessor } from '../utils/attachment-processor.js';
+/**
+ * Discord bot wrapper for Tars
+ */
+export class DiscordBot {
+    config;
+    client;
+    supervisor;
+    processor;
+    constructor(supervisor, config) {
+        this.config = config;
+        this.supervisor = supervisor;
+        this.processor = new AttachmentProcessor(config);
+        this.client = new Client({
+            intents: [
+                GatewayIntentBits.Guilds,
+                GatewayIntentBits.GuildMessages,
+                GatewayIntentBits.MessageContent,
+                GatewayIntentBits.DirectMessages
+            ],
+            partials: [Partials.Channel, Partials.Message]
+        });
+        this.setupEventHandlers();
+    }
+    /**
+     * Start the Discord bot
+     */
+    async start() {
+        await this.client.login(this.config.discordToken);
+    }
+    /**
+     * Stop the Discord bot
+     */
+    async stop() {
+        this.client.destroy();
+    }
+    /**
+     * Setup event handlers
+     */
+    setupEventHandlers() {
+        this.client.once('clientReady', (c) => {
+            logger.info(`🚀 Tars online as ${c.user.tag}`);
+            logger.info(`🧠 Gemini Model: ${this.config.geminiModel}`);
+        });
+        this.client.on('messageCreate', this.handleMessage.bind(this));
+    }
+    /**
+     * Handle incoming messages
+     */
+    async handleMessage(message) {
+        if (message.author.bot)
+            return;
+        const userPrompt = this.extractPrompt(message);
+        // If null, message wasn't for us. If empty string, check for attachments.
+        if (userPrompt === null)
+            return;
+        if (!userPrompt && message.attachments.size === 0)
+            return;
+        logger.info(`Received request from ${message.author.tag}: "${userPrompt || '[Attachment Only]'}"`);
+        // Handle Attachments
+        let attachmentContext = '';
+        if (message.attachments.size > 0) {
+            for (const [id, attachment] of message.attachments) {
+                try {
+                    const filePath = await this.processor.download(attachment);
+                    attachmentContext += `\n[User attached file (${attachment.contentType}): ${filePath}]`;
+                }
+                catch (err) {
+                    logger.error(`Failed to download attachment: ${err.message}`);
+                    await message.reply(`⚠️ Failed to download ${attachment.name}: ${err.message}`);
+                }
+            }
+        }
+        const fullPrompt = `${userPrompt}${attachmentContext}`.trim();
+        if (!fullPrompt)
+            return;
+        let typingInterval = null;
+        // Start typing indicator loop (Discord typing status lasts 10s)
+        if ('sendTyping' in message.channel) {
+            // Initial typing
+            await message.channel.sendTyping().catch(() => { });
+            // Loop every 9s to keep it active
+            typingInterval = setInterval(() => {
+                if ('sendTyping' in message.channel) {
+                    message.channel.sendTyping().catch(() => { });
+                }
+            }, 9000);
+        }
+        try {
+            let fullResponse = '';
+            await this.supervisor.run(fullPrompt, async (event) => {
+                if ((event.type === 'text' || event.type === 'message') &&
+                    event.content &&
+                    event.role !== 'user') {
+                    fullResponse += event.content;
+                }
+                else if (event.type === 'error') {
+                    await message.reply(`❌ **Error:** ${event.error}`);
+                }
+                else if (event.type === 'done') {
+                    if (fullResponse.trim()) {
+                        const formatted = MessageFormatter.format(fullResponse);
+                        if (formatted.length > 1900) {
+                            const filePath = this.processor.saveResponse(fullResponse, 'md');
+                            await message.reply({
+                                content: `📄 **Response too long** (${formatted.length} chars). See attached file:`,
+                                files: [filePath]
+                            });
+                        }
+                        else {
+                            const chunks = MessageFormatter.split(formatted);
+                            for (const chunk of chunks) {
+                                await message.reply(chunk);
+                            }
+                        }
+                    }
+                }
+            });
+        }
+        catch (error) {
+            logger.error(`Discord handling error: ${error.message}`);
+            await message.reply(`❌ **Supervisor Error:** ${error.message}`);
+        }
+        finally {
+            if (typingInterval)
+                clearInterval(typingInterval);
+        }
+    }
+    /**
+     * Extract prompt and handle prefix !tars
+     */
+    extractPrompt(message) {
+        const isDM = message.channel.type === ChannelType.DM;
+        const isMentioned = this.client.user && message.mentions.has(this.client.user);
+        const hasCommand = message.content.startsWith('!tars');
+        if (!isDM && !isMentioned && !hasCommand)
+            return null;
+        let prompt = message.content;
+        if (hasCommand) {
+            prompt = prompt.replace('!tars', '');
+        }
+        if (isMentioned && this.client.user) {
+            prompt = prompt.replace(new RegExp(`<@!?${this.client.user.id}>`, 'g'), '');
+        }
+        return prompt.trim();
+    }
+}
+//# sourceMappingURL=discord-bot.js.map

package/dist/discord/discord-bot.js.map

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

package/dist/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;
+}