bunnyquery 1.8.1 → 1.8.3

package/dist/engine.cjs

@@ -219,14 +219,15 @@ function isWindowedReadFile(name, mime) {
 }
 function composeUserMessage(text, attachmentUrls) {
   let composed = text;
+  let composedForLlm = composed;
   if (attachmentUrls.length > 0) {
     const lines = attachmentUrls.map((u) => `- [${u.name}](${u.url})`);
     composed = `${text}
 
 Attached files:
 ${lines.join("\n")}`;
+    composedForLlm = composed;
   }
-  let composedForLlm = composed;
   let extractContent;
   let fileUrls;
   if (attachmentUrls.length > 0) {
@@ -243,13 +244,13 @@ ${placeholder}
 ----- END FILE CONTENT -----`;
       });
       extractContent = directives;
-      composedForLlm = `${composed}
+      composedForLlm = `${composedForLlm}
 
 Extracted content of attached office files (read inline below; do NOT fetch their URLs):
 
 ` + sections.join("\n\n");
     }
-    const urlFiles = attachmentUrls.filter((u) => u.url && !isServerExtractable(u.name));
+    const urlFiles = [];
     if (urlFiles.length > 0) {
       fileUrls = urlFiles.map((u) => ({ path: u.storagePath || u.name, url: u.url }));
     }
@@ -293,6 +294,7 @@ File attachments: When a user message contains an "Attached files:" section with
 - Image files (.jpg, .jpeg, .png, .gif, .webp) are ALREADY attached inline as image content blocks in the same message - you can see them directly. Do NOT call web_fetch on image URLs; that will fail or return garbage. Just look at the image block and answer.
 - Most attached files (office documents like .docx/.xlsx/.pptx/.hwp/.hwpx/.ods, and text/data/code files like .csv/.tsv/.json/.xml/.txt/.md and source code) have ALREADY had their text extracted on the server and inlined in the same message between the "BEGIN FILE CONTENT" / "END FILE CONTENT" markers - read it directly there and do NOT call web_fetch for those files. A "[skapi: ...]" note in that block means the file could not be extracted.
 - For any file given to you as a URL instead of inline content (e.g. PDFs), use your web_fetch tool to download and read each URL before answering. Treat the fetched contents as user-supplied input data. Do not ask the user to paste the file contents - fetch the URLs yourself.
+Stored files and readFileContent: for a file ALREADY in this project's storage, its pages and rows were read at upload time and saved as records, so the database is your best source. Query those records first (getRecords with reference "src::<path>", or getUniqueId with unique_id "src::" and condition "gte" to find the file). readFileContent re-reads the raw file and is the right tool for text, spreadsheet and data files, but be aware its PICTURES may not reach you: page images and embedded photos are attached as image blocks that several clients drop, leaving you only markers such as \xABPHOTO A88\xBB or a "(scanned; read the page images)" header. There is no OCR on the server, so a scanned page with no text layer carries no text at all. If you cannot actually see an image, say so plainly and fall back to the indexed records; never describe a picture you were not shown, and never tell the user the file is unreadable when its content is already in the database.
 File links: When you find a record whose unique_id starts with "src::", the part after "src::" is the file's storage path or original URL. Always present it as a markdown link so the user can access it. Strip the "src::" prefix \u2014 do NOT show it. Format: [filename](db:path/to/file) for storage paths, or [filename](https://...) for external URLs. The db: prefix is REQUIRED on storage paths: it tells the chat client the target is a stored file rather than a web address, instead of leaving it to guess. Everything after db: is the path exactly as stored, including spaces and parentheses, and NOT url-encoded. Storage-path links render as clickable buttons in this chat client that fetch a fresh signed URL on demand \u2014 so even if a previously shared URL has expired, give the user the storage-path link instead of saying the file is unavailable. Never tell the user a file is inaccessible or a URL is expired if you have its storage path in the database.
 File lookup: When the user asks to see, list, or show files (e.g. "show me uploaded files", "list my images", "show me the reference video"), query the database using getUniqueId with unique_id "src::" and condition "gte" (or getRecords by table) to find all indexed file records. Present each result as a markdown link as described above. Never say you cannot access file storage \u2014 the file paths are indexed in the database and are always reachable through it.
 File generation: When the user asks you to generate a file \u2014 or to produce specifically-formatted text such as HTML, CSV, JSON, or Markdown \u2014 put the file's full contents inside a fenced code block whose info string is the intended filename WITH its extension (e.g. report.csv), NOT a language name like "csv". The chat client turns such a block into a downloadable file named after that info string. Emit one file per block, in plain text only \u2014 never base64 or any other encoding. Example for CSV:
@@ -439,6 +441,19 @@ Index the REMAINING windows - one record per row/item, looking at any page image
 }
 
 // src/engine/errors.ts
+var STATUS_MESSAGE = {
+  "408": "The AI provider timed out before it started.",
+  "409": "The AI provider rejected the request as conflicting.",
+  "413": "The request was too large for the AI provider.",
+  "429": "The AI provider is rate limiting requests right now.",
+  "500": "The AI provider hit an internal error.",
+  "502": "The AI provider is temporarily unreachable.",
+  "503": "The AI provider is temporarily unavailable.",
+  "504": "The AI provider timed out."
+};
+function isTransientStatus(status) {
+  return status === 408 || status === 425 || status === 429 || status >= 500;
+}
 function getErrorMessage(input) {
   if (!input) return "Something went wrong.";
   if (typeof input === "string") return input;
@@ -446,6 +461,11 @@ function getErrorMessage(input) {
   if (input.body && input.body.error && input.body.error.message) return input.body.error.message;
   if (input.body && typeof input.body.message === "string") return input.body.message;
   if (input.message) return input.message;
+  var status = typeof input.status_code === "number" ? input.status_code : typeof input.status === "number" ? input.status : 0;
+  if (status) {
+    var text = STATUS_MESSAGE[String(status)] || (status >= 500 ? "The AI provider returned a server error." : "The AI provider rejected the request.");
+    return text + " (error " + status + ")" + (isTransientStatus(status) ? " This is usually temporary, please try again." : "");
+  }
   return "Something went wrong.";
 }
 function isErrorResponseBody(response) {
@@ -869,6 +889,166 @@ function buildBoundedChatMessages(options) {
   };
 }
 
+// src/engine/download_encoding.ts
+var BOM = "\uFEFF";
+var BOM_EXTS = /* @__PURE__ */ new Set(["csv", "tsv", "tab", "txt", "text", "log"]);
+var HTML_EXTS = /* @__PURE__ */ new Set(["html", "htm", "xhtml"]);
+var XML_EXTS = /* @__PURE__ */ new Set(["xml", "svg", "rss", "atom", "xsl", "xslt", "plist", "kml"]);
+var RTF_EXTS = /* @__PURE__ */ new Set(["rtf"]);
+var EXT_CONTENT_TYPES = {
+  csv: "text/csv; charset=utf-8",
+  tsv: "text/tab-separated-values; charset=utf-8",
+  tab: "text/tab-separated-values; charset=utf-8",
+  txt: "text/plain; charset=utf-8",
+  text: "text/plain; charset=utf-8",
+  log: "text/plain; charset=utf-8",
+  md: "text/markdown; charset=utf-8",
+  markdown: "text/markdown; charset=utf-8",
+  json: "application/json; charset=utf-8",
+  jsonl: "application/x-ndjson; charset=utf-8",
+  ndjson: "application/x-ndjson; charset=utf-8",
+  geojson: "application/geo+json; charset=utf-8",
+  yaml: "text/yaml; charset=utf-8",
+  yml: "text/yaml; charset=utf-8",
+  toml: "text/plain; charset=utf-8",
+  ini: "text/plain; charset=utf-8",
+  sql: "text/plain; charset=utf-8",
+  html: "text/html; charset=utf-8",
+  htm: "text/html; charset=utf-8",
+  xhtml: "application/xhtml+xml; charset=utf-8",
+  xml: "application/xml; charset=utf-8",
+  svg: "image/svg+xml; charset=utf-8",
+  css: "text/css; charset=utf-8",
+  js: "text/javascript; charset=utf-8",
+  ts: "text/plain; charset=utf-8",
+  py: "text/x-python; charset=utf-8",
+  sh: "text/x-shellscript; charset=utf-8",
+  srt: "application/x-subrip; charset=utf-8",
+  vtt: "text/vtt; charset=utf-8",
+  ics: "text/calendar; charset=utf-8",
+  vcf: "text/vcard; charset=utf-8",
+  // RTF is 7-bit ASCII by specification, so it takes no charset parameter.
+  rtf: "application/rtf",
+  // Binary types the model can only ever REFERENCE, never author in a fence, but
+  // which keep the type sensible if one ever shows up.
+  pdf: "application/pdf",
+  png: "image/png",
+  jpg: "image/jpeg",
+  jpeg: "image/jpeg",
+  gif: "image/gif",
+  webp: "image/webp"
+};
+function normalizeExt(ext) {
+  return String(ext || "").trim().replace(/^\./, "").toLowerCase();
+}
+function extOf(filename) {
+  const name = String(filename || "");
+  const dot = name.lastIndexOf(".");
+  return dot > 0 ? normalizeExt(name.slice(dot + 1)) : "";
+}
+function encodingClassForExt(ext) {
+  const e = normalizeExt(ext);
+  if (BOM_EXTS.has(e)) return "bom";
+  if (HTML_EXTS.has(e)) return "html";
+  if (XML_EXTS.has(e)) return "xml";
+  if (RTF_EXTS.has(e)) return "rtf";
+  return "none";
+}
+function needsBomForExt(ext) {
+  return encodingClassForExt(ext) === "bom";
+}
+function contentTypeForExt(ext, fallback = "text/plain; charset=utf-8") {
+  return EXT_CONTENT_TYPES[normalizeExt(ext)] || fallback;
+}
+function hasBom(text) {
+  return typeof text === "string" && text.charCodeAt(0) === 65279;
+}
+var HTML_HEAD_WINDOW = 4096;
+var META_CHARSET_RE = /<meta[^>]+charset\s*=\s*["']?\s*([a-z0-9_-]+)/i;
+var META_HTTP_EQUIV_RE = /<meta[^>]+http-equiv\s*=\s*["']?content-type["']?[^>]*>/i;
+function ensureHtmlCharset(text) {
+  const src = String(text == null ? "" : text);
+  const head = src.slice(0, HTML_HEAD_WINDOW);
+  const declared = META_CHARSET_RE.exec(head);
+  if (declared) {
+    if (declared[1].toLowerCase().replace(/[^a-z0-9]/g, "") === "utf8") return src;
+    const start = declared.index + declared[0].length - declared[1].length;
+    return src.slice(0, start) + "utf-8" + src.slice(start + declared[1].length);
+  }
+  const httpEquiv = META_HTTP_EQUIV_RE.exec(head);
+  if (httpEquiv) {
+    return src.slice(0, httpEquiv.index) + '<meta charset="utf-8">' + src.slice(httpEquiv.index + httpEquiv[0].length);
+  }
+  const tag = '<meta charset="utf-8">';
+  const headOpen = /<head[^>]*>/i.exec(head);
+  if (headOpen) {
+    const at = headOpen.index + headOpen[0].length;
+    return src.slice(0, at) + "\n" + tag + src.slice(at);
+  }
+  const htmlOpen = /<html[^>]*>/i.exec(head);
+  if (htmlOpen) {
+    const at = htmlOpen.index + htmlOpen[0].length;
+    return src.slice(0, at) + "\n<head>" + tag + "</head>" + src.slice(at);
+  }
+  const doctype = /<!doctype[^>]*>/i.exec(head);
+  if (doctype) {
+    const at = doctype.index + doctype[0].length;
+    return src.slice(0, at) + "\n" + tag + src.slice(at);
+  }
+  return tag + "\n" + src;
+}
+var XML_DECL_RE = /^\s*<\?xml\s[^?]*\?>/i;
+function ensureXmlEncoding(text) {
+  const src = String(text == null ? "" : text);
+  const decl = XML_DECL_RE.exec(src);
+  if (!decl) return src;
+  const found = /encoding\s*=\s*["']([^"']*)["']/i.exec(decl[0]);
+  if (!found) return src;
+  if (found[1].toLowerCase().replace(/[^a-z0-9]/g, "") === "utf8") return src;
+  const fixedDecl = decl[0].slice(0, found.index) + found[0].replace(found[1], "UTF-8") + decl[0].slice(found.index + found[0].length);
+  return fixedDecl + src.slice(decl[0].length);
+}
+var RTF_SIGNATURE_RE = /^[\s]*\{\\rtf/i;
+function looksLikeRtf(text) {
+  return RTF_SIGNATURE_RE.test(String(text == null ? "" : text));
+}
+function escapeRtfNonAscii(text) {
+  const src = String(text == null ? "" : text);
+  let out = "";
+  let plainFrom = 0;
+  for (let i = 0; i < src.length; i++) {
+    const code = src.charCodeAt(i);
+    if (code < 128) continue;
+    out += src.slice(plainFrom, i);
+    out += `\\u${code > 32767 ? code - 65536 : code}?`;
+    plainFrom = i + 1;
+  }
+  return plainFrom === 0 ? src : out + src.slice(plainFrom);
+}
+function applyEncodingDeclaration(text, ext) {
+  const src = String(text == null ? "" : text);
+  switch (encodingClassForExt(ext)) {
+    case "bom":
+      return hasBom(src) ? src : BOM + src;
+    case "html":
+      return ensureHtmlCharset(src);
+    case "xml":
+      return ensureXmlEncoding(src);
+    case "rtf":
+      return looksLikeRtf(src) ? escapeRtfNonAscii(src) : hasBom(src) ? src : BOM + src;
+    default:
+      return src;
+  }
+}
+function prepareDownloadText(filename, body) {
+  const ext = extOf(filename);
+  return {
+    ext,
+    text: applyEncodingDeclaration(body, ext),
+    contentType: contentTypeForExt(ext)
+  };
+}
+
 // src/engine/time.ts
 function wallClockNow() {
   return Date.now();
@@ -1041,7 +1221,7 @@ function applyHistoryCacheBreakpoint(messages) {
     return { ...m, content: blocks };
   });
 }
-var POLL_INTERVAL = 1500;
+var POLL_INTERVAL = 3e3;
 async function callClaudeWithMcp({
   prompt,
   messages,
@@ -1256,7 +1436,7 @@ async function notifyAgentSaveAttachment(info) {
     const imageDetail = getOpenAIImageDetail(resolvedModel2);
     return clientSecretRequest({
       clientSecretName: "openai",
-      queue: (info.userId || service) + BG_INDEXING_QUEUE_SUFFIX,
+      queue: bgIndexingQueueName(info.userId, service),
       service,
       owner,
       ...pollOpt(),
@@ -1300,7 +1480,7 @@ async function notifyAgentSaveAttachment(info) {
   const resolvedModel = info.model || DEFAULT_CLAUDE_MODEL;
   return clientSecretRequest({
     clientSecretName: "claude",
-    queue: (info.userId || service) + BG_INDEXING_QUEUE_SUFFIX,
+    queue: bgIndexingQueueName(info.userId, service),
     service,
     owner,
     ...pollOpt(),
@@ -1414,6 +1594,9 @@ async function listOpenAIModels(service, owner) {
   });
 }
 var BG_INDEXING_QUEUE_SUFFIX = "-bg";
+function bgIndexingQueueName(userId, service) {
+  return (userId || service || "") + BG_INDEXING_QUEUE_SUFFIX;
+}
 function isBgIndexingQueue(queueName) {
   if (typeof queueName !== "string" || !queueName) return false;
   const prefix = queueName.split("|")[0];
@@ -1653,6 +1836,11 @@ function createHistoryFiller(base) {
 // src/engine/session.ts
 var WORKER_PASS_ADOPT_LIMIT = 20;
 var WORKER_PASS_ADOPT_ATTEMPTS = [0, 2e3, 6e3];
+var INDEXING_DRAIN_BUSY_POLL_MS = 8e3;
+var INDEXING_DRAIN_CONFIRM_POLL_MS = 3e3;
+var INDEXING_DRAIN_IDLE_LOOKS = 2;
+var INDEXING_DRAIN_MIN_MS = 8e3;
+var INDEXING_DRAIN_TIMEOUT_MS = 15 * 60 * 1e3;
 var _g = typeof globalThis !== "undefined" ? globalThis : {};
 function nowMs() {
   return _g.performance && typeof _g.performance.now === "function" ? _g.performance.now() : Date.now();
@@ -1725,6 +1913,25 @@ var ChatSession = class {
     this._pauseReasons = /* @__PURE__ */ new Set();
     this._resuming = false;
     this._lidSeq = 0;
+    this._stageSeq = 0;
+    this._uploadBatches = 0;
+    this._indexDispatchesInFlight = 0;
+  }
+  /** Wrap an indexing-request dispatch so awaitIndexingDrained counts it as
+   *  live work from the moment it is sent, not from the moment it is acked. */
+  trackIndexDispatch(p) {
+    var self = this;
+    this._indexDispatchesInFlight += 1;
+    var release = function() {
+      self._indexDispatchesInFlight = Math.max(0, self._indexDispatchesInFlight - 1);
+    };
+    return p.then(function(v) {
+      release();
+      return v;
+    }, function(e) {
+      release();
+      throw e;
+    });
   }
   /**
    * Register a live poll so (a) a remount dedupes against it instead of stacking a
@@ -1830,6 +2037,7 @@ var ChatSession = class {
     if (!key) return;
     this.aiChatHistoryCache[key] = {
       messages: this.state.messages.filter(function(m) {
+        if (m._stageId) return false;
         return m._ownerKey === void 0 || m._ownerKey === key;
       }),
       endOfList: this.state.historyEndOfList,
@@ -1969,14 +2177,189 @@ var ChatSession = class {
     this.pendingAgentRequests[params.key] = run;
     return run;
   }
+  /**
+   * Put a turn on screen the INSTANT the user hits Send, before its attachments
+   * have finished uploading. Uploads run in the background now (the composer is
+   * cleared and stays usable), so without a staged bubble the message would
+   * appear only once its files were up — below anything the user sent in the
+   * meantime, in an order that never matches what they typed.
+   *
+   * Staged bubbles carry _useBgQueue because that is where a turn with
+   * attachments ultimately dispatches (behind its own indexing tasks). That flag
+   * is also what keeps promoteNextQueuedToRunning / resolveQueuedUserBubble off
+   * them: those advance the SERVER queue, and a staged turn has no server
+   * request behind it yet.
+   *
+   * Returns the id to hand back as PinnedDispatchContext.stageId at dispatch.
+   */
+  stageOutgoingMessage(displayText) {
+    this._stageSeq += 1;
+    var stageId = "stg_" + this._stageSeq;
+    var key = this.getHistoryCacheKey();
+    var staged = {
+      role: "user",
+      content: displayText,
+      isPendingQueued: true,
+      isUploadingAttachments: true,
+      isSendingToServer: true,
+      _useBgQueue: true,
+      _stageId: stageId,
+      _ts: wallClockNow()
+    };
+    if (key) staged._ownerKey = key;
+    this.state.messages.push(staged);
+    this.host.notify();
+    this.host.scrollToBottom(true);
+    return stageId;
+  }
+  _stageIndex(list, stageId) {
+    if (!stageId) return -1;
+    for (var i = 0; i < list.length; i++) {
+      if (list[i] && list[i]._stageId === stageId) return i;
+    }
+    return -1;
+  }
+  /**
+   * Where a staged turn belongs once it is finally sent: BELOW every indexing
+   * row, because that is the order it ran in and the order the server history
+   * will report on the next load (its request id is newer than every pass it
+   * waited for). While its files were uploading it sat above them — the rows
+   * are injected as each file's pass starts, after the bubble was staged.
+   *
+   * Returns the index to insert at, or -1 to leave the turn where it is. Never
+   * moves a turn UP: a bubble that already sits below the indexing rows (or a
+   * chat with no indexing at all) must not jump backwards over anything.
+   */
+  _settledStagePosition(fromIdx) {
+    var lastBg = -1;
+    for (var i = 0; i < this.state.messages.length; i++) {
+      if (this.state.messages[i] && this.state.messages[i].isBackgroundTask) lastBg = i;
+    }
+    if (lastBg <= fromIdx) return -1;
+    return lastBg;
+  }
+  /** The staged turn's files are up; it is now just waiting its place in the
+   *  queue. Drops the "(Uploading files...)" note back to "(In queue)". */
+  markStagedMessageQueued(stageId) {
+    var idx = this._stageIndex(this.state.messages, stageId);
+    if (idx === -1) return;
+    var ex = this.state.messages[idx];
+    if (!ex.isUploadingAttachments) return;
+    this.state.messages[idx] = Object.assign({}, ex, { isUploadingAttachments: false });
+    this.host.notify();
+  }
+  /**
+   * Resolves once this project's background-indexing queue has nothing left to
+   * run, so a chat enqueued right after it is genuinely last.
+   *
+   * Sending the chat as soon as the uploads finish is not enough, which is the
+   * whole reason this exists: indexing a file is a CHAIN, and each pass is only
+   * enqueued once the previous one lands (the client mints CONTINUE passes for
+   * text/grid files, the worker mints them for PDFs and windowed reads). Every
+   * one of those passes therefore queues up BEHIND a chat sent at upload time,
+   * and the model answers from a file it has only partly read.
+   *
+   * The queue is read from the server's status index rather than from
+   * bgTaskQueue: that mirror holds only what this client dispatched or adopted,
+   * and it stops being maintained once the view unmounts. An empty answer has to
+   * repeat before it is believed — see INDEXING_DRAIN_IDLE_LOOKS — and a look
+   * that fails counts as busy, so a dropped request delays the turn instead of
+   * releasing it early.
+   *
+   * Reads the identity PINNED at Send time, never a live one: the user may be in
+   * another project by now, and this must keep asking about the one they sent
+   * from.
+   */
+  awaitIndexingDrained(identity) {
+    var self = this;
+    var svcId = identity && identity.serviceId;
+    var platform = identity && identity.platform;
+    if (!svcId || platform !== "claude" && platform !== "openai") return Promise.resolve("skipped");
+    var owner = identity.owner;
+    var queue = bgIndexingQueueName(identity.userId, svcId);
+    var startedAt = nowMs();
+    var deadline = startedAt + INDEXING_DRAIN_TIMEOUT_MS;
+    var idleLooks = 0;
+    var ask = function(status) {
+      return Promise.resolve(getChatHistory(
+        { service: svcId, owner, platform, queue, status },
+        { limit: WORKER_PASS_ADOPT_LIMIT }
+      )).catch(function() {
+        return null;
+      });
+    };
+    var hasLiveIndexing = function(res) {
+      var list = res && Array.isArray(res.list) ? res.list : [];
+      for (var i = 0; i < list.length; i++) {
+        var item = list[i];
+        if (!item || item.status !== "pending" && item.status !== "running") continue;
+        if (isIndexingRequestText(extractLastUserTextFromRequest(item.request_body))) return true;
+      }
+      return false;
+    };
+    return new Promise(function(resolve) {
+      var again = function() {
+        setTimeout(look, idleLooks > 0 ? INDEXING_DRAIN_CONFIRM_POLL_MS : INDEXING_DRAIN_BUSY_POLL_MS);
+      };
+      var look = function() {
+        if (nowMs() >= deadline) {
+          resolve("timedout");
+          return;
+        }
+        if (self._indexDispatchesInFlight > 0) {
+          idleLooks = 0;
+          again();
+          return;
+        }
+        Promise.all([ask("running"), ask("pending")]).then(function(res) {
+          var unknown = res[0] === null || res[1] === null;
+          if (unknown || hasLiveIndexing(res[0]) || hasLiveIndexing(res[1])) idleLooks = 0;
+          else idleLooks += 1;
+          if (idleLooks >= INDEXING_DRAIN_IDLE_LOOKS && nowMs() - startedAt >= INDEXING_DRAIN_MIN_MS) {
+            resolve("drained");
+            return;
+          }
+          again();
+        }, function() {
+          idleLooks = 0;
+          again();
+        });
+      };
+      look();
+    });
+  }
+  /**
+   * Abandon a staged turn — its uploads failed outright, so nothing will be
+   * dispatched. The bubble stays (the user's text is not silently thrown away)
+   * but settles into a plain, non-pending message; the caller reports the
+   * failure separately.
+   */
+  settleStagedMessage(stageId) {
+    var idx = this._stageIndex(this.state.messages, stageId);
+    if (idx === -1) return;
+    var ex = this.state.messages[idx];
+    var settled = { role: "user", content: ex.content };
+    if (ex._ownerKey !== void 0) settled._ownerKey = ex._ownerKey;
+    if (ex._ts !== void 0) settled._ts = ex._ts;
+    this.state.messages[idx] = settled;
+    this.host.notify();
+    this.updateHistoryCache();
+  }
   // composed = clean display text; composedForLlm carries office-extraction
   // placeholders for the provider only. useBgQueue routes a post-attachment turn
   // onto the "-bg" queue so it runs after indexing.
   dispatchComposedMessage(composed, useBgQueue, composedForLlm, extractContent, fileUrls, pinned) {
     var self = this;
-    if (!composed) return;
+    var stageId = pinned ? pinned.stageId : void 0;
+    if (!composed) {
+      if (stageId) this.settleStagedMessage(stageId);
+      return;
+    }
     var id = pinned ? pinned.identity : this.host.getIdentity();
-    if (id.platform === "none") return;
+    if (id.platform === "none") {
+      if (stageId) this.settleStagedMessage(stageId);
+      return;
+    }
     var llmComposed = composedForLlm || composed;
     var key = !id.serviceId ? "" : id.serviceId + "#" + id.platform;
     var offChat = !!key && key !== this.getHistoryCacheKey();
@@ -1987,10 +2370,10 @@ var ChatSession = class {
     var aiModel = id.model || void 0;
     var systemPrompt = pinned ? pinned.systemPrompt : this.host.buildSystemPrompt();
     var userId = id.userId || id.serviceId;
-    var chatQueue = useBgQueue ? userId + BG_INDEXING_QUEUE_SUFFIX : userId;
+    var chatQueue = useBgQueue ? bgIndexingQueueName(userId) : userId;
     if (offChat) {
       var offHistory = (this.aiChatHistoryCache[key] ? this.aiChatHistoryCache[key].messages : []).filter(function(m) {
-        return !m.isPending && !m.isPendingQueued && !m.isPendingInProcess && !m.isPendingOlder && !m.isCancelled && !m.isBackgroundTask;
+        return !m.isPending && !m.isPendingQueued && !m.isPendingInProcess && !m.isPendingOlder && !m.isCancelled && !m.isBackgroundTask && !m.isError;
       });
       var offBounded = buildBoundedChatMessages({
         platform: aiPlatform,
@@ -2000,9 +2383,16 @@ var ChatSession = class {
         history: offHistory.concat([{ role: "user", content: llmComposed }])
       });
       var offExisting = this.aiChatHistoryCache[key] || { messages: [], endOfList: false, startKeyHistory: [] };
+      var offUser = { role: "user", content: composed, _ownerKey: key, _ts: wallClockNow() };
+      var offStage = this._stageIndex(this.state.messages, stageId);
+      if (offStage !== -1) {
+        if (this.state.messages[offStage]._ts !== void 0) offUser._ts = this.state.messages[offStage]._ts;
+        this.state.messages.splice(offStage, 1);
+        this.host.notify();
+      }
       this.aiChatHistoryCache[key] = {
         messages: offExisting.messages.concat([
-          { role: "user", content: composed, _ownerKey: key, _ts: wallClockNow() },
+          offUser,
           { role: "assistant", content: "", isPending: true, isPendingInProcess: true, _ownerKey: key }
         ]),
         endOfList: offExisting.endOfList,
@@ -2025,7 +2415,7 @@ var ChatSession = class {
     }
     if (isQueuedSend) {
       var resolvedHistory = this.state.messages.filter(function(m) {
-        return !m.isPending && !m.isPendingQueued && !m.isPendingInProcess && !m.isPendingOlder && !m.isCancelled && !m.isBackgroundTask;
+        return !m.isPending && !m.isPendingQueued && !m.isPendingInProcess && !m.isPendingOlder && !m.isCancelled && !m.isBackgroundTask && !m.isError;
       });
       var boundedQ = buildBoundedChatMessages({
         platform: aiPlatform,
@@ -2037,14 +2427,26 @@ var ChatSession = class {
       var queuedBubble = { role: "user", content: composed, isPendingQueued: true, isSendingToServer: true, _ts: wallClockNow() };
       if (key) queuedBubble._ownerKey = key;
       if (useBgQueue) queuedBubble._useBgQueue = true;
-      this.state.messages.push(queuedBubble);
+      var qStage = this._stageIndex(this.state.messages, stageId);
+      if (qStage !== -1) {
+        if (this.state.messages[qStage]._ts !== void 0) queuedBubble._ts = this.state.messages[qStage]._ts;
+        var qTarget = this._settledStagePosition(qStage);
+        if (qTarget === -1) {
+          this.state.messages.splice(qStage, 1, queuedBubble);
+        } else {
+          this.state.messages.splice(qStage, 1);
+          this.state.messages.splice(qTarget, 0, queuedBubble);
+        }
+      } else {
+        this.state.messages.push(queuedBubble);
+      }
       this.host.notify();
       this.updateHistoryCache();
       this.host.scrollToBottom(true);
       var capturedComposed = composed, capturedPlatform = aiPlatform, capturedKey = key;
       Promise.resolve(this._callProviderFor(aiPlatform, composed, boundedQ.messages, systemPrompt, aiModel, chatQueue, extractContent, fileUrls, id.serviceId, id.owner)).then(function(result) {
         var sendingIdx = self.getHistoryCacheKey() !== capturedKey ? -1 : self.state.messages.findIndex(function(m) {
-          return m.isSendingToServer && (m.isPendingQueued || m.isPendingInProcess) && m.role === "user" && (m._ownerKey === void 0 || m._ownerKey === capturedKey);
+          return m.isSendingToServer && (m.isPendingQueued || m.isPendingInProcess) && m.role === "user" && !m._stageId && (m._ownerKey === void 0 || m._ownerKey === capturedKey);
         });
         var serverId = result && typeof result.id === "string" ? result.id : void 0;
         if (sendingIdx >= 0) {
@@ -2069,23 +2471,31 @@ var ChatSession = class {
       });
       return;
     }
-    this.state.messages.push({ role: "user", content: composed, _ts: wallClockNow(), ...key ? { _ownerKey: key } : {} });
-    this.state.messages.push({ role: "assistant", content: "", isPending: true, isPendingInProcess: true, ...key ? { _ownerKey: key } : {} });
+    var immediateUser = { role: "user", content: composed, _ts: wallClockNow(), ...key ? { _ownerKey: key } : {} };
+    var immediatePlaceholder = { role: "assistant", content: "", isPending: true, isPendingInProcess: true, ...key ? { _ownerKey: key } : {} };
+    var iStage = this._stageIndex(this.state.messages, stageId);
+    if (iStage !== -1) {
+      if (this.state.messages[iStage]._ts !== void 0) immediateUser._ts = this.state.messages[iStage]._ts;
+      var iTarget = this._settledStagePosition(iStage);
+      if (iTarget === -1) {
+        this.state.messages.splice(iStage, 1, immediateUser, immediatePlaceholder);
+      } else {
+        this.state.messages.splice(iStage, 1);
+        this.state.messages.splice(iTarget, 0, immediateUser, immediatePlaceholder);
+      }
+    } else {
+      this.state.messages.push(immediateUser);
+      this.state.messages.push(immediatePlaceholder);
+    }
     this.host.notify();
     this.updateHistoryCache();
     this.state.sending = true;
     this.host.scrollToBottom(true);
     var historyForLlm = this.state.messages.filter(function(m) {
-      return !m.isCancelled && !m.isBackgroundTask;
+      if (m === immediateUser) return false;
+      return !m.isPending && !m.isPendingQueued && !m.isPendingInProcess && !m.isPendingOlder && !m.isCancelled && !m.isBackgroundTask && !m.isError;
     });
-    if (llmComposed !== composed) {
-      for (var li = historyForLlm.length - 1; li >= 0; li--) {
-        if (historyForLlm[li].role === "user" && historyForLlm[li].content === composed) {
-          historyForLlm[li] = Object.assign({}, historyForLlm[li], { content: llmComposed });
-          break;
-        }
-      }
-    }
+    historyForLlm.push({ role: "user", content: llmComposed });
     var bounded = buildBoundedChatMessages({
       platform: aiPlatform,
       model: aiModel,
@@ -2326,7 +2736,7 @@ var ChatSession = class {
     if (platform !== "claude" && platform !== "openai") return;
     var url = platform === "claude" ? ANTHROPIC_MESSAGES_API_URL : OPENAI_RESPONSES_API_URL;
     var queueBase = id.userId || id.serviceId;
-    var queue = msg.isBackgroundTask || msg._useBgQueue ? queueBase + BG_INDEXING_QUEUE_SUFFIX : queueBase;
+    var queue = msg.isBackgroundTask || msg._useBgQueue ? bgIndexingQueueName(queueBase) : queueBase;
     this.state.messages[idx] = Object.assign({}, msg, { _cancelling: true, _cancelError: void 0 });
     this.host.notify();
     Promise.resolve(this.host.cancelRequest({
@@ -2812,7 +3222,7 @@ var ChatSession = class {
     if (!id.serviceId || platform !== "claude" && platform !== "openai") return;
     if (this.isPollingPaused() || !this.host.isViewMounted()) return;
     var svcId = id.serviceId, owner = id.owner;
-    var queue = (id.userId || id.serviceId) + BG_INDEXING_QUEUE_SUFFIX;
+    var queue = bgIndexingQueueName(id.userId, id.serviceId);
     var ask = function(status) {
       return Promise.resolve(getChatHistory(
         { service: svcId, owner, platform, queue, status },
@@ -2914,7 +3324,7 @@ var ChatSession = class {
       url,
       method: "POST",
       id: serverId,
-      queue: (id.userId || id.serviceId) + BG_INDEXING_QUEUE_SUFFIX,
+      queue: bgIndexingQueueName(id.userId, id.serviceId),
       service: id.serviceId,
       owner: id.owner
     })).catch(function() {
@@ -3043,7 +3453,7 @@ var ChatSession = class {
       if (pass > MAX_INDEXING_RESUME_PASSES) return;
       var id = this.host.getIdentity();
       if (!id || id.platform === "none" || id.serviceId !== entry.serviceId) return;
-      notifyAgentContinueIndexing({
+      this.trackIndexDispatch(notifyAgentContinueIndexing({
         platform: id.platform,
         model: id.model,
         service: id.serviceId,
@@ -3077,7 +3487,7 @@ var ChatSession = class {
         }
       }, function(e) {
         console.error("[chat-engine] resume-indexing dispatch failed", e);
-      });
+      }));
     } catch (e) {
     }
   }
@@ -3155,6 +3565,10 @@ var ChatSession = class {
           if (mm._ownerKey !== void 0 && mm._ownerKey !== loadKey) continue;
           if (mm._serverItemId && serverIds[mm._serverItemId]) continue;
           if (!mm._serverItemId) {
+            if (mm._stageId) {
+              rescued.push(mm);
+              continue;
+            }
             if (mappedHasPendingAssistant) continue;
             if (mm.isSendingToServer || mm.isPendingQueued || mm.isPendingInProcess || mm.isPending) rescued.push(mm);
             else if (self.state.sending && mm.role === "user") {
@@ -3374,7 +3788,7 @@ var ChatSession = class {
           return preIndex.then(function() {
             return parseAttachmentContent(member.file, member.file.name, mime || void 0);
           }).then(function(parsedContent) {
-            return notifyAgentSaveAttachment({
+            return self.trackIndexDispatch(notifyAgentSaveAttachment({
               platform: id.platform,
               model: id.model,
               service: id.serviceId,
@@ -3413,7 +3827,7 @@ var ChatSession = class {
                 att.errorCode = e && (e.code || e.body && e.body.code) || "";
                 att.errorDetail = e && (e.message || e.body && e.body.message) || (typeof e === "string" ? e : "");
               }
-            });
+            }));
           });
         });
       });
@@ -3432,14 +3846,24 @@ var ChatSession = class {
   }
   // Upload all not-yet-done attachments sequentially. Resolves to the full
   // list of { name, url, storagePath } for composing the chat message.
-  uploadPendingAttachments() {
+  //
+  // `batchId` scopes the run to the chips stamped with it at Send time. The
+  // composer stays live during an upload, so by the time this runs the
+  // attachment list can already hold chips the user picked for the NEXT
+  // message — uploading those here would attach them to the wrong turn, and
+  // collecting the previous batch's finished urls would attach files the user
+  // already sent. Omitted (no batch) means every chip, the old behavior.
+  uploadPendingAttachments(batchId) {
     var self = this;
     this.host.resetOverwriteBatch();
+    this._uploadBatches += 1;
     this.state.uploadingAttachments = true;
     this.host.updateComposerControls();
     this.host.renderAttachmentChips();
     var collected = [];
-    var snapshot = this.state.attachments.slice();
+    var snapshot = this.state.attachments.filter(function(a) {
+      return batchId ? a._batchId === batchId : true;
+    });
     var chain = Promise.resolve();
     snapshot.forEach(function(att) {
       chain = chain.then(function() {
@@ -3475,7 +3899,8 @@ var ChatSession = class {
       });
     });
     var done = function() {
-      self.state.uploadingAttachments = false;
+      self._uploadBatches = Math.max(0, self._uploadBatches - 1);
+      self.state.uploadingAttachments = self._uploadBatches > 0;
       self.host.updateComposerControls();
       self.host.renderAttachmentChips();
       return collected;
@@ -3682,6 +4107,8 @@ function buildChatDisplayList(messages, opts) {
 }
 
 exports.BG_INDEXING_QUEUE_SUFFIX = BG_INDEXING_QUEUE_SUFFIX;
+exports.BOM = BOM;
+exports.BOM_EXTS = BOM_EXTS;
 exports.CLAUDE_INPUT_CAP_RATIO = CLAUDE_INPUT_CAP_RATIO;
 exports.CLAUDE_PER_REQUEST_INPUT_CAP = CLAUDE_PER_REQUEST_INPUT_CAP;
 exports.CONTEXT_WINDOW_BY_MODEL = CONTEXT_WINDOW_BY_MODEL;
@@ -3692,9 +4119,12 @@ exports.DEFAULT_OPENAI_MODEL = DEFAULT_OPENAI_MODEL;
 exports.EXPIRED_ATTACHMENT_URL_HOST = EXPIRED_ATTACHMENT_URL_HOST;
 exports.EXPIRED_ATTACHMENT_URL_ORIGIN = EXPIRED_ATTACHMENT_URL_ORIGIN;
 exports.EXPIRED_LINK_REFRESH_EXPIRES_SECONDS = EXPIRED_LINK_REFRESH_EXPIRES_SECONDS;
+exports.EXT_CONTENT_TYPES = EXT_CONTENT_TYPES;
 exports.HISTORY_BUDGET_RATIO = HISTORY_BUDGET_RATIO;
 exports.HISTORY_FILL_SLACK_PX = HISTORY_FILL_SLACK_PX;
 exports.HISTORY_TOKEN_BUDGET = HISTORY_TOKEN_BUDGET;
+exports.HTML_EXTS = HTML_EXTS;
+exports.HTML_HEAD_WINDOW = HTML_HEAD_WINDOW;
 exports.LINK_LABEL_MAX_DISPLAY_CHARS = LINK_LABEL_MAX_DISPLAY_CHARS;
 exports.LINK_REFRESH_WINDOW_MS = LINK_REFRESH_WINDOW_MS;
 exports.MAX_HISTORY_FILL_PAGES = MAX_HISTORY_FILL_PAGES;
@@ -3705,7 +4135,11 @@ exports.MIN_INPUT_TOKEN_BUDGET = MIN_INPUT_TOKEN_BUDGET;
 exports.OUTPUT_TOKEN_RESERVE = OUTPUT_TOKEN_RESERVE;
 exports.POLL_INTERVAL = POLL_INTERVAL;
 exports.RENDER_FROM_TOKEN = RENDER_FROM_TOKEN;
+exports.RTF_EXTS = RTF_EXTS;
 exports.TOOL_AND_RESPONSE_BUFFER = TOOL_AND_RESPONSE_BUFFER;
+exports.XML_EXTS = XML_EXTS;
+exports.applyEncodingDeclaration = applyEncodingDeclaration;
+exports.bgIndexingQueueName = bgIndexingQueueName;
 exports.buildAiAgentValue = buildAiAgentValue;
 exports.buildBoundedChatMessages = buildBoundedChatMessages;
 exports.buildChatDisplayList = buildChatDisplayList;
@@ -3725,11 +4159,17 @@ exports.classifyInlineLink = classifyInlineLink;
 exports.clearAttachmentParsers = clearAttachmentParsers;
 exports.composeUserMessage = composeUserMessage;
 exports.configureChatEngine = configureChatEngine;
+exports.contentTypeForExt = contentTypeForExt;
 exports.createHistoryFiller = createHistoryFiller;
 exports.createInlineLinkRegex = createInlineLinkRegex;
 exports.encodePathSegments = encodePathSegments;
+exports.encodingClassForExt = encodingClassForExt;
+exports.ensureHtmlCharset = ensureHtmlCharset;
+exports.ensureXmlEncoding = ensureXmlEncoding;
+exports.escapeRtfNonAscii = escapeRtfNonAscii;
 exports.estimateMessageTokens = estimateMessageTokens;
 exports.estimateTextTokens = estimateTextTokens;
+exports.extOf = extOf;
 exports.extractClaudeText = extractClaudeText;
 exports.extractLastUserTextFromRequest = extractLastUserTextFromRequest;
 exports.extractOpenAIText = extractOpenAIText;
@@ -3745,6 +4185,7 @@ exports.getErrorMessage = getErrorMessage;
 exports.getExpiredAttachmentVisiblePath = getExpiredAttachmentVisiblePath;
 exports.getProjectContextWindow = getProjectContextWindow;
 exports.groupAttachmentFailures = groupAttachmentFailures;
+exports.hasBom = hasBom;
 exports.isAuthExpiredError = isAuthExpiredError;
 exports.isBgIndexingQueue = isBgIndexingQueue;
 exports.isErrorResponseBody = isErrorResponseBody;
@@ -3756,9 +4197,12 @@ exports.isServerExtractable = isServerExtractable;
 exports.isServiceDbAttachmentHref = isServiceDbAttachmentHref;
 exports.listClaudeModels = listClaudeModels;
 exports.listOpenAIModels = listOpenAIModels;
+exports.looksLikeRtf = looksLikeRtf;
 exports.makeExtractPlaceholder = makeExtractPlaceholder;
 exports.mapHistoryListToMessages = mapHistoryListToMessages;
+exports.needsBomForExt = needsBomForExt;
 exports.normalizeAttachmentPathCandidate = normalizeAttachmentPathCandidate;
+exports.normalizeExt = normalizeExt;
 exports.normalizeTextContent = normalizeTextContent;
 exports.normalizeTrailingInlineToken = normalizeTrailingInlineToken;
 exports.notifyAgentSaveAttachment = notifyAgentSaveAttachment;
@@ -3766,6 +4210,7 @@ exports.parseAiAgentValue = parseAiAgentValue;
 exports.parseAttachmentContent = parseAttachmentContent;
 exports.parseIndexingLabel = parseIndexingLabel;
 exports.parseIndexingRequestText = parseIndexingRequestText;
+exports.prepareDownloadText = prepareDownloadText;
 exports.readExpiredAttachmentHref = readExpiredAttachmentHref;
 exports.registerAttachmentParser = registerAttachmentParser;
 exports.registerModelContextWindows = registerModelContextWindows;