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

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 === "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,
   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,6 +2522,7 @@ 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?.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,
@@ -2548,6 +2549,7 @@ 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?.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,
@@ -2574,6 +2576,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 +2601,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 +2767,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 +2802,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,6 +3867,7 @@ 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,
     sqliteQueryPushdownCoverageRatio: typeof metadata.sqliteQueryPushdownCoverageRatio === "number" ? metadata.sqliteQueryPushdownCoverageRatio : undefined,
     sqliteQueryJsRemainderRatio: typeof metadata.sqliteQueryJsRemainderRatio === "number" ? metadata.sqliteQueryJsRemainderRatio : undefined,
     sqliteQueryReturnedCount: typeof metadata.sqliteQueryReturnedCount === "number" ? metadata.sqliteQueryReturnedCount : undefined,
@@ -3887,6 +3894,7 @@ 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,
     postgresQueryPushdownCoverageRatio: typeof metadata.postgresQueryPushdownCoverageRatio === "number" ? metadata.postgresQueryPushdownCoverageRatio : undefined,
     postgresQueryJsRemainderRatio: typeof metadata.postgresQueryJsRemainderRatio === "number" ? metadata.postgresQueryJsRemainderRatio : undefined,
     postgresQueryReturnedCount: typeof metadata.postgresQueryReturnedCount === "number" ? metadata.postgresQueryReturnedCount : undefined,
@@ -5142,6 +5150,7 @@ 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 sqliteQueryPushdownCoverageRatio = currentSQLiteQueryPlanSnapshot.sqliteQueryPushdownCoverageRatio ?? currentSnapshot?.sqliteQueryPushdownCoverageRatio;
   const sqliteQueryJsRemainderRatio = currentSQLiteQueryPlanSnapshot.sqliteQueryJsRemainderRatio ?? currentSnapshot?.sqliteQueryJsRemainderRatio;
   const sqliteQueryFilteredCandidates = currentSQLiteQueryPlanSnapshot.sqliteQueryFilteredCandidates ?? currentSnapshot?.sqliteQueryFilteredCandidates;
@@ -5162,6 +5171,7 @@ 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 postgresQueryPushdownCoverageRatio = currentPostgresQueryPlanSnapshot.postgresQueryPushdownCoverageRatio ?? currentSnapshot?.postgresQueryPushdownCoverageRatio;
   const postgresQueryJsRemainderRatio = currentPostgresQueryPlanSnapshot.postgresQueryJsRemainderRatio ?? currentSnapshot?.postgresQueryJsRemainderRatio;
   const postgresQueryFilteredCandidates = currentPostgresQueryPlanSnapshot.postgresQueryFilteredCandidates ?? currentSnapshot?.postgresQueryFilteredCandidates;
@@ -5179,7 +5189,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.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";
   return {
     candidateTopK: currentTrace?.candidateTopK ?? 0,
     caseId: caseResult.caseId,
@@ -5215,6 +5225,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousSqliteQueryTotalFilterClauseCount: previousTrace?.sqliteQueryTotalFilterClauseCount,
     previousSqliteQueryJsRemainderClauseCount: previousTrace?.sqliteQueryJsRemainderClauseCount,
     previousSqliteQueryMultiplierUsed: previousTrace?.sqliteQueryMultiplierUsed,
+    previousSqliteQueryCandidateLimitUsed: previousTrace?.sqliteQueryCandidateLimitUsed,
     previousSqliteQueryPushdownCoverageRatio: previousTrace?.sqliteQueryPushdownCoverageRatio,
     previousSqliteQueryJsRemainderRatio: previousTrace?.sqliteQueryJsRemainderRatio,
     previousSqliteQueryReturnedCount: previousTrace?.sqliteQueryReturnedCount,
@@ -5235,6 +5246,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     previousPostgresQueryTotalFilterClauseCount: previousTrace?.postgresQueryTotalFilterClauseCount,
     previousPostgresQueryJsRemainderClauseCount: previousTrace?.postgresQueryJsRemainderClauseCount,
     previousPostgresQueryMultiplierUsed: previousTrace?.postgresQueryMultiplierUsed,
+    previousPostgresQueryCandidateLimitUsed: previousTrace?.postgresQueryCandidateLimitUsed,
     previousPostgresQueryPushdownCoverageRatio: previousTrace?.postgresQueryPushdownCoverageRatio,
     previousPostgresQueryJsRemainderRatio: previousTrace?.postgresQueryJsRemainderRatio,
     previousPostgresQueryReturnedCount: previousTrace?.postgresQueryReturnedCount,
@@ -5271,6 +5283,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     sqliteQueryTotalFilterClauseCount,
     sqliteQueryJsRemainderClauseCount,
     sqliteQueryMultiplierUsed,
+    sqliteQueryCandidateLimitUsed,
     sqliteQueryPushdownCoverageRatio,
     sqliteQueryJsRemainderRatio,
     sqliteQueryReturnedCount,
@@ -5291,6 +5304,7 @@ var buildEvaluationCaseTraceSnapshot = ({
     postgresQueryTotalFilterClauseCount,
     postgresQueryJsRemainderClauseCount,
     postgresQueryMultiplierUsed,
+    postgresQueryCandidateLimitUsed,
     postgresQueryPushdownCoverageRatio,
     postgresQueryJsRemainderRatio,
     postgresQueryReturnedCount,
@@ -16907,6 +16921,7 @@ var buildStoreQueryPlanTraceMetadata = (store) => {
       sqliteQueryTotalFilterClauseCount: sqliteNativePlan.totalFilterClauseCount,
       sqliteQueryJsRemainderClauseCount: sqliteNativePlan.jsRemainderClauseCount,
       sqliteQueryMultiplierUsed: sqliteNativePlan.queryMultiplierUsed ?? null,
+      sqliteQueryCandidateLimitUsed: sqliteNativePlan.candidateLimitUsed ?? null,
       sqliteQueryJsRemainderRatio: sqliteNativePlan.jsRemainderRatio ?? null,
       sqliteQueryCandidateYieldRatio: sqliteNativePlan.candidateYieldRatio ?? null,
       sqliteQueryReturnedCount: sqliteNativePlan.returnedCount ?? null,
@@ -16934,6 +16949,7 @@ var buildStoreQueryPlanTraceMetadata = (store) => {
     postgresQueryTotalFilterClauseCount: postgresNativePlan.totalFilterClauseCount,
     postgresQueryJsRemainderClauseCount: postgresNativePlan.jsRemainderClauseCount,
     postgresQueryMultiplierUsed: postgresNativePlan.queryMultiplierUsed ?? null,
+    postgresQueryCandidateLimitUsed: postgresNativePlan.candidateLimitUsed ?? null,
     postgresQueryJsRemainderRatio: postgresNativePlan.jsRemainderRatio ?? null,
     postgresQueryCandidateYieldRatio: postgresNativePlan.candidateYieldRatio ?? null,
     postgresQueryReturnedCount: postgresNativePlan.returnedCount ?? null,
@@ -17065,6 +17081,7 @@ var createRAGCollection = (options) => {
           text: query
         }, "query").then((nextQueryVector) => options.store.query({
           filter: input.filter,
+          candidateLimit: input.nativeCandidateLimit,
           queryMultiplier: input.nativeQueryMultiplier,
           queryVector: nextQueryVector,
           topK: candidateTopK
@@ -22055,6 +22072,7 @@ var ragChat = (config) => {
     }
     const input = {
       filter: getObjectProperty(body, "filter"),
+      nativeCandidateLimit: typeof body.nativeCandidateLimit === "number" ? body.nativeCandidateLimit : undefined,
       nativeQueryMultiplier: typeof body.nativeQueryMultiplier === "number" ? body.nativeQueryMultiplier : undefined,
       retrieval: undefined,
       model: getStringProperty(body, "model"),
@@ -28993,6 +29011,12 @@ 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 toQualifiedTableName = (schemaName, tableName) => `${schemaName}.${tableName}`;
 var toVectorLiteral = (vector) => `[${vector.join(",")}]`;
 var parseMetadata = (value) => {
@@ -29080,6 +29104,7 @@ 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,
     jsRemainderClauseCount: pushdown.jsRemainderClauseCount,
     queryMultiplierUsed: input.queryMultiplierUsed,
     jsRemainderRatio: pushdown.jsRemainderRatio,
@@ -29172,6 +29197,7 @@ var createPostgresRAGStore = (options = {}) => {
     await init();
     const queryVector = normalizeVector(input.queryVector);
     const queryMultiplier2 = normalizeQueryMultiplier(input.queryMultiplier ?? options.queryMultiplier);
+    const candidateLimit = normalizeCandidateLimit(input.candidateLimit);
     const queryVectorLiteral = toVectorLiteral(queryVector);
     const pushdownFilter = buildPostgresPushdownFilter(input.filter);
     const countFilterPlan = buildPostgresFilterPlan(pushdownFilter);
@@ -29189,7 +29215,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
@@ -29233,7 +29259,7 @@ var createPostgresRAGStore = (options = {}) => {
         break;
       }
       const nextSearchK = planNativeCandidateSearchBackfillK({
-        candidateLimit: RAG_NATIVE_QUERY_CANDIDATE_LIMIT,
+        candidateLimit,
         currentSearchK,
         filteredCandidateCount: effectiveFilteredCandidateCount
       });
@@ -29249,6 +29275,7 @@ var createPostgresRAGStore = (options = {}) => {
     updatePostgresLastQueryPlan({
       backfillCount,
       candidateBudgetExhausted,
+      candidateLimitUsed: candidateLimit,
       filter: input.filter,
       pushdownFilter,
       queryMultiplierUsed: queryMultiplier2,
@@ -29463,6 +29490,12 @@ 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 toJSONString = (metadata) => metadata === undefined ? null : JSON.stringify(metadata);
 var parseMetadata2 = (value) => {
   if (value === null) {
@@ -30040,6 +30073,7 @@ 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,
     queryMultiplierUsed: input.queryMultiplierUsed,
     jsRemainderRatio: pushdown.jsRemainderRatio,
     pushdownApplied: pushdown.pushdownClauseCount > 0,
@@ -30206,6 +30240,7 @@ 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 queryVector = normalizeVector(input.queryVector);
     const queryVectorText = toVectorText(queryVector);
     const pushdownFilter = buildSQLitePushdownFilter(input.filter);
@@ -30217,7 +30252,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
@@ -30258,7 +30293,7 @@ var createSQLiteRAGStore = (options = {}) => {
         break;
       }
       const nextSearchK = planNativeCandidateSearchBackfillK({
-        candidateLimit: RAG_NATIVE_QUERY_CANDIDATE_LIMIT,
+        candidateLimit,
         currentSearchK,
         filteredCandidateCount
       });
@@ -30278,6 +30313,7 @@ var createSQLiteRAGStore = (options = {}) => {
       initialSearchK: searchK,
       nativeDiagnostics,
       pushdownFilter,
+      candidateLimitUsed: candidateLimit,
       queryMultiplierUsed: queryMultiplier,
       queryMode: "native_vec0",
       returnedCount: Math.min(mapped.length, input.topK),
@@ -32448,5 +32484,5 @@ export {
   addRAGEvaluationSuiteCase
 };
 
-//# debugId=5A59D44AA35F8CBB64756E2164756E21
+//# debugId=F50A92B6908BBB4464756E2164756E21
 //# sourceMappingURL=index.js.map