@absolutejs/absolute 0.19.0-beta.512 → 0.19.0-beta.514

package/dist/ai/index.js

@@ -4974,6 +4974,75 @@ var summarizeRAGRerankerComparison = (entries) => {
 var summarizeRAGRetrievalComparison = (entries) => summarizeEvaluationResponseComparison(entries, "retrievalId");
 
 // src/ai/rag/types.ts
+var getContextNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var getContextString = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+var formatMediaTimestamp = (value) => {
+  if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
+    return;
+  }
+  const totalSeconds = Math.floor(value / 1000);
+  const minutes = Math.floor(totalSeconds / 60);
+  const seconds = totalSeconds % 60;
+  const milliseconds = Math.floor(value % 1000);
+  return `${String(minutes).padStart(2, "0")}:${String(seconds).padStart(2, "0")}.${String(milliseconds).padStart(3, "0")}`;
+};
+var buildRAGContextLocatorLabel = (metadata, source, title) => {
+  if (!metadata) {
+    return;
+  }
+  const page = getContextNumber(metadata.page) ?? getContextNumber(metadata.pageNumber) ?? (typeof metadata.pageIndex === "number" ? metadata.pageIndex + 1 : undefined);
+  if (page) {
+    return `Page ${page}`;
+  }
+  const sheet = getContextString(metadata.sheetName) ?? (Array.isArray(metadata.sheetNames) ? getContextString(metadata.sheetNames[0]) : undefined);
+  if (sheet) {
+    return `Sheet ${sheet}`;
+  }
+  const slide = getContextNumber(metadata.slide) ?? getContextNumber(metadata.slideNumber) ?? (typeof metadata.slideIndex === "number" ? metadata.slideIndex + 1 : undefined);
+  if (slide) {
+    return `Slide ${slide}`;
+  }
+  const archiveEntry = getContextString(metadata.archiveEntryPath) ?? getContextString(metadata.entryPath);
+  if (archiveEntry) {
+    return `Archive entry ${archiveEntry}`;
+  }
+  const emailKind = getContextString(metadata.emailKind);
+  if (emailKind === "attachment") {
+    const attachmentName = getContextString(metadata.attachmentName) ?? source?.split("/").at(-1) ?? title?.split(" \xB7 ").at(-1);
+    return attachmentName ? `Attachment ${attachmentName}` : "Attachment";
+  }
+  const mediaStart = formatMediaTimestamp(metadata.startMs);
+  const mediaEnd = formatMediaTimestamp(metadata.endMs);
+  if (mediaStart && mediaEnd) {
+    return `Timestamp ${mediaStart} - ${mediaEnd}`;
+  }
+  if (mediaStart) {
+    return `Timestamp ${mediaStart}`;
+  }
+  return;
+};
+var buildRAGContextProvenanceLabel = (metadata) => {
+  if (!metadata) {
+    return;
+  }
+  const pdfTextMode = getContextString(metadata.pdfTextMode);
+  const ocrEngine = getContextString(metadata.ocrEngine);
+  const mediaKind = getContextString(metadata.mediaKind);
+  const transcriptSource = getContextString(metadata.transcriptSource);
+  const threadTopic = getContextString(metadata.threadTopic);
+  const from = getContextString(metadata.from);
+  const speaker = getContextString(metadata.speaker);
+  const labels = [
+    pdfTextMode ? `PDF ${pdfTextMode}` : "",
+    ocrEngine ? `OCR ${ocrEngine}` : "",
+    mediaKind ? `Media ${mediaKind}` : "",
+    transcriptSource ? `Transcript ${transcriptSource}` : "",
+    threadTopic ? `Thread ${threadTopic}` : "",
+    speaker ? `Speaker ${speaker}` : "",
+    from ? `Sender ${from}` : ""
+  ].filter((value) => value.length > 0);
+  return labels.length > 0 ? labels.join(" \xB7 ") : undefined;
+};
 var buildRAGContext = (hits) => {
   if (hits.length === 0) {
     return "";
@@ -4981,15 +5050,23 @@ var buildRAGContext = (hits) => {
   const sourceLines = hits.map((hit, index) => {
     const source = hit.source ? ` (${hit.source})` : "";
     const title = hit.title ? ` ${hit.title}` : "";
-    return `[${index + 1}]${title}${source}
-${hit.chunkText.trim()}`;
+    const locatorLabel = buildRAGContextLocatorLabel(hit.metadata, hit.source, hit.title);
+    const provenanceLabel = buildRAGContextProvenanceLabel(hit.metadata);
+    const evidenceLines = [
+      `[${index + 1}]${title}${source}`,
+      locatorLabel ? `Location: ${locatorLabel}` : "",
+      provenanceLabel ? `Provenance: ${provenanceLabel}` : "",
+      hit.chunkText.trim()
+    ].filter((value) => value.length > 0);
+    return evidenceLines.join(`
+`);
   });
   return `Use the following context for this question:
 ${sourceLines.join(`
 
 `)}
 
-Answer with citations like [1], [2] when you use specific context.`;
+When you use retrieved context, cite it inline with [1], [2]. Prefer the most specific evidence available and preserve page, sheet, slide, timestamp, attachment, or thread cues when the context provides them.`;
 };
 
 // src/ai/rag/chat.ts
@@ -7318,8 +7395,8 @@ ${tag} OK`) || chunk.startsWith(`${tag} OK`));
 // src/ai/rag/presentation.ts
 var buildSourceGroupKey = (source) => source.source ?? source.title ?? source.chunkId;
 var buildSourceLabel = (source) => source.source ?? source.title ?? source.chunkId;
-var getContextNumber = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
-var getContextString = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
+var getContextNumber2 = (value) => typeof value === "number" && Number.isFinite(value) ? value : undefined;
+var getContextString2 = (value) => typeof value === "string" && value.trim().length > 0 ? value.trim() : undefined;
 var formatTimestampLabel = (value) => {
   const timestamp = typeof value === "number" && Number.isFinite(value) ? value : typeof value === "string" ? Date.parse(value) : Number.NaN;
   if (!Number.isFinite(timestamp)) {
@@ -7330,7 +7407,7 @@ var formatTimestampLabel = (value) => {
     timeStyle: "short"
   });
 };
-var formatMediaTimestamp = (value) => {
+var formatMediaTimestamp2 = (value) => {
   if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
     return;
   }
@@ -7355,35 +7432,35 @@ var buildContextLabel = (metadata) => {
   if (!metadata) {
     return;
   }
-  const emailKind = getContextString(metadata.emailKind);
+  const emailKind = getContextString2(metadata.emailKind);
   if (emailKind === "attachment") {
     return "Attachment evidence";
   }
   if (emailKind === "message") {
-    const from = getContextString(metadata.from);
+    const from = getContextString2(metadata.from);
     return from ? `Message from ${from}` : "Message evidence";
   }
-  const page = getContextNumber(metadata.page) ?? getContextNumber(metadata.pageNumber) ?? (typeof metadata.pageIndex === "number" ? metadata.pageIndex + 1 : undefined);
+  const page = getContextNumber2(metadata.page) ?? getContextNumber2(metadata.pageNumber) ?? (typeof metadata.pageIndex === "number" ? metadata.pageIndex + 1 : undefined);
   if (page) {
     return `Page ${page}`;
   }
-  const sheet = getContextString(metadata.sheetName) ?? (Array.isArray(metadata.sheetNames) ? getContextString(metadata.sheetNames[0]) : undefined);
+  const sheet = getContextString2(metadata.sheetName) ?? (Array.isArray(metadata.sheetNames) ? getContextString2(metadata.sheetNames[0]) : undefined);
   if (sheet) {
     return `Sheet ${sheet}`;
   }
-  const slide = getContextNumber(metadata.slide) ?? getContextNumber(metadata.slideNumber) ?? (typeof metadata.slideIndex === "number" ? metadata.slideIndex + 1 : undefined);
+  const slide = getContextNumber2(metadata.slide) ?? getContextNumber2(metadata.slideNumber) ?? (typeof metadata.slideIndex === "number" ? metadata.slideIndex + 1 : undefined);
   if (slide) {
     return `Slide ${slide}`;
   }
-  const archiveEntry = getContextString(metadata.archiveEntryPath) ?? getContextString(metadata.entryPath);
+  const archiveEntry = getContextString2(metadata.archiveEntryPath) ?? getContextString2(metadata.entryPath);
   if (archiveEntry) {
     return `Archive entry ${archiveEntry}`;
   }
-  const threadTopic = getContextString(metadata.threadTopic);
+  const threadTopic = getContextString2(metadata.threadTopic);
   if (threadTopic) {
     return `Thread ${threadTopic}`;
   }
-  const speaker = getContextString(metadata.speaker);
+  const speaker = getContextString2(metadata.speaker);
   if (speaker) {
     return `Speaker ${speaker}`;
   }
@@ -7393,29 +7470,29 @@ var buildLocatorLabel = (metadata, source, title) => {
   if (!metadata) {
     return;
   }
-  const page = getContextNumber(metadata.page) ?? getContextNumber(metadata.pageNumber) ?? (typeof metadata.pageIndex === "number" ? metadata.pageIndex + 1 : undefined);
+  const page = getContextNumber2(metadata.page) ?? getContextNumber2(metadata.pageNumber) ?? (typeof metadata.pageIndex === "number" ? metadata.pageIndex + 1 : undefined);
   if (page) {
     return `Page ${page}`;
   }
-  const sheet = getContextString(metadata.sheetName) ?? (Array.isArray(metadata.sheetNames) ? getContextString(metadata.sheetNames[0]) : undefined);
+  const sheet = getContextString2(metadata.sheetName) ?? (Array.isArray(metadata.sheetNames) ? getContextString2(metadata.sheetNames[0]) : undefined);
   if (sheet) {
     return `Sheet ${sheet}`;
   }
-  const slide = getContextNumber(metadata.slide) ?? getContextNumber(metadata.slideNumber) ?? (typeof metadata.slideIndex === "number" ? metadata.slideIndex + 1 : undefined);
+  const slide = getContextNumber2(metadata.slide) ?? getContextNumber2(metadata.slideNumber) ?? (typeof metadata.slideIndex === "number" ? metadata.slideIndex + 1 : undefined);
   if (slide) {
     return `Slide ${slide}`;
   }
-  const archiveEntry = getContextString(metadata.archiveEntryPath) ?? getContextString(metadata.entryPath);
+  const archiveEntry = getContextString2(metadata.archiveEntryPath) ?? getContextString2(metadata.entryPath);
   if (archiveEntry) {
     return `Archive entry ${archiveEntry}`;
   }
-  const emailKind = getContextString(metadata.emailKind);
+  const emailKind = getContextString2(metadata.emailKind);
   if (emailKind === "attachment") {
-    const attachmentName = getContextString(metadata.attachmentName) ?? getAttachmentName(source, title);
+    const attachmentName = getContextString2(metadata.attachmentName) ?? getAttachmentName(source, title);
     return attachmentName ? `Attachment ${attachmentName}` : "Attachment";
   }
-  const mediaStart = formatMediaTimestamp(metadata.startMs);
-  const mediaEnd = formatMediaTimestamp(metadata.endMs);
+  const mediaStart = formatMediaTimestamp2(metadata.startMs);
+  const mediaEnd = formatMediaTimestamp2(metadata.endMs);
   if (mediaStart && mediaEnd) {
     return `Timestamp ${mediaStart} - ${mediaEnd}`;
   }
@@ -7428,14 +7505,14 @@ var buildProvenanceLabel = (metadata) => {
   if (!metadata) {
     return;
   }
-  const threadTopic = getContextString(metadata.threadTopic);
-  const from = getContextString(metadata.from);
+  const threadTopic = getContextString2(metadata.threadTopic);
+  const from = getContextString2(metadata.from);
   const sentAt = formatTimestampLabel(metadata.sentAt) ?? formatTimestampLabel(metadata.receivedAt);
-  const speaker = getContextString(metadata.speaker);
-  const mediaKind = getContextString(metadata.mediaKind);
-  const transcriptSource = getContextString(metadata.transcriptSource);
-  const pdfTextMode = getContextString(metadata.pdfTextMode);
-  const ocrEngine = getContextString(metadata.ocrEngine);
+  const speaker = getContextString2(metadata.speaker);
+  const mediaKind = getContextString2(metadata.mediaKind);
+  const transcriptSource = getContextString2(metadata.transcriptSource);
+  const pdfTextMode = getContextString2(metadata.pdfTextMode);
+  const ocrEngine = getContextString2(metadata.ocrEngine);
   const labels = [
     pdfTextMode ? `PDF ${pdfTextMode}` : "",
     ocrEngine ? `OCR ${ocrEngine}` : "",
@@ -7485,6 +7562,23 @@ var buildExcerpt = (text, maxLength = 160) => {
   }
   return `${normalized.slice(0, Math.max(0, maxLength - 1)).trimEnd()}\u2026`;
 };
+var buildGroundingReferenceEvidenceLabel = (reference) => [reference.label, reference.locatorLabel, reference.contextLabel].filter((value) => Boolean(value && value.length > 0)).filter((value, index, values) => values.findIndex((entry) => entry === value) === index).join(" \xB7 ");
+var buildGroundingReferenceEvidenceSummary = (reference) => [
+  reference.source ?? reference.title ?? reference.chunkId,
+  reference.provenanceLabel
+].filter((value) => Boolean(value && value.length > 0)).join(" \xB7 ");
+var buildGroundedAnswerCitationDetail = (reference) => ({
+  contextLabel: reference.contextLabel,
+  evidenceLabel: buildGroundingReferenceEvidenceLabel(reference),
+  evidenceSummary: buildGroundingReferenceEvidenceSummary(reference),
+  excerpt: reference.excerpt,
+  label: reference.label,
+  locatorLabel: reference.locatorLabel,
+  number: reference.number,
+  provenanceLabel: reference.provenanceLabel,
+  source: reference.source,
+  title: reference.title
+});
 var buildRAGGroundedAnswer = (content, sources) => {
   const references = buildRAGGroundingReferences(sources);
   const referenceMap = new Map(references.map((reference) => [reference.number, reference]));
@@ -7508,11 +7602,14 @@ var buildRAGGroundedAnswer = (content, sources) => {
         ungroundedReferenceNumbers.add(number);
       }
     }
+    const unresolvedNumbers = numbers.filter((number) => !referenceMap.has(number));
     parts.push({
       referenceNumbers: numbers,
+      referenceDetails: resolvedReferences.map(buildGroundedAnswerCitationDetail),
       references: resolvedReferences,
       text: raw,
-      type: "citation"
+      type: "citation",
+      unresolvedReferenceNumbers: unresolvedNumbers
     });
     cursor = start + raw.length;
   }
@@ -10400,5 +10497,5 @@ export {
   aiChat
 };
 
-//# debugId=E67FA7078681805C64756E2164756E21
+//# debugId=B33CC824E07DC89F64756E2164756E21
 //# sourceMappingURL=index.js.map