claude-threads 1.23.0 → 1.24.1

package/CHANGELOG.md

@@ -5,6 +5,20 @@ 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
+- **`!model` and `!effort` — switch model or reasoning effort mid-session.** Verified against the real CLI (2.1.226): `/model` and `/effort` work over stream-json (`/model` with no args lists the options; `/model sonnet` switches "for this session only"; `/effort low|medium|high|xhigh|max|auto`), and both are listed in the CLI's `init.slash_commands` — so the bot's dynamic slash-command passthrough forwards `!model sonnet` / `!effort high` as-is and the CLI's confirmation posts to the thread. Both are now first-class registered commands with unconditional forwarding handlers (like `!context`/`!cost`/`!compact` — they work even before the CLI's init event arrives, and forward their argument: `!model sonnet` → `/model sonnet`), and `!help` gained a line pointing out that Claude Code slash commands work with `!`.
+- **The session header now shows the model the session actually runs on.** Previously the header picked the "primary model" by highest cumulative cost — after a `!model` switch the old model keeps the larger spend, so the header kept naming the old model indefinitely. The per-turn `init.model` (re-emitted every turn, per the reference captures) is now authoritative. Model display names also cover the Claude 5 family via generic id parsing (`claude-sonnet-5` → "Sonnet 5", `claude-fable-5` → "Fable 5", dated ids still render as before).
+
+### Changed
+- **Latest verified Claude CLI: 2.1.226** (from 2.1.223). The full verification battery ran against it this cycle: the decision-bridge e2e (4/4), all 17 reference captures re-recorded on 2.1.225/2.1.226, and both integration matrices. Install hints updated. Also verified while probing: `/cd` and `/add-dir` report "isn't available in this environment" over stream-json on 2.1.226 — a native in-session directory switch isn't possible, so `!cd` keeps its restart-based implementation.
+
 ## [1.23.0] - 2026-08-08
 
 ### Fixed

package/dist/index.js

@@ -51319,7 +51319,7 @@ var COMMON_CLAUDE_PATHS = process.platform === "win32" ? [
 var CLAUDE_CLI_MIN_VERSION = "2.0.74";
 var CLAUDE_CLI_VERIFIED_RANGE = ">=2.0.74 <2.2.0";
 var CLAUDE_CLI_SUPPORTED_MAJOR = 2;
-var CLAUDE_CLI_LATEST_VERIFIED = "2.1.223";
+var CLAUDE_CLI_LATEST_VERIFIED = "2.1.226";
 function tryClaudeVersion(claudePath) {
   try {
     const output = execSync(`"${claudePath}" --version`, {
@@ -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) {
@@ -57560,6 +57567,18 @@ var COMMAND_REGISTRY = [
     description: "Compact conversation",
     category: "passthrough",
     audience: "both"
+  },
+  {
+    command: "model",
+    description: "Show or switch the model for this session (e.g. !model sonnet)",
+    category: "passthrough",
+    audience: "both"
+  },
+  {
+    command: "effort",
+    description: "Set reasoning effort: low|medium|high|xhigh|max|auto (e.g. !effort high)",
+    category: "passthrough",
+    audience: "both"
   }
 ];
 var REACTION_REGISTRY = [
@@ -57617,6 +57636,8 @@ var COMMAND_PATTERNS = [
   ["context", /^!context\s*$/i],
   ["cost", /^!cost\s*$/i],
   ["compact", /^!compact\s*$/i],
+  ["model", /^!model(?:\s+(\S+))?\s*$/i],
+  ["effort", /^!effort(?:\s+(\S+))?\s*$/i],
   ["plugin", /^!plugin(?:\s+(.+))?$/i],
   ["kill", /^!kill\s*$/i],
   ["bug", /^!bug(?:\s+(.+))?$/i],
@@ -57741,6 +57762,8 @@ ${formatter.formatBold("Reactions:")}
 ` + `${formatter.formatListItem(approvalReactions)}
 ` + `${formatter.formatListItem(sessionReactions)}
 
+` + `Claude Code slash commands work with ${code("!")} too — e.g. ${code("!model sonnet")}, ${code("!effort high")}, ${code("!compact")}, ${code("!context")}.
+
 ` + formatSponsorFooter(formatter);
 }
 
@@ -58122,12 +58145,13 @@ var handlePlugin = async (ctx, args) => {
   return { handled: true };
 };
 function createPassthroughHandler(slashCommand) {
-  return async (ctx) => {
+  return async (ctx, args) => {
     if (ctx.commandContext === "first-message") {
       return { handled: false };
     }
     if (ctx.isAllowed) {
-      await ctx.sessionManager.sendFollowUp(ctx.threadId, `/${slashCommand}`, undefined, undefined, undefined, { system: true });
+      const full = args ? `/${slashCommand} ${args}` : `/${slashCommand}`;
+      await ctx.sessionManager.sendFollowUp(ctx.threadId, full, undefined, undefined, undefined, { system: true });
     }
     return { handled: true };
   };
@@ -58150,6 +58174,8 @@ handlers.set("plugin", handlePlugin);
 handlers.set("context", createPassthroughHandler("context"));
 handlers.set("cost", createPassthroughHandler("cost"));
 handlers.set("compact", createPassthroughHandler("compact"));
+handlers.set("model", createPassthroughHandler("model"));
+handlers.set("effort", createPassthroughHandler("effort"));
 async function executeCommand(command, args, ctx) {
   const cmdDef = getCommandDef(command);
   if (!cmdDef) {
@@ -65021,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 {
@@ -65114,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
@@ -67208,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);
   }
@@ -68841,6 +68906,9 @@ function handleEventPreProcessing(session, event, ctx) {
   }
   if (event.type === "system") {
     const e = event;
+    if (e.subtype === "init" && typeof e.model === "string") {
+      session.currentModel = e.model;
+    }
     if (e.subtype === "init" && e.slash_commands && Array.isArray(e.slash_commands)) {
       session.availableSlashCommands = new Set(e.slash_commands.map((cmd) => cmd.startsWith("/") ? cmd.slice(1) : cmd));
       sessionLog3(session).info(`Captured ${session.availableSlashCommands.size} slash commands from init: ${[...session.availableSlashCommands].join(", ")}`);
@@ -68882,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 || []) {
@@ -68899,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;
@@ -68975,20 +69048,15 @@ async function handleCompactionComplete(session, compactMetadata, _ctx) {
   }
 }
 function getModelDisplayName(modelId) {
-  if (modelId.includes("opus-4-5") || modelId.includes("opus-4.5"))
-    return "Opus 4.5";
-  if (modelId.includes("opus-4"))
-    return "Opus 4";
-  if (modelId.includes("opus"))
-    return "Opus";
-  if (modelId.includes("sonnet-4"))
-    return "Sonnet 4";
-  if (modelId.includes("sonnet-3-5") || modelId.includes("sonnet-3.5"))
-    return "Sonnet 3.5";
+  const modern = modelId.match(/^claude-([a-z]+)-(\d+)(?:-(\d{1,2}))?(?:-\d{8})?$/);
+  if (modern) {
+    const family = modern[1].charAt(0).toUpperCase() + modern[1].slice(1);
+    return modern[3] ? `${family} ${modern[2]}.${modern[3]}` : `${family} ${modern[2]}`;
+  }
   if (modelId.includes("sonnet"))
     return "Sonnet";
-  if (modelId.includes("haiku-4-5") || modelId.includes("haiku-4.5"))
-    return "Haiku 4.5";
+  if (modelId.includes("opus"))
+    return "Opus";
   if (modelId.includes("haiku"))
     return "Haiku";
   const match = modelId.match(/claude-(\w+)/);
@@ -69019,6 +69087,10 @@ function updateUsageStats(session, event, ctx) {
       contextWindowSize = usage.contextWindow;
     }
   }
+  if (session.currentModel && result.modelUsage[session.currentModel]) {
+    primaryModel = session.currentModel;
+    contextWindowSize = result.modelUsage[session.currentModel].contextWindow;
+  }
   let contextTokens = 0;
   if (result.usage) {
     contextTokens = result.usage.input_tokens + result.usage.cache_creation_input_tokens + result.usage.cache_read_input_tokens;
@@ -70856,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({
@@ -71806,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);
@@ -71845,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;
       }
@@ -71874,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) {
@@ -56734,6 +56780,18 @@ var COMMAND_REGISTRY = [
     description: "Compact conversation",
     category: "passthrough",
     audience: "both"
+  },
+  {
+    command: "model",
+    description: "Show or switch the model for this session (e.g. !model sonnet)",
+    category: "passthrough",
+    audience: "both"
+  },
+  {
+    command: "effort",
+    description: "Set reasoning effort: low|medium|high|xhigh|max|auto (e.g. !effort high)",
+    category: "passthrough",
+    audience: "both"
   }
 ];
 var REACTION_REGISTRY = [
@@ -56806,6 +56864,8 @@ ${formatter.formatBold("Reactions:")}
 ` + `${formatter.formatListItem(approvalReactions)}
 ` + `${formatter.formatListItem(sessionReactions)}
 
+` + `Claude Code slash commands work with ${code("!")} too — e.g. ${code("!model sonnet")}, ${code("!effort high")}, ${code("!compact")}, ${code("!context")}.
+
 ` + formatSponsorFooter(formatter);
 }
 
@@ -57072,12 +57132,13 @@ var handlePlugin = async (ctx, args) => {
   return { handled: true };
 };
 function createPassthroughHandler(slashCommand) {
-  return async (ctx) => {
+  return async (ctx, args) => {
     if (ctx.commandContext === "first-message") {
       return { handled: false };
     }
     if (ctx.isAllowed) {
-      await ctx.sessionManager.sendFollowUp(ctx.threadId, `/${slashCommand}`, undefined, undefined, undefined, { system: true });
+      const full = args ? `/${slashCommand} ${args}` : `/${slashCommand}`;
+      await ctx.sessionManager.sendFollowUp(ctx.threadId, full, undefined, undefined, undefined, { system: true });
     }
     return { handled: true };
   };
@@ -57100,6 +57161,8 @@ handlers.set("plugin", handlePlugin);
 handlers.set("context", createPassthroughHandler("context"));
 handlers.set("cost", createPassthroughHandler("cost"));
 handlers.set("compact", createPassthroughHandler("compact"));
+handlers.set("model", createPassthroughHandler("model"));
+handlers.set("effort", createPassthroughHandler("effort"));
 // src/commands/system-prompt-generator.ts
 var log9 = createLogger("system-prompt");
 function formatUserCommand(cmd) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "claude-threads",
-  "version": "1.23.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",