@absolutejs/absolute 0.19.0-beta.513 → 0.19.0-beta.515

package/dist/ai/index.js

@@ -4974,6 +4974,123 @@ 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 buildRAGContextCitationGuidance = (hits) => {
+  const needsPageGuidance = hits.some((hit) => {
+    const metadata = hit.metadata;
+    if (!metadata) {
+      return false;
+    }
+    return getContextNumber(metadata.page) !== undefined || getContextNumber(metadata.pageNumber) !== undefined || typeof metadata.pageIndex === "number";
+  });
+  const needsSheetGuidance = hits.some((hit) => {
+    const metadata = hit.metadata;
+    if (!metadata) {
+      return false;
+    }
+    return getContextString(metadata.sheetName) !== undefined || Array.isArray(metadata.sheetNames) && getContextString(metadata.sheetNames[0]) !== undefined;
+  });
+  const needsSlideGuidance = hits.some((hit) => {
+    const metadata = hit.metadata;
+    if (!metadata) {
+      return false;
+    }
+    return getContextNumber(metadata.slide) !== undefined || getContextNumber(metadata.slideNumber) !== undefined || typeof metadata.slideIndex === "number";
+  });
+  const needsTimestampGuidance = hits.some((hit) => {
+    const metadata = hit.metadata;
+    if (!metadata) {
+      return false;
+    }
+    return typeof metadata.startMs === "number" || typeof metadata.endMs === "number";
+  });
+  const needsAttachmentGuidance = hits.some((hit) => getContextString(hit.metadata?.emailKind) === "attachment");
+  const needsThreadGuidance = hits.some((hit) => getContextString(hit.metadata?.threadTopic) !== undefined || getContextString(hit.metadata?.from) !== undefined);
+  const needsArchiveGuidance = hits.some((hit) => {
+    const metadata = hit.metadata;
+    return getContextString(metadata?.archiveEntryPath) !== undefined || getContextString(metadata?.entryPath) !== undefined;
+  });
+  const guidanceLines = [
+    "When you use retrieved context, cite it inline with [1], [2]. Prefer the most specific evidence available and preserve page, sheet, slide, timestamp, attachment, archive entry, or thread cues when the context provides them.",
+    needsPageGuidance ? "For PDF evidence, keep the cited page number in the answer when the context includes one." : "",
+    needsSheetGuidance ? "For spreadsheet evidence, name the worksheet when the context identifies a sheet." : "",
+    needsSlideGuidance ? "For presentation evidence, keep the slide number in the answer when the context provides it." : "",
+    needsTimestampGuidance ? "For media evidence, preserve the cited timestamp range in the answer." : "",
+    needsAttachmentGuidance ? "For email attachment evidence, distinguish the attachment from the parent message." : "",
+    needsThreadGuidance ? "For email message evidence, preserve sender or thread cues when they matter to the claim." : "",
+    needsArchiveGuidance ? "For archive evidence, identify the archive entry path instead of only naming the outer archive." : ""
+  ].filter((value) => value.length > 0);
+  return guidanceLines.join(`
+`);
+};
 var buildRAGContext = (hits) => {
   if (hits.length === 0) {
     return "";
@@ -4981,15 +5098,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.`;
+${buildRAGContextCitationGuidance(hits)}`;
 };
 
 // src/ai/rag/chat.ts
@@ -7318,8 +7443,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 +7455,7 @@ var formatTimestampLabel = (value) => {
     timeStyle: "short"
   });
 };
-var formatMediaTimestamp = (value) => {
+var formatMediaTimestamp2 = (value) => {
   if (typeof value !== "number" || !Number.isFinite(value) || value < 0) {
     return;
   }
@@ -7355,35 +7480,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 +7518,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 +7553,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}` : "",
@@ -10420,5 +10545,5 @@ export {
   aiChat
 };
 
-//# debugId=92744A9C86B6EB9164756E2164756E21
+//# debugId=80D809BE3389E86564756E2164756E21
 //# sourceMappingURL=index.js.map