claude-threads 0.57.4 → 0.58.0

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.58.0] - 2026-01-10
+
+### Improved
+- **More stable session titles** - Titles now stay consistent throughout the session by anchoring on the original task rather than constantly changing based on recent messages (#189)
+  - Original task is used as the PRIMARY anchor for title generation
+  - Recent context only matters if the session focus fundamentally changed
+  - Existing title is preserved unless there's a major direction shift
+
+### Removed
+- **Dead code cleanup** - Removed obsolete marker-based metadata extraction from events.ts (title/description now generated out-of-band via quickQuery)
+
 ## [0.57.0] - 2026-01-10
 
 ### Added

package/dist/index.js

@@ -51857,6 +51857,7 @@ function formatContextBar(percent) {
 async function cancelSession(session, username, ctx) {
   sessionLog2(session).info(`\uD83D\uDED1 Cancelled by @${username}`);
   session.threadLogger?.logCommand("stop", undefined, username);
+  session.isCancelled = true;
   const formatter = session.platform.getFormatter();
   await postCancelled(session, `${formatter.formatBold("Session cancelled")} by ${formatter.formatUserMention(username)}`);
   await ctx.ops.killSession(session.threadId);
@@ -53062,52 +53063,6 @@ var log16 = createLogger("events");
 function sessionLog4(session) {
   return log16.forSession(session.sessionId);
 }
-function extractAndUpdateMetadata(text, session, config, sessionField, ctx) {
-  const regex2 = new RegExp(`\\[${config.marker}:\\s*([^\\]]+)\\]`);
-  const match = text.match(regex2);
-  if (sessionField === "sessionTitle") {
-    const textPreview = text.substring(0, 200).replace(/\n/g, "\\n");
-    log16.forSession(session.sessionId).debug(`Title extraction: match=${match ? `"${match[1]}"` : "null"}, text="${textPreview}${text.length > 200 ? "..." : ""}"`);
-  }
-  if (match) {
-    const newValue = match[1].trim();
-    const isValid = newValue.length >= config.minLength && newValue.length <= config.maxLength && !/^\.+$/.test(newValue) && !/^\u2026+$/.test(newValue) && newValue !== config.placeholder && !newValue.startsWith("...");
-    if (sessionField === "sessionTitle") {
-      log16.forSession(session.sessionId).debug(`Title validation: value="${newValue}", len=${newValue.length}, isValid=${isValid}, current="${session[sessionField]}"`);
-    }
-    if (isValid && newValue !== session[sessionField]) {
-      session[sessionField] = newValue;
-      log16.forSession(session.sessionId).debug(`Setting ${sessionField} to "${newValue}"`);
-      ctx.ops.persistSession(session);
-      ctx.ops.updateStickyMessage().catch((err) => {
-        log16.forSession(session.sessionId).error(`Failed to update sticky message: ${err}`);
-      });
-      ctx.ops.updateSessionHeader(session).catch((err) => {
-        log16.forSession(session.sessionId).error(`Failed to update session header: ${err}`);
-      });
-      const updates = {};
-      if (sessionField === "sessionTitle")
-        updates.title = newValue;
-      if (sessionField === "sessionDescription")
-        updates.description = newValue;
-      ctx.ops.emitSessionUpdate(session.sessionId, updates);
-    }
-  }
-  const removeRegex = new RegExp(`\\[${config.marker}:\\s*[^\\]]+\\]\\s*`, "g");
-  return text.replace(removeRegex, "").trim();
-}
-var TITLE_CONFIG = {
-  marker: "SESSION_TITLE",
-  minLength: 3,
-  maxLength: 50,
-  placeholder: "<short title>"
-};
-var DESCRIPTION_CONFIG = {
-  marker: "SESSION_DESCRIPTION",
-  minLength: 5,
-  maxLength: 100,
-  placeholder: "<brief description>"
-};
 function detectAndExecuteClaudeCommands(text, session, ctx) {
   const parsed = parseClaudeCommand(text);
   if (parsed && isClaudeAllowedCommand(parsed.command)) {
@@ -53235,8 +53190,6 @@ function formatEvent(session, e, ctx) {
       for (const block of msg?.content || []) {
         if (block.type === "text" && block.text) {
           let text = block.text.replace(/<thinking>[\s\S]*?<\/thinking>/g, "").trim();
-          text = extractAndUpdateMetadata(text, session, TITLE_CONFIG, "sessionTitle", ctx);
-          text = extractAndUpdateMetadata(text, session, DESCRIPTION_CONFIG, "sessionDescription", ctx);
           extractAndUpdatePullRequest(text, session, ctx);
           text = detectAndExecuteClaudeCommands(text, session, ctx);
           if (text)
@@ -53993,11 +53946,14 @@ var MIN_TITLE_LENGTH = 3;
 var MAX_TITLE_LENGTH = 50;
 var MIN_DESC_LENGTH = 5;
 var MAX_DESC_LENGTH = 200;
-function buildTitlePrompt(userMessage) {
-  const truncatedMessage = userMessage.length > 500 ? userMessage.substring(0, 500) + "..." : userMessage;
-  return `Generate a session title and description for this task.
+var MAX_ORIGINAL_TASK_LENGTH = 1000;
+var MAX_RECENT_CONTEXT_LENGTH = 500;
+function buildTitlePrompt(context) {
+  if (typeof context === "string") {
+    const truncated = context.length > MAX_ORIGINAL_TASK_LENGTH ? context.substring(0, MAX_ORIGINAL_TASK_LENGTH) + "..." : context;
+    return `Generate a session title and description for this task.
 
-Task: "${truncatedMessage}"
+Task: "${truncated}"
 
 Rules for title:
 - 3-7 words, imperative form (e.g., "Fix login bug", "Add dark mode")
@@ -54008,6 +53964,38 @@ Rules for description:
 - 1-2 sentences, under 100 characters total
 - Explain what will be accomplished
 
+Output format (exactly two lines):
+TITLE: <title here>
+DESC: <description here>`;
+  }
+  const { originalTask, recentContext, currentTitle } = context;
+  const truncatedOriginal = originalTask.length > MAX_ORIGINAL_TASK_LENGTH ? originalTask.substring(0, MAX_ORIGINAL_TASK_LENGTH) + "..." : originalTask;
+  const truncatedRecent = recentContext && recentContext.length > MAX_RECENT_CONTEXT_LENGTH ? recentContext.substring(0, MAX_RECENT_CONTEXT_LENGTH) + "..." : recentContext;
+  let contextSection = `Original task (PRIMARY - base the title on this): "${truncatedOriginal}"`;
+  if (truncatedRecent) {
+    contextSection += `
+
+Recent activity (SECONDARY - only incorporate if the session focus has fundamentally shifted): "${truncatedRecent}"`;
+  }
+  const stabilityInstruction = currentTitle ? `
+
+Current title: "${currentTitle}"
+IMPORTANT: Only suggest a different title if the session focus has FUNDAMENTALLY changed. Minor variations in activity should NOT change the title. Prefer keeping the current title if it still captures the main goal.` : "";
+  return `Generate a session title and description based on the following context.
+${stabilityInstruction}
+
+${contextSection}
+
+Rules for title:
+- 3-7 words, imperative form (e.g., "Fix login bug", "Add dark mode")
+- No quotes or punctuation at end
+- Capture the MAIN intent from the original task
+- Only deviate from original task if recent activity shows a fundamental change in direction
+
+Rules for description:
+- 1-2 sentences, under 100 characters total
+- Explain what will be accomplished
+
 Output format (exactly two lines):
 TITLE: <title here>
 DESC: <description here>`;
@@ -54039,11 +54027,12 @@ function parseMetadata(response) {
   }
   return { title, description };
 }
-async function suggestSessionMetadata(userMessage) {
-  log18.debug(`Suggesting title for: "${userMessage.substring(0, 50)}..."`);
+async function suggestSessionMetadata(context) {
+  const logContext = typeof context === "string" ? context.substring(0, 50) : context.originalTask.substring(0, 50);
+  log18.debug(`Suggesting title for: "${logContext}..."`);
   try {
     const result = await quickQuery({
-      prompt: buildTitlePrompt(userMessage),
+      prompt: buildTitlePrompt(context),
       model: "haiku",
       timeout: SUGGESTION_TIMEOUT2
     });
@@ -54206,12 +54195,17 @@ function firePeriodicReclassification(session, currentMessage, ctx) {
   (async () => {
     try {
       const sessionId = session.sessionId;
-      const contextPrompt = session.firstPrompt ? `Original task: ${session.firstPrompt}
-
-Current message: ${currentMessage}` : currentMessage;
+      const titleContext = session.firstPrompt ? {
+        originalTask: session.firstPrompt,
+        recentContext: currentMessage,
+        currentTitle: session.sessionTitle
+      } : currentMessage;
+      const tagContext = session.firstPrompt ? `Original task: ${session.firstPrompt}
+
+Recent activity: ${currentMessage}` : currentMessage;
       const [metadata, tags] = await Promise.all([
-        suggestSessionMetadata(contextPrompt),
-        suggestSessionTags(contextPrompt)
+        suggestSessionMetadata(titleContext),
+        suggestSessionTags(tagContext)
       ]);
       const currentSession = ctx.state.sessions.get(sessionId);
       if (!currentSession) {
@@ -54220,10 +54214,14 @@ Current message: ${currentMessage}` : currentMessage;
       }
       let updated = false;
       if (metadata) {
-        currentSession.sessionTitle = metadata.title;
-        currentSession.sessionDescription = metadata.description;
-        sessionLog6(currentSession).debug(`Updated title: "${metadata.title}"`);
-        updated = true;
+        if (metadata.title !== currentSession.sessionTitle) {
+          currentSession.sessionTitle = metadata.title;
+          currentSession.sessionDescription = metadata.description;
+          sessionLog6(currentSession).debug(`Updated title: "${metadata.title}"`);
+          updated = true;
+        } else {
+          sessionLog6(currentSession).debug("Title unchanged (stable)");
+        }
       }
       if (tags.length > 0) {
         currentSession.sessionTags = tags;
@@ -54372,6 +54370,7 @@ ${CHAT_PLATFORM_PROMPT}`;
     subagentUpdateTimer: null,
     timeoutWarningPosted: false,
     isRestarting: false,
+    isCancelled: false,
     isResumed: false,
     resumeFailCount: 0,
     wasInterrupted: false,
@@ -54524,6 +54523,7 @@ ${CHAT_PLATFORM_PROMPT}`;
     subagentUpdateTimer: null,
     timeoutWarningPosted: false,
     isRestarting: false,
+    isCancelled: false,
     isResumed: true,
     resumeFailCount: state.resumeFailCount ?? 0,
     wasInterrupted: false,
@@ -54660,6 +54660,10 @@ async function handleExit(sessionId, code, ctx) {
     session.isRestarting = false;
     return;
   }
+  if (session.isCancelled) {
+    sessionLog6(session).debug(`Cancelled, skipping cleanup (handled by killSession)`);
+    return;
+  }
   if (ctx.state.isShuttingDown) {
     sessionLog6(session).debug(`Bot shutting down, preserving persistence`);
     ctx.ops.stopTyping(session);

package/package.json

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