claude-threads 1.24.0 → 1.24.1

package/CHANGELOG.md

@@ -5,6 +5,11 @@ All notable changes to this project will be documented in this file.
 The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
 and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
 
+## [1.24.1] - 2026-08-08
+
+### Fixed
+- **Task lists no longer degrade to "Task #N" placeholders after a bot restart.** Modern CLIs stream tasks incrementally (`TaskCreate`/`TaskUpdate` with ids), and the bot accumulates them in a per-session `TaskTracker` — but that tracker lived only in memory. After a restart + resume, the first `TaskUpdate` of the next turn hit an empty tracker and rendered a placeholder ("Task #1") instead of the real subject, losing every task name for the rest of the session. The tracker's resolved tasks (id → subject/status) are now persisted to `sessions.json` at each turn end and restored on resume. In-flight creates (id not yet resolved from result text) are deliberately dropped at serialize time; pre-1.24.1 persisted sessions simply start with an empty tracker as before. Covered by a red-green integration test that restarts the bot mid-task-list and asserts the post-resume re-render still shows real subjects on both platform paths.
+
 ## [1.24.0] - 2026-08-08
 
 ### Added

package/dist/index.js

@@ -56301,16 +56301,23 @@ class ClaudeCli extends EventEmitter2 {
       const trimmed = line.trim();
       if (!trimmed)
         continue;
+      let event;
+      try {
+        event = JSON.parse(trimmed);
+      } catch {
+        continue;
+      }
       try {
-        const event = JSON.parse(trimmed);
         this.emit("event", event);
-        if (event.type === "result" && isErrorResultEvent(event)) {
-          this.maybeEmitRateLimit(trimmed);
-        }
-        if (event.type === "rate_limit_event") {
-          this.maybeEmitRateLimitHit(parseRateLimitEvent(event));
-        }
-      } catch {}
+      } catch (err) {
+        this.log.error(`'event' listener threw while handling a ${event.type} event: ${err}`);
+      }
+      if (event.type === "result" && isErrorResultEvent(event)) {
+        this.maybeEmitRateLimit(trimmed);
+      }
+      if (event.type === "rate_limit_event") {
+        this.maybeEmitRateLimitHit(parseRateLimitEvent(event));
+      }
     }
   }
   maybeEmitRateLimit(text) {
@@ -65040,6 +65047,7 @@ function truncateAtWord2(text, maxLength) {
   return truncated + "...";
 }
 // src/operations/task-tracker.ts
+var VALID_STATUSES = new Set(["pending", "in_progress", "completed"]);
 var CREATED_RESULT_RE = /Task #(\S+) created/;
 
 class TaskTracker {
@@ -65133,6 +65141,38 @@ class TaskTracker {
     this.pendingCreates.clear();
     this.unmatchedCreateResults = 0;
   }
+  serialize() {
+    const restorable = this.tasks.filter((t) => Boolean(t.taskId));
+    if (restorable.length === 0)
+      return;
+    return restorable.map((t) => {
+      const out = {
+        taskId: t.taskId,
+        subject: t.subject,
+        status: t.status
+      };
+      if (t.activeForm)
+        out.activeForm = t.activeForm;
+      if (t.isPlaceholder)
+        out.isPlaceholder = true;
+      return out;
+    });
+  }
+  restore(state) {
+    if (!Array.isArray(state)) {
+      this.tasks = [];
+      this.pendingCreates.clear();
+      return;
+    }
+    this.tasks = state.filter((t) => t !== null && typeof t === "object" && typeof t.taskId === "string" && t.taskId.length > 0 && typeof t.subject === "string").map((t) => ({
+      taskId: t.taskId,
+      subject: t.subject || `Task #${t.taskId}`,
+      activeForm: typeof t.activeForm === "string" ? t.activeForm : undefined,
+      status: VALID_STATUSES.has(t.status) ? t.status : "pending",
+      isPlaceholder: t.isPlaceholder === true ? true : undefined
+    }));
+    this.pendingCreates.clear();
+  }
 }
 
 // src/operations/executors/base.ts
@@ -67227,9 +67267,15 @@ class MessageManager {
   serialize() {
     return {
       taskList: this.taskListExecutor.serialize(),
+      taskTracker: this.taskTracker.serialize(),
       contextPrompt: this.promptExecutor.serialize()
     };
   }
+  restoreTaskTracker(state) {
+    if (state && state.length > 0) {
+      this.taskTracker.restore(state);
+    }
+  }
   hydrateTaskListState(persisted) {
     this.taskListExecutor.hydrateState(persisted);
   }
@@ -68904,7 +68950,7 @@ function handleEventPreProcessing(session, event, ctx) {
     trackEvent(session, "tool_use", tool.name);
   }
 }
-function handleEventPostProcessing(session, event, ctx) {
+function handleEventPostProcessing(session, event, ctx, mainHandling) {
   if (event.type === "assistant") {
     const msg = event.message;
     for (const block of msg?.content || []) {
@@ -68921,6 +68967,11 @@ function handleEventPostProcessing(session, event, ctx) {
     session.isProcessing = false;
     ctx.ops.emitSessionUpdate(session.sessionId, { status: getSessionStatus(session) });
     updateUsageStats(session, event, ctx);
+    if (mainHandling) {
+      mainHandling.catch(() => {}).then(() => ctx.ops.persistSession(session));
+    } else {
+      ctx.ops.persistSession(session);
+    }
   }
   if (event.type === "user" && !isSidechainEvent(event)) {
     const msg = event.message;
@@ -70877,6 +70928,7 @@ Please start a new session.`), { action: "Post resume failure notification" });
     tasksCompleted: state.tasksCompleted,
     tasksMinimized: state.tasksMinimized
   });
+  session.messageManager.restoreTaskTracker(state.taskTrackerState);
   const persistedWithInteractive = state;
   if (persistedWithInteractive.pendingQuestionSet || persistedWithInteractive.pendingApproval) {
     session.messageManager.hydrateInteractiveState({
@@ -71827,8 +71879,8 @@ class SessionManager extends EventEmitter4 {
     if (!session || !session.messageManager)
       return;
     handleEventPreProcessing(session, event, this.getContext());
-    session.messageManager.handleEvent(event);
-    handleEventPostProcessing(session, event, this.getContext());
+    const mainHandling = session.messageManager.handleEvent(event);
+    handleEventPostProcessing(session, event, this.getContext(), mainHandling);
   }
   async handleExit(sessionId, code, source) {
     await handleExit(sessionId, code, this.getContext(), source);
@@ -71866,11 +71918,20 @@ class SessionManager extends EventEmitter4 {
     this.stopTyping(session);
   }
   persistSession(session) {
+    try {
+      this.persistSessionUnsafe(session);
+    } catch (err) {
+      log35.error(`Failed to persist session ${session.sessionId}: ${err}`);
+    }
+  }
+  persistSessionUnsafe(session) {
     let taskListSnapshot;
     let contextPromptSnapshot;
+    let taskTrackerSnapshot;
     if (session.messageManager) {
       const serialized = session.messageManager.serialize();
       taskListSnapshot = serialized.taskList;
+      taskTrackerSnapshot = serialized.taskTracker;
       if (serialized.contextPrompt) {
         contextPromptSnapshot = serialized.contextPrompt;
       }
@@ -71895,6 +71956,7 @@ class SessionManager extends EventEmitter4 {
       lastTasksContent: taskListSnapshot?.content ?? null,
       tasksCompleted: taskListSnapshot?.isCompleted ?? false,
       tasksMinimized: taskListSnapshot?.isMinimized ?? false,
+      taskTrackerState: taskTrackerSnapshot,
       worktreeInfo: session.worktreeInfo,
       isWorktreeOwner: session.isWorktreeOwner,
       pendingWorktreePrompt: session.pendingWorktreePrompt,

package/dist/mcp/mcp-server.js

@@ -49412,6 +49412,7 @@ function truncateAtWord(text, maxLength) {
   return truncated + "...";
 }
 // src/operations/task-tracker.ts
+var VALID_STATUSES = new Set(["pending", "in_progress", "completed"]);
 var CREATED_RESULT_RE = /Task #(\S+) created/;
 
 class TaskTracker {
@@ -49505,6 +49506,38 @@ class TaskTracker {
     this.pendingCreates.clear();
     this.unmatchedCreateResults = 0;
   }
+  serialize() {
+    const restorable = this.tasks.filter((t) => Boolean(t.taskId));
+    if (restorable.length === 0)
+      return;
+    return restorable.map((t) => {
+      const out = {
+        taskId: t.taskId,
+        subject: t.subject,
+        status: t.status
+      };
+      if (t.activeForm)
+        out.activeForm = t.activeForm;
+      if (t.isPlaceholder)
+        out.isPlaceholder = true;
+      return out;
+    });
+  }
+  restore(state) {
+    if (!Array.isArray(state)) {
+      this.tasks = [];
+      this.pendingCreates.clear();
+      return;
+    }
+    this.tasks = state.filter((t) => t !== null && typeof t === "object" && typeof t.taskId === "string" && t.taskId.length > 0 && typeof t.subject === "string").map((t) => ({
+      taskId: t.taskId,
+      subject: t.subject || `Task #${t.taskId}`,
+      activeForm: typeof t.activeForm === "string" ? t.activeForm : undefined,
+      status: VALID_STATUSES.has(t.status) ? t.status : "pending",
+      isPlaceholder: t.isPlaceholder === true ? true : undefined
+    }));
+    this.pendingCreates.clear();
+  }
 }
 
 // src/operations/executors/base.ts
@@ -51908,9 +51941,15 @@ class MessageManager {
   serialize() {
     return {
       taskList: this.taskListExecutor.serialize(),
+      taskTracker: this.taskTracker.serialize(),
       contextPrompt: this.promptExecutor.serialize()
     };
   }
+  restoreTaskTracker(state) {
+    if (state && state.length > 0) {
+      this.taskTracker.restore(state);
+    }
+  }
   hydrateTaskListState(persisted) {
     this.taskListExecutor.hydrateState(persisted);
   }
@@ -56409,16 +56448,23 @@ class ClaudeCli extends EventEmitter2 {
       const trimmed = line.trim();
       if (!trimmed)
         continue;
+      let event;
+      try {
+        event = JSON.parse(trimmed);
+      } catch {
+        continue;
+      }
       try {
-        const event = JSON.parse(trimmed);
         this.emit("event", event);
-        if (event.type === "result" && isErrorResultEvent(event)) {
-          this.maybeEmitRateLimit(trimmed);
-        }
-        if (event.type === "rate_limit_event") {
-          this.maybeEmitRateLimitHit(parseRateLimitEvent(event));
-        }
-      } catch {}
+      } catch (err) {
+        this.log.error(`'event' listener threw while handling a ${event.type} event: ${err}`);
+      }
+      if (event.type === "result" && isErrorResultEvent(event)) {
+        this.maybeEmitRateLimit(trimmed);
+      }
+      if (event.type === "rate_limit_event") {
+        this.maybeEmitRateLimitHit(parseRateLimitEvent(event));
+      }
     }
   }
   maybeEmitRateLimit(text) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-threads",
-  "version": "1.24.0",
+  "version": "1.24.1",
   "description": "Run Claude Code from Slack or Mattermost. Sessions stream live into threads where your whole team can watch and steer.",
   "main": "dist/index.js",
   "type": "module",