@mindstudio-ai/remy 0.1.307 → 0.1.308

package/dist/headless.js

@@ -8444,6 +8444,155 @@ function friendlyError(raw) {
   return `Something went wrong: ${raw}`;
 }
 
+// src/suggestions.ts
+var SUGGEST_MARKER = "](suggest:";
+var SEPARATORS = "\\s\xB7|,\\-\u2013\u2014";
+var SEPARATORS_ONLY = new RegExp(`^[${SEPARATORS}]*$`);
+var TRAILING_SEPARATORS = new RegExp(`[${SEPARATORS}]+$`);
+var LIST_MARKER = /^\s*(?:[-*+]|\d+[.)])\s+/;
+var FENCE = /^ {0,3}(?:```|~~~)/;
+function findLinks(line) {
+  const found = [];
+  let i = 0;
+  while (i < line.length) {
+    const ch = line[i];
+    if (ch === "\\") {
+      i += 2;
+      continue;
+    }
+    if (ch === "`") {
+      let runEnd = i;
+      while (runEnd < line.length && line[runEnd] === "`") {
+        runEnd++;
+      }
+      const fence = line.slice(i, runEnd);
+      const close = line.indexOf(fence, runEnd);
+      if (close === -1) {
+        break;
+      }
+      i = close + fence.length;
+      continue;
+    }
+    if (ch !== "[") {
+      i++;
+      continue;
+    }
+    const labelEnd = line.indexOf("]", i + 1);
+    if (labelEnd === -1) {
+      break;
+    }
+    if (!line.startsWith(SUGGEST_MARKER, labelEnd)) {
+      i = labelEnd + 1;
+      continue;
+    }
+    let depth = 1;
+    let p = labelEnd + SUGGEST_MARKER.length;
+    while (p < line.length && depth > 0) {
+      if (line[p] === "(") {
+        depth++;
+      } else if (line[p] === ")") {
+        depth--;
+      }
+      p++;
+    }
+    if (depth > 0) {
+      break;
+    }
+    found.push({
+      start: i,
+      end: p,
+      label: line.slice(i + 1, labelEnd).trim(),
+      message: line.slice(labelEnd + SUGGEST_MARKER.length, p - 1).trim(),
+      standalone: false
+    });
+    i = p;
+  }
+  return found;
+}
+function classify(line, matches) {
+  let tailClean = SEPARATORS_ONLY.test(
+    line.slice(matches[matches.length - 1].end)
+  );
+  for (let i = matches.length - 1; i >= 0; i--) {
+    matches[i].standalone = tailClean;
+    if (!tailClean) {
+      continue;
+    }
+    const gap = i > 0 ? line.slice(matches[i - 1].end, matches[i].start) : "";
+    tailClean = SEPARATORS_ONLY.test(gap);
+  }
+}
+function parseSuggestions(raw) {
+  if (!raw.includes(SUGGEST_MARKER)) {
+    return { text: raw, suggestions: [] };
+  }
+  const suggestions = [];
+  const seen = /* @__PURE__ */ new Set();
+  const outLines = [];
+  let inFence = false;
+  let droppedLine = false;
+  for (const line of raw.split("\n")) {
+    if (FENCE.test(line)) {
+      inFence = !inFence;
+      outLines.push(line);
+      continue;
+    }
+    if (inFence) {
+      outLines.push(line);
+      continue;
+    }
+    const matches = findLinks(line);
+    if (matches.length === 0) {
+      outLines.push(line);
+      continue;
+    }
+    classify(line, matches);
+    for (const m of matches) {
+      const key = `${m.label}::${m.message}`;
+      if (!seen.has(key)) {
+        seen.add(key);
+        suggestions.push({ label: m.label, message: m.message });
+      }
+    }
+    let rebuilt = "";
+    let cursor = 0;
+    for (const m of matches) {
+      rebuilt += line.slice(cursor, m.start);
+      if (!m.standalone) {
+        rebuilt += m.label;
+      }
+      cursor = m.end;
+    }
+    rebuilt += line.slice(cursor);
+    if (matches.some((m) => m.standalone)) {
+      if (SEPARATORS_ONLY.test(rebuilt.replace(LIST_MARKER, ""))) {
+        droppedLine = true;
+        continue;
+      }
+      rebuilt = rebuilt.replace(TRAILING_SEPARATORS, "");
+    }
+    outLines.push(rebuilt);
+  }
+  let text = outLines.join("\n").replace(/\s+$/, "");
+  if (droppedLine) {
+    text = text.replace(/\n{3,}/g, "\n\n");
+  }
+  return { text, suggestions };
+}
+function annotateSuggestions(blocks) {
+  for (const block of blocks) {
+    if (block.type !== "text" || !block.text.includes(SUGGEST_MARKER)) {
+      continue;
+    }
+    const { text, suggestions } = parseSuggestions(block.text);
+    if (suggestions.length === 0) {
+      continue;
+    }
+    block.displayText = text;
+    block.suggestions = suggestions;
+  }
+}
+
 // src/agent.ts
 var log15 = createLogger("agent");
 var BRAND_TRIGGERING_TOOLS = /* @__PURE__ */ new Set([
@@ -8638,8 +8787,27 @@ async function runTurn(params) {
           toolInputAccumulators.set(id, acc);
         }
         return acc;
+      }, emitTextBlockSnapshot2 = function(closing) {
+        let block;
+        for (let i = contentBlocks.length - 1; i >= 0; i--) {
+          const candidate = contentBlocks[i];
+          if (candidate.type === "text") {
+            block = candidate;
+            break;
+          }
+        }
+        if (!block || !block.text.includes(SUGGEST_MARKER)) {
+          return;
+        }
+        const { text, suggestions } = parseSuggestions(block.text);
+        const worthSending = closing ? suggestions.length > 0 : suggestions.length > emittedSuggestionCount;
+        if (!worthSending) {
+          return;
+        }
+        emittedSuggestionCount = suggestions.length;
+        onEvent({ type: "text_block", text, suggestions });
       };
-      var getOrCreateAccumulator = getOrCreateAccumulator2;
+      var getOrCreateAccumulator = getOrCreateAccumulator2, emitTextBlockSnapshot = emitTextBlockSnapshot2;
       if (signal?.aborted) {
         onEvent({ type: "turn_cancelled" });
         saveSession(state);
@@ -8651,6 +8819,7 @@ async function runTurn(params) {
       let thinkingCompleteCount = 0;
       let lastThinkingRelatedStartedAt;
       let textBlockOpen = false;
+      let emittedSuggestionCount = 0;
       const toolInputAccumulators = /* @__PURE__ */ new Map();
       let stopReason = "end_turn";
       let turnProviderMetadata;
@@ -8739,14 +8908,19 @@ async function runTurn(params) {
                   text: event.text,
                   startedAt: event.ts
                 });
+                emittedSuggestionCount = 0;
               }
               textBlockOpen = true;
               onEvent({ type: "text", text: event.text });
+              emitTextBlockSnapshot2(false);
               break;
             }
             case "thinking":
               if (event.text === "") {
                 thinkingBlockStartTimes.push(event.ts);
+                if (textBlockOpen) {
+                  emitTextBlockSnapshot2(true);
+                }
                 textBlockOpen = false;
               }
               onEvent({ type: "thinking", text: event.text });
@@ -8872,6 +9046,11 @@ async function runTurn(params) {
           throw err;
         }
       }
+      if (textBlockOpen) {
+        emitTextBlockSnapshot2(true);
+        textBlockOpen = false;
+      }
+      annotateSuggestions(contentBlocks);
       if (signal?.aborted) {
         statusWatcher.stop();
         if (contentBlocks.length > 0) {
@@ -10002,6 +10181,13 @@ var HeadlessSession = class {
           rid
         );
         return;
+      case "text_block":
+        this.emit(
+          "text_block",
+          { text: e.text, suggestions: e.suggestions },
+          rid
+        );
+        return;
       case "thinking":
         this.emit(
           "thinking",

package/dist/index.js

@@ -8752,6 +8752,161 @@ var init_errors = __esm({
   }
 });
 
+// src/suggestions.ts
+function findLinks(line) {
+  const found = [];
+  let i = 0;
+  while (i < line.length) {
+    const ch = line[i];
+    if (ch === "\\") {
+      i += 2;
+      continue;
+    }
+    if (ch === "`") {
+      let runEnd = i;
+      while (runEnd < line.length && line[runEnd] === "`") {
+        runEnd++;
+      }
+      const fence = line.slice(i, runEnd);
+      const close = line.indexOf(fence, runEnd);
+      if (close === -1) {
+        break;
+      }
+      i = close + fence.length;
+      continue;
+    }
+    if (ch !== "[") {
+      i++;
+      continue;
+    }
+    const labelEnd = line.indexOf("]", i + 1);
+    if (labelEnd === -1) {
+      break;
+    }
+    if (!line.startsWith(SUGGEST_MARKER, labelEnd)) {
+      i = labelEnd + 1;
+      continue;
+    }
+    let depth = 1;
+    let p = labelEnd + SUGGEST_MARKER.length;
+    while (p < line.length && depth > 0) {
+      if (line[p] === "(") {
+        depth++;
+      } else if (line[p] === ")") {
+        depth--;
+      }
+      p++;
+    }
+    if (depth > 0) {
+      break;
+    }
+    found.push({
+      start: i,
+      end: p,
+      label: line.slice(i + 1, labelEnd).trim(),
+      message: line.slice(labelEnd + SUGGEST_MARKER.length, p - 1).trim(),
+      standalone: false
+    });
+    i = p;
+  }
+  return found;
+}
+function classify(line, matches) {
+  let tailClean = SEPARATORS_ONLY.test(
+    line.slice(matches[matches.length - 1].end)
+  );
+  for (let i = matches.length - 1; i >= 0; i--) {
+    matches[i].standalone = tailClean;
+    if (!tailClean) {
+      continue;
+    }
+    const gap = i > 0 ? line.slice(matches[i - 1].end, matches[i].start) : "";
+    tailClean = SEPARATORS_ONLY.test(gap);
+  }
+}
+function parseSuggestions(raw) {
+  if (!raw.includes(SUGGEST_MARKER)) {
+    return { text: raw, suggestions: [] };
+  }
+  const suggestions = [];
+  const seen = /* @__PURE__ */ new Set();
+  const outLines = [];
+  let inFence = false;
+  let droppedLine = false;
+  for (const line of raw.split("\n")) {
+    if (FENCE.test(line)) {
+      inFence = !inFence;
+      outLines.push(line);
+      continue;
+    }
+    if (inFence) {
+      outLines.push(line);
+      continue;
+    }
+    const matches = findLinks(line);
+    if (matches.length === 0) {
+      outLines.push(line);
+      continue;
+    }
+    classify(line, matches);
+    for (const m of matches) {
+      const key = `${m.label}::${m.message}`;
+      if (!seen.has(key)) {
+        seen.add(key);
+        suggestions.push({ label: m.label, message: m.message });
+      }
+    }
+    let rebuilt = "";
+    let cursor = 0;
+    for (const m of matches) {
+      rebuilt += line.slice(cursor, m.start);
+      if (!m.standalone) {
+        rebuilt += m.label;
+      }
+      cursor = m.end;
+    }
+    rebuilt += line.slice(cursor);
+    if (matches.some((m) => m.standalone)) {
+      if (SEPARATORS_ONLY.test(rebuilt.replace(LIST_MARKER, ""))) {
+        droppedLine = true;
+        continue;
+      }
+      rebuilt = rebuilt.replace(TRAILING_SEPARATORS, "");
+    }
+    outLines.push(rebuilt);
+  }
+  let text = outLines.join("\n").replace(/\s+$/, "");
+  if (droppedLine) {
+    text = text.replace(/\n{3,}/g, "\n\n");
+  }
+  return { text, suggestions };
+}
+function annotateSuggestions(blocks) {
+  for (const block of blocks) {
+    if (block.type !== "text" || !block.text.includes(SUGGEST_MARKER)) {
+      continue;
+    }
+    const { text, suggestions } = parseSuggestions(block.text);
+    if (suggestions.length === 0) {
+      continue;
+    }
+    block.displayText = text;
+    block.suggestions = suggestions;
+  }
+}
+var SUGGEST_MARKER, SEPARATORS, SEPARATORS_ONLY, TRAILING_SEPARATORS, LIST_MARKER, FENCE;
+var init_suggestions = __esm({
+  "src/suggestions.ts"() {
+    "use strict";
+    SUGGEST_MARKER = "](suggest:";
+    SEPARATORS = "\\s\xB7|,\\-\u2013\u2014";
+    SEPARATORS_ONLY = new RegExp(`^[${SEPARATORS}]*$`);
+    TRAILING_SEPARATORS = new RegExp(`[${SEPARATORS}]+$`);
+    LIST_MARKER = /^\s*(?:[-*+]|\d+[.)])\s+/;
+    FENCE = /^ {0,3}(?:```|~~~)/;
+  }
+});
+
 // src/brandExtraction/index.ts
 import fs20 from "fs";
 import path11 from "path";
@@ -9285,8 +9440,27 @@ async function runTurn(params) {
           toolInputAccumulators.set(id, acc);
         }
         return acc;
+      }, emitTextBlockSnapshot2 = function(closing) {
+        let block;
+        for (let i = contentBlocks.length - 1; i >= 0; i--) {
+          const candidate = contentBlocks[i];
+          if (candidate.type === "text") {
+            block = candidate;
+            break;
+          }
+        }
+        if (!block || !block.text.includes(SUGGEST_MARKER)) {
+          return;
+        }
+        const { text, suggestions } = parseSuggestions(block.text);
+        const worthSending = closing ? suggestions.length > 0 : suggestions.length > emittedSuggestionCount;
+        if (!worthSending) {
+          return;
+        }
+        emittedSuggestionCount = suggestions.length;
+        onEvent({ type: "text_block", text, suggestions });
       };
-      var getOrCreateAccumulator = getOrCreateAccumulator2;
+      var getOrCreateAccumulator = getOrCreateAccumulator2, emitTextBlockSnapshot = emitTextBlockSnapshot2;
       if (signal?.aborted) {
         onEvent({ type: "turn_cancelled" });
         saveSession(state);
@@ -9298,6 +9472,7 @@ async function runTurn(params) {
       let thinkingCompleteCount = 0;
       let lastThinkingRelatedStartedAt;
       let textBlockOpen = false;
+      let emittedSuggestionCount = 0;
       const toolInputAccumulators = /* @__PURE__ */ new Map();
       let stopReason = "end_turn";
       let turnProviderMetadata;
@@ -9386,14 +9561,19 @@ async function runTurn(params) {
                   text: event.text,
                   startedAt: event.ts
                 });
+                emittedSuggestionCount = 0;
               }
               textBlockOpen = true;
               onEvent({ type: "text", text: event.text });
+              emitTextBlockSnapshot2(false);
               break;
             }
             case "thinking":
               if (event.text === "") {
                 thinkingBlockStartTimes.push(event.ts);
+                if (textBlockOpen) {
+                  emitTextBlockSnapshot2(true);
+                }
                 textBlockOpen = false;
               }
               onEvent({ type: "thinking", text: event.text });
@@ -9519,6 +9699,11 @@ async function runTurn(params) {
           throw err;
         }
       }
+      if (textBlockOpen) {
+        emitTextBlockSnapshot2(true);
+        textBlockOpen = false;
+      }
+      annotateSuggestions(contentBlocks);
       if (signal?.aborted) {
         statusWatcher.stop();
         if (contentBlocks.length > 0) {
@@ -9802,6 +9987,7 @@ var init_agent = __esm({
     init_resolve();
     init_errors();
     init_cleanMessages();
+    init_suggestions();
     init_sentinel();
     init_trigger2();
     init_surfaces();
@@ -10992,6 +11178,13 @@ var init_headless = __esm({
               rid
             );
             return;
+          case "text_block":
+            this.emit(
+              "text_block",
+              { text: e.text, suggestions: e.suggestions },
+              rid
+            );
+            return;
           case "thinking":
             this.emit(
               "thinking",

package/dist/prompt/static/instructions.md

@@ -38,7 +38,7 @@ You will occasionally receive automated messages prefixed with `@@automated_mess
 
 ## Style
 - Your messages are rendered as markdown. Use formatting (headers, bold, lists, code blocks) when it helps readability. You can include images using `![alt](url)` — use this to show the user screenshots, generated images, or other visual references inline in your messages.
-- When offering suggestions or options the user might want to quickly select in a conversation, format them as clickable suggestion links: `[label](suggest:message sent on click)`. The label renders as a tappable chip and should be a few words — chip-sized, not sentence-sized. The `suggest:` payload can be longer; that's what gets sent as the user's next message when clicked. Use these liberally: when brainstorming, offering directions, listing options, or any time you're asking a question the user could answer with a quick tap. When explicitly gathering information from the user, however, always use the `promptUser` tool instead.
+- When offering suggestions or options the user might want to quickly select in a conversation, format them as clickable suggestion links: `[label](suggest:message sent on click)`. The label renders as a tappable chip and should be a few words — chip-sized, not sentence-sized. The `suggest:` payload can be longer; that's what gets sent as the user's next message when clicked. A run of links on its own line, or at the end of a line, is lifted out of your message and rendered as chips beneath it; a link written mid-sentence keeps its label in the sentence and offers the chip as well. Use these liberally: when brainstorming, offering directions, listing options, or any time you're asking a question the user could answer with a quick tap. When explicitly gathering information from the user, however, always use the `promptUser` tool instead.
 - When pointing the user to a specific page in their running app, format the link as `[label](preview:/path)` — clicking it navigates the live preview there. The payload is a path-relative URL (just `/...`, with optional query/hash); for external URLs, use a plain markdown link.
 - Keep language accessible. Describe what the app *does*, not how it's implemented, unless the user demonstrates technical fluency.
 - Always use full paths relative to the project root when mentioning files (`dist/interfaces/web/src/App.tsx`, not `App.tsx`). Paths will be rendered as clickable links for the user.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mindstudio-ai/remy",
-  "version": "0.1.307",
+  "version": "0.1.308",
   "description": "Remy coding agent",
   "repository": {
     "type": "git",