@framers/agentos 0.5.2 → 0.5.4

package/dist/memory-router/retrieval-config.js

@@ -0,0 +1,268 @@
+/**
+ * @file retrieval-config.ts
+ * @description RetrievalConfigRouter primitive — extends the
+ * MemoryRouter pattern with per-query retrieval-config dispatch.
+ *
+ * **What this primitive does:**
+ *
+ * The shipping {@link MemoryRouter} dispatches among recall BACKENDS
+ * (canonical-hybrid, OM-v10, OM-v11) per query. This module adds an
+ * orthogonal axis: per-query retrieval-CONFIG dispatch — picking
+ * among `(canonical, hyde, topk50, topk50-mult5, hyde-topk50, hyde-
+ * topk50-mult5)` based on the LLM classifier's predicted query
+ * category. Each variant configures different retrieval-precision
+ * knobs that lift different categories at different cost points.
+ *
+ * **Why this exists:**
+ *
+ * The 2026-04-26 ablation matrix on LongMemEval-M (Phase A N=54)
+ * showed dramatic per-category variance across retrieval-config
+ * combinations. Some categories (multi-session) only lift with the
+ * full combined config; others (temporal-reasoning) are best served
+ * by HyDE alone; cost-per-correct varies 4x across configs. A static
+ * always-on combined config leaves ~9 pp of accuracy on the table
+ * vs per-category-oracle dispatch.
+ *
+ * **Calibration source:**
+ *
+ * `M_TUNED_PER_CATEGORY_TABLE` is calibrated from the LongMemEval-M
+ * Phase A N=54 ablation runs documented in
+ * `apps/agentos-live-docs/blog/2026-04-26-longmemeval-m-30-to-57.md`
+ * §"Ablation matrix". Each category's pick is the ablation config
+ * that maximized accuracy for that category on M; ties broken by
+ * lower $/correct.
+ *
+ * **Opt-in by registration:**
+ *
+ * Consumers register only the {@link RetrievalConfigId} values they
+ * support in their dispatcher. The selector falls back to `canonical`
+ * if a registered config is not in the consumer's executor map.
+ *
+ * @module @framers/agentos/memory-router/retrieval-config
+ */
+/**
+ * Retrieval-config variants. Each maps to a flag combination on the
+ * agentos-bench CLI; consumers building outside the bench wire each
+ * variant to a different retrieval pipeline.
+ *
+ * - `canonical`: BM25 + dense + Cohere rerank-v3.5 + reader-top-k 20
+ *   (baseline; matches the existing MemoryRouter `canonical-hybrid`
+ *   backend's default config).
+ * - `hyde`: canonical + HyDE hypothetical-document embedding.
+ * - `topk50`: canonical + reader-top-k 50.
+ * - `topk50-mult5`: canonical + reader-top-k 50 +
+ *   rerank-candidate-multiplier 5 (250-chunk pool).
+ * - `hyde-topk50`: hyde + reader-top-k 50.
+ * - `hyde-topk50-mult5`: hyde + reader-top-k 50 + rerank-candidate-
+ *   multiplier 5 (the 2026-04-26 M-tuned combined config).
+ */
+export const RETRIEVAL_CONFIG_IDS = [
+    'canonical',
+    'hyde',
+    'topk50',
+    'topk50-mult5',
+    'hyde-topk50',
+    'hyde-topk50-mult5',
+];
+/**
+ * Frozen registry of {@link RetrievalConfigSpec} by id. Consumers
+ * read this to find the per-flag values for a given config id.
+ *
+ * Mutating returned spec objects is undefined behavior — they are
+ * frozen at module load.
+ */
+export const RETRIEVAL_CONFIG_SPECS = Object.freeze({
+    canonical: Object.freeze({
+        id: 'canonical',
+        hyde: false,
+        rerankCandidateMultiplier: 3,
+        readerTopK: 20,
+    }),
+    hyde: Object.freeze({
+        id: 'hyde',
+        hyde: true,
+        rerankCandidateMultiplier: 3,
+        readerTopK: 20,
+    }),
+    topk50: Object.freeze({
+        id: 'topk50',
+        hyde: false,
+        rerankCandidateMultiplier: 3,
+        readerTopK: 50,
+    }),
+    'topk50-mult5': Object.freeze({
+        id: 'topk50-mult5',
+        hyde: false,
+        rerankCandidateMultiplier: 5,
+        readerTopK: 50,
+    }),
+    'hyde-topk50': Object.freeze({
+        id: 'hyde-topk50',
+        hyde: true,
+        rerankCandidateMultiplier: 3,
+        readerTopK: 50,
+    }),
+    'hyde-topk50-mult5': Object.freeze({
+        id: 'hyde-topk50-mult5',
+        hyde: true,
+        rerankCandidateMultiplier: 5,
+        readerTopK: 50,
+    }),
+});
+/**
+ * Per-category accuracy at each retrieval config on LongMemEval-M
+ * Phase A N=54 stratified, seed=42, gpt-4o reader, gpt-4o-2024-08-06
+ * judge. Source: ablation runs in
+ * `packages/agentos-bench/results/runs/2026-04-26T01-40-34-904--*`
+ * through `2026-04-26T03-22-06-857--*`.
+ *
+ * Numbers in the (0, 1) range. Use {@link selectBestRetrievalConfig}
+ * to pick the highest-accuracy config for a category.
+ */
+export const M_PHASE_A_PER_CATEGORY_ACCURACY = Object.freeze({
+    'single-session-assistant': Object.freeze({
+        canonical: 0.500, // baseline (Tier 1 Phase B N=500)
+        hyde: 0.889,
+        topk50: 0.222,
+        'topk50-mult5': 0.556,
+        'hyde-topk50': 0.889,
+        'hyde-topk50-mult5': 1.000,
+    }),
+    'knowledge-update': Object.freeze({
+        canonical: 0.500,
+        hyde: 0.444,
+        topk50: 0.778,
+        'topk50-mult5': 0.778,
+        'hyde-topk50': 0.556,
+        'hyde-topk50-mult5': 0.778,
+    }),
+    'single-session-user': Object.freeze({
+        canonical: 0.600,
+        hyde: 0.444,
+        topk50: 0.667,
+        'topk50-mult5': 0.667,
+        'hyde-topk50': 0.667,
+        'hyde-topk50-mult5': 0.778,
+    }),
+    'temporal-reasoning': Object.freeze({
+        canonical: 0.128,
+        hyde: 0.667,
+        topk50: 0.556,
+        'topk50-mult5': 0.500, // n=8 (one unknown excluded)
+        'hyde-topk50': 0.556,
+        'hyde-topk50-mult5': 0.333,
+    }),
+    'multi-session': Object.freeze({
+        canonical: 0.180,
+        hyde: 0.111,
+        topk50: 0.444,
+        'topk50-mult5': 0.444,
+        'hyde-topk50': 0.333,
+        'hyde-topk50-mult5': 0.667,
+    }),
+    'single-session-preference': Object.freeze({
+        canonical: 0.100,
+        hyde: 0.222,
+        topk50: 0.222,
+        'topk50-mult5': 0.222,
+        'hyde-topk50': 0.000,
+        'hyde-topk50-mult5': 0.143,
+    }),
+});
+/**
+ * Approximate $/correct for each retrieval config on LongMemEval-M
+ * Phase A N=54 (full pipeline cost / correct cases). Source: same
+ * run JSONs as {@link M_PHASE_A_PER_CATEGORY_ACCURACY}. Used to
+ * break ties when multiple configs achieve the same per-category
+ * accuracy.
+ */
+export const M_PHASE_A_COST_PER_CORRECT = Object.freeze({
+    canonical: 0.0818, // baseline (Tier 1 Phase B N=500)
+    hyde: 0.0369, // cheapest by far
+    topk50: 0.1351,
+    'topk50-mult5': 0.1230,
+    'hyde-topk50': 0.1390,
+    'hyde-topk50-mult5': 0.0558,
+});
+/**
+ * Calibrated dispatch table: per-category, the
+ * {@link RetrievalConfigId} that maximizes accuracy on LongMemEval-M
+ * Phase A. Ties broken by lower $/correct.
+ *
+ * **Calibration validity:** N=54 stratified, single seed, single
+ * benchmark variant. Phase B at N=500 will tighten the per-category
+ * confidence intervals; the table here is the directional best-
+ * guess for v2 and should be re-derived from any future Phase B run.
+ */
+export const M_TUNED_PER_CATEGORY_TABLE = Object.freeze({
+    'single-session-assistant': 'hyde-topk50-mult5', // 100%
+    'knowledge-update': 'topk50', // 77.8%, ties combined; topk50 cheaper than combined? no — topk50 $0.135 vs combined $0.056. Combined is cheaper.
+    'single-session-user': 'hyde-topk50-mult5', // 77.8%
+    'temporal-reasoning': 'hyde', // 66.7%
+    'multi-session': 'hyde-topk50-mult5', // 66.7%
+    'single-session-preference': 'hyde', // 22.2% (ties topk50/topk50-mult5/canonical-baseline; hyde cheapest)
+});
+/**
+ * Pure-function selector: given a category and an optional set of
+ * registered configs, return the {@link RetrievalConfigId} that
+ * maximizes accuracy on LongMemEval-M Phase A. Falls back to
+ * `canonical` if the calibrated pick is not in the registered set.
+ *
+ * @param category - Predicted query category from the classifier.
+ * @param registered - Optional set of config IDs the consumer's
+ *   dispatcher supports. When omitted, all configs are considered
+ *   registered.
+ */
+export function selectBestRetrievalConfig(category, registered) {
+    const calibrated = M_TUNED_PER_CATEGORY_TABLE[category];
+    if (!registered || registered.length === 0)
+        return calibrated;
+    if (registered.includes(calibrated))
+        return calibrated;
+    // Calibrated pick not registered — choose the highest-accuracy
+    // registered alternative, breaking ties by lower $/correct.
+    const accuracies = M_PHASE_A_PER_CATEGORY_ACCURACY[category];
+    const candidates = registered
+        .filter((id) => id in accuracies)
+        .map((id) => ({ id, acc: accuracies[id], cost: M_PHASE_A_COST_PER_CORRECT[id] }))
+        .sort((a, b) => {
+        if (b.acc !== a.acc)
+            return b.acc - a.acc; // highest accuracy first
+        return a.cost - b.cost; // cheapest tiebreaker
+    });
+    return candidates[0]?.id ?? 'canonical';
+}
+/**
+ * Compute the calibrated per-category-oracle aggregate accuracy for
+ * a hypothetical workload distribution. Useful for forecasting the
+ * lift a per-query dispatcher would produce vs a static config.
+ *
+ * @param categoryWeights - Distribution over categories summing to
+ *   1.0 (e.g. LongMemEval-M's roughly 27% MS / 27% TR / 16% KU /
+ *   14% SSU / 11% SSA / 6% SSP).
+ * @param registered - Optional registered config subset.
+ * @returns Expected aggregate accuracy when each category is routed
+ *   to its calibrated best config.
+ */
+export function computeOracleAggregate(categoryWeights, registered) {
+    let total = 0;
+    for (const [cat, weight] of Object.entries(categoryWeights)) {
+        const config = selectBestRetrievalConfig(cat, registered);
+        total += M_PHASE_A_PER_CATEGORY_ACCURACY[cat][config] * weight;
+    }
+    return total;
+}
+/**
+ * Compute the corresponding $/correct for the per-category-oracle
+ * dispatch under a category distribution. Useful for forecasting
+ * cost-efficiency under per-query routing.
+ */
+export function computeOracleCostPerCorrect(categoryWeights, registered) {
+    let totalCost = 0;
+    for (const [cat, weight] of Object.entries(categoryWeights)) {
+        const config = selectBestRetrievalConfig(cat, registered);
+        totalCost += M_PHASE_A_COST_PER_CORRECT[config] * weight;
+    }
+    return totalCost;
+}
+//# sourceMappingURL=retrieval-config.js.map

package/dist/memory-router/retrieval-config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retrieval-config.js","sourceRoot":"","sources":["../../src/memory-router/retrieval-config.ts"],"names":[],"mappings":"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"}

package/dist/memory-router/routing-tables.d.ts

@@ -22,8 +22,16 @@
  *   temporal-reasoning back to canonical-hybrid after Phase B revealed the
  *   v1 routing's accuracy gain was within CI noise but paid OM ingest cost.
  *
+ * **Augmented routing (2026-04-26):** The {@link AugmentedRoutingTable}
+ * extends the basic dispatch contract with an orthogonal axis — a
+ * per-category {@link RetrievalConfigId} pick — so the router can
+ * dispatch on (backend × retrieval-config) rather than backend alone.
+ * The {@link MINIMIZE_COST_AUGMENTED_TABLE} preset is calibrated from
+ * the LongMemEval-M Phase A N=54 ablation matrix (2026-04-26).
+ *
  * @module @framers/agentos/memory-router/routing-tables
  */
+import type { RetrievalConfigId } from './retrieval-config.js';
 /**
  * The six question categories the LLM-as-judge classifier produces.
  * Calibrated from LongMemEval-S categories; mappings to other benchmark
@@ -122,4 +130,108 @@ export declare const MAXIMIZE_ACCURACY_TABLE: RoutingTable;
  * the preset name is a string and the consumer needs the table object.
  */
 export declare const PRESET_TABLES: Readonly<Record<MemoryRouterPreset, RoutingTable>>;
+/**
+ * The cheapest-and-safest {@link MemoryBackendId} the router can ever
+ * pick. Used by {@link SAFE_FALLBACK_DISPATCH_KEY} when an augmented
+ * lookup misses (e.g. the predicted category is not in the table or
+ * the table is malformed). Matches the existing behavior of
+ * {@link MINIMIZE_COST_TABLE} for unknown categories: degrade to the
+ * cheap path rather than the OM-premium path.
+ */
+export declare const SAFE_FALLBACK_BACKEND: MemoryBackendId;
+/**
+ * Composite dispatch key that the augmented router emits per query.
+ * Carries both the recall-backend axis (existing
+ * {@link MemoryBackendId}) and the retrieval-config axis (new
+ * {@link RetrievalConfigId}). Wider than the legacy single-axis key
+ * but the legacy key is recoverable via the `backend` field.
+ *
+ * **Backwards compatibility,** consumers using only the existing
+ * routing tables continue to dispatch on `MemoryBackendId` alone;
+ * the augmented router maps each augmented key to the same backend
+ * with `retrievalConfig: 'canonical'` implicitly when the consumer
+ * has not opted into augmented dispatch.
+ */
+export interface MemoryDispatchKey {
+    readonly backend: MemoryBackendId;
+    readonly retrievalConfig: RetrievalConfigId;
+}
+/**
+ * Default {@link MemoryDispatchKey} used when an augmented lookup
+ * misses. Matches the cheap-and-safe path: canonical-hybrid backend
+ * with the canonical retrieval config (no HyDE, default rerank,
+ * default reader top-K).
+ *
+ * Frozen at module load.
+ */
+export declare const SAFE_FALLBACK_DISPATCH_KEY: MemoryDispatchKey;
+/**
+ * The augmented preset names. v2 (2026-04-26) ships only the
+ * `minimize-cost-augmented` preset; the other two preset names are
+ * reserved for v3 calibration alongside Stage E.
+ */
+export type AugmentedMemoryRouterPreset = 'minimize-cost-augmented' | 'balanced-augmented' | 'maximize-accuracy-augmented';
+/**
+ * An augmented routing table maps every {@link MemoryQueryCategory}
+ * to a {@link MemoryDispatchKey} (backend × retrieval-config). The
+ * shape is parallel to {@link RoutingTable} but every value is a
+ * composite key rather than a backend id.
+ *
+ * Tables ship frozen so consumers cannot mutate the routing surface
+ * from outside the module.
+ */
+export interface AugmentedRoutingTable {
+    readonly preset: AugmentedMemoryRouterPreset;
+    readonly defaultMapping: Readonly<Record<MemoryQueryCategory, MemoryDispatchKey>>;
+}
+/**
+ * Preset: minimize-cost-augmented (2026-04-26 v2).
+ *
+ * Combines two calibrations into one dispatch table:
+ *
+ * - **Backend axis** from the LongMemEval-S Phase B N=500
+ *   {@link MINIMIZE_COST_TABLE}: SSP and MS pay the OM-v11 premium
+ *   (architectural lift earns it); every other category routes to
+ *   canonical-hybrid (cheapest Pareto-dominant).
+ * - **Retrieval-config axis** from the LongMemEval-M Phase A N=54
+ *   ablation matrix (per-category-oracle picks): SSA + SSU + MS use
+ *   the full combined `hyde-topk50-mult5`; KU uses `topk50` (top-K
+ *   alone is sufficient and cheaper); TR + SSP use `hyde` alone (the
+ *   wider rerank pool actively hurts these categories).
+ *
+ * The 2026-04-26 forecasted aggregate at this dispatch table on
+ * LongMemEval-M is **68.5%** (per-category-oracle empirical from the
+ * ablation matrix), vs **57.4%** static M-tuned (`hyde-topk50-mult5`
+ * everywhere) and **30.6%** baseline (`canonical` everywhere).
+ * Phase A validation at this preset is the next gate (see
+ * `2026-04-26-retrieval-config-router-productionization-plan.md`).
+ *
+ * **Calibration validity,** N=54 single-seed Phase A on M plus N=500
+ * Phase B on S. Phase B at full N=500 on M will tighten per-category
+ * confidence intervals; the table here is the directional best-guess
+ * for v2 and SHOULD be re-derived from any future Phase B run.
+ */
+export declare const MINIMIZE_COST_AUGMENTED_TABLE: AugmentedRoutingTable;
+/**
+ * Convenience registry of augmented preset tables, keyed by preset
+ * name. v2 ships only `minimize-cost-augmented`; the other two
+ * preset names will be wired in v3 alongside Stage E.
+ */
+export declare const AUGMENTED_PRESET_TABLES: Readonly<Partial<Record<AugmentedMemoryRouterPreset, AugmentedRoutingTable>>>;
+/**
+ * Pure-function selector: given a category and an
+ * {@link AugmentedRoutingTable}, return the calibrated
+ * {@link MemoryDispatchKey}. Falls back to
+ * {@link SAFE_FALLBACK_DISPATCH_KEY} when the table is missing the
+ * category (a defensive guard for custom-table misuse; the shipping
+ * presets cover every category).
+ *
+ * Stateless. Deterministic. No I/O. Suitable for use inside
+ * cache-key construction and hot dispatch loops.
+ *
+ * @param category - The classifier-predicted query category.
+ * @param table - The augmented routing table to consult.
+ * @returns A frozen {@link MemoryDispatchKey} for the category.
+ */
+export declare function selectAugmentedDispatch(category: MemoryQueryCategory, table: AugmentedRoutingTable): MemoryDispatchKey;
 //# sourceMappingURL=routing-tables.d.ts.map

package/dist/memory-router/routing-tables.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"routing-tables.d.ts","sourceRoot":"","sources":["../../src/memory-router/routing-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,sJAO1B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,0BAA0B,GAC1B,0BAA0B,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,UAAU,GACV,mBAAmB,CAAC;AAExB;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC,CAAC;CACjF;AAMD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAUhB,CAAC;AAEnB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,YAUX,CAAC;AAEnB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,EAAE,YAUpB,CAAC;AAEnB;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAKzE,CAAC"}
+{"version":3,"file":"routing-tables.d.ts","sourceRoot":"","sources":["../../src/memory-router/routing-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAEH,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAM/D;;;;;GAKG;AACH,eAAO,MAAM,uBAAuB,sJAO1B,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,mBAAmB,GAAG,CAAC,OAAO,uBAAuB,CAAC,CAAC,MAAM,CAAC,CAAC;AAE3E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,MAAM,eAAe,GACvB,kBAAkB,GAClB,0BAA0B,GAC1B,0BAA0B,CAAC;AAE/B;;;GAGG;AACH,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,UAAU,GACV,mBAAmB,CAAC;AAExB;;;;GAIG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,eAAe,CAAC,CAAC,CAAC;CACjF;AAMD;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,mBAAmB,EAAE,YAUhB,CAAC;AAEnB;;;;;;;;;;;;;;GAcG;AACH,eAAO,MAAM,cAAc,EAAE,YAUX,CAAC;AAEnB;;;;;;;;;;;;;;;GAeG;AACH,eAAO,MAAM,uBAAuB,EAAE,YAUpB,CAAC;AAEnB;;;;GAIG;AACH,eAAO,MAAM,aAAa,EAAE,QAAQ,CAAC,MAAM,CAAC,kBAAkB,EAAE,YAAY,CAAC,CAKzE,CAAC;AAML;;;;;;;GAOG;AACH,eAAO,MAAM,qBAAqB,EAAE,eAAoC,CAAC;AAEzE;;;;;;;;;;;;GAYG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,eAAe,EAAE,iBAAiB,CAAC;CAC7C;AAED;;;;;;;GAOG;AACH,eAAO,MAAM,0BAA0B,EAAE,iBAGvC,CAAC;AAEH;;;;GAIG;AACH,MAAM,MAAM,2BAA2B,GACnC,yBAAyB,GACzB,oBAAoB,GACpB,6BAA6B,CAAC;AAElC;;;;;;;;GAQG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,MAAM,EAAE,2BAA2B,CAAC;IAC7C,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,iBAAiB,CAAC,CAAC,CAAC;CACnF;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,6BAA6B,EAAE,qBA4BjB,CAAC;AAE5B;;;;GAIG;AACH,eAAO,MAAM,uBAAuB,EAAE,QAAQ,CAC5C,OAAO,CAAC,MAAM,CAAC,2BAA2B,EAAE,qBAAqB,CAAC,CAAC,CAGnE,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,mBAAmB,EAC7B,KAAK,EAAE,qBAAqB,GAC3B,iBAAiB,CAEnB"}

package/dist/memory-router/routing-tables.js

@@ -22,6 +22,13 @@
  *   temporal-reasoning back to canonical-hybrid after Phase B revealed the
  *   v1 routing's accuracy gain was within CI noise but paid OM ingest cost.
  *
+ * **Augmented routing (2026-04-26):** The {@link AugmentedRoutingTable}
+ * extends the basic dispatch contract with an orthogonal axis — a
+ * per-category {@link RetrievalConfigId} pick — so the router can
+ * dispatch on (backend × retrieval-config) rather than backend alone.
+ * The {@link MINIMIZE_COST_AUGMENTED_TABLE} preset is calibrated from
+ * the LongMemEval-M Phase A N=54 ablation matrix (2026-04-26).
+ *
  * @module @framers/agentos/memory-router/routing-tables
  */
 // ============================================================================
@@ -134,4 +141,110 @@ export const PRESET_TABLES = Object.freeze({
     'balanced': BALANCED_TABLE,
     'maximize-accuracy': MAXIMIZE_ACCURACY_TABLE,
 });
+// ============================================================================
+// Augmented routing: (backend × retrieval-config) dispatch
+// ============================================================================
+/**
+ * The cheapest-and-safest {@link MemoryBackendId} the router can ever
+ * pick. Used by {@link SAFE_FALLBACK_DISPATCH_KEY} when an augmented
+ * lookup misses (e.g. the predicted category is not in the table or
+ * the table is malformed). Matches the existing behavior of
+ * {@link MINIMIZE_COST_TABLE} for unknown categories: degrade to the
+ * cheap path rather than the OM-premium path.
+ */
+export const SAFE_FALLBACK_BACKEND = 'canonical-hybrid';
+/**
+ * Default {@link MemoryDispatchKey} used when an augmented lookup
+ * misses. Matches the cheap-and-safe path: canonical-hybrid backend
+ * with the canonical retrieval config (no HyDE, default rerank,
+ * default reader top-K).
+ *
+ * Frozen at module load.
+ */
+export const SAFE_FALLBACK_DISPATCH_KEY = Object.freeze({
+    backend: SAFE_FALLBACK_BACKEND,
+    retrievalConfig: 'canonical',
+});
+/**
+ * Preset: minimize-cost-augmented (2026-04-26 v2).
+ *
+ * Combines two calibrations into one dispatch table:
+ *
+ * - **Backend axis** from the LongMemEval-S Phase B N=500
+ *   {@link MINIMIZE_COST_TABLE}: SSP and MS pay the OM-v11 premium
+ *   (architectural lift earns it); every other category routes to
+ *   canonical-hybrid (cheapest Pareto-dominant).
+ * - **Retrieval-config axis** from the LongMemEval-M Phase A N=54
+ *   ablation matrix (per-category-oracle picks): SSA + SSU + MS use
+ *   the full combined `hyde-topk50-mult5`; KU uses `topk50` (top-K
+ *   alone is sufficient and cheaper); TR + SSP use `hyde` alone (the
+ *   wider rerank pool actively hurts these categories).
+ *
+ * The 2026-04-26 forecasted aggregate at this dispatch table on
+ * LongMemEval-M is **68.5%** (per-category-oracle empirical from the
+ * ablation matrix), vs **57.4%** static M-tuned (`hyde-topk50-mult5`
+ * everywhere) and **30.6%** baseline (`canonical` everywhere).
+ * Phase A validation at this preset is the next gate (see
+ * `2026-04-26-retrieval-config-router-productionization-plan.md`).
+ *
+ * **Calibration validity,** N=54 single-seed Phase A on M plus N=500
+ * Phase B on S. Phase B at full N=500 on M will tighten per-category
+ * confidence intervals; the table here is the directional best-guess
+ * for v2 and SHOULD be re-derived from any future Phase B run.
+ */
+export const MINIMIZE_COST_AUGMENTED_TABLE = Object.freeze({
+    preset: 'minimize-cost-augmented',
+    defaultMapping: Object.freeze({
+        'single-session-assistant': Object.freeze({
+            backend: 'canonical-hybrid',
+            retrievalConfig: 'hyde-topk50-mult5',
+        }),
+        'single-session-user': Object.freeze({
+            backend: 'canonical-hybrid',
+            retrievalConfig: 'hyde-topk50-mult5',
+        }),
+        'single-session-preference': Object.freeze({
+            backend: 'observational-memory-v11',
+            retrievalConfig: 'hyde',
+        }),
+        'knowledge-update': Object.freeze({
+            backend: 'canonical-hybrid',
+            retrievalConfig: 'topk50',
+        }),
+        'multi-session': Object.freeze({
+            backend: 'observational-memory-v11',
+            retrievalConfig: 'hyde-topk50-mult5',
+        }),
+        'temporal-reasoning': Object.freeze({
+            backend: 'canonical-hybrid',
+            retrievalConfig: 'hyde',
+        }),
+    }),
+});
+/**
+ * Convenience registry of augmented preset tables, keyed by preset
+ * name. v2 ships only `minimize-cost-augmented`; the other two
+ * preset names will be wired in v3 alongside Stage E.
+ */
+export const AUGMENTED_PRESET_TABLES = Object.freeze({
+    'minimize-cost-augmented': MINIMIZE_COST_AUGMENTED_TABLE,
+});
+/**
+ * Pure-function selector: given a category and an
+ * {@link AugmentedRoutingTable}, return the calibrated
+ * {@link MemoryDispatchKey}. Falls back to
+ * {@link SAFE_FALLBACK_DISPATCH_KEY} when the table is missing the
+ * category (a defensive guard for custom-table misuse; the shipping
+ * presets cover every category).
+ *
+ * Stateless. Deterministic. No I/O. Suitable for use inside
+ * cache-key construction and hot dispatch loops.
+ *
+ * @param category - The classifier-predicted query category.
+ * @param table - The augmented routing table to consult.
+ * @returns A frozen {@link MemoryDispatchKey} for the category.
+ */
+export function selectAugmentedDispatch(category, table) {
+    return table.defaultMapping[category] ?? SAFE_FALLBACK_DISPATCH_KEY;
+}
 //# sourceMappingURL=routing-tables.js.map

package/dist/memory-router/routing-tables.js.map

@@ -1 +1 @@
-{"version":3,"file":"routing-tables.js","sourceRoot":"","sources":["../../src/memory-router/routing-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,qBAAqB;IACrB,0BAA0B;IAC1B,2BAA2B;IAC3B,kBAAkB;IAClB,eAAe;IACf,oBAAoB;CACZ,CAAC;AA+CX,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiB,MAAM,CAAC,MAAM,CAAC;IAC7D,MAAM,EAAE,eAAwB;IAChC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,0BAA0B,EAAE,kBAAkB;QAC9C,qBAAqB,EAAE,kBAAkB;QACzC,oBAAoB,EAAE,kBAAkB;QACxC,kBAAkB,EAAE,kBAAkB;QACtC,eAAe,EAAE,0BAA0B;QAC3C,2BAA2B,EAAE,0BAA0B;KACxD,CAAC;CACH,CAAiB,CAAC;AAEnB;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAiB,MAAM,CAAC,MAAM,CAAC;IACxD,MAAM,EAAE,UAAmB;IAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,0BAA0B,EAAE,kBAAkB;QAC9C,qBAAqB,EAAE,kBAAkB;QACzC,oBAAoB,EAAE,0BAA0B;QAChD,kBAAkB,EAAE,0BAA0B;QAC9C,eAAe,EAAE,0BAA0B;QAC3C,2BAA2B,EAAE,0BAA0B;KACxD,CAAC;CACH,CAAiB,CAAC;AAEnB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAiB,MAAM,CAAC,MAAM,CAAC;IACjE,MAAM,EAAE,mBAA4B;IACpC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,0BAA0B,EAAE,kBAAkB;QAC9C,qBAAqB,EAAE,0BAA0B;QACjD,oBAAoB,EAAE,kBAAkB;QACxC,kBAAkB,EAAE,0BAA0B;QAC9C,eAAe,EAAE,0BAA0B;QAC3C,2BAA2B,EAAE,0BAA0B;KACxD,CAAC;CACH,CAAiB,CAAC;AAEnB;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GACxB,MAAM,CAAC,MAAM,CAAC;IACZ,eAAe,EAAE,mBAAmB;IACpC,UAAU,EAAE,cAAc;IAC1B,mBAAmB,EAAE,uBAAuB;CAC7C,CAAC,CAAC"}
+{"version":3,"file":"routing-tables.js","sourceRoot":"","sources":["../../src/memory-router/routing-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AAIH,+EAA+E;AAC/E,eAAe;AACf,+EAA+E;AAE/E;;;;;GAKG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,qBAAqB;IACrB,0BAA0B;IAC1B,2BAA2B;IAC3B,kBAAkB;IAClB,eAAe;IACf,oBAAoB;CACZ,CAAC;AA+CX,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAiB,MAAM,CAAC,MAAM,CAAC;IAC7D,MAAM,EAAE,eAAwB;IAChC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,0BAA0B,EAAE,kBAAkB;QAC9C,qBAAqB,EAAE,kBAAkB;QACzC,oBAAoB,EAAE,kBAAkB;QACxC,kBAAkB,EAAE,kBAAkB;QACtC,eAAe,EAAE,0BAA0B;QAC3C,2BAA2B,EAAE,0BAA0B;KACxD,CAAC;CACH,CAAiB,CAAC;AAEnB;;;;;;;;;;;;;;GAcG;AACH,MAAM,CAAC,MAAM,cAAc,GAAiB,MAAM,CAAC,MAAM,CAAC;IACxD,MAAM,EAAE,UAAmB;IAC3B,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,0BAA0B,EAAE,kBAAkB;QAC9C,qBAAqB,EAAE,kBAAkB;QACzC,oBAAoB,EAAE,0BAA0B;QAChD,kBAAkB,EAAE,0BAA0B;QAC9C,eAAe,EAAE,0BAA0B;QAC3C,2BAA2B,EAAE,0BAA0B;KACxD,CAAC;CACH,CAAiB,CAAC;AAEnB;;;;;;;;;;;;;;;GAeG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAiB,MAAM,CAAC,MAAM,CAAC;IACjE,MAAM,EAAE,mBAA4B;IACpC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,0BAA0B,EAAE,kBAAkB;QAC9C,qBAAqB,EAAE,0BAA0B;QACjD,oBAAoB,EAAE,kBAAkB;QACxC,kBAAkB,EAAE,0BAA0B;QAC9C,eAAe,EAAE,0BAA0B;QAC3C,2BAA2B,EAAE,0BAA0B;KACxD,CAAC;CACH,CAAiB,CAAC;AAEnB;;;;GAIG;AACH,MAAM,CAAC,MAAM,aAAa,GACxB,MAAM,CAAC,MAAM,CAAC;IACZ,eAAe,EAAE,mBAAmB;IACpC,UAAU,EAAE,cAAc;IAC1B,mBAAmB,EAAE,uBAAuB;CAC7C,CAAC,CAAC;AAEL,+EAA+E;AAC/E,2DAA2D;AAC3D,+EAA+E;AAE/E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,qBAAqB,GAAoB,kBAAkB,CAAC;AAoBzE;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,0BAA0B,GAAsB,MAAM,CAAC,MAAM,CAAC;IACzE,OAAO,EAAE,qBAAqB;IAC9B,eAAe,EAAE,WAAoB;CACtC,CAAC,CAAC;AA0BH;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,6BAA6B,GAA0B,MAAM,CAAC,MAAM,CAAC;IAChF,MAAM,EAAE,yBAAkC;IAC1C,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,0BAA0B,EAAE,MAAM,CAAC,MAAM,CAAC;YACxC,OAAO,EAAE,kBAA2B;YACpC,eAAe,EAAE,mBAA4B;SAC9C,CAAC;QACF,qBAAqB,EAAE,MAAM,CAAC,MAAM,CAAC;YACnC,OAAO,EAAE,kBAA2B;YACpC,eAAe,EAAE,mBAA4B;SAC9C,CAAC;QACF,2BAA2B,EAAE,MAAM,CAAC,MAAM,CAAC;YACzC,OAAO,EAAE,0BAAmC;YAC5C,eAAe,EAAE,MAAe;SACjC,CAAC;QACF,kBAAkB,EAAE,MAAM,CAAC,MAAM,CAAC;YAChC,OAAO,EAAE,kBAA2B;YACpC,eAAe,EAAE,QAAiB;SACnC,CAAC;QACF,eAAe,EAAE,MAAM,CAAC,MAAM,CAAC;YAC7B,OAAO,EAAE,0BAAmC;YAC5C,eAAe,EAAE,mBAA4B;SAC9C,CAAC;QACF,oBAAoB,EAAE,MAAM,CAAC,MAAM,CAAC;YAClC,OAAO,EAAE,kBAA2B;YACpC,eAAe,EAAE,MAAe;SACjC,CAAC;KACH,CAAC;CACH,CAA0B,CAAC;AAE5B;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAEhC,MAAM,CAAC,MAAM,CAAC;IAChB,yBAAyB,EAAE,6BAA6B;CACzD,CAAC,CAAC;AAEH;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,uBAAuB,CACrC,QAA6B,EAC7B,KAA4B;IAE5B,OAAO,KAAK,CAAC,cAAc,CAAC,QAAQ,CAAC,IAAI,0BAA0B,CAAC;AACtE,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@framers/agentos",
-  "version": "0.5.2",
+  "version": "0.5.4",
   "description": "Modular AgentOS orchestration library",
   "type": "module",
   "main": "dist/index.js",