@saccolabs/tars 1.0.7

package/dist/supervisor/heartbeat-service.js

@@ -0,0 +1,143 @@
+import fs from 'fs/promises';
+import logger from '../utils/logger.js';
+import { CronExpressionParser } from 'cron-parser';
+import { AttachmentProcessor } from '../utils/attachment-processor.js';
+/**
+ * HeartbeatService - Manages background task execution via file polling
+ */
+export class HeartbeatService {
+    supervisor;
+    config;
+    interval = null;
+    isExecuting = false;
+    processor;
+    constructor(supervisor, config) {
+        this.supervisor = supervisor;
+        this.config = config;
+        this.processor = new AttachmentProcessor(config);
+    }
+    async start() {
+        const intervalMs = this.config.heartbeatIntervalMs;
+        logger.info(`💓 Heartbeat service started (Interval: ${intervalMs / 1000}s)`);
+        // Initial run
+        this.tick();
+        this.interval = setInterval(() => this.tick(), intervalMs);
+    }
+    stop() {
+        if (this.interval) {
+            clearInterval(this.interval);
+            this.interval = null;
+        }
+        logger.info('💓 Heartbeat service stopped');
+    }
+    async tick() {
+        if (this.isExecuting)
+            return;
+        this.isExecuting = true;
+        try {
+            // 1. Maintenance & Sync
+            this.processor.cleanup();
+            await this.supervisor.memory.fullSync();
+            // 2. Load Tasks
+            const tasks = await this.loadTasks();
+            const now = new Date();
+            const dueTasks = tasks.filter((t) => t.enabled && new Date(t.nextRun) <= now);
+            // 3. Autonomous Check (The OpenClaw style)
+            // If no hard-scheduled tasks, we do a semantic "health check"
+            if (dueTasks.length === 0) {
+                await this.autonomousCheck();
+            }
+            else {
+                logger.info(`💓 Found ${dueTasks.length} due tasks`);
+                for (const task of dueTasks) {
+                    await this.runTask(task);
+                }
+                await this.saveTasks(tasks);
+            }
+        }
+        catch (error) {
+            logger.error(`❌ Heartbeat tick error: ${error.message}`);
+        }
+        finally {
+            this.isExecuting = false;
+        }
+    }
+    async autonomousCheck() {
+        // This is a "quiet" heartbeat. We ask the AI if anything needs attention
+        // based on the context it has in memory.
+        const prompt = `Self-Correction and Autonomous Heartbeat:\nReview your current objectives in GEMINI.md and any pending tasks.\nIf everything is on track and no immediate action is required, reply exactly with 'SILENT_ACK'.\nIf you detect an issue, a missed deadline, or a high-priority task that needs starting, provide a short internal reasoning and then describe the action you are taking.`;
+        try {
+            const response = await this.supervisor.executeTask(prompt);
+            if (response.includes('SILENT_ACK')) {
+                // Heartbeat OK, prune to prevent context bloat
+                await this.supervisor.pruneLastTurn();
+                return;
+            }
+            // If the AI didn't say SILENT_ACK, it wants to do something!
+            logger.info(`🤖 Tars Heartbeat initiated action: ${response.substring(0, 100)}...`);
+            // Here we could route this to Discord or a Log.
+        }
+        catch (error) {
+            logger.error(`❌ Autonomous check failed: ${error.message}`);
+        }
+    }
+    async runTask(task) {
+        logger.info(`🚀 Running task: ${task.title} (${task.id})`);
+        try {
+            const result = await this.supervisor.executeTask(task.prompt);
+            logger.info(`✅ Task ${task.id} completed. Result length: ${result.length}`);
+            task.lastRun = new Date().toISOString();
+            task.failedCount = 0;
+        }
+        catch (error) {
+            logger.error(`❌ Task ${task.id} failed: ${error.message}`);
+            task.failedCount++;
+        }
+        finally {
+            // Calculate next run
+            task.nextRun = this.calculateNextRun(task.schedule);
+            task.updatedAt = new Date().toISOString();
+        }
+    }
+    calculateNextRun(schedule) {
+        try {
+            // 1. Try parsing as a cron expression (using the new 5.x API)
+            const interval = CronExpressionParser.parse(schedule);
+            const next = interval.next();
+            const iso = next.toISOString();
+            if (!iso) {
+                throw new Error('Could not calculate next run from cron.');
+            }
+            return iso;
+        }
+        catch (err) {
+            // 2. If not cron, try parsing as a specific ISO date
+            const date = new Date(schedule);
+            if (!isNaN(date.getTime()) && schedule.includes('-')) {
+                // We check for '-' to ensure it's likely a date string and not a weird numeric cron fallback
+                return date.toISOString();
+            }
+            // 3. Absolute Fallback: Run in 24 hours if the schedule is totally unparseable
+            // This prevents the task from "looping" or getting stuck in the past
+            logger.warn(`⚠️ Unrecognized schedule format: "${schedule}". Falling back to 24h.`);
+            return new Date(Date.now() + 24 * 60 * 60 * 1000).toISOString();
+        }
+    }
+    async loadTasks() {
+        try {
+            const data = await fs.readFile(this.config.taskFilePath, 'utf-8');
+            return JSON.parse(data);
+        }
+        catch (error) {
+            if (error.code === 'ENOENT') {
+                return [];
+            }
+            throw error;
+        }
+    }
+    async saveTasks(tasks) {
+        const data = JSON.stringify(tasks, null, 2);
+        await fs.writeFile(this.config.taskFilePath, data, 'utf-8');
+    }
+}
+//# sourceMappingURL=heartbeat-service.js.map

package/dist/supervisor/heartbeat-service.js.map

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

package/dist/supervisor/main.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/supervisor/main.js

@@ -0,0 +1,242 @@
+import { Config } from '../config/config.js';
+import { GeminiCli } from './gemini-cli.js';
+import { SessionManager } from './session-manager.js';
+import { Supervisor } from './supervisor.js';
+import { HeartbeatService } from './heartbeat-service.js';
+import { DiscordBot } from '../discord/discord-bot.js';
+import logger from '../utils/logger.js';
+import fs from 'fs';
+import path from 'path';
+import { fileURLToPath } from 'url';
+const __filename = fileURLToPath(import.meta.url);
+const __dirname = path.dirname(__filename);
+/**
+ * Install the fixed system prompt into the Tars home directory.
+ * This ensures Gemini CLI uses Tars' custom persona instead of the default coding-centric prompt.
+ */
+function installSystemPrompt(config) {
+    // Walk up from dist/supervisor/ or src/supervisor/ to find prompts/system.md
+    let searchDir = __dirname;
+    let srcPrompt = '';
+    // Try to find the prompt relative to the package root
+    for (let i = 0; i < 5; i++) {
+        const candidate = path.join(searchDir, 'prompts', 'system.md');
+        const srcCandidate = path.join(searchDir, 'src', 'prompts', 'system.md');
+        if (fs.existsSync(candidate)) {
+            srcPrompt = candidate;
+            break;
+        }
+        else if (fs.existsSync(srcCandidate)) {
+            srcPrompt = srcCandidate;
+            break;
+        }
+        searchDir = path.dirname(searchDir);
+    }
+    if (!srcPrompt) {
+        logger.warn('⚠️ Could not locate system.md prompt file');
+        return;
+    }
+    // Ensure target directory exists
+    const targetDir = path.dirname(config.systemPromptPath);
+    fs.mkdirSync(targetDir, { recursive: true });
+    // Always overwrite to ensure latest prompt is deployed
+    fs.copyFileSync(srcPrompt, config.systemPromptPath);
+    logger.info(`📝 System prompt installed: ${config.systemPromptPath}`);
+}
+/**
+ * Install built-in skills into the Tars runtime directory.
+ */
+/**
+ * Install and sync built-in skills into the Tars runtime directory.
+ * Safely updates built-in skills while preserving user-created ones.
+ */
+function installSkills(config) {
+    // 1. Locate context/skills/ in the repo
+    let searchDir = __dirname;
+    let skillsSrc = '';
+    for (let i = 0; i < 5; i++) {
+        const candidate = path.join(searchDir, 'context', 'skills');
+        const srcCandidate = path.join(searchDir, '..', 'context', 'skills'); // If in dist/supervisor/
+        if (fs.existsSync(candidate)) {
+            skillsSrc = candidate;
+            break;
+        }
+        else if (fs.existsSync(srcCandidate)) {
+            skillsSrc = srcCandidate;
+            break;
+        }
+        // Try finding context in root if running from src
+        const rootCandidate = path.join(searchDir, '..', '..', 'context', 'skills');
+        if (fs.existsSync(rootCandidate)) {
+            skillsSrc = rootCandidate;
+            break;
+        }
+        searchDir = path.dirname(searchDir);
+    }
+    if (!skillsSrc) {
+        logger.warn('⚠️ Could not locate built-in skills directory');
+        return;
+    }
+    // 2. Define target directory (~/.tars/.gemini/skills)
+    const skillsDest = path.join(config.homeDir, '.gemini', 'skills');
+    try {
+        if (!fs.existsSync(skillsDest)) {
+            fs.mkdirSync(skillsDest, { recursive: true });
+        }
+        // 3. Selective Sync: Copy each built-in skill individually
+        const builtInSkills = fs.readdirSync(skillsSrc);
+        for (const skillName of builtInSkills) {
+            const srcSkillPath = path.join(skillsSrc, skillName);
+            const destSkillPath = path.join(skillsDest, skillName);
+            // Only copy directories
+            if (!fs.statSync(srcSkillPath).isDirectory())
+                continue;
+            // Remove existing destination (to ensure clean update - e.g. deleting old files)
+            // This assumes built-in skills are managed entirely by the repo
+            if (fs.existsSync(destSkillPath)) {
+                fs.rmSync(destSkillPath, { recursive: true, force: true });
+            }
+            // Copy fresh from repo
+            fs.cpSync(srcSkillPath, destSkillPath, { recursive: true });
+            logger.info(`📚 Skill synced: ${skillName}`);
+        }
+    }
+    catch (error) {
+        logger.error(`❌ Failed to sync skills: ${error}`);
+    }
+}
+/**
+ * Automatically install/link extensions and enable them.
+ * Verifies symlinks are valid and re-links if broken.
+ */
+function installExtensions(config) {
+    const repoExtensionsDir = path.join(__dirname, '..', '..', 'extensions');
+    const targetExtensionsDir = path.join(config.homeDir, '.gemini', 'extensions');
+    const enablementFile = path.join(targetExtensionsDir, 'extension-enablement.json');
+    if (!fs.existsSync(repoExtensionsDir)) {
+        logger.warn('⚠️ Could not locate extensions directory');
+        return;
+    }
+    if (!fs.existsSync(targetExtensionsDir)) {
+        fs.mkdirSync(targetExtensionsDir, { recursive: true });
+    }
+    // Load Enablement
+    let enablement = {};
+    if (fs.existsSync(enablementFile)) {
+        try {
+            enablement = JSON.parse(fs.readFileSync(enablementFile, 'utf-8'));
+        }
+        catch (e) {
+            logger.warn('⚠️ Could not parse extension-enablement.json, starting fresh');
+        }
+    }
+    const builtInExtensions = fs.readdirSync(repoExtensionsDir);
+    for (const extName of builtInExtensions) {
+        const srcPath = path.resolve(repoExtensionsDir, extName);
+        if (!fs.statSync(srcPath).isDirectory())
+            continue;
+        const finalExtName = extName === 'tasks' ? 'tars-tasks' : extName;
+        const finalDestPath = path.join(targetExtensionsDir, finalExtName);
+        // Check if symlink exists and is valid
+        let needsLink = true;
+        try {
+            if (fs.existsSync(finalDestPath)) {
+                const stats = fs.lstatSync(finalDestPath);
+                if (stats.isSymbolicLink()) {
+                    const realPath = fs.realpathSync(finalDestPath);
+                    if (realPath === srcPath) {
+                        needsLink = false; // Already linked correctly
+                    }
+                }
+            }
+        }
+        catch (e) {
+            // Broken link or other error, proceed to re-link
+        }
+        if (needsLink) {
+            try {
+                // Remove existing file/link if present to prevent EEXIST
+                if (fs.existsSync(finalDestPath) || fs.lstatSync(finalDestPath).isSymbolicLink()) {
+                    fs.rmSync(finalDestPath, { recursive: true, force: true });
+                }
+                fs.symlinkSync(srcPath, finalDestPath, 'dir');
+                logger.info(`🔌 Linked extension: ${finalExtName} -> ${srcPath}`);
+            }
+            catch (error) {
+                logger.error(`❌ Failed to link extension ${finalExtName}: ${error}`);
+            }
+        }
+        // Ensure enabled
+        if (!enablement[finalExtName]) {
+            enablement[finalExtName] = {
+                overrides: [path.join(config.homeDir, '*')]
+            };
+        }
+    }
+    fs.writeFileSync(enablementFile, JSON.stringify(enablement, null, 2));
+}
+/**
+ * Install default settings if none exist.
+ */
+function installDefaultSettings(config) {
+    const settingsTemplate = path.join(__dirname, '..', '..', 'context', 'config', 'settings.json-template');
+    const targetSettings = path.join(config.homeDir, '.gemini', 'settings.json');
+    if (fs.existsSync(targetSettings))
+        return;
+    if (fs.existsSync(settingsTemplate)) {
+        fs.mkdirSync(path.dirname(targetSettings), { recursive: true });
+        fs.copyFileSync(settingsTemplate, targetSettings);
+        logger.info(`⚙️ Default settings installed: ${targetSettings}`);
+    }
+    else {
+        logger.warn('⚠️ Could not locate settings.json-template');
+    }
+}
+/**
+ * Tars Main Entry Point
+ */
+async function main() {
+    try {
+        logger.info('🚀 Tars Starting...');
+        // 1. Load Configuration
+        const config = Config.getInstance();
+        // 2. Install system prompt, skills, extensions and settings
+        installSystemPrompt(config);
+        installSkills(config);
+        installExtensions(config);
+        installDefaultSettings(config);
+        // 3. Initialize Core Services
+        const gemini = new GeminiCli(config);
+        const sessionManager = new SessionManager(config.sessionFilePath);
+        const supervisor = new Supervisor(gemini, sessionManager);
+        // 4. Initialize Heartbeat (Background Tasks)
+        const heartbeat = new HeartbeatService(supervisor, config);
+        // 5. Initialize Interface (Discord)
+        const discordBot = new DiscordBot(supervisor, config);
+        // Start Services
+        await discordBot.start();
+        await heartbeat.start();
+        logger.info('✨ Tars successfully initialized and running.');
+        // Graceful shutdown
+        process.on('SIGINT', async () => {
+            logger.info('🛑 Shutting down...');
+            heartbeat.stop();
+            process.exit(0);
+        });
+    }
+    catch (error) {
+        logger.error(`💥 Fatal error during startup: ${error.message}`);
+        process.exit(1);
+    }
+}
+// 6. Run Main
+// Strict Safety Check: The supervisor must be explicitly activated via environment variable.
+// This prevents accidental execution via "node dist/supervisor/main.js" which can spawn zombie processes.
+if (process.env.TARS_SUPERVISOR_MODE !== 'true') {
+    logger.error('❌ TARS_SUPERVISOR_MODE=true is required to start the supervisor.');
+    logger.error('   This safety check prevents accidental multiple instances.');
+    logger.error('👉 Use "tars start" or "npm run dev" instead.');
+    process.exit(1);
+}
+main();
+//# sourceMappingURL=main.js.map

package/dist/supervisor/main.js.map

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

package/dist/supervisor/session-manager.d.ts

@@ -0,0 +1,47 @@
+import { UsageStats } from '../types/index.js';
+/**
+ * Session data stored to disk
+ */
+export interface SessionData {
+    sessionId: string;
+    createdAt: string;
+    totalInputTokens: number;
+    totalOutputTokens: number;
+    totalCachedTokens: number;
+    interactionCount: number;
+    lastInteractionAt: string;
+    lastInputTokens: number;
+    totalNetTokens: number;
+}
+/**
+ * Manages Gemini CLI session persistence with token tracking
+ */
+export declare class SessionManager {
+    private readonly sessionFilePath;
+    private sessionData;
+    constructor(sessionFilePath: string);
+    /**
+     * Load session data from storage
+     */
+    load(): string | null;
+    /**
+     * Save or initialize session
+     */
+    save(sessionId: string): void;
+    /**
+     * Update session with usage stats from latest interaction
+     */
+    updateUsage(usage: UsageStats): void;
+    /**
+     * Get current session statistics
+     */
+    getStats(): SessionData | null;
+    /**
+     * Clear the stored session
+     */
+    clear(): void;
+    /**
+     * Check if a session exists
+     */
+    exists(): boolean;
+}

package/dist/supervisor/session-manager.js

@@ -0,0 +1,118 @@
+import fs from 'fs';
+import path from 'path';
+import logger from '../utils/logger.js';
+/**
+ * Manages Gemini CLI session persistence with token tracking
+ */
+export class SessionManager {
+    sessionFilePath;
+    sessionData = null;
+    constructor(sessionFilePath) {
+        this.sessionFilePath = sessionFilePath;
+    }
+    /**
+     * Load session data from storage
+     */
+    load() {
+        if (!fs.existsSync(this.sessionFilePath)) {
+            return null;
+        }
+        try {
+            const raw = fs.readFileSync(this.sessionFilePath, 'utf-8');
+            const parsed = JSON.parse(raw);
+            // Check if sessionId exists
+            if (!parsed.sessionId) {
+                return null;
+            }
+            this.sessionData = parsed;
+            if (this.sessionData.totalNetTokens === undefined) {
+                this.sessionData.totalNetTokens = this.sessionData.totalInputTokens || 0;
+            }
+            return this.sessionData.sessionId;
+        }
+        catch (e) {
+            logger.warn(`[SessionManager] Failed to load session: ${e}`);
+            return null;
+        }
+    }
+    /**
+     * Save or initialize session
+     */
+    save(sessionId) {
+        try {
+            // Initialize new session data if not exists
+            if (!this.sessionData || this.sessionData.sessionId !== sessionId) {
+                this.sessionData = {
+                    sessionId,
+                    createdAt: new Date().toISOString(),
+                    totalInputTokens: 0,
+                    totalOutputTokens: 0,
+                    totalCachedTokens: 0,
+                    interactionCount: 0,
+                    lastInteractionAt: new Date().toISOString(),
+                    lastInputTokens: 0,
+                    totalNetTokens: 0
+                };
+            }
+            const dir = path.dirname(this.sessionFilePath);
+            fs.mkdirSync(dir, { recursive: true });
+            fs.writeFileSync(this.sessionFilePath, JSON.stringify(this.sessionData, null, 2));
+            logger.info(`[SessionManager] Session saved: ${sessionId}`);
+        }
+        catch (e) {
+            logger.error(`[SessionManager] Failed to save session: ${e}`);
+        }
+    }
+    /**
+     * Update session with usage stats from latest interaction
+     */
+    updateUsage(usage) {
+        if (!this.sessionData) {
+            logger.warn('[SessionManager] Cannot update usage - no active session');
+            return;
+        }
+        const netInput = Math.max(0, usage.inputTokens - (usage.cachedTokens || 0));
+        this.sessionData.totalNetTokens += netInput;
+        this.sessionData.totalInputTokens = usage.inputTokens; // Current context size
+        this.sessionData.totalOutputTokens += usage.outputTokens;
+        this.sessionData.totalCachedTokens = usage.cachedTokens || 0; // Current cached state
+        this.sessionData.interactionCount++;
+        this.sessionData.lastInteractionAt = new Date().toISOString();
+        this.sessionData.lastInputTokens = usage.inputTokens;
+        // Persist to disk
+        try {
+            fs.writeFileSync(this.sessionFilePath, JSON.stringify(this.sessionData, null, 2));
+        }
+        catch (e) {
+            logger.error(`[SessionManager] Failed to update usage: ${e}`);
+        }
+    }
+    /**
+     * Get current session statistics
+     */
+    getStats() {
+        return this.sessionData ? { ...this.sessionData } : null;
+    }
+    /**
+     * Clear the stored session
+     */
+    clear() {
+        if (fs.existsSync(this.sessionFilePath)) {
+            try {
+                fs.unlinkSync(this.sessionFilePath);
+                this.sessionData = null;
+                logger.info('[SessionManager] Session cleared');
+            }
+            catch (e) {
+                logger.error(`[SessionManager] Failed to clear session: ${e}`);
+            }
+        }
+    }
+    /**
+     * Check if a session exists
+     */
+    exists() {
+        return fs.existsSync(this.sessionFilePath);
+    }
+}
+//# sourceMappingURL=session-manager.js.map

package/dist/supervisor/session-manager.js.map

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

package/dist/supervisor/supervisor.d.ts

@@ -0,0 +1,32 @@
+import { GeminiCli } from './gemini-cli.js';
+import { SessionManager } from './session-manager.js';
+import { GeminiOutputHandler } from '../types/index.js';
+import { MemoryManager } from '../memory/memory-manager.js';
+/**
+ * Tars Supervisor - Core Orchestrator
+ * Simplified to handle session management and Gemini CLI execution.
+ */
+export declare class Supervisor {
+    private readonly gemini;
+    private readonly sessionManager;
+    private readonly config;
+    readonly memory: MemoryManager;
+    private isProcessing;
+    constructor(gemini: GeminiCli, sessionManager: SessionManager);
+    /**
+     * Executes a user prompt through the Gemini CLI
+     */
+    run(content: string, onEvent: GeminiOutputHandler, sessionId?: string): Promise<void>;
+    /**
+     * Specialized execution for background tasks
+     */
+    executeTask(prompt: string): Promise<string>;
+    /**
+     * Prunes the last turn from the current session.
+     */
+    pruneLastTurn(): Promise<void>;
+    /**
+     * Checks if the supervisor is currently processing a request
+     */
+    isBusy(): boolean;
+}