@absolutejs/absolute 0.19.0-beta.632 → 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 === "postgresQueryJsRemainderClauseCount" ? "Postgres JS remainder clauses" : key === "postgresQueryMultiplierUsed" ? "Postgres query multiplier" : 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) => {
@@ -2522,12 +2522,15 @@ var formatSQLitePlannerCueSummary = (input) => {
     typeof input?.sqliteQueryPushdownCoverageRatio === "number" ? `pushdown ${(input.sqliteQueryPushdownCoverageRatio * 100).toFixed(0)}%` : undefined,
     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,
@@ -2548,12 +2551,15 @@ var formatPostgresPlannerCueSummary = (input) => {
     typeof input?.postgresQueryPushdownCoverageRatio === "number" ? `pushdown ${(input.postgresQueryPushdownCoverageRatio * 100).toFixed(0)}%` : undefined,
     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,
@@ -2574,6 +2580,7 @@ var formatComparisonSQLitePlannerCueSummary = (entry) => {
     sqliteQueryInitialSearchK: snapshot.sqliteQueryInitialSearchK,
     sqliteQuerySearchExpansionRatio: snapshot.sqliteQuerySearchExpansionRatio,
     sqliteQueryJsRemainderClauseCount: snapshot.sqliteQueryJsRemainderClauseCount,
+    sqliteQueryCandidateLimitUsed: snapshot.sqliteQueryCandidateLimitUsed,
     sqliteQueryMode: snapshot.sqliteQueryMode,
     sqliteQueryPushdownApplied: snapshot.sqliteQueryPushdownApplied,
     sqliteQueryPushdownClauseCount: snapshot.sqliteQueryPushdownClauseCount,
@@ -2598,6 +2605,7 @@ var formatComparisonPostgresPlannerCueSummary = (entry) => {
     postgresQueryInitialSearchK: snapshot.postgresQueryInitialSearchK,
     postgresQuerySearchExpansionRatio: snapshot.postgresQuerySearchExpansionRatio,
     postgresQueryJsRemainderClauseCount: snapshot.postgresQueryJsRemainderClauseCount,
+    postgresQueryCandidateLimitUsed: snapshot.postgresQueryCandidateLimitUsed,
     postgresQueryMultiplierUsed: snapshot.postgresQueryMultiplierUsed,
     postgresQueryMode: snapshot.postgresQueryMode,
     postgresQueryPushdownApplied: snapshot.postgresQueryPushdownApplied,
@@ -2763,6 +2771,7 @@ var formatHistorySQLitePlannerShift = (history) => {
       sqliteQueryInitialSearchK: entry.previousSqliteQueryInitialSearchK,
       sqliteQuerySearchExpansionRatio: entry.previousSqliteQuerySearchExpansionRatio,
       sqliteQueryJsRemainderClauseCount: entry.previousSqliteQueryJsRemainderClauseCount,
+      sqliteQueryCandidateLimitUsed: entry.previousSqliteQueryCandidateLimitUsed,
       sqliteQueryMode: entry.previousSqliteQueryMode,
       sqliteQueryPushdownApplied: entry.previousSqliteQueryPushdownApplied,
       sqliteQueryPushdownClauseCount: entry.previousSqliteQueryPushdownClauseCount,
@@ -2797,6 +2806,7 @@ var formatHistoryPostgresPlannerShift = (history) => {
       postgresQueryInitialSearchK: entry.previousPostgresQueryInitialSearchK,
       postgresQuerySearchExpansionRatio: entry.previousPostgresQuerySearchExpansionRatio,
       postgresQueryJsRemainderClauseCount: entry.previousPostgresQueryJsRemainderClauseCount,
+      postgresQueryCandidateLimitUsed: entry.previousPostgresQueryCandidateLimitUsed,
       postgresQueryMultiplierUsed: entry.previousPostgresQueryMultiplierUsed,
       postgresQueryMode: entry.previousPostgresQueryMode,
       postgresQueryPushdownApplied: entry.previousPostgresQueryPushdownApplied,
@@ -3861,10 +3871,13 @@ var buildEvaluationSQLiteQueryPlanSnapshot = (trace) => {
     sqliteQueryTotalFilterClauseCount: typeof metadata.sqliteQueryTotalFilterClauseCount === "number" ? metadata.sqliteQueryTotalFilterClauseCount : undefined,
     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
   };
@@ -3887,10 +3900,13 @@ var buildEvaluationPostgresQueryPlanSnapshot = (trace) => {
     postgresQueryTotalFilterClauseCount: typeof metadata.postgresQueryTotalFilterClauseCount === "number" ? metadata.postgresQueryTotalFilterClauseCount : undefined,
     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
   };
@@ -5142,6 +5158,8 @@ var buildEvaluationCaseTraceSnapshot = ({
   const sqliteQueryTotalFilterClauseCount = currentSQLiteQueryPlanSnapshot.sqliteQueryTotalFilterClauseCount ?? currentSnapshot?.sqliteQueryTotalFilterClauseCount;
   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;
@@ -5149,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;
@@ -5162,6 +5181,8 @@ var buildEvaluationCaseTraceSnapshot = ({
   const postgresQueryTotalFilterClauseCount = currentPostgresQueryPlanSnapshot.postgresQueryTotalFilterClauseCount ?? currentSnapshot?.postgresQueryTotalFilterClauseCount;
   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;
@@ -5169,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;
@@ -5179,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.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.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,
@@ -5202,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,
@@ -5215,6 +5238,8 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousSqliteQueryTotalFilterClauseCount: previousTrace?.sqliteQueryTotalFilterClauseCount,
     previousSqliteQueryJsRemainderClauseCount: previousTrace?.sqliteQueryJsRemainderClauseCount,
     previousSqliteQueryMultiplierUsed: previousTrace?.sqliteQueryMultiplierUsed,
+    previousSqliteQueryCandidateLimitUsed: previousTrace?.sqliteQueryCandidateLimitUsed,
+    previousSqliteQueryMaxBackfillsUsed: previousTrace?.sqliteQueryMaxBackfillsUsed,
     previousSqliteQueryPushdownCoverageRatio: previousTrace?.sqliteQueryPushdownCoverageRatio,
     previousSqliteQueryJsRemainderRatio: previousTrace?.sqliteQueryJsRemainderRatio,
     previousSqliteQueryReturnedCount: previousTrace?.sqliteQueryReturnedCount,
@@ -5222,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,
@@ -5235,6 +5261,8 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousPostgresQueryTotalFilterClauseCount: previousTrace?.postgresQueryTotalFilterClauseCount,
     previousPostgresQueryJsRemainderClauseCount: previousTrace?.postgresQueryJsRemainderClauseCount,
     previousPostgresQueryMultiplierUsed: previousTrace?.postgresQueryMultiplierUsed,
+    previousPostgresQueryCandidateLimitUsed: previousTrace?.postgresQueryCandidateLimitUsed,
+    previousPostgresQueryMaxBackfillsUsed: previousTrace?.postgresQueryMaxBackfillsUsed,
     previousPostgresQueryPushdownCoverageRatio: previousTrace?.postgresQueryPushdownCoverageRatio,
     previousPostgresQueryJsRemainderRatio: previousTrace?.postgresQueryJsRemainderRatio,
     previousPostgresQueryReturnedCount: previousTrace?.postgresQueryReturnedCount,
@@ -5258,6 +5286,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     leadSpeakerAttributionCue,
     leadSpeakerCue,
     sqliteQueryBackfillCount,
+    sqliteQueryBackfillLimitReached,
     sqliteQueryCandidateBudgetExhausted,
     sqliteQueryCandidateCoverage,
     sqliteQueryFilteredCandidates,
@@ -5271,6 +5300,8 @@ var buildEvaluationCaseTraceSnapshot = ({
     sqliteQueryTotalFilterClauseCount,
     sqliteQueryJsRemainderClauseCount,
     sqliteQueryMultiplierUsed,
+    sqliteQueryCandidateLimitUsed,
+    sqliteQueryMaxBackfillsUsed,
     sqliteQueryPushdownCoverageRatio,
     sqliteQueryJsRemainderRatio,
     sqliteQueryReturnedCount,
@@ -5278,6 +5309,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     sqliteQueryTopKFillRatio,
     sqliteQueryUnderfilledTopK,
     postgresQueryBackfillCount,
+    postgresQueryBackfillLimitReached,
     postgresQueryCandidateBudgetExhausted,
     postgresQueryCandidateCoverage,
     postgresQueryFilteredCandidates,
@@ -5291,6 +5323,8 @@ var buildEvaluationCaseTraceSnapshot = ({
     postgresQueryTotalFilterClauseCount,
     postgresQueryJsRemainderClauseCount,
     postgresQueryMultiplierUsed,
+    postgresQueryCandidateLimitUsed,
+    postgresQueryMaxBackfillsUsed,
     postgresQueryPushdownCoverageRatio,
     postgresQueryJsRemainderRatio,
     postgresQueryReturnedCount,
@@ -16907,9 +16941,12 @@ var buildStoreQueryPlanTraceMetadata = (store) => {
       sqliteQueryTotalFilterClauseCount: sqliteNativePlan.totalFilterClauseCount,
       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
     };
@@ -16934,9 +16971,12 @@ var buildStoreQueryPlanTraceMetadata = (store) => {
     postgresQueryTotalFilterClauseCount: postgresNativePlan.totalFilterClauseCount,
     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
   };
@@ -17065,6 +17105,8 @@ var createRAGCollection = (options) => {
           text: query
         }, "query").then((nextQueryVector) => options.store.query({
           filter: input.filter,
+          candidateLimit: input.nativeCandidateLimit,
+          maxBackfills: input.nativeMaxBackfills,
           queryMultiplier: input.nativeQueryMultiplier,
           queryVector: nextQueryVector,
           topK: candidateTopK
@@ -22055,6 +22097,8 @@ 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"),
@@ -28741,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;
@@ -28993,6 +29040,18 @@ var normalizeQueryMultiplier = (value) => {
   }
   return Math.min(MAX_QUERY_MULTIPLIER, Math.max(1, Math.floor(value)));
 };
+var normalizeCandidateLimit = (value) => {
+  if (value === undefined || !Number.isFinite(value)) {
+    return RAG_NATIVE_QUERY_CANDIDATE_LIMIT;
+  }
+  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) => {
@@ -29080,6 +29139,8 @@ var updatePostgresLastQueryPlan = (input) => {
     finalSearchK: input.finalSearchK,
     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,
@@ -29090,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
@@ -29172,6 +29234,8 @@ var createPostgresRAGStore = (options = {}) => {
     await init();
     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);
@@ -29189,7 +29253,7 @@ var createPostgresRAGStore = (options = {}) => {
     const hasPushdownFilter = Boolean(pushdownFilter);
     const plannedFilteredCandidateCount = hasPushdownFilter && totalRows === 0 ? undefined : totalRows;
     const initialSearchK = planNativeCandidateSearchK({
-      candidateLimit: RAG_NATIVE_QUERY_CANDIDATE_LIMIT,
+      candidateLimit,
       filteredCandidateCount: plannedFilteredCandidateCount,
       queryMultiplier: queryMultiplier2,
       topK: input.topK
@@ -29200,6 +29264,7 @@ var createPostgresRAGStore = (options = {}) => {
     let currentSearchK = initialSearchK;
     let backfillCount = 0;
     let candidateBudgetExhausted = false;
+    let backfillLimitReached = false;
     let effectiveFilteredCandidateCount = plannedFilteredCandidateCount;
     let mapped = [];
     for (;; ) {
@@ -29233,11 +29298,14 @@ var createPostgresRAGStore = (options = {}) => {
         break;
       }
       const nextSearchK = planNativeCandidateSearchBackfillK({
-        candidateLimit: RAG_NATIVE_QUERY_CANDIDATE_LIMIT,
+        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;
       }
@@ -29248,7 +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,
@@ -29463,6 +29534,18 @@ var normalizeQueryMultiplier2 = (value) => {
   const minMultiplier = Math.max(1, Math.floor(value));
   return Math.min(minMultiplier, MAX_QUERY_MULTIPLIER2);
 };
+var normalizeCandidateLimit2 = (value) => {
+  if (value === undefined || !Number.isFinite(value)) {
+    return RAG_NATIVE_QUERY_CANDIDATE_LIMIT;
+  }
+  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) {
@@ -30040,6 +30123,8 @@ var updateSQLiteLastQueryPlan = (input) => {
     initialSearchK: input.initialSearchK,
     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,
@@ -30049,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
@@ -30206,6 +30292,8 @@ var createSQLiteRAGStore = (options = {}) => {
       throw new Error("Native vector backend is not available");
     }
     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);
@@ -30217,7 +30305,7 @@ var createSQLiteRAGStore = (options = {}) => {
     });
     const filteredCandidateCount = getFilteredSQLiteCandidateCount(db, tableName, filterPlan);
     const searchK = planNativeCandidateSearchK({
-      candidateLimit: RAG_NATIVE_QUERY_CANDIDATE_LIMIT,
+      candidateLimit,
       filteredCandidateCount,
       queryMultiplier,
       topK: input.topK
@@ -30229,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);
@@ -30258,11 +30347,14 @@ var createSQLiteRAGStore = (options = {}) => {
         break;
       }
       const nextSearchK = planNativeCandidateSearchBackfillK({
-        candidateLimit: RAG_NATIVE_QUERY_CANDIDATE_LIMIT,
+        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;
       }
@@ -30271,6 +30363,7 @@ var createSQLiteRAGStore = (options = {}) => {
     }
     updateSQLiteLastQueryPlan({
       backfillCount,
+      backfillLimitReached,
       candidateBudgetExhausted,
       filter: input.filter,
       filteredCandidateCount,
@@ -30278,6 +30371,8 @@ var createSQLiteRAGStore = (options = {}) => {
       initialSearchK: searchK,
       nativeDiagnostics,
       pushdownFilter,
+      candidateLimitUsed: candidateLimit,
+      maxBackfillsUsed: maxBackfills,
       queryMultiplierUsed: queryMultiplier,
       queryMode: "native_vec0",
       returnedCount: Math.min(mapped.length, input.topK),
@@ -32448,5 +32543,5 @@ export {
   addRAGEvaluationSuiteCase
 };
 
-//# debugId=5A59D44AA35F8CBB64756E2164756E21
+//# debugId=78B8CFF451FC7B6D64756E2164756E21
 //# sourceMappingURL=index.js.map