@saccolabs/tars 1.30.0 → 1.32.0

package/dist/supervisor/supervisor.js

@@ -3,22 +3,26 @@ import { Config } from '../config/config.js';
 import { MemoryManager } from '../memory/memory-manager.js';
 /**
  * Tars Supervisor - Core Orchestrator
- * Handles session management and Gemini Engine execution.
+ * Handles session management and Tars Engine execution.
  */
 export class Supervisor {
-    gemini;
+    tarsEngine;
     sessionManager;
     config;
     memory;
     processingSince = null;
-    constructor(gemini, sessionManager) {
-        this.gemini = gemini;
+    channelManager;
+    constructor(tarsEngine, sessionManager) {
+        this.tarsEngine = tarsEngine;
         this.sessionManager = sessionManager;
         this.config = Config.getInstance();
         this.memory = new MemoryManager(this.config);
     }
+    setChannelManager(channelManager) {
+        this.channelManager = channelManager;
+    }
     /**
-     * Executes a user prompt through the Gemini CLI
+     * Executes a user prompt through the Tars CLI
      */
     async run(content, onEvent, sessionId, attachments, onStatus) {
         if (this.processingSince !== null) {
@@ -34,11 +38,15 @@ export class Supervisor {
             let sessionIdToUse = sessionId || (await this.sessionManager.load());
             // Track user activity for idle suppression
             await this.sessionManager.touchActivity();
+            // Proactive compression check before run starts
+            if (sessionIdToUse) {
+                await this.performCompressionIfNeeded(sessionIdToUse, onEvent, onStatus);
+            }
             let toolCallCount = 0;
             const callIdToNameMap = new Map();
-            // Run Gemini CLI
-            await this.gemini.run(content, async (event) => {
-                // Learn session ID from Gemini CLI if it was newly generated
+            // Run Tars CLI
+            await this.tarsEngine.run(content, async (event) => {
+                // Learn session ID from Tars CLI if it was newly generated
                 if (event.sessionId && !sessionIdToUse) {
                     sessionIdToUse = event.sessionId;
                     this.sessionManager
@@ -87,25 +95,7 @@ export class Supervisor {
                 if (event.type === 'done') {
                     if (event.usageStats) {
                         await this.sessionManager.updateUsage(event.usageStats);
-                        // Proactive compression check
-                        if (this.sessionManager.needsCompression(this.config.contextWindowTokens, this.config.compressionThreshold)) {
-                            logger.info('[Supervisor] Context threshold exceeded — triggering compression');
-                            try {
-                                const didCompress = await this.gemini.compressSession();
-                                await this.sessionManager.recordCompression();
-                                if (didCompress) {
-                                    await onEvent({
-                                        type: 'text',
-                                        role: 'assistant',
-                                        content: '\n\n✨ *Session memory compacted to optimally save context space while retaining historical facts.*',
-                                        sessionId: sessionIdToUse
-                                    });
-                                }
-                            }
-                            catch (e) {
-                                logger.warn(`[Supervisor] Compression failed: ${e.message}`);
-                            }
-                        }
+                        await this.performCompressionIfNeeded(sessionIdToUse, onEvent, onStatus);
                     }
                 }
                 await onEvent(event);
@@ -114,7 +104,7 @@ export class Supervisor {
             // instead of destroying the session
             if (memoryMutated) {
                 logger.info('[Supervisor] Memory mutated — refreshing system instruction in-place');
-                this.gemini.refreshSystemInstruction();
+                this.tarsEngine.refreshSystemInstruction();
             }
         }
         catch (error) {
@@ -135,22 +125,90 @@ export class Supervisor {
             logger.warn('⚠️ Supervisor is busy, skipping background task');
             throw new Error('Supervisor is busy');
         }
+        const isCron = prompt.includes('Task Directive:');
+        const taskType = isCron ? 'scheduled cron task' : 'background heartbeat check';
+        if (this.channelManager) {
+            await this.channelManager.notify(`⏳ *Starting a background task (${taskType}). Please hold on while I finish...*`);
+        }
         logger.info(`⚙️ Executing background task...`);
         try {
             this.processingSince = Date.now();
             // Run in the active session so context is shared
             const activeSessionId = await this.sessionManager.load();
-            const result = await this.gemini.runSync(prompt, activeSessionId || undefined);
+            const result = await this.tarsEngine.runSync(prompt, activeSessionId || undefined);
+            if (this.channelManager) {
+                await this.channelManager.notify(`✅ *Finished background task (${taskType}). I am free now.*`);
+            }
             return result;
         }
         catch (error) {
             logger.error(`❌ Background task failed: ${error.message}`);
+            if (this.channelManager) {
+                await this.channelManager.notify(`⚠️ *Background task (${taskType}) failed:* ${error.message}`);
+            }
             throw error;
         }
         finally {
             this.processingSince = null;
         }
     }
+    /**
+     * Checks if the session needs compression and performs it, updating status if requested.
+     */
+    async performCompressionIfNeeded(sessionIdToUse, onEvent, onStatus) {
+        if (this.sessionManager.needsCompression(this.config.contextWindowTokens, this.config.compressionThreshold)) {
+            logger.info('[Supervisor] Context threshold exceeded — triggering compression');
+            if (onStatus) {
+                await onStatus(0, [
+                    ...this.tarsEngine.activeTools,
+                    {
+                        id: 'compression',
+                        name: 'Memory Compactor',
+                        status: 'running'
+                    }
+                ], false);
+            }
+            try {
+                const didCompress = await this.tarsEngine.compressSession();
+                await this.sessionManager.recordCompression();
+                if (didCompress) {
+                    if (onStatus) {
+                        await onStatus(0, [
+                            ...this.tarsEngine.activeTools,
+                            {
+                                id: 'compression',
+                                name: 'Memory Compactor',
+                                status: 'completed',
+                                responsePreview: 'Successfully compacted session memory to optimally save context space while retaining historical facts.',
+                                responseSize: 114
+                            }
+                        ], false);
+                    }
+                    await onEvent({
+                        type: 'text',
+                        role: 'assistant',
+                        content: '\n\n✨ *Session memory compacted to optimally save context space while retaining historical facts.*',
+                        sessionId: sessionIdToUse
+                    });
+                }
+            }
+            catch (e) {
+                logger.warn(`[Supervisor] Compression failed: ${e.message}`);
+                if (onStatus) {
+                    await onStatus(0, [
+                        ...this.tarsEngine.activeTools,
+                        {
+                            id: 'compression',
+                            name: 'Memory Compactor',
+                            status: 'completed',
+                            responsePreview: `Compression failed: ${e.message}`,
+                            responseSize: e.message.length
+                        }
+                    ], false);
+                }
+            }
+        }
+    }
     isBusy() {
         return this.processingSince !== null;
     }

package/dist/supervisor/supervisor.js.map

@@ -1 +1 @@
-{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../../src/supervisor/supervisor.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"supervisor.js","sourceRoot":"","sources":["../../src/supervisor/supervisor.ts"],"names":[],"mappings":"AAGA,OAAO,MAAM,MAAM,oBAAoB,CAAC;AACxC,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAG5D;;;GAGG;AACH,MAAM,OAAO,UAAU;IAOE;IACA;IAPJ,MAAM,CAAS;IAChB,MAAM,CAAgB;IAC9B,eAAe,GAAkB,IAAI,CAAC;IACtC,cAAc,CAAkB;IAExC,YACqB,UAAsB,EACtB,cAA8B;QAD9B,eAAU,GAAV,UAAU,CAAY;QACtB,mBAAc,GAAd,cAAc,CAAgB;QAE/C,IAAI,CAAC,MAAM,GAAG,MAAM,CAAC,WAAW,EAAE,CAAC;QACnC,IAAI,CAAC,MAAM,GAAG,IAAI,aAAa,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACjD,CAAC;IAEM,iBAAiB,CAAC,cAA8B;QACnD,IAAI,CAAC,cAAc,GAAG,cAAc,CAAC;IACzC,CAAC;IAED;;OAEG;IACI,KAAK,CAAC,GAAG,CACZ,OAAe,EACf,OAA0B,EAC1B,SAAkB,EAClB,WAAiC,EACjC,QAA8B;QAE9B,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,IAAI,KAAK,CACX,oGAAoG,CACvG,CAAC;QACN,CAAC;QAED,MAAM,CAAC,IAAI,CACP,qCAAqC,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,OAAO,CAAC,MAAM,GAAG,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CACrG,CAAC;QAEF,0DAA0D;QAC1D,IAAI,aAAa,GAAG,KAAK,CAAC;QAE1B,IAAI,CAAC;YACD,sBAAsB;YACtB,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAElC,wBAAwB;YACxB,IAAI,cAAc,GAAG,SAAS,IAAI,CAAC,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,CAAC;YAErE,2CAA2C;YAC3C,MAAM,IAAI,CAAC,cAAc,CAAC,aAAa,EAAE,CAAC;YAE1C,gDAAgD;YAChD,IAAI,cAAc,EAAE,CAAC;gBACjB,MAAM,IAAI,CAAC,0BAA0B,CAAC,cAAc,EAAE,OAAO,EAAE,QAAQ,CAAC,CAAC;YAC7E,CAAC;YAED,IAAI,aAAa,GAAG,CAAC,CAAC;YACtB,MAAM,eAAe,GAAG,IAAI,GAAG,EAAkB,CAAC;YAElD,eAAe;YACf,MAAM,IAAI,CAAC,UAAU,CAAC,GAAG,CACrB,OAAO,EACP,KAAK,EAAE,KAAK,EAAE,EAAE;gBACZ,2DAA2D;gBAC3D,IAAI,KAAK,CAAC,SAAS,IAAI,CAAC,cAAc,EAAE,CAAC;oBACrC,cAAc,GAAG,KAAK,CAAC,SAAS,CAAC;oBACjC,IAAI,CAAC,cAAc;yBACd,IAAI,CAAC,cAAc,CAAC;yBACpB,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,2BAA2B,CAAC,EAAE,CAAC,CAAC,CAAC;gBACpE,CAAC;gBAED,uCAAuC;gBACvC,IAAI,KAAK,CAAC,IAAI,KAAK,WAAW,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBAC/C,aAAa,EAAE,CAAC;oBAChB,IAAI,KAAK,CAAC,MAAM,EAAE,CAAC;wBACf,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,KAAK,CAAC,QAAQ,CAAC,CAAC;oBACtD,CAAC;oBAED,MAAM,WAAW,GAAG,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAC;oBACzD,MAAM,aAAa,GACf,WAAW,CAAC,MAAM,GAAG,GAAG;wBACpB,CAAC,CAAC,WAAW,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,GAAG,KAAK;wBACvC,CAAC,CAAC,WAAW,CAAC;oBAEtB,MAAM,CAAC,IAAI,CAAC,eAAe,aAAa,KAAK,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC;oBAC/D,MAAM,CAAC,IAAI,CAAC,gBAAgB,aAAa,EAAE,CAAC,CAAC;oBAE7C,wCAAwC;oBACxC,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,CAAC;oBAChC,IACI,QAAQ,CAAC,QAAQ,CAAC,mBAAmB,CAAC;wBACtC,QAAQ,CAAC,QAAQ,CAAC,oBAAoB,CAAC,EACzC,CAAC;wBACC,MAAM,CAAC,IAAI,CAAC,yBAAyB,QAAQ,EAAE,CAAC,CAAC;wBACjD,aAAa,GAAG,IAAI,CAAC;oBACzB,CAAC;gBACL,CAAC;gBAED,qBAAqB;gBACrB,IAAI,KAAK,CAAC,IAAI,KAAK,eAAe,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC;oBACnD,MAAM,QAAQ,GAAG,eAAe,CAAC,GAAG,CAAC,KAAK,CAAC,QAAQ,CAAC,IAAI,cAAc,CAAC;oBACvE,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,IAAI,EAAE,CAAC;oBAEpC,IAAI,OAAO,GAAG,EAAE,CAAC;oBACjB,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;wBACrD,IAAI,CAAC;4BACD,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC;4BACnC,IAAI,KAAK,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,CAAC;gCACxB,OAAO,GAAG,OAAO,MAAM,CAAC,MAAM,gBAAgB,CAAC;4BACnD,CAAC;wBACL,CAAC;wBAAC,OAAO,CAAC,EAAE,CAAC,CAAA,CAAC;oBAClB,CAAC;oBAED,MAAM,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;oBACrE,MAAM,CAAC,IAAI,CAAC,YAAY,QAAQ,GAAG,OAAO,EAAE,CAAC,CAAC;oBAC9C,MAAM,CAAC,IAAI,CACP,iBAAiB,OAAO,GAAG,OAAO,CAAC,MAAM,GAAG,GAAG,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,OAAO,CAAC,MAAM,SAAS,CAC3F,CAAC;gBACN,CAAC;gBAED,oCAAoC;gBACpC,IAAI,KAAK,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;oBACxB,IAAI,KAAK,CAAC,UAAU,EAAE,CAAC;wBACnB,MAAM,IAAI,CAAC,cAAc,CAAC,WAAW,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC;wBACxD,MAAM,IAAI,CAAC,0BAA0B,CACjC,cAAe,EACf,OAAO,EACP,QAAQ,CACX,CAAC;oBACN,CAAC;gBACL,CAAC;gBACD,MAAM,OAAO,CAAC,KAAY,CAAC,CAAC;YAChC,CAAC,EACD,cAAc,IAAI,SAAS,EAC3B,WAAW,EACX,QAAQ,CACX,CAAC;YAEF,0EAA0E;YAC1E,oCAAoC;YACpC,IAAI,aAAa,EAAE,CAAC;gBAChB,MAAM,CAAC,IAAI,CAAC,sEAAsE,CAAC,CAAC;gBACpF,IAAI,CAAC,UAAU,CAAC,wBAAwB,EAAE,CAAC;YAC/C,CAAC;QACL,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,MAAM,CAAC,KAAK,CAAC,iCAAiC,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;QACrD,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAChC,CAAC;IACL,CAAC;IAED;;;;OAIG;IACI,KAAK,CAAC,WAAW,CAAC,MAAc;QACnC,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,CAAC,IAAI,CAAC,iDAAiD,CAAC,CAAC;YAC/D,MAAM,IAAI,KAAK,CAAC,oBAAoB,CAAC,CAAC;QAC1C,CAAC;QAED,MAAM,MAAM,GAAG,MAAM,CAAC,QAAQ,CAAC,iBAAiB,CAAC,CAAC;QAClD,MAAM,QAAQ,GAAG,MAAM,CAAC,CAAC,CAAC,qBAAqB,CAAC,CAAC,CAAC,4BAA4B,CAAC;QAE/E,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;YACtB,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAC5B,kCAAkC,QAAQ,sCAAsC,CACnF,CAAC;QACN,CAAC;QAED,MAAM,CAAC,IAAI,CAAC,iCAAiC,CAAC,CAAC;QAE/C,IAAI,CAAC;YACD,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC,GAAG,EAAE,CAAC;YAElC,iDAAiD;YACjD,MAAM,eAAe,GAAG,MAAM,IAAI,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC;YACzD,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,OAAO,CAAC,MAAM,EAAE,eAAe,IAAI,SAAS,CAAC,CAAC;YAEnF,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAC5B,gCAAgC,QAAQ,oBAAoB,CAC/D,CAAC;YACN,CAAC;YACD,OAAO,MAAM,CAAC;QAClB,CAAC;QAAC,OAAO,KAAU,EAAE,CAAC;YAClB,MAAM,CAAC,KAAK,CAAC,6BAA6B,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC3D,IAAI,IAAI,CAAC,cAAc,EAAE,CAAC;gBACtB,MAAM,IAAI,CAAC,cAAc,CAAC,MAAM,CAC5B,wBAAwB,QAAQ,cAAc,KAAK,CAAC,OAAO,EAAE,CAChE,CAAC;YACN,CAAC;YACD,MAAM,KAAK,CAAC;QAChB,CAAC;gBAAS,CAAC;YACP,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;QAChC,CAAC;IACL,CAAC;IAED;;OAEG;IACK,KAAK,CAAC,0BAA0B,CACpC,cAAsB,EACtB,OAA0B,EAC1B,QAA8B;QAE9B,IACI,IAAI,CAAC,cAAc,CAAC,gBAAgB,CAChC,IAAI,CAAC,MAAM,CAAC,mBAAmB,EAC/B,IAAI,CAAC,MAAM,CAAC,oBAAoB,CACnC,EACH,CAAC;YACC,MAAM,CAAC,IAAI,CAAC,kEAAkE,CAAC,CAAC;YAEhF,IAAI,QAAQ,EAAE,CAAC;gBACX,MAAM,QAAQ,CACV,CAAC,EACD;oBACI,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW;oBAC9B;wBACI,EAAE,EAAE,aAAa;wBACjB,IAAI,EAAE,kBAAkB;wBACxB,MAAM,EAAE,SAAS;qBACpB;iBACJ,EACD,KAAK,CACR,CAAC;YACN,CAAC;YAED,IAAI,CAAC;gBACD,MAAM,WAAW,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,eAAe,EAAE,CAAC;gBAC5D,MAAM,IAAI,CAAC,cAAc,CAAC,iBAAiB,EAAE,CAAC;gBAE9C,IAAI,WAAW,EAAE,CAAC;oBACd,IAAI,QAAQ,EAAE,CAAC;wBACX,MAAM,QAAQ,CACV,CAAC,EACD;4BACI,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW;4BAC9B;gCACI,EAAE,EAAE,aAAa;gCACjB,IAAI,EAAE,kBAAkB;gCACxB,MAAM,EAAE,WAAW;gCACnB,eAAe,EACX,yGAAyG;gCAC7G,YAAY,EAAE,GAAG;6BACpB;yBACJ,EACD,KAAK,CACR,CAAC;oBACN,CAAC;oBACD,MAAM,OAAO,CAAC;wBACV,IAAI,EAAE,MAAM;wBACZ,IAAI,EAAE,WAAW;wBACjB,OAAO,EACH,oGAAoG;wBACxG,SAAS,EAAE,cAAc;qBACrB,CAAC,CAAC;gBACd,CAAC;YACL,CAAC;YAAC,OAAO,CAAM,EAAE,CAAC;gBACd,MAAM,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC;gBAC7D,IAAI,QAAQ,EAAE,CAAC;oBACX,MAAM,QAAQ,CACV,CAAC,EACD;wBACI,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW;wBAC9B;4BACI,EAAE,EAAE,aAAa;4BACjB,IAAI,EAAE,kBAAkB;4BACxB,MAAM,EAAE,WAAW;4BACnB,eAAe,EAAE,uBAAuB,CAAC,CAAC,OAAO,EAAE;4BACnD,YAAY,EAAE,CAAC,CAAC,OAAO,CAAC,MAAM;yBACjC;qBACJ,EACD,KAAK,CACR,CAAC;gBACN,CAAC;YACL,CAAC;QACL,CAAC;IACL,CAAC;IAEM,MAAM;QACT,OAAO,IAAI,CAAC,eAAe,KAAK,IAAI,CAAC;IACzC,CAAC;IAED;;;OAGG;IACI,wBAAwB,CAAC,QAAgB;QAC5C,IAAI,IAAI,CAAC,eAAe,KAAK,IAAI,EAAE,CAAC;YAChC,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,IAAI,CAAC,eAAe,CAAC;YAC9C,IAAI,GAAG,GAAG,QAAQ,EAAE,CAAC;gBACjB,MAAM,CAAC,IAAI,CACP,wCAAwC,IAAI,CAAC,KAAK,CAAC,GAAG,GAAG,IAAI,CAAC,qCAAqC,CACtG,CAAC;gBACF,IAAI,CAAC,eAAe,GAAG,IAAI,CAAC;gBAC5B,OAAO,IAAI,CAAC;YAChB,CAAC;QACL,CAAC;QACD,OAAO,KAAK,CAAC;IACjB,CAAC;CACJ"}

package/dist/supervisor/{gemini-engine.d.ts → tars-engine.d.ts}

@@ -3,7 +3,7 @@ import { Config as TarsConfig } from '../config/config.js';
 import { AttachmentContext } from '../types/index.js';
 import { ChannelManager } from '../channels/channel-manager.js';
 import { SessionManager } from './session-manager.js';
-export interface GeminiEngineEvent {
+export interface TarsEngineEvent {
     type: string;
     role?: 'user' | 'assistant' | 'system';
     content?: string;
@@ -18,35 +18,37 @@ export interface GeminiEngineEvent {
     sessionId?: string;
     error?: string;
 }
-export type GeminiEngineOutputHandler = (event: GeminiEngineEvent) => void | Promise<void>;
+export type TarsEngineOutputHandler = (event: TarsEngineEvent) => void | Promise<void>;
 /**
  * Snapshot of a completed tool call for status reporting.
  */
 export interface ToolStatus {
+    id?: string;
     name: string;
-    responsePreview: string;
-    responseSize: number;
+    status: 'running' | 'completed';
+    responsePreview?: string;
+    responseSize?: number;
 }
 /**
  * Callback signature for live status updates during long-running tasks.
  */
 export type StatusUpdateHandler = (turnCount: number, recentTools: ToolStatus[], isMilestone: boolean) => void | Promise<void>;
 /**
- * GeminiEngine - Native replacement for GeminiCli subprocess
+ * TarsEngine - Wraps the Pi Agent SDK as a drop-in replacement.
  *
- * Uses @google/gemini-cli-core directly to interact with Gemini models.
- * Operates within the ~/.tars isolated environment by overriding HOME.
+ * Interacts with configured providers (Google, OpenAI, Anthropic, or Custom).
+ * Operates within the ~/.tars isolated environment.
  */
-export declare class GeminiEngine extends EventEmitter {
+export declare class TarsEngine extends EventEmitter {
     private readonly tarsConfig;
-    private coreConfig;
-    private client;
     private initialized;
-    private initializedWithFallback;
     private currentSessionId;
     private channelManager?;
     private sessionManager?;
     private rateLimiter;
+    private mcpBridge;
+    private allTools;
+    activeTools: ToolStatus[];
     constructor(tarsConfig: TarsConfig);
     /**
      * Provide the ChannelManager instance to the engine so it can build proactive notification tools
@@ -57,46 +59,53 @@ export declare class GeminiEngine extends EventEmitter {
      */
     setSessionManager(sessionManager: SessionManager): void;
     /**
-     * Initializes the core Gemini client with proper auth and config.
+     * Initializes the Tars Engine and discovers MCP extensions.
      */
     initialize(initialSessionId?: string): Promise<void>;
     /**
-     * Discovers extensions from the ~/.tars/.gemini/extensions directory.
+     * Returns the API key mapped to the provider name from process.env.
      */
-    private discoverExtensions;
+    private getApiKeyForProvider;
     /**
-     * Executes a prompt and streams events back.
+     * Executes the conversational agent loop using the Pi Agent SDK.
      */
-    run(prompt: string, onEvent: GeminiEngineOutputHandler, sessionId?: string, attachments?: AttachmentContext[], onStatus?: StatusUpdateHandler): Promise<void>;
+    run(prompt: string, onEvent: TarsEngineOutputHandler, sessionId?: string, attachments?: AttachmentContext[], onStatus?: StatusUpdateHandler): Promise<void>;
     /**
-     * Synchronous-style run for background tasks.
+     * Executes a prompt synchronously and returns the model response.
      */
     runSync(prompt: string, sessionId?: string): Promise<string>;
-    /**
-     * Rebuilds the response array for Gemini ensuring 1:1 parity with function calls.
-     */
-    static buildToolResponseParts(toolRequests: any[], completedCalls: any[], blockedResponses: Map<string, string>, sensitiveCalls: Set<string>, isLocalInference?: boolean): any[];
     /**
      * Proactively compress the session history to reclaim context window space.
-     * Delegates to Gemini Core's built-in compression.
+     * Summarizes older messages into a <state_snapshot> block.
      */
     compressSession(force?: boolean): Promise<boolean>;
     /**
-     * Refreshes the system instruction in-place without destroying the session.
-     * Used after memory mutations so the model sees updated facts.
+     * Refreshes the system instruction in-place.
      */
     refreshSystemInstruction(): void;
     /**
-     * Maps native core events to Tars-compatible event format.
+     * Attempts to find and load session history from either the Pi chats directory
+     * or the legacy Core history directory.
+     */
+    private loadHistory;
+    /**
+     * Saves session history to the Pi chats directory.
+     */
+    private saveHistory;
+    /**
+     * Helper to load legacy conversation records.
+     */
+    private loadConversationRecord;
+    /**
+     * Converts a legacy ConversationRecord to Pi SDK AgentMessage[] format.
      */
-    private normalizeEvent;
+    private migrateLegacyConversation;
     /**
-     * Attempts to find and load session history from the Core's history directory.
+     * Attempts to find and load legacy session history.
      */
     private loadResumedSessionData;
     /**
-     * Applies runtime overrides to the Gemini client to ensure smooth operation
-     * in specific environments (e.g., local inference).
+     * Closes the MCP client bridge connections.
      */
-    private applyClientOverrides;
+    shutdown(): Promise<void>;
 }