instar 0.4.2 → 0.4.3

package/dist/commands/server.js

@@ -113,6 +113,27 @@ function wireTelegramCallbacks(telegram, sessionManager, state) {
     telegram.onIsSessionAlive = (sessionName) => {
         return sessionManager.isSessionAlive(sessionName);
     };
+    // Stall verification — check if session has recent output activity
+    telegram.onIsSessionActive = async (sessionName) => {
+        const output = sessionManager.captureOutput(sessionName, 20);
+        if (!output)
+            return false;
+        const lines = output.trim().split('\n').slice(-15);
+        // Look for signs of Claude Code activity in recent output
+        const activePatterns = [
+            /\bRead\b|\bWrite\b|\bEdit\b|\bBash\b|\bGrep\b|\bGlob\b/, // Tool names
+            /⠋|⠙|⠹|⠸|⠼|⠴|⠦|⠧|⠇|⠏/, // Spinner characters
+            /\d+\s*tokens?/i, // Token counts
+            /Sent \d+ chars/, // Telegram reply confirmation
+        ];
+        for (const line of lines) {
+            for (const pattern of activePatterns) {
+                if (pattern.test(line))
+                    return true;
+            }
+        }
+        return false;
+    };
 }
 /**
  * Wire up Telegram message routing: topic messages → Claude sessions.

package/dist/messaging/TelegramAdapter.d.ts

@@ -65,6 +65,7 @@ export declare class TelegramAdapter implements MessagingAdapter {
         alive: boolean;
     }>) | null;
     onIsSessionAlive: ((tmuxSession: string) => boolean) | null;
+    onIsSessionActive: ((tmuxSession: string) => Promise<boolean>) | null;
     constructor(config: TelegramConfig, stateDir: string);
     start(): Promise<void>;
     stop(): Promise<void>;

package/dist/messaging/TelegramAdapter.js

@@ -37,6 +37,7 @@ export class TelegramAdapter {
     onRestartSession = null;
     onListSessions = null;
     onIsSessionAlive = null;
+    onIsSessionActive = null;
     constructor(config, stateDir) {
         this.config = config;
         this.stateDir = stateDir;
@@ -237,7 +238,7 @@ export class TelegramAdapter {
             }
         }
     }
-    checkForStalls() {
+    async checkForStalls() {
         const stallMinutes = this.config.stallTimeoutMinutes ?? 5;
         const stallThresholdMs = stallMinutes * 60 * 1000;
         const now = Date.now();
@@ -250,6 +251,21 @@ export class TelegramAdapter {
             const alive = this.onIsSessionAlive
                 ? this.onIsSessionAlive(pending.sessionName)
                 : true; // assume alive if no checker
+            // If alive, verify the session is truly stalled (not just responding through a different path)
+            if (alive && this.onIsSessionActive) {
+                try {
+                    const active = await this.onIsSessionActive(pending.sessionName);
+                    if (active) {
+                        // Session is producing output — false alarm, clear it
+                        console.log(`[telegram] Session "${pending.sessionName}" verified active, clearing stall`);
+                        this.pendingMessages.delete(key);
+                        continue;
+                    }
+                }
+                catch {
+                    // Verifier failed — fall through to alert
+                }
+            }
             pending.alerted = true;
             const status = alive ? 'running but not responding' : 'no longer running';
             const minutesAgo = Math.round((now - pending.injectedAt) / 60000);
@@ -278,20 +294,36 @@ export class TelegramAdapter {
      * Download a file from Telegram by file_id.
      */
     async downloadFile(fileId, destPath) {
-        const fileInfo = await this.apiCall('getFile', { file_id: fileId });
-        const fileUrl = `https://api.telegram.org/file/bot${this.config.token}/${fileInfo.file_path}`;
-        const controller = new AbortController();
-        const timer = setTimeout(() => controller.abort(), 60_000);
-        try {
-            const response = await fetch(fileUrl, { signal: controller.signal });
-            if (!response.ok)
-                throw new Error(`Download failed: ${response.status}`);
-            const buffer = Buffer.from(await response.arrayBuffer());
-            fs.writeFileSync(destPath, buffer);
-        }
-        finally {
-            clearTimeout(timer);
+        const maxRetries = 3;
+        let lastError;
+        for (let attempt = 1; attempt <= maxRetries; attempt++) {
+            try {
+                const fileInfo = await this.apiCall('getFile', { file_id: fileId });
+                const fileUrl = `https://api.telegram.org/file/bot${this.config.token}/${fileInfo.file_path}`;
+                const controller = new AbortController();
+                const timer = setTimeout(() => controller.abort(), 60_000);
+                try {
+                    const response = await fetch(fileUrl, { signal: controller.signal });
+                    if (!response.ok)
+                        throw new Error(`Download failed: ${response.status}`);
+                    const buffer = Buffer.from(await response.arrayBuffer());
+                    fs.writeFileSync(destPath, buffer);
+                    return; // Success
+                }
+                finally {
+                    clearTimeout(timer);
+                }
+            }
+            catch (err) {
+                lastError = err instanceof Error ? err : new Error(String(err));
+                if (attempt < maxRetries) {
+                    const delay = attempt * 1000;
+                    console.warn(`[telegram] File download attempt ${attempt}/${maxRetries} failed, retrying in ${delay}ms...`);
+                    await new Promise(resolve => setTimeout(resolve, delay));
+                }
+            }
         }
+        throw lastError;
     }
     /**
      * Resolve voice transcription provider from config or environment.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "instar",
-  "version": "0.4.2",
+  "version": "0.4.3",
   "description": "Persistent autonomy infrastructure for AI agents",
   "type": "module",
   "main": "dist/index.js",