@absolutejs/absolute 0.19.0-beta.633 → 0.19.0-beta.634

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 === "postgresQueryJsRemainderClauseCount" ? "Postgres JS remainder clauses" : key === "postgresQueryMultiplierUsed" ? "Postgres query multiplier" : key === "postgresQueryCandidateLimitUsed" ? "Postgres candidate limit" : 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 === "postgresQueryBackfillCount" ? "Postgres backfill count" : 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 === "postgresQueryJsRemainderClauseCount" ? "Postgres JS remainder clauses" : key === "postgresQueryMultiplierUsed" ? "Postgres query multiplier" : key === "postgresQueryCandidateLimitUsed" ? "Postgres candidate limit" : key === "postgresQueryMaxBackfillsUsed" ? "Postgres max backfills" : 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 === "postgresQueryBackfillCount" ? "Postgres backfill count" : key === "postgresQueryBackfillLimitReached" ? "Postgres backfill limit reached" : 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) => {
@@ -2523,12 +2523,14 @@ var formatSQLitePlannerCueSummary = (input) => {
     typeof input?.sqliteQueryJsRemainderClauseCount === "number" ? `js remainder ${input.sqliteQueryJsRemainderClauseCount}` : undefined,
     typeof input?.sqliteQueryMultiplierUsed === "number" ? `x${input.sqliteQueryMultiplierUsed}` : undefined,
     typeof input?.sqliteQueryCandidateLimitUsed === "number" ? `cap ${input.sqliteQueryCandidateLimitUsed}` : undefined,
+    typeof input?.sqliteQueryMaxBackfillsUsed === "number" ? `backfills ${input.sqliteQueryMaxBackfillsUsed}` : 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,
     typeof input?.sqliteQueryInitialSearchK === "number" && typeof input?.sqliteQueryFinalSearchK === "number" ? `searchK ${input.sqliteQueryInitialSearchK}->${input.sqliteQueryFinalSearchK}` : typeof input?.sqliteQueryFinalSearchK === "number" ? `searchK ${input.sqliteQueryFinalSearchK}` : undefined,
     typeof input?.sqliteQuerySearchExpansionRatio === "number" ? `expand ${(input.sqliteQuerySearchExpansionRatio * 100).toFixed(0)}%` : undefined,
     typeof input?.sqliteQueryBackfillCount === "number" ? `backfill ${input.sqliteQueryBackfillCount}` : undefined,
+    typeof input?.sqliteQueryBackfillLimitReached === "boolean" && input.sqliteQueryBackfillLimitReached ? "backfill limit reached" : undefined,
     typeof input?.sqliteQueryReturnedCount === "number" ? `returned ${input.sqliteQueryReturnedCount}` : undefined,
     typeof input?.sqliteQueryCandidateYieldRatio === "number" ? `yield ${(input.sqliteQueryCandidateYieldRatio * 100).toFixed(0)}%` : undefined,
     typeof input?.sqliteQueryTopKFillRatio === "number" ? `fill ${(input.sqliteQueryTopKFillRatio * 100).toFixed(0)}%` : undefined,
@@ -2550,12 +2552,14 @@ var formatPostgresPlannerCueSummary = (input) => {
     typeof input?.postgresQueryJsRemainderClauseCount === "number" ? `js remainder ${input.postgresQueryJsRemainderClauseCount}` : undefined,
     typeof input?.postgresQueryMultiplierUsed === "number" ? `x${input.postgresQueryMultiplierUsed}` : undefined,
     typeof input?.postgresQueryCandidateLimitUsed === "number" ? `cap ${input.postgresQueryCandidateLimitUsed}` : undefined,
+    typeof input?.postgresQueryMaxBackfillsUsed === "number" ? `backfills ${input.postgresQueryMaxBackfillsUsed}` : 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,
     typeof input?.postgresQueryInitialSearchK === "number" && typeof input?.postgresQueryFinalSearchK === "number" ? `searchK ${input.postgresQueryInitialSearchK}->${input.postgresQueryFinalSearchK}` : typeof input?.postgresQueryFinalSearchK === "number" ? `searchK ${input.postgresQueryFinalSearchK}` : undefined,
     typeof input?.postgresQuerySearchExpansionRatio === "number" ? `expand ${(input.postgresQuerySearchExpansionRatio * 100).toFixed(0)}%` : undefined,
     typeof input?.postgresQueryBackfillCount === "number" ? `backfill ${input.postgresQueryBackfillCount}` : undefined,
+    typeof input?.postgresQueryBackfillLimitReached === "boolean" && input.postgresQueryBackfillLimitReached ? "backfill limit reached" : undefined,
     typeof input?.postgresQueryReturnedCount === "number" ? `returned ${input.postgresQueryReturnedCount}` : undefined,
     typeof input?.postgresQueryCandidateYieldRatio === "number" ? `yield ${(input.postgresQueryCandidateYieldRatio * 100).toFixed(0)}%` : undefined,
     typeof input?.postgresQueryTopKFillRatio === "number" ? `fill ${(input.postgresQueryTopKFillRatio * 100).toFixed(0)}%` : undefined,
@@ -3868,10 +3872,12 @@ var buildEvaluationSQLiteQueryPlanSnapshot = (trace) => {
     sqliteQueryJsRemainderClauseCount: typeof metadata.sqliteQueryJsRemainderClauseCount === "number" ? metadata.sqliteQueryJsRemainderClauseCount : undefined,
     sqliteQueryMultiplierUsed: typeof metadata.sqliteQueryMultiplierUsed === "number" ? metadata.sqliteQueryMultiplierUsed : undefined,
     sqliteQueryCandidateLimitUsed: typeof metadata.sqliteQueryCandidateLimitUsed === "number" ? metadata.sqliteQueryCandidateLimitUsed : undefined,
+    sqliteQueryMaxBackfillsUsed: typeof metadata.sqliteQueryMaxBackfillsUsed === "number" ? metadata.sqliteQueryMaxBackfillsUsed : 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,
     sqliteQueryCandidateYieldRatio: typeof metadata.sqliteQueryCandidateYieldRatio === "number" ? metadata.sqliteQueryCandidateYieldRatio : undefined,
+    sqliteQueryBackfillLimitReached: typeof metadata.sqliteQueryBackfillLimitReached === "boolean" ? metadata.sqliteQueryBackfillLimitReached : undefined,
     sqliteQueryTopKFillRatio: typeof metadata.sqliteQueryTopKFillRatio === "number" ? metadata.sqliteQueryTopKFillRatio : undefined,
     sqliteQueryUnderfilledTopK: typeof metadata.sqliteQueryUnderfilledTopK === "boolean" ? metadata.sqliteQueryUnderfilledTopK : undefined
   };
@@ -3895,10 +3901,12 @@ var buildEvaluationPostgresQueryPlanSnapshot = (trace) => {
     postgresQueryJsRemainderClauseCount: typeof metadata.postgresQueryJsRemainderClauseCount === "number" ? metadata.postgresQueryJsRemainderClauseCount : undefined,
     postgresQueryMultiplierUsed: typeof metadata.postgresQueryMultiplierUsed === "number" ? metadata.postgresQueryMultiplierUsed : undefined,
     postgresQueryCandidateLimitUsed: typeof metadata.postgresQueryCandidateLimitUsed === "number" ? metadata.postgresQueryCandidateLimitUsed : undefined,
+    postgresQueryMaxBackfillsUsed: typeof metadata.postgresQueryMaxBackfillsUsed === "number" ? metadata.postgresQueryMaxBackfillsUsed : 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,
     postgresQueryCandidateYieldRatio: typeof metadata.postgresQueryCandidateYieldRatio === "number" ? metadata.postgresQueryCandidateYieldRatio : undefined,
+    postgresQueryBackfillLimitReached: typeof metadata.postgresQueryBackfillLimitReached === "boolean" ? metadata.postgresQueryBackfillLimitReached : undefined,
     postgresQueryTopKFillRatio: typeof metadata.postgresQueryTopKFillRatio === "number" ? metadata.postgresQueryTopKFillRatio : undefined,
     postgresQueryUnderfilledTopK: typeof metadata.postgresQueryUnderfilledTopK === "boolean" ? metadata.postgresQueryUnderfilledTopK : undefined
   };
@@ -5151,6 +5159,7 @@ var buildEvaluationCaseTraceSnapshot = ({
   const sqliteQueryJsRemainderClauseCount = currentSQLiteQueryPlanSnapshot.sqliteQueryJsRemainderClauseCount ?? currentSnapshot?.sqliteQueryJsRemainderClauseCount;
   const sqliteQueryMultiplierUsed = currentSQLiteQueryPlanSnapshot.sqliteQueryMultiplierUsed ?? currentSnapshot?.sqliteQueryMultiplierUsed;
   const sqliteQueryCandidateLimitUsed = currentSQLiteQueryPlanSnapshot.sqliteQueryCandidateLimitUsed ?? currentSnapshot?.sqliteQueryCandidateLimitUsed;
+  const sqliteQueryMaxBackfillsUsed = currentSQLiteQueryPlanSnapshot.sqliteQueryMaxBackfillsUsed ?? currentSnapshot?.sqliteQueryMaxBackfillsUsed;
   const sqliteQueryPushdownCoverageRatio = currentSQLiteQueryPlanSnapshot.sqliteQueryPushdownCoverageRatio ?? currentSnapshot?.sqliteQueryPushdownCoverageRatio;
   const sqliteQueryJsRemainderRatio = currentSQLiteQueryPlanSnapshot.sqliteQueryJsRemainderRatio ?? currentSnapshot?.sqliteQueryJsRemainderRatio;
   const sqliteQueryFilteredCandidates = currentSQLiteQueryPlanSnapshot.sqliteQueryFilteredCandidates ?? currentSnapshot?.sqliteQueryFilteredCandidates;
@@ -5158,6 +5167,7 @@ var buildEvaluationCaseTraceSnapshot = ({
   const sqliteQueryFinalSearchK = currentSQLiteQueryPlanSnapshot.sqliteQueryFinalSearchK ?? currentSnapshot?.sqliteQueryFinalSearchK;
   const sqliteQuerySearchExpansionRatio = currentSQLiteQueryPlanSnapshot.sqliteQuerySearchExpansionRatio ?? currentSnapshot?.sqliteQuerySearchExpansionRatio;
   const sqliteQueryBackfillCount = currentSQLiteQueryPlanSnapshot.sqliteQueryBackfillCount ?? currentSnapshot?.sqliteQueryBackfillCount;
+  const sqliteQueryBackfillLimitReached = currentSQLiteQueryPlanSnapshot.sqliteQueryBackfillLimitReached ?? currentSnapshot?.sqliteQueryBackfillLimitReached;
   const sqliteQueryReturnedCount = currentSQLiteQueryPlanSnapshot.sqliteQueryReturnedCount ?? currentSnapshot?.sqliteQueryReturnedCount;
   const sqliteQueryCandidateYieldRatio = currentSQLiteQueryPlanSnapshot.sqliteQueryCandidateYieldRatio ?? currentSnapshot?.sqliteQueryCandidateYieldRatio;
   const sqliteQueryTopKFillRatio = currentSQLiteQueryPlanSnapshot.sqliteQueryTopKFillRatio ?? currentSnapshot?.sqliteQueryTopKFillRatio;
@@ -5172,6 +5182,7 @@ var buildEvaluationCaseTraceSnapshot = ({
   const postgresQueryJsRemainderClauseCount = currentPostgresQueryPlanSnapshot.postgresQueryJsRemainderClauseCount ?? currentSnapshot?.postgresQueryJsRemainderClauseCount;
   const postgresQueryMultiplierUsed = currentPostgresQueryPlanSnapshot.postgresQueryMultiplierUsed ?? currentSnapshot?.postgresQueryMultiplierUsed;
   const postgresQueryCandidateLimitUsed = currentPostgresQueryPlanSnapshot.postgresQueryCandidateLimitUsed ?? currentSnapshot?.postgresQueryCandidateLimitUsed;
+  const postgresQueryMaxBackfillsUsed = currentPostgresQueryPlanSnapshot.postgresQueryMaxBackfillsUsed ?? currentSnapshot?.postgresQueryMaxBackfillsUsed;
   const postgresQueryPushdownCoverageRatio = currentPostgresQueryPlanSnapshot.postgresQueryPushdownCoverageRatio ?? currentSnapshot?.postgresQueryPushdownCoverageRatio;
   const postgresQueryJsRemainderRatio = currentPostgresQueryPlanSnapshot.postgresQueryJsRemainderRatio ?? currentSnapshot?.postgresQueryJsRemainderRatio;
   const postgresQueryFilteredCandidates = currentPostgresQueryPlanSnapshot.postgresQueryFilteredCandidates ?? currentSnapshot?.postgresQueryFilteredCandidates;
@@ -5179,6 +5190,7 @@ var buildEvaluationCaseTraceSnapshot = ({
   const postgresQueryFinalSearchK = currentPostgresQueryPlanSnapshot.postgresQueryFinalSearchK ?? currentSnapshot?.postgresQueryFinalSearchK;
   const postgresQuerySearchExpansionRatio = currentPostgresQueryPlanSnapshot.postgresQuerySearchExpansionRatio ?? currentSnapshot?.postgresQuerySearchExpansionRatio;
   const postgresQueryBackfillCount = currentPostgresQueryPlanSnapshot.postgresQueryBackfillCount ?? currentSnapshot?.postgresQueryBackfillCount;
+  const postgresQueryBackfillLimitReached = currentPostgresQueryPlanSnapshot.postgresQueryBackfillLimitReached ?? currentSnapshot?.postgresQueryBackfillLimitReached;
   const postgresQueryReturnedCount = currentPostgresQueryPlanSnapshot.postgresQueryReturnedCount ?? currentSnapshot?.postgresQueryReturnedCount;
   const postgresQueryCandidateYieldRatio = currentPostgresQueryPlanSnapshot.postgresQueryCandidateYieldRatio ?? currentSnapshot?.postgresQueryCandidateYieldRatio;
   const postgresQueryTopKFillRatio = currentPostgresQueryPlanSnapshot.postgresQueryTopKFillRatio ?? currentSnapshot?.postgresQueryTopKFillRatio;
@@ -5189,7 +5201,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.sqliteQueryPushdownCoverageRatio !== sqliteQueryPushdownCoverageRatio || previousTrace.sqliteQueryJsRemainderRatio !== sqliteQueryJsRemainderRatio || previousTrace.sqliteQueryFilteredCandidates !== sqliteQueryFilteredCandidates || previousTrace.sqliteQueryInitialSearchK !== sqliteQueryInitialSearchK || previousTrace.sqliteQueryFinalSearchK !== sqliteQueryFinalSearchK || previousTrace.sqliteQuerySearchExpansionRatio !== sqliteQuerySearchExpansionRatio || previousTrace.sqliteQueryBackfillCount !== sqliteQueryBackfillCount || 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.postgresQueryPushdownCoverageRatio !== postgresQueryPushdownCoverageRatio || previousTrace.postgresQueryJsRemainderRatio !== postgresQueryJsRemainderRatio || previousTrace.postgresQueryFilteredCandidates !== postgresQueryFilteredCandidates || previousTrace.postgresQueryInitialSearchK !== postgresQueryInitialSearchK || previousTrace.postgresQueryFinalSearchK !== postgresQueryFinalSearchK || previousTrace.postgresQuerySearchExpansionRatio !== postgresQuerySearchExpansionRatio || previousTrace.postgresQueryBackfillCount !== postgresQueryBackfillCount || 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.sqliteQueryPushdownCoverageRatio !== sqliteQueryPushdownCoverageRatio || previousTrace.sqliteQueryJsRemainderRatio !== sqliteQueryJsRemainderRatio || previousTrace.sqliteQueryFilteredCandidates !== sqliteQueryFilteredCandidates || previousTrace.sqliteQueryInitialSearchK !== sqliteQueryInitialSearchK || previousTrace.sqliteQueryFinalSearchK !== sqliteQueryFinalSearchK || previousTrace.sqliteQuerySearchExpansionRatio !== sqliteQuerySearchExpansionRatio || previousTrace.sqliteQueryBackfillCount !== sqliteQueryBackfillCount || previousTrace.sqliteQueryBackfillLimitReached !== sqliteQueryBackfillLimitReached || 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.postgresQueryPushdownCoverageRatio !== postgresQueryPushdownCoverageRatio || previousTrace.postgresQueryJsRemainderRatio !== postgresQueryJsRemainderRatio || previousTrace.postgresQueryFilteredCandidates !== postgresQueryFilteredCandidates || previousTrace.postgresQueryInitialSearchK !== postgresQueryInitialSearchK || previousTrace.postgresQueryFinalSearchK !== postgresQueryFinalSearchK || previousTrace.postgresQuerySearchExpansionRatio !== postgresQuerySearchExpansionRatio || previousTrace.postgresQueryBackfillCount !== postgresQueryBackfillCount || previousTrace.postgresQueryBackfillLimitReached !== postgresQueryBackfillLimitReached || 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,
@@ -5212,6 +5224,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousLeadSpeakerAttributionCue: previousTrace?.leadSpeakerAttributionCue,
     previousLeadSpeakerCue: previousTrace?.leadSpeakerCue,
     previousSqliteQueryBackfillCount: previousTrace?.sqliteQueryBackfillCount,
+    previousSqliteQueryBackfillLimitReached: previousTrace?.sqliteQueryBackfillLimitReached,
     previousSqliteQueryCandidateBudgetExhausted: previousTrace?.sqliteQueryCandidateBudgetExhausted,
     previousSqliteQueryCandidateCoverage: previousTrace?.sqliteQueryCandidateCoverage,
     previousSqliteQueryFilteredCandidates: previousTrace?.sqliteQueryFilteredCandidates,
@@ -5226,6 +5239,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousSqliteQueryJsRemainderClauseCount: previousTrace?.sqliteQueryJsRemainderClauseCount,
     previousSqliteQueryMultiplierUsed: previousTrace?.sqliteQueryMultiplierUsed,
     previousSqliteQueryCandidateLimitUsed: previousTrace?.sqliteQueryCandidateLimitUsed,
+    previousSqliteQueryMaxBackfillsUsed: previousTrace?.sqliteQueryMaxBackfillsUsed,
     previousSqliteQueryPushdownCoverageRatio: previousTrace?.sqliteQueryPushdownCoverageRatio,
     previousSqliteQueryJsRemainderRatio: previousTrace?.sqliteQueryJsRemainderRatio,
     previousSqliteQueryReturnedCount: previousTrace?.sqliteQueryReturnedCount,
@@ -5233,6 +5247,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousSqliteQueryTopKFillRatio: previousTrace?.sqliteQueryTopKFillRatio,
     previousSqliteQueryUnderfilledTopK: previousTrace?.sqliteQueryUnderfilledTopK,
     previousPostgresQueryBackfillCount: previousTrace?.postgresQueryBackfillCount,
+    previousPostgresQueryBackfillLimitReached: previousTrace?.postgresQueryBackfillLimitReached,
     previousPostgresQueryCandidateBudgetExhausted: previousTrace?.postgresQueryCandidateBudgetExhausted,
     previousPostgresQueryCandidateCoverage: previousTrace?.postgresQueryCandidateCoverage,
     previousPostgresQueryFilteredCandidates: previousTrace?.postgresQueryFilteredCandidates,
@@ -5247,6 +5262,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousPostgresQueryJsRemainderClauseCount: previousTrace?.postgresQueryJsRemainderClauseCount,
     previousPostgresQueryMultiplierUsed: previousTrace?.postgresQueryMultiplierUsed,
     previousPostgresQueryCandidateLimitUsed: previousTrace?.postgresQueryCandidateLimitUsed,
+    previousPostgresQueryMaxBackfillsUsed: previousTrace?.postgresQueryMaxBackfillsUsed,
     previousPostgresQueryPushdownCoverageRatio: previousTrace?.postgresQueryPushdownCoverageRatio,
     previousPostgresQueryJsRemainderRatio: previousTrace?.postgresQueryJsRemainderRatio,
     previousPostgresQueryReturnedCount: previousTrace?.postgresQueryReturnedCount,
@@ -5270,6 +5286,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     leadSpeakerAttributionCue,
     leadSpeakerCue,
     sqliteQueryBackfillCount,
+    sqliteQueryBackfillLimitReached,
     sqliteQueryCandidateBudgetExhausted,
     sqliteQueryCandidateCoverage,
     sqliteQueryFilteredCandidates,
@@ -5284,6 +5301,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     sqliteQueryJsRemainderClauseCount,
     sqliteQueryMultiplierUsed,
     sqliteQueryCandidateLimitUsed,
+    sqliteQueryMaxBackfillsUsed,
     sqliteQueryPushdownCoverageRatio,
     sqliteQueryJsRemainderRatio,
     sqliteQueryReturnedCount,
@@ -5291,6 +5309,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     sqliteQueryTopKFillRatio,
     sqliteQueryUnderfilledTopK,
     postgresQueryBackfillCount,
+    postgresQueryBackfillLimitReached,
     postgresQueryCandidateBudgetExhausted,
     postgresQueryCandidateCoverage,
     postgresQueryFilteredCandidates,
@@ -5305,6 +5324,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     postgresQueryJsRemainderClauseCount,
     postgresQueryMultiplierUsed,
     postgresQueryCandidateLimitUsed,
+    postgresQueryMaxBackfillsUsed,
     postgresQueryPushdownCoverageRatio,
     postgresQueryJsRemainderRatio,
     postgresQueryReturnedCount,
@@ -16922,9 +16942,11 @@ var buildStoreQueryPlanTraceMetadata = (store) => {
       sqliteQueryJsRemainderClauseCount: sqliteNativePlan.jsRemainderClauseCount,
       sqliteQueryMultiplierUsed: sqliteNativePlan.queryMultiplierUsed ?? null,
       sqliteQueryCandidateLimitUsed: sqliteNativePlan.candidateLimitUsed ?? null,
+      sqliteQueryMaxBackfillsUsed: sqliteNativePlan.maxBackfillsUsed ?? null,
       sqliteQueryJsRemainderRatio: sqliteNativePlan.jsRemainderRatio ?? null,
       sqliteQueryCandidateYieldRatio: sqliteNativePlan.candidateYieldRatio ?? null,
       sqliteQueryReturnedCount: sqliteNativePlan.returnedCount ?? null,
+      sqliteQueryBackfillLimitReached: sqliteNativePlan.backfillLimitReached ?? null,
       sqliteQueryTopKFillRatio: sqliteNativePlan.topKFillRatio ?? null,
       sqliteQueryUnderfilledTopK: sqliteNativePlan.underfilledTopK ?? null
     };
@@ -16950,9 +16972,11 @@ var buildStoreQueryPlanTraceMetadata = (store) => {
     postgresQueryJsRemainderClauseCount: postgresNativePlan.jsRemainderClauseCount,
     postgresQueryMultiplierUsed: postgresNativePlan.queryMultiplierUsed ?? null,
     postgresQueryCandidateLimitUsed: postgresNativePlan.candidateLimitUsed ?? null,
+    postgresQueryMaxBackfillsUsed: postgresNativePlan.maxBackfillsUsed ?? null,
     postgresQueryJsRemainderRatio: postgresNativePlan.jsRemainderRatio ?? null,
     postgresQueryCandidateYieldRatio: postgresNativePlan.candidateYieldRatio ?? null,
     postgresQueryReturnedCount: postgresNativePlan.returnedCount ?? null,
+    postgresQueryBackfillLimitReached: postgresNativePlan.backfillLimitReached ?? null,
     postgresQueryTopKFillRatio: postgresNativePlan.topKFillRatio ?? null,
     postgresQueryUnderfilledTopK: postgresNativePlan.underfilledTopK ?? null
   };
@@ -17082,6 +17106,7 @@ var createRAGCollection = (options) => {
         }, "query").then((nextQueryVector) => options.store.query({
           filter: input.filter,
           candidateLimit: input.nativeCandidateLimit,
+          maxBackfills: input.nativeMaxBackfills,
           queryMultiplier: input.nativeQueryMultiplier,
           queryVector: nextQueryVector,
           topK: candidateTopK
@@ -22073,6 +22098,7 @@ var ragChat = (config) => {
     const input = {
       filter: getObjectProperty(body, "filter"),
       nativeCandidateLimit: typeof body.nativeCandidateLimit === "number" ? body.nativeCandidateLimit : undefined,
+      nativeMaxBackfills: typeof body.nativeMaxBackfills === "number" ? body.nativeMaxBackfills : undefined,
       nativeQueryMultiplier: typeof body.nativeQueryMultiplier === "number" ? body.nativeQueryMultiplier : undefined,
       retrieval: undefined,
       model: getStringProperty(body, "model"),
@@ -28759,6 +28785,9 @@ var planNativeCandidateSearchK = (input) => {
   return Math.min(base, filtered);
 };
 var planNativeCandidateSearchBackfillK = (input) => {
+  if (typeof input.maxBackfills === "number" && Number.isFinite(input.maxBackfills) && (input.backfillCount ?? 0) >= Math.max(0, Math.floor(input.maxBackfills))) {
+    return input.currentSearchK;
+  }
   const cappedLimit = input.filteredCandidateCount === undefined || !Number.isFinite(input.filteredCandidateCount) ? input.candidateLimit : Math.min(input.candidateLimit, Math.max(0, Math.floor(input.filteredCandidateCount)));
   if (input.currentSearchK >= cappedLimit) {
     return input.currentSearchK;
@@ -29017,6 +29046,12 @@ var normalizeCandidateLimit = (value) => {
   }
   return Math.min(RAG_NATIVE_QUERY_CANDIDATE_LIMIT, Math.max(1, Math.floor(value)));
 };
+var normalizeMaxBackfills = (value) => {
+  if (value === undefined || !Number.isFinite(value)) {
+    return;
+  }
+  return Math.max(0, Math.floor(value));
+};
 var toQualifiedTableName = (schemaName, tableName) => `${schemaName}.${tableName}`;
 var toVectorLiteral = (vector) => `[${vector.join(",")}]`;
 var parseMetadata = (value) => {
@@ -29105,6 +29140,7 @@ var updatePostgresLastQueryPlan = (input) => {
     initialSearchK: input.initialSearchK,
     searchExpansionRatio: typeof input.initialSearchK === "number" && typeof input.finalSearchK === "number" && input.initialSearchK > 0 ? input.finalSearchK / input.initialSearchK : undefined,
     candidateLimitUsed: input.candidateLimitUsed,
+    maxBackfillsUsed: input.maxBackfillsUsed,
     jsRemainderClauseCount: pushdown.jsRemainderClauseCount,
     queryMultiplierUsed: input.queryMultiplierUsed,
     jsRemainderRatio: pushdown.jsRemainderRatio,
@@ -29115,6 +29151,7 @@ var updatePostgresLastQueryPlan = (input) => {
     queryMode: "native_pgvector",
     candidateYieldRatio: typeof input.returnedCount === "number" && typeof input.finalSearchK === "number" && input.finalSearchK > 0 ? input.returnedCount / input.finalSearchK : undefined,
     returnedCount: input.returnedCount,
+    backfillLimitReached: input.backfillLimitReached,
     topKFillRatio: typeof input.returnedCount === "number" && input.topK > 0 ? input.returnedCount / input.topK : undefined,
     totalFilterClauseCount: pushdown.totalFilterClauseCount,
     underfilledTopK: input.underfilledTopK
@@ -29198,6 +29235,7 @@ var createPostgresRAGStore = (options = {}) => {
     const queryVector = normalizeVector(input.queryVector);
     const queryMultiplier2 = normalizeQueryMultiplier(input.queryMultiplier ?? options.queryMultiplier);
     const candidateLimit = normalizeCandidateLimit(input.candidateLimit);
+    const maxBackfills = normalizeMaxBackfills(input.maxBackfills);
     const queryVectorLiteral = toVectorLiteral(queryVector);
     const pushdownFilter = buildPostgresPushdownFilter(input.filter);
     const countFilterPlan = buildPostgresFilterPlan(pushdownFilter);
@@ -29226,6 +29264,7 @@ var createPostgresRAGStore = (options = {}) => {
     let currentSearchK = initialSearchK;
     let backfillCount = 0;
     let candidateBudgetExhausted = false;
+    let backfillLimitReached = false;
     let effectiveFilteredCandidateCount = plannedFilteredCandidateCount;
     let mapped = [];
     for (;; ) {
@@ -29259,11 +29298,14 @@ var createPostgresRAGStore = (options = {}) => {
         break;
       }
       const nextSearchK = planNativeCandidateSearchBackfillK({
+        backfillCount,
         candidateLimit,
         currentSearchK,
-        filteredCandidateCount: effectiveFilteredCandidateCount
+        filteredCandidateCount: effectiveFilteredCandidateCount,
+        maxBackfills
       });
       if (nextSearchK <= currentSearchK) {
+        backfillLimitReached = typeof maxBackfills === "number" && backfillCount >= maxBackfills && mapped.length < input.topK;
         candidateBudgetExhausted = mapped.length < input.topK;
         break;
       }
@@ -29274,8 +29316,10 @@ var createPostgresRAGStore = (options = {}) => {
     const returned = mapped.slice(0, input.topK);
     updatePostgresLastQueryPlan({
       backfillCount,
+      backfillLimitReached,
       candidateBudgetExhausted,
       candidateLimitUsed: candidateLimit,
+      maxBackfillsUsed: maxBackfills,
       filter: input.filter,
       pushdownFilter,
       queryMultiplierUsed: queryMultiplier2,
@@ -29496,6 +29540,12 @@ var normalizeCandidateLimit2 = (value) => {
   }
   return Math.min(RAG_NATIVE_QUERY_CANDIDATE_LIMIT, Math.max(1, Math.floor(value)));
 };
+var normalizeMaxBackfills2 = (value) => {
+  if (value === undefined || !Number.isFinite(value)) {
+    return;
+  }
+  return Math.max(0, Math.floor(value));
+};
 var toJSONString = (metadata) => metadata === undefined ? null : JSON.stringify(metadata);
 var parseMetadata2 = (value) => {
   if (value === null) {
@@ -30074,6 +30124,7 @@ var updateSQLiteLastQueryPlan = (input) => {
     searchExpansionRatio: typeof input.initialSearchK === "number" && typeof input.finalSearchK === "number" && input.initialSearchK > 0 ? input.finalSearchK / input.initialSearchK : undefined,
     jsRemainderClauseCount: pushdown.jsRemainderClauseCount,
     candidateLimitUsed: input.candidateLimitUsed,
+    maxBackfillsUsed: input.maxBackfillsUsed,
     queryMultiplierUsed: input.queryMultiplierUsed,
     jsRemainderRatio: pushdown.jsRemainderRatio,
     pushdownApplied: pushdown.pushdownClauseCount > 0,
@@ -30083,6 +30134,7 @@ var updateSQLiteLastQueryPlan = (input) => {
     queryMode: input.queryMode,
     candidateYieldRatio: typeof input.returnedCount === "number" && typeof input.finalSearchK === "number" && input.finalSearchK > 0 ? input.returnedCount / input.finalSearchK : undefined,
     returnedCount: input.returnedCount,
+    backfillLimitReached: input.backfillLimitReached,
     topKFillRatio: typeof input.returnedCount === "number" && input.topK > 0 ? input.returnedCount / input.topK : undefined,
     totalFilterClauseCount: pushdown.totalFilterClauseCount,
     underfilledTopK: input.underfilledTopK
@@ -30241,6 +30293,7 @@ var createSQLiteRAGStore = (options = {}) => {
     }
     const queryMultiplier = normalizeQueryMultiplier2(input.queryMultiplier ?? nativeConfig?.queryMultiplier);
     const candidateLimit = normalizeCandidateLimit2(input.candidateLimit);
+    const maxBackfills = normalizeMaxBackfills2(input.maxBackfills);
     const queryVector = normalizeVector(input.queryVector);
     const queryVectorText = toVectorText(queryVector);
     const pushdownFilter = buildSQLitePushdownFilter(input.filter);
@@ -30264,6 +30317,7 @@ var createSQLiteRAGStore = (options = {}) => {
     let currentSearchK = searchK;
     let backfillCount = 0;
     let candidateBudgetExhausted = false;
+    let backfillLimitReached = false;
     let mapped = [];
     for (;; ) {
       const rawRows = runNativeQuery(currentSearchK);
@@ -30293,11 +30347,14 @@ var createSQLiteRAGStore = (options = {}) => {
         break;
       }
       const nextSearchK = planNativeCandidateSearchBackfillK({
+        backfillCount,
         candidateLimit,
         currentSearchK,
-        filteredCandidateCount
+        filteredCandidateCount,
+        maxBackfills
       });
       if (nextSearchK <= currentSearchK) {
+        backfillLimitReached = typeof maxBackfills === "number" && backfillCount >= maxBackfills && mapped.length < input.topK;
         candidateBudgetExhausted = mapped.length < input.topK;
         break;
       }
@@ -30306,6 +30363,7 @@ var createSQLiteRAGStore = (options = {}) => {
     }
     updateSQLiteLastQueryPlan({
       backfillCount,
+      backfillLimitReached,
       candidateBudgetExhausted,
       filter: input.filter,
       filteredCandidateCount,
@@ -30314,6 +30372,7 @@ var createSQLiteRAGStore = (options = {}) => {
       nativeDiagnostics,
       pushdownFilter,
       candidateLimitUsed: candidateLimit,
+      maxBackfillsUsed: maxBackfills,
       queryMultiplierUsed: queryMultiplier,
       queryMode: "native_vec0",
       returnedCount: Math.min(mapped.length, input.topK),
@@ -32484,5 +32543,5 @@ export {
   addRAGEvaluationSuiteCase
 };
 
-//# debugId=F50A92B6908BBB4464756E2164756E21
+//# debugId=78B8CFF451FC7B6D64756E2164756E21
 //# sourceMappingURL=index.js.map