mixpeek 0.81.269 → 0.81.271

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -52,6 +52,18 @@ export interface StageParamsFeatureSearch {
52
52
  * @memberof StageParamsFeatureSearch
53
53
  */
54
54
  'hard_timeout_ms'?: number;
55
+ /**
56
+ * OPTIONAL (BACKE-3177). Declare this retriever serves an INTERACTIVE surface (chat widget, live search-as-you-type): the stage opts out of the server-side extended degrade-retry and degrades at its first hard ceiling. Use when a caller abandons long before the two-attempt worst case (~20s) — a fast \'search is degraded\' beats a correct answer nobody waits for, and skips the wasted backend work. Leave False (default) for batch/backfill/API callers: the extended retry converts a slow-but-real backend into complete results instead of zero documents. CONSUMER CONTRACT: this opt-out converts a latency problem into a ZERO-RESULTS problem — a ceiling timeout now returns an empty set with status \'degraded\' and an explanatory warning. Any consumer that renders or synthesizes over the result set MUST read status/warnings before treating empty as no-match, or it will confidently tell users content does not exist during a backend brownout (hit in production within minutes of the first adoption; see BACKE-3177).
57
+ * @type {boolean}
58
+ * @memberof StageParamsFeatureSearch
59
+ */
60
+ 'interactive'?: boolean;
61
+ /**
62
+ * OPTIONAL (BACKE-3177). Explicit switch for the server-side extended degrade-retry on ceiling timeout. False = opt out (equivalent to interactive=true); None/True = keep the default retry behavior. Prefer `interactive` for intent-revealing configs; this switch exists for surfaces that want the opt-out without the label.
63
+ * @type {boolean}
64
+ * @memberof StageParamsFeatureSearch
65
+ */
66
+ 'degrade_retry'?: boolean;
55
67
  /**
56
68
  * OPTIONAL. Score fusion strategy for combining multiple feature searches. Defaults to \'rrf\' (Reciprocal Rank Fusion). Only relevant when searches has 2+ entries. Ignored for single feature search (no fusion needed). ┌──────────┬──────────────┬────────────────────────────────────────┐ │ Strategy │ MVS Native│ Description │ ├──────────┼──────────────┼────────────────────────────────────────┤ │ rrf │ ✅ Yes │ Rank-based, robust default │ │ dbsf │ ✅ Yes │ Score-based with normalization │ │ weighted │ ❌ No │ Manual score-weighted fusion │ │ max │ ❌ No │ Best match from any feature │ │ learned │ ❌ No │ Bandit-learned, personalized weights │ └──────────┴──────────────┴────────────────────────────────────────┘ \'rrf\' (default): Rank-based fusion, robust and simple. Single MVS call, no tuning needed. \'dbsf\': Score-based fusion with statistical normalization. Single MVS call, handles different score scales. \'weighted\': Manual weight fusion using FeatureSearchConfig.weight. N separate queries, merged client-side. \'max\': Maximum score across features (OR semantics). N separate queries, merged client-side. \'learned\': Bandit-learned weights from user feedback. Requires learning_config. Enables personalization. N separate queries for per-feature score tracking.
57
69
  * @type {StageDefsFusionStrategy}
@@ -1 +1 @@
1
- {"version":3,"file":"stage-params-feature-search.d.ts","sourceRoot":"","sources":["../../models/stage-params-feature-search.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAGjF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAGvF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAG1F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG5E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAGvF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAGpF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAErF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,2BAA2B,CAAC;IAC/C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACjD;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;IACjD;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;IACpD;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C;;;;OAIG;IACH,UAAU,CAAC,EAAE,6BAA6B,CAAC;CAC9C"}
1
+ {"version":3,"file":"stage-params-feature-search.d.ts","sourceRoot":"","sources":["../../models/stage-params-feature-search.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;GAUG;AAKH,OAAO,KAAK,EAAE,yBAAyB,EAAE,MAAM,iCAAiC,CAAC;AAGjF,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAGvF,OAAO,KAAK,EAAE,6BAA6B,EAAE,MAAM,sCAAsC,CAAC;AAG1F,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAG5E,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,oCAAoC,CAAC;AAGvF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAGpF,OAAO,KAAK,EAAE,2BAA2B,EAAE,MAAM,mCAAmC,CAAC;AAErF;;;;GAIG;AACH,MAAM,WAAW,wBAAwB;IACrC;;;;OAIG;IACH,gBAAgB,CAAC,EAAE,2BAA2B,CAAC;IAC/C;;;;OAIG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;;OAIG;IACH,UAAU,CAAC,EAAE,KAAK,CAAC,4BAA4B,CAAC,CAAC;IACjD;;;;OAIG;IACH,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B;;;;OAIG;IACH,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB;;;;OAIG;IACH,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B;;;;OAIG;IACH,QAAQ,CAAC,EAAE,uBAAuB,CAAC;IACnC;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,4BAA4B,CAAC;IACjD;;;;OAIG;IACH,qBAAqB,CAAC,EAAE,2BAA2B,CAAC;IACpD;;;;OAIG;IACH,iBAAiB,CAAC,EAAE,OAAO,CAAC;IAC5B;;;;OAIG;IACH,wBAAwB,CAAC,EAAE,KAAK,CAAC,MAAM,CAAC,CAAC;IACzC;;;;OAIG;IACH,QAAQ,CAAC,EAAE,KAAK,CAAC,yBAAyB,CAAC,CAAC;IAC5C;;;;OAIG;IACH,UAAU,CAAC,EAAE,6BAA6B,CAAC;CAC9C"}
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "mixpeek",
3
- "version": "0.81.269",
3
+ "version": "0.81.271",
4
4
  "description": "Official Mixpeek TypeScript/JavaScript SDK for multimodal data processing and retrieval",
5
5
  "main": "./dist/index.js",
6
6
  "module": "./dist/index.mjs",