mattermost-claude-code 0.5.4 → 0.5.6

package/README.md

@@ -17,23 +17,21 @@ Share Claude Code sessions live in a Mattermost channel. Your colleagues can wat
 
 ## How it works
 
-```
-┌─────────────────────────────────────────────────────────────────┐
-│                     Your Local Machine                          │
-│  ┌─────────────────┐         ┌─────────────────────────────┐   │
-│  │ Claude Code CLI │◀───────▶│ mm-claude                   │   │
-│  │ (subprocess)    │ stdio   │ (this service)              │   │
-│  └─────────────────┘         └──────────┬──────────────────┘   │
-└─────────────────────────────────────────┼───────────────────────┘
-                                          │ WebSocket + REST API
-                                          ▼ (outbound only)
-┌─────────────────────────────────────────────────────────────────┐
-│                     Mattermost Server                           │
-│  ┌─────────────────┐         ┌─────────────────────────────┐   │
-│  │ Bot Account     │◀───────▶│ Channel                     │   │
-│  │ @claude-code    │         │ #claude-sessions            │   │
-│  └─────────────────┘         └─────────────────────────────┘   │
-└─────────────────────────────────────────────────────────────────┘
+```mermaid
+flowchart TB
+    subgraph local["Your Local Machine"]
+        cli["Claude Code CLI<br/>(subprocess)"]
+        mm["mm-claude<br/>(this service)"]
+        cli <-->|"stdio"| mm
+    end
+
+    subgraph server["Mattermost Server"]
+        bot["Bot Account<br/>@claude-code"]
+        channel["Channel<br/>#claude-sessions"]
+        bot <--> channel
+    end
+
+    mm -->|"WebSocket + REST API<br/>(outbound only)"| server
 ```
 
 Runs entirely on your machine - only **outbound** connections to Mattermost. No port forwarding needed!

package/dist/claude/session.d.ts

@@ -51,6 +51,7 @@ interface Session {
     activeSubagents: Map<string, string>;
     updateTimer: ReturnType<typeof setTimeout> | null;
     typingTimer: ReturnType<typeof setInterval> | null;
+    timeoutWarningPosted: boolean;
 }
 export declare class SessionManager {
     private mattermost;

package/dist/claude/session.js

@@ -16,6 +16,7 @@ const EMOJI_TO_INDEX = {
 // =============================================================================
 const MAX_SESSIONS = parseInt(process.env.MAX_SESSIONS || '5', 10);
 const SESSION_TIMEOUT_MS = parseInt(process.env.SESSION_TIMEOUT_MS || '1800000', 10); // 30 min
+const SESSION_WARNING_MS = 5 * 60 * 1000; // Warn 5 minutes before timeout
 // =============================================================================
 // SessionManager - Manages multiple concurrent Claude Code sessions
 // =============================================================================
@@ -127,6 +128,7 @@ export class SessionManager {
             activeSubagents: new Map(),
             updateTimer: null,
             typingTimer: null,
+            timeoutWarningPosted: false,
         };
         // Register session
         this.sessions.set(actualThreadId, session);
@@ -157,8 +159,9 @@ export class SessionManager {
         const session = this.sessions.get(threadId);
         if (!session)
             return;
-        // Update last activity
+        // Update last activity and reset timeout warning
         session.lastActivityAt = new Date();
+        session.timeoutWarningPosted = false;
         // Check for special tool uses that need custom handling
         if (event.type === 'assistant') {
             const msg = event.message;
@@ -937,8 +940,10 @@ export class SessionManager {
     /** Cleanup idle sessions that have exceeded timeout */
     cleanupIdleSessions() {
         const now = Date.now();
+        const warningThreshold = SESSION_TIMEOUT_MS - SESSION_WARNING_MS;
         for (const [threadId, session] of this.sessions.entries()) {
             const idleTime = now - session.lastActivityAt.getTime();
+            // Check if we should time out
             if (idleTime > SESSION_TIMEOUT_MS) {
                 const mins = Math.round(idleTime / 60000);
                 const shortId = threadId.substring(0, 8);
@@ -946,6 +951,14 @@ export class SessionManager {
                 this.mattermost.createPost(`⏰ **Session timed out** — no activity for ${mins} minutes`, session.threadId).catch(() => { });
                 this.killSession(threadId);
             }
+            // Check if we should show warning (only once)
+            else if (idleTime > warningThreshold && !session.timeoutWarningPosted) {
+                const remainingMins = Math.round((SESSION_TIMEOUT_MS - idleTime) / 60000);
+                const shortId = threadId.substring(0, 8);
+                console.log(`  ⚠️ Session (${shortId}…) warning: ${remainingMins}m until timeout`);
+                this.mattermost.createPost(`⚠️ **Session idle** — will time out in ~${remainingMins} minutes. Send a message to keep it alive.`, session.threadId).catch(() => { });
+                session.timeoutWarningPosted = true;
+            }
         }
     }
 }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "mattermost-claude-code",
-  "version": "0.5.4",
+  "version": "0.5.6",
   "description": "Share Claude Code sessions live in a Mattermost channel with interactive features",
   "main": "dist/index.js",
   "type": "module",