@absolutejs/absolute 0.19.0-beta.602 → 0.19.0-beta.604

package/dist/ai/index.js

@@ -216,6 +216,10 @@ var buildContextLabel = (metadata) => {
     return from ? `Message from ${from}` : "Message evidence";
   }
   const page = getContextNumber(metadata.page) ?? getContextNumber(metadata.pageNumber) ?? (typeof metadata.pageIndex === "number" ? metadata.pageIndex + 1 : undefined);
+  const region = getContextNumber(metadata.regionNumber) ?? (typeof metadata.regionIndex === "number" ? metadata.regionIndex + 1 : undefined);
+  if (page && region) {
+    return `Page ${page} region ${region}`;
+  }
   if (page) {
     return `Page ${page}`;
   }
@@ -256,6 +260,10 @@ var buildLocatorLabel = (metadata, source, title) => {
     return;
   }
   const page = getContextNumber(metadata.page) ?? getContextNumber(metadata.pageNumber) ?? (typeof metadata.pageIndex === "number" ? metadata.pageIndex + 1 : undefined);
+  const region = getContextNumber(metadata.regionNumber) ?? (typeof metadata.regionIndex === "number" ? metadata.regionIndex + 1 : undefined);
+  if (page && region) {
+    return `Page ${page} \xB7 Region ${region}`;
+  }
   if (page) {
     return `Page ${page}`;
   }
@@ -308,9 +316,11 @@ var buildProvenanceLabel = (metadata) => {
   const transcriptSource = getContextString(metadata.transcriptSource);
   const pdfTextMode = getContextString(metadata.pdfTextMode);
   const ocrEngine = getContextString(metadata.ocrEngine);
+  const ocrConfidence = getContextNumber(metadata.ocrRegionConfidence) ?? getContextNumber(metadata.ocrConfidence);
   const labels = [
     pdfTextMode ? `PDF ${pdfTextMode}` : "",
     ocrEngine ? `OCR ${ocrEngine}` : "",
+    typeof ocrConfidence === "number" ? `Confidence ${ocrConfidence.toFixed(2)}` : "",
     mediaKind ? `Media ${mediaKind}` : "",
     transcriptSource ? `Transcript ${transcriptSource}` : "",
     threadTopic ? `Thread ${threadTopic}` : "",
@@ -3977,6 +3987,10 @@ var buildContextLabel2 = (metadata) => {
     return from ? `Message from ${from}` : "Message evidence";
   }
   const page = getContextNumber2(metadata.page) ?? getContextNumber2(metadata.pageNumber) ?? (typeof metadata.pageIndex === "number" ? metadata.pageIndex + 1 : undefined);
+  const region = getContextNumber2(metadata.regionNumber) ?? (typeof metadata.regionIndex === "number" ? metadata.regionIndex + 1 : undefined);
+  if (page && region) {
+    return `Page ${page} region ${region}`;
+  }
   if (page) {
     return `Page ${page}`;
   }
@@ -4007,6 +4021,10 @@ var buildLocatorLabel2 = (metadata, source, title) => {
     return;
   }
   const page = getContextNumber2(metadata.page) ?? getContextNumber2(metadata.pageNumber) ?? (typeof metadata.pageIndex === "number" ? metadata.pageIndex + 1 : undefined);
+  const region = getContextNumber2(metadata.regionNumber) ?? (typeof metadata.regionIndex === "number" ? metadata.regionIndex + 1 : undefined);
+  if (page && region) {
+    return `Page ${page} \xB7 Region ${region}`;
+  }
   if (page) {
     return `Page ${page}`;
   }
@@ -4049,9 +4067,11 @@ var buildProvenanceLabel2 = (metadata) => {
   const transcriptSource = getContextString2(metadata.transcriptSource);
   const pdfTextMode = getContextString2(metadata.pdfTextMode);
   const ocrEngine = getContextString2(metadata.ocrEngine);
+  const ocrConfidence = getContextNumber2(metadata.ocrRegionConfidence) ?? getContextNumber2(metadata.ocrConfidence);
   const labels = [
     pdfTextMode ? `PDF ${pdfTextMode}` : "",
     ocrEngine ? `OCR ${ocrEngine}` : "",
+    typeof ocrConfidence === "number" ? `Confidence ${ocrConfidence.toFixed(2)}` : "",
     mediaKind ? `Media ${mediaKind}` : "",
     transcriptSource ? `Transcript ${transcriptSource}` : "",
     threadTopic ? `Thread ${threadTopic}` : "",
@@ -4061,6 +4081,23 @@ var buildProvenanceLabel2 = (metadata) => {
   ].filter((value) => value.length > 0);
   return labels.length > 0 ? labels.join(" \xB7 ") : undefined;
 };
+var buildRAGSourceLabels = ({
+  metadata,
+  source,
+  title
+}) => {
+  const contextLabel = buildContextLabel2(metadata);
+  const locatorLabel = buildLocatorLabel2(metadata, source, title);
+  const provenanceLabel = buildProvenanceLabel2(metadata);
+  if (!contextLabel && !locatorLabel && !provenanceLabel) {
+    return;
+  }
+  return {
+    contextLabel,
+    locatorLabel,
+    provenanceLabel
+  };
+};
 var buildExcerpt2 = (text, maxLength = 160) => {
   const normalized = text.replaceAll(/\s+/g, " ").trim();
   if (normalized.length <= maxLength) {
@@ -4102,13 +4139,13 @@ var buildRAGSourceSummaries = (sources) => {
       citationNumbers: groupCitations.map((citation) => citationReferenceMap[citation.chunkId] ?? 0),
       citations: groupCitations,
       chunkIds: group.chunks.map((chunk) => chunk.chunkId),
-      contextLabel: buildContextLabel2(leadChunk?.metadata),
+      contextLabel: leadChunk?.labels?.contextLabel ?? buildContextLabel2(leadChunk?.metadata),
       count: group.count,
       excerpt: buildExcerpt2(leadChunk?.text ?? ""),
       key: group.key,
       label: group.label,
-      locatorLabel: buildLocatorLabel2(leadChunk?.metadata, leadChunk?.source, leadChunk?.title),
-      provenanceLabel: buildProvenanceLabel2(leadChunk?.metadata),
+      locatorLabel: leadChunk?.labels?.locatorLabel ?? buildLocatorLabel2(leadChunk?.metadata, leadChunk?.source, leadChunk?.title),
+      provenanceLabel: leadChunk?.labels?.provenanceLabel ?? buildProvenanceLabel2(leadChunk?.metadata),
       source: group.source,
       title: group.title
     };
@@ -4232,6 +4269,11 @@ var buildSourceGroup = (source, key) => ({
   count: 1,
   key,
   label: buildSourceLabel2(source),
+  labels: source.labels ?? buildRAGSourceLabels({
+    metadata: source.metadata,
+    source: source.source,
+    title: source.title
+  }),
   source: source.source,
   title: source.title
 });
@@ -4242,7 +4284,19 @@ var updateSourceGroup = (groups, source) => {
     groups.set(key, buildSourceGroup(source, key));
     return;
   }
-  existing.bestScore = Math.max(existing.bestScore, source.score);
+  if (source.score > existing.bestScore) {
+    existing.bestScore = source.score;
+    existing.label = buildSourceLabel2(source);
+    existing.labels = source.labels ?? buildRAGSourceLabels({
+      metadata: source.metadata,
+      source: source.source,
+      title: source.title
+    });
+    existing.source = source.source;
+    existing.title = source.title;
+  } else {
+    existing.bestScore = Math.max(existing.bestScore, source.score);
+  }
   existing.count += 1;
   existing.chunks.push(source);
 };
@@ -7787,11 +7841,71 @@ var decodeHtmlEntities = (value) => {
   output = output.replace(/&#(\d+);/g, (_, code) => String.fromCodePoint(Number(code)));
   return output.replace(/&#x([0-9a-f]+);/gi, (_, code) => String.fromCodePoint(parseInt(code, 16)));
 };
-var stripHtml = (value) => {
-  const withoutTags = value.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, " ").replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, " ").replace(/<br\s*\/?>/gi, `
+var formatHtmlLinkContext = (href) => {
+  const decoded = decodeHtmlEntities(href.trim());
+  if (!decoded) {
+    return;
+  }
+  if (decoded.startsWith("#")) {
+    return decoded;
+  }
+  if (/^[a-z]+:/i.test(decoded)) {
+    try {
+      const url = new URL(decoded);
+      const path = url.pathname === "/" ? "" : url.pathname;
+      return `${url.hostname}${path}`;
+    } catch {
+      return decoded;
+    }
+  }
+  return decoded;
+};
+var stripHtmlTags = (value) => {
+  const withoutTags = value.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, " ").replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, " ").replace(/<a\b[^>]*href=(['"])(.*?)\1[^>]*>([\s\S]*?)<\/a>/gi, (_match, _quote, href, inner) => {
+    const label = normalizeWhitespace(stripHtmlTags(inner));
+    const context = formatHtmlLinkContext(href);
+    if (!label) {
+      return context ?? " ";
+    }
+    if (!context || context === label) {
+      return label;
+    }
+    return `${label} (${context})`;
+  }).replace(/<br\s*\/?>/gi, `
 `).replace(/<\/(p|div|section|article|li|ul|ol|h[1-6]|table|tr)>/gi, `
 `).replace(/<li\b[^>]*>/gi, "- ").replace(/<[^>]+>/g, " ");
-  return normalizeWhitespace(decodeHtmlEntities(withoutTags));
+  return decodeHtmlEntities(withoutTags);
+};
+var extractMainHtmlContent = (value) => {
+  const trimmed = value.trim();
+  if (!/<html\b|<body\b|<main\b|<article\b/i.test(trimmed)) {
+    return value;
+  }
+  const boilerplateStripped = trimmed.replace(/<script\b[^>]*>[\s\S]*?<\/script>/gi, " ").replace(/<style\b[^>]*>[\s\S]*?<\/style>/gi, " ").replace(/<(nav|footer|header|aside|form)\b[^>]*>[\s\S]*?<\/\1>/gi, " ");
+  const mainMatch = boilerplateStripped.match(/<main\b[^>]*>([\s\S]*?)<\/main>/i);
+  if (mainMatch?.[1]) {
+    return mainMatch[1];
+  }
+  const articleMatches = [
+    ...boilerplateStripped.matchAll(/<article\b[^>]*>([\s\S]*?)<\/article>/gi)
+  ].map((match) => match[1]?.trim()).filter(Boolean);
+  if (articleMatches.length > 0) {
+    return articleMatches.join(`
+`);
+  }
+  const roleMainMatch = boilerplateStripped.match(/<([a-z0-9:_-]+)\b[^>]*\brole=(['"])main\2[^>]*>([\s\S]*?)<\/\1>/i);
+  if (roleMainMatch?.[3]) {
+    return roleMainMatch[3];
+  }
+  const bodyMatch = boilerplateStripped.match(/<body\b[^>]*>([\s\S]*?)<\/body>/i);
+  if (bodyMatch?.[1]) {
+    return bodyMatch[1];
+  }
+  return boilerplateStripped;
+};
+var stripHtml = (value) => {
+  const focused = extractMainHtmlContent(value);
+  return normalizeWhitespace(stripHtmlTags(focused));
 };
 var stripMarkdown = (value) => {
   const withoutCodeBlocks = value.replace(/```[\s\S]*?```/g, (block) => {
@@ -7828,14 +7942,49 @@ var markdownStructureUnits = (value) => {
   flushCurrentSection();
   return sections.map((section) => stripMarkdown(section)).map((section) => normalizeWhitespace(section)).filter(Boolean);
 };
-var htmlStructureUnits = (value) => {
-  const marked = value.replace(/<(section|article|main|aside|nav|h[1-6])\b[^>]*>/gi, `
-
-__ABS_SECTION_BREAK__ `).replace(/<\/(section|article|main|aside|nav|h[1-6])>/gi, `
-
+var joinHtmlHeadingSection = (headings, content) => {
+  const normalizedHeadings = headings.map((heading) => normalizeWhitespace(heading));
+  const combined = [...normalizedHeadings, content].filter(Boolean).join(`
 `);
-  const normalized = stripHtml(marked);
-  return normalized.split(/__ABS_SECTION_BREAK__/).map((section) => normalizeWhitespace(section)).filter(Boolean);
+  return normalizeWhitespace(combined);
+};
+var htmlStructureUnits = (value) => {
+  const focused = extractMainHtmlContent(value);
+  const headingPattern = /<h([1-6])\b[^>]*>([\s\S]*?)<\/h\1>/gi;
+  const sections = [];
+  const headingStack = [];
+  let cursor = 0;
+  let currentContentStart = 0;
+  let activeHeadings = [];
+  const flushSection = (end) => {
+    const content = normalizeWhitespace(stripHtmlTags(focused.slice(currentContentStart, end)));
+    if (!content) {
+      return;
+    }
+    const section = joinHtmlHeadingSection(activeHeadings, content);
+    if (section) {
+      sections.push(section);
+    }
+  };
+  for (const match of focused.matchAll(headingPattern)) {
+    const fullMatch = match[0];
+    const start = match.index ?? cursor;
+    flushSection(start);
+    const level = Number.parseInt(match[1] ?? "1", 10);
+    const headingText = normalizeWhitespace(stripHtmlTags(match[2] ?? ""));
+    if (headingText) {
+      headingStack[level - 1] = headingText;
+      headingStack.length = level;
+      activeHeadings = [...headingStack];
+    }
+    cursor = start + fullMatch.length;
+    currentContentStart = cursor;
+  }
+  flushSection(focused.length);
+  if (sections.length > 0) {
+    return sections;
+  }
+  return [normalizeWhitespace(stripHtmlTags(focused))].filter(Boolean);
 };
 var inferFormat = (document) => {
   if (document.format) {
@@ -7927,10 +8076,77 @@ var isLikelyTextData = (data) => {
 };
 var decodePdfLiteral = (value) => value.replace(/\\([\\()])/g, "$1").replace(/\\n/g, `
 `).replace(/\\r/g, "\r").replace(/\\t/g, "\t").replace(/\\b/g, "\b").replace(/\\f/g, "\f").replace(/\\([0-7]{1,3})/g, (_match, octal) => String.fromCharCode(parseInt(octal, 8)));
+var PDF_TABLE_GAP_THRESHOLD = 120;
+var extractPdfArrayText = (value) => {
+  const parts = [];
+  const tokenPattern = /\(((?:\\.|[^\\)])*)\)|([-+]?\d*\.?\d+)/g;
+  let pendingColumnGap = false;
+  for (const match of value.matchAll(tokenPattern)) {
+    if (match[1] !== undefined) {
+      const decoded = decodePdfLiteral(match[1]);
+      if (pendingColumnGap && decoded && !/^\s/.test(decoded) && parts.at(-1) !== " | ") {
+        parts.push(" | ");
+      }
+      parts.push(decoded);
+      pendingColumnGap = false;
+      continue;
+    }
+    const gap = Number(match[2]);
+    if (Number.isFinite(gap) && gap >= PDF_TABLE_GAP_THRESHOLD) {
+      pendingColumnGap = true;
+    }
+  }
+  return normalizeWhitespace(parts.join("")).replace(/\s+\|\s+/g, " | ").trim();
+};
+var appendPdfText = (parts, value) => {
+  if (!value) {
+    return;
+  }
+  parts.push(value);
+};
+var appendPdfLineBreak = (parts) => {
+  const last = parts.at(-1);
+  if (!last || last.endsWith(`
+`)) {
+    return;
+  }
+  parts.push(`
+`);
+};
+var PDF_TEXT_OPERATOR_PATTERN = /(\[((?:\\.|[^\]])*)\]\s*TJ)|(\(((?:\\.|[^\\)])*)\)\s*Tj)|([-+]?\d*\.?\d+\s+[-+]?\d*\.?\d+\s+\(((?:\\.|[^\\)])*)\)\s*")|(\(((?:\\.|[^\\)])*)\)\s*')|((?:[-+]?\d*\.?\d+\s+){2}(?:Td|TD))|(T\*)|((?:[-+]?\d*\.?\d+\s+){6}Tm)/g;
+var extractTextFromPDFTextObject = (value) => {
+  const parts = [];
+  for (const match of value.matchAll(PDF_TEXT_OPERATOR_PATTERN)) {
+    if (match[2] !== undefined) {
+      appendPdfText(parts, extractPdfArrayText(match[2]));
+      continue;
+    }
+    if (match[4] !== undefined) {
+      appendPdfText(parts, decodePdfLiteral(match[4]));
+      continue;
+    }
+    if (match[6] !== undefined) {
+      appendPdfLineBreak(parts);
+      appendPdfText(parts, decodePdfLiteral(match[6]));
+      continue;
+    }
+    if (match[8] !== undefined) {
+      appendPdfLineBreak(parts);
+      appendPdfText(parts, decodePdfLiteral(match[8]));
+      continue;
+    }
+    if (match[9] !== undefined || match[10] !== undefined || match[11] !== undefined) {
+      appendPdfLineBreak(parts);
+    }
+  }
+  return parts.join("");
+};
 var extractTextFromPDFBytes = (data) => {
   const raw = Buffer.from(data).toString("latin1");
-  const matches = [...raw.matchAll(/\(((?:\\.|[^\\)])*)\)\s*Tj/g)];
-  const combined = matches.map((match) => decodePdfLiteral(match[1] ?? "")).join(`
+  const textObjects = [...raw.matchAll(/BT([\s\S]*?)ET/g)].map((match) => extractTextFromPDFTextObject(match[1] ?? "")).filter(Boolean);
+  const combined = textObjects.length > 0 ? textObjects.join(`
+
+`) : [...raw.matchAll(/\(((?:\\.|[^\\)])*)\)\s*Tj/g)].map((match) => decodePdfLiteral(match[1] ?? "")).join(`
 `);
   return normalizeWhitespace(combined);
 };
@@ -8022,7 +8238,40 @@ var decodeGzipEntries = (data, input) => {
   ];
 };
 var extractXmlText = (value) => normalizeWhitespace(decodeHtmlEntities(value.replace(/<[^>]+>/g, " ").replace(/\s+/g, " ")));
+var extractOfficeParagraphText = (value) => normalizeWhitespace(decodeHtmlEntities(value.replace(/<w:tab\b[^>]*\/>/gi, "\t").replace(/<w:br\b[^>]*\/>/gi, `
+`).replace(/<[^>]+>/g, " ")));
+var officeDocumentParagraphs = (entries) => {
+  const documentEntry = entries.find((entry) => entry.path === "word/document.xml");
+  if (!documentEntry) {
+    return [];
+  }
+  const xml = decodeUtf8(documentEntry.data);
+  const paragraphs = [...xml.matchAll(/<w:p\b[\s\S]*?<\/w:p>/g)];
+  return paragraphs.map((match) => {
+    const paragraphXml = match[0] ?? "";
+    const text = extractOfficeParagraphText(paragraphXml);
+    if (!text) {
+      return "";
+    }
+    const styleMatch = paragraphXml.match(/<w:pStyle\b[^>]*w:val="([^"]+)"[^>]*\/?>/i);
+    const style = (styleMatch?.[1] ?? "").toLowerCase();
+    if (style === "title") {
+      return text;
+    }
+    const headingMatch = style.match(/^heading([1-6])$/);
+    if (headingMatch) {
+      return text;
+    }
+    return text;
+  }).filter(Boolean);
+};
 var officeDocumentText = (entries) => {
+  const paragraphs = officeDocumentParagraphs(entries);
+  if (paragraphs.length > 0) {
+    return normalizeWhitespace(paragraphs.join(`
+
+`));
+  }
   const documentEntry = entries.find((entry) => entry.path === "word/document.xml");
   if (!documentEntry) {
     return "";
@@ -8037,31 +8286,68 @@ var officeDocumentSectionCount = (entries) => {
   const count = [...decodeUtf8(documentEntry.data).matchAll(/<w:p\b/g)].length;
   return count > 0 ? count : undefined;
 };
-var spreadsheetText = (entries) => {
-  const sharedStrings = entries.filter((entry) => entry.path === "xl/sharedStrings.xml").flatMap((entry) => [
-    ...decodeUtf8(entry.data).matchAll(/<t[^>]*>([\s\S]*?)<\/t>/g)
-  ].map((match) => decodeHtmlEntities(match[1] ?? "")));
-  const sheetValues = entries.filter((entry) => entry.path.startsWith("xl/worksheets/") && entry.path.endsWith(".xml")).flatMap((entry) => [...decodeUtf8(entry.data).matchAll(/<v>([\s\S]*?)<\/v>/g)].map((match) => match[1] ?? "")).map((value) => {
-    const index = Number(value);
-    return Number.isInteger(index) && sharedStrings[index] ? sharedStrings[index] : value;
+var spreadsheetSharedStrings = (entries) => entries.filter((entry) => entry.path === "xl/sharedStrings.xml").flatMap((entry) => [
+  ...decodeUtf8(entry.data).matchAll(/<t[^>]*>([\s\S]*?)<\/t>/g)
+].map((match) => decodeHtmlEntities(match[1] ?? "")));
+var spreadsheetColumnLabel = (reference) => {
+  const match = reference?.match(/([A-Z]+)/i);
+  return match?.[1]?.toUpperCase() ?? "";
+};
+var spreadsheetResolveCellValue = (cellXml, sharedStrings) => {
+  const inlineMatch = cellXml.match(/<is\b[^>]*>[\s\S]*?<t[^>]*>([\s\S]*?)<\/t>[\s\S]*?<\/is>/i);
+  if (inlineMatch?.[1]) {
+    return normalizeWhitespace(decodeHtmlEntities(inlineMatch[1]));
+  }
+  const valueMatch = cellXml.match(/<v>([\s\S]*?)<\/v>/i);
+  if (!valueMatch?.[1]) {
+    return "";
+  }
+  const rawValue = decodeHtmlEntities(valueMatch[1]);
+  const typeMatch = cellXml.match(/\bt="([^"]+)"/i);
+  if (typeMatch?.[1] === "s") {
+    const index = Number(rawValue);
+    return Number.isInteger(index) && sharedStrings[index] ? sharedStrings[index] : rawValue;
+  }
+  return normalizeWhitespace(rawValue);
+};
+var spreadsheetWorksheetRows = (worksheetXml, sharedStrings) => [...worksheetXml.matchAll(/<row\b[^>]*>([\s\S]*?)<\/row>/gi)].map((rowMatch) => {
+  const rowXml = rowMatch[1] ?? "";
+  const cells = [...rowXml.matchAll(/<c\b([^>]*)>([\s\S]*?)<\/c>/gi)].map((cellMatch) => {
+    const attributes = cellMatch[1] ?? "";
+    const cellBody = cellMatch[2] ?? "";
+    const referenceMatch = attributes.match(/\br="([^"]+)"/i);
+    const reference = referenceMatch?.[1];
+    const value = spreadsheetResolveCellValue(`<c${attributes}>${cellBody}</c>`, sharedStrings);
+    return {
+      column: spreadsheetColumnLabel(reference),
+      reference,
+      value
+    };
+  }).filter((cell) => cell.value);
+  return cells;
+}).filter((row) => row.length > 0);
+var spreadsheetRowText = (row, headers) => {
+  const entries = row.map((cell, index) => {
+    const header = headers[index];
+    if (header) {
+      return `${header}: ${cell.value}`;
+    }
+    return cell.column ? `${cell.column}: ${cell.value}` : cell.value;
   });
-  return normalizeWhitespace(sheetValues.join(`
-`));
+  return normalizeWhitespace(entries.join(" | "));
 };
 var spreadsheetSheetTexts = (entries) => {
-  const sharedStrings = entries.filter((entry) => entry.path === "xl/sharedStrings.xml").flatMap((entry) => [
-    ...decodeUtf8(entry.data).matchAll(/<t[^>]*>([\s\S]*?)<\/t>/g)
-  ].map((match) => decodeHtmlEntities(match[1] ?? "")));
+  const sharedStrings = spreadsheetSharedStrings(entries);
   const sheetNames = spreadsheetSheetNames(entries);
   const sheetEntries = entries.filter((entry) => entry.path.startsWith("xl/worksheets/") && entry.path.endsWith(".xml")).sort((left, right) => left.path.localeCompare(right.path));
   return sheetEntries.map((entry, index) => {
-    const values = [
-      ...decodeUtf8(entry.data).matchAll(/<v>([\s\S]*?)<\/v>/g)
-    ].map((match) => match[1] ?? "").map((value) => {
-      const sharedStringIndex = Number(value);
-      return Number.isInteger(sharedStringIndex) && sharedStrings[sharedStringIndex] ? sharedStrings[sharedStringIndex] : value;
-    });
-    const text = normalizeWhitespace(values.join(`
+    const rows = spreadsheetWorksheetRows(decodeUtf8(entry.data), sharedStrings);
+    if (rows.length === 0) {
+      return null;
+    }
+    const headers = rows[0].map((cell) => cell.value);
+    const rowTexts = rows.map((row, rowIndex) => normalizeWhitespace(`Row ${rowIndex + 1}. ${spreadsheetRowText(row, rowIndex === 0 ? [] : headers)}`));
+    const text = normalizeWhitespace(rowTexts.join(`
 `));
     if (!text) {
       return null;
@@ -8072,19 +8358,38 @@ var spreadsheetSheetTexts = (entries) => {
     };
   }).filter((entry) => Boolean(entry));
 };
+var spreadsheetText = (entries) => normalizeWhitespace(spreadsheetSheetTexts(entries).map((sheet) => `Sheet ${sheet.name}
+${sheet.text}`).join(`
+
+`));
 var spreadsheetSheetNames = (entries) => entries.filter((entry) => entry.path === "xl/workbook.xml").flatMap((entry) => [
   ...decodeUtf8(entry.data).matchAll(/<sheet[^>]*name="([^"]+)"/g)
 ].map((match) => match[1] ?? "")).filter(Boolean);
-var presentationText = (entries) => {
-  const slides = entries.filter((entry) => entry.path.startsWith("ppt/slides/") && entry.path.endsWith(".xml")).map((entry) => extractXmlText(decodeUtf8(entry.data)));
-  return normalizeWhitespace(slides.join(`
-
+var presentationNotesByIndex = (entries) => new Map(entries.filter((entry) => entry.path.startsWith("ppt/notesSlides/") && entry.path.endsWith(".xml")).sort((left, right) => left.path.localeCompare(right.path)).map((entry) => {
+  const indexMatch = entry.path.match(/notesSlide(\d+)\.xml$/i);
+  const index = Number(indexMatch?.[1] ?? "0") - 1;
+  return [
+    index,
+    normalizeWhitespace(extractXmlText(decodeUtf8(entry.data)))
+  ];
+}).filter((entry) => entry[0] >= 0 && Boolean(entry[1])));
+var presentationSlides = (entries) => {
+  const notesByIndex = presentationNotesByIndex(entries);
+  return entries.filter((entry) => entry.path.startsWith("ppt/slides/") && entry.path.endsWith(".xml")).sort((left, right) => left.path.localeCompare(right.path)).map((entry, index) => {
+    const slideText = normalizeWhitespace(extractXmlText(decodeUtf8(entry.data)));
+    const notesText = notesByIndex.get(index);
+    const text = normalizeWhitespace([slideText, notesText ? `Speaker notes: ${notesText}` : ""].filter(Boolean).join(`
 `));
+    return {
+      index,
+      notesText,
+      text
+    };
+  }).filter((slide) => Boolean(slide.text));
 };
-var presentationSlides = (entries) => entries.filter((entry) => entry.path.startsWith("ppt/slides/") && entry.path.endsWith(".xml")).sort((left, right) => left.path.localeCompare(right.path)).map((entry, index) => ({
-  index,
-  text: normalizeWhitespace(extractXmlText(decodeUtf8(entry.data)))
-})).filter((slide) => Boolean(slide.text));
+var presentationText = (entries) => normalizeWhitespace(presentationSlides(entries).map((slide) => slide.text).join(`
+
+`));
 var presentationSlideCount = (entries) => entries.filter((entry) => entry.path.startsWith("ppt/slides/") && entry.path.endsWith(".xml")).length;
 var epubText = (entries) => {
   const htmlEntries = entries.filter((entry) => /\.(xhtml|html|htm)$/i.test(entry.path));
@@ -8092,17 +8397,113 @@ var epubText = (entries) => {
 
 `));
 };
-var extractEmailText = (raw) => {
+var splitEmailMessage = (raw) => {
   const normalized = raw.replace(/\r\n?/g, `
 `);
-  const [, ...bodyParts] = normalized.split(`
-
-`);
-  const body = bodyParts.join(`
+  const separator = normalized.indexOf(`
 
 `);
+  if (separator < 0) {
+    return {
+      body: "",
+      headerBlock: normalized
+    };
+  }
+  return {
+    body: normalized.slice(separator + 2),
+    headerBlock: normalized.slice(0, separator)
+  };
+};
+var parseHeaderBlock = (headerBlock) => {
+  const unfolded = headerBlock.replace(/\n[ \t]+/g, " ");
+  const headers = new Map;
+  for (const line of unfolded.split(`
+`)) {
+    const separator = line.indexOf(":");
+    if (separator < 0) {
+      continue;
+    }
+    headers.set(line.slice(0, separator).trim().toLowerCase(), line.slice(separator + 1).trim());
+  }
+  return headers;
+};
+var decodeQuotedPrintable = (value) => value.replace(/=\r?\n/g, "").replace(/=([0-9A-F]{2})/gi, (_match, hex) => String.fromCharCode(parseInt(hex, 16)));
+var decodeEmailPartBody = (body, encoding) => {
+  const normalizedEncoding = encoding?.toLowerCase();
+  const trimmed = body.trim();
+  if (normalizedEncoding === "base64") {
+    return new Uint8Array(Buffer.from(trimmed.replace(/\s+/g, ""), "base64"));
+  }
+  if (normalizedEncoding === "quoted-printable") {
+    return new Uint8Array(Buffer.from(decodeQuotedPrintable(body), "utf8"));
+  }
+  return new Uint8Array(Buffer.from(body, "utf8"));
+};
+var parseMimeBoundary = (contentType) => {
+  const match = contentType?.match(/boundary="?([^";]+)"?/i);
+  return match?.[1];
+};
+var parseEmailMimeParts = (body, contentType) => {
+  const boundary = parseMimeBoundary(contentType);
+  if (!boundary) {
+    const htmlMatch = body.match(/<html[\s\S]*<\/html>/i);
+    return {
+      attachments: [],
+      bodyHtml: htmlMatch?.[0],
+      bodyText: htmlMatch ? undefined : body
+    };
+  }
+  const attachments = [];
+  let bodyText;
+  let bodyHtml;
+  const parts = body.split(`--${boundary}`);
+  for (const rawPart of parts) {
+    const trimmed = rawPart.trim();
+    if (!trimmed || trimmed === "--") {
+      continue;
+    }
+    const { body: partBody, headerBlock } = splitEmailMessage(trimmed);
+    const headers = parseHeaderBlock(headerBlock);
+    const partContentType = headers.get("content-type");
+    const disposition = headers.get("content-disposition");
+    const transferEncoding = headers.get("content-transfer-encoding");
+    const filename = disposition?.match(/filename="?([^";]+)"?/i)?.[1] ?? partContentType?.match(/name="?([^";]+)"?/i)?.[1];
+    if (filename) {
+      attachments.push({
+        contentType: partContentType,
+        data: decodeEmailPartBody(partBody, transferEncoding),
+        fileName: filename
+      });
+      continue;
+    }
+    const decoded = Buffer.from(decodeEmailPartBody(partBody, transferEncoding)).toString("utf8");
+    if (partContentType?.toLowerCase().includes("text/html")) {
+      bodyHtml = decoded;
+      continue;
+    }
+    if (partContentType?.toLowerCase().includes("text/plain")) {
+      bodyText = decoded;
+    }
+  }
+  return {
+    attachments,
+    bodyHtml,
+    bodyText
+  };
+};
+var extractEmailText = (raw) => {
+  const { body, headerBlock } = splitEmailMessage(raw);
+  const headers = parseHeaderBlock(headerBlock);
+  const parsed = parseEmailMimeParts(body, headers.get("content-type"));
+  if (parsed.bodyHtml) {
+    return stripHtml(parsed.bodyHtml);
+  }
+  if (parsed.bodyText) {
+    return normalizeWhitespace(parsed.bodyText);
+  }
   if (!body) {
-    return normalizeWhitespace(normalized);
+    return normalizeWhitespace(raw.replace(/\r\n?/g, `
+`));
   }
   const htmlMatch = body.match(/<html[\s\S]*<\/html>/i);
   if (htmlMatch) {
@@ -8111,17 +8512,15 @@ var extractEmailText = (raw) => {
   return normalizeWhitespace(body);
 };
 var parseEmailHeaders = (raw) => {
-  const normalized = raw.replace(/\r\n?/g, `
-`);
-  const [headerBlock = ""] = normalized.split(`
-
-`);
-  const getHeader = (name) => {
-    const match = headerBlock.match(new RegExp(`^${name}:\\s*(.+)$`, "im"));
-    return match?.[1]?.trim();
-  };
+  const { headerBlock } = splitEmailMessage(raw);
+  const headers = parseHeaderBlock(headerBlock);
+  const getHeader = (name) => headers.get(name.toLowerCase());
   return {
+    contentType: getHeader("Content-Type"),
     from: getHeader("From"),
+    inReplyTo: getHeader("In-Reply-To"),
+    messageId: getHeader("Message-ID"),
+    references: getHeader("References"),
     subject: getHeader("Subject"),
     threadTopic: getHeader("Thread-Topic") ?? getHeader("Subject"),
     to: getHeader("To")
@@ -8142,6 +8541,87 @@ var extractPrintableStrings = (data) => {
   return unique.join(`
 `);
 };
+var ocrMetadata = (result) => {
+  const regions = result.regions?.filter((region) => normalizeWhitespace(region.text ?? "").length > 0);
+  const confidenceValues = [
+    typeof result.confidence === "number" ? result.confidence : undefined,
+    ...(regions ?? []).map((region) => typeof region.confidence === "number" ? region.confidence : undefined)
+  ].filter((value) => value !== undefined);
+  const averageConfidence = confidenceValues.length > 0 ? confidenceValues.reduce((sum, value) => sum + value, 0) / confidenceValues.length : undefined;
+  return {
+    ...result.metadata ?? {},
+    ocrConfidence: result.confidence,
+    ocrRegionCount: regions?.length,
+    ocrRegions: regions,
+    ocrAverageConfidence: averageConfidence
+  };
+};
+var ocrPageDocuments = (result, input, baseMetadata) => {
+  const grouped = new Map;
+  for (const region of result.regions ?? []) {
+    const text = normalizeWhitespace(region.text ?? "");
+    if (!text || typeof region.page !== "number" || region.page < 1) {
+      continue;
+    }
+    const bucket = grouped.get(region.page) ?? [];
+    bucket.push({ ...region, text });
+    grouped.set(region.page, bucket);
+  }
+  return [...grouped.entries()].sort((left, right) => left[0] - right[0]).map(([pageNumber, regions]) => ({
+    chunking: input.chunking,
+    contentType: input.contentType,
+    format: "text",
+    metadata: {
+      ...input.metadata ?? {},
+      ...baseMetadata,
+      ocrRegionCount: regions.length,
+      ocrRegions: regions,
+      pageNumber,
+      pageIndex: pageNumber - 1,
+      sourceNativeKind: "pdf_page"
+    },
+    source: input.source ?? input.path ?? input.name ?? `${slugify(input.title ?? DEFAULT_BINARY_NAME)}.pdf`,
+    text: normalizeWhitespace(`PDF page ${pageNumber} from ${input.title ?? input.name ?? input.path ?? DEFAULT_BINARY_NAME}.
+${regions.map((region) => region.text).join(`
+`)}`),
+    title: input.title ? `${input.title} \xB7 Page ${pageNumber}` : `Page ${pageNumber}`
+  }));
+};
+var ocrRegionDocuments = (result, input, baseMetadata) => {
+  const documents = [];
+  for (const [index, region] of (result.regions ?? []).entries()) {
+    const text = normalizeWhitespace(region.text ?? "");
+    if (!text || typeof region.page !== "number" || region.page < 1) {
+      continue;
+    }
+    const pageNumber = region.page;
+    const regionNumber = index + 1;
+    documents.push({
+      chunking: input.chunking,
+      contentType: input.contentType,
+      format: "text",
+      metadata: {
+        ...input.metadata ?? {},
+        ...baseMetadata,
+        ocrRegionConfidence: region.confidence,
+        ocrRegionHeight: region.height,
+        ocrRegionWidth: region.width,
+        ocrRegionX: region.x,
+        ocrRegionY: region.y,
+        pageNumber,
+        pageIndex: pageNumber - 1,
+        regionIndex: index,
+        regionNumber,
+        sourceNativeKind: "pdf_region"
+      },
+      source: input.source ?? input.path ?? input.name ?? `${slugify(input.title ?? DEFAULT_BINARY_NAME)}.pdf`,
+      text: normalizeWhitespace(`PDF page ${pageNumber} region ${regionNumber} from ${input.title ?? input.name ?? input.path ?? DEFAULT_BINARY_NAME}.
+${text}`),
+      title: input.title ? `${input.title} \xB7 Page ${pageNumber} Region ${regionNumber}` : `Page ${pageNumber} Region ${regionNumber}`
+    });
+  }
+  return documents;
+};
 var textExtractorSupports = (input) => {
   if (input.format) {
     return true;
@@ -8227,24 +8707,52 @@ var createBuiltinArchiveExpander = () => ({
 var createEmailExtractor = () => ({
   name: "absolute_email",
   supports: emailExtractorSupports,
-  extract: (input) => {
+  extract: async (input) => {
     const raw = decodeUtf8(input.data);
     const headers = parseEmailHeaders(raw);
-    return {
+    const { body } = splitEmailMessage(raw);
+    const parsed = parseEmailMimeParts(body, headers.contentType);
+    const source = input.source ?? input.path ?? input.name ?? `${slugify(input.title ?? DEFAULT_BINARY_NAME)}.eml`;
+    const messageMetadata = {
+      ...input.metadata ?? {},
+      emailKind: "message",
+      fileKind: "email",
+      from: headers.from,
+      inReplyTo: headers.inReplyTo,
+      messageId: headers.messageId,
+      references: headers.references,
+      threadTopic: headers.subject,
+      to: headers.to,
+      hasAttachments: parsed.attachments.length > 0
+    };
+    const attachmentDocuments = await Promise.all(parsed.attachments.map(async (attachment, index) => {
+      const documents = await extractRAGFileDocuments({
+        chunking: input.chunking,
+        contentType: attachment.contentType,
+        data: attachment.data,
+        format: inferFormatFromContentType(attachment.contentType ?? null) ?? inferFormatFromName(attachment.fileName),
+        metadata: {
+          ...messageMetadata,
+          attachmentIndex: index,
+          attachmentName: attachment.fileName,
+          emailKind: "attachment"
+        },
+        name: attachment.fileName,
+        source: `${source}#attachments/${attachment.fileName}`,
+        title: headers.subject ? `${headers.subject} \xB7 ${attachment.fileName}` : attachment.fileName
+      });
+      return documents;
+    }));
+    const messageDocument = {
       chunking: input.chunking,
       contentType: input.contentType,
       format: "text",
-      metadata: {
-        ...input.metadata ?? {},
-        fileKind: "email",
-        from: headers.from,
-        threadTopic: headers.subject,
-        to: headers.to
-      },
-      source: input.source ?? input.path ?? input.name ?? `${slugify(input.title ?? DEFAULT_BINARY_NAME)}.eml`,
+      metadata: messageMetadata,
+      source,
       text: extractEmailText(raw),
       title: input.title ?? headers.subject
     };
+    return [messageDocument, ...attachmentDocuments.flat()];
   }
 });
 var createEPUBExtractor = () => ({
@@ -8388,7 +8896,7 @@ var createRAGImageOCRExtractor = (provider) => ({
       format: "text",
       metadata: {
         ...input.metadata ?? {},
-        ...result.metadata ?? {},
+        ...ocrMetadata(result),
         fileKind: "image"
       },
       source: input.source ?? input.path ?? input.name ?? `${slugify(input.title ?? DEFAULT_BINARY_NAME)}.image.txt`,
@@ -8476,6 +8984,9 @@ var expandArchiveEntry = async (entry, archiveInput, extractors) => {
     metadata: {
       ...archiveInput.metadata ?? {},
       ...entry.metadata ?? {},
+      archiveEntryName: basename(entry.path),
+      archiveParentName: archiveInput.name ?? archiveInput.path?.split(/[/\\]/).pop() ?? archiveInput.source,
+      archiveParentSource: archiveInput.source ?? archiveInput.path ?? archiveInput.name,
       archivePath: entry.path,
       fileKind: "archive_entry"
     },
@@ -8551,21 +9062,27 @@ var createRAGPDFOCRExtractor = (options) => ({
       ...input,
       contentType: input.contentType ?? "application/pdf"
     });
-    return {
+    const baseMetadata = {
+      ...ocrMetadata(ocr),
+      fileKind: "pdf",
+      pageCount: estimatePDFPageCount(input.data),
+      pdfTextMode: "ocr"
+    };
+    const summaryDocument = {
       chunking: input.chunking,
       contentType: input.contentType ?? "application/pdf",
       format: "text",
       metadata: {
         ...input.metadata ?? {},
-        ...ocr.metadata ?? {},
-        fileKind: "pdf",
-        pageCount: estimatePDFPageCount(input.data),
-        pdfTextMode: "ocr"
+        ...baseMetadata
       },
       source: input.source ?? input.path ?? input.name ?? `${slugify(input.title ?? DEFAULT_BINARY_NAME)}.pdf`,
       text: ocr.text,
       title: ocr.title ?? input.title
     };
+    const pageDocuments = ocrPageDocuments(ocr, input, baseMetadata);
+    const regionDocuments = ocrRegionDocuments(ocr, input, baseMetadata);
+    return [summaryDocument, ...pageDocuments, ...regionDocuments];
   }
 });
 var DEFAULT_FILE_EXTRACTORS = [
@@ -9421,6 +9938,17 @@ var searchDocuments = async (collection, input) => collection.search(input);
 // src/ai/rag/htmxWorkflowRenderers.ts
 init_constants();
 var escapeHtml2 = (text) => text.replace(/&/g, "&amp;").replace(/</g, "&lt;").replace(/>/g, "&gt;").replace(/"/g, "&quot;");
+var renderSourceLabels = (input) => {
+  if (!input) {
+    return "";
+  }
+  const rows = [
+    input.contextLabel ? `<li><strong>Context</strong> ${escapeHtml2(input.contextLabel)}</li>` : "",
+    input.locatorLabel ? `<li><strong>Location</strong> ${escapeHtml2(input.locatorLabel)}</li>` : "",
+    input.provenanceLabel ? `<li><strong>Provenance</strong> ${escapeHtml2(input.provenanceLabel)}</li>` : ""
+  ].filter((row) => row.length > 0);
+  return rows.length > 0 ? `<ul class="rag-source-labels">${rows.join("")}</ul>` : "";
+};
 var renderEmptyState = (kind) => {
   switch (kind) {
     case "documents":
@@ -9460,17 +9988,41 @@ var defaultStatus = ({
   }
   return `<dl class="rag-status">` + `<div><dt>Backend</dt><dd>${escapeHtml2(status.backend)}</dd></div>` + `<div><dt>Vector mode</dt><dd>${escapeHtml2(status.vectorMode)}</dd></div>` + `<div><dt>Embedding dimensions</dt><dd>${status.dimensions ?? "n/a"}</dd></div>` + `<div><dt>Vector acceleration</dt><dd>${status.native?.active ? "active" : "inactive"}</dd></div>` + `<div><dt>Documents</dt><dd>${documents?.total ?? "n/a"}</dd></div>` + `<div><dt>Total chunks</dt><dd>${documents?.chunkCount ?? "n/a"}</dd></div>` + `<div><dt>Seed docs</dt><dd>${documents?.byKind.seed ?? 0}</dd></div>` + `<div><dt>Custom docs</dt><dd>${documents?.byKind.custom ?? 0}</dd></div>` + `</dl>${renderCapabilityList(capabilities)}`;
 };
-var defaultSearchResultItem = (source, index) => '<article class="rag-search-result">' + `<h3>${escapeHtml2(source.title ?? source.chunkId ?? `Result ${index + 1}`)}</h3>` + `<p class="rag-search-source">${escapeHtml2(source.source ?? "unknown source")}</p>` + `<p class="rag-search-score">score ${source.score.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES)}</p>` + `<p class="rag-search-text">${escapeHtml2(source.text)}</p>` + "</article>";
+var defaultSearchResultItem = (source, index) => '<article class="rag-search-result">' + `<h3>${escapeHtml2(source.title ?? source.chunkId ?? `Result ${index + 1}`)}</h3>` + `<p class="rag-search-source">${escapeHtml2(source.source ?? "unknown source")}</p>` + renderSourceLabels(source.labels) + `<p class="rag-search-score">score ${source.score.toFixed(RAG_SEARCH_SCORE_DECIMAL_PLACES)}</p>` + `<p class="rag-search-text">${escapeHtml2(source.text)}</p>` + "</article>";
 var defaultSearchResults = ({
   query,
   results,
   trace
 }) => results.length === 0 ? renderEmptyState("searchResults") : `<section class="rag-search-results">` + `<p class="rag-search-summary">${results.length} results for ${escapeHtml2(query)}</p>` + (trace ? `<p class="rag-search-summary">mode=${escapeHtml2(trace.mode)} \xB7 final=${trace.resultCounts.final} \xB7 vector=${trace.resultCounts.vector} \xB7 lexical=${trace.resultCounts.lexical}</p>` : "") + `${results.map((result, index) => defaultSearchResultItem(result, index)).join("")}</section>`;
-var defaultDocumentItem = (document, index) => '<article class="rag-document">' + `<h3>${escapeHtml2(document.title || `Document ${index + 1}`)}</h3>` + `<p class="rag-document-id">${escapeHtml2(document.id)}</p>` + `<p class="rag-document-source">${escapeHtml2(document.source)}</p>` + `<p class="rag-document-meta">${escapeHtml2(document.format ?? "text")} \xB7 ${escapeHtml2(document.chunkStrategy ?? "paragraphs")} \xB7 ${document.chunkCount ?? 0} chunks</p>` + "</article>";
+var defaultDocumentItem = (document, index) => '<article class="rag-document">' + `<h3>${escapeHtml2(document.title || `Document ${index + 1}`)}</h3>` + `<p class="rag-document-id">${escapeHtml2(document.id)}</p>` + `<p class="rag-document-source">${escapeHtml2(document.source)}</p>` + renderSourceLabels(document.labels) + `<p class="rag-document-meta">${escapeHtml2(document.format ?? "text")} \xB7 ${escapeHtml2(document.chunkStrategy ?? "paragraphs")} \xB7 ${document.chunkCount ?? 0} chunks</p>` + "</article>";
 var defaultDocuments = ({
   documents
 }) => documents.length === 0 ? renderEmptyState("documents") : `<section class="rag-documents">${documents.map((document, index) => defaultDocumentItem(document, index)).join("")}</section>`;
-var defaultChunkPreview = (input) => `<section class="rag-chunk-preview">` + `<h3>${escapeHtml2(input.document.title)}</h3>` + `<p class="rag-chunk-preview-source">${escapeHtml2(input.document.source)}</p>` + `<article class="rag-chunk-normalized">` + `<h4>Normalized text</h4>` + `<pre>${escapeHtml2(input.normalizedText)}</pre>` + `</article>${input.chunks.map((chunk) => '<article class="rag-chunk">' + `<h4>${escapeHtml2(chunk.chunkId)}</h4>` + `<p class="rag-chunk-meta">chunk ${typeof chunk.metadata?.chunkIndex === "number" ? chunk.metadata.chunkIndex : 0} of ${typeof chunk.metadata?.chunkCount === "number" ? chunk.metadata.chunkCount : input.chunks.length}</p>` + `<pre>${escapeHtml2(chunk.text)}</pre>` + "</article>").join("")}</section>`;
+var defaultChunkPreview = (input) => {
+  const groups = input.chunks.reduce((acc, chunk) => {
+    const metadata = chunk.metadata ?? {};
+    const kind = typeof metadata.sourceNativeKind === "string" ? metadata.sourceNativeKind : "document_chunk";
+    const locator = chunk.labels?.locatorLabel ?? "";
+    const title = kind === "pdf_page" ? locator || "PDF pages" : kind === "pdf_region" ? locator || "PDF regions" : kind === "spreadsheet_sheet" ? locator || "Spreadsheet sheets" : kind === "presentation_slide" ? locator || "Presentation slides" : kind === "attachment" ? locator || "Attachments" : kind === "archive_entry" ? locator || "Archive entries" : "Chunks";
+    const key = kind === "document_chunk" ? "document_chunk" : `${kind}:${title}`;
+    const existing = acc.find((entry) => entry.key === key);
+    if (existing) {
+      existing.chunks.push(chunk);
+      return acc;
+    }
+    acc.push({
+      chunks: [chunk],
+      key,
+      title
+    });
+    return acc;
+  }, []);
+  const groupHtml = groups.map((group) => {
+    const chunkHtml = group.chunks.map((chunk) => '<article class="rag-chunk">' + `<h5>${escapeHtml2(chunk.chunkId)}</h5>` + `<p class="rag-chunk-meta">chunk ${typeof chunk.metadata?.chunkIndex === "number" ? chunk.metadata.chunkIndex : 0} of ${typeof chunk.metadata?.chunkCount === "number" ? chunk.metadata.chunkCount : input.chunks.length}</p>` + renderSourceLabels(chunk.labels) + `<pre>${escapeHtml2(chunk.text)}</pre>` + "</article>").join("");
+    return `<section class="rag-chunk-group"><h4>${escapeHtml2(group.title)}</h4>${chunkHtml}</section>`;
+  }).join("");
+  return `<section class="rag-chunk-preview">` + `<h3>${escapeHtml2(input.document.title)}</h3>` + `<p class="rag-chunk-preview-source">${escapeHtml2(input.document.source)}</p>` + renderSourceLabels(input.document.labels) + `<article class="rag-chunk-normalized">` + `<h4>Normalized text</h4>` + `<pre>${escapeHtml2(input.normalizedText)}</pre>` + `</article>${groupHtml}</section>`;
+};
 var defaultMutationResult = (input) => {
   if (!input.ok) {
     return `<div class="rag-mutation error">${escapeHtml2(input.error ?? "Request failed")}</div>`;
@@ -9533,6 +10085,10 @@ var buildRAGContextLocatorLabel = (metadata, source, title) => {
     return;
   }
   const page = getContextNumber3(metadata.page) ?? getContextNumber3(metadata.pageNumber) ?? (typeof metadata.pageIndex === "number" ? metadata.pageIndex + 1 : undefined);
+  const region = getContextNumber3(metadata.regionNumber) ?? (typeof metadata.regionIndex === "number" ? metadata.regionIndex + 1 : undefined);
+  if (page && region) {
+    return `Page ${page} \xB7 Region ${region}`;
+  }
   if (page) {
     return `Page ${page}`;
   }
@@ -9574,9 +10130,11 @@ var buildRAGContextProvenanceLabel = (metadata) => {
   const threadTopic = getContextString3(metadata.threadTopic);
   const from = getContextString3(metadata.from);
   const speaker = getContextString3(metadata.speaker);
+  const ocrConfidence = getContextNumber3(metadata.ocrRegionConfidence) ?? getContextNumber3(metadata.ocrConfidence);
   const labels = [
     pdfTextMode ? `PDF ${pdfTextMode}` : "",
     ocrEngine ? `OCR ${ocrEngine}` : "",
+    typeof ocrConfidence === "number" ? `Confidence ${ocrConfidence.toFixed(2)}` : "",
     mediaKind ? `Media ${mediaKind}` : "",
     transcriptSource ? `Transcript ${transcriptSource}` : "",
     threadTopic ? `Thread ${threadTopic}` : "",
@@ -9886,6 +10444,11 @@ var isRAGDocumentUrlArray = (value) => Array.isArray(value) && value.every((entr
 var isRAGDocumentChunkArray = (value) => Array.isArray(value) && value.every((entry) => isRAGDocumentChunk(entry));
 var buildSources2 = (results) => results.map((result) => ({
   chunkId: result.chunkId,
+  labels: buildRAGSourceLabels({
+    metadata: result.metadata,
+    source: result.source,
+    title: result.title
+  }),
   metadata: result.metadata,
   score: normalizeScore(result.score),
   source: result.source,
@@ -13616,6 +14179,11 @@ var ragChat = (config) => {
     let documentsWithoutChunkPreview = 0;
     let inspectedDocuments = 0;
     let inspectedChunks = 0;
+    let documentsWithSourceLabels = 0;
+    let chunksWithSourceLabels = 0;
+    const sourceNativeKinds = new Map;
+    const sampleDocuments = [];
+    const sampleChunks = [];
     let oldestDocumentAgeMs;
     let newestDocumentAgeMs;
     const staleDocuments = [];
@@ -13656,6 +14224,27 @@ var ragChat = (config) => {
       if ((document.chunkCount ?? 0) === 0) {
         emptyDocuments += 1;
       }
+      const documentLabels = buildRAGSourceLabels({
+        metadata: document.metadata,
+        source: document.source,
+        title: document.title
+      });
+      if (documentLabels) {
+        documentsWithSourceLabels += 1;
+      }
+      const documentSourceNativeKind = typeof document.metadata?.sourceNativeKind === "string" ? document.metadata.sourceNativeKind : undefined;
+      if (documentSourceNativeKind) {
+        sourceNativeKinds.set(documentSourceNativeKind, (sourceNativeKinds.get(documentSourceNativeKind) ?? 0) + 1);
+      }
+      if (sampleDocuments.length < 5 && (documentLabels || documentSourceNativeKind)) {
+        sampleDocuments.push({
+          id: document.id,
+          labels: documentLabels,
+          source: document.source,
+          sourceNativeKind: documentSourceNativeKind,
+          title: document.title
+        });
+      }
       if (indexManager?.getDocumentChunks) {
         const preview = await indexManager.getDocumentChunks(document.id);
         if (!preview) {
@@ -13665,6 +14254,27 @@ var ragChat = (config) => {
         inspectedDocuments += 1;
         for (const chunk of preview.chunks) {
           inspectedChunks += 1;
+          const chunkLabels = buildRAGSourceLabels({
+            metadata: chunk.metadata,
+            source: chunk.source ?? preview.document.source,
+            title: chunk.title ?? preview.document.title
+          });
+          if (chunkLabels) {
+            chunksWithSourceLabels += 1;
+          }
+          const chunkSourceNativeKind = typeof chunk.metadata?.sourceNativeKind === "string" ? chunk.metadata.sourceNativeKind : undefined;
+          if (chunkSourceNativeKind) {
+            sourceNativeKinds.set(chunkSourceNativeKind, (sourceNativeKinds.get(chunkSourceNativeKind) ?? 0) + 1);
+          }
+          if (sampleChunks.length < 8 && (chunkLabels || chunkSourceNativeKind)) {
+            sampleChunks.push({
+              chunkId: chunk.chunkId,
+              documentId: document.id,
+              labels: chunkLabels,
+              source: chunk.source ?? preview.document.source,
+              sourceNativeKind: chunkSourceNativeKind
+            });
+          }
           const normalized = chunk.text.trim();
           if (!normalized) {
             emptyChunks += 1;
@@ -13721,6 +14331,13 @@ var ragChat = (config) => {
       failuresByInputKind: Object.fromEntries(failuresByInputKind.entries()),
       inspectedChunks,
       inspectedDocuments,
+      inspection: {
+        chunksWithSourceLabels,
+        documentsWithSourceLabels,
+        sampleChunks,
+        sampleDocuments,
+        sourceNativeKinds: Object.fromEntries(sourceNativeKinds.entries())
+      },
       lowSignalChunks,
       newestDocumentAgeMs,
       oldestDocumentAgeMs,
@@ -14901,7 +15518,14 @@ var ragChat = (config) => {
     }
     const documents = await indexManager.listDocuments({ kind });
     return {
-      documents,
+      documents: documents.map((document) => ({
+        ...document,
+        labels: buildRAGSourceLabels({
+          metadata: document.metadata,
+          source: document.source,
+          title: document.title
+        })
+      })),
       ok: true
     };
   };
@@ -14961,7 +15585,23 @@ var ragChat = (config) => {
     }
     return {
       ok: true,
-      ...preview
+      ...preview,
+      document: {
+        ...preview.document,
+        labels: buildRAGSourceLabels({
+          metadata: preview.document.metadata,
+          source: preview.document.source,
+          title: preview.document.title
+        })
+      },
+      chunks: preview.chunks.map((chunk) => ({
+        ...chunk,
+        labels: buildRAGSourceLabels({
+          metadata: chunk.metadata,
+          source: chunk.source ?? preview.document.source,
+          title: chunk.title ?? preview.document.title
+        })
+      }))
     };
   };
   const handleDeleteDocument = async (id) => {
@@ -20557,5 +21197,5 @@ export {
   aiChat
 };
 
-//# debugId=E76E681490B6CFE564756E2164756E21
+//# debugId=5C4A7D98C1C2BE6B64756E2164756E21
 //# sourceMappingURL=index.js.map