@mindstudio-ai/remy 0.1.306 → 0.1.308

package/dist/headless.js

@@ -3009,7 +3009,7 @@ var runScenarioTool = {
 var runMethodTool = {
   definition: {
     name: "runMethod",
-    description: 'Run a method in the dev environment and return the result. Use for testing methods after writing or modifying them. Returns output, captured console output, errors with stack traces, and duration. If it fails, check .logs/tunnel.log or .logs/requests.ndjson for more details. Returns synchronously \u2014 no need to sleep before checking results.\n\nBy default methods run unauthenticated. If the method is auth-gated (calls `auth.requireRole()`, filters on `auth.userId`, etc.), pass `userId: "testUser"` to run as the default test user \u2014 no scenario setup required, no userId lookup.',
+    description: 'Run a method in the dev environment and return the result. Use for testing methods after writing or modifying them. Returns output, captured console output, errors with stack traces, and duration. If it fails, check .logs/tunnel.log or .logs/requests.ndjson for more details. Returns synchronously \u2014 no need to sleep before checking results.\n\nBy default methods run unauthenticated. If the method is auth-gated (calls `auth.requireRole()`, filters on `auth.userId`, etc.), pass `userId: "testUser"` to run as the default test user \u2014 no scenario setup required, no userId lookup. For a method gated on `auth.requireRole("system")` \u2014 cron, webhook, and email work \u2014 pass `roles: ["system"]`; that works whether or not the app has auth.',
     inputSchema: {
       type: "object",
       properties: {
@@ -3028,7 +3028,7 @@ var runMethodTool = {
         roles: {
           type: "array",
           items: { type: "string" },
-          description: 'Optional. Role names for this request (e.g. ["admin"]). For auth-enabled apps, roles without a userId run as the dev test user holding exactly these roles \u2014 a real user row, so `auth.userId` and `requireRole` behave like production. For apps without auth, roles attach to an anonymous call. Applies to this call only.'
+          description: 'Optional. Role names for this request (e.g. ["admin"]). Roles without a userId bind to the dev test user holding exactly these roles \u2014 a real user row, so `auth.userId` and `requireRole` behave like production. `["system"]` is the exception and needs no user: it runs as the platform system identity, the same one cron, webhook, and email invocations get, so a system-gated method is testable in an app with no auth configured. Any other role requires an `auth` block in mindstudio.json \u2014 without one the app has no users to hold a role, and the call is rejected saying so. Applies to this call only.'
         }
       },
       required: ["method"]
@@ -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

@@ -4200,7 +4200,7 @@ var init_runMethod = __esm({
     runMethodTool = {
       definition: {
         name: "runMethod",
-        description: 'Run a method in the dev environment and return the result. Use for testing methods after writing or modifying them. Returns output, captured console output, errors with stack traces, and duration. If it fails, check .logs/tunnel.log or .logs/requests.ndjson for more details. Returns synchronously \u2014 no need to sleep before checking results.\n\nBy default methods run unauthenticated. If the method is auth-gated (calls `auth.requireRole()`, filters on `auth.userId`, etc.), pass `userId: "testUser"` to run as the default test user \u2014 no scenario setup required, no userId lookup.',
+        description: 'Run a method in the dev environment and return the result. Use for testing methods after writing or modifying them. Returns output, captured console output, errors with stack traces, and duration. If it fails, check .logs/tunnel.log or .logs/requests.ndjson for more details. Returns synchronously \u2014 no need to sleep before checking results.\n\nBy default methods run unauthenticated. If the method is auth-gated (calls `auth.requireRole()`, filters on `auth.userId`, etc.), pass `userId: "testUser"` to run as the default test user \u2014 no scenario setup required, no userId lookup. For a method gated on `auth.requireRole("system")` \u2014 cron, webhook, and email work \u2014 pass `roles: ["system"]`; that works whether or not the app has auth.',
         inputSchema: {
           type: "object",
           properties: {
@@ -4219,7 +4219,7 @@ var init_runMethod = __esm({
             roles: {
               type: "array",
               items: { type: "string" },
-              description: 'Optional. Role names for this request (e.g. ["admin"]). For auth-enabled apps, roles without a userId run as the dev test user holding exactly these roles \u2014 a real user row, so `auth.userId` and `requireRole` behave like production. For apps without auth, roles attach to an anonymous call. Applies to this call only.'
+              description: 'Optional. Role names for this request (e.g. ["admin"]). Roles without a userId bind to the dev test user holding exactly these roles \u2014 a real user row, so `auth.userId` and `requireRole` behave like production. `["system"]` is the exception and needs no user: it runs as the platform system identity, the same one cron, webhook, and email invocations get, so a system-gated method is testable in an app with no auth configured. Any other role requires an `auth` block in mindstudio.json \u2014 without one the app has no users to hold a role, and the call is rejected saying so. Applies to this call only.'
             }
           },
           required: ["method"]
@@ -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/skills/agentInterfaces.md

@@ -14,7 +14,7 @@ Guidance for designing conversational AI agents and their frontends. An agent in
 
 A good system prompt establishes who the agent is — personality, tone, judgment style, the kind of person they sound like. It doesn't enumerate every possible interaction or restate what tools already describe.
 
-Short and opinionated beats long and comprehensive. "Sounds like a sharp, organized friend — brief by default" gives the model more to work with than a page of behavioral rules. Define constraints through character, not checklists. Let the model's judgment work.
+Short and opinionated beats long and comprehensive. "Sounds like a sharp, organized friend — brief by default" gives the model more to work with than a page of behavioral rules. Define constraints through character, not checklists. Let the model's judgment work. Start minimal and add rules only for behaviors that actually misfire once the user has tested it — the thread log is the feedback loop, and `remy-admin agent threads get` reads a conversation verbatim (see "The agent CLI" below).
 
 Three things every compiled system prompt should carry, on top of the character:
 
@@ -213,7 +213,7 @@ When the user sends a message, add it to the conversation immediately — don't
 
 ### Tool calls
 
-Show tool activity in the chat as a compact, inline status that appears when `onToolCallStart` fires and resolves when `onToolCallResult` arrives. Never show raw JSON, tool IDs, or internal details — just a human-readable description of what's happening.
+Show tool activity in the chat as a compact, inline status that appears when `onToolCallStart` fires and resolves when `onToolCallResult` arrives. Never show raw JSON, tool IDs, or internal details — just a human-readable description of what's happening. Tool calls should be interleaved into the conversation so they flow naturally as part of the agent's response.
 
 ### Input area
 
@@ -236,6 +236,21 @@ The chat UI uses the app's design system — colors, typography, voice from `@br
 - Avoid designs that look like dated messaging apps from 2015
 - Avoid robotic empty states ("Hello! I'm your AI assistant. How can I help you today?")
 
+## The agent CLI
+
+The `remy-admin agent` family is the conversation log — every thread the deployed agent has had, and each one's full transcript:
+
+```bash
+remy-admin agent threads list --limit 10   # newest activity first
+remy-admin agent threads get <threadId>    # full transcript: messages + tool calls
+```
+
+Transcripts are how you iterate on an agent: after the user tests it, read `agent threads get` for what was actually said and which tools ran with which arguments — a tool the agent never reached for, one it called with the wrong shape, a reply that ignored the result — and fix the system prompt and tool descriptions from that evidence rather than guesses.
+
+In the list, `toolErrorCount` and `hasTurnError` point at the conversations worth opening (a failed tool call; a turn that broke on a model error, rate limit, or credits instead of replying). `devSession` is true for your own test conversations through the dev tunnel, so you can tell them from real traffic.
+
+In a transcript, each message keeps the stored conversation's own shape: `user` for a person's message and also for a tool result (which carries `toolCallId`), `assistant` for the agent (carrying `toolCalls` when it asked for tools). Every method tool call also carries a `requestId` — `remy-admin requests get <requestId>` opens that call's input, output, `console.log` output and error, which is how you get from "the agent said something wrong" to the method that gave it bad data. Client tools run in the browser, so they have no requestId.
+
 ---
 
 # The wiring

package/dist/prompt/skills/auth.md

@@ -317,6 +317,8 @@ export async function regenerateCache(input: {}) {
 
 Web frontend calls (`/_/methods`), API interface calls (`/_/api`), and agent chat all run as the authenticated user — they don't get the system role unless the user has been explicitly assigned it. You can assign `system` to app users via the dashboard or SDK if they need to manually trigger these methods.
 
+The system role is a platform-minted identity, not a row in the app's users table, so it does not require auth. A cron-only app with no login and no user table can gate a method on `requireRole('system')` and it works. To exercise one in dev, run it with `roles: ["system"]` — `runMethod` gives it the same identity a real platform trigger gets, so the gate stays in place while you test.
+
 ## Login Page Example
 
 ```tsx
@@ -461,7 +463,7 @@ Auth works the same in dev/preview as in production — real verification codes
 
 All other emails and phone numbers receive real codes. There is no dev-mode bypass, no fake code, and no way to skip verification. When testing auth flows in the preview, use one of the test bypasses above or a real email/phone. (These dev bypasses work in dev sessions only and exist for you — they're distinct from *test accounts*, the platform setting for giving external reviewers a fixed-code login that works in production; see *Restricting Who Can Sign Up*.)
 
-This test account is the dev's standing identity: the preview's sign-in helper auto-fills it, the editor's Roles column edits its roles, and a scenario's `roles` field assigns roles to it after seeding. The `runMethod` tool's `userId: "testUser"` shortcut resolves to this same dev-bypass identity (as does `roles` without a `userId`). The platform find-or-creates a real users-table row for it on first call and caches the row's UUID for the rest of the dev session. **`auth.userId` inside the method is that UUID — not the literal string `"testUser"`.** The user row already exists, so don't try to insert it. If you need the UUID to seed app-specific rows that reference it (profiles, preferences, foreign keys), read it from any method response or query the users table directly: `SELECT id FROM users WHERE email = 'remy@mindstudio.ai'` (or `phone = '+15555555555'` for SMS-auth apps).
+This test account is the dev's standing identity: the preview's sign-in helper auto-fills it, the editor's Roles column edits its roles, and a scenario's `roles` field assigns roles to it after seeding. The `runMethod` tool's `userId: "testUser"` shortcut resolves to this same dev-bypass identity, as does `roles` without a `userId` (except `roles: ["system"]`, which is platform-minted and needs no user row — see *System Role*). The platform find-or-creates a real users-table row for it on first call and caches the row's UUID for the rest of the dev session. **`auth.userId` inside the method is that UUID — not the literal string `"testUser"`.** The user row already exists, so don't try to insert it. If you need the UUID to seed app-specific rows that reference it (profiles, preferences, foreign keys), read it from any method response or query the users table directly: `SELECT id FROM users WHERE email = 'remy@mindstudio.ai'` (or `phone = '+15555555555'` for SMS-auth apps).
 
 For **"Sign in with Remy"** apps (`auth.methods` is `["remy"]`, with no `email-code`/`sms-code`), `testUser` — and `setupBrowser`, and the editor's Roles column — resolve to **the developer's own delegated Remy identity**, not the `remy@mindstudio.ai` code-bypass user. `auth.userId` is still that user's real UUID, but the `remy@mindstudio.ai` email lookup above does not apply — read the UUID from a method response instead.
 

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.306",
+  "version": "0.1.308",
   "description": "Remy coding agent",
   "repository": {
     "type": "git",