bunnyquery 1.5.7 → 1.6.2

package/dist/engine.cjs

@@ -61,6 +61,9 @@ function chatEngineConfig() {
   }
   return _config;
 }
+function windowedIndexingEnabled() {
+  return _config?.windowedIndexing === true;
+}
 function pollOpt() {
   const p = _config?.poll;
   return p === void 0 ? {} : { poll: p };
@@ -155,19 +158,65 @@ function isServerExtractable(name, mime) {
   return m.includes("officedocument") || m.includes("opendocument") || m.includes("hwp") || m.includes("epub") || m === "application/msword" || m === "application/vnd.ms-excel" || m === "application/vnd.ms-powerpoint";
 }
 var isOfficeFile = isServerExtractable;
-var PAGED_READ_EXTENSIONS = /* @__PURE__ */ new Set(["xls", "xlsx", "xlsm", "ods", "pdf"]);
+var PAGED_READ_EXTENSIONS = /* @__PURE__ */ new Set([
+  // grids
+  "xls",
+  "xlsx",
+  "xlsm",
+  "ods",
+  // delimited text (row-windowed by the layer)
+  "csv",
+  "tsv",
+  "tab",
+  // documents
+  "pdf",
+  "docx",
+  "pptx",
+  // plain text / data / markup
+  "txt",
+  "md",
+  "markdown",
+  "log",
+  "json",
+  "jsonl",
+  "ndjson",
+  "xml",
+  "yaml",
+  "yml"
+]);
 function isPagedReadFile(name, mime) {
   const ext = (name || "").split(".").pop()?.toLowerCase() || "";
   if (PAGED_READ_EXTENSIONS.has(ext)) return true;
   const m = (mime || "").toLowerCase();
   return m === "application/pdf" || m === "application/vnd.ms-excel" || m.includes("spreadsheetml") || m.includes("opendocument.spreadsheet");
 }
+function isImageVisionFile(name, mime) {
+  const ext = (name || "").split(".").pop()?.toLowerCase() || "";
+  return ext === "pdf" || (mime || "").toLowerCase() === "application/pdf";
+}
 var _extractPlaceholderSeq = 0;
 function makeExtractPlaceholder(seed) {
   _extractPlaceholderSeq += 1;
   const slug = (seed || "file").replace(/[^a-zA-Z0-9]+/g, "_").slice(-48);
   return `{{SKAPI_FILE_CONTENT::${slug}-${_extractPlaceholderSeq}}}`;
 }
+var _renderPlaceholderSeq = 0;
+function makeRenderPlaceholder(seed) {
+  _renderPlaceholderSeq += 1;
+  const slug = (seed || "file").replace(/[^a-zA-Z0-9]+/g, "_").slice(-48);
+  return `{{SKAPI_RENDER::${slug}-${_renderPlaceholderSeq}}}`;
+}
+var RENDER_PAGES_PER_WINDOW = 5;
+var _windowPlaceholderSeq = 0;
+function makeWindowPlaceholder(seed) {
+  _windowPlaceholderSeq += 1;
+  const slug = (seed || "file").replace(/[^a-zA-Z0-9]+/g, "_").slice(-48);
+  return `{{SKAPI_WINDOW::${slug}-${_windowPlaceholderSeq}}}`;
+}
+function isWindowedReadFile(name, mime) {
+  if (isImageVisionFile(name, mime)) return false;
+  return isPagedReadFile(name, mime);
+}
 function composeUserMessage(text, attachmentUrls) {
   let composed = text;
   if (attachmentUrls.length > 0) {
@@ -265,12 +314,14 @@ function buildIndexingSystemPrompt(params) {
   let systemPrompt = `You are a background indexing agent for project ${service}.
 - 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 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 been extracted on the server and included inline in the user message between the "BEGIN FILE CONTENT" / "END FILE CONTENT" markers - read that directly. If the inline content is a "[skapi: ...]" note, the file could not be extracted - index it from its metadata only.
-- BIG or SCANNED files: the inline content may be only the FIRST part of a large file (it can end with a truncation or "more remains" note), and scanned PDFs / files with embedded photos are not fully captured inline. In those cases READ THE FILE WITH THE readFileContent TOOL: it returns the file ONE WINDOW at a time (spreadsheets as coordinate-tagged grid rows, scanned/large PDFs as rendered PAGE IMAGES, text as a range of characters). Pass the file's storage path. After each window: datafy it into records and SAVE them, THEN if the window says MORE REMAINS call readFileContent again with the cursor it gives you. Repeat until it says END OF FILE, so the WHOLE file is indexed - never stop after the first window.
-- VISION: when a readFileContent window (or an inline attachment) includes IMAGES - scanned PDF pages, or photos embedded in a spreadsheet next to a row/block - LOOK at them and capture what they show as record data (the reading/values in a scanned table, the part/defect/condition visible in a photo). The image IS part of the data; correlate each photo with its labelled block ("PHOTO A3" markers tie a photo to that grid row).
+- BIG SPREADSHEETS / TEXT: the inline content may be only the FIRST part of a large file (it can end with a truncation or "more remains" note). For big spreadsheets and big text/data files READ THE FILE WITH THE readFileContent TOOL: it returns the file ONE WINDOW at a time (spreadsheets as coordinate-tagged grid rows, text as a range of characters). Pass the file's storage path. After each window: datafy it into records and SAVE them, THEN if the window says MORE REMAINS call readFileContent again with the cursor it gives you. Repeat until it says END OF FILE, so the WHOLE file is indexed - never stop after the first window. (Do NOT call readFileContent on a PDF - see the next line.)
+- PDFs (scanned or not): you do NOT read a PDF with a tool or a URL. Its pages are RENDERED and embedded directly in the user message as IMAGE blocks, a WINDOW of pages at a time. LOOK at the embedded page images and datafy every one. The note beside them tells you whether MORE pages remain: if so, save this window's records and stop (a follow-up pass shows the next window automatically); only when the note says it was the LAST window is the PDF fully seen. Do NOT call readFileContent or web_fetch for a PDF.
+- VISION: when the message (a readFileContent window, an embedded PDF page, or an inline attachment) includes IMAGES - scanned/rendered PDF pages, or photos embedded in a spreadsheet next to a row/block - LOOK at them and capture what they show as record data (the reading/values in a scanned table, the part/defect/condition visible in a photo). The image IS part of the data; correlate each photo with its labelled block ("PHOTO A3" markers tie a photo to that grid row).
 - Whatever the file type, use the file's storage path (the "storage path" metadata line) as the "src::" unique_id - never the inline content or a temporary URL.
 - TABULAR data (any spreadsheet - .csv/.tsv/.xlsx/.xls/.ods, or sheet-like rows): you MUST save EVERY data row as its own record (ONE record per row) with that row's actual column values in the record's "data", keyed by the header names, in a dedicated table (e.g. "spreadsheet_rows"). Do NOT summarize, sample only a few rows, or save just file metadata - index the whole sheet, paging through it with readFileContent when it is large. Make MULTIPLE postRecords calls in batches (e.g. 30-50 rows per call) rather than one oversized call. This per-row completeness OVERRIDES brevity. ALSO save one file-level summary record (file name, sheet name(s), column headers, total row count, overall summary) - this is the record that carries the file's "src::" unique_id - and link EVERY per-row record to it via reference (set each row record's reference to that src:: file record; the row records themselves do NOT carry a src:: unique_id). The per-row records AND this reference linkage are BOTH mandatory: the linkage is what lets the whole sheet be found and cleaned up together when the file is re-indexed.
 - EPUB / e-books / long-form books (.epub or any book-length prose, provided inline in reading order with chapter headings preserved): you MUST save ONE record per CHAPTER (or, when chapters are unclear, per major section/topic) in a dedicated table (e.g. "book_chapters") - never collapse the whole book into a single record. Each chapter record's "data" must capture the chapter title plus its order/number AND a substantive summary of that chapter's content (key events, arguments, characters, places, concepts, terms, notable quotes). Apply AS MANY relevant tags as possible to EVERY chapter record (characters, locations, themes, topics, key concepts, key terms, dates, named entities) so the book is easy to SEARCH and cross-reference later - this is the whole point. ALSO save one book-level record (title, author, language, overall summary, chapter list / table of contents, genre/subjects) and link each chapter record to it via reference. This per-chapter completeness OVERRIDES brevity; human-readable summaries only, never raw/binary bytes.
-- This is a background indexing task: do ALL the MCP saving FIRST, never reply mid-task, and never ask the user questions. Always use the MCP tools to save what you learn - be exhaustive about meaning (and, for tabular data, about every row). SAVE AS YOU GO: persist each window's records before reading the next, so progress is never lost. If the file is so large you cannot finish in one turn, still save everything you have read so far and note the last cursor/page you reached; a follow-up will continue from there. Never store raw or binary bytes (base64, blobs); describe them in human-readable text instead.
+- This is a background indexing task: do ALL the MCP saving FIRST, never reply mid-task, and never ask the user questions. Always use the MCP tools to save what you learn - be exhaustive about meaning (and, for tabular data, about every row). SAVE AS YOU GO: persist each window's records before reading the next, so progress is never lost. If the file is so large you cannot finish in one turn, still save everything you have read so far; a follow-up pass will automatically continue from where you stopped. Never store raw or binary bytes (base64, blobs); describe them in human-readable text instead.
+- COMPLETION SIGNAL: only when you have fully read and saved the ENTIRE file (for readFileContent files: reached "END OF FILE"; for PDFs: the embedded page-image note said it was the LAST window - with all rows/pages/items saved), end your final message with the token INDEXING_COMPLETE on its own line. If you did NOT finish the whole file (more rows/pages remain), do NOT write that token - leaving it out is how the system knows to run another pass to continue.
 - Only AFTER every save is done, send exactly ONE final message summarizing what you indexed - never just "Indexing complete", and never a raw/base64/binary value or a large pasted dump. Keep it to a few factual sentences or a short markdown bullet list covering: the file name, its content type, each table you wrote to with its record/row count and the key columns/fields or topics captured, and anything that could not be extracted. Follow this shape - Indexed <file name> (<content type>): saved <N> records to <table(s)> capturing <key columns/fields or topics>; could not extract: <gaps, or none>.`;
   if (serviceDescription) {
     systemPrompt += `
@@ -313,6 +364,74 @@ Read this file with the readFileContent tool, using the storage path above - do
   }
   return head + `- temporary URL (fetch this to read the file contents): ${attachment.url}`;
 }
+var RENDER_FROM_TOKEN = "{{RENDER_FROM}}";
+var WINDOW_CURSOR_TOKEN = RENDER_FROM_TOKEN;
+function buildIndexingRenderMessage(attachment, placeholder, renderFrom) {
+  const from = Math.max(0, renderFrom || 0);
+  if (from > 0) return buildIndexingRenderContinueTemplate(attachment, placeholder, String(from + 1));
+  return `A new file has just been uploaded. Index it now.
+
+` + buildRenderMeta(attachment) + `
+This is a PDF. Its pages are delivered to you as RENDERED PAGE IMAGES embedded directly in this message (you do NOT need any tool, URL, or web_fetch to see them). You are shown a WINDOW of pages at a time, starting at page ${from + 1}.
+` + buildRenderDatafy(placeholder);
+}
+function buildIndexingRenderContinueTemplate(attachment, placeholder, pageLabel = RENDER_FROM_TOKEN) {
+  const src = `src::${attachment.storagePath}`;
+  return `CONTINUE indexing a PDF whose previous pass did not finish.
+
+` + buildRenderMeta(attachment) + `
+Records for the earlier pages are ALREADY saved (they reference "${src}"). The NEXT window of rendered page images (starting at page ${pageLabel}) is embedded in this message. Datafy each page as before and do NOT re-save pages that are already saved.
+` + buildRenderDatafy(placeholder);
+}
+function buildRenderMeta(attachment) {
+  return `File metadata:
+- name: ${attachment.name}
+- storage path: ${attachment.storagePath}
+` + (attachment.mime ? `- mime type: ${attachment.mime}
+` : "");
+}
+function buildRenderDatafy(placeholder) {
+  return `
+${placeholder}
+
+LOOK at each rendered page image in this message and DATAFY what it shows: for EVERY page call postRecords and save records - one record per row / table entry / line item visible on the page (or one record for the page if it is prose), capturing every value you can read (OCR the text, read tables cell by cell, describe any photos/diagrams). Use the storage path above for the "src::" unique_id.
+
+Save records for THIS window of pages only, then stop and report what you saved. Do NOT try to read the rest of the file and do NOT worry about the pages after this window: if any remain, the next window is rendered and sent to you automatically. Report only the pages you were actually shown - never imply you have seen the whole document.`;
+}
+function buildIndexingWindowMessage(attachment, placeholder, isContinuation, positionLabel) {
+  const src = `src::${attachment.storagePath}`;
+  const head = isContinuation ? `CONTINUE indexing a file whose previous pass did not finish.
+
+` : `A new file has just been uploaded. Index it now.
+
+`;
+  const where = isContinuation ? `
+Records for the earlier windows are ALREADY saved (they reference "${src}"). The NEXT window (starting at ${positionLabel || WINDOW_CURSOR_TOKEN}) is embedded below. Do NOT re-save windows that are already saved.
+` : `
+This file is delivered to you ONE WINDOW at a time, embedded directly in this message. You do NOT need any tool, URL, or web_fetch to read it.
+`;
+  return head + buildRenderMeta(attachment) + where + `
+${placeholder}
+
+DATAFY this window: call postRecords and save records for everything in it - ONE RECORD PER ROW for tabular data (keyed by the column headers), or one record per section for prose. Capture every value you can read. Use the storage path above for the "src::" unique_id on the file-level record, and link every row/section record to it by reference.
+
+Save records for THIS window only, then stop and report what you saved. Do NOT try to read the rest of the file, and do NOT call readFileContent - if more remains, the next window is read and sent to you automatically. Report only what you were actually shown, and never imply you have seen the whole file when the note beside the window says more remains.`;
+}
+function buildIndexingContinueMessage(attachment) {
+  const src = `src::${attachment.storagePath}`;
+  return `CONTINUE indexing a file whose previous pass did not finish.
+
+File metadata:
+- name: ${attachment.name}
+- storage path: ${attachment.storagePath}
+` + (attachment.mime ? `- mime type: ${attachment.mime}
+` : "") + `
+Records for the earlier windows/pages of this file are ALREADY saved (they reference "${src}"). First call getRecords with reference "${src}" to see how far the previous pass got (the furthest page/row/window already saved). Then call readFileContent with the storage path above and a CURSOR that RESUMES just after that point - do NOT start at the beginning. The cursor is derivable from what you already saved:
+  - PDF: the cursor is the NUMBER OF PAGES already read (0-based next page). If you saved up to page N, call readFileContent with cursor="N" to get page N+1 onward.
+  - Spreadsheet: the cursor is "<sheetIndex>:<nextRow>" (0-based sheet index, 1-based row). If you saved up to row R of sheet S, use cursor="S:R+1".
+  - Text: the cursor is the character offset already read.
+Index the REMAINING windows - one record per row/item, looking at any page images or embedded photos - saving as you go until readFileContent reports END OF FILE. Do NOT re-save windows that are already saved. Use the storage path above for the "src::" unique_id. When the ENTIRE file is finally indexed, end your message with the token INDEXING_COMPLETE.`;
+}
 
 // src/engine/errors.ts
 function getErrorMessage(input) {
@@ -569,19 +688,22 @@ var mcpUrl = () => chatEngineConfig().mcpBaseUrl;
 var clientSecretRequest = (opts) => chatEngineConfig().clientSecretRequest(opts);
 var getOpenAIImageDetail = (model) => {
   const normalized = (model || DEFAULT_OPENAI_MODEL).trim().toLowerCase();
-  const match = normalized.match(/^gpt-(\d+)(?:\.(\d+))?$/);
+  const match = normalized.match(/^gpt-(\d+)(?:\.(\d+))?(-[a-z0-9.\-]+)?$/);
   if (!match) {
     return DEFAULT_OPENAI_IMAGE_DETAIL;
   }
   const major = Number(match[1]);
   const minor = match[2] === void 0 ? null : Number(match[2]);
-  if (major > 5) {
-    return "original";
-  }
-  if (major === 5 && minor !== null && minor >= 4) {
-    return "original";
+  const isVariant = !!match[3];
+  const supportsOriginal = major > 5 || major === 5 && minor !== null && minor >= 4;
+  if (!supportsOriginal) {
+    return DEFAULT_OPENAI_IMAGE_DETAIL;
   }
-  return DEFAULT_OPENAI_IMAGE_DETAIL;
+  return isVariant ? "high" : "original";
+};
+var getRenderImageDetail = (model) => {
+  const detail = getOpenAIImageDetail(model);
+  return detail === DEFAULT_OPENAI_IMAGE_DETAIL ? "high" : detail;
 };
 var IMAGE_URL_REGEX = /\bhttps?:\/\/[^\s<>"'()\[\]]+?\.(?:jpg|jpeg|png|gif|webp)(?:\?[^\s<>"'()\[\]]*)?/gi;
 function transformContentWithImages(content) {
@@ -817,14 +939,53 @@ async function callOpenAIWithPublicMcp(prompt, service, owner, messages, system,
     }
   });
 }
+async function notifyAgentContinueIndexing(info) {
+  return notifyAgentSaveAttachment({ ...info, continueIndexing: true });
+}
 async function notifyAgentSaveAttachment(info) {
   const { platform, service, owner, attachment, parsedContent } = info;
-  const pagedRead = !parsedContent && isPagedReadFile(attachment.name, attachment.mime);
-  const serverExtract = !parsedContent && !pagedRead && isServerExtractable(attachment.name, attachment.mime);
+  const continuing = !!info.continueIndexing;
+  const visionFile = !parsedContent && isImageVisionFile(attachment.name, attachment.mime);
+  const renderFrom = Math.max(0, info.renderFrom || 0);
+  const renderPlaceholder = visionFile ? makeRenderPlaceholder(attachment.storagePath) : void 0;
+  const renderDetail = platform === "openai" ? getRenderImageDetail(info.model || DEFAULT_OPENAI_MODEL) : void 0;
+  const skapiRender = visionFile && renderPlaceholder ? {
+    _skapi_render: [
+      {
+        path: attachment.storagePath,
+        from: renderFrom,
+        count: RENDER_PAGES_PER_WINDOW,
+        placeholder: renderPlaceholder,
+        name: attachment.name,
+        mime: attachment.mime,
+        detail: renderDetail,
+        auto_continue: true,
+        continue_text: buildIndexingRenderContinueTemplate(attachment, renderPlaceholder)
+      }
+    ]
+  } : {};
+  const windowedRead = !visionFile && !parsedContent && windowedIndexingEnabled() && isWindowedReadFile(attachment.name, attachment.mime);
+  const windowPlaceholder = windowedRead ? makeWindowPlaceholder(attachment.storagePath) : void 0;
+  const skapiWindow = windowedRead && windowPlaceholder ? {
+    _skapi_window: [
+      {
+        path: attachment.storagePath,
+        cursor: null,
+        placeholder: windowPlaceholder,
+        name: attachment.name,
+        mime: attachment.mime,
+        kind: "window",
+        auto_continue: true,
+        continue_text: buildIndexingWindowMessage(attachment, windowPlaceholder, true)
+      }
+    ]
+  } : {};
+  const pagedRead = !visionFile && !windowedRead && (continuing || !parsedContent && isPagedReadFile(attachment.name, attachment.mime));
+  const serverExtract = !visionFile && !windowedRead && !continuing && !parsedContent && !pagedRead && isServerExtractable(attachment.name, attachment.mime);
   const placeholder = serverExtract ? makeExtractPlaceholder(attachment.storagePath) : void 0;
   const extractContent = serverExtract && placeholder ? [{ path: attachment.storagePath, placeholder, name: attachment.name, mime: attachment.mime }] : void 0;
   const skapiExtract = extractContent && extractContent.length ? { _skapi_extract: extractContent } : {};
-  const userMessage = buildIndexingUserMessage(
+  const userMessage = visionFile && renderPlaceholder ? buildIndexingRenderMessage(attachment, renderPlaceholder, renderFrom) : windowedRead && windowPlaceholder ? buildIndexingWindowMessage(attachment, windowPlaceholder, false) : continuing ? buildIndexingContinueMessage(attachment) : buildIndexingUserMessage(
     attachment,
     parsedContent ? { inlineContent: parsedContent } : placeholder ? { inlineContentPlaceholder: placeholder } : pagedRead ? { pagedRead: true } : void 0
   );
@@ -852,6 +1013,8 @@ async function notifyAgentSaveAttachment(info) {
         model: resolvedModel2,
         max_output_tokens: MAX_TOKENS,
         ...skapiExtract,
+        ...skapiRender,
+        ...skapiWindow,
         input: [
           { role: "system", content: systemPrompt },
           {
@@ -896,6 +1059,8 @@ async function notifyAgentSaveAttachment(info) {
       model: resolvedModel,
       max_tokens: MAX_TOKENS,
       ...skapiExtract,
+      ...skapiRender,
+      ...skapiWindow,
       system: [
         {
           type: "text",
@@ -992,6 +1157,15 @@ async function listOpenAIModels(service, owner) {
   });
 }
 var BG_INDEXING_QUEUE_SUFFIX = "-bg";
+function isBgIndexingQueue(queueName) {
+  if (typeof queueName !== "string" || !queueName) return false;
+  const prefix = queueName.split("|")[0];
+  const idx = prefix.lastIndexOf(":");
+  const name = idx === -1 ? prefix : prefix.slice(idx + 1);
+  return name.slice(-BG_INDEXING_QUEUE_SUFFIX.length) === BG_INDEXING_QUEUE_SUFFIX;
+}
+var INDEXING_COMPLETE_MARKER = "INDEXING_COMPLETE";
+var MAX_INDEXING_RESUME_PASSES = 6;
 async function getChatHistory(params, fetchOptions) {
   const url = params.platform === "claude" ? ANTHROPIC_MESSAGES_API_URL : OPENAI_RESPONSES_API_URL;
   const p = Object.assign(
@@ -1119,6 +1293,9 @@ function nextFrame(cb) {
     cb(nowMs());
   }, 16);
 }
+function isPollStopped(res) {
+  return !!res && typeof res === "object" && res.status === "stopped";
+}
 var ChatSession = class {
   constructor(host) {
     this.typewriterQueue = Promise.resolve();
@@ -1142,8 +1319,83 @@ var ChatSession = class {
     this.pendingAgentRequests = {};
     this.aiChatHistoryCache = {};
     this.historyItemPolls = /* @__PURE__ */ new Map();
+    this._pauseReasons = /* @__PURE__ */ new Set();
+    this._resuming = false;
     this._lidSeq = 0;
   }
+  /**
+   * Register a live poll so (a) a remount dedupes against it instead of stacking a
+   * SECOND poll on the same item, and (b) pausePolling can stop it.
+   *
+   * `stop` comes from the SDK and may be absent on an older skapi-js, in which case the
+   * poll simply cannot be stopped and is left running — see pausePolling.
+   */
+  _trackPoll(id, kind, p) {
+    var stop = p && typeof p.stop === "function" ? p.stop.bind(p) : void 0;
+    if (!stop) {
+      console.debug("[chat-engine] poll has no stop handle", { id, kind });
+    }
+    this.historyItemPolls.set(id, { kind, stop });
+    return p;
+  }
+  /** True while any pause reason is active. */
+  isPollingPaused() {
+    return this._pauseReasons.size > 0;
+  }
+  /**
+   * Stop BACKGROUND polling until resumePolling. Foreground polls (a reply the user is
+   * waiting on) keep running deliberately: their results must still land in the history
+   * cache so resumePendingRequest can render them on return, otherwise a user who sends
+   * a message then navigates away comes back to a permanently stuck "Thinking...".
+   *
+   * Server-side work is untouched; this only stops asking about it. That is safe for
+   * document indexing because the worker drives that loop itself.
+   */
+  pausePolling(reason) {
+    this._pauseReasons.add(reason || "paused");
+    var self = this;
+    var stopped = [];
+    this.historyItemPolls.forEach(function(handle, id) {
+      if (!handle || handle.kind !== "bg") return;
+      if (typeof handle.stop !== "function") return;
+      try {
+        handle.stop();
+      } catch (e) {
+      }
+      stopped.push(id);
+    });
+    stopped.forEach(function(id) {
+      self.historyItemPolls.delete(id);
+    });
+  }
+  /**
+   * Lift a pause reason WITHOUT running the reconcile. For a caller that is about to
+   * reload history anyway (a view remounting), letting resumePolling also reconcile
+   * would race that load and can double-attach.
+   */
+  clearPauseReason(reason) {
+    this._pauseReasons.delete(reason || "paused");
+  }
+  /**
+   * Clear a pause reason and, once none remain, re-attach polling and reconcile.
+   * Deliberately does NOT touch gateRefreshToken: bumping it would silently discard
+   * the results of anything still in flight across the pause.
+   */
+  resumePolling(reason) {
+    this._pauseReasons.delete(reason || "paused");
+    if (this._pauseReasons.size > 0 || this._resuming) return Promise.resolve();
+    if (!this.host.isViewMounted || !this.host.isViewMounted()) return Promise.resolve();
+    var self = this;
+    this._resuming = true;
+    return Promise.resolve().then(function() {
+      self.drainBgTaskQueue();
+      return self.loadHistory(false, self.state.gateRefreshToken);
+    }).catch(function(e) {
+      console.error("[chat-engine] resume polling failed", e);
+    }).then(function() {
+      self._resuming = false;
+    });
+  }
   _newLocalId() {
     this._lidSeq += 1;
     return "lid_" + this._lidSeq;
@@ -1157,29 +1409,86 @@ var ChatSession = class {
     var key = this.getHistoryCacheKey();
     if (!key) return;
     this.aiChatHistoryCache[key] = {
-      messages: this.state.messages.slice(),
+      messages: this.state.messages.filter(function(m) {
+        return m._ownerKey === void 0 || m._ownerKey === key;
+      }),
       endOfList: this.state.historyEndOfList,
       startKeyHistory: this.state.historyStartKeyHistory.slice()
     };
   }
-  _callProviderFor(platform, prompt, messages, system, model, userId, extractContent, fileUrls) {
-    var id = this.host.getIdentity();
-    return platform === "openai" ? callOpenAIWithPublicMcp(prompt, id.serviceId, id.owner, messages, system, model, userId, extractContent, fileUrls) : callClaudeWithPublicMcp(prompt, id.serviceId, id.owner, messages, system, model, userId, extractContent, fileUrls);
+  /**
+   * Land a resolved reply in the history cache of a chat that is NOT currently
+   * visible, without touching state.messages. Mirrors the cache-only path in
+   * dispatchAgentRequest: REPLACE the trailing pending "Thinking..." bubble
+   * (append only when there is none), and settle the matching pending user
+   * bubble, so the cached copy never keeps a stuck "Thinking..." that a later
+   * cache-first load would re-render forever.
+   */
+  _applyReplyToCache(key, reply, serverId) {
+    if (!key) return;
+    var existing = this.aiChatHistoryCache[key] || { messages: [], endOfList: false, startKeyHistory: [] };
+    var msgs = existing.messages.slice();
+    var thIdx = -1;
+    for (var i = msgs.length - 1; i >= 0; i--) {
+      var m = msgs[i];
+      if (!m || !m.isPending || m.role !== "assistant" || m.isBackgroundTask) continue;
+      if (serverId && m._serverItemId && m._serverItemId !== serverId) continue;
+      thIdx = i;
+      break;
+    }
+    if (thIdx !== -1) {
+      if (reply._serverItemId === void 0 && msgs[thIdx]._serverItemId !== void 0) reply._serverItemId = msgs[thIdx]._serverItemId;
+      msgs[thIdx] = reply;
+    } else {
+      msgs.push(reply);
+    }
+    for (var j = 0; j < msgs.length; j++) {
+      var u = msgs[j];
+      if (!u || u.role !== "user" || u.isBackgroundTask) continue;
+      if (!(u.isPendingQueued || u.isPendingInProcess || u.isSendingToServer)) continue;
+      if (serverId && u._serverItemId && u._serverItemId !== serverId) continue;
+      var settled = { role: "user", content: u.content };
+      if (u._serverItemId !== void 0) settled._serverItemId = u._serverItemId;
+      if (u._ownerKey !== void 0) settled._ownerKey = u._ownerKey;
+      msgs[j] = settled;
+      break;
+    }
+    this.aiChatHistoryCache[key] = {
+      messages: msgs,
+      endOfList: existing.endOfList,
+      startKeyHistory: existing.startKeyHistory
+    };
+  }
+  /**
+   * serviceId/owner are passed explicitly by every caller: a request can be
+   * dispatched after the user moved to another project, and re-reading the live
+   * identity here would silently send the turn to THAT project instead of the
+   * one it was composed for. Falls back to the live read only when a caller
+   * omits them.
+   */
+  _callProviderFor(platform, prompt, messages, system, model, userId, extractContent, fileUrls, serviceId, owner) {
+    if (serviceId === void 0 || owner === void 0) {
+      var id = this.host.getIdentity();
+      if (serviceId === void 0) serviceId = id.serviceId;
+      if (owner === void 0) owner = id.owner;
+    }
+    return platform === "openai" ? callOpenAIWithPublicMcp(prompt, serviceId, owner, messages, system, model, userId, extractContent, fileUrls) : callClaudeWithPublicMcp(prompt, serviceId, owner, messages, system, model, userId, extractContent, fileUrls);
   }
   dispatchAgentRequest(params) {
     var self = this;
     var dispatchItemId;
     var sendAndPoll = function() {
       return Promise.resolve(
-        self._callProviderFor(params.aiPlatform, params.text, params.boundedMessages, params.systemPrompt, params.aiModel, params.userId, params.extractContent, params.fileUrls)
+        self._callProviderFor(params.aiPlatform, params.text, params.boundedMessages, params.systemPrompt, params.aiModel, params.userId, params.extractContent, params.fileUrls, params.serviceId, params.owner)
       ).then(function(initial) {
         if (initial && initial.poll && (initial.status === "pending" || initial.status === "running")) {
           if (initial.id) {
             if (dispatchItemId && dispatchItemId !== initial.id) self.historyItemPolls.delete(dispatchItemId);
             dispatchItemId = initial.id;
-            self.historyItemPolls.set(initial.id, true);
           }
-          return initial.poll({ latency: POLL_INTERVAL });
+          var dp = initial.poll({ latency: POLL_INTERVAL });
+          if (initial.id) self._trackPoll(initial.id, "fg", dp);
+          return dp;
         }
         return initial;
       });
@@ -1232,20 +1541,57 @@ var ChatSession = class {
   // 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) {
+  dispatchComposedMessage(composed, useBgQueue, composedForLlm, extractContent, fileUrls, pinned) {
     var self = this;
     if (!composed) return;
-    var id = this.host.getIdentity();
+    var id = pinned ? pinned.identity : this.host.getIdentity();
     if (id.platform === "none") return;
     var llmComposed = composedForLlm || composed;
-    var isQueuedSend = useBgQueue || this.state.sending || this.state.messages.some(function(m) {
+    var key = !id.serviceId ? "" : id.serviceId + "#" + id.platform;
+    var offChat = !!key && key !== this.getHistoryCacheKey();
+    var isQueuedSend = !offChat && (useBgQueue || this.state.sending || this.state.messages.some(function(m) {
       return (m.isPending || m.isPendingQueued) && !m.isBackgroundTask && !m._useBgQueue;
-    });
+    }));
     var aiPlatform = id.platform;
     var aiModel = id.model || void 0;
-    var systemPrompt = this.host.buildSystemPrompt();
+    var systemPrompt = pinned ? pinned.systemPrompt : this.host.buildSystemPrompt();
     var userId = id.userId || id.serviceId;
     var chatQueue = useBgQueue ? userId + BG_INDEXING_QUEUE_SUFFIX : 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;
+      });
+      var offBounded = buildBoundedChatMessages({
+        platform: aiPlatform,
+        model: aiModel,
+        systemPrompt,
+        serviceId: id.serviceId,
+        history: offHistory.concat([{ role: "user", content: llmComposed }])
+      });
+      var offExisting = this.aiChatHistoryCache[key] || { messages: [], endOfList: false, startKeyHistory: [] };
+      this.aiChatHistoryCache[key] = {
+        messages: offExisting.messages.concat([
+          { role: "user", content: composed, _ownerKey: key },
+          { role: "assistant", content: "", isPending: true, isPendingInProcess: true, _ownerKey: key }
+        ]),
+        endOfList: offExisting.endOfList,
+        startKeyHistory: offExisting.startKeyHistory
+      };
+      this.dispatchAgentRequest({
+        key,
+        serviceId: id.serviceId,
+        owner: id.owner,
+        aiPlatform,
+        aiModel,
+        systemPrompt,
+        text: composed,
+        boundedMessages: offBounded.messages,
+        userId: chatQueue,
+        extractContent,
+        fileUrls
+      });
+      return;
+    }
     if (isQueuedSend) {
       var resolvedHistory = this.state.messages.filter(function(m) {
         return !m.isPending && !m.isPendingQueued && !m.isPendingInProcess && !m.isPendingOlder && !m.isCancelled && !m.isBackgroundTask;
@@ -1258,15 +1604,16 @@ var ChatSession = class {
         history: resolvedHistory.concat([{ role: "user", content: llmComposed }])
       });
       var queuedBubble = { role: "user", content: composed, isPendingQueued: true, isSendingToServer: true };
+      if (key) queuedBubble._ownerKey = key;
       if (useBgQueue) queuedBubble._useBgQueue = true;
       this.state.messages.push(queuedBubble);
       this.host.notify();
       this.updateHistoryCache();
       this.host.scrollToBottom(true);
-      var capturedComposed = composed, capturedPlatform = aiPlatform;
-      Promise.resolve(this._callProviderFor(aiPlatform, composed, boundedQ.messages, systemPrompt, aiModel, chatQueue, extractContent, fileUrls)).then(function(result) {
-        var sendingIdx = self.state.messages.findIndex(function(m) {
-          return m.isSendingToServer && (m.isPendingQueued || m.isPendingInProcess) && m.role === "user";
+      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);
         });
         var serverId = result && typeof result.id === "string" ? result.id : void 0;
         if (sendingIdx >= 0) {
@@ -1276,26 +1623,27 @@ var ChatSession = class {
           self.host.notify();
         }
         if (result && result.poll && (result.status === "pending" || result.status === "running")) {
-          if (serverId) self.historyItemPolls.set(serverId, true);
-          return result.poll({ latency: POLL_INTERVAL }).then(function(res) {
-            return self.onQueuedSendResponse(capturedComposed, res, capturedPlatform, serverId);
+          var qp = result.poll({ latency: POLL_INTERVAL });
+          if (serverId) self._trackPoll(serverId, "fg", qp);
+          return qp.then(function(res) {
+            if (isPollStopped(res)) return;
+            return self.onQueuedSendResponse(capturedComposed, res, capturedPlatform, serverId, capturedKey);
           }).catch(function(err) {
-            return self.onQueuedSendError(capturedComposed, err, serverId);
+            return self.onQueuedSendError(capturedComposed, err, serverId, capturedKey);
           });
         }
-        return self.onQueuedSendResponse(capturedComposed, result, capturedPlatform, serverId);
+        return self.onQueuedSendResponse(capturedComposed, result, capturedPlatform, serverId, capturedKey);
       }).catch(function(err) {
-        return self.onQueuedSendError(capturedComposed, err, void 0);
+        return self.onQueuedSendError(capturedComposed, err, void 0, capturedKey);
       });
       return;
     }
-    this.state.messages.push({ role: "user", content: composed });
-    this.state.messages.push({ role: "assistant", content: "", isPending: true, isPendingInProcess: true });
+    this.state.messages.push({ role: "user", content: composed, ...key ? { _ownerKey: key } : {} });
+    this.state.messages.push({ role: "assistant", content: "", isPending: true, isPendingInProcess: true, ...key ? { _ownerKey: key } : {} });
     this.host.notify();
     this.updateHistoryCache();
     this.state.sending = true;
     this.host.scrollToBottom(true);
-    var key = this.getHistoryCacheKey();
     var historyForLlm = this.state.messages.filter(function(m) {
       return !m.isCancelled && !m.isBackgroundTask;
     });
@@ -1329,8 +1677,8 @@ var ChatSession = class {
     });
     Promise.resolve(run).catch(function() {
     }).then(function() {
-      if (!(self.host.isViewMounted() && self.getHistoryCacheKey() === key)) return;
       self.state.sending = false;
+      if (!(self.host.isViewMounted() && self.getHistoryCacheKey() === key)) return;
       return Promise.resolve(self.typewriteLatestReply(key)).then(function() {
         self.host.scrollToBottom(true);
       });
@@ -1347,9 +1695,11 @@ var ChatSession = class {
     var existing = this.state.messages[nextIdx];
     var promoted = { role: "user", content: existing.content, isPendingInProcess: true, isBackgroundTask: true };
     if (existing._serverItemId !== void 0) promoted._serverItemId = existing._serverItemId;
+    if (existing._ownerKey !== void 0) promoted._ownerKey = existing._ownerKey;
     this.state.messages[nextIdx] = promoted;
     var placeholder = { role: "assistant", content: "", isPending: true, isPendingInProcess: true, isBackgroundTask: true };
     if (existing._serverItemId !== void 0) placeholder._serverItemId = existing._serverItemId;
+    if (existing._ownerKey !== void 0) placeholder._ownerKey = existing._ownerKey;
     this.state.messages.splice(nextIdx + 1, 0, placeholder);
     this.host.notify();
   }
@@ -1365,14 +1715,20 @@ var ChatSession = class {
     var promoted = { role: "user", content: existing.content, isPendingInProcess: true };
     if (existing.isBackgroundTask) promoted.isBackgroundTask = true;
     if (existing._serverItemId !== void 0) promoted._serverItemId = existing._serverItemId;
+    if (existing._ownerKey !== void 0) promoted._ownerKey = existing._ownerKey;
     if (existing.isSendingToServer) promoted.isSendingToServer = true;
     this.state.messages[nextIdx] = promoted;
     var placeholder = { role: "assistant", content: "", isPending: true };
     if (existing._serverItemId !== void 0) placeholder._serverItemId = existing._serverItemId;
+    if (existing._ownerKey !== void 0) placeholder._ownerKey = existing._ownerKey;
     this.state.messages.splice(nextIdx + 1, 0, placeholder);
     this.host.notify();
   }
   resolveQueuedUserBubble(serverId) {
+    var liveKey = this.getHistoryCacheKey();
+    var isLocal = function(m) {
+      return m._ownerKey === void 0 || m._ownerKey === liveKey;
+    };
     var userIdx = -1;
     if (serverId) {
       userIdx = this.state.messages.findIndex(function(m) {
@@ -1381,19 +1737,19 @@ var ChatSession = class {
     }
     if (userIdx === -1) {
       userIdx = this.state.messages.findIndex(function(m) {
-        return m.isPendingInProcess && m.role === "user" && !m.isBackgroundTask && !m._useBgQueue;
+        return m.isPendingInProcess && m.role === "user" && !m.isBackgroundTask && !m._useBgQueue && isLocal(m);
       });
     }
     if (userIdx === -1) {
       userIdx = this.state.messages.findIndex(function(m) {
-        return m.isPendingQueued && m.role === "user" && !m.isBackgroundTask && !m._useBgQueue;
+        return m.isPendingQueued && m.role === "user" && !m.isBackgroundTask && !m._useBgQueue && isLocal(m);
       });
     }
     if (serverId && this.cancelledServerIds.has(serverId)) {
       this.cancelledServerIds.delete(serverId);
       if (userIdx >= 0) {
         var ex = this.state.messages[userIdx];
-        this.state.messages[userIdx] = { role: "user", content: ex.content, isCancelled: true, _serverItemId: ex._serverItemId };
+        this.state.messages[userIdx] = { role: "user", content: ex.content, isCancelled: true, _serverItemId: ex._serverItemId, ...ex._ownerKey !== void 0 ? { _ownerKey: ex._ownerKey } : {} };
         var thIdx = this.state.messages.findIndex(function(m, i) {
           return i > userIdx && m.isPending && m.role === "assistant" && !m.isBackgroundTask;
         });
@@ -1406,6 +1762,7 @@ var ChatSession = class {
       var exist = this.state.messages[userIdx];
       var repl = { role: "user", content: exist.content };
       if (exist._serverItemId !== void 0) repl._serverItemId = exist._serverItemId;
+      if (exist._ownerKey !== void 0) repl._ownerKey = exist._ownerKey;
       this.state.messages[userIdx] = repl;
     }
     var thinkingIdx = userIdx >= 0 ? this.state.messages.findIndex(function(m, i) {
@@ -1418,8 +1775,14 @@ var ChatSession = class {
     else if (targetIdx >= 0) this.state.messages.splice(targetIdx, 0, msg);
     else this.state.messages.push(msg);
   }
-  onQueuedSendResponse(_composed, response, platform, serverId) {
+  onQueuedSendResponse(_composed, response, platform, serverId, ownerKey) {
     if (serverId) this.historyItemPolls.delete(serverId);
+    if (ownerKey && this.getHistoryCacheKey() !== ownerKey) {
+      var offReply = isErrorResponseBody(response) ? { role: "assistant", content: getErrorMessage(response), isError: true } : { role: "assistant", content: ((platform === "openai" ? extractOpenAIText(response) : extractClaudeText(response)) || "").trim() || "No text response received from AI provider." };
+      this._applyReplyToCache(ownerKey, offReply, serverId);
+      if (serverId) this.cancelledServerIds.delete(serverId);
+      return;
+    }
     var targetIdx = this.resolveQueuedUserBubble(serverId);
     if (targetIdx === void 0) {
       this.host.notify();
@@ -1453,8 +1816,14 @@ var ChatSession = class {
     this.host.notify();
     this.host.scrollToBottom(true);
   }
-  onQueuedSendError(_composed, err, serverId) {
+  onQueuedSendError(_composed, err, serverId, ownerKey) {
     if (serverId) this.historyItemPolls.delete(serverId);
+    if (ownerKey && this.getHistoryCacheKey() !== ownerKey) {
+      var isGone = err && (err.code === "NOT_EXISTS" || err.body && err.body.code === "NOT_EXISTS");
+      this._applyReplyToCache(ownerKey, isGone ? { role: "assistant", content: "Request was cancelled.", isError: true } : { role: "assistant", content: getErrorMessage(err), isError: true }, serverId);
+      if (serverId) this.cancelledServerIds.delete(serverId);
+      return;
+    }
     var isNotExists = err && (err.code === "NOT_EXISTS" || err.body && err.body.code === "NOT_EXISTS");
     if (isNotExists) {
       var userIdx = serverId ? this.state.messages.findIndex(function(m) {
@@ -1800,6 +2169,7 @@ var ChatSession = class {
     this.historyItemPolls.delete(itemId);
     var isErr = isErrorResponseBody(response);
     var answer = isErr ? getErrorMessage(response) : ((platform === "openai" ? extractOpenAIText(response) : extractClaudeText(response)) || "").trim();
+    if (!isErr && answer) answer = answer.split(INDEXING_COMPLETE_MARKER).join("").trim();
     var idx = this.state.messages.findIndex(function(m) {
       return m.isPending && m._serverItemId === itemId;
     });
@@ -1857,24 +2227,33 @@ var ChatSession = class {
     }
     this.bgTaskQueue.forEach(function(entry) {
       if (entry.serviceId !== svcId || entry.platform !== plat) return;
-      if (presentIds[entry.id]) return;
-      var isRunning = entry.status === "running";
-      var userBubble = { role: "user", content: self.host.formatIndexingLabel(entry.filename, entry.mime, entry.size, entry.storagePath, entry.isReindex), isBackgroundTask: true, _serverItemId: entry.id };
-      if (isRunning) userBubble.isPendingInProcess = true;
-      else userBubble.isPendingQueued = true;
-      self.state.messages.push(userBubble);
-      if (isRunning) {
-        self.state.messages.push({ role: "assistant", content: "", isPending: true, isPendingInProcess: true, isBackgroundTask: true, _serverItemId: entry.id });
+      if (!presentIds[entry.id]) {
+        var isRunning = entry.status === "running";
+        var userBubble = { role: "user", content: self.host.formatIndexingLabel(entry.filename, entry.mime, entry.size, entry.storagePath, entry.isReindex), isBackgroundTask: true, _serverItemId: entry.id };
+        if (isRunning) userBubble.isPendingInProcess = true;
+        else userBubble.isPendingQueued = true;
+        self.state.messages.push(userBubble);
+        if (isRunning) {
+          self.state.messages.push({ role: "assistant", content: "", isPending: true, isPendingInProcess: true, isBackgroundTask: true, _serverItemId: entry.id });
+        }
+        presentIds[entry.id] = true;
+        self.host.notify();
+        self.updateHistoryCache();
+        self.host.scrollToBottom(false);
       }
-      presentIds[entry.id] = true;
-      self.host.notify();
-      self.updateHistoryCache();
-      self.host.scrollToBottom(false);
-      if (!self.historyItemPolls.has(entry.id) && typeof entry.poll === "function") {
-        self.historyItemPolls.set(entry.id, true);
+      if (!self.isPollingPaused() && !self.historyItemPolls.has(entry.id) && typeof entry.poll === "function") {
         var capturedId = entry.id, capturedPlat = plat;
-        entry.poll({ latency: POLL_INTERVAL }).then(function(response) {
+        var capturedEntry = entry;
+        var wasStopped = false;
+        var bp = entry.poll({ latency: POLL_INTERVAL });
+        self._trackPoll(entry.id, "bg", bp);
+        bp.then(function(response) {
+          if (isPollStopped(response)) {
+            wasStopped = true;
+            return;
+          }
           self.handleHistoryItemResolution(capturedId, response, capturedPlat);
+          self.maybeResumeIndexing(capturedEntry, response, capturedPlat);
         }).catch(function(err) {
           self.historyItemPolls.delete(capturedId);
           var isNotExists = err && (err.code === "NOT_EXISTS" || err.body && err.body.code === "NOT_EXISTS");
@@ -1888,6 +2267,7 @@ var ChatSession = class {
             self.updateHistoryCache();
           }
         }).then(function() {
+          if (wasStopped) return;
           var qi = self.bgTaskQueue.findIndex(function(q) {
             return q.id === capturedId;
           });
@@ -1897,6 +2277,69 @@ var ChatSession = class {
     });
     this.promoteNextBgQueuedToRunning();
   }
+  // Resume-across-passes: if a background INDEXING task for a paged file (spreadsheet or
+  // text) finished WITHOUT the completion marker, the agent ran out of room before reading
+  // the whole file - dispatch a CONTINUE pass (up to a cap) that resumes from where the
+  // already-saved records leave off. Additive + guarded so it never loops forever and
+  // never breaks the resolution path.
+  //
+  // VISION files (PDFs rendered to page images) are NOT resumed here: the proxy worker
+  // advances their page window itself, off the renderer's true page count. Driving them
+  // from the browser is what used to lose pages on long documents - the chain lived in tab
+  // memory (a reload or a closed tab ended it), and it stopped whenever the model claimed
+  // completion, which on an 88-page file happened at page 15. Continuing to dispatch here
+  // as well would now double-index every window.
+  maybeResumeIndexing(entry, response, platform) {
+    var self = this;
+    try {
+      if (!entry || !entry.storagePath) return;
+      if (!isPagedReadFile(entry.filename, entry.mime)) return;
+      if (isImageVisionFile(entry.filename, entry.mime)) return;
+      if (isErrorResponseBody(response)) return;
+      var answer = (platform === "openai" ? extractOpenAIText(response) : extractClaudeText(response)) || "";
+      if (answer.indexOf(INDEXING_COMPLETE_MARKER) !== -1) return;
+      var pass = (entry.resumePass || 0) + 1;
+      if (pass > MAX_INDEXING_RESUME_PASSES) return;
+      var id = this.host.getIdentity();
+      if (!id || id.platform === "none" || id.serviceId !== entry.serviceId) return;
+      notifyAgentContinueIndexing({
+        platform: id.platform,
+        model: id.model,
+        service: id.serviceId,
+        owner: id.owner,
+        userId: id.userId || id.serviceId,
+        serviceName: id.serviceName,
+        serviceDescription: id.serviceDescription,
+        attachment: {
+          name: entry.filename,
+          storagePath: entry.storagePath,
+          mime: entry.mime,
+          size: entry.size,
+          url: ""
+        }
+      }).then(function(ack) {
+        if (ack && typeof ack.id === "string") {
+          self.bgTaskQueue.push({
+            serviceId: id.serviceId,
+            platform: id.platform,
+            id: ack.id,
+            filename: entry.filename,
+            storagePath: entry.storagePath,
+            isReindex: entry.isReindex,
+            mime: entry.mime,
+            size: entry.size,
+            status: ack.status === "running" ? "running" : "pending",
+            poll: ack.poll,
+            resumePass: pass
+          });
+          self.drainBgTaskQueue();
+        }
+      }, function(e) {
+        console.error("[chat-engine] resume-indexing dispatch failed", e);
+      });
+    } catch (e) {
+    }
+  }
   // --- history fetch + pagination --------------------------------------
   // Initial load (fetchMore=false) replaces the list (with in-flight rescue +
   // cancelled-merge) and attaches polls to running/pending items; pagination
@@ -1906,6 +2349,7 @@ var ChatSession = class {
   loadHistory(fetchMore, token) {
     var self = this;
     var id = this.host.getIdentity();
+    var loadKey = !id.serviceId || id.platform === "none" ? "" : id.serviceId + "#" + id.platform;
     if (token === void 0) token = this.state.gateRefreshToken;
     if (this.state.loadingHistory && this.state.historyRequestToken === token || id.platform === "none" || !id.serviceId) {
       return Promise.resolve();
@@ -1928,9 +2372,9 @@ var ChatSession = class {
       if (token !== self.state.gateRefreshToken) return;
       var chatList = history && Array.isArray(history.list) ? history.list : [];
       chatList.forEach(function(item) {
-        if (typeof item.queue_name === "string" && item.queue_name.slice(-BG_INDEXING_QUEUE_SUFFIX.length) === BG_INDEXING_QUEUE_SUFFIX) {
+        if (isBgIndexingQueue(item.queue_name)) {
           var userText = extractLastUserTextFromRequest(item.request_body);
-          if (typeof userText === "string" && userText.indexOf("A new file has just been uploaded") === 0) item._isBgTask = true;
+          if (typeof userText === "string" && (userText.indexOf("A new file has just been uploaded") === 0 || userText.indexOf("CONTINUE indexing") === 0)) item._isBgTask = true;
           else item._isOnBgQueue = true;
         }
       });
@@ -1962,6 +2406,7 @@ var ChatSession = class {
         for (var ri = 0; ri < self.state.messages.length; ri++) {
           var mm = self.state.messages[ri];
           if (mm.isBackgroundTask) continue;
+          if (mm._ownerKey !== void 0 && mm._ownerKey !== loadKey) continue;
           if (mm._serverItemId && serverIds[mm._serverItemId]) continue;
           if (!mm._serverItemId) {
             if (mappedHasPendingAssistant) continue;
@@ -2006,11 +2451,12 @@ var ChatSession = class {
           if (!item.poll || !item.id) return;
           if (self.historyItemPolls.has(item.id)) return;
           if (self.pendingAgentRequests[self.getHistoryCacheKey()] && !item._isBgTask && !item._isOnBgQueue) return;
-          self.historyItemPolls.set(item.id, true);
+          if ((item._isBgTask || item._isOnBgQueue) && self.isPollingPaused()) return;
           var capturedId = item.id;
           var pp = item.poll({
             latency: POLL_INTERVAL,
             onResponse: function(response) {
+              if (isPollStopped(response)) return;
               self.handleHistoryItemResolution(capturedId, response, platform);
             },
             onError: function(err) {
@@ -2046,6 +2492,7 @@ var ChatSession = class {
               }
             }
           });
+          self._trackPoll(capturedId, item._isBgTask || item._isOnBgQueue ? "bg" : "fg", pp);
           if (pp && pp.catch) pp.catch(function() {
           });
         });
@@ -2275,12 +2722,17 @@ exports.MCP_NAME = MCP_NAME;
 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.TOOL_AND_RESPONSE_BUFFER = TOOL_AND_RESPONSE_BUFFER;
 exports.buildBoundedChatMessages = buildBoundedChatMessages;
 exports.buildChatSystemPrompt = buildChatSystemPrompt;
 exports.buildDisplayExpiredAttachmentHref = buildDisplayExpiredAttachmentHref;
+exports.buildIndexingContinueMessage = buildIndexingContinueMessage;
+exports.buildIndexingRenderContinueTemplate = buildIndexingRenderContinueTemplate;
+exports.buildIndexingRenderMessage = buildIndexingRenderMessage;
 exports.buildIndexingSystemPrompt = buildIndexingSystemPrompt;
 exports.buildIndexingUserMessage = buildIndexingUserMessage;
+exports.buildIndexingWindowMessage = buildIndexingWindowMessage;
 exports.callClaudeWithMcp = callClaudeWithMcp;
 exports.callClaudeWithPublicMcp = callClaudeWithPublicMcp;
 exports.callOpenAIWithPublicMcp = callOpenAIWithPublicMcp;
@@ -2305,6 +2757,7 @@ exports.getErrorMessage = getErrorMessage;
 exports.getExpiredAttachmentVisiblePath = getExpiredAttachmentVisiblePath;
 exports.groupAttachmentFailures = groupAttachmentFailures;
 exports.isAuthExpiredError = isAuthExpiredError;
+exports.isBgIndexingQueue = isBgIndexingQueue;
 exports.isErrorResponseBody = isErrorResponseBody;
 exports.isNonRetryableRequestError = isNonRetryableRequestError;
 exports.isOfficeFile = isOfficeFile;