@codeagentswarm/cas-cloud 0.0.12 → 0.0.16

package/dist/antigravity-mcp-launcher.js

@@ -3809,6 +3809,18 @@ var require_mcp_stdio_server = __commonJS({
         } catch (e) {
         }
       }
+      _hasNudgeMarker(kind) {
+        try {
+          const os3 = require("os");
+          const fs3 = require("fs");
+          const stateDir = path2.join(os3.homedir(), ".codeagentswarm", "terminal-nudge-state");
+          const rawKey = process.env.CODEAGENTSWARM_TERMINAL_ID || process.env.CODEAGENTSWARM_CURRENT_QUADRANT;
+          const key = String(rawKey || "").replace(/[^A-Za-z0-9_-]/g, "_");
+          return !!key && fs3.existsSync(path2.join(stateDir, `${key}.${kind}`));
+        } catch (e) {
+          return false;
+        }
+      }
       // Resolve the current terminal id (1-based) from the environment.
       _getCurrentTerminalId() {
         const terminalId = process.env.CODEAGENTSWARM_CURRENT_QUADRANT;
@@ -3827,20 +3839,30 @@ var require_mcp_stdio_server = __commonJS({
       }
       // Set the GENERAL terminal title: the sticky tab label that represents the
       // product-level goal of what this terminal is working on. Set it ONCE at the
-      // start of work; call it again only to refine when the overall functionality
-      // changes, or to replace it when the terminal pivots to a radically different
-      // topic. It does NOT represent the current step — use update_terminal_activity
-      // for that.
+      // start of the conversation. Later calls preserve it unless the caller explicitly
+      // declares a radical topic change. It does NOT represent the current step — use
+      // update_terminal_activity for that.
       async setTerminalTitle(params) {
-        const { title, long_title } = params;
+        const { title, long_title, replace_existing } = params;
         if (!title) {
           throw new Error("title is required");
         }
         if (isPlaceholderTitle(title)) {
           throw new Error(`"${title}" looks like example text copied from the tool documentation, not a real title. Call the tool again with a title that describes the ACTUAL feature or goal you are working on in this agent (max 6 words).`);
         }
-        const shortTitle = this.generateShortTitle(title);
+        if (replace_existing !== void 0 && typeof replace_existing !== "boolean") {
+          throw new Error("replace_existing must be a boolean");
+        }
         const terminalId = this._getCurrentTerminalId();
+        if (replace_existing !== true && this._hasNudgeMarker("title")) {
+          return {
+            terminal_id: terminalId,
+            updated: false,
+            preserved: true,
+            message: "The existing conversation title was preserved. Use update_terminal_activity for follow-up work; set replace_existing=true only after the user pivots to a completely different functionality."
+          };
+        }
+        const shortTitle = this.generateShortTitle(title);
         const currentTask = this._getCurrentTask(terminalId);
         const taskId = currentTask ? currentTask.id : null;
         let longTitle = long_title;
@@ -4738,7 +4760,7 @@ Use 'clear' to remove the status.`;
           },
           {
             name: "set_terminal_title",
-            description: 'Set the GENERAL agent title AND the agent GOAL \u2014 pass BOTH arguments, because the user sees them together. `title` is the sticky Agent tab label at the FEATURE level (e.g. "Promo video for Twitter", "Minimize agents"); `long_title` is one sentence on what this agent is FOR, shown in the hover under the title. Keep the title high-level: name the feature, not a low-level step or work phase. Set it once at the start, then only refine it when the overall goal changes. Use update_terminal_activity for the current step. LANGUAGE: write BOTH in the SAME language the user is speaking.',
+            description: "Set the GENERAL agent title AND the agent GOAL from the first user request that established this conversation's topic. Pass BOTH text arguments because the user sees them together. This is once per conversation, NOT once per user message, turn, task, review, validation, or resumed session. Follow-up work belongs in update_terminal_activity and repeated calls preserve the original title. Only a user pivot to a completely different functionality may replace it, by passing replace_existing=true. LANGUAGE: write both text fields in the SAME language the user is speaking.",
             inputSchema: {
               type: "object",
               properties: {
@@ -4749,6 +4771,10 @@ Use 'clear' to remove the status.`;
                 long_title: {
                   type: "string",
                   description: `The agent GOAL: one sentence saying what this agent is FOR \u2014 the outcome the work is aiming at, not the current step. ALWAYS provide it: the user reads it in the Agent hover, labelled GOAL, under the short title. Write the real goal in the user's language. Do NOT restate the title or prefix it with "Working on:".`
+                },
+                replace_existing: {
+                  type: "boolean",
+                  description: "Leave false or omit for normal follow-up work. Set true ONLY when the user explicitly pivots this existing conversation to a completely different functionality; reviews, tests, fixes, implementation phases, and refinements of the original request are activities and must not replace the title."
                 }
               },
               // long_title is NOT in `required` on purpose: some agent clients
@@ -5202,7 +5228,8 @@ Use 'clear' to remove the status.`;
           case "set_terminal_title":
             result = await this.setTerminalTitle({
               title: args.title,
-              long_title: args.long_title
+              long_title: args.long_title,
+              replace_existing: args.replace_existing
             });
             break;
           case "update_terminal_activity":