@mindstudio-ai/remy 0.1.244 → 0.1.246

package/dist/headless.d.ts

@@ -19,7 +19,10 @@
  * page size (default 500, hard cap 2000). Response: {event:"history",
  * messages, startIndex, endIndex, totalMessageCount, ...}. Walk backward by
  * passing the previous response's `startIndex` as the next `before`. When
- * `startIndex === 0`, no older messages remain.
+ * `startIndex === 0`, no older messages remain. Indices are GLOBAL — they span
+ * the sealed session archives followed by the live tail (see getHistoryPage in
+ * session.ts), so scrollback continues past a rotation to the conversation
+ * start, not just to the start of the live (post-rotation) array.
  */
 interface HeadlessOptions {
     apiKey?: string;

package/dist/headless.js

@@ -1881,11 +1881,11 @@ var setProjectMetadataTool = {
         },
         iconUrl: {
           type: "string",
-          description: "URL for the app icon (square."
+          description: "URL for the app icon (square)."
         },
         openGraphShareImageUrl: {
           type: "string",
-          description: "URL for the Open Graph share image (1200x630)."
+          description: "URL for the Open Graph share image (1200\xD7630 PNG)."
         }
       }
     }
@@ -2819,9 +2819,7 @@ async function analyzeImage(params) {
 
 // src/tools/_helpers/screenshot.ts
 var SCREENSHOT_ANALYSIS_PROMPT = `Describe everything visible on screen from top to bottom \u2014 every element, its position, its size relative to the viewport, its colors, its content. Be comprehensive, thorough, and spatial. After the inventory, note anything that looks visually broken (overlapping elements, clipped text, misaligned components).`;
-var TEXT_WRAP_DISCLAIMER = `Note: ignore text wrapping issues. Screenshots occasionally show text wrapping onto an extra line compared to the live page \u2014 most noticeable in buttons, badges, and headings. This is a known limitation of SVG foreignObject rendering used the DOM-to-image capture library that took the screenshot. The browser's SVG renderer computes slightly wider text metrics than the HTML layout engine, so text that fits on one line in the live DOM can overflow by a fraction of a pixel in the capture - this is not a real issue.
-
-Respond only with your analysis as Markdown and absolutely no other text. Do not use emojis - use unicode if you need symbols.`;
+var ANALYSIS_RESPONSE_FORMAT = `Respond only with your analysis as Markdown and absolutely no other text. Do not use emojis - use unicode if you need symbols.`;
 function buildScreenshotAnalysisPrompt(opts) {
   let p = opts?.prompt || SCREENSHOT_ANALYSIS_PROMPT;
   if (opts?.styleMap) {
@@ -2835,7 +2833,7 @@ ${opts.styleMap}
   }
   p += `
 
-${TEXT_WRAP_DISCLAIMER}`;
+${ANALYSIS_RESPONSE_FORMAT}`;
   return p;
 }
 async function streamScreenshotAnalysis(opts) {
@@ -2861,6 +2859,9 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   let model;
   let path13;
   let fullPage = true;
+  let width;
+  let height;
+  let format;
   if (typeof promptOrOptions === "object" && promptOrOptions !== null) {
     prompt = promptOrOptions.prompt;
     existingUrl = promptOrOptions.imageUrl;
@@ -2868,11 +2869,17 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
     if (promptOrOptions.fullPage !== void 0) {
       fullPage = promptOrOptions.fullPage;
     }
+    width = promptOrOptions.width;
+    height = promptOrOptions.height;
+    format = promptOrOptions.format;
     onLog = promptOrOptions.onLog;
     model = promptOrOptions.model;
   } else {
     prompt = promptOrOptions;
   }
+  if (width != null && height != null) {
+    fullPage = false;
+  }
   let url;
   let styleMap;
   if (existingUrl) {
@@ -2880,7 +2887,12 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   } else {
     const ssResult = await sidecarRequest(
       fullPage ? "/screenshot-full-page" : "/screenshot-viewport",
-      path13 ? { path: path13 } : void 0,
+      {
+        ...path13 ? { path: path13 } : {},
+        ...width != null ? { width } : {},
+        ...height != null ? { height } : {},
+        ...format ? { format } : {}
+      },
       { timeout: fullPage ? 12e4 : 3e4 }
     );
     url = ssResult?.url || ssResult?.screenshotUrl;
@@ -4009,7 +4021,7 @@ var screenshotTool = {
   clearable: true,
   definition: {
     name: "screenshot",
-    description: "Capture a screenshot of the app preview and get a description of what's on screen. Choose `fullPage`: `false` captures just the visible viewport (fast \u2014 for a specific section the page is scrolled to), `true` captures the entire page top-to-bottom (slower \u2014 for overall composition or content past the fold). Captures the settled page state \u2014 it cannot catch animations, transitions, or transient state. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. To ask additional questions about a screenshot you have already captured, pass its URL as imageUrl to skip recapture. If the screenshot requires interaction first (logging in, clicking a tab, dismissing a modal, scrolling to a section), use the instructions param to describe the steps.",
+    description: "Capture a screenshot of the app preview and get a description of what's on screen. Choose `fullPage`: `false` captures just the visible viewport (fast \u2014 for a specific section the page is scrolled to), `true` captures the entire page top-to-bottom (slower \u2014 for overall composition or content past the fold). Captures the settled page state \u2014 it cannot catch animations, transitions, or transient state. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. To ask additional questions about a screenshot you have already captured, pass its URL as imageUrl to skip recapture. If the screenshot requires interaction first (logging in, clicking a tab, dismissing a modal, scrolling to a section), use the instructions param to describe the steps. To render a fixed-size image such as an Open Graph share card, set `width` and `height` (e.g. 1200 \xD7 630) and `format: 'png'`: the tool navigates to `path`, clips to exactly those pixel dimensions, and returns the image URL.",
     inputSchema: {
       type: "object",
       properties: {
@@ -4029,6 +4041,19 @@ var screenshotTool = {
           type: "string",
           description: 'Navigate to this path before capturing (e.g. "/settings", "/dashboard"). If omitted, screenshots the current page.'
         },
+        width: {
+          type: "number",
+          description: "Exact capture width in pixels. Set together with `height` to render a fixed-size image; clips to exactly this viewport instead of the default preview size."
+        },
+        height: {
+          type: "number",
+          description: "Exact capture height in pixels. Set together with `width`."
+        },
+        format: {
+          type: "string",
+          enum: ["png", "jpeg"],
+          description: "Output image format. Defaults to 'jpeg'. Use 'png' for crisp flat graphics like share cards, where JPEG artifacts show on sharp type and edges."
+        },
         instructions: {
           type: "string",
           description: "If the screenshot you need requires interaction first (dismissing a modal, clicking a tab, filling out a form, navigating a flow, scrolling to a section, getting through a login/auth checkpoint), describe the steps to get there. A browser automation agent will follow these instructions, then capture per your `fullPage` choice \u2014 so with `fullPage: false` you can scroll to a section and capture just that viewport. It can bypass auth and get right to where it needs to be if you tell it to authenticate as a test user and give it the path/screen to start its test at. Never describe what names or values to use when applying the instructions - the browser automation agent must use its own values for it to work properly. If a specific auth role is required to access the content, be sure to note that - it can automatically assume it for the purpose of testing. Use only when interaction is required to *reach* the state you want to capture \u2014 log in, dismiss a modal, switch a tab, follow a route, scroll to a section. If your steps are exercising the app's functionality across multiple states (running flows, asserting behavior under interaction, multi-step QA), use `runAutomatedBrowserTest` instead."
@@ -4071,6 +4096,9 @@ var screenshotTool = {
           prompt: input.prompt,
           path: input.path,
           fullPage,
+          width: input.width,
+          height: input.height,
+          format: input.format,
           onLog: context?.onLog,
           model: resolveModel("imageAnalysis", context?.models, context?.model)
         });
@@ -6281,6 +6309,14 @@ var ARCHIVE_DIR = ".logs/sessions";
 var ROTATE_THRESHOLD_BYTES = 32 * 1024 * 1024;
 var RETAIN_TAIL_BYTES = 16 * 1024 * 1024;
 var ARCHIVE_RETENTION_BYTES = 64 * 1024 * 1024;
+var ARCHIVE_NAME_RE = /^(cleared|rotated)-.*\.json$/;
+var archiveSortKey = (name) => name.replace(/^(cleared|rotated)-/, "");
+var ARCHIVE_COUNT_RE = /\.c(\d+)\.json$/;
+var HISTORY_DEFAULT_LIMIT = 500;
+var HISTORY_MAX_LIMIT = 2e3;
+var archiveCountCache = /* @__PURE__ */ new Map();
+var archiveMsgCache = /* @__PURE__ */ new Map();
+var ARCHIVE_MSG_CACHE_MAX = 3;
 function loadSession(state) {
   pruneArchives();
   try {
@@ -6359,31 +6395,34 @@ function buildPayload(state) {
 function archiveMessages(messages, label, models) {
   fs21.mkdirSync(ARCHIVE_DIR, { recursive: true });
   const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-  let dest = path11.join(ARCHIVE_DIR, `${label}-${ts}.json`);
+  const count = messages.length;
+  let dest = path11.join(ARCHIVE_DIR, `${label}-${ts}.c${count}.json`);
   let n = 1;
   while (fs21.existsSync(dest)) {
-    dest = path11.join(ARCHIVE_DIR, `${label}-${ts}-${n++}.json`);
+    dest = path11.join(ARCHIVE_DIR, `${label}-${ts}-${n++}.c${count}.json`);
   }
   const payload = { messages };
   if (models && Object.keys(models).length > 0) {
     payload.models = models;
   }
   fs21.writeFileSync(dest, JSON.stringify(payload), "utf-8");
-  log9.info("Session archived", { label, dest, messageCount: messages.length });
+  archiveCountCache.set(path11.basename(dest), count);
+  log9.info("Session archived", { label, dest, messageCount: count });
   pruneArchives();
   return dest;
 }
 function pruneArchives() {
   try {
-    const entries = fs21.readdirSync(ARCHIVE_DIR).filter((name) => /^(cleared|rotated)-.*\.json$/.test(name));
+    const entries = fs21.readdirSync(ARCHIVE_DIR).filter((name) => ARCHIVE_NAME_RE.test(name));
     if (entries.length <= 1) {
       return;
     }
-    const sortKey = (name) => name.replace(/^(cleared|rotated)-/, "");
     const archives = entries.map((name) => ({
       name,
       size: fs21.statSync(path11.join(ARCHIVE_DIR, name)).size
-    })).sort((a, b) => sortKey(b.name).localeCompare(sortKey(a.name)));
+    })).sort(
+      (a, b) => archiveSortKey(b.name).localeCompare(archiveSortKey(a.name))
+    );
     let kept = 0;
     let cut = archives.length;
     for (let i = 0; i < archives.length; i++) {
@@ -6414,6 +6453,129 @@ function pruneArchives() {
   } catch {
   }
 }
+function parseArchive(name) {
+  const cached3 = archiveMsgCache.get(name);
+  if (cached3) {
+    archiveMsgCache.delete(name);
+    archiveMsgCache.set(name, cached3);
+    return cached3;
+  }
+  try {
+    const raw = fs21.readFileSync(path11.join(ARCHIVE_DIR, name), "utf-8");
+    const data = JSON.parse(raw);
+    const messages = Array.isArray(data?.messages) ? data.messages : [];
+    archiveCountCache.set(name, messages.length);
+    archiveMsgCache.set(name, messages);
+    while (archiveMsgCache.size > ARCHIVE_MSG_CACHE_MAX) {
+      const oldest = archiveMsgCache.keys().next().value;
+      if (oldest === void 0) {
+        break;
+      }
+      archiveMsgCache.delete(oldest);
+    }
+    return messages;
+  } catch (err) {
+    log9.warn("Session archive unreadable", { name, error: err?.message });
+    return null;
+  }
+}
+function archiveCount(name) {
+  const cached3 = archiveCountCache.get(name);
+  if (cached3 !== void 0) {
+    return cached3;
+  }
+  const m = ARCHIVE_COUNT_RE.exec(name);
+  if (m) {
+    const n = Number(m[1]);
+    archiveCountCache.set(name, n);
+    return n;
+  }
+  const msgs = parseArchive(name);
+  return msgs ? msgs.length : null;
+}
+function readArchiveMessages(name) {
+  return parseArchive(name) ?? [];
+}
+function listConversationArchives() {
+  let names;
+  try {
+    names = fs21.readdirSync(ARCHIVE_DIR).filter((n) => ARCHIVE_NAME_RE.test(n));
+  } catch {
+    return { slots: [], archivedCount: 0 };
+  }
+  let maxClearedKey = null;
+  for (const name of names) {
+    if (name.startsWith("cleared-")) {
+      const key = archiveSortKey(name);
+      if (maxClearedKey === null || key > maxClearedKey) {
+        maxClearedKey = key;
+      }
+    }
+  }
+  const rotated = names.filter((n) => n.startsWith("rotated-")).filter((n) => maxClearedKey === null || archiveSortKey(n) > maxClearedKey).sort((a, b) => archiveSortKey(a).localeCompare(archiveSortKey(b)));
+  const slots = [];
+  let offset = 0;
+  for (const name of rotated) {
+    const count = archiveCount(name);
+    if (count === null || count <= 0) {
+      continue;
+    }
+    slots.push({ name, count, offset });
+    offset += count;
+  }
+  return { slots, archivedCount: offset };
+}
+function getHistoryPage(state, opts) {
+  const { slots, archivedCount } = listConversationArchives();
+  const liveLen = state.messages.length;
+  const total = archivedCount + liveLen;
+  const rawLimit = opts?.limit;
+  const limit = typeof rawLimit === "number" && Number.isFinite(rawLimit) ? Math.min(Math.max(1, rawLimit | 0), HISTORY_MAX_LIMIT) : HISTORY_DEFAULT_LIMIT;
+  const rawBefore = opts?.before;
+  const before = typeof rawBefore === "number" && Number.isFinite(rawBefore) ? Math.max(0, Math.min(rawBefore | 0, total)) : total;
+  const peekGlobal = (i) => {
+    if (i >= archivedCount) {
+      return state.messages[i - archivedCount];
+    }
+    for (const slot of slots) {
+      if (i < slot.offset + slot.count) {
+        return readArchiveMessages(slot.name)[i - slot.offset];
+      }
+    }
+    return void 0;
+  };
+  let startIndex = Math.max(0, before - limit);
+  while (startIndex > 0) {
+    const msg = peekGlobal(startIndex);
+    if (msg && msg.role === "user" && msg.toolCallId) {
+      startIndex--;
+    } else {
+      break;
+    }
+  }
+  const endIndex = before;
+  const messages = [];
+  for (const slot of slots) {
+    const slotEnd = slot.offset + slot.count;
+    if (slotEnd <= startIndex || slot.offset >= endIndex) {
+      continue;
+    }
+    const from = Math.max(startIndex, slot.offset) - slot.offset;
+    const to = Math.min(endIndex, slotEnd) - slot.offset;
+    const msgs = readArchiveMessages(slot.name);
+    for (let i = from; i < to; i++) {
+      messages.push(msgs[i]);
+    }
+  }
+  if (endIndex > archivedCount) {
+    const from = Math.max(startIndex, archivedCount) - archivedCount;
+    const to = endIndex - archivedCount;
+    for (let i = from; i < to; i++) {
+      messages.push(state.messages[i]);
+    }
+  }
+  return { messages, startIndex, endIndex, totalMessageCount: total };
+}
 function rotate(state) {
   const messages = state.messages;
   if (messages.length === 0) {
@@ -7951,8 +8113,6 @@ var USER_FACING_TOOLS = /* @__PURE__ */ new Set([
   "presentPublishPlan"
 ]);
 var FORCED_COMPACTION_THRESHOLD_TOKENS = 85e4;
-var HISTORY_DEFAULT_LIMIT = 500;
-var HISTORY_MAX_LIMIT = 2e3;
 var HeadlessSession = class {
   // Configuration
   opts;
@@ -8698,30 +8858,24 @@ var HeadlessSession = class {
     }
     if (action === "get_history") {
       this.applyPendingBlockUpdates();
-      const total = this.state.messages.length;
-      const rawLimit = parsed.limit;
-      const limit = typeof rawLimit === "number" && Number.isFinite(rawLimit) ? Math.min(Math.max(1, rawLimit | 0), HISTORY_MAX_LIMIT) : HISTORY_DEFAULT_LIMIT;
-      const rawBefore = parsed.before;
-      const before = typeof rawBefore === "number" && Number.isFinite(rawBefore) ? Math.max(0, Math.min(rawBefore | 0, total)) : total;
-      let startIndex = Math.max(0, before - limit);
-      while (startIndex > 0 && this.state.messages[startIndex].role === "user" && this.state.messages[startIndex].toolCallId) {
-        startIndex--;
-      }
-      const endIndex = before;
+      const page = getHistoryPage(this.state, {
+        ...typeof parsed.before === "number" ? { before: parsed.before } : {},
+        ...typeof parsed.limit === "number" ? { limit: parsed.limit } : {}
+      });
       log15.info("History response", {
         requestId,
-        startIndex,
-        endIndex,
-        count: endIndex - startIndex,
-        totalMessageCount: total,
-        beforeParam: rawBefore,
-        limitParam: rawLimit
+        startIndex: page.startIndex,
+        endIndex: page.endIndex,
+        count: page.endIndex - page.startIndex,
+        totalMessageCount: page.totalMessageCount,
+        beforeParam: parsed.before,
+        limitParam: parsed.limit
       });
       this.dispatchSimple(requestId, "history", () => ({
-        messages: this.state.messages.slice(startIndex, endIndex),
-        startIndex,
-        endIndex,
-        totalMessageCount: total,
+        messages: page.messages,
+        startIndex: page.startIndex,
+        endIndex: page.endIndex,
+        totalMessageCount: page.totalMessageCount,
         running: this.running,
         ...this.running && this.currentRequestId ? { currentRequestId: this.currentRequestId } : {},
         ...this.state.models && { models: this.state.models },

package/dist/index.js

@@ -1462,11 +1462,11 @@ var init_setProjectMetadata = __esm({
             },
             iconUrl: {
               type: "string",
-              description: "URL for the app icon (square."
+              description: "URL for the app icon (square)."
             },
             openGraphShareImageUrl: {
               type: "string",
-              description: "URL for the Open Graph share image (1200x630)."
+              description: "URL for the Open Graph share image (1200\xD7630 PNG)."
             }
           }
         }
@@ -2314,31 +2314,34 @@ function buildPayload(state) {
 function archiveMessages(messages, label, models) {
   fs10.mkdirSync(ARCHIVE_DIR, { recursive: true });
   const ts = (/* @__PURE__ */ new Date()).toISOString().replace(/[:.]/g, "-");
-  let dest = path4.join(ARCHIVE_DIR, `${label}-${ts}.json`);
+  const count = messages.length;
+  let dest = path4.join(ARCHIVE_DIR, `${label}-${ts}.c${count}.json`);
   let n = 1;
   while (fs10.existsSync(dest)) {
-    dest = path4.join(ARCHIVE_DIR, `${label}-${ts}-${n++}.json`);
+    dest = path4.join(ARCHIVE_DIR, `${label}-${ts}-${n++}.c${count}.json`);
   }
   const payload = { messages };
   if (models && Object.keys(models).length > 0) {
     payload.models = models;
   }
   fs10.writeFileSync(dest, JSON.stringify(payload), "utf-8");
-  log3.info("Session archived", { label, dest, messageCount: messages.length });
+  archiveCountCache.set(path4.basename(dest), count);
+  log3.info("Session archived", { label, dest, messageCount: count });
   pruneArchives();
   return dest;
 }
 function pruneArchives() {
   try {
-    const entries = fs10.readdirSync(ARCHIVE_DIR).filter((name) => /^(cleared|rotated)-.*\.json$/.test(name));
+    const entries = fs10.readdirSync(ARCHIVE_DIR).filter((name) => ARCHIVE_NAME_RE.test(name));
     if (entries.length <= 1) {
       return;
     }
-    const sortKey = (name) => name.replace(/^(cleared|rotated)-/, "");
     const archives = entries.map((name) => ({
       name,
       size: fs10.statSync(path4.join(ARCHIVE_DIR, name)).size
-    })).sort((a, b) => sortKey(b.name).localeCompare(sortKey(a.name)));
+    })).sort(
+      (a, b) => archiveSortKey(b.name).localeCompare(archiveSortKey(a.name))
+    );
     let kept = 0;
     let cut = archives.length;
     for (let i = 0; i < archives.length; i++) {
@@ -2369,6 +2372,129 @@ function pruneArchives() {
   } catch {
   }
 }
+function parseArchive(name) {
+  const cached3 = archiveMsgCache.get(name);
+  if (cached3) {
+    archiveMsgCache.delete(name);
+    archiveMsgCache.set(name, cached3);
+    return cached3;
+  }
+  try {
+    const raw = fs10.readFileSync(path4.join(ARCHIVE_DIR, name), "utf-8");
+    const data = JSON.parse(raw);
+    const messages = Array.isArray(data?.messages) ? data.messages : [];
+    archiveCountCache.set(name, messages.length);
+    archiveMsgCache.set(name, messages);
+    while (archiveMsgCache.size > ARCHIVE_MSG_CACHE_MAX) {
+      const oldest = archiveMsgCache.keys().next().value;
+      if (oldest === void 0) {
+        break;
+      }
+      archiveMsgCache.delete(oldest);
+    }
+    return messages;
+  } catch (err) {
+    log3.warn("Session archive unreadable", { name, error: err?.message });
+    return null;
+  }
+}
+function archiveCount(name) {
+  const cached3 = archiveCountCache.get(name);
+  if (cached3 !== void 0) {
+    return cached3;
+  }
+  const m = ARCHIVE_COUNT_RE.exec(name);
+  if (m) {
+    const n = Number(m[1]);
+    archiveCountCache.set(name, n);
+    return n;
+  }
+  const msgs = parseArchive(name);
+  return msgs ? msgs.length : null;
+}
+function readArchiveMessages(name) {
+  return parseArchive(name) ?? [];
+}
+function listConversationArchives() {
+  let names;
+  try {
+    names = fs10.readdirSync(ARCHIVE_DIR).filter((n) => ARCHIVE_NAME_RE.test(n));
+  } catch {
+    return { slots: [], archivedCount: 0 };
+  }
+  let maxClearedKey = null;
+  for (const name of names) {
+    if (name.startsWith("cleared-")) {
+      const key = archiveSortKey(name);
+      if (maxClearedKey === null || key > maxClearedKey) {
+        maxClearedKey = key;
+      }
+    }
+  }
+  const rotated = names.filter((n) => n.startsWith("rotated-")).filter((n) => maxClearedKey === null || archiveSortKey(n) > maxClearedKey).sort((a, b) => archiveSortKey(a).localeCompare(archiveSortKey(b)));
+  const slots = [];
+  let offset = 0;
+  for (const name of rotated) {
+    const count = archiveCount(name);
+    if (count === null || count <= 0) {
+      continue;
+    }
+    slots.push({ name, count, offset });
+    offset += count;
+  }
+  return { slots, archivedCount: offset };
+}
+function getHistoryPage(state, opts) {
+  const { slots, archivedCount } = listConversationArchives();
+  const liveLen = state.messages.length;
+  const total = archivedCount + liveLen;
+  const rawLimit = opts?.limit;
+  const limit = typeof rawLimit === "number" && Number.isFinite(rawLimit) ? Math.min(Math.max(1, rawLimit | 0), HISTORY_MAX_LIMIT) : HISTORY_DEFAULT_LIMIT;
+  const rawBefore = opts?.before;
+  const before = typeof rawBefore === "number" && Number.isFinite(rawBefore) ? Math.max(0, Math.min(rawBefore | 0, total)) : total;
+  const peekGlobal = (i) => {
+    if (i >= archivedCount) {
+      return state.messages[i - archivedCount];
+    }
+    for (const slot of slots) {
+      if (i < slot.offset + slot.count) {
+        return readArchiveMessages(slot.name)[i - slot.offset];
+      }
+    }
+    return void 0;
+  };
+  let startIndex = Math.max(0, before - limit);
+  while (startIndex > 0) {
+    const msg = peekGlobal(startIndex);
+    if (msg && msg.role === "user" && msg.toolCallId) {
+      startIndex--;
+    } else {
+      break;
+    }
+  }
+  const endIndex = before;
+  const messages = [];
+  for (const slot of slots) {
+    const slotEnd = slot.offset + slot.count;
+    if (slotEnd <= startIndex || slot.offset >= endIndex) {
+      continue;
+    }
+    const from = Math.max(startIndex, slot.offset) - slot.offset;
+    const to = Math.min(endIndex, slotEnd) - slot.offset;
+    const msgs = readArchiveMessages(slot.name);
+    for (let i = from; i < to; i++) {
+      messages.push(msgs[i]);
+    }
+  }
+  if (endIndex > archivedCount) {
+    const from = Math.max(startIndex, archivedCount) - archivedCount;
+    const to = endIndex - archivedCount;
+    for (let i = from; i < to; i++) {
+      messages.push(state.messages[i]);
+    }
+  }
+  return { messages, startIndex, endIndex, totalMessageCount: total };
+}
 function rotate(state) {
   const messages = state.messages;
   if (messages.length === 0) {
@@ -2428,7 +2554,7 @@ function clearSession(state) {
     });
   }
 }
-var log3, SESSION_FILE, ARCHIVE_DIR, ROTATE_THRESHOLD_BYTES, RETAIN_TAIL_BYTES, ARCHIVE_RETENTION_BYTES;
+var log3, SESSION_FILE, ARCHIVE_DIR, ROTATE_THRESHOLD_BYTES, RETAIN_TAIL_BYTES, ARCHIVE_RETENTION_BYTES, ARCHIVE_NAME_RE, archiveSortKey, ARCHIVE_COUNT_RE, HISTORY_DEFAULT_LIMIT, HISTORY_MAX_LIMIT, archiveCountCache, archiveMsgCache, ARCHIVE_MSG_CACHE_MAX;
 var init_session = __esm({
   "src/session.ts"() {
     "use strict";
@@ -2442,6 +2568,14 @@ var init_session = __esm({
     ROTATE_THRESHOLD_BYTES = 32 * 1024 * 1024;
     RETAIN_TAIL_BYTES = 16 * 1024 * 1024;
     ARCHIVE_RETENTION_BYTES = 64 * 1024 * 1024;
+    ARCHIVE_NAME_RE = /^(cleared|rotated)-.*\.json$/;
+    archiveSortKey = (name) => name.replace(/^(cleared|rotated)-/, "");
+    ARCHIVE_COUNT_RE = /\.c(\d+)\.json$/;
+    HISTORY_DEFAULT_LIMIT = 500;
+    HISTORY_MAX_LIMIT = 2e3;
+    archiveCountCache = /* @__PURE__ */ new Map();
+    archiveMsgCache = /* @__PURE__ */ new Map();
+    ARCHIVE_MSG_CACHE_MAX = 3;
   }
 });
 
@@ -3555,7 +3689,7 @@ ${opts.styleMap}
   }
   p += `
 
-${TEXT_WRAP_DISCLAIMER}`;
+${ANALYSIS_RESPONSE_FORMAT}`;
   return p;
 }
 async function streamScreenshotAnalysis(opts) {
@@ -3581,6 +3715,9 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   let model;
   let path14;
   let fullPage = true;
+  let width;
+  let height;
+  let format;
   if (typeof promptOrOptions === "object" && promptOrOptions !== null) {
     prompt = promptOrOptions.prompt;
     existingUrl = promptOrOptions.imageUrl;
@@ -3588,11 +3725,17 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
     if (promptOrOptions.fullPage !== void 0) {
       fullPage = promptOrOptions.fullPage;
     }
+    width = promptOrOptions.width;
+    height = promptOrOptions.height;
+    format = promptOrOptions.format;
     onLog = promptOrOptions.onLog;
     model = promptOrOptions.model;
   } else {
     prompt = promptOrOptions;
   }
+  if (width != null && height != null) {
+    fullPage = false;
+  }
   let url;
   let styleMap;
   if (existingUrl) {
@@ -3600,7 +3743,12 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
   } else {
     const ssResult = await sidecarRequest(
       fullPage ? "/screenshot-full-page" : "/screenshot-viewport",
-      path14 ? { path: path14 } : void 0,
+      {
+        ...path14 ? { path: path14 } : {},
+        ...width != null ? { width } : {},
+        ...height != null ? { height } : {},
+        ...format ? { format } : {}
+      },
       { timeout: fullPage ? 12e4 : 3e4 }
     );
     url = ssResult?.url || ssResult?.screenshotUrl;
@@ -3627,16 +3775,14 @@ async function captureAndAnalyzeScreenshot(promptOrOptions) {
     model
   });
 }
-var SCREENSHOT_ANALYSIS_PROMPT, TEXT_WRAP_DISCLAIMER;
+var SCREENSHOT_ANALYSIS_PROMPT, ANALYSIS_RESPONSE_FORMAT;
 var init_screenshot = __esm({
   "src/tools/_helpers/screenshot.ts"() {
     "use strict";
     init_sidecar();
     init_analyzeImage();
     SCREENSHOT_ANALYSIS_PROMPT = `Describe everything visible on screen from top to bottom \u2014 every element, its position, its size relative to the viewport, its colors, its content. Be comprehensive, thorough, and spatial. After the inventory, note anything that looks visually broken (overlapping elements, clipped text, misaligned components).`;
-    TEXT_WRAP_DISCLAIMER = `Note: ignore text wrapping issues. Screenshots occasionally show text wrapping onto an extra line compared to the live page \u2014 most noticeable in buttons, badges, and headings. This is a known limitation of SVG foreignObject rendering used the DOM-to-image capture library that took the screenshot. The browser's SVG renderer computes slightly wider text metrics than the HTML layout engine, so text that fits on one line in the live DOM can overflow by a fraction of a pixel in the capture - this is not a real issue.
-
-Respond only with your analysis as Markdown and absolutely no other text. Do not use emojis - use unicode if you need symbols.`;
+    ANALYSIS_RESPONSE_FORMAT = `Respond only with your analysis as Markdown and absolutely no other text. Do not use emojis - use unicode if you need symbols.`;
   }
 });
 
@@ -4622,7 +4768,7 @@ var init_screenshot2 = __esm({
       clearable: true,
       definition: {
         name: "screenshot",
-        description: "Capture a screenshot of the app preview and get a description of what's on screen. Choose `fullPage`: `false` captures just the visible viewport (fast \u2014 for a specific section the page is scrolled to), `true` captures the entire page top-to-bottom (slower \u2014 for overall composition or content past the fold). Captures the settled page state \u2014 it cannot catch animations, transitions, or transient state. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. To ask additional questions about a screenshot you have already captured, pass its URL as imageUrl to skip recapture. If the screenshot requires interaction first (logging in, clicking a tab, dismissing a modal, scrolling to a section), use the instructions param to describe the steps.",
+        description: "Capture a screenshot of the app preview and get a description of what's on screen. Choose `fullPage`: `false` captures just the visible viewport (fast \u2014 for a specific section the page is scrolled to), `true` captures the entire page top-to-bottom (slower \u2014 for overall composition or content past the fold). Captures the settled page state \u2014 it cannot catch animations, transitions, or transient state. Optionally provide specific questions about what you're looking for. Use a bulleted list to ask many questions at once. To ask additional questions about a screenshot you have already captured, pass its URL as imageUrl to skip recapture. If the screenshot requires interaction first (logging in, clicking a tab, dismissing a modal, scrolling to a section), use the instructions param to describe the steps. To render a fixed-size image such as an Open Graph share card, set `width` and `height` (e.g. 1200 \xD7 630) and `format: 'png'`: the tool navigates to `path`, clips to exactly those pixel dimensions, and returns the image URL.",
         inputSchema: {
           type: "object",
           properties: {
@@ -4642,6 +4788,19 @@ var init_screenshot2 = __esm({
               type: "string",
               description: 'Navigate to this path before capturing (e.g. "/settings", "/dashboard"). If omitted, screenshots the current page.'
             },
+            width: {
+              type: "number",
+              description: "Exact capture width in pixels. Set together with `height` to render a fixed-size image; clips to exactly this viewport instead of the default preview size."
+            },
+            height: {
+              type: "number",
+              description: "Exact capture height in pixels. Set together with `width`."
+            },
+            format: {
+              type: "string",
+              enum: ["png", "jpeg"],
+              description: "Output image format. Defaults to 'jpeg'. Use 'png' for crisp flat graphics like share cards, where JPEG artifacts show on sharp type and edges."
+            },
             instructions: {
               type: "string",
               description: "If the screenshot you need requires interaction first (dismissing a modal, clicking a tab, filling out a form, navigating a flow, scrolling to a section, getting through a login/auth checkpoint), describe the steps to get there. A browser automation agent will follow these instructions, then capture per your `fullPage` choice \u2014 so with `fullPage: false` you can scroll to a section and capture just that viewport. It can bypass auth and get right to where it needs to be if you tell it to authenticate as a test user and give it the path/screen to start its test at. Never describe what names or values to use when applying the instructions - the browser automation agent must use its own values for it to work properly. If a specific auth role is required to access the content, be sure to note that - it can automatically assume it for the purpose of testing. Use only when interaction is required to *reach* the state you want to capture \u2014 log in, dismiss a modal, switch a tab, follow a route, scroll to a section. If your steps are exercising the app's functionality across multiple states (running flows, asserting behavior under interaction, multi-step QA), use `runAutomatedBrowserTest` instead."
@@ -4684,6 +4843,9 @@ var init_screenshot2 = __esm({
               prompt: input.prompt,
               path: input.path,
               fullPage,
+              width: input.width,
+              height: input.height,
+              format: input.format,
               onLog: context?.onLog,
               model: resolveModel("imageAnalysis", context?.models, context?.model)
             });
@@ -8811,7 +8973,7 @@ var headless_exports = {};
 __export(headless_exports, {
   HeadlessSession: () => HeadlessSession
 });
-var log15, EXTERNAL_TOOL_TIMEOUT_MS, USER_FACING_TOOLS, FORCED_COMPACTION_THRESHOLD_TOKENS, HISTORY_DEFAULT_LIMIT, HISTORY_MAX_LIMIT, HeadlessSession;
+var log15, EXTERNAL_TOOL_TIMEOUT_MS, USER_FACING_TOOLS, FORCED_COMPACTION_THRESHOLD_TOKENS, HeadlessSession;
 var init_headless = __esm({
   "src/headless/index.ts"() {
     "use strict";
@@ -8840,8 +9002,6 @@ var init_headless = __esm({
       "presentPublishPlan"
     ]);
     FORCED_COMPACTION_THRESHOLD_TOKENS = 85e4;
-    HISTORY_DEFAULT_LIMIT = 500;
-    HISTORY_MAX_LIMIT = 2e3;
     HeadlessSession = class {
       // Configuration
       opts;
@@ -9587,30 +9747,24 @@ var init_headless = __esm({
         }
         if (action === "get_history") {
           this.applyPendingBlockUpdates();
-          const total = this.state.messages.length;
-          const rawLimit = parsed.limit;
-          const limit = typeof rawLimit === "number" && Number.isFinite(rawLimit) ? Math.min(Math.max(1, rawLimit | 0), HISTORY_MAX_LIMIT) : HISTORY_DEFAULT_LIMIT;
-          const rawBefore = parsed.before;
-          const before = typeof rawBefore === "number" && Number.isFinite(rawBefore) ? Math.max(0, Math.min(rawBefore | 0, total)) : total;
-          let startIndex = Math.max(0, before - limit);
-          while (startIndex > 0 && this.state.messages[startIndex].role === "user" && this.state.messages[startIndex].toolCallId) {
-            startIndex--;
-          }
-          const endIndex = before;
+          const page = getHistoryPage(this.state, {
+            ...typeof parsed.before === "number" ? { before: parsed.before } : {},
+            ...typeof parsed.limit === "number" ? { limit: parsed.limit } : {}
+          });
           log15.info("History response", {
             requestId,
-            startIndex,
-            endIndex,
-            count: endIndex - startIndex,
-            totalMessageCount: total,
-            beforeParam: rawBefore,
-            limitParam: rawLimit
+            startIndex: page.startIndex,
+            endIndex: page.endIndex,
+            count: page.endIndex - page.startIndex,
+            totalMessageCount: page.totalMessageCount,
+            beforeParam: parsed.before,
+            limitParam: parsed.limit
           });
           this.dispatchSimple(requestId, "history", () => ({
-            messages: this.state.messages.slice(startIndex, endIndex),
-            startIndex,
-            endIndex,
-            totalMessageCount: total,
+            messages: page.messages,
+            startIndex: page.startIndex,
+            endIndex: page.endIndex,
+            totalMessageCount: page.totalMessageCount,
             running: this.running,
             ...this.running && this.currentRequestId ? { currentRequestId: this.currentRequestId } : {},
             ...this.state.models && { models: this.state.models },

package/dist/prompt/static/team.md

@@ -76,6 +76,6 @@ When you receive background results:
 
 You can only background the following two tasks, unless the user specifically asks you to do work in the background:
 - `productVision` seeding the intiial roadmap after writing the spec for the first time or updating the roadmap after large work sessions. This task takes a while and we can allow the user to continue building while it happens in the background.
-- After writing the spec, once you have finalized the shape of the app, ask `visualDesignExpert` to create an icon and an open graph shring image for the app, then set them with `setProjectMetadata`, alongside the app's name and short description.
+- After writing the spec, once you have finalized the shape of the app, ask `visualDesignExpert` to create an icon and to design an Open Graph share image, then set them with `setProjectMetadata` alongside the app's name and short description. The icon is a generated asset. The share image should be composed as a self-contained HTML card (real lockup, brand fonts, exact type) and captured — not generated: serve the card HTML from `dist/interfaces/web/public/`, screenshot it with the `screenshot` tool at `width: 1200, height: 630, format: 'png'`, and save the resulting PNG into the app's public assets so the deployed site hosts it.
 
 Do not background any other tasks. Be aware that sometimes tools like specSync will background on their own - this is not something that is within your control.

package/dist/subagents/designExpert/prompts/images.md

@@ -77,7 +77,9 @@ Keep logos and icons consistent - if you already have a logo, use `editImages` t
 
 #### Open Graph Sharing Images
 
-OG images show up in iMessage, Slack, Twitter, etc. at small sizes. They're a mood piece, not a messaging opportunity. Keep text minimal: the app name and at most a short tagline (three to five words). Think App Store feature card — one beautiful composition that makes someone want to tap. The text should feel integrated into the scene, not pasted on a background. Generate at 4096 × 2150 and return the CDN URL.
+OG images show up in iMessage, Slack, Twitter, etc. at small sizes. They're a mood piece, not a messaging opportunity. Keep text minimal: the app name and at most a short tagline (three to five words). Think App Store feature card — one beautiful composition that makes someone want to tap. The text should feel integrated into the scene, not pasted on a background.
+
+A share card is a wordmark, a short line, and a logo on a brand field — **compose it as HTML, don't generate it with the image model.** A generated image gives you odd letterforms and no brand fidelity; HTML gives you the real SVG lockup, the actual brand fonts, exact colors, and pixel-perfect spacing. Author a self-contained HTML document sized to 1200 × 630 — the lockup inline as SVG, the brand fonts inlined as base64 (so nothing loads late and captures as a fallback), the palette and type exact — then capture it with the `screenshot` tool at `width: 1200, height: 630, format: 'png'`, a faithful real-browser render. Don't route it through a document/HTML-to-image "openGraph" render mode; that pipeline strips CSS backgrounds. The same compose-and-capture approach beats generation for any precise brand graphic where letterforms and spacing carry the design.
 
 ### When to use images
 

package/dist/subagents/designExpert/tools/images/enhance-image-prompt.md

@@ -69,12 +69,6 @@ For app icons and logos, the goal is something that reads clearly at phone home
 - You must specify that the image is full bleed - never say anything about rounded corners or there is a high likelihood that the image will come back as a rounded rectangle on a white background!
 - Apply the same material/lighting/color density as photography prompts, just to a single object. Describe the surface finish ("high-gloss lacquered finish with clean specular highlights," "soft matte ceramic with subtle surface texture"), the lighting behavior ("warm directional light from upper left producing a bright highlight streak across the curved surface and a soft shadow beneath"), and color as relationships ("deep coral body graduating to warm peach at the highlight edge, with a cream accent on the lens element"). Generic descriptors like "clean surfaces, soft lighting" produce generic icons.
 
-#### Open Graph Sharing Images
-
-OG images are often a user's first impression of the app — they show up in iMessage, Slack, Twitter, etc. at small sizes. Keep text minimal: the app name and at most a short tagline (three to five words). This is a mood piece, not a messaging opportunity. Think App Store feature card — one beautiful composition that makes someone want to tap.
-
-Apply the same material/lighting/color density as photography prompts. The text should feel integrated into the scene — typeset within the composition, not pasted on top. Describe the typography treatment (weight, size, color, position) as part of the overall image, and describe how the background interacts with the text (glow, depth, contrast). The whole image should read as one cohesive graphic, not layers.
-
 ## Output
 
 Respond with ONLY the enhanced prompt. Be detailed and specific — a good prompt is a dense paragraph of 80-150 words that paints a complete picture: style, subject, materials, lighting behavior, color relationships, atmosphere, and composition. Terse prompts produce generic images.

package/package.json

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