@framers/agentos 0.6.29 → 0.7.0

package/dist/memory-router/MemoryRouter.js

@@ -1,242 +0,0 @@
-/**
- * @file MemoryRouter.ts
- * @description Top-level orchestrator that composes the LLM-as-judge
- * classifier and the pure `selectBackend` decision function into a single
- * per-query routing call.
- *
- * MemoryRouter is deliberately a THIN composition layer. It:
- *   1. Runs the classifier on the incoming query → category + token counts.
- *   2. Resolves the routing table from (preset | custom table | custom mapping).
- *   3. Calls the pure selectBackend to get the routing decision.
- *   4. Returns a {@link MemoryRouterDecision} bundling both.
- *
- * It does NOT execute the recall — backend execution is the job of
- * {@link IMemoryDispatcher}. This split keeps the router pure-enough to
- * be used in both "decide only" flows (benchmarks, dashboards, dry-runs)
- * and "decide + execute" flows (production queries).
- *
- * @module @framers/agentos/memory-router/MemoryRouter
- */
-import { DEFAULT_MEMORY_BACKEND_COSTS, } from './backend-costs.js';
-import { PRESET_TABLES, selectAugmentedDispatch, } from './routing-tables.js';
-import { selectBackend, } from './select-backend.js';
-/**
- * Thrown when `decideAndDispatch` is called on a router that was
- * constructed without a dispatcher.
- */
-export class MemoryRouterDispatcherMissingError extends Error {
-    constructor() {
-        super('MemoryRouter.decideAndDispatch requires a dispatcher. ' +
-            'Either pass a dispatcher in options, or call `decide` and dispatch yourself.');
-        this.name = 'MemoryRouterDispatcherMissingError';
-    }
-}
-/**
- * Thrown when `decideAugmented` or `decideAndDispatchAugmented` is
- * called on a router that was constructed without an
- * {@link AugmentedRoutingTable}.
- */
-export class MemoryRouterAugmentedTableMissingError extends Error {
-    constructor() {
-        super('MemoryRouter.decideAugmented requires an augmentedTable. ' +
-            'Pass one in MemoryRouterOptions (e.g. MINIMIZE_COST_AUGMENTED_TABLE), ' +
-            'or use the legacy `decide` / `decideAndDispatch` methods.');
-        this.name = 'MemoryRouterAugmentedTableMissingError';
-    }
-}
-// ============================================================================
-// Class
-// ============================================================================
-/**
- * The public MemoryRouter primitive. One instance per memory-recall
- * endpoint; construct once at app startup with the chosen preset and
- * reuse across queries.
- *
- * @example Basic min-cost routing
- * ```ts
- * import { LLMMemoryClassifier, MemoryRouter } from '../memory-router/index.js';
- *
- * const router = new MemoryRouter({
- *   classifier: new LLMMemoryClassifier({ llm: myOpenAIAdapter }),
- *   preset: 'minimize-cost',
- * });
- *
- * const decision = await router.decide("What's my current job title?");
- * console.log(decision.classifier.category); // 'knowledge-update'
- * console.log(decision.routing.chosenBackend); // 'canonical-hybrid'
- * console.log(decision.routing.estimatedCostUsd); // 0.0189
- * ```
- *
- * @example With a strict budget
- * ```ts
- * const router = new MemoryRouter({
- *   classifier: myClassifier,
- *   preset: 'maximize-accuracy',
- *   budget: { perQueryUsd: 0.025, mode: 'cheapest-fallback' },
- * });
- * ```
- */
-export class MemoryRouter {
-    constructor(options) {
-        this.classifier = options.classifier;
-        this.preset = options.preset ?? 'minimize-cost';
-        this.dispatcher = options.dispatcher ?? null;
-        this.augmentedTable = options.augmentedTable ?? null;
-        // Resolve routing table: explicit > preset's default.
-        const baseTable = options.routingTable ?? PRESET_TABLES[this.preset];
-        // Apply optional per-category mapping override.
-        if (options.mapping) {
-            const patched = {
-                ...baseTable.defaultMapping,
-            };
-            for (const key of Object.keys(options.mapping)) {
-                const override = options.mapping[key];
-                if (override)
-                    patched[key] = override;
-            }
-            this.routingTable = Object.freeze({
-                preset: baseTable.preset,
-                defaultMapping: Object.freeze(patched),
-            });
-        }
-        else {
-            this.routingTable = baseTable;
-        }
-        this.budgetPerQuery = options.budget?.perQueryUsd ?? null;
-        this.budgetMode = options.budget?.mode ?? 'cheapest-fallback';
-        this.backendCosts = options.backendCosts ?? DEFAULT_MEMORY_BACKEND_COSTS;
-        this.defaultUseFewShotPrompt = options.useFewShotPrompt ?? false;
-    }
-    /**
-     * Decide-only routing. Classifies the query, picks a backend, returns
-     * both pieces. Does NOT execute the recall — pair with an
-     * {@link IMemoryDispatcher} for the end-to-end flow, or call
-     * {@link MemoryRouter.decideAndDispatch} if a dispatcher is wired.
-     *
-     * @param query - The user's memory-recall query text.
-     * @param options - Per-call overrides (ground-truth telemetry, prompt variant).
-     * @returns A {@link MemoryRouterDecision} bundling classifier + routing results.
-     */
-    async decide(query, options) {
-        const useFewShot = options?.useFewShotPrompt ?? this.defaultUseFewShotPrompt;
-        const classifierOptions = useFewShot
-            ? { useFewShotPrompt: true }
-            : undefined;
-        const classifier = await this.classifier.classify(query, classifierOptions);
-        const routing = selectBackend({
-            predictedCategory: classifier.category,
-            groundTruthCategory: options?.groundTruthCategory ?? null,
-            config: {
-                table: this.routingTable,
-                budgetPerQuery: this.budgetPerQuery,
-                budgetMode: this.budgetMode,
-                backendCosts: this.backendCosts,
-            },
-        });
-        return { classifier, routing };
-    }
-    /**
-     * Decide + dispatch in one call. Requires the router to have been
-     * constructed with a {@link IMemoryDispatcher}.
-     *
-     * @typeParam TTrace - Caller's trace shape (passed through verbatim).
-     * @typeParam TPayload - Caller's payload shape for the dispatcher.
-     * @param query - User memory-recall query.
-     * @param dispatchPayload - Optional payload forwarded to the dispatcher's
-     *   per-backend executor (e.g. topK, retrieval policy).
-     * @param options - Per-call overrides (ground-truth telemetry, prompt variant).
-     *
-     * @throws {@link MemoryRouterDispatcherMissingError} when no dispatcher
-     *   was supplied at construction.
-     */
-    async decideAndDispatch(query, dispatchPayload, options) {
-        if (!this.dispatcher) {
-            throw new MemoryRouterDispatcherMissingError();
-        }
-        const decision = await this.decide(query, options);
-        const dispatched = (await this.dispatcher.dispatch({
-            backend: decision.routing.chosenBackend,
-            query,
-            payload: dispatchPayload,
-        }));
-        return {
-            decision,
-            traces: dispatched.traces,
-            backend: dispatched.backend,
-        };
-    }
-    /**
-     * Decide-only routing using the augmented table. Classifies the
-     * query, resolves a composite {@link MemoryDispatchKey} (backend ×
-     * retrieval-config) from the configured
-     * {@link AugmentedRoutingTable}, and returns both pieces.
-     *
-     * Does NOT execute the recall — pair with {@link IMemoryDispatcher}
-     * for the end-to-end flow, or call
-     * {@link MemoryRouter.decideAndDispatchAugmented} when both an
-     * augmented table and a dispatcher are wired.
-     *
-     * @param query - The user's memory-recall query text.
-     * @param options - Per-call overrides (ground-truth telemetry,
-     *   prompt variant). The `groundTruthCategory` field is unused on
-     *   this path because augmented routing has no `selectBackend`-style
-     *   telemetry surface; tests pass it through anyway for parity.
-     * @returns The classifier result + composite dispatch key.
-     *
-     * @throws {@link MemoryRouterAugmentedTableMissingError} when no
-     *   augmented table was supplied at construction.
-     */
-    async decideAugmented(query, options) {
-        if (!this.augmentedTable) {
-            throw new MemoryRouterAugmentedTableMissingError();
-        }
-        const useFewShot = options?.useFewShotPrompt ?? this.defaultUseFewShotPrompt;
-        const classifierOptions = useFewShot
-            ? { useFewShotPrompt: true }
-            : undefined;
-        const classifier = await this.classifier.classify(query, classifierOptions);
-        const dispatch = selectAugmentedDispatch(classifier.category, this.augmentedTable);
-        return { classifier, dispatch };
-    }
-    /**
-     * Decide + dispatch in one call, using the augmented table.
-     * Requires the router to have been constructed with both an
-     * {@link AugmentedRoutingTable} and a {@link IMemoryDispatcher}.
-     *
-     * The selected {@link RetrievalConfigId} is forwarded to the
-     * dispatcher's `retrievalConfig` arg; consumer-defined executors
-     * read it via the third-arg
-     * {@link MemoryBackendExecutorContext} parameter.
-     *
-     * @typeParam TTrace - Caller's trace shape (passed through verbatim).
-     * @typeParam TPayload - Caller's payload shape for the dispatcher.
-     * @param query - User memory-recall query.
-     * @param dispatchPayload - Optional payload forwarded to the
-     *   per-backend executor (e.g. topK, retrieval policy).
-     * @param options - Per-call overrides (ground-truth telemetry,
-     *   prompt variant).
-     *
-     * @throws {@link MemoryRouterAugmentedTableMissingError} when no
-     *   augmented table was supplied at construction.
-     * @throws {@link MemoryRouterDispatcherMissingError} when no
-     *   dispatcher was supplied at construction.
-     */
-    async decideAndDispatchAugmented(query, dispatchPayload, options) {
-        if (!this.dispatcher) {
-            throw new MemoryRouterDispatcherMissingError();
-        }
-        const decision = await this.decideAugmented(query, options);
-        const dispatched = (await this.dispatcher.dispatch({
-            backend: decision.dispatch.backend,
-            retrievalConfig: decision.dispatch.retrievalConfig,
-            query,
-            payload: dispatchPayload,
-        }));
-        return {
-            decision,
-            traces: dispatched.traces,
-            dispatch: decision.dispatch,
-        };
-    }
-}
-//# sourceMappingURL=MemoryRouter.js.map

package/dist/memory-router/MemoryRouter.js.map

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

package/dist/memory-router/adaptive.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"adaptive.d.ts","sourceRoot":"","sources":["../../src/memory-router/adaptive.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AAEH,OAAO,EAAE,YAAY,EAAE,KAAK,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AAC3E,OAAO,EAEL,KAAK,eAAe,EACpB,KAAK,mBAAmB,EAExB,KAAK,YAAY,EAClB,MAAM,qBAAqB,CAAC;AAM7B;;;GAGG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,uEAAuE;IACvE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B;AAED;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,CAAC,EAAE,MAAM,CAAC;IACnB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;CAC/B;AAED;;;GAGG;AACH,MAAM,MAAM,qBAAqB,GAAG,OAAO,CACzC,MAAM,CAAC,mBAAmB,EAAE,OAAO,CAAC,MAAM,CAAC,eAAe,EAAE,eAAe,CAAC,CAAC,CAAC,CAC/E,CAAC;AAEF;;;;;;;;;;;;;GAaG;AACH,MAAM,MAAM,kBAAkB,GAC1B,eAAe,GACf,UAAU,GACV,mBAAmB,CAAC;AAExB,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,GAAG,EAAE,qBAAqB,CAAC;IACpC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAED,MAAM,WAAW,6BAA6B;IAC5C,QAAQ,CAAC,OAAO,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC/C,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC;;;OAGG;IACH,QAAQ,CAAC,aAAa,CAAC,EAAE,YAAY,CAAC;CACvC;AAED,MAAM,WAAW,2BACf,SAAQ,IAAI,CAAC,mBAAmB,EAAE,cAAc,GAAG,QAAQ,CAAC;IAC5D,QAAQ,CAAC,kBAAkB,EAAE,SAAS,iBAAiB,EAAE,CAAC;IAC1D,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,iBAAiB,CAAC,EAAE,MAAM,CAAC;CACrC;AAMD;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,OAAO,EAAE,SAAS,iBAAiB,EAAE,GACpC,qBAAqB,CA4BvB;AAMD;;;;GAIG;AACH,wBAAgB,cAAc,CAAC,IAAI,EAAE,kBAAkB,GAAG,eAAe,CA8DxE;AAeD;;;;GAIG;AACH,wBAAgB,yBAAyB,CACvC,IAAI,EAAE,6BAA6B,GAClC,YAAY,CAqCd;AAMD;;;;GAIG;AACH,qBAAa,oBAAqB,SAAQ,YAAY;IACpD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAe;gBAEhC,OAAO,EAAE,2BAA2B;IAiBhD;;OAEG;IACH,eAAe,IAAI,YAAY;CAGhC"}

package/dist/memory-router/adaptive.js.map

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

package/dist/memory-router/backend-costs.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"backend-costs.d.ts","sourceRoot":"","sources":["../../src/memory-router/backend-costs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAEhF;;;GAGG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,OAAO,EAAE,eAAe,CAAC;IAClC,uEAAuE;IACvE,QAAQ,CAAC,eAAe,EAAE,MAAM,CAAC;IACjC,6DAA6D;IAC7D,QAAQ,CAAC,mBAAmB,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;IAC5E,kEAAkE;IAClE,QAAQ,CAAC,uBAAuB,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;IAChF,0EAA0E;IAC1E,QAAQ,CAAC,oBAAoB,EAAE,QAAQ,CAAC,MAAM,CAAC,mBAAmB,EAAE,MAAM,CAAC,CAAC,CAAC;CAC9E;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,EAAE,sBA2BT,CAAC;AAE7B;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,sBA2BJ,CAAC;AAE7B;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,EAAE,sBA2BJ,CAAC;AAE7B;;;;;;;;;GASG;AACH,eAAO,MAAM,4BAA4B,EAAE,QAAQ,CACjD,MAAM,CAAC,eAAe,EAAE,sBAAsB,CAAC,CAK/C,CAAC"}

package/dist/memory-router/backend-costs.js.map

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

package/dist/memory-router/backends/EntityRetrievalRanker.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"EntityRetrievalRanker.d.ts","sourceRoot":"","sources":["../../../src/memory-router/backends/EntityRetrievalRanker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAIH;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,aAAa,EAAE,MAAM,CAAC;IACtB,iEAAiE;IACjE,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAED;;;GAGG;AACH,MAAM,WAAW,wBAAyB,SAAQ,eAAe;IAC/D,aAAa,EAAE,MAAM,CAAC;IACtB,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,MAAM,WAAW,4BAA4B;IAC3C;;;OAGG;IACH,YAAY,EAAE,MAAM,CAAC;CACtB;AAED,qBAAa,qBAAqB;IAChC,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAS;IACtC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAyB;gBAEvC,IAAI,EAAE,4BAA4B;IAI9C,IAAI,CAAC,KAAK,EAAE,MAAM,EAAE,UAAU,EAAE,eAAe,EAAE,GAAG,wBAAwB,EAAE;CAc/E"}

package/dist/memory-router/backends/EntityRetrievalRanker.js

@@ -1,39 +0,0 @@
-/**
- * @file EntityRetrievalRanker.ts
- * @description Mem0-v3-style recall-stage re-ranker. Adds an
- * entity-overlap signal to the existing semantic-similarity score:
- *
- *   combinedScore = (1 - entityWeight) * semanticScore
- *                 + entityWeight * (overlap / queryEntityCount)
- *
- * Returns candidates sorted descending by combinedScore. The original
- * fields (id, text, semanticScore, entities) are preserved alongside
- * the new combinedScore + entityOverlap.
- *
- * The query's entities are extracted via {@link EntityExtractor} so
- * this ranker is end-to-end self-contained: pass a query string and
- * candidate list, get a re-ranked list back.
- *
- * Reference: docs.mem0.ai/migration/oss-v2-to-v3.
- *
- * @module @framers/agentos/memory-router/backends/EntityRetrievalRanker
- */
-import { EntityExtractor } from '../../ingest-router/executors/EntityExtractor.js';
-export class EntityRetrievalRanker {
-    constructor(opts) {
-        this.extractor = new EntityExtractor();
-        this.entityWeight = opts.entityWeight;
-    }
-    rank(query, candidates) {
-        const queryEntities = new Set(this.extractor.extract(query).entities.map((e) => e.text));
-        const queryEntityCount = queryEntities.size;
-        const scored = candidates.map((c) => {
-            const overlap = c.entities.filter((e) => queryEntities.has(e)).length;
-            const overlapRatio = queryEntityCount > 0 ? overlap / queryEntityCount : 0;
-            const combinedScore = (1 - this.entityWeight) * c.semanticScore + this.entityWeight * overlapRatio;
-            return { ...c, combinedScore, entityOverlap: overlap };
-        });
-        return scored.sort((a, b) => b.combinedScore - a.combinedScore);
-    }
-}
-//# sourceMappingURL=EntityRetrievalRanker.js.map

package/dist/memory-router/backends/EntityRetrievalRanker.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"EntityRetrievalRanker.js","sourceRoot":"","sources":["../../../src/memory-router/backends/EntityRetrievalRanker.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AAEH,OAAO,EAAE,eAAe,EAAE,MAAM,kDAAkD,CAAC;AAgCnF,MAAM,OAAO,qBAAqB;IAIhC,YAAY,IAAkC;QAF7B,cAAS,GAAG,IAAI,eAAe,EAAE,CAAC;QAGjD,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC,YAAY,CAAC;IACxC,CAAC;IAED,IAAI,CAAC,KAAa,EAAE,UAA6B;QAC/C,MAAM,aAAa,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC;QACzF,MAAM,gBAAgB,GAAG,aAAa,CAAC,IAAI,CAAC;QAE5C,MAAM,MAAM,GAAG,UAAU,CAAC,GAAG,CAA2B,CAAC,CAAC,EAAE,EAAE;YAC5D,MAAM,OAAO,GAAG,CAAC,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;YACtE,MAAM,YAAY,GAAG,gBAAgB,GAAG,CAAC,CAAC,CAAC,CAAC,OAAO,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;YAC3E,MAAM,aAAa,GACjB,CAAC,CAAC,GAAG,IAAI,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,aAAa,GAAG,IAAI,CAAC,YAAY,GAAG,YAAY,CAAC;YAC/E,OAAO,EAAE,GAAG,CAAC,EAAE,aAAa,EAAE,aAAa,EAAE,OAAO,EAAE,CAAC;QACzD,CAAC,CAAC,CAAC;QAEH,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,aAAa,GAAG,CAAC,CAAC,aAAa,CAAC,CAAC;IAClE,CAAC;CACF"}

package/dist/memory-router/backends/index.d.ts

@@ -1,16 +0,0 @@
-/**
- * @file backends/index.ts
- * @description Sub-barrel for MemoryRouter recall-side backends. The
- * top-level `@framers/agentos/memory-router` barrel re-exports these
- * symbols so consumers can write
- * `import { EntityRetrievalRanker } from '../../memory-router'`.
- *
- * Reference recall-stage components ship in agentos core so the
- * memory-router strategy IDs work out of the box.
- */
-export { EntityRetrievalRanker } from './EntityRetrievalRanker.js';
-export type { RankedCandidate, RankedCandidateWithBoost, EntityRetrievalRankerOptions, } from './EntityRetrievalRanker.js';
-import { EntityRetrievalRanker } from './EntityRetrievalRanker.js';
-import type { EntityRetrievalRankerOptions } from './EntityRetrievalRanker.js';
-export declare function createEntityRetrievalRanker(opts: EntityRetrievalRankerOptions): EntityRetrievalRanker;
-//# sourceMappingURL=index.d.ts.map

package/dist/memory-router/backends/index.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/memory-router/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,YAAY,EACV,eAAe,EACf,wBAAwB,EACxB,4BAA4B,GAC7B,MAAM,4BAA4B,CAAC;AAEpC,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AACnE,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,4BAA4B,CAAC;AAE/E,wBAAgB,2BAA2B,CACzC,IAAI,EAAE,4BAA4B,GACjC,qBAAqB,CAEvB"}

package/dist/memory-router/backends/index.js

@@ -1,16 +0,0 @@
-/**
- * @file backends/index.ts
- * @description Sub-barrel for MemoryRouter recall-side backends. The
- * top-level `@framers/agentos/memory-router` barrel re-exports these
- * symbols so consumers can write
- * `import { EntityRetrievalRanker } from '../../memory-router'`.
- *
- * Reference recall-stage components ship in agentos core so the
- * memory-router strategy IDs work out of the box.
- */
-export { EntityRetrievalRanker } from './EntityRetrievalRanker.js';
-import { EntityRetrievalRanker } from './EntityRetrievalRanker.js';
-export function createEntityRetrievalRanker(opts) {
-    return new EntityRetrievalRanker(opts);
-}
-//# sourceMappingURL=index.js.map

package/dist/memory-router/backends/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/memory-router/backends/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAOnE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4BAA4B,CAAC;AAGnE,MAAM,UAAU,2BAA2B,CACzC,IAAkC;IAElC,OAAO,IAAI,qBAAqB,CAAC,IAAI,CAAC,CAAC;AACzC,CAAC"}

package/dist/memory-router/classifier.d.ts

@@ -1,169 +0,0 @@
-/**
- * @file classifier.ts
- * @description The LLM-as-judge classifier that the {@link MemoryRouter}
- * uses to pick a {@link MemoryQueryCategory} for each incoming query.
- *
- * The classifier is deliberately abstracted behind {@link IMemoryClassifier}
- * so callers can swap:
- *   - the LLM client (any provider — OpenAI, Anthropic, local, mock) via
- *     the {@link IMemoryClassifierLLM} adapter interface,
- *   - the prompt variant (base vs few-shot) per-call,
- *   - the classifier implementation entirely (e.g. a keyword-matcher or a
- *     small custom ML model) by implementing {@link IMemoryClassifier}.
- *
- * The reference implementation, {@link LLMMemoryClassifier}, runs the
- * gpt-5-mini-style cheap single-shot discriminator prompt and robustly
- * parses the output, falling back to `multi-session` on unparseable
- * responses (the safest default — multi-session routes cover cross-session
- * synthesis which handles most misidentified question types gracefully).
- *
- * @module @framers/agentos/memory-router/classifier
- */
-import { type MemoryQueryCategory } from './routing-tables.js';
-/**
- * Minimal LLM-call interface the built-in classifier needs. Agentos
- * consumers wire their preferred provider to this shape via an adapter
- * — we intentionally do NOT import any provider SDK here so the
- * memory-router module stays provider-agnostic.
- */
-export interface MemoryClassifierLLMRequest {
-    /** System prompt. The classifier supplies this based on prompt variant. */
-    readonly system: string;
-    /** User prompt. The classifier renders `Question: {q}\n\nCategory:`. */
-    readonly user: string;
-    /** Max tokens to generate. Classifier passes ≤16 (bare category token). */
-    readonly maxTokens: number;
-    /** Temperature. Classifier passes 0 for determinism. */
-    readonly temperature: number;
-}
-/**
- * Response shape the built-in classifier expects from the adapter.
- */
-export interface MemoryClassifierLLMResponse {
-    /** The model's raw text. Whitespace is tolerated; the parser normalizes it. */
-    readonly text: string;
-    /** Input token count, for cost tracking. */
-    readonly tokensIn: number;
-    /** Output token count, for cost tracking. */
-    readonly tokensOut: number;
-    /** Model identifier the LLM reports. */
-    readonly model: string;
-}
-/**
- * The LLM-client adapter the built-in classifier expects. Adapt any
- * provider SDK (OpenAI, Anthropic, a provider-router, a mock) to this
- * shape before passing into {@link LLMMemoryClassifier}.
- */
-export interface IMemoryClassifierLLM {
-    invoke(request: MemoryClassifierLLMRequest): Promise<MemoryClassifierLLMResponse>;
-}
-/**
- * Options passed per-call to {@link IMemoryClassifier.classify}. The
- * classifier reads these to pick a prompt variant; everything else is
- * constructor-scoped.
- */
-export interface MemoryClassifierClassifyOptions {
-    /**
-     * Use the few-shot prompt variant instead of the base prompt. The
-     * few-shot prompt includes explicit Question/Category pairs targeting
-     * known confusion patterns (SSU-vs-SSA, SSP-vs-SSA, MS-vs-KU). Default
-     * false — the base prompt is ~2.5x cheaper per-classification-token and
-     * matches the shipping Tier 3 v10 classifier configuration.
-     */
-    readonly useFewShotPrompt?: boolean;
-}
-/**
- * Result of a classification call. The returned category is always a
- * valid {@link MemoryQueryCategory}; parse failures map to the safe
- * fallback 'multi-session'.
- */
-export interface MemoryClassifierResult {
-    readonly category: MemoryQueryCategory;
-    readonly tokensIn: number;
-    readonly tokensOut: number;
-    readonly model: string;
-}
-/**
- * The public classifier contract. Implementations decide how to turn a
- * query into a category — via LLM, keyword heuristic, small ML model, or
- * mock.
- */
-export interface IMemoryClassifier {
-    classify(query: string, options?: MemoryClassifierClassifyOptions): Promise<MemoryClassifierResult>;
-}
-/**
- * Base classifier prompt. Lists the six category tokens with one-sentence
- * definitions and a few examples per category, then instructs the model
- * to emit ONLY the bare category token.
- */
-export declare const CLASSIFIER_SYSTEM_PROMPT = "You are classifying a memory-system question into one of six categories.\n\nReturn ONLY the category token (no explanation, no quotes, no punctuation).\n\nCategories:\n- single-session-user: the question asks about something the USER said, did, or stated in a specific past session. Answer is in one session. Examples: \"What did I tell you about my favorite dessert?\", \"Where did I say I moved to last month?\"\n- single-session-assistant: the question asks about something the ASSISTANT said, generated, or recommended in a specific session. Answer is in one session. Examples: \"What recipe did you suggest for the birthday party?\", \"What books did you recommend to me?\"\n- single-session-preference: the question asks about a preference the user stated in passing. Answer is in one session. Examples: \"Do I prefer tea or coffee?\", \"What's my favorite type of movie?\"\n- knowledge-update: the question asks about current state where the answer EVOLVED across sessions (supersession). Examples: \"What's my current job title?\", \"Where do I live now?\", \"What's my latest project?\"\n- multi-session: the question requires combining information from 2+ separate sessions. Examples: \"How many different languages have I mentioned studying?\", \"Which authors did you recommend across our conversations?\"\n- temporal-reasoning: the question asks about the order, timing, or duration of events across time. Examples: \"In what order did I visit the three countries?\", \"How many months ago did I start the new job?\"";
-/**
- * Few-shot variant of the classifier prompt. Adds explicit
- * Question/Category pairs targeting confusion patterns observed in the
- * gpt-5-mini base-prompt classifier on LongMemEval Tier A:
- *   - SSA confused as SSU (YOU-said vs I-said distinction)
- *   - SSP confused as SSA (preferences phrased like recommendations)
- *   - MS confused as KU (cross-session vs current-state)
- *
- * Used when {@link MemoryClassifierClassifyOptions.useFewShotPrompt} is true.
- */
-export declare const CLASSIFIER_SYSTEM_PROMPT_FEWSHOT = "You are classifying a memory-system question into one of six categories.\n\nReturn ONLY the category token (no explanation, no quotes, no punctuation).\n\nCategories:\n- single-session-user: the question asks about something the USER said, did, or stated in a specific past session. Answer is in one session.\n- single-session-assistant: the question asks about something the ASSISTANT said, generated, or recommended in a specific session. Answer is in one session.\n- single-session-preference: the question asks about a preference the user stated in passing. Answer is in one session.\n- knowledge-update: the question asks about current state where the answer EVOLVED across sessions (supersession). The user wants the LATEST value of an attribute that has changed over time.\n- multi-session: the question requires combining information from 2+ separate sessions. Counting, listing, or aggregating items the user mentioned across sessions.\n- temporal-reasoning: the question asks about the order, timing, or duration of events across time.\n\nExamples:\n\nQuestion: What did I tell you my favorite ice cream flavor was?\nCategory: single-session-user\n\nQuestion: Where did I say I moved to last month?\nCategory: single-session-user\n\nQuestion: What book did you recommend to me last week?\nCategory: single-session-assistant\n\nQuestion: What recipe did you suggest for the birthday party?\nCategory: single-session-assistant\n\nQuestion: Do I prefer working in the morning or evening?\nCategory: single-session-preference\n\nQuestion: What's my favorite type of movie?\nCategory: single-session-preference\n\nQuestion: What's my current job title?\nCategory: knowledge-update\n\nQuestion: Where do I live now?\nCategory: knowledge-update\n\nQuestion: How many different programming languages have I mentioned learning?\nCategory: multi-session\n\nQuestion: Which authors have you recommended to me across our conversations?\nCategory: multi-session\n\nQuestion: In what order did I visit the three European cities?\nCategory: temporal-reasoning\n\nQuestion: How many weeks ago did I start the new job?\nCategory: temporal-reasoning";
-/**
- * Default fallback category used when the classifier's LLM output cannot
- * be parsed into a known category token. multi-session is chosen because
- * its routing target (OM-based cross-session synthesis under max-accuracy,
- * canonical-hybrid under min-cost) degrades gracefully on most other
- * question types.
- */
-export declare const SAFE_FALLBACK_CATEGORY: MemoryQueryCategory;
-/**
- * Strips common LLM-output decorations so the parser can match the bare
- * category token:
- *   - keeps only the first non-empty line,
- *   - strips common label prefixes ("category:", "type:", "answer:"),
- *   - strips surrounding quotes / backticks,
- *   - strips trailing sentence punctuation,
- *   - lower-cases the result.
- */
-export declare function normalizeClassifierOutput(raw: string): string;
-/**
- * Parse a normalized classifier output into a known category token, or
- * return the safe fallback if no match is found.
- */
-export declare function parseClassifierOutput(raw: string): MemoryQueryCategory;
-/**
- * Constructor options for {@link LLMMemoryClassifier}.
- */
-export interface LLMMemoryClassifierOptions {
-    /** LLM adapter the classifier calls. */
-    readonly llm: IMemoryClassifierLLM;
-    /**
-     * Max output tokens. Default 16 — the classifier only needs to emit
-     * one bare category token. Callers rarely need to change this.
-     */
-    readonly maxTokens?: number;
-}
-/**
- * The built-in LLM-based classifier. Runs the category-discrimination
- * prompt on the configured LLM adapter and parses the response robustly.
- *
- * @example
- * ```ts
- * import { LLMMemoryClassifier } from '../memory-router';
- *
- * const classifier = new LLMMemoryClassifier({
- *   llm: createOpenAIClassifierAdapter('gpt-5-mini'),
- * });
- * const { category } = await classifier.classify(
- *   "What's my current job title?",
- * );
- * // => { category: 'knowledge-update', tokensIn: 412, tokensOut: 4, model: 'gpt-5-mini-2025-08-07' }
- * ```
- */
-export declare class LLMMemoryClassifier implements IMemoryClassifier {
-    private readonly llm;
-    private readonly maxTokens;
-    constructor(options: LLMMemoryClassifierOptions);
-    classify(query: string, options?: MemoryClassifierClassifyOptions): Promise<MemoryClassifierResult>;
-}
-//# sourceMappingURL=classifier.d.ts.map

package/dist/memory-router/classifier.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/memory-router/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;GAoBG;AAEH,OAAO,EAEL,KAAK,mBAAmB,EACzB,MAAM,qBAAqB,CAAC;AAM7B;;;;;GAKG;AACH,MAAM,WAAW,0BAA0B;IACzC,2EAA2E;IAC3E,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,wEAAwE;IACxE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,2EAA2E;IAC3E,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wDAAwD;IACxD,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED;;GAEG;AACH,MAAM,WAAW,2BAA2B;IAC1C,+EAA+E;IAC/E,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4CAA4C;IAC5C,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,6CAA6C;IAC7C,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,wCAAwC;IACxC,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,oBAAoB;IACnC,MAAM,CACJ,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzC;AAMD;;;;GAIG;AACH,MAAM,WAAW,+BAA+B;IAC9C;;;;;;OAMG;IACH,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED;;;;GAIG;AACH,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,QAAQ,EAAE,mBAAmB,CAAC;IACvC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED;;;;GAIG;AACH,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CACN,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,+BAA+B,GACxC,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpC;AAMD;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,8/CAU0K,CAAC;AAEhN;;;;;;;;;GASG;AACH,eAAO,MAAM,gCAAgC,kmEAgDhB,CAAC;AAM9B;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,mBAAqC,CAAC;AAE3E;;;;;;;;GAQG;AACH,wBAAgB,yBAAyB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAe7D;AAED;;;GAGG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,MAAM,GAAG,mBAAmB,CAYtE;AAMD;;GAEG;AACH,MAAM,WAAW,0BAA0B;IACzC,wCAAwC;IACxC,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAC;IACnC;;;OAGG;IACH,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;;;;;;;;;;GAgBG;AACH,qBAAa,mBAAoB,YAAW,iBAAiB;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;gBAEvB,OAAO,EAAE,0BAA0B;IAKzC,QAAQ,CACZ,KAAK,EAAE,MAAM,EACb,OAAO,CAAC,EAAE,+BAA+B,GACxC,OAAO,CAAC,sBAAsB,CAAC;CAoBnC"}