@absolutejs/absolute 0.19.0-beta.617 → 0.19.0-beta.619

package/dist/ai-client/angular/ai/index.js

@@ -1212,6 +1212,25 @@ var buildContextLabel2 = (metadata) => {
   if (!metadata) {
     return;
   }
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
+  const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : [];
+  const sectionTitle = getContextString2(metadata.sectionTitle) ?? sectionPath.at(-1);
+  if (pdfTextKind === "table_like" && sectionTitle) {
+    return `PDF table block ${sectionTitle}`;
+  }
+  if (pdfTextKind === "paragraph" && sectionTitle) {
+    return `PDF text block ${sectionTitle}`;
+  }
+  if (officeBlockKind === "table" && sectionTitle) {
+    return `Office table block ${sectionTitle}`;
+  }
+  if (officeBlockKind === "list" && sectionTitle) {
+    return `Office list block ${sectionTitle}`;
+  }
+  if (officeBlockKind === "paragraph" && sectionTitle) {
+    return `Office paragraph block ${sectionTitle}`;
+  }
   const emailKind = getContextString2(metadata.emailKind);
   if (emailKind === "attachment") {
     return "Attachment evidence";
@@ -1248,8 +1267,6 @@ var buildContextLabel2 = (metadata) => {
   if (speaker) {
     return `Speaker ${speaker}`;
   }
-  const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : [];
-  const sectionTitle = getContextString2(metadata.sectionTitle) ?? sectionPath.at(-1);
   if (sectionTitle) {
     return `Section ${sectionTitle}`;
   }
@@ -1259,11 +1276,21 @@ var buildLocatorLabel2 = (metadata, source, title) => {
   if (!metadata) {
     return;
   }
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
+  const pdfBlockNumber = getContextNumber2(metadata.pdfBlockNumber);
+  const officeBlockNumber = getContextNumber2(metadata.officeBlockNumber);
   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 && pdfBlockNumber && pdfTextKind === "table_like") {
+    return `Page ${page} · Table Block ${pdfBlockNumber}`;
+  }
+  if (page && pdfBlockNumber) {
+    return `Page ${page} · Text Block ${pdfBlockNumber}`;
+  }
   if (page) {
     return `Page ${page}`;
   }
@@ -1292,6 +1319,15 @@ var buildLocatorLabel2 = (metadata, source, title) => {
   if (mediaStart) {
     return `Timestamp ${mediaStart}`;
   }
+  if (officeBlockNumber && officeBlockKind === "table") {
+    return `Office table block ${officeBlockNumber}`;
+  }
+  if (officeBlockNumber && officeBlockKind === "list") {
+    return `Office list block ${officeBlockNumber}`;
+  }
+  if (officeBlockNumber && officeBlockKind === "paragraph") {
+    return `Office paragraph block ${officeBlockNumber}`;
+  }
   const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : [];
   if (sectionPath.length > 0) {
     return `Section ${sectionPath.join(" > ")}`;
@@ -1309,12 +1345,16 @@ var buildProvenanceLabel2 = (metadata) => {
   const mediaKind = getContextString2(metadata.mediaKind);
   const transcriptSource = getContextString2(metadata.transcriptSource);
   const pdfTextMode = getContextString2(metadata.pdfTextMode);
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
   const ocrEngine = getContextString2(metadata.ocrEngine);
   const extractorRegistryMatch = getContextString2(metadata.extractorRegistryMatch);
   const chunkingProfile = getContextString2(metadata.chunkingProfile);
   const ocrConfidence = getContextNumber2(metadata.ocrRegionConfidence) ?? getContextNumber2(metadata.ocrConfidence);
   const labels = [
     pdfTextMode ? `PDF ${pdfTextMode}` : "",
+    pdfTextKind === "table_like" ? "PDF table block" : pdfTextKind === "paragraph" ? "PDF text block" : "",
+    officeBlockKind ? `Office ${officeBlockKind}` : "",
     ocrEngine ? `OCR ${ocrEngine}` : "",
     extractorRegistryMatch ? `Extractor ${extractorRegistryMatch}` : "",
     chunkingProfile ? `Chunking ${chunkingProfile}` : "",
@@ -1350,7 +1390,7 @@ var buildRAGChunkStructure = (metadata) => {
     return;
   }
   const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.filter((value) => typeof value === "string" && value.trim().length > 0) : undefined;
-  const sectionKind = metadata.sectionKind === "markdown_heading" || metadata.sectionKind === "html_heading" || metadata.sectionKind === "office_heading" || metadata.sectionKind === "spreadsheet_rows" || metadata.sectionKind === "presentation_slide" ? metadata.sectionKind : undefined;
+  const sectionKind = metadata.sectionKind === "markdown_heading" || metadata.sectionKind === "html_heading" || metadata.sectionKind === "office_heading" || metadata.sectionKind === "office_block" || metadata.sectionKind === "pdf_block" || metadata.sectionKind === "spreadsheet_rows" || metadata.sectionKind === "presentation_slide" ? metadata.sectionKind : undefined;
   const section = {
     depth: getContextNumber2(metadata.sectionDepth),
     kind: sectionKind,
@@ -1670,7 +1710,7 @@ var buildRAGSourceSummaries = (sources) => {
   const citationReferenceMap = buildRAGCitationReferenceMap(citations);
   return sourceGroups.map((group) => {
     const groupCitations = citations.filter((citation) => group.chunks.some((chunk) => chunk.chunkId === citation.chunkId));
-    const leadChunk = group.chunks.slice().sort((left, right) => right.score - left.score)[0];
+    const leadChunk = getPreferredSourceLeadChunk(group.chunks);
     const excerpts = leadChunk ? buildRAGChunkExcerpts(group.chunks, leadChunk.chunkId) : undefined;
     const structure = leadChunk?.structure ?? buildRAGChunkStructure(leadChunk?.metadata);
     const excerptSelection = buildRAGExcerptSelection(excerpts, structure);
@@ -1698,13 +1738,45 @@ var getSectionPathFromSource = (source) => {
   const path = source.structure?.section?.path ?? (Array.isArray(source.metadata?.sectionPath) ? source.metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : []);
   return path.length > 0 ? path : undefined;
 };
+var isBlockAwareContextLabel = (value) => typeof value === "string" && (value.startsWith("PDF ") || value.startsWith("Office "));
+var getStructuredSectionScoreWeight = (metadata) => {
+  if (!metadata) {
+    return 1;
+  }
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
+  const sectionKind = getContextString2(metadata.sectionKind);
+  if (pdfTextKind === "table_like") {
+    return 1.28;
+  }
+  if (officeBlockKind === "table" || officeBlockKind === "list") {
+    return 1.24;
+  }
+  if (sectionKind === "pdf_block" || sectionKind === "office_block" || officeBlockKind === "paragraph" || pdfTextKind === "paragraph") {
+    return 1.12;
+  }
+  return 1;
+};
+var getStructuredSourceLeadScore = (source) => source.score * getStructuredSectionScoreWeight(source.metadata);
+var getPreferredSourceLeadChunk = (chunks) => chunks.slice().sort((left, right) => {
+  const leftWeightedScore = getStructuredSourceLeadScore(left);
+  const rightWeightedScore = getStructuredSourceLeadScore(right);
+  if (rightWeightedScore !== leftWeightedScore) {
+    return rightWeightedScore - leftWeightedScore;
+  }
+  if (right.score !== left.score) {
+    return right.score - left.score;
+  }
+  return left.chunkId.localeCompare(right.chunkId);
+})[0];
 var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
-  const totalScore = sources.reduce((sum, source) => sum + source.score, 0);
+  const totalScore = sources.reduce((sum, source) => sum + source.score * getStructuredSectionScoreWeight(source.metadata), 0);
   if (sources.length === 0 || totalScore <= 0) {
     return [];
   }
   const sections = new Map;
   for (const source of sources) {
+    const structuredScore = source.score * getStructuredSectionScoreWeight(source.metadata);
     const path = getSectionPathFromSource(source);
     if (!path) {
       continue;
@@ -1736,7 +1808,7 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
         sourceSet: new Set(source.source ? [source.source] : []),
         topChunkId: source.chunkId,
         topSource: source.source,
-        totalScore: source.score,
+        totalScore: structuredScore,
         transformedHits,
         variantHits,
         vectorHits
@@ -1744,7 +1816,7 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
       continue;
     }
     existing.count += 1;
-    existing.totalScore += source.score;
+    existing.totalScore += structuredScore;
     if (source.source) {
       existing.sourceSet.add(source.source);
     }
@@ -1772,6 +1844,8 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
     const parentTotal = siblingPool.reduce((sum, entry) => sum + entry.totalScore, 0);
     const scoreShare = section.totalScore / totalScore;
     const parentShare = parentTotal > 0 ? section.totalScore / parentTotal : undefined;
+    const topChunk = sources.find((source) => source.chunkId === section.topChunkId);
+    const topContextLabel = topChunk?.labels?.contextLabel ?? buildContextLabel2(topChunk?.metadata);
     const parentDistribution = parentTotal > 0 ? siblingPool.map((entry) => ({
       count: entry.count,
       isActive: entry.key === section.key,
@@ -1897,6 +1971,7 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
       reasons.push("concentrated_evidence");
     }
     const summaryParts = [
+      isBlockAwareContextLabel(topContextLabel) ? topContextLabel : "",
       `${section.count} hit${section.count === 1 ? "" : "s"}`,
       `${(scoreShare * 100).toFixed(0)}% score share`,
       `vector ${section.vectorHits} · lexical ${section.lexicalHits} · hybrid ${section.hybridHits}`,
@@ -2108,22 +2183,21 @@ var updateSourceGroup = (groups, source) => {
     groups.set(key, buildSourceGroup(source, key));
     return;
   }
-  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.structure = source.structure ?? buildRAGChunkStructure(source.metadata);
-    existing.source = source.source;
-    existing.title = source.title;
-  } else {
-    existing.bestScore = Math.max(existing.bestScore, source.score);
-  }
+  existing.bestScore = Math.max(existing.bestScore, source.score);
   existing.count += 1;
   existing.chunks.push(source);
+  const leadChunk = getPreferredSourceLeadChunk(existing.chunks);
+  if (leadChunk) {
+    existing.label = buildSourceLabel2(leadChunk);
+    existing.labels = leadChunk.labels ?? buildRAGSourceLabels({
+      metadata: leadChunk.metadata,
+      source: leadChunk.source,
+      title: leadChunk.title
+    });
+    existing.structure = leadChunk.structure ?? buildRAGChunkStructure(leadChunk.metadata);
+    existing.source = leadChunk.source;
+    existing.title = leadChunk.title;
+  }
 };
 var getLatestAssistantMessage = (messages) => {
   for (let index = messages.length - 1;index >= 0; index -= 1) {

package/dist/ai-client/react/ai/index.js

@@ -1172,6 +1172,25 @@ var buildContextLabel2 = (metadata) => {
   if (!metadata) {
     return;
   }
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
+  const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : [];
+  const sectionTitle = getContextString2(metadata.sectionTitle) ?? sectionPath.at(-1);
+  if (pdfTextKind === "table_like" && sectionTitle) {
+    return `PDF table block ${sectionTitle}`;
+  }
+  if (pdfTextKind === "paragraph" && sectionTitle) {
+    return `PDF text block ${sectionTitle}`;
+  }
+  if (officeBlockKind === "table" && sectionTitle) {
+    return `Office table block ${sectionTitle}`;
+  }
+  if (officeBlockKind === "list" && sectionTitle) {
+    return `Office list block ${sectionTitle}`;
+  }
+  if (officeBlockKind === "paragraph" && sectionTitle) {
+    return `Office paragraph block ${sectionTitle}`;
+  }
   const emailKind = getContextString2(metadata.emailKind);
   if (emailKind === "attachment") {
     return "Attachment evidence";
@@ -1208,8 +1227,6 @@ var buildContextLabel2 = (metadata) => {
   if (speaker) {
     return `Speaker ${speaker}`;
   }
-  const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : [];
-  const sectionTitle = getContextString2(metadata.sectionTitle) ?? sectionPath.at(-1);
   if (sectionTitle) {
     return `Section ${sectionTitle}`;
   }
@@ -1219,11 +1236,21 @@ var buildLocatorLabel2 = (metadata, source, title) => {
   if (!metadata) {
     return;
   }
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
+  const pdfBlockNumber = getContextNumber2(metadata.pdfBlockNumber);
+  const officeBlockNumber = getContextNumber2(metadata.officeBlockNumber);
   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 && pdfBlockNumber && pdfTextKind === "table_like") {
+    return `Page ${page} · Table Block ${pdfBlockNumber}`;
+  }
+  if (page && pdfBlockNumber) {
+    return `Page ${page} · Text Block ${pdfBlockNumber}`;
+  }
   if (page) {
     return `Page ${page}`;
   }
@@ -1252,6 +1279,15 @@ var buildLocatorLabel2 = (metadata, source, title) => {
   if (mediaStart) {
     return `Timestamp ${mediaStart}`;
   }
+  if (officeBlockNumber && officeBlockKind === "table") {
+    return `Office table block ${officeBlockNumber}`;
+  }
+  if (officeBlockNumber && officeBlockKind === "list") {
+    return `Office list block ${officeBlockNumber}`;
+  }
+  if (officeBlockNumber && officeBlockKind === "paragraph") {
+    return `Office paragraph block ${officeBlockNumber}`;
+  }
   const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : [];
   if (sectionPath.length > 0) {
     return `Section ${sectionPath.join(" > ")}`;
@@ -1269,12 +1305,16 @@ var buildProvenanceLabel2 = (metadata) => {
   const mediaKind = getContextString2(metadata.mediaKind);
   const transcriptSource = getContextString2(metadata.transcriptSource);
   const pdfTextMode = getContextString2(metadata.pdfTextMode);
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
   const ocrEngine = getContextString2(metadata.ocrEngine);
   const extractorRegistryMatch = getContextString2(metadata.extractorRegistryMatch);
   const chunkingProfile = getContextString2(metadata.chunkingProfile);
   const ocrConfidence = getContextNumber2(metadata.ocrRegionConfidence) ?? getContextNumber2(metadata.ocrConfidence);
   const labels = [
     pdfTextMode ? `PDF ${pdfTextMode}` : "",
+    pdfTextKind === "table_like" ? "PDF table block" : pdfTextKind === "paragraph" ? "PDF text block" : "",
+    officeBlockKind ? `Office ${officeBlockKind}` : "",
     ocrEngine ? `OCR ${ocrEngine}` : "",
     extractorRegistryMatch ? `Extractor ${extractorRegistryMatch}` : "",
     chunkingProfile ? `Chunking ${chunkingProfile}` : "",
@@ -1310,7 +1350,7 @@ var buildRAGChunkStructure = (metadata) => {
     return;
   }
   const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.filter((value) => typeof value === "string" && value.trim().length > 0) : undefined;
-  const sectionKind = metadata.sectionKind === "markdown_heading" || metadata.sectionKind === "html_heading" || metadata.sectionKind === "office_heading" || metadata.sectionKind === "spreadsheet_rows" || metadata.sectionKind === "presentation_slide" ? metadata.sectionKind : undefined;
+  const sectionKind = metadata.sectionKind === "markdown_heading" || metadata.sectionKind === "html_heading" || metadata.sectionKind === "office_heading" || metadata.sectionKind === "office_block" || metadata.sectionKind === "pdf_block" || metadata.sectionKind === "spreadsheet_rows" || metadata.sectionKind === "presentation_slide" ? metadata.sectionKind : undefined;
   const section = {
     depth: getContextNumber2(metadata.sectionDepth),
     kind: sectionKind,
@@ -1630,7 +1670,7 @@ var buildRAGSourceSummaries = (sources) => {
   const citationReferenceMap = buildRAGCitationReferenceMap(citations);
   return sourceGroups.map((group) => {
     const groupCitations = citations.filter((citation) => group.chunks.some((chunk) => chunk.chunkId === citation.chunkId));
-    const leadChunk = group.chunks.slice().sort((left, right) => right.score - left.score)[0];
+    const leadChunk = getPreferredSourceLeadChunk(group.chunks);
     const excerpts = leadChunk ? buildRAGChunkExcerpts(group.chunks, leadChunk.chunkId) : undefined;
     const structure = leadChunk?.structure ?? buildRAGChunkStructure(leadChunk?.metadata);
     const excerptSelection = buildRAGExcerptSelection(excerpts, structure);
@@ -1658,13 +1698,45 @@ var getSectionPathFromSource = (source) => {
   const path = source.structure?.section?.path ?? (Array.isArray(source.metadata?.sectionPath) ? source.metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : []);
   return path.length > 0 ? path : undefined;
 };
+var isBlockAwareContextLabel = (value) => typeof value === "string" && (value.startsWith("PDF ") || value.startsWith("Office "));
+var getStructuredSectionScoreWeight = (metadata) => {
+  if (!metadata) {
+    return 1;
+  }
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
+  const sectionKind = getContextString2(metadata.sectionKind);
+  if (pdfTextKind === "table_like") {
+    return 1.28;
+  }
+  if (officeBlockKind === "table" || officeBlockKind === "list") {
+    return 1.24;
+  }
+  if (sectionKind === "pdf_block" || sectionKind === "office_block" || officeBlockKind === "paragraph" || pdfTextKind === "paragraph") {
+    return 1.12;
+  }
+  return 1;
+};
+var getStructuredSourceLeadScore = (source) => source.score * getStructuredSectionScoreWeight(source.metadata);
+var getPreferredSourceLeadChunk = (chunks) => chunks.slice().sort((left, right) => {
+  const leftWeightedScore = getStructuredSourceLeadScore(left);
+  const rightWeightedScore = getStructuredSourceLeadScore(right);
+  if (rightWeightedScore !== leftWeightedScore) {
+    return rightWeightedScore - leftWeightedScore;
+  }
+  if (right.score !== left.score) {
+    return right.score - left.score;
+  }
+  return left.chunkId.localeCompare(right.chunkId);
+})[0];
 var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
-  const totalScore = sources.reduce((sum, source) => sum + source.score, 0);
+  const totalScore = sources.reduce((sum, source) => sum + source.score * getStructuredSectionScoreWeight(source.metadata), 0);
   if (sources.length === 0 || totalScore <= 0) {
     return [];
   }
   const sections = new Map;
   for (const source of sources) {
+    const structuredScore = source.score * getStructuredSectionScoreWeight(source.metadata);
     const path = getSectionPathFromSource(source);
     if (!path) {
       continue;
@@ -1696,7 +1768,7 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
         sourceSet: new Set(source.source ? [source.source] : []),
         topChunkId: source.chunkId,
         topSource: source.source,
-        totalScore: source.score,
+        totalScore: structuredScore,
         transformedHits,
         variantHits,
         vectorHits
@@ -1704,7 +1776,7 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
       continue;
     }
     existing.count += 1;
-    existing.totalScore += source.score;
+    existing.totalScore += structuredScore;
     if (source.source) {
       existing.sourceSet.add(source.source);
     }
@@ -1732,6 +1804,8 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
     const parentTotal = siblingPool.reduce((sum, entry) => sum + entry.totalScore, 0);
     const scoreShare = section.totalScore / totalScore;
     const parentShare = parentTotal > 0 ? section.totalScore / parentTotal : undefined;
+    const topChunk = sources.find((source) => source.chunkId === section.topChunkId);
+    const topContextLabel = topChunk?.labels?.contextLabel ?? buildContextLabel2(topChunk?.metadata);
     const parentDistribution = parentTotal > 0 ? siblingPool.map((entry) => ({
       count: entry.count,
       isActive: entry.key === section.key,
@@ -1857,6 +1931,7 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
       reasons.push("concentrated_evidence");
     }
     const summaryParts = [
+      isBlockAwareContextLabel(topContextLabel) ? topContextLabel : "",
       `${section.count} hit${section.count === 1 ? "" : "s"}`,
       `${(scoreShare * 100).toFixed(0)}% score share`,
       `vector ${section.vectorHits} · lexical ${section.lexicalHits} · hybrid ${section.hybridHits}`,
@@ -2068,22 +2143,21 @@ var updateSourceGroup = (groups, source) => {
     groups.set(key, buildSourceGroup(source, key));
     return;
   }
-  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.structure = source.structure ?? buildRAGChunkStructure(source.metadata);
-    existing.source = source.source;
-    existing.title = source.title;
-  } else {
-    existing.bestScore = Math.max(existing.bestScore, source.score);
-  }
+  existing.bestScore = Math.max(existing.bestScore, source.score);
   existing.count += 1;
   existing.chunks.push(source);
+  const leadChunk = getPreferredSourceLeadChunk(existing.chunks);
+  if (leadChunk) {
+    existing.label = buildSourceLabel2(leadChunk);
+    existing.labels = leadChunk.labels ?? buildRAGSourceLabels({
+      metadata: leadChunk.metadata,
+      source: leadChunk.source,
+      title: leadChunk.title
+    });
+    existing.structure = leadChunk.structure ?? buildRAGChunkStructure(leadChunk.metadata);
+    existing.source = leadChunk.source;
+    existing.title = leadChunk.title;
+  }
 };
 var getLatestAssistantMessage = (messages) => {
   for (let index = messages.length - 1;index >= 0; index -= 1) {

package/dist/ai-client/vue/ai/index.js

@@ -2215,6 +2215,25 @@ var buildContextLabel2 = (metadata) => {
   if (!metadata) {
     return;
   }
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
+  const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : [];
+  const sectionTitle = getContextString2(metadata.sectionTitle) ?? sectionPath.at(-1);
+  if (pdfTextKind === "table_like" && sectionTitle) {
+    return `PDF table block ${sectionTitle}`;
+  }
+  if (pdfTextKind === "paragraph" && sectionTitle) {
+    return `PDF text block ${sectionTitle}`;
+  }
+  if (officeBlockKind === "table" && sectionTitle) {
+    return `Office table block ${sectionTitle}`;
+  }
+  if (officeBlockKind === "list" && sectionTitle) {
+    return `Office list block ${sectionTitle}`;
+  }
+  if (officeBlockKind === "paragraph" && sectionTitle) {
+    return `Office paragraph block ${sectionTitle}`;
+  }
   const emailKind = getContextString2(metadata.emailKind);
   if (emailKind === "attachment") {
     return "Attachment evidence";
@@ -2251,8 +2270,6 @@ var buildContextLabel2 = (metadata) => {
   if (speaker) {
     return `Speaker ${speaker}`;
   }
-  const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : [];
-  const sectionTitle = getContextString2(metadata.sectionTitle) ?? sectionPath.at(-1);
   if (sectionTitle) {
     return `Section ${sectionTitle}`;
   }
@@ -2262,11 +2279,21 @@ var buildLocatorLabel2 = (metadata, source, title) => {
   if (!metadata) {
     return;
   }
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
+  const pdfBlockNumber = getContextNumber2(metadata.pdfBlockNumber);
+  const officeBlockNumber = getContextNumber2(metadata.officeBlockNumber);
   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 && pdfBlockNumber && pdfTextKind === "table_like") {
+    return `Page ${page} · Table Block ${pdfBlockNumber}`;
+  }
+  if (page && pdfBlockNumber) {
+    return `Page ${page} · Text Block ${pdfBlockNumber}`;
+  }
   if (page) {
     return `Page ${page}`;
   }
@@ -2295,6 +2322,15 @@ var buildLocatorLabel2 = (metadata, source, title) => {
   if (mediaStart) {
     return `Timestamp ${mediaStart}`;
   }
+  if (officeBlockNumber && officeBlockKind === "table") {
+    return `Office table block ${officeBlockNumber}`;
+  }
+  if (officeBlockNumber && officeBlockKind === "list") {
+    return `Office list block ${officeBlockNumber}`;
+  }
+  if (officeBlockNumber && officeBlockKind === "paragraph") {
+    return `Office paragraph block ${officeBlockNumber}`;
+  }
   const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : [];
   if (sectionPath.length > 0) {
     return `Section ${sectionPath.join(" > ")}`;
@@ -2312,12 +2348,16 @@ var buildProvenanceLabel2 = (metadata) => {
   const mediaKind = getContextString2(metadata.mediaKind);
   const transcriptSource = getContextString2(metadata.transcriptSource);
   const pdfTextMode = getContextString2(metadata.pdfTextMode);
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
   const ocrEngine = getContextString2(metadata.ocrEngine);
   const extractorRegistryMatch = getContextString2(metadata.extractorRegistryMatch);
   const chunkingProfile = getContextString2(metadata.chunkingProfile);
   const ocrConfidence = getContextNumber2(metadata.ocrRegionConfidence) ?? getContextNumber2(metadata.ocrConfidence);
   const labels = [
     pdfTextMode ? `PDF ${pdfTextMode}` : "",
+    pdfTextKind === "table_like" ? "PDF table block" : pdfTextKind === "paragraph" ? "PDF text block" : "",
+    officeBlockKind ? `Office ${officeBlockKind}` : "",
     ocrEngine ? `OCR ${ocrEngine}` : "",
     extractorRegistryMatch ? `Extractor ${extractorRegistryMatch}` : "",
     chunkingProfile ? `Chunking ${chunkingProfile}` : "",
@@ -2353,7 +2393,7 @@ var buildRAGChunkStructure = (metadata) => {
     return;
   }
   const sectionPath = Array.isArray(metadata.sectionPath) ? metadata.sectionPath.filter((value) => typeof value === "string" && value.trim().length > 0) : undefined;
-  const sectionKind = metadata.sectionKind === "markdown_heading" || metadata.sectionKind === "html_heading" || metadata.sectionKind === "office_heading" || metadata.sectionKind === "spreadsheet_rows" || metadata.sectionKind === "presentation_slide" ? metadata.sectionKind : undefined;
+  const sectionKind = metadata.sectionKind === "markdown_heading" || metadata.sectionKind === "html_heading" || metadata.sectionKind === "office_heading" || metadata.sectionKind === "office_block" || metadata.sectionKind === "pdf_block" || metadata.sectionKind === "spreadsheet_rows" || metadata.sectionKind === "presentation_slide" ? metadata.sectionKind : undefined;
   const section = {
     depth: getContextNumber2(metadata.sectionDepth),
     kind: sectionKind,
@@ -2673,7 +2713,7 @@ var buildRAGSourceSummaries = (sources) => {
   const citationReferenceMap = buildRAGCitationReferenceMap(citations);
   return sourceGroups.map((group) => {
     const groupCitations = citations.filter((citation) => group.chunks.some((chunk) => chunk.chunkId === citation.chunkId));
-    const leadChunk = group.chunks.slice().sort((left, right) => right.score - left.score)[0];
+    const leadChunk = getPreferredSourceLeadChunk(group.chunks);
     const excerpts = leadChunk ? buildRAGChunkExcerpts(group.chunks, leadChunk.chunkId) : undefined;
     const structure = leadChunk?.structure ?? buildRAGChunkStructure(leadChunk?.metadata);
     const excerptSelection = buildRAGExcerptSelection(excerpts, structure);
@@ -2701,13 +2741,45 @@ var getSectionPathFromSource = (source) => {
   const path = source.structure?.section?.path ?? (Array.isArray(source.metadata?.sectionPath) ? source.metadata.sectionPath.map((value) => getContextString2(value)).filter((value) => typeof value === "string") : []);
   return path.length > 0 ? path : undefined;
 };
+var isBlockAwareContextLabel = (value) => typeof value === "string" && (value.startsWith("PDF ") || value.startsWith("Office "));
+var getStructuredSectionScoreWeight = (metadata) => {
+  if (!metadata) {
+    return 1;
+  }
+  const pdfTextKind = getContextString2(metadata.pdfTextKind);
+  const officeBlockKind = getContextString2(metadata.officeBlockKind);
+  const sectionKind = getContextString2(metadata.sectionKind);
+  if (pdfTextKind === "table_like") {
+    return 1.28;
+  }
+  if (officeBlockKind === "table" || officeBlockKind === "list") {
+    return 1.24;
+  }
+  if (sectionKind === "pdf_block" || sectionKind === "office_block" || officeBlockKind === "paragraph" || pdfTextKind === "paragraph") {
+    return 1.12;
+  }
+  return 1;
+};
+var getStructuredSourceLeadScore = (source) => source.score * getStructuredSectionScoreWeight(source.metadata);
+var getPreferredSourceLeadChunk = (chunks) => chunks.slice().sort((left, right) => {
+  const leftWeightedScore = getStructuredSourceLeadScore(left);
+  const rightWeightedScore = getStructuredSourceLeadScore(right);
+  if (rightWeightedScore !== leftWeightedScore) {
+    return rightWeightedScore - leftWeightedScore;
+  }
+  if (right.score !== left.score) {
+    return right.score - left.score;
+  }
+  return left.chunkId.localeCompare(right.chunkId);
+})[0];
 var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
-  const totalScore = sources.reduce((sum, source) => sum + source.score, 0);
+  const totalScore = sources.reduce((sum, source) => sum + source.score * getStructuredSectionScoreWeight(source.metadata), 0);
   if (sources.length === 0 || totalScore <= 0) {
     return [];
   }
   const sections = new Map;
   for (const source of sources) {
+    const structuredScore = source.score * getStructuredSectionScoreWeight(source.metadata);
     const path = getSectionPathFromSource(source);
     if (!path) {
       continue;
@@ -2739,7 +2811,7 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
         sourceSet: new Set(source.source ? [source.source] : []),
         topChunkId: source.chunkId,
         topSource: source.source,
-        totalScore: source.score,
+        totalScore: structuredScore,
         transformedHits,
         variantHits,
         vectorHits
@@ -2747,7 +2819,7 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
       continue;
     }
     existing.count += 1;
-    existing.totalScore += source.score;
+    existing.totalScore += structuredScore;
     if (source.source) {
       existing.sourceSet.add(source.source);
     }
@@ -2775,6 +2847,8 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
     const parentTotal = siblingPool.reduce((sum, entry) => sum + entry.totalScore, 0);
     const scoreShare = section.totalScore / totalScore;
     const parentShare = parentTotal > 0 ? section.totalScore / parentTotal : undefined;
+    const topChunk = sources.find((source) => source.chunkId === section.topChunkId);
+    const topContextLabel = topChunk?.labels?.contextLabel ?? buildContextLabel2(topChunk?.metadata);
     const parentDistribution = parentTotal > 0 ? siblingPool.map((entry) => ({
       count: entry.count,
       isActive: entry.key === section.key,
@@ -2900,6 +2974,7 @@ var buildRAGSectionRetrievalDiagnostics = (sources, trace) => {
       reasons.push("concentrated_evidence");
     }
     const summaryParts = [
+      isBlockAwareContextLabel(topContextLabel) ? topContextLabel : "",
       `${section.count} hit${section.count === 1 ? "" : "s"}`,
       `${(scoreShare * 100).toFixed(0)}% score share`,
       `vector ${section.vectorHits} · lexical ${section.lexicalHits} · hybrid ${section.hybridHits}`,
@@ -3111,22 +3186,21 @@ var updateSourceGroup = (groups, source) => {
     groups.set(key, buildSourceGroup(source, key));
     return;
   }
-  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.structure = source.structure ?? buildRAGChunkStructure(source.metadata);
-    existing.source = source.source;
-    existing.title = source.title;
-  } else {
-    existing.bestScore = Math.max(existing.bestScore, source.score);
-  }
+  existing.bestScore = Math.max(existing.bestScore, source.score);
   existing.count += 1;
   existing.chunks.push(source);
+  const leadChunk = getPreferredSourceLeadChunk(existing.chunks);
+  if (leadChunk) {
+    existing.label = buildSourceLabel2(leadChunk);
+    existing.labels = leadChunk.labels ?? buildRAGSourceLabels({
+      metadata: leadChunk.metadata,
+      source: leadChunk.source,
+      title: leadChunk.title
+    });
+    existing.structure = leadChunk.structure ?? buildRAGChunkStructure(leadChunk.metadata);
+    existing.source = leadChunk.source;
+    existing.title = leadChunk.title;
+  }
 };
 var getLatestAssistantMessage = (messages) => {
   for (let index = messages.length - 1;index >= 0; index -= 1) {