instar 0.7.44 → 0.7.46

package/dist/commands/server.js

@@ -9,6 +9,7 @@
  */
 import { execFileSync } from 'node:child_process';
 import fs from 'node:fs';
+import os from 'node:os';
 import path from 'node:path';
 import pc from 'picocolors';
 import { loadConfig, ensureStateDir, detectTmuxPath } from '../core/Config.js';
@@ -35,6 +36,24 @@ import { QuotaTracker } from '../monitoring/QuotaTracker.js';
 import { AccountSwitcher } from '../monitoring/AccountSwitcher.js';
 import { QuotaNotifier } from '../monitoring/QuotaNotifier.js';
 import { classifySessionDeath } from '../monitoring/QuotaExhaustionDetector.js';
+import { installAutoStart } from './setup.js';
+/**
+ * Check if autostart is installed for this project.
+ * Extracted from the CLI `autostart status` handler for programmatic use.
+ */
+function isAutostartInstalled(projectName) {
+    if (process.platform === 'darwin') {
+        const label = `ai.instar.${projectName}`;
+        const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${label}.plist`);
+        return fs.existsSync(plistPath);
+    }
+    else if (process.platform === 'linux') {
+        const serviceName = `instar-${projectName}.service`;
+        const servicePath = path.join(os.homedir(), '.config', 'systemd', 'user', serviceName);
+        return fs.existsSync(servicePath);
+    }
+    return false;
+}
 /**
  * Respawn a session for a topic, including thread history in the bootstrap.
  * This prevents "thread drift" where respawned sessions lose context.
@@ -794,6 +813,27 @@ export async function startServer(options) {
                 console.log(pc.yellow(`  Server running locally without tunnel. Fix tunnel config and restart.`));
             }
         }
+        // Self-healing: ensure autostart is installed so the server always restarts
+        // This is a non-negotiable requirement — the user must always be able to reach their agent remotely.
+        // If autostart isn't installed, install it silently. The agent should never require human intervention
+        // to ensure its own resilience.
+        try {
+            const hasTelegram = !!telegram;
+            const autostartInstalled = isAutostartInstalled(config.projectName);
+            if (!autostartInstalled) {
+                const installed = installAutoStart(config.projectName, config.projectDir, hasTelegram);
+                if (installed) {
+                    console.log(pc.green(`  Auto-start self-healed: installed ${process.platform === 'darwin' ? 'LaunchAgent' : 'systemd service'}`));
+                }
+                else {
+                    console.log(pc.yellow(`  Auto-start not available on ${process.platform}`));
+                }
+            }
+        }
+        catch (err) {
+            // Non-critical — don't crash the server over autostart
+            console.error(`  Auto-start check failed: ${err instanceof Error ? err.message : err}`);
+        }
         // Graceful shutdown
         const shutdown = async () => {
             console.log('\nShutting down...');

package/dist/commands/setup.js

@@ -813,10 +813,7 @@ ${argsXml}
     <key>RunAtLoad</key>
     <true/>
     <key>KeepAlive</key>
-    <dict>
-        <key>SuccessfulExit</key>
-        <false/>
-    </dict>
+    <true/>
     <key>StandardOutPath</key>
     <string>${escapeXml(path.join(logDir, `${command}-launchd.log`))}</string>
     <key>StandardErrorPath</key>

package/dist/lifeline/ServerSupervisor.js

@@ -97,7 +97,7 @@ export class ServerSupervisor extends EventEmitter {
             return false;
         try {
             // Get the instar CLI path
-            const cliPath = new URL('../../cli.js', import.meta.url).pathname;
+            const cliPath = new URL('../cli.js', import.meta.url).pathname;
             // --no-telegram: lifeline owns the Telegram connection, server should not poll
             const nodeCmd = ['node', cliPath, 'server', 'start', '--foreground', '--no-telegram']
                 .map(arg => `'${arg.replace(/'/g, "'\\''")}'`)

package/dist/lifeline/TelegramLifeline.d.ts

@@ -45,6 +45,10 @@ export declare class TelegramLifeline {
     private handleLifelineCommand;
     private replayQueue;
     private notifyServerDown;
+    /**
+     * Check if OS-level autostart is installed for this project.
+     */
+    private isAutostartInstalled;
     /**
      * Ensure the Lifeline topic exists. Recreates if deleted.
      */

package/dist/lifeline/TelegramLifeline.js

@@ -19,10 +19,12 @@
  * the full server crashes, runs out of memory, or gets stuck.
  */
 import fs from 'node:fs';
+import os from 'node:os';
 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';
 import { MessageQueue } from './MessageQueue.js';
 import { ServerSupervisor } from './ServerSupervisor.js';
 /**
@@ -127,7 +129,7 @@ export class TelegramLifeline {
         // Acquire exclusive lock — prevent multiple lifeline instances
         if (!acquireLockFile(this.lockPath)) {
             console.error(pc.red('[Lifeline] Another lifeline instance is already running. Exiting.'));
-            process.exit(0); // Clean exit — launchd won't respawn on clean exit with KeepAlive config
+            process.exit(0); // Clean exit — launchd will restart after ThrottleInterval, acting as a watchdog
         }
         // Register in port registry (lifeline owns the port claim)
         try {
@@ -166,6 +168,19 @@ export class TelegramLifeline {
                 setTimeout(() => this.replayQueue(), 5000); // Wait for server to fully start
             }
         }
+        // Self-healing: ensure autostart is installed so the lifeline persists across reboots.
+        // The user must always be able to reach their agent remotely — this is non-negotiable.
+        try {
+            if (!this.isAutostartInstalled()) {
+                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'}`));
+                }
+            }
+        }
+        catch {
+            // Non-critical — don't crash the lifeline over autostart
+        }
         // Graceful shutdown
         const shutdown = async () => {
             console.log('\nLifeline shutting down...');
@@ -366,6 +381,22 @@ export class TelegramLifeline {
         await this.sendToTopic(topicId, `Server went down: ${reason}\n\nYour messages will be queued until recovery. Use /lifeline status to check.`).catch(() => { });
     }
     // ── Lifeline Topic ──────────────────────────────────────────
+    /**
+     * Check if OS-level autostart is installed for this project.
+     */
+    isAutostartInstalled() {
+        if (process.platform === 'darwin') {
+            const label = `ai.instar.${this.projectConfig.projectName}`;
+            const plistPath = path.join(os.homedir(), 'Library', 'LaunchAgents', `${label}.plist`);
+            return fs.existsSync(plistPath);
+        }
+        else if (process.platform === 'linux') {
+            const serviceName = `instar-${this.projectConfig.projectName}.service`;
+            const servicePath = path.join(os.homedir(), '.config', 'systemd', 'user', serviceName);
+            return fs.existsSync(servicePath);
+        }
+        return false;
+    }
     /**
      * Ensure the Lifeline topic exists. Recreates if deleted.
      */

package/package.json

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