instar 0.8.3 → 0.8.4

package/.vercel/README.txt

@@ -0,0 +1,11 @@
+> Why do I have a folder named ".vercel" in my project?
+The ".vercel" folder is created when you link a directory to a Vercel project.
+
+> What does the "project.json" file contain?
+The "project.json" file contains:
+- The ID of the Vercel project that you linked ("projectId")
+- The ID of the user or team your Vercel project is owned by ("orgId")
+
+> Should I commit the ".vercel" folder?
+No, you should not share the ".vercel" folder with anyone.
+Upon creation, it will be automatically added to your ".gitignore" file.

package/.vercel/project.json

@@ -0,0 +1 @@
+{"projectId":"prj_evM5LcItYL3IAmw8zNvEPGrHeaya","orgId":"team_dHctwIDcV3X9ydapQlCPHFGI","projectName":"claude-agent-kit"}

package/dist/lifeline/ServerSupervisor.d.ts

@@ -27,6 +27,8 @@ export declare class ServerSupervisor extends EventEmitter {
     private lastHealthy;
     private startupGraceMs;
     private spawnedAt;
+    private retryCooldownMs;
+    private maxRetriesExhaustedAt;
     constructor(options: {
         projectDir: string;
         projectName: string;
@@ -53,6 +55,8 @@ export declare class ServerSupervisor extends EventEmitter {
         restartAttempts: number;
         lastHealthy: number;
         serverSession: string;
+        coolingDown: boolean;
+        cooldownRemainingMs: number;
     };
     private spawnServer;
     private isServerSessionAlive;

package/dist/lifeline/ServerSupervisor.js

@@ -24,6 +24,8 @@ export class ServerSupervisor extends EventEmitter {
     lastHealthy = 0;
     startupGraceMs = 20_000; // 20 seconds grace period after spawn before health checks
     spawnedAt = 0;
+    retryCooldownMs = 5 * 60_000; // 5 minutes cooldown after max retries exhausted
+    maxRetriesExhaustedAt = 0;
     constructor(options) {
         super();
         this.projectDir = options.projectDir;
@@ -84,12 +86,18 @@ export class ServerSupervisor extends EventEmitter {
      * Get supervisor status.
      */
     getStatus() {
+        const coolingDown = this.maxRetriesExhaustedAt > 0;
+        const cooldownRemainingMs = coolingDown
+            ? Math.max(0, this.retryCooldownMs - (Date.now() - this.maxRetriesExhaustedAt))
+            : 0;
         return {
             running: this.isRunning,
             healthy: this.healthy,
             restartAttempts: this.restartAttempts,
             lastHealthy: this.lastHealthy,
             serverSession: this.serverSessionName,
+            coolingDown,
+            cooldownRemainingMs,
         };
     }
     spawnServer() {
@@ -188,28 +196,41 @@ export class ServerSupervisor extends EventEmitter {
             this.isRunning = false;
             this.emit('serverDown', 'Health check failed');
         }
+        // After max retries exhausted, wait for cooldown before trying again.
+        // This prevents permanent death from transient issues (port conflicts, etc.)
+        if (this.restartAttempts >= this.maxRestartAttempts) {
+            if (this.maxRetriesExhaustedAt === 0) {
+                this.maxRetriesExhaustedAt = Date.now();
+                console.error(`[Supervisor] Max restart attempts (${this.maxRestartAttempts}) reached. Cooling down for ${this.retryCooldownMs / 1000}s before retrying.`);
+            }
+            if ((Date.now() - this.maxRetriesExhaustedAt) >= this.retryCooldownMs) {
+                // Cooldown elapsed — reset and try again
+                console.log(`[Supervisor] Cooldown elapsed. Resetting restart counter.`);
+                this.restartAttempts = 0;
+                this.maxRetriesExhaustedAt = 0;
+                // Fall through to the restart logic below
+            }
+            else {
+                return; // Still cooling down
+            }
+        }
         // Auto-restart with backoff
-        if (this.restartAttempts < this.maxRestartAttempts) {
-            this.restartAttempts++;
-            const delay = this.restartBackoffMs * Math.pow(2, this.restartAttempts - 1);
-            console.log(`[Supervisor] Server unhealthy. Restart attempt ${this.restartAttempts}/${this.maxRestartAttempts} in ${delay}ms`);
-            this.emit('serverRestarting', this.restartAttempts);
-            setTimeout(() => {
-                // Kill stale session if it exists
-                if (this.tmuxPath && this.isServerSessionAlive()) {
-                    try {
-                        execFileSync(this.tmuxPath, ['kill-session', '-t', `=${this.serverSessionName}`], {
-                            stdio: 'ignore',
-                        });
-                    }
-                    catch { /* ignore */ }
+        this.restartAttempts++;
+        const delay = this.restartBackoffMs * Math.pow(2, this.restartAttempts - 1);
+        console.log(`[Supervisor] Server unhealthy. Restart attempt ${this.restartAttempts}/${this.maxRestartAttempts} in ${delay}ms`);
+        this.emit('serverRestarting', this.restartAttempts);
+        setTimeout(() => {
+            // Kill stale session if it exists
+            if (this.tmuxPath && this.isServerSessionAlive()) {
+                try {
+                    execFileSync(this.tmuxPath, ['kill-session', '-t', `=${this.serverSessionName}`], {
+                        stdio: 'ignore',
+                    });
                 }
-                this.spawnServer();
-            }, delay);
-        }
-        else {
-            console.error(`[Supervisor] Max restart attempts (${this.maxRestartAttempts}) reached. Server down.`);
-        }
+                catch { /* ignore */ }
+            }
+            this.spawnServer();
+        }, delay);
     }
 }
 //# sourceMappingURL=ServerSupervisor.js.map

package/dist/lifeline/TelegramLifeline.js

@@ -24,7 +24,9 @@ import path from 'node:path';
 import pc from 'picocolors';
 import { loadConfig, ensureStateDir } from '../core/Config.js';
 import { registerPort, unregisterPort, startHeartbeat } from '../core/PortRegistry.js';
-import { installAutoStart } from '../commands/setup.js';
+// setup.ts uses @inquirer/prompts which requires Node 20.12+
+// Dynamic import to avoid breaking the lifeline on older Node versions
+// import { installAutoStart } from '../commands/setup.js';
 import { MessageQueue } from './MessageQueue.js';
 import { ServerSupervisor } from './ServerSupervisor.js';
 /**
@@ -172,6 +174,8 @@ export class TelegramLifeline {
         // The user must always be able to reach their agent remotely — this is non-negotiable.
         try {
             if (!this.isAutostartInstalled()) {
+                // Dynamic import — setup.ts uses @inquirer/prompts which requires Node 20.12+
+                const { installAutoStart } = await import('../commands/setup.js');
                 const installed = installAutoStart(this.projectConfig.projectName, this.projectConfig.projectDir, true);
                 if (installed) {
                     console.log(pc.green(`  Auto-start self-healed: installed ${process.platform === 'darwin' ? 'LaunchAgent' : 'systemd service'}`));
@@ -310,9 +314,13 @@ export class TelegramLifeline {
         if (cmd === '/lifeline' || cmd === '/lifeline status') {
             const status = this.supervisor.getStatus();
             const queueSize = this.queue.length;
+            let serverLine = status.healthy ? '● healthy' : status.running ? '○ unhealthy' : '✗ down';
+            if (status.coolingDown) {
+                serverLine += ` (cooldown: ${Math.ceil(status.cooldownRemainingMs / 1000)}s)`;
+            }
             const lines = [
                 `Lifeline Status:`,
-                `  Server: ${status.healthy ? '● healthy' : status.running ? '○ unhealthy' : '✗ down'}`,
+                `  Server: ${serverLine}`,
                 `  Restart attempts: ${status.restartAttempts}`,
                 `  Queued messages: ${queueSize}`,
                 `  Last healthy: ${status.lastHealthy ? new Date(status.lastHealthy).toISOString().slice(11, 19) : 'never'}`,

package/dist/server/routes.js

@@ -1438,7 +1438,19 @@ export function createRoutes(ctx) {
             }
             else {
                 // No session or session dead — auto-spawn a new one
-                const topicName = targetSession || `topic-${topicId}`;
+                // Use topic name from registry, NOT the tmux session name.
+                // tmux names include the project prefix (e.g., "ai-guy-lifeline"), and
+                // spawnInteractiveSession prepends it again → cascading names.
+                let topicName = `topic-${topicId}`;
+                try {
+                    if (fs.existsSync(registryPath)) {
+                        const reg = JSON.parse(fs.readFileSync(registryPath, 'utf-8'));
+                        const stored = reg.topicToName?.[String(topicId)];
+                        if (stored)
+                            topicName = stored;
+                    }
+                }
+                catch { /* fall through to default */ }
                 console.log(`[telegram-forward] No live session for topic ${topicId}, spawning "${topicName}"...`);
                 const contextLines = [
                     `This session was auto-created for Telegram topic ${topicId}.`,

package/package.json

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