@absolutejs/absolute 0.19.0-beta.635 → 0.19.0-beta.637

package/dist/ai/index.js

@@ -749,7 +749,7 @@ var formatLeadMediaCueSummary = (input) => {
   return parts.length > 0 ? parts.join(" \xB7 ") : "none";
 };
 var formatRAGTraceMetadataRow = (key, value) => ({
-  label: key === "sqliteQueryMode" ? "SQLite query mode" : key === "postgresQueryMode" ? "Postgres query mode" : key === "sqliteQueryPushdownMode" ? "SQLite pushdown mode" : key === "postgresQueryPushdownMode" ? "Postgres pushdown mode" : key === "sqliteQueryPushdownApplied" ? "SQLite pushdown applied" : key === "postgresQueryPushdownApplied" ? "Postgres pushdown applied" : key === "sqliteQueryPushdownClauseCount" ? "SQLite pushdown clauses" : key === "postgresQueryPushdownClauseCount" ? "Postgres pushdown clauses" : key === "sqliteQueryPushdownCoverageRatio" ? "SQLite pushdown coverage" : key === "postgresQueryPushdownCoverageRatio" ? "Postgres pushdown coverage" : key === "sqliteQueryTotalFilterClauseCount" ? "SQLite total filter clauses" : key === "postgresQueryTotalFilterClauseCount" ? "Postgres total filter clauses" : key === "sqliteQueryJsRemainderClauseCount" ? "SQLite JS remainder clauses" : key === "sqliteQueryMultiplierUsed" ? "SQLite query multiplier" : key === "sqliteQueryCandidateLimitUsed" ? "SQLite candidate limit" : key === "sqliteQueryMaxBackfillsUsed" ? "SQLite max backfills" : key === "sqliteQueryMinResultsUsed" ? "SQLite min results" : key === "postgresQueryJsRemainderClauseCount" ? "Postgres JS remainder clauses" : key === "postgresQueryMultiplierUsed" ? "Postgres query multiplier" : key === "postgresQueryCandidateLimitUsed" ? "Postgres candidate limit" : key === "postgresQueryMaxBackfillsUsed" ? "Postgres max backfills" : key === "postgresQueryMinResultsUsed" ? "Postgres min results" : key === "sqliteQueryJsRemainderRatio" ? "SQLite JS remainder share" : key === "postgresQueryJsRemainderRatio" ? "Postgres JS remainder share" : key === "sqliteQueryFilteredCandidates" ? "SQLite filtered candidates" : key === "postgresQueryFilteredCandidates" ? "Postgres filtered candidates" : key === "sqliteQueryInitialSearchK" ? "SQLite initial searchK" : key === "postgresQueryInitialSearchK" ? "Postgres initial searchK" : key === "sqliteQueryFinalSearchK" ? "SQLite final searchK" : key === "postgresQueryFinalSearchK" ? "Postgres final searchK" : key === "sqliteQuerySearchExpansionRatio" ? "SQLite search expansion" : key === "postgresQuerySearchExpansionRatio" ? "Postgres search expansion" : key === "sqliteQueryBackfillCount" ? "SQLite backfill count" : key === "sqliteQueryBackfillLimitReached" ? "SQLite backfill limit reached" : key === "sqliteQueryMinResultsSatisfied" ? "SQLite min results satisfied" : key === "postgresQueryBackfillCount" ? "Postgres backfill count" : key === "postgresQueryBackfillLimitReached" ? "Postgres backfill limit reached" : key === "postgresQueryMinResultsSatisfied" ? "Postgres min results satisfied" : key === "sqliteQueryReturnedCount" ? "SQLite returned hits" : key === "postgresQueryReturnedCount" ? "Postgres returned hits" : key === "sqliteQueryCandidateYieldRatio" ? "SQLite candidate yield" : key === "postgresQueryCandidateYieldRatio" ? "Postgres candidate yield" : key === "sqliteQueryTopKFillRatio" ? "SQLite topK fill rate" : key === "postgresQueryTopKFillRatio" ? "Postgres topK fill rate" : key === "sqliteQueryUnderfilledTopK" ? "SQLite underfilled topK" : key === "postgresQueryUnderfilledTopK" ? "Postgres underfilled topK" : key === "sqliteQueryCandidateBudgetExhausted" ? "SQLite candidate budget exhausted" : key === "postgresQueryCandidateBudgetExhausted" ? "Postgres candidate budget exhausted" : key === "sqliteQueryCandidateCoverage" ? "SQLite candidate coverage" : key === "postgresQueryCandidateCoverage" ? "Postgres candidate coverage" : key === "leadSpeakerCue" ? "Lead speaker cue" : key === "leadSpeakerAttributionCue" ? "Lead speaker attribution" : key === "leadChannelAttributionCue" ? "Lead channel attribution" : key === "leadChannelCue" ? "Lead channel cue" : key === "leadContinuityCue" ? "Lead continuity cue" : key,
+  label: key === "sqliteQueryMode" ? "SQLite query mode" : key === "postgresQueryMode" ? "Postgres query mode" : key === "sqliteQueryPushdownMode" ? "SQLite pushdown mode" : key === "postgresQueryPushdownMode" ? "Postgres pushdown mode" : key === "sqliteQueryPushdownApplied" ? "SQLite pushdown applied" : key === "postgresQueryPushdownApplied" ? "Postgres pushdown applied" : key === "sqliteQueryPushdownClauseCount" ? "SQLite pushdown clauses" : key === "postgresQueryPushdownClauseCount" ? "Postgres pushdown clauses" : key === "sqliteQueryPushdownCoverageRatio" ? "SQLite pushdown coverage" : key === "postgresQueryPushdownCoverageRatio" ? "Postgres pushdown coverage" : key === "sqliteQueryTotalFilterClauseCount" ? "SQLite total filter clauses" : key === "postgresQueryTotalFilterClauseCount" ? "Postgres total filter clauses" : key === "sqliteQueryJsRemainderClauseCount" ? "SQLite JS remainder clauses" : key === "sqliteQueryMultiplierUsed" ? "SQLite query multiplier" : key === "sqliteQueryCandidateLimitUsed" ? "SQLite candidate limit" : key === "sqliteQueryMaxBackfillsUsed" ? "SQLite max backfills" : key === "sqliteQueryMinResultsUsed" ? "SQLite min results" : key === "sqliteQueryFillPolicyUsed" ? "SQLite fill policy" : key === "postgresQueryJsRemainderClauseCount" ? "Postgres JS remainder clauses" : key === "postgresQueryMultiplierUsed" ? "Postgres query multiplier" : key === "postgresQueryCandidateLimitUsed" ? "Postgres candidate limit" : key === "postgresQueryMaxBackfillsUsed" ? "Postgres max backfills" : key === "postgresQueryMinResultsUsed" ? "Postgres min results" : key === "postgresQueryFillPolicyUsed" ? "Postgres fill policy" : key === "sqliteQueryJsRemainderRatio" ? "SQLite JS remainder share" : key === "postgresQueryJsRemainderRatio" ? "Postgres JS remainder share" : key === "sqliteQueryFilteredCandidates" ? "SQLite filtered candidates" : key === "postgresQueryFilteredCandidates" ? "Postgres filtered candidates" : key === "sqliteQueryInitialSearchK" ? "SQLite initial searchK" : key === "postgresQueryInitialSearchK" ? "Postgres initial searchK" : key === "sqliteQueryFinalSearchK" ? "SQLite final searchK" : key === "postgresQueryFinalSearchK" ? "Postgres final searchK" : key === "sqliteQuerySearchExpansionRatio" ? "SQLite search expansion" : key === "postgresQuerySearchExpansionRatio" ? "Postgres search expansion" : key === "sqliteQueryBackfillCount" ? "SQLite backfill count" : key === "sqliteQueryBackfillLimitReached" ? "SQLite backfill limit reached" : key === "sqliteQueryMinResultsSatisfied" ? "SQLite min results satisfied" : key === "postgresQueryBackfillCount" ? "Postgres backfill count" : key === "postgresQueryBackfillLimitReached" ? "Postgres backfill limit reached" : key === "postgresQueryMinResultsSatisfied" ? "Postgres min results satisfied" : key === "sqliteQueryReturnedCount" ? "SQLite returned hits" : key === "postgresQueryReturnedCount" ? "Postgres returned hits" : key === "sqliteQueryCandidateYieldRatio" ? "SQLite candidate yield" : key === "postgresQueryCandidateYieldRatio" ? "Postgres candidate yield" : key === "sqliteQueryTopKFillRatio" ? "SQLite topK fill rate" : key === "postgresQueryTopKFillRatio" ? "Postgres topK fill rate" : key === "sqliteQueryUnderfilledTopK" ? "SQLite underfilled topK" : key === "postgresQueryUnderfilledTopK" ? "Postgres underfilled topK" : key === "sqliteQueryCandidateBudgetExhausted" ? "SQLite candidate budget exhausted" : key === "postgresQueryCandidateBudgetExhausted" ? "Postgres candidate budget exhausted" : key === "sqliteQueryCandidateCoverage" ? "SQLite candidate coverage" : key === "postgresQueryCandidateCoverage" ? "Postgres candidate coverage" : key === "leadSpeakerCue" ? "Lead speaker cue" : key === "leadSpeakerAttributionCue" ? "Lead speaker attribution" : key === "leadChannelAttributionCue" ? "Lead channel attribution" : key === "leadChannelCue" ? "Lead channel cue" : key === "leadContinuityCue" ? "Lead continuity cue" : key,
   value: key === "sourceAwareChunkReason" ? formatSourceAwareChunkReason(value) ?? formatRAGTraceValue(value) : key === "leadSpeakerAttributionCue" ? formatLeadSpeakerAttributionCue(value) ?? formatRAGTraceValue(value) : key === "leadChannelAttributionCue" ? formatLeadChannelAttributionCue(value) ?? formatRAGTraceValue(value) : key === "leadContinuityCue" ? formatLeadContinuityCue(value) ?? formatRAGTraceValue(value) : formatRAGTraceValue(value)
 });
 var buildRAGRetrievalTracePresentation = (trace) => {
@@ -2525,6 +2525,7 @@ var formatSQLitePlannerCueSummary = (input) => {
     typeof input?.sqliteQueryCandidateLimitUsed === "number" ? `cap ${input.sqliteQueryCandidateLimitUsed}` : undefined,
     typeof input?.sqliteQueryMaxBackfillsUsed === "number" ? `backfills ${input.sqliteQueryMaxBackfillsUsed}` : undefined,
     typeof input?.sqliteQueryMinResultsUsed === "number" ? `min ${input.sqliteQueryMinResultsUsed}` : undefined,
+    input?.sqliteQueryFillPolicyUsed ? `fill ${input.sqliteQueryFillPolicyUsed}` : undefined,
     typeof input?.sqliteQueryJsRemainderRatio === "number" ? `js ${(input.sqliteQueryJsRemainderRatio * 100).toFixed(0)}%` : undefined,
     typeof input?.sqliteQueryTotalFilterClauseCount === "number" ? `total clauses ${input.sqliteQueryTotalFilterClauseCount}` : undefined,
     typeof input?.sqliteQueryFilteredCandidates === "number" ? `filtered ${input.sqliteQueryFilteredCandidates}` : undefined,
@@ -2556,6 +2557,7 @@ var formatPostgresPlannerCueSummary = (input) => {
     typeof input?.postgresQueryCandidateLimitUsed === "number" ? `cap ${input.postgresQueryCandidateLimitUsed}` : undefined,
     typeof input?.postgresQueryMaxBackfillsUsed === "number" ? `backfills ${input.postgresQueryMaxBackfillsUsed}` : undefined,
     typeof input?.postgresQueryMinResultsUsed === "number" ? `min ${input.postgresQueryMinResultsUsed}` : undefined,
+    input?.postgresQueryFillPolicyUsed ? `fill ${input.postgresQueryFillPolicyUsed}` : undefined,
     typeof input?.postgresQueryJsRemainderRatio === "number" ? `js ${(input.postgresQueryJsRemainderRatio * 100).toFixed(0)}%` : undefined,
     typeof input?.postgresQueryTotalFilterClauseCount === "number" ? `total clauses ${input.postgresQueryTotalFilterClauseCount}` : undefined,
     typeof input?.postgresQueryFilteredCandidates === "number" ? `filtered ${input.postgresQueryFilteredCandidates}` : undefined,
@@ -2587,6 +2589,7 @@ var formatComparisonSQLitePlannerCueSummary = (entry) => {
     sqliteQueryCandidateLimitUsed: snapshot.sqliteQueryCandidateLimitUsed,
     sqliteQueryMaxBackfillsUsed: snapshot.sqliteQueryMaxBackfillsUsed,
     sqliteQueryMinResultsUsed: snapshot.sqliteQueryMinResultsUsed,
+    sqliteQueryFillPolicyUsed: snapshot.sqliteQueryFillPolicyUsed,
     sqliteQueryMode: snapshot.sqliteQueryMode,
     sqliteQueryPushdownApplied: snapshot.sqliteQueryPushdownApplied,
     sqliteQueryPushdownClauseCount: snapshot.sqliteQueryPushdownClauseCount,
@@ -2616,6 +2619,7 @@ var formatComparisonPostgresPlannerCueSummary = (entry) => {
     postgresQueryCandidateLimitUsed: snapshot.postgresQueryCandidateLimitUsed,
     postgresQueryMaxBackfillsUsed: snapshot.postgresQueryMaxBackfillsUsed,
     postgresQueryMinResultsUsed: snapshot.postgresQueryMinResultsUsed,
+    postgresQueryFillPolicyUsed: snapshot.postgresQueryFillPolicyUsed,
     postgresQueryMultiplierUsed: snapshot.postgresQueryMultiplierUsed,
     postgresQueryMode: snapshot.postgresQueryMode,
     postgresQueryPushdownApplied: snapshot.postgresQueryPushdownApplied,
@@ -2786,6 +2790,7 @@ var formatHistorySQLitePlannerShift = (history) => {
       sqliteQueryCandidateLimitUsed: entry.previousSqliteQueryCandidateLimitUsed,
       sqliteQueryMaxBackfillsUsed: entry.previousSqliteQueryMaxBackfillsUsed,
       sqliteQueryMinResultsUsed: entry.previousSqliteQueryMinResultsUsed,
+      sqliteQueryFillPolicyUsed: entry.previousSqliteQueryFillPolicyUsed,
       sqliteQueryMode: entry.previousSqliteQueryMode,
       sqliteQueryPushdownApplied: entry.previousSqliteQueryPushdownApplied,
       sqliteQueryPushdownClauseCount: entry.previousSqliteQueryPushdownClauseCount,
@@ -2825,6 +2830,7 @@ var formatHistoryPostgresPlannerShift = (history) => {
       postgresQueryCandidateLimitUsed: entry.previousPostgresQueryCandidateLimitUsed,
       postgresQueryMaxBackfillsUsed: entry.previousPostgresQueryMaxBackfillsUsed,
       postgresQueryMinResultsUsed: entry.previousPostgresQueryMinResultsUsed,
+      postgresQueryFillPolicyUsed: entry.previousPostgresQueryFillPolicyUsed,
       postgresQueryMultiplierUsed: entry.previousPostgresQueryMultiplierUsed,
       postgresQueryMode: entry.previousPostgresQueryMode,
       postgresQueryPushdownApplied: entry.previousPostgresQueryPushdownApplied,
@@ -3894,6 +3900,7 @@ var buildEvaluationSQLiteQueryPlanSnapshot = (trace) => {
     sqliteQueryCandidateLimitUsed: typeof metadata.sqliteQueryCandidateLimitUsed === "number" ? metadata.sqliteQueryCandidateLimitUsed : undefined,
     sqliteQueryMaxBackfillsUsed: typeof metadata.sqliteQueryMaxBackfillsUsed === "number" ? metadata.sqliteQueryMaxBackfillsUsed : undefined,
     sqliteQueryMinResultsUsed: typeof metadata.sqliteQueryMinResultsUsed === "number" ? metadata.sqliteQueryMinResultsUsed : undefined,
+    sqliteQueryFillPolicyUsed: metadata.sqliteQueryFillPolicyUsed === "strict_topk" || metadata.sqliteQueryFillPolicyUsed === "satisfy_min_results" ? metadata.sqliteQueryFillPolicyUsed : undefined,
     sqliteQueryPushdownCoverageRatio: typeof metadata.sqliteQueryPushdownCoverageRatio === "number" ? metadata.sqliteQueryPushdownCoverageRatio : undefined,
     sqliteQueryJsRemainderRatio: typeof metadata.sqliteQueryJsRemainderRatio === "number" ? metadata.sqliteQueryJsRemainderRatio : undefined,
     sqliteQueryReturnedCount: typeof metadata.sqliteQueryReturnedCount === "number" ? metadata.sqliteQueryReturnedCount : undefined,
@@ -3925,6 +3932,7 @@ var buildEvaluationPostgresQueryPlanSnapshot = (trace) => {
     postgresQueryCandidateLimitUsed: typeof metadata.postgresQueryCandidateLimitUsed === "number" ? metadata.postgresQueryCandidateLimitUsed : undefined,
     postgresQueryMaxBackfillsUsed: typeof metadata.postgresQueryMaxBackfillsUsed === "number" ? metadata.postgresQueryMaxBackfillsUsed : undefined,
     postgresQueryMinResultsUsed: typeof metadata.postgresQueryMinResultsUsed === "number" ? metadata.postgresQueryMinResultsUsed : undefined,
+    postgresQueryFillPolicyUsed: metadata.postgresQueryFillPolicyUsed === "strict_topk" || metadata.postgresQueryFillPolicyUsed === "satisfy_min_results" ? metadata.postgresQueryFillPolicyUsed : undefined,
     postgresQueryPushdownCoverageRatio: typeof metadata.postgresQueryPushdownCoverageRatio === "number" ? metadata.postgresQueryPushdownCoverageRatio : undefined,
     postgresQueryJsRemainderRatio: typeof metadata.postgresQueryJsRemainderRatio === "number" ? metadata.postgresQueryJsRemainderRatio : undefined,
     postgresQueryReturnedCount: typeof metadata.postgresQueryReturnedCount === "number" ? metadata.postgresQueryReturnedCount : undefined,
@@ -5185,6 +5193,7 @@ var buildEvaluationCaseTraceSnapshot = ({
   const sqliteQueryCandidateLimitUsed = currentSQLiteQueryPlanSnapshot.sqliteQueryCandidateLimitUsed ?? currentSnapshot?.sqliteQueryCandidateLimitUsed;
   const sqliteQueryMaxBackfillsUsed = currentSQLiteQueryPlanSnapshot.sqliteQueryMaxBackfillsUsed ?? currentSnapshot?.sqliteQueryMaxBackfillsUsed;
   const sqliteQueryMinResultsUsed = currentSQLiteQueryPlanSnapshot.sqliteQueryMinResultsUsed ?? currentSnapshot?.sqliteQueryMinResultsUsed;
+  const sqliteQueryFillPolicyUsed = currentSQLiteQueryPlanSnapshot.sqliteQueryFillPolicyUsed ?? currentSnapshot?.sqliteQueryFillPolicyUsed;
   const sqliteQueryPushdownCoverageRatio = currentSQLiteQueryPlanSnapshot.sqliteQueryPushdownCoverageRatio ?? currentSnapshot?.sqliteQueryPushdownCoverageRatio;
   const sqliteQueryJsRemainderRatio = currentSQLiteQueryPlanSnapshot.sqliteQueryJsRemainderRatio ?? currentSnapshot?.sqliteQueryJsRemainderRatio;
   const sqliteQueryFilteredCandidates = currentSQLiteQueryPlanSnapshot.sqliteQueryFilteredCandidates ?? currentSnapshot?.sqliteQueryFilteredCandidates;
@@ -5210,6 +5219,7 @@ var buildEvaluationCaseTraceSnapshot = ({
   const postgresQueryCandidateLimitUsed = currentPostgresQueryPlanSnapshot.postgresQueryCandidateLimitUsed ?? currentSnapshot?.postgresQueryCandidateLimitUsed;
   const postgresQueryMaxBackfillsUsed = currentPostgresQueryPlanSnapshot.postgresQueryMaxBackfillsUsed ?? currentSnapshot?.postgresQueryMaxBackfillsUsed;
   const postgresQueryMinResultsUsed = currentPostgresQueryPlanSnapshot.postgresQueryMinResultsUsed ?? currentSnapshot?.postgresQueryMinResultsUsed;
+  const postgresQueryFillPolicyUsed = currentPostgresQueryPlanSnapshot.postgresQueryFillPolicyUsed ?? currentSnapshot?.postgresQueryFillPolicyUsed;
   const postgresQueryPushdownCoverageRatio = currentPostgresQueryPlanSnapshot.postgresQueryPushdownCoverageRatio ?? currentSnapshot?.postgresQueryPushdownCoverageRatio;
   const postgresQueryJsRemainderRatio = currentPostgresQueryPlanSnapshot.postgresQueryJsRemainderRatio ?? currentSnapshot?.postgresQueryJsRemainderRatio;
   const postgresQueryFilteredCandidates = currentPostgresQueryPlanSnapshot.postgresQueryFilteredCandidates ?? currentSnapshot?.postgresQueryFilteredCandidates;
@@ -5229,7 +5239,7 @@ var buildEvaluationCaseTraceSnapshot = ({
   const previousFilterSignature = JSON.stringify(previousTrace?.inputFilter ?? undefined);
   const currentRetrievalSignature = JSON.stringify(retrieval ?? undefined);
   const previousRetrievalSignature = JSON.stringify(previousTrace?.inputRetrieval ?? undefined);
-  const traceChange = !previousTrace ? currentTrace ? "new" : "unchanged" : previousTrace.traceMode !== currentTrace?.mode || previousFilterSignature !== currentFilterSignature || previousRetrievalSignature !== currentRetrievalSignature || previousTrace.sourceBalanceStrategy !== currentTrace?.sourceBalanceStrategy || previousTrace.transformedQuery !== (currentTrace?.transformedQuery || undefined) || previousTrace.variantQueries.join("|") !== (currentTrace?.variantQueries ?? []).join("|") || previousTrace.finalCount !== (currentTrace?.resultCounts.final ?? 0) || previousTrace.vectorCount !== (currentTrace?.resultCounts.vector ?? 0) || previousTrace.lexicalCount !== (currentTrace?.resultCounts.lexical ?? 0) || previousTrace.candidateTopK !== (currentTrace?.candidateTopK ?? 0) || previousTrace.lexicalTopK !== (currentTrace?.lexicalTopK ?? 0) || previousTrace.topContextLabel !== topContextLabel || previousTrace.topLocatorLabel !== topLocatorLabel || previousTrace.sourceAwareChunkReasonLabel !== sourceAwareChunkReasonLabel || previousTrace.sourceAwareUnitScopeLabel !== sourceAwareUnitScopeLabel || previousTrace.leadSpeakerCue !== leadSpeakerCue || previousTrace.leadSpeakerAttributionCue !== leadSpeakerAttributionCue || previousTrace.leadChannelCue !== leadChannelCue || previousTrace.leadChannelAttributionCue !== leadChannelAttributionCue || previousTrace.leadContinuityCue !== leadContinuityCue || previousTrace.sqliteQueryMode !== sqliteQueryMode || previousTrace.sqliteQueryPushdownMode !== sqliteQueryPushdownMode || previousTrace.sqliteQueryPushdownApplied !== sqliteQueryPushdownApplied || previousTrace.sqliteQueryPushdownClauseCount !== sqliteQueryPushdownClauseCount || previousTrace.sqliteQueryTotalFilterClauseCount !== sqliteQueryTotalFilterClauseCount || previousTrace.sqliteQueryJsRemainderClauseCount !== sqliteQueryJsRemainderClauseCount || previousTrace.sqliteQueryMultiplierUsed !== sqliteQueryMultiplierUsed || previousTrace.sqliteQueryCandidateLimitUsed !== sqliteQueryCandidateLimitUsed || previousTrace.sqliteQueryMaxBackfillsUsed !== sqliteQueryMaxBackfillsUsed || previousTrace.sqliteQueryMinResultsUsed !== sqliteQueryMinResultsUsed || previousTrace.sqliteQueryPushdownCoverageRatio !== sqliteQueryPushdownCoverageRatio || previousTrace.sqliteQueryJsRemainderRatio !== sqliteQueryJsRemainderRatio || previousTrace.sqliteQueryFilteredCandidates !== sqliteQueryFilteredCandidates || previousTrace.sqliteQueryInitialSearchK !== sqliteQueryInitialSearchK || previousTrace.sqliteQueryFinalSearchK !== sqliteQueryFinalSearchK || previousTrace.sqliteQuerySearchExpansionRatio !== sqliteQuerySearchExpansionRatio || previousTrace.sqliteQueryBackfillCount !== sqliteQueryBackfillCount || previousTrace.sqliteQueryBackfillLimitReached !== sqliteQueryBackfillLimitReached || previousTrace.sqliteQueryMinResultsSatisfied !== sqliteQueryMinResultsSatisfied || previousTrace.sqliteQueryReturnedCount !== sqliteQueryReturnedCount || previousTrace.sqliteQueryCandidateYieldRatio !== sqliteQueryCandidateYieldRatio || previousTrace.sqliteQueryTopKFillRatio !== sqliteQueryTopKFillRatio || previousTrace.sqliteQueryUnderfilledTopK !== sqliteQueryUnderfilledTopK || previousTrace.sqliteQueryCandidateBudgetExhausted !== sqliteQueryCandidateBudgetExhausted || previousTrace.sqliteQueryCandidateCoverage !== sqliteQueryCandidateCoverage || previousTrace.postgresQueryMode !== postgresQueryMode || previousTrace.postgresQueryPushdownMode !== postgresQueryPushdownMode || previousTrace.postgresQueryPushdownApplied !== postgresQueryPushdownApplied || previousTrace.postgresQueryPushdownClauseCount !== postgresQueryPushdownClauseCount || previousTrace.postgresQueryTotalFilterClauseCount !== postgresQueryTotalFilterClauseCount || previousTrace.postgresQueryJsRemainderClauseCount !== postgresQueryJsRemainderClauseCount || previousTrace.postgresQueryMultiplierUsed !== postgresQueryMultiplierUsed || previousTrace.postgresQueryCandidateLimitUsed !== postgresQueryCandidateLimitUsed || previousTrace.postgresQueryMaxBackfillsUsed !== postgresQueryMaxBackfillsUsed || previousTrace.postgresQueryMinResultsUsed !== postgresQueryMinResultsUsed || previousTrace.postgresQueryPushdownCoverageRatio !== postgresQueryPushdownCoverageRatio || previousTrace.postgresQueryJsRemainderRatio !== postgresQueryJsRemainderRatio || previousTrace.postgresQueryFilteredCandidates !== postgresQueryFilteredCandidates || previousTrace.postgresQueryInitialSearchK !== postgresQueryInitialSearchK || previousTrace.postgresQueryFinalSearchK !== postgresQueryFinalSearchK || previousTrace.postgresQuerySearchExpansionRatio !== postgresQuerySearchExpansionRatio || previousTrace.postgresQueryBackfillCount !== postgresQueryBackfillCount || previousTrace.postgresQueryBackfillLimitReached !== postgresQueryBackfillLimitReached || previousTrace.postgresQueryMinResultsSatisfied !== postgresQueryMinResultsSatisfied || previousTrace.postgresQueryReturnedCount !== postgresQueryReturnedCount || previousTrace.postgresQueryCandidateYieldRatio !== postgresQueryCandidateYieldRatio || previousTrace.postgresQueryTopKFillRatio !== postgresQueryTopKFillRatio || previousTrace.postgresQueryUnderfilledTopK !== postgresQueryUnderfilledTopK || previousTrace.postgresQueryCandidateBudgetExhausted !== postgresQueryCandidateBudgetExhausted || previousTrace.postgresQueryCandidateCoverage !== postgresQueryCandidateCoverage || !areStageCountsEqual(previousStageCounts, stageCounts) ? "changed" : "unchanged";
+  const traceChange = !previousTrace ? currentTrace ? "new" : "unchanged" : previousTrace.traceMode !== currentTrace?.mode || previousFilterSignature !== currentFilterSignature || previousRetrievalSignature !== currentRetrievalSignature || previousTrace.sourceBalanceStrategy !== currentTrace?.sourceBalanceStrategy || previousTrace.transformedQuery !== (currentTrace?.transformedQuery || undefined) || previousTrace.variantQueries.join("|") !== (currentTrace?.variantQueries ?? []).join("|") || previousTrace.finalCount !== (currentTrace?.resultCounts.final ?? 0) || previousTrace.vectorCount !== (currentTrace?.resultCounts.vector ?? 0) || previousTrace.lexicalCount !== (currentTrace?.resultCounts.lexical ?? 0) || previousTrace.candidateTopK !== (currentTrace?.candidateTopK ?? 0) || previousTrace.lexicalTopK !== (currentTrace?.lexicalTopK ?? 0) || previousTrace.topContextLabel !== topContextLabel || previousTrace.topLocatorLabel !== topLocatorLabel || previousTrace.sourceAwareChunkReasonLabel !== sourceAwareChunkReasonLabel || previousTrace.sourceAwareUnitScopeLabel !== sourceAwareUnitScopeLabel || previousTrace.leadSpeakerCue !== leadSpeakerCue || previousTrace.leadSpeakerAttributionCue !== leadSpeakerAttributionCue || previousTrace.leadChannelCue !== leadChannelCue || previousTrace.leadChannelAttributionCue !== leadChannelAttributionCue || previousTrace.leadContinuityCue !== leadContinuityCue || previousTrace.sqliteQueryMode !== sqliteQueryMode || previousTrace.sqliteQueryPushdownMode !== sqliteQueryPushdownMode || previousTrace.sqliteQueryPushdownApplied !== sqliteQueryPushdownApplied || previousTrace.sqliteQueryPushdownClauseCount !== sqliteQueryPushdownClauseCount || previousTrace.sqliteQueryTotalFilterClauseCount !== sqliteQueryTotalFilterClauseCount || previousTrace.sqliteQueryJsRemainderClauseCount !== sqliteQueryJsRemainderClauseCount || previousTrace.sqliteQueryMultiplierUsed !== sqliteQueryMultiplierUsed || previousTrace.sqliteQueryCandidateLimitUsed !== sqliteQueryCandidateLimitUsed || previousTrace.sqliteQueryMaxBackfillsUsed !== sqliteQueryMaxBackfillsUsed || previousTrace.sqliteQueryMinResultsUsed !== sqliteQueryMinResultsUsed || previousTrace.sqliteQueryFillPolicyUsed !== sqliteQueryFillPolicyUsed || previousTrace.sqliteQueryPushdownCoverageRatio !== sqliteQueryPushdownCoverageRatio || previousTrace.sqliteQueryJsRemainderRatio !== sqliteQueryJsRemainderRatio || previousTrace.sqliteQueryFilteredCandidates !== sqliteQueryFilteredCandidates || previousTrace.sqliteQueryInitialSearchK !== sqliteQueryInitialSearchK || previousTrace.sqliteQueryFinalSearchK !== sqliteQueryFinalSearchK || previousTrace.sqliteQuerySearchExpansionRatio !== sqliteQuerySearchExpansionRatio || previousTrace.sqliteQueryBackfillCount !== sqliteQueryBackfillCount || previousTrace.sqliteQueryBackfillLimitReached !== sqliteQueryBackfillLimitReached || previousTrace.sqliteQueryMinResultsSatisfied !== sqliteQueryMinResultsSatisfied || previousTrace.sqliteQueryReturnedCount !== sqliteQueryReturnedCount || previousTrace.sqliteQueryCandidateYieldRatio !== sqliteQueryCandidateYieldRatio || previousTrace.sqliteQueryTopKFillRatio !== sqliteQueryTopKFillRatio || previousTrace.sqliteQueryUnderfilledTopK !== sqliteQueryUnderfilledTopK || previousTrace.sqliteQueryCandidateBudgetExhausted !== sqliteQueryCandidateBudgetExhausted || previousTrace.sqliteQueryCandidateCoverage !== sqliteQueryCandidateCoverage || previousTrace.postgresQueryMode !== postgresQueryMode || previousTrace.postgresQueryPushdownMode !== postgresQueryPushdownMode || previousTrace.postgresQueryPushdownApplied !== postgresQueryPushdownApplied || previousTrace.postgresQueryPushdownClauseCount !== postgresQueryPushdownClauseCount || previousTrace.postgresQueryTotalFilterClauseCount !== postgresQueryTotalFilterClauseCount || previousTrace.postgresQueryJsRemainderClauseCount !== postgresQueryJsRemainderClauseCount || previousTrace.postgresQueryMultiplierUsed !== postgresQueryMultiplierUsed || previousTrace.postgresQueryCandidateLimitUsed !== postgresQueryCandidateLimitUsed || previousTrace.postgresQueryMaxBackfillsUsed !== postgresQueryMaxBackfillsUsed || previousTrace.postgresQueryMinResultsUsed !== postgresQueryMinResultsUsed || previousTrace.postgresQueryFillPolicyUsed !== postgresQueryFillPolicyUsed || previousTrace.postgresQueryPushdownCoverageRatio !== postgresQueryPushdownCoverageRatio || previousTrace.postgresQueryJsRemainderRatio !== postgresQueryJsRemainderRatio || previousTrace.postgresQueryFilteredCandidates !== postgresQueryFilteredCandidates || previousTrace.postgresQueryInitialSearchK !== postgresQueryInitialSearchK || previousTrace.postgresQueryFinalSearchK !== postgresQueryFinalSearchK || previousTrace.postgresQuerySearchExpansionRatio !== postgresQuerySearchExpansionRatio || previousTrace.postgresQueryBackfillCount !== postgresQueryBackfillCount || previousTrace.postgresQueryBackfillLimitReached !== postgresQueryBackfillLimitReached || previousTrace.postgresQueryMinResultsSatisfied !== postgresQueryMinResultsSatisfied || previousTrace.postgresQueryReturnedCount !== postgresQueryReturnedCount || previousTrace.postgresQueryCandidateYieldRatio !== postgresQueryCandidateYieldRatio || previousTrace.postgresQueryTopKFillRatio !== postgresQueryTopKFillRatio || previousTrace.postgresQueryUnderfilledTopK !== postgresQueryUnderfilledTopK || previousTrace.postgresQueryCandidateBudgetExhausted !== postgresQueryCandidateBudgetExhausted || previousTrace.postgresQueryCandidateCoverage !== postgresQueryCandidateCoverage || !areStageCountsEqual(previousStageCounts, stageCounts) ? "changed" : "unchanged";
   return {
     candidateTopK: currentTrace?.candidateTopK ?? 0,
     caseId: caseResult.caseId,
@@ -5270,6 +5280,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousSqliteQueryCandidateLimitUsed: previousTrace?.sqliteQueryCandidateLimitUsed,
     previousSqliteQueryMaxBackfillsUsed: previousTrace?.sqliteQueryMaxBackfillsUsed,
     previousSqliteQueryMinResultsUsed: previousTrace?.sqliteQueryMinResultsUsed,
+    previousSqliteQueryFillPolicyUsed: previousTrace?.sqliteQueryFillPolicyUsed,
     previousSqliteQueryPushdownCoverageRatio: previousTrace?.sqliteQueryPushdownCoverageRatio,
     previousSqliteQueryJsRemainderRatio: previousTrace?.sqliteQueryJsRemainderRatio,
     previousSqliteQueryReturnedCount: previousTrace?.sqliteQueryReturnedCount,
@@ -5295,6 +5306,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousPostgresQueryCandidateLimitUsed: previousTrace?.postgresQueryCandidateLimitUsed,
     previousPostgresQueryMaxBackfillsUsed: previousTrace?.postgresQueryMaxBackfillsUsed,
     previousPostgresQueryMinResultsUsed: previousTrace?.postgresQueryMinResultsUsed,
+    previousPostgresQueryFillPolicyUsed: previousTrace?.postgresQueryFillPolicyUsed,
     previousPostgresQueryPushdownCoverageRatio: previousTrace?.postgresQueryPushdownCoverageRatio,
     previousPostgresQueryJsRemainderRatio: previousTrace?.postgresQueryJsRemainderRatio,
     previousPostgresQueryReturnedCount: previousTrace?.postgresQueryReturnedCount,
@@ -5336,6 +5348,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     sqliteQueryCandidateLimitUsed,
     sqliteQueryMaxBackfillsUsed,
     sqliteQueryMinResultsUsed,
+    sqliteQueryFillPolicyUsed,
     sqliteQueryPushdownCoverageRatio,
     sqliteQueryJsRemainderRatio,
     sqliteQueryReturnedCount,
@@ -5361,6 +5374,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     postgresQueryCandidateLimitUsed,
     postgresQueryMaxBackfillsUsed,
     postgresQueryMinResultsUsed,
+    postgresQueryFillPolicyUsed,
     postgresQueryPushdownCoverageRatio,
     postgresQueryJsRemainderRatio,
     postgresQueryReturnedCount,
@@ -16980,6 +16994,7 @@ var buildStoreQueryPlanTraceMetadata = (store) => {
       sqliteQueryCandidateLimitUsed: sqliteNativePlan.candidateLimitUsed ?? null,
       sqliteQueryMaxBackfillsUsed: sqliteNativePlan.maxBackfillsUsed ?? null,
       sqliteQueryMinResultsUsed: sqliteNativePlan.minResultsUsed ?? null,
+      sqliteQueryFillPolicyUsed: sqliteNativePlan.fillPolicyUsed ?? null,
       sqliteQueryJsRemainderRatio: sqliteNativePlan.jsRemainderRatio ?? null,
       sqliteQueryCandidateYieldRatio: sqliteNativePlan.candidateYieldRatio ?? null,
       sqliteQueryReturnedCount: sqliteNativePlan.returnedCount ?? null,
@@ -17012,6 +17027,7 @@ var buildStoreQueryPlanTraceMetadata = (store) => {
     postgresQueryCandidateLimitUsed: postgresNativePlan.candidateLimitUsed ?? null,
     postgresQueryMaxBackfillsUsed: postgresNativePlan.maxBackfillsUsed ?? null,
     postgresQueryMinResultsUsed: postgresNativePlan.minResultsUsed ?? null,
+    postgresQueryFillPolicyUsed: postgresNativePlan.fillPolicyUsed ?? null,
     postgresQueryJsRemainderRatio: postgresNativePlan.jsRemainderRatio ?? null,
     postgresQueryCandidateYieldRatio: postgresNativePlan.candidateYieldRatio ?? null,
     postgresQueryReturnedCount: postgresNativePlan.returnedCount ?? null,
@@ -17146,6 +17162,7 @@ var createRAGCollection = (options) => {
         }, "query").then((nextQueryVector) => options.store.query({
           filter: input.filter,
           candidateLimit: input.nativeCandidateLimit,
+          fillPolicy: input.nativeFillPolicy,
           maxBackfills: input.nativeMaxBackfills,
           minResults: input.nativeMinResults,
           queryMultiplier: input.nativeQueryMultiplier,
@@ -22141,6 +22158,7 @@ var ragChat = (config) => {
       nativeCandidateLimit: typeof body.nativeCandidateLimit === "number" ? body.nativeCandidateLimit : undefined,
       nativeMaxBackfills: typeof body.nativeMaxBackfills === "number" ? body.nativeMaxBackfills : undefined,
       nativeMinResults: typeof body.nativeMinResults === "number" ? body.nativeMinResults : undefined,
+      nativeFillPolicy: body.nativeFillPolicy === "strict_topk" || body.nativeFillPolicy === "satisfy_min_results" ? body.nativeFillPolicy : undefined,
       nativeQueryMultiplier: typeof body.nativeQueryMultiplier === "number" ? body.nativeQueryMultiplier : undefined,
       retrieval: undefined,
       model: getStringProperty(body, "model"),
@@ -29100,6 +29118,13 @@ var normalizeMinResults = (value, topK) => {
   }
   return Math.min(topK, Math.max(1, Math.floor(value)));
 };
+var resolveFillTarget = (input) => {
+  const fillPolicy = input.fillPolicy ?? "satisfy_min_results";
+  return {
+    fillPolicy,
+    targetResults: fillPolicy === "strict_topk" ? input.topK : input.minResults
+  };
+};
 var toQualifiedTableName = (schemaName, tableName) => `${schemaName}.${tableName}`;
 var toVectorLiteral = (vector) => `[${vector.join(",")}]`;
 var parseMetadata = (value) => {
@@ -29190,6 +29215,7 @@ var updatePostgresLastQueryPlan = (input) => {
     candidateLimitUsed: input.candidateLimitUsed,
     maxBackfillsUsed: input.maxBackfillsUsed,
     minResultsUsed: input.minResultsUsed,
+    fillPolicyUsed: input.fillPolicyUsed,
     jsRemainderClauseCount: pushdown.jsRemainderClauseCount,
     queryMultiplierUsed: input.queryMultiplierUsed,
     jsRemainderRatio: pushdown.jsRemainderRatio,
@@ -29287,6 +29313,11 @@ var createPostgresRAGStore = (options = {}) => {
     const candidateLimit = normalizeCandidateLimit(input.candidateLimit);
     const maxBackfills = normalizeMaxBackfills(input.maxBackfills);
     const minResults = normalizeMinResults(input.minResults, input.topK);
+    const fillTarget = resolveFillTarget({
+      fillPolicy: input.fillPolicy,
+      minResults,
+      topK: input.topK
+    });
     const queryVectorLiteral = toVectorLiteral(queryVector);
     const pushdownFilter = buildPostgresPushdownFilter(input.filter);
     const countFilterPlan = buildPostgresFilterPlan(pushdownFilter);
@@ -29345,7 +29376,7 @@ var createPostgresRAGStore = (options = {}) => {
         source: entry.chunk.source,
         title: entry.chunk.title
       })).sort((left, right) => right.score - left.score);
-      if (mapped.length >= minResults) {
+      if (mapped.length >= fillTarget.targetResults) {
         break;
       }
       const nextSearchK = planNativeCandidateSearchBackfillK({
@@ -29356,8 +29387,8 @@ var createPostgresRAGStore = (options = {}) => {
         maxBackfills
       });
       if (nextSearchK <= currentSearchK) {
-        backfillLimitReached = typeof maxBackfills === "number" && backfillCount >= maxBackfills && mapped.length < minResults;
-        candidateBudgetExhausted = mapped.length < minResults;
+        backfillLimitReached = typeof maxBackfills === "number" && backfillCount >= maxBackfills && mapped.length < fillTarget.targetResults;
+        candidateBudgetExhausted = mapped.length < fillTarget.targetResults;
         break;
       }
       currentSearchK = nextSearchK;
@@ -29372,6 +29403,7 @@ var createPostgresRAGStore = (options = {}) => {
       candidateLimitUsed: candidateLimit,
       maxBackfillsUsed: maxBackfills,
       minResultsUsed: minResults,
+      fillPolicyUsed: fillTarget.fillPolicy,
       filter: input.filter,
       pushdownFilter,
       queryMultiplierUsed: queryMultiplier2,
@@ -29435,8 +29467,12 @@ var createPostgresRAGStore = (options = {}) => {
     await init();
     await db.unsafe(`truncate table ${qualifiedTableName}`);
   };
+  const close = async () => {
+    await db.close?.();
+  };
   return {
     clear,
+    close,
     embed,
     getCapabilities: () => capabilities,
     getStatus: () => createPostgresStatus(dimensions, nativeDiagnostics),
@@ -29605,6 +29641,13 @@ var normalizeMinResults2 = (value, topK) => {
   }
   return Math.min(topK, Math.max(1, Math.floor(value)));
 };
+var resolveFillTarget2 = (input) => {
+  const fillPolicy = input.fillPolicy ?? "satisfy_min_results";
+  return {
+    fillPolicy,
+    targetResults: fillPolicy === "strict_topk" ? input.topK : input.minResults
+  };
+};
 var toJSONString = (metadata) => metadata === undefined ? null : JSON.stringify(metadata);
 var parseMetadata2 = (value) => {
   if (value === null) {
@@ -30185,6 +30228,7 @@ var updateSQLiteLastQueryPlan = (input) => {
     candidateLimitUsed: input.candidateLimitUsed,
     maxBackfillsUsed: input.maxBackfillsUsed,
     minResultsUsed: input.minResultsUsed,
+    fillPolicyUsed: input.fillPolicyUsed,
     queryMultiplierUsed: input.queryMultiplierUsed,
     jsRemainderRatio: pushdown.jsRemainderRatio,
     pushdownApplied: pushdown.pushdownClauseCount > 0,
@@ -30356,6 +30400,11 @@ var createSQLiteRAGStore = (options = {}) => {
     const candidateLimit = normalizeCandidateLimit2(input.candidateLimit);
     const maxBackfills = normalizeMaxBackfills2(input.maxBackfills);
     const minResults = normalizeMinResults2(input.minResults, input.topK);
+    const fillTarget = resolveFillTarget2({
+      fillPolicy: input.fillPolicy,
+      minResults,
+      topK: input.topK
+    });
     const queryVector = normalizeVector(input.queryVector);
     const queryVectorText = toVectorText(queryVector);
     const pushdownFilter = buildSQLitePushdownFilter(input.filter);
@@ -30405,7 +30454,7 @@ var createSQLiteRAGStore = (options = {}) => {
         source: entry.chunk.source,
         title: entry.chunk.title
       })).sort((left, right) => right.score - left.score);
-      if (mapped.length >= minResults) {
+      if (mapped.length >= fillTarget.targetResults) {
         break;
       }
       const nextSearchK = planNativeCandidateSearchBackfillK({
@@ -30416,8 +30465,8 @@ var createSQLiteRAGStore = (options = {}) => {
         maxBackfills
       });
       if (nextSearchK <= currentSearchK) {
-        backfillLimitReached = typeof maxBackfills === "number" && backfillCount >= maxBackfills && mapped.length < minResults;
-        candidateBudgetExhausted = mapped.length < minResults;
+        backfillLimitReached = typeof maxBackfills === "number" && backfillCount >= maxBackfills && mapped.length < fillTarget.targetResults;
+        candidateBudgetExhausted = mapped.length < fillTarget.targetResults;
         break;
       }
       currentSearchK = nextSearchK;
@@ -30436,6 +30485,7 @@ var createSQLiteRAGStore = (options = {}) => {
       candidateLimitUsed: candidateLimit,
       maxBackfillsUsed: maxBackfills,
       minResultsUsed: minResults,
+      fillPolicyUsed: fillTarget.fillPolicy,
       queryMultiplierUsed: queryMultiplier,
       queryMode: "native_vec0",
       returnedCount: Math.min(mapped.length, input.topK),
@@ -32607,5 +32657,5 @@ export {
   addRAGEvaluationSuiteCase
 };
 
-//# debugId=320F9912162970CC64756E2164756E21
+//# debugId=690A2FC8A2432BC964756E2164756E21
 //# sourceMappingURL=index.js.map