bunnyquery 1.3.4 → 1.4.0

package/dist/engine.d.mts

@@ -1,3 +1,53 @@
+/**
+ * Client-side attachment-parser plugins.
+ *
+ * Some attachment formats can't be read by the model's web_fetch (binary) and
+ * have no server-side extractor either — e.g. legacy Hancom .hwp. A parser
+ * plugin runs IN THE BROWSER, turns the uploaded File into indexable text (or an
+ * HTML string), and the engine sends that content INLINE in the background
+ * indexing request — so the model indexes the parsed content directly, with no
+ * upload-side server extraction and no web_fetch for that file.
+ *
+ * Register a parser with `registerAttachmentParser()`, or via
+ * `configureChatEngine({ attachmentParsers: [...] })`. The BunnyQuery widget also
+ * exposes `BunnyQuery.registerAttachmentParser()` and an `attachmentParsers`
+ * init option. First matching parser wins.
+ */
+interface AttachmentParser {
+    /** Human-readable label — used only in logs. */
+    name?: string;
+    /**
+     * Return true if this parser handles the file. Receives the file name and
+     * (when known) its MIME type. Keep it cheap — it runs for every upload.
+     */
+    match: (file: {
+        name: string;
+        mime?: string;
+    }) => boolean;
+    /**
+     * Parse the File into indexable plain text OR an HTML string (the model reads
+     * either). Runs in the browser; may be async. Return a falsy/empty value to
+     * skip (the file then falls back to web_fetch / server extraction).
+     */
+    parse: (file: File) => string | null | undefined | Promise<string | null | undefined>;
+}
+declare const MAX_PARSED_CONTENT_CHARS = 200000;
+/** Register an attachment parser. Ignores duplicates (by reference) and invalid plugins. */
+declare function registerAttachmentParser(parser: AttachmentParser): void;
+/** Remove all registered parsers (mainly for tests / re-init). */
+declare function clearAttachmentParsers(): void;
+/** Snapshot of the registered parsers. */
+declare function getAttachmentParsers(): AttachmentParser[];
+/** First parser whose `match` returns true for the given file, if any. */
+declare function findAttachmentParser(name: string, mime?: string): AttachmentParser | undefined;
+/**
+ * Run the matching parser (if any) and return capped, trimmed content — or null
+ * when there is no parser, the parser throws, or it yields nothing. Never throws:
+ * a parser failure degrades to null so the upload still completes (the file then
+ * resolves via its normal path).
+ */
+declare function parseAttachmentContent(file: File, name: string, mime?: string): Promise<string | null>;
+
 /**
  * Engine configuration / dependency injection.
  *
@@ -12,6 +62,7 @@
  * `poll: 0` to get the early ack + a manual `.poll()` handle (needed for queued-
  * send cancel). So the request builders include `poll` only when it is set.
  */
+
 interface ChatEngineConfig {
     /** skapi.clientSecretRequest, bound to the consumer's skapi instance. */
     clientSecretRequest: (opts: any) => Promise<any>;
@@ -24,6 +75,12 @@ interface ChatEngineConfig {
      * the `poll` key is omitted entirely (agent.vue). BunnyQuery sets `0`.
      */
     poll?: number;
+    /**
+     * Optional client-side attachment parsers (e.g. an .hwp parser). Each is
+     * registered at configure time; more can be added later via
+     * `registerAttachmentParser()`. See attachment_parsers.ts.
+     */
+    attachmentParsers?: AttachmentParser[];
 }
 declare function configureChatEngine(config: ChatEngineConfig): void;
 declare function chatEngineConfig(): ChatEngineConfig;
@@ -153,6 +210,12 @@ type BuildIndexingUserMessageOptions = {
      * drops the temporary-URL line — there is nothing for the model to fetch).
      */
     inlineContentPlaceholder?: string;
+    /**
+     * Actual file content parsed CLIENT-SIDE by an attachment-parser plugin (e.g.
+     * an .hwp parser). Embedded inline verbatim — no server extraction and no
+     * web_fetch for this file. Takes precedence over `inlineContentPlaceholder`.
+     */
+    inlineContent?: string;
 };
 declare function buildIndexingUserMessage(attachment: IndexingAttachmentInfo, options?: BuildIndexingUserMessageOptions): string;
 
@@ -293,6 +356,12 @@ type AttachmentSaveInfo = {
         size?: number;
         url: string;
     };
+    /**
+     * Content parsed CLIENT-SIDE by an attachment-parser plugin (e.g. an .hwp
+     * parser). When set, it is inlined into the indexing message verbatim and
+     * takes precedence over server-side office extraction / web_fetch.
+     */
+    parsedContent?: string;
 };
 declare function notifyAgentSaveAttachment(info: AttachmentSaveInfo): Promise<any>;
 declare function extractClaudeText(response: any): any;
@@ -475,6 +544,8 @@ declare class ChatSession {
     private typewriterQueue;
     enqueueTypewrite(idx: number, fullText: string, localId?: string): Promise<any>;
     typewriteLatestReply(key: string): Promise<any>;
+    _removeStrayPendingAssistants(): void;
+    _clearPendingUserBubble(itemId: string): void;
     resumePendingRequest(token: number): Promise<void>;
     handleHistoryItemResolution(itemId: string, response: any, platform: string): void;
     applyHistoryItemResolution(itemId: string, response: any, platform: string): void;
@@ -494,4 +565,4 @@ declare class ChatSession {
     bumpGate(): void;
 }
 
-export { type AttachmentFailureGroup, type AttachmentSaveInfo, BG_INDEXING_QUEUE_SUFFIX, type BgTaskEntry, type BoundedChatOptions, type BuildIndexingUserMessageOptions, CLAUDE_PER_REQUEST_INPUT_CAP, CONTEXT_WINDOW_BY_MODEL, CONTEXT_WINDOW_DEFAULT, type CallClaudeWithMcpParams, type ChatEngineConfig, type ChatHost, type ChatIdentity, type ChatMessage, ChatSession, type ChatState, type ChatSystemPromptParams, type ClaudeMcpServerRequest, type ClaudeMcpToolConfig, type ClaudeMessage, type ClaudeRole, type ComposedUserMessage, DEFAULT_CLAUDE_MODEL, DEFAULT_OPENAI_MODEL, EXPIRED_ATTACHMENT_URL_HOST, EXPIRED_ATTACHMENT_URL_ORIGIN, type ExtractDirective, HISTORY_TOKEN_BUDGET, type IndexingAttachmentInfo, type IndexingSystemPromptParams, LINK_LABEL_MAX_DISPLAY_CHARS, MAX_HISTORY_MESSAGES, MCP_NAME, MIN_INPUT_TOKEN_BUDGET, type MapHistoryOptions, OUTPUT_TOKEN_RESERVE, type OpenAIMessage, POLL_INTERVAL, TOOL_AND_RESPONSE_BUFFER, buildBoundedChatMessages, buildChatSystemPrompt, buildDisplayExpiredAttachmentHref, buildIndexingSystemPrompt, buildIndexingUserMessage, callClaudeWithMcp, callClaudeWithPublicMcp, callOpenAIWithPublicMcp, chatEngineConfig, composeUserMessage, configureChatEngine, createInlineLinkRegex, encodePathSegments, estimateMessageTokens, estimateTextTokens, extractClaudeText, extractLastUserTextFromRequest, extractOpenAIText, extractRemotePathFromAttachmentHref, filterListByClearHorizon, getChatHistory, getContextWindow, getErrorMessage, getExpiredAttachmentVisiblePath, groupAttachmentFailures, isAuthExpiredError, isErrorResponseBody, isNonRetryableRequestError, isOfficeFile, listClaudeModels, listOpenAIModels, makeExtractPlaceholder, mapHistoryListToMessages, normalizeAttachmentPathCandidate, normalizeTextContent, notifyAgentSaveAttachment, safeDecodeURIComponent, sanitizeAttachmentLinksForHistory, stripFileBlocksFromHistory, transformContentWithImages, transformContentWithOpenAIImages, truncateLabelForDisplay };
+export { type AttachmentFailureGroup, type AttachmentParser, type AttachmentSaveInfo, BG_INDEXING_QUEUE_SUFFIX, type BgTaskEntry, type BoundedChatOptions, type BuildIndexingUserMessageOptions, CLAUDE_PER_REQUEST_INPUT_CAP, CONTEXT_WINDOW_BY_MODEL, CONTEXT_WINDOW_DEFAULT, type CallClaudeWithMcpParams, type ChatEngineConfig, type ChatHost, type ChatIdentity, type ChatMessage, ChatSession, type ChatState, type ChatSystemPromptParams, type ClaudeMcpServerRequest, type ClaudeMcpToolConfig, type ClaudeMessage, type ClaudeRole, type ComposedUserMessage, DEFAULT_CLAUDE_MODEL, DEFAULT_OPENAI_MODEL, EXPIRED_ATTACHMENT_URL_HOST, EXPIRED_ATTACHMENT_URL_ORIGIN, type ExtractDirective, HISTORY_TOKEN_BUDGET, type IndexingAttachmentInfo, type IndexingSystemPromptParams, LINK_LABEL_MAX_DISPLAY_CHARS, MAX_HISTORY_MESSAGES, MAX_PARSED_CONTENT_CHARS, MCP_NAME, MIN_INPUT_TOKEN_BUDGET, type MapHistoryOptions, OUTPUT_TOKEN_RESERVE, type OpenAIMessage, POLL_INTERVAL, TOOL_AND_RESPONSE_BUFFER, buildBoundedChatMessages, buildChatSystemPrompt, buildDisplayExpiredAttachmentHref, buildIndexingSystemPrompt, buildIndexingUserMessage, callClaudeWithMcp, callClaudeWithPublicMcp, callOpenAIWithPublicMcp, chatEngineConfig, clearAttachmentParsers, composeUserMessage, configureChatEngine, createInlineLinkRegex, encodePathSegments, estimateMessageTokens, estimateTextTokens, extractClaudeText, extractLastUserTextFromRequest, extractOpenAIText, extractRemotePathFromAttachmentHref, filterListByClearHorizon, findAttachmentParser, getAttachmentParsers, getChatHistory, getContextWindow, getErrorMessage, getExpiredAttachmentVisiblePath, groupAttachmentFailures, isAuthExpiredError, isErrorResponseBody, isNonRetryableRequestError, isOfficeFile, listClaudeModels, listOpenAIModels, makeExtractPlaceholder, mapHistoryListToMessages, normalizeAttachmentPathCandidate, normalizeTextContent, notifyAgentSaveAttachment, parseAttachmentContent, registerAttachmentParser, safeDecodeURIComponent, sanitizeAttachmentLinksForHistory, stripFileBlocksFromHistory, transformContentWithImages, transformContentWithOpenAIImages, truncateLabelForDisplay };

package/dist/engine.d.ts

@@ -1,3 +1,53 @@
+/**
+ * Client-side attachment-parser plugins.
+ *
+ * Some attachment formats can't be read by the model's web_fetch (binary) and
+ * have no server-side extractor either — e.g. legacy Hancom .hwp. A parser
+ * plugin runs IN THE BROWSER, turns the uploaded File into indexable text (or an
+ * HTML string), and the engine sends that content INLINE in the background
+ * indexing request — so the model indexes the parsed content directly, with no
+ * upload-side server extraction and no web_fetch for that file.
+ *
+ * Register a parser with `registerAttachmentParser()`, or via
+ * `configureChatEngine({ attachmentParsers: [...] })`. The BunnyQuery widget also
+ * exposes `BunnyQuery.registerAttachmentParser()` and an `attachmentParsers`
+ * init option. First matching parser wins.
+ */
+interface AttachmentParser {
+    /** Human-readable label — used only in logs. */
+    name?: string;
+    /**
+     * Return true if this parser handles the file. Receives the file name and
+     * (when known) its MIME type. Keep it cheap — it runs for every upload.
+     */
+    match: (file: {
+        name: string;
+        mime?: string;
+    }) => boolean;
+    /**
+     * Parse the File into indexable plain text OR an HTML string (the model reads
+     * either). Runs in the browser; may be async. Return a falsy/empty value to
+     * skip (the file then falls back to web_fetch / server extraction).
+     */
+    parse: (file: File) => string | null | undefined | Promise<string | null | undefined>;
+}
+declare const MAX_PARSED_CONTENT_CHARS = 200000;
+/** Register an attachment parser. Ignores duplicates (by reference) and invalid plugins. */
+declare function registerAttachmentParser(parser: AttachmentParser): void;
+/** Remove all registered parsers (mainly for tests / re-init). */
+declare function clearAttachmentParsers(): void;
+/** Snapshot of the registered parsers. */
+declare function getAttachmentParsers(): AttachmentParser[];
+/** First parser whose `match` returns true for the given file, if any. */
+declare function findAttachmentParser(name: string, mime?: string): AttachmentParser | undefined;
+/**
+ * Run the matching parser (if any) and return capped, trimmed content — or null
+ * when there is no parser, the parser throws, or it yields nothing. Never throws:
+ * a parser failure degrades to null so the upload still completes (the file then
+ * resolves via its normal path).
+ */
+declare function parseAttachmentContent(file: File, name: string, mime?: string): Promise<string | null>;
+
 /**
  * Engine configuration / dependency injection.
  *
@@ -12,6 +62,7 @@
  * `poll: 0` to get the early ack + a manual `.poll()` handle (needed for queued-
  * send cancel). So the request builders include `poll` only when it is set.
  */
+
 interface ChatEngineConfig {
     /** skapi.clientSecretRequest, bound to the consumer's skapi instance. */
     clientSecretRequest: (opts: any) => Promise<any>;
@@ -24,6 +75,12 @@ interface ChatEngineConfig {
      * the `poll` key is omitted entirely (agent.vue). BunnyQuery sets `0`.
      */
     poll?: number;
+    /**
+     * Optional client-side attachment parsers (e.g. an .hwp parser). Each is
+     * registered at configure time; more can be added later via
+     * `registerAttachmentParser()`. See attachment_parsers.ts.
+     */
+    attachmentParsers?: AttachmentParser[];
 }
 declare function configureChatEngine(config: ChatEngineConfig): void;
 declare function chatEngineConfig(): ChatEngineConfig;
@@ -153,6 +210,12 @@ type BuildIndexingUserMessageOptions = {
      * drops the temporary-URL line — there is nothing for the model to fetch).
      */
     inlineContentPlaceholder?: string;
+    /**
+     * Actual file content parsed CLIENT-SIDE by an attachment-parser plugin (e.g.
+     * an .hwp parser). Embedded inline verbatim — no server extraction and no
+     * web_fetch for this file. Takes precedence over `inlineContentPlaceholder`.
+     */
+    inlineContent?: string;
 };
 declare function buildIndexingUserMessage(attachment: IndexingAttachmentInfo, options?: BuildIndexingUserMessageOptions): string;
 
@@ -293,6 +356,12 @@ type AttachmentSaveInfo = {
         size?: number;
         url: string;
     };
+    /**
+     * Content parsed CLIENT-SIDE by an attachment-parser plugin (e.g. an .hwp
+     * parser). When set, it is inlined into the indexing message verbatim and
+     * takes precedence over server-side office extraction / web_fetch.
+     */
+    parsedContent?: string;
 };
 declare function notifyAgentSaveAttachment(info: AttachmentSaveInfo): Promise<any>;
 declare function extractClaudeText(response: any): any;
@@ -475,6 +544,8 @@ declare class ChatSession {
     private typewriterQueue;
     enqueueTypewrite(idx: number, fullText: string, localId?: string): Promise<any>;
     typewriteLatestReply(key: string): Promise<any>;
+    _removeStrayPendingAssistants(): void;
+    _clearPendingUserBubble(itemId: string): void;
     resumePendingRequest(token: number): Promise<void>;
     handleHistoryItemResolution(itemId: string, response: any, platform: string): void;
     applyHistoryItemResolution(itemId: string, response: any, platform: string): void;
@@ -494,4 +565,4 @@ declare class ChatSession {
     bumpGate(): void;
 }
 
-export { type AttachmentFailureGroup, type AttachmentSaveInfo, BG_INDEXING_QUEUE_SUFFIX, type BgTaskEntry, type BoundedChatOptions, type BuildIndexingUserMessageOptions, CLAUDE_PER_REQUEST_INPUT_CAP, CONTEXT_WINDOW_BY_MODEL, CONTEXT_WINDOW_DEFAULT, type CallClaudeWithMcpParams, type ChatEngineConfig, type ChatHost, type ChatIdentity, type ChatMessage, ChatSession, type ChatState, type ChatSystemPromptParams, type ClaudeMcpServerRequest, type ClaudeMcpToolConfig, type ClaudeMessage, type ClaudeRole, type ComposedUserMessage, DEFAULT_CLAUDE_MODEL, DEFAULT_OPENAI_MODEL, EXPIRED_ATTACHMENT_URL_HOST, EXPIRED_ATTACHMENT_URL_ORIGIN, type ExtractDirective, HISTORY_TOKEN_BUDGET, type IndexingAttachmentInfo, type IndexingSystemPromptParams, LINK_LABEL_MAX_DISPLAY_CHARS, MAX_HISTORY_MESSAGES, MCP_NAME, MIN_INPUT_TOKEN_BUDGET, type MapHistoryOptions, OUTPUT_TOKEN_RESERVE, type OpenAIMessage, POLL_INTERVAL, TOOL_AND_RESPONSE_BUFFER, buildBoundedChatMessages, buildChatSystemPrompt, buildDisplayExpiredAttachmentHref, buildIndexingSystemPrompt, buildIndexingUserMessage, callClaudeWithMcp, callClaudeWithPublicMcp, callOpenAIWithPublicMcp, chatEngineConfig, composeUserMessage, configureChatEngine, createInlineLinkRegex, encodePathSegments, estimateMessageTokens, estimateTextTokens, extractClaudeText, extractLastUserTextFromRequest, extractOpenAIText, extractRemotePathFromAttachmentHref, filterListByClearHorizon, getChatHistory, getContextWindow, getErrorMessage, getExpiredAttachmentVisiblePath, groupAttachmentFailures, isAuthExpiredError, isErrorResponseBody, isNonRetryableRequestError, isOfficeFile, listClaudeModels, listOpenAIModels, makeExtractPlaceholder, mapHistoryListToMessages, normalizeAttachmentPathCandidate, normalizeTextContent, notifyAgentSaveAttachment, safeDecodeURIComponent, sanitizeAttachmentLinksForHistory, stripFileBlocksFromHistory, transformContentWithImages, transformContentWithOpenAIImages, truncateLabelForDisplay };
+export { type AttachmentFailureGroup, type AttachmentParser, type AttachmentSaveInfo, BG_INDEXING_QUEUE_SUFFIX, type BgTaskEntry, type BoundedChatOptions, type BuildIndexingUserMessageOptions, CLAUDE_PER_REQUEST_INPUT_CAP, CONTEXT_WINDOW_BY_MODEL, CONTEXT_WINDOW_DEFAULT, type CallClaudeWithMcpParams, type ChatEngineConfig, type ChatHost, type ChatIdentity, type ChatMessage, ChatSession, type ChatState, type ChatSystemPromptParams, type ClaudeMcpServerRequest, type ClaudeMcpToolConfig, type ClaudeMessage, type ClaudeRole, type ComposedUserMessage, DEFAULT_CLAUDE_MODEL, DEFAULT_OPENAI_MODEL, EXPIRED_ATTACHMENT_URL_HOST, EXPIRED_ATTACHMENT_URL_ORIGIN, type ExtractDirective, HISTORY_TOKEN_BUDGET, type IndexingAttachmentInfo, type IndexingSystemPromptParams, LINK_LABEL_MAX_DISPLAY_CHARS, MAX_HISTORY_MESSAGES, MAX_PARSED_CONTENT_CHARS, MCP_NAME, MIN_INPUT_TOKEN_BUDGET, type MapHistoryOptions, OUTPUT_TOKEN_RESERVE, type OpenAIMessage, POLL_INTERVAL, TOOL_AND_RESPONSE_BUFFER, buildBoundedChatMessages, buildChatSystemPrompt, buildDisplayExpiredAttachmentHref, buildIndexingSystemPrompt, buildIndexingUserMessage, callClaudeWithMcp, callClaudeWithPublicMcp, callOpenAIWithPublicMcp, chatEngineConfig, clearAttachmentParsers, composeUserMessage, configureChatEngine, createInlineLinkRegex, encodePathSegments, estimateMessageTokens, estimateTextTokens, extractClaudeText, extractLastUserTextFromRequest, extractOpenAIText, extractRemotePathFromAttachmentHref, filterListByClearHorizon, findAttachmentParser, getAttachmentParsers, getChatHistory, getContextWindow, getErrorMessage, getExpiredAttachmentVisiblePath, groupAttachmentFailures, isAuthExpiredError, isErrorResponseBody, isNonRetryableRequestError, isOfficeFile, listClaudeModels, listOpenAIModels, makeExtractPlaceholder, mapHistoryListToMessages, normalizeAttachmentPathCandidate, normalizeTextContent, notifyAgentSaveAttachment, parseAttachmentContent, registerAttachmentParser, safeDecodeURIComponent, sanitizeAttachmentLinksForHistory, stripFileBlocksFromHistory, transformContentWithImages, transformContentWithOpenAIImages, truncateLabelForDisplay };

package/dist/engine.mjs

@@ -1,7 +1,55 @@
+// src/engine/attachment_parsers.ts
+var MAX_PARSED_CONTENT_CHARS = 2e5;
+var _parsers = [];
+function registerAttachmentParser(parser) {
+  if (parser && typeof parser.match === "function" && typeof parser.parse === "function" && _parsers.indexOf(parser) === -1) {
+    _parsers.push(parser);
+  }
+}
+function clearAttachmentParsers() {
+  _parsers.length = 0;
+}
+function getAttachmentParsers() {
+  return _parsers.slice();
+}
+function findAttachmentParser(name, mime) {
+  for (let i = 0; i < _parsers.length; i++) {
+    try {
+      if (_parsers[i].match({ name, mime })) return _parsers[i];
+    } catch {
+    }
+  }
+  return void 0;
+}
+async function parseAttachmentContent(file, name, mime) {
+  const parser = findAttachmentParser(name, mime);
+  if (!parser) return null;
+  let raw;
+  try {
+    raw = await parser.parse(file);
+  } catch (err) {
+    console.error(
+      `[chat-engine] attachment parser ${parser.name || "(unnamed)"} failed for ${name}:`,
+      err
+    );
+    return null;
+  }
+  let text = (raw == null ? "" : String(raw)).trim();
+  if (!text) return null;
+  if (text.length > MAX_PARSED_CONTENT_CHARS) {
+    text = text.slice(0, MAX_PARSED_CONTENT_CHARS) + `
+...[truncated for length; original ${text.length} characters]`;
+  }
+  return text;
+}
+
 // src/engine/config.ts
 var _config = null;
 function configureChatEngine(config) {
   _config = config;
+  if (config.attachmentParsers) {
+    for (const parser of config.attachmentParsers) registerAttachmentParser(parser);
+  }
 }
 function chatEngineConfig() {
   if (!_config) {
@@ -28,13 +76,41 @@ var OFFICE_FILE_EXTENSIONS = /* @__PURE__ */ new Set([
   "pptx",
   "pptm",
   "hwp",
-  "hwpx"
+  "hwpx",
+  "ods",
+  "odt",
+  "odp",
+  "epub"
+]);
+var WEB_FETCHABLE_TEXT_EXTENSIONS = /* @__PURE__ */ new Set([
+  "csv",
+  "tsv",
+  "tab",
+  "txt",
+  "text",
+  "md",
+  "markdown",
+  "json",
+  "ndjson",
+  "jsonl",
+  "xml",
+  "yaml",
+  "yml",
+  "log",
+  // RTF is a TEXT format (not a binary zip), so web_fetch can read it and the
+  // model decodes its control words. Pin it here so a `.rtf` reported as
+  // `application/msword` isn't misrouted to server-side extraction (which has no
+  // .rtf extractor → "unsupported format" note).
+  "rtf",
+  "htm",
+  "html"
 ]);
 function isOfficeFile(name, mime) {
   const ext = (name || "").split(".").pop()?.toLowerCase() || "";
   if (OFFICE_FILE_EXTENSIONS.has(ext)) return true;
+  if (WEB_FETCHABLE_TEXT_EXTENSIONS.has(ext)) return false;
   const m = (mime || "").toLowerCase();
-  return m.includes("officedocument") || m.includes("hwp") || m === "application/msword" || m === "application/vnd.ms-excel" || m === "application/vnd.ms-powerpoint";
+  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 _extractPlaceholderSeq = 0;
 function makeExtractPlaceholder(seed) {
@@ -155,6 +231,14 @@ File metadata:
 ` + (attachment.mime ? `- mime type: ${attachment.mime}
 ` : "") + (typeof attachment.size === "number" ? `- size (bytes): ${attachment.size}
 ` : "");
+  if (options?.inlineContent) {
+    return head + `
+The file's content was parsed by the client and is provided inline below. Read it directly \u2014 do NOT fetch any URL for this file. Use the storage path above (not this content) for the "src::" unique_id.
+
+----- BEGIN FILE CONTENT -----
+${options.inlineContent}
+----- END FILE CONTENT -----`;
+  }
   if (options?.inlineContentPlaceholder) {
     return head + `
 The file's text content was extracted on the server and is provided inline below. Read it directly \u2014 do NOT fetch any URL for this file. Use the storage path above (not this content) for the "src::" unique_id.
@@ -653,14 +737,14 @@ async function callOpenAIWithPublicMcp(prompt, service, owner, messages, system,
   });
 }
 async function notifyAgentSaveAttachment(info) {
-  const { platform, service, owner, attachment } = info;
-  const office = isOfficeFile(attachment.name, attachment.mime);
+  const { platform, service, owner, attachment, parsedContent } = info;
+  const office = !parsedContent && isOfficeFile(attachment.name, attachment.mime);
   const placeholder = office ? makeExtractPlaceholder(attachment.storagePath) : void 0;
   const extractContent = office && placeholder ? [{ path: attachment.storagePath, placeholder, name: attachment.name, mime: attachment.mime }] : void 0;
   const skapiExtract = extractContent && extractContent.length ? { _skapi_extract: extractContent } : {};
   const userMessage = buildIndexingUserMessage(
     attachment,
-    placeholder ? { inlineContentPlaceholder: placeholder } : void 0
+    parsedContent ? { inlineContent: parsedContent } : placeholder ? { inlineContentPlaceholder: placeholder } : void 0
   );
   const systemPrompt = buildIndexingSystemPrompt({
     service,
@@ -1246,6 +1330,7 @@ var ChatSession = class {
         this.enqueueTypewrite(aiIdx, answer, lid);
       }
     }
+    this._removeStrayPendingAssistants();
     this.promoteNextQueuedToRunning();
     this.updateHistoryCache();
     this.host.notify();
@@ -1288,6 +1373,7 @@ var ChatSession = class {
         if (thPos2 !== -1) this.state.messages.splice(thPos2, 1);
       }
       if (serverId) this.cancelledServerIds.delete(serverId);
+      this._removeStrayPendingAssistants();
       this.promoteNextQueuedToRunning();
       this.updateHistoryCache();
       this.host.notify();
@@ -1301,6 +1387,7 @@ var ChatSession = class {
       return;
     }
     this.insertAtTarget({ role: "assistant", content: getErrorMessage(err), isError: true }, targetIdx);
+    this._removeStrayPendingAssistants();
     this.promoteNextQueuedToRunning();
     this.updateHistoryCache();
     this.host.notify();
@@ -1462,16 +1549,48 @@ var ChatSession = class {
     if (pendingIdx === -1) return Promise.resolve();
     if (latest.isError || !latest.content) {
       this.state.messages[pendingIdx] = { role: "assistant", content: latest.content || "", isError: !!latest.isError };
+      this._removeStrayPendingAssistants();
       this.host.notify();
       this.promoteNextQueuedToRunning();
       return Promise.resolve();
     }
     var lid = this._newLocalId();
     this.state.messages[pendingIdx] = { role: "assistant", content: "", isPending: false, _localId: lid };
+    this._removeStrayPendingAssistants();
     this.host.notify();
     this.promoteNextQueuedToRunning();
     return this.enqueueTypewrite(pendingIdx, latest.content, lid);
   }
+  // Remove any leftover non-background pending ("Thinking…") assistant bubbles.
+  // There is normally at most ONE such bubble at a time (promoteNext* refuses to
+  // add a second), so any extra is a duplicate — it appears when a concurrent
+  // history refetch re-maps the still-"running" turn into a pending placeholder
+  // (with a real _serverItemId) while the local pending bubble (no _serverItemId)
+  // is rescued and re-appended (see loadHistory rescue below). Each resolve path
+  // only replaces the FIRST pending bubble, so without this a stray "Thinking…"
+  // survives next to the reply/error. MUST run AFTER the resolved bubble has been
+  // made non-pending and BEFORE promoteNext*() (so a freshly-promoted Thinking,
+  // which is added only once no pending assistant remains, is preserved).
+  _removeStrayPendingAssistants() {
+    for (var k = this.state.messages.length - 1; k >= 0; k--) {
+      var m = this.state.messages[k];
+      if (m.isPending && m.role === "assistant" && !m.isBackgroundTask) this.state.messages.splice(k, 1);
+    }
+  }
+  // Drop the pending flags on the resolved turn's USER bubble (preserving its
+  // content + background-task marker). Needed because a bg "Indexing:" turn's user
+  // bubble carries isPendingInProcess; leaving it set keeps the bubble visually
+  // stuck and keeps its bgTaskQueue entry alive forever.
+  _clearPendingUserBubble(itemId) {
+    var uIdx = this.state.messages.findIndex(function(m) {
+      return m.role === "user" && m._serverItemId === itemId && (m.isPendingInProcess || m.isPendingQueued || m.isSendingToServer);
+    });
+    if (uIdx === -1) return;
+    var u = this.state.messages[uIdx];
+    var cleaned = { role: "user", content: u.content, _serverItemId: itemId };
+    if (u.isBackgroundTask) cleaned.isBackgroundTask = true;
+    this.state.messages[uIdx] = cleaned;
+  }
   // If an immediate-send request for the current cache key is still in flight
   // (e.g. the view unmounted then remounted mid-request), show the sending
   // state, await it, then render the reply from the cache. Skipped when the
@@ -1510,6 +1629,7 @@ var ChatSession = class {
       return m.isPending && m._serverItemId === itemId;
     });
     if (idx !== -1) {
+      this._clearPendingUserBubble(itemId);
       if (isErr) {
         this.state.messages[idx] = { role: "assistant", content: answer, isError: true, _serverItemId: itemId };
         this.host.notify();
@@ -1659,12 +1779,16 @@ var ChatSession = class {
         self.state.messages.forEach(function(m) {
           if (m.isCancelled && m._serverItemId) locallyCancelled[m._serverItemId] = 1;
         });
+        var mappedHasPendingAssistant = mapped.some(function(m) {
+          return m.isPending && m.role === "assistant" && !m.isBackgroundTask;
+        });
         var rescued = [];
         for (var ri = 0; ri < self.state.messages.length; ri++) {
           var mm = self.state.messages[ri];
           if (mm.isBackgroundTask) continue;
           if (mm._serverItemId && serverIds[mm._serverItemId]) continue;
           if (!mm._serverItemId) {
+            if (mappedHasPendingAssistant) continue;
             if (mm.isSendingToServer || mm.isPendingQueued || mm.isPendingInProcess || mm.isPending) rescued.push(mm);
             else if (self.state.sending && mm.role === "user") {
               var next = self.state.messages[ri + 1];
@@ -1822,44 +1946,49 @@ var ChatSession = class {
             att.storagePath = member.storagePath;
           }
           var mime = member.file.type || self.host.getMimeType(member.file.name);
-          return notifyAgentSaveAttachment({
-            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: member.file.name,
-              storagePath: member.storagePath,
-              mime: mime || void 0,
-              size: member.file.size,
-              url
-            }
-          }).then(function(ack) {
-            if (ack && typeof ack.id === "string") {
-              self.bgTaskQueue.push({
-                serviceId: id.serviceId,
-                platform: id.platform,
-                id: ack.id,
-                filename: member.file.name,
+          return Promise.resolve(
+            parseAttachmentContent(member.file, member.file.name, mime || void 0)
+          ).then(function(parsedContent) {
+            return notifyAgentSaveAttachment({
+              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: member.file.name,
                 storagePath: member.storagePath,
-                isReindex: hadExists,
                 mime: mime || void 0,
                 size: member.file.size,
-                status: ack.status === "running" ? "running" : "pending",
-                poll: ack.poll
-              });
-              self.drainBgTaskQueue();
-            }
-          }, function(e) {
-            console.error("[chat-engine] indexing request failed", e);
-            anyIndexFailed = true;
-            if (!att.errorCode && !att.errorDetail) {
-              att.errorCode = e && (e.code || e.body && e.body.code) || "";
-              att.errorDetail = e && (e.message || e.body && e.body.message) || (typeof e === "string" ? e : "");
-            }
+                url
+              },
+              parsedContent: parsedContent || void 0
+            }).then(function(ack) {
+              if (ack && typeof ack.id === "string") {
+                self.bgTaskQueue.push({
+                  serviceId: id.serviceId,
+                  platform: id.platform,
+                  id: ack.id,
+                  filename: member.file.name,
+                  storagePath: member.storagePath,
+                  isReindex: hadExists,
+                  mime: mime || void 0,
+                  size: member.file.size,
+                  status: ack.status === "running" ? "running" : "pending",
+                  poll: ack.poll
+                });
+                self.drainBgTaskQueue();
+              }
+            }, function(e) {
+              console.error("[chat-engine] indexing request failed", e);
+              anyIndexFailed = true;
+              if (!att.errorCode && !att.errorDetail) {
+                att.errorCode = e && (e.code || e.body && e.body.code) || "";
+                att.errorDetail = e && (e.message || e.body && e.body.message) || (typeof e === "string" ? e : "");
+              }
+            });
           });
         });
       });
@@ -1939,6 +2068,6 @@ var ChatSession = class {
   }
 };
 
-export { BG_INDEXING_QUEUE_SUFFIX, CLAUDE_PER_REQUEST_INPUT_CAP, CONTEXT_WINDOW_BY_MODEL, CONTEXT_WINDOW_DEFAULT, ChatSession, DEFAULT_CLAUDE_MODEL, DEFAULT_OPENAI_MODEL, EXPIRED_ATTACHMENT_URL_HOST, EXPIRED_ATTACHMENT_URL_ORIGIN, HISTORY_TOKEN_BUDGET, LINK_LABEL_MAX_DISPLAY_CHARS, MAX_HISTORY_MESSAGES, MCP_NAME, MIN_INPUT_TOKEN_BUDGET, OUTPUT_TOKEN_RESERVE, POLL_INTERVAL, TOOL_AND_RESPONSE_BUFFER, buildBoundedChatMessages, buildChatSystemPrompt, buildDisplayExpiredAttachmentHref, buildIndexingSystemPrompt, buildIndexingUserMessage, callClaudeWithMcp, callClaudeWithPublicMcp, callOpenAIWithPublicMcp, chatEngineConfig, composeUserMessage, configureChatEngine, createInlineLinkRegex, encodePathSegments, estimateMessageTokens, estimateTextTokens, extractClaudeText, extractLastUserTextFromRequest, extractOpenAIText, extractRemotePathFromAttachmentHref, filterListByClearHorizon, getChatHistory, getContextWindow, getErrorMessage, getExpiredAttachmentVisiblePath, groupAttachmentFailures, isAuthExpiredError, isErrorResponseBody, isNonRetryableRequestError, isOfficeFile, listClaudeModels, listOpenAIModels, makeExtractPlaceholder, mapHistoryListToMessages, normalizeAttachmentPathCandidate, normalizeTextContent, notifyAgentSaveAttachment, safeDecodeURIComponent, sanitizeAttachmentLinksForHistory, stripFileBlocksFromHistory, transformContentWithImages, transformContentWithOpenAIImages, truncateLabelForDisplay };
+export { BG_INDEXING_QUEUE_SUFFIX, CLAUDE_PER_REQUEST_INPUT_CAP, CONTEXT_WINDOW_BY_MODEL, CONTEXT_WINDOW_DEFAULT, ChatSession, DEFAULT_CLAUDE_MODEL, DEFAULT_OPENAI_MODEL, EXPIRED_ATTACHMENT_URL_HOST, EXPIRED_ATTACHMENT_URL_ORIGIN, HISTORY_TOKEN_BUDGET, LINK_LABEL_MAX_DISPLAY_CHARS, MAX_HISTORY_MESSAGES, MAX_PARSED_CONTENT_CHARS, MCP_NAME, MIN_INPUT_TOKEN_BUDGET, OUTPUT_TOKEN_RESERVE, POLL_INTERVAL, TOOL_AND_RESPONSE_BUFFER, buildBoundedChatMessages, buildChatSystemPrompt, buildDisplayExpiredAttachmentHref, buildIndexingSystemPrompt, buildIndexingUserMessage, callClaudeWithMcp, callClaudeWithPublicMcp, callOpenAIWithPublicMcp, chatEngineConfig, clearAttachmentParsers, composeUserMessage, configureChatEngine, createInlineLinkRegex, encodePathSegments, estimateMessageTokens, estimateTextTokens, extractClaudeText, extractLastUserTextFromRequest, extractOpenAIText, extractRemotePathFromAttachmentHref, filterListByClearHorizon, findAttachmentParser, getAttachmentParsers, getChatHistory, getContextWindow, getErrorMessage, getExpiredAttachmentVisiblePath, groupAttachmentFailures, isAuthExpiredError, isErrorResponseBody, isNonRetryableRequestError, isOfficeFile, listClaudeModels, listOpenAIModels, makeExtractPlaceholder, mapHistoryListToMessages, normalizeAttachmentPathCandidate, normalizeTextContent, notifyAgentSaveAttachment, parseAttachmentContent, registerAttachmentParser, safeDecodeURIComponent, sanitizeAttachmentLinksForHistory, stripFileBlocksFromHistory, transformContentWithImages, transformContentWithOpenAIImages, truncateLabelForDisplay };
 //# sourceMappingURL=engine.mjs.map
 //# sourceMappingURL=engine.mjs.map