instar 0.8.8 → 0.8.10

package/dist/core/PostUpdateMigrator.js

@@ -196,6 +196,30 @@ Strip the \`[telegram:N]\` prefix before interpreting the message. Respond natur
         else {
             result.skipped.push('CLAUDE.md: Private Viewer section already present');
         }
+        // Dashboard section
+        if (!content.includes('**Dashboard**') && !content.includes('/dashboard')) {
+            const section = `
+**Dashboard** — Visual web interface for monitoring and managing sessions. Accessible from any device (phone, tablet, laptop) via tunnel.
+- Local: \`http://localhost:${port}/dashboard\`
+- Remote: When a tunnel is running, the dashboard is accessible at \`{tunnelUrl}/dashboard\`
+- Authentication: Uses a 6-digit PIN (configured via \`dashboardPin\` in \`.instar/config.json\`) — no need to enter the full bearer token
+- Features: Real-time terminal streaming of all running sessions, session management, model badges, mobile-responsive
+- **Sharing the dashboard**: When the user wants to check on sessions from their phone, give them the tunnel URL + PIN. Check tunnel status: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/tunnel\`
+`;
+            // Insert after Server Status or before Scripts section
+            const insertBefore = content.indexOf('**Scripts**');
+            if (insertBefore >= 0) {
+                content = content.slice(0, insertBefore) + section + '\n' + content.slice(insertBefore);
+            }
+            else {
+                content += '\n' + section;
+            }
+            patched = true;
+            result.upgraded.push('CLAUDE.md: added Dashboard section');
+        }
+        else {
+            result.skipped.push('CLAUDE.md: Dashboard section already present');
+        }
         if (patched) {
             try {
                 fs.writeFileSync(claudeMdPath, content);

package/dist/scaffold/templates.js

@@ -268,6 +268,13 @@ This routes feedback to the Instar maintainers automatically. Valid types: \`bug
 **Server Status** — Detailed runtime information beyond health checks.
 - Status: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/status\`
 
+**Dashboard** — Visual web interface for monitoring and managing sessions. Accessible from any device (phone, tablet, laptop) via tunnel.
+- Local: \`http://localhost:${port}/dashboard\`
+- Remote: When a tunnel is running, the dashboard is accessible at \`{tunnelUrl}/dashboard\`
+- Authentication: Uses a 6-digit PIN (configured via \`dashboardPin\` in \`.instar/config.json\`) — no need to enter the full bearer token
+- Features: Real-time terminal streaming of all running sessions, session management, model badges, mobile-responsive
+- **Sharing the dashboard**: When the user wants to check on sessions from their phone, give them the tunnel URL + PIN. Check tunnel status: \`curl -H "Authorization: Bearer $AUTH" http://localhost:${port}/tunnel\`
+
 **Scripts** — Reusable capabilities in \`.claude/scripts/\`.
 
 **Skills** — Reusable behavioral capabilities in \`.claude/skills/\`.

package/dist/server/AgentServer.js

@@ -142,6 +142,7 @@ export class AgentServer {
                     sessionManager: this.sessionManager,
                     state: this.state,
                     authToken: this.config.authToken,
+                    instarDir: this.config.stateDir,
                 });
                 resolve();
             });

package/dist/server/WebSocketManager.d.ts

@@ -36,11 +36,13 @@ export declare class WebSocketManager {
     private sessionManager;
     private state;
     private authToken?;
+    private registryPath?;
     constructor(options: {
         server: HttpServer;
         sessionManager: SessionManager;
         state: StateManager;
         authToken?: string;
+        instarDir?: string;
     });
     private authenticate;
     private verifyToken;
@@ -50,6 +52,12 @@ export declare class WebSocketManager {
      * Uses diff-based approach: only sends new content since last capture.
      */
     private startStreaming;
+    /**
+     * Resolve display names by cross-referencing the topic-session registry.
+     * Maps tmux session names to their Telegram topic names.
+     */
+    private getTopicDisplayNames;
+    private buildSessionList;
     private sendSessionList;
     private broadcastSessionList;
     private clientId;

package/dist/server/WebSocketManager.js

@@ -25,6 +25,8 @@
  */
 import { WebSocketServer, WebSocket } from 'ws';
 import { createHash, timingSafeEqual } from 'node:crypto';
+import fs from 'node:fs';
+import path from 'node:path';
 export class WebSocketManager {
     wss;
     clients = new Map();
@@ -35,10 +37,14 @@ export class WebSocketManager {
     sessionManager;
     state;
     authToken;
+    registryPath;
     constructor(options) {
         this.sessionManager = options.sessionManager;
         this.state = options.state;
         this.authToken = options.authToken;
+        if (options.instarDir) {
+            this.registryPath = path.join(options.instarDir, 'topic-session-registry.json');
+        }
         this.wss = new WebSocketServer({
             noServer: true,
         });
@@ -226,32 +232,52 @@ export class WebSocketManager {
         }, 500);
         this.streamInterval.unref();
     }
-    sendSessionList(ws) {
+    /**
+     * Resolve display names by cross-referencing the topic-session registry.
+     * Maps tmux session names to their Telegram topic names.
+     */
+    getTopicDisplayNames() {
+        const map = new Map();
+        if (!this.registryPath)
+            return map;
+        try {
+            const data = JSON.parse(fs.readFileSync(this.registryPath, 'utf-8'));
+            const topicToSession = data.topicToSession || {};
+            const topicToName = data.topicToName || {};
+            // Build reverse map: tmux session name → topic display name
+            for (const [topicId, tmuxSession] of Object.entries(topicToSession)) {
+                const name = topicToName[topicId];
+                if (name) {
+                    map.set(tmuxSession, name);
+                }
+            }
+        }
+        catch {
+            // Registry missing or corrupt — skip
+        }
+        return map;
+    }
+    buildSessionList() {
         const running = this.sessionManager.listRunningSessions();
-        const sessions = running.map(s => ({
+        const displayNames = this.getTopicDisplayNames();
+        return running.map(s => ({
             id: s.id,
-            name: s.name,
+            name: displayNames.get(s.tmuxSession) || s.name,
             tmuxSession: s.tmuxSession,
             status: s.status,
             startedAt: s.startedAt,
             jobSlug: s.jobSlug,
             model: s.model,
         }));
+    }
+    sendSessionList(ws) {
+        const sessions = this.buildSessionList();
         this.send(ws, { type: 'sessions', sessions });
     }
     broadcastSessionList() {
         if (this.clients.size === 0)
             return;
-        const running = this.sessionManager.listRunningSessions();
-        const sessions = running.map(s => ({
-            id: s.id,
-            name: s.name,
-            tmuxSession: s.tmuxSession,
-            status: s.status,
-            startedAt: s.startedAt,
-            jobSlug: s.jobSlug,
-            model: s.model,
-        }));
+        const sessions = this.buildSessionList();
         const msg = JSON.stringify({ type: 'sessions', sessions });
         for (const client of this.clients.values()) {
             if (client.ws.readyState === WebSocket.OPEN) {

package/package.json

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