@framers/agentos 0.6.30 → 0.7.1

package/dist/orchestration/pipeline/ingest/executors/SummarizedIngestExecutor.d.ts

@@ -0,0 +1,68 @@
+/**
+ * @file SummarizedIngestExecutor.ts
+ * @description Anthropic Contextual Retrieval reference executor for
+ * the IngestRouter `summarized` strategy.
+ *
+ * Wraps the existing {@link SessionSummarizer} (in
+ * `@framers/agentos/memory`) which carries the conversation-tuned
+ * summarization prompt + persistent disk cache + cost-tracking. This
+ * executor is the IngestRouter-shaped facade over that primitive, so
+ * the production SessionSummarizer is the single source of truth for
+ * session-level summarization across both the bench and the
+ * IngestRouter dispatcher path.
+ *
+ * Cost model: ~$0.003 per session at gpt-5-mini. SessionSummarizer's
+ * SHA-256 disk cache means re-runs against the same sessions are $0.
+ *
+ * @module @framers/agentos/ingest-router/executors/SummarizedIngestExecutor
+ */
+import { SessionSummarizer } from '../../../../cognition/memory/ingest/SessionSummarizer.js';
+/**
+ * Outcome shape returned by {@link SummarizedIngestExecutor.ingest}.
+ * Mirrors the shape of every other executor's outcome so the dispatch
+ * type stays uniform across strategies.
+ */
+export interface IngestOutcome {
+    writtenTraces: number;
+    summary: string;
+    embedTexts: string[];
+    tokensIn: number;
+    tokensOut: number;
+}
+/**
+ * Per-call payload. The executor needs the sessionId for SessionSummarizer
+ * cache lookups (also used for stable identification in logging) and
+ * the optional chunks list for splitting content.
+ */
+export interface IngestPayload {
+    sessionId: string;
+    chunks?: string[];
+}
+/**
+ * Reference executor for the IngestRouter `summarized` strategy. Wires
+ * the existing SessionSummarizer through the IngestRouter dispatcher
+ * pattern so consumers using IngestRouter get Anthropic Contextual
+ * Retrieval out of the box.
+ */
+export declare class SummarizedIngestExecutor {
+    /** Strategy ID expected by IngestRouter's FunctionIngestDispatcher registry. */
+    readonly strategyId: "summarized";
+    private readonly summarizer;
+    constructor(opts: {
+        summarizer: SessionSummarizer;
+    });
+    /**
+     * Ingest a session's content. Delegates to the wrapped
+     * SessionSummarizer for the LLM call (which handles caching, cost
+     * tracking, and prompt management). Returns the summary prepended
+     * to every chunk, ready for embedding.
+     *
+     * Per-call tokensIn/tokensOut are reported as 0 because the
+     * SessionSummarizer's disk cache obscures whether a particular
+     * `summarize()` call hit the cache or fired the LLM. Callers that
+     * need precise per-call cost should inspect
+     * {@link SessionSummarizer.stats} directly.
+     */
+    ingest(content: string, payload: IngestPayload): Promise<IngestOutcome>;
+}
+//# sourceMappingURL=SummarizedIngestExecutor.d.ts.map

package/dist/orchestration/pipeline/ingest/executors/SummarizedIngestExecutor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SummarizedIngestExecutor.d.ts","sourceRoot":"","sources":["../../../../../src/orchestration/pipeline/ingest/executors/SummarizedIngestExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AAEH,OAAO,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAC;AAE7F;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,MAAM,CAAC;IAChB,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC5B,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;CACnB;AAED;;;;;GAKG;AACH,qBAAa,wBAAwB;IACnC,gFAAgF;IAChF,QAAQ,CAAC,UAAU,EAAG,YAAY,CAAU;IAE5C,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAoB;gBAEnC,IAAI,EAAE;QAAE,UAAU,EAAE,iBAAiB,CAAA;KAAE;IAInD;;;;;;;;;;;OAWG;IACG,MAAM,CAAC,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,aAAa,GAAG,OAAO,CAAC,aAAa,CAAC;CAa9E"}

package/dist/orchestration/pipeline/ingest/executors/SummarizedIngestExecutor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"SummarizedIngestExecutor.js","sourceRoot":"","sources":["../../../../../src/orchestration/pipeline/ingest/executors/SummarizedIngestExecutor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;GAiBG;AA2BH;;;;;GAKG;AACH,MAAM,OAAO,wBAAwB;IAMnC,YAAY,IAAuC;QALnD,gFAAgF;QACvE,eAAU,GAAG,YAAqB,CAAC;QAK1C,IAAI,CAAC,UAAU,GAAG,IAAI,CAAC,UAAU,CAAC;IACpC,CAAC;IAED;;;;;;;;;;;OAWG;IACH,KAAK,CAAC,MAAM,CAAC,OAAe,EAAE,OAAsB;QAClD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,UAAU,CAAC,SAAS,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAC,CAAC;QAC5E,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC,OAAO,CAAC,CAAC;QAC3C,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,GAAG,OAAO,OAAO,KAAK,EAAE,CAAC,CAAC;QAEnE,OAAO;YACL,aAAa,EAAE,MAAM,CAAC,MAAM;YAC5B,OAAO;YACP,UAAU;YACV,QAAQ,EAAE,CAAC;YACX,SAAS,EAAE,CAAC;SACb,CAAC;IACJ,CAAC;CACF"}

package/dist/orchestration/pipeline/ingest/executors/entity-types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-types.d.ts","sourceRoot":"","sources":["../../../../../src/orchestration/pipeline/ingest/executors/entity-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,aAAa,GAAG,aAAa,GAAG,sBAAsB,CAAC;AAEhF;;GAEG;AACH,MAAM,WAAW,eAAe;IAC9B,kEAAkE;IAClE,IAAI,EAAE,MAAM,CAAC;IACb,uDAAuD;IACvD,IAAI,EAAE,UAAU,CAAC;IACjB,qEAAqE;IACrE,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,8CAA8C;IAC9C,QAAQ,EAAE,eAAe,EAAE,CAAC;IAC5B,8CAA8C;IAC9C,OAAO,EAAE,MAAM,CAAC;CACjB;AAED;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC;;;OAGG;IACH,mBAAmB,CAAC,EAAE,MAAM,CAAC;IAC7B;;;OAGG;IACH,qBAAqB,CAAC,EAAE,MAAM,CAAC;CAChC"}

package/dist/orchestration/pipeline/ingest/executors/entity-types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entity-types.js","sourceRoot":"","sources":["../../../../../src/orchestration/pipeline/ingest/executors/entity-types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG"}

package/dist/orchestration/pipeline/ingest/executors/index.d.ts

@@ -0,0 +1,37 @@
+/**
+ * @file executors/index.ts
+ * @description Sub-barrel for IngestRouter reference executors. The
+ * top-level `@framers/agentos/ingest-router` barrel re-exports these
+ * symbols so consumers can write
+ * `import { SummarizedIngestExecutor } from '@framers/agentos/ingest-router'`.
+ *
+ * Reference executors ship in agentos core (not in extension packages)
+ * so the IngestRouter strategy IDs (`summarized`, `raw-chunks`, `skip`)
+ * work out of the box rather than being empty promises.
+ *
+ * The summarized executor wraps the existing
+ * {@link SessionSummarizer} from `@framers/agentos/memory` so the
+ * production summarization primitive is the single source of truth.
+ */
+export { SummarizedIngestExecutor } from './SummarizedIngestExecutor.js';
+export type { IngestOutcome, IngestPayload } from './SummarizedIngestExecutor.js';
+export { RawChunksIngestExecutor } from './RawChunksIngestExecutor.js';
+export type { RawChunksOutcome } from './RawChunksIngestExecutor.js';
+export { SkipIngestExecutor } from './SkipIngestExecutor.js';
+export { EntityExtractor } from './EntityExtractor.js';
+export { EntityLinkingIngestExecutor } from './EntityLinkingIngestExecutor.js';
+export type { EntityLinkingOutcome } from './EntityLinkingIngestExecutor.js';
+export type { EntityKind, ExtractedEntity, EntityExtractionResult, EntityLinkingOptions, } from './entity-types.js';
+import { SummarizedIngestExecutor } from './SummarizedIngestExecutor.js';
+import { RawChunksIngestExecutor } from './RawChunksIngestExecutor.js';
+import { SkipIngestExecutor } from './SkipIngestExecutor.js';
+import { EntityLinkingIngestExecutor } from './EntityLinkingIngestExecutor.js';
+import type { SessionSummarizer } from '../../../../cognition/memory/ingest/SessionSummarizer.js';
+import type { EntityLinkingOptions } from './entity-types.js';
+export declare function createSummarizedIngestExecutor(opts: {
+    summarizer: SessionSummarizer;
+}): SummarizedIngestExecutor;
+export declare function createRawChunksIngestExecutor(): RawChunksIngestExecutor;
+export declare function createSkipIngestExecutor(): SkipIngestExecutor;
+export declare function createEntityLinkingIngestExecutor(opts?: EntityLinkingOptions): EntityLinkingIngestExecutor;
+//# sourceMappingURL=index.d.ts.map

package/dist/orchestration/pipeline/ingest/executors/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/orchestration/pipeline/ingest/executors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,YAAY,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,+BAA+B,CAAC;AAClF,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,YAAY,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,YAAY,EAAE,oBAAoB,EAAE,MAAM,kCAAkC,CAAC;AAC7E,YAAY,EACV,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAC/E,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAC;AAClG,OAAO,KAAK,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AAE9D,wBAAgB,8BAA8B,CAAC,IAAI,EAAE;IACnD,UAAU,EAAE,iBAAiB,CAAC;CAC/B,GAAG,wBAAwB,CAE3B;AAED,wBAAgB,6BAA6B,IAAI,uBAAuB,CAEvE;AAED,wBAAgB,wBAAwB,IAAI,kBAAkB,CAE7D;AAED,wBAAgB,iCAAiC,CAC/C,IAAI,GAAE,oBAAyB,GAC9B,2BAA2B,CAE7B"}

package/dist/orchestration/pipeline/ingest/executors/index.js

@@ -0,0 +1,37 @@
+/**
+ * @file executors/index.ts
+ * @description Sub-barrel for IngestRouter reference executors. The
+ * top-level `@framers/agentos/ingest-router` barrel re-exports these
+ * symbols so consumers can write
+ * `import { SummarizedIngestExecutor } from '@framers/agentos/ingest-router'`.
+ *
+ * Reference executors ship in agentos core (not in extension packages)
+ * so the IngestRouter strategy IDs (`summarized`, `raw-chunks`, `skip`)
+ * work out of the box rather than being empty promises.
+ *
+ * The summarized executor wraps the existing
+ * {@link SessionSummarizer} from `@framers/agentos/memory` so the
+ * production summarization primitive is the single source of truth.
+ */
+export { SummarizedIngestExecutor } from './SummarizedIngestExecutor.js';
+export { RawChunksIngestExecutor } from './RawChunksIngestExecutor.js';
+export { SkipIngestExecutor } from './SkipIngestExecutor.js';
+export { EntityExtractor } from './EntityExtractor.js';
+export { EntityLinkingIngestExecutor } from './EntityLinkingIngestExecutor.js';
+import { SummarizedIngestExecutor } from './SummarizedIngestExecutor.js';
+import { RawChunksIngestExecutor } from './RawChunksIngestExecutor.js';
+import { SkipIngestExecutor } from './SkipIngestExecutor.js';
+import { EntityLinkingIngestExecutor } from './EntityLinkingIngestExecutor.js';
+export function createSummarizedIngestExecutor(opts) {
+    return new SummarizedIngestExecutor(opts);
+}
+export function createRawChunksIngestExecutor() {
+    return new RawChunksIngestExecutor();
+}
+export function createSkipIngestExecutor() {
+    return new SkipIngestExecutor();
+}
+export function createEntityLinkingIngestExecutor(opts = {}) {
+    return new EntityLinkingIngestExecutor(opts);
+}
+//# sourceMappingURL=index.js.map

package/dist/orchestration/pipeline/ingest/executors/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../../src/orchestration/pipeline/ingest/executors/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAEH,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AAEzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AAEvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AACvD,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAS/E,OAAO,EAAE,wBAAwB,EAAE,MAAM,+BAA+B,CAAC;AACzE,OAAO,EAAE,uBAAuB,EAAE,MAAM,8BAA8B,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,2BAA2B,EAAE,MAAM,kCAAkC,CAAC;AAI/E,MAAM,UAAU,8BAA8B,CAAC,IAE9C;IACC,OAAO,IAAI,wBAAwB,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC;AAED,MAAM,UAAU,6BAA6B;IAC3C,OAAO,IAAI,uBAAuB,EAAE,CAAC;AACvC,CAAC;AAED,MAAM,UAAU,wBAAwB;IACtC,OAAO,IAAI,kBAAkB,EAAE,CAAC;AAClC,CAAC;AAED,MAAM,UAAU,iCAAiC,CAC/C,OAA6B,EAAE;IAE/B,OAAO,IAAI,2BAA2B,CAAC,IAAI,CAAC,CAAC;AAC/C,CAAC"}

package/dist/orchestration/pipeline/ingest/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/orchestration/pipeline/ingest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,YAAY,EACV,iBAAiB,EACjB,gBAAgB,EAChB,kBAAkB,EAClB,kBAAkB,GACnB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAE3D,YAAY,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAE1D,YAAY,EACV,gBAAgB,EAChB,kBAAkB,EAClB,qBAAqB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,0BAA0B,EAC1B,2BAA2B,EAC3B,+BAA+B,EAC/B,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,iBAAiB,EACjB,kBAAkB,EAClB,oBAAoB,EACpB,sBAAsB,EACtB,sBAAsB,GACvB,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,kBAAkB,EAClB,mBAAmB,EACnB,yBAAyB,EACzB,oBAAoB,EACpB,4BAA4B,GAC7B,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,SAAS,EACT,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,+BAA+B,EAC/B,uCAAuC,EACvC,yBAAyB,EACzB,mBAAmB,EACnB,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,kCAAkC,GACnC,MAAM,mBAAmB,CAAC;AAe3B,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,wBAAwB,EACxB,iCAAiC,GAClC,MAAM,sBAAsB,CAAC;AAC9B,YAAY,EACV,aAAa,EACb,aAAa,EACb,gBAAgB,EAChB,oBAAoB,EACpB,UAAU,EACV,eAAe,EACf,sBAAsB,EACtB,oBAAoB,GACrB,MAAM,sBAAsB,CAAC"}

package/dist/orchestration/pipeline/ingest/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/orchestration/pipeline/ingest/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAQH,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAoC3D,OAAO,EACL,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,YAAY,EACZ,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACL,eAAe,EACf,eAAe,EACf,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,SAAS,EACT,oBAAoB,GACrB,MAAM,YAAY,CAAC;AAEpB,OAAO,EACL,oBAAoB,EACpB,4BAA4B,EAC5B,+BAA+B,GAChC,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACL,+BAA+B,EAC/B,uCAAuC,EACvC,yBAAyB,EACzB,mBAAmB,EACnB,+BAA+B,EAC/B,2BAA2B,GAC5B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,wBAAwB,EACxB,8BAA8B,GAC/B,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACL,YAAY,EACZ,kCAAkC,GACnC,MAAM,mBAAmB,CAAC;AAE3B,8BAA8B;AAC9B,wEAAwE;AACxE,4DAA4D;AAC5D,EAAE;AACF,qEAAqE;AACrE,yEAAyE;AACzE,mEAAmE;AACnE,mBAAmB;AACnB,EAAE;AACF,sEAAsE;AACtE,sEAAsE;AACtE,yEAAyE;AACzE,mBAAmB;AACnB,OAAO,EACL,wBAAwB,EACxB,uBAAuB,EACvB,kBAAkB,EAClB,eAAe,EACf,2BAA2B,EAC3B,8BAA8B,EAC9B,6BAA6B,EAC7B,wBAAwB,EACxB,iCAAiC,GAClC,MAAM,sBAAsB,CAAC"}

package/dist/orchestration/pipeline/ingest/routing-tables.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-tables.d.ts","sourceRoot":"","sources":["../../../../src/orchestration/pipeline/ingest/routing-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAMH;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,+GAOvB,CAAC;AAEX,MAAM,MAAM,iBAAiB,GAAG,CAAC,OAAO,oBAAoB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEtE;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,MAAM,gBAAgB,GACxB,YAAY,GACZ,YAAY,GACZ,eAAe,GACf,YAAY,GACZ,QAAQ,GACR,MAAM,CAAC;AAEX;;GAEG;AACH,MAAM,MAAM,kBAAkB,GAC1B,YAAY,GACZ,YAAY,GACZ,eAAe,GACf,QAAQ,CAAC;AAEb;;;;GAIG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;IACpC,QAAQ,CAAC,cAAc,EAAE,QAAQ,CAC/B,MAAM,CAAC,iBAAiB,EAAE,gBAAgB,CAAC,CAC5C,CAAC;CACH;AAMD;;;;;;;;;GASG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAUP,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,gBAAgB,EAAE,kBAUP,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,mBAAmB,EAAE,kBAUV,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,eAAO,MAAM,YAAY,EAAE,kBAUH,CAAC;AAEzB;;GAEG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CACzC,MAAM,CAAC,kBAAkB,EAAE,kBAAkB,CAAC,CAM9C,CAAC"}

package/dist/orchestration/pipeline/ingest/routing-tables.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"routing-tables.js","sourceRoot":"","sources":["../../../../src/orchestration/pipeline/ingest/routing-tables.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,+EAA+E;AAC/E,QAAQ;AACR,+EAA+E;AAE/E;;;;GAIG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,oBAAoB;IACpB,mBAAmB;IACnB,cAAc;IACd,MAAM;IACN,iBAAiB;IACjB,YAAY;CACJ,CAAC;AAqDX,+EAA+E;AAC/E,gBAAgB;AAChB,+EAA+E;AAE/E;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuB,MAAM,CAAC,MAAM,CAAC;IAChE,MAAM,EAAE,YAAqB;IAC7B,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,oBAAoB,EAAE,YAAY;QAClC,mBAAmB,EAAE,YAAY;QACjC,cAAc,EAAE,YAAY;QAC5B,IAAI,EAAE,YAAY;QAClB,iBAAiB,EAAE,YAAY;QAC/B,UAAU,EAAE,YAAY;KACzB,CAAC;CACH,CAAuB,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAuB,MAAM,CAAC,MAAM,CAAC;IAChE,MAAM,EAAE,YAAqB;IAC7B,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,oBAAoB,EAAE,YAAY;QAClC,mBAAmB,EAAE,YAAY;QACjC,cAAc,EAAE,YAAY;QAC5B,IAAI,EAAE,YAAY;QAClB,iBAAiB,EAAE,YAAY;QAC/B,UAAU,EAAE,YAAY;KACzB,CAAC;CACH,CAAuB,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAuB,MAAM,CAAC,MAAM,CAAC;IACnE,MAAM,EAAE,eAAwB;IAChC,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,oBAAoB,EAAE,YAAY;QAClC,mBAAmB,EAAE,eAAe;QACpC,cAAc,EAAE,YAAY;QAC5B,IAAI,EAAE,YAAY;QAClB,iBAAiB,EAAE,YAAY;QAC/B,UAAU,EAAE,YAAY;KACzB,CAAC;CACH,CAAuB,CAAC;AAEzB;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,YAAY,GAAuB,MAAM,CAAC,MAAM,CAAC;IAC5D,MAAM,EAAE,QAAiB;IACzB,cAAc,EAAE,MAAM,CAAC,MAAM,CAAC;QAC5B,oBAAoB,EAAE,YAAY;QAClC,mBAAmB,EAAE,QAAQ;QAC7B,cAAc,EAAE,QAAQ;QACxB,IAAI,EAAE,YAAY;QAClB,iBAAiB,EAAE,YAAY;QAC/B,UAAU,EAAE,YAAY;KACzB,CAAC;CACH,CAAuB,CAAC;AAEzB;;GAEG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAE7B,MAAM,CAAC,MAAM,CAAC;IAChB,YAAY,EAAE,gBAAgB;IAC9B,UAAU,EAAE,gBAAgB;IAC5B,aAAa,EAAE,mBAAmB;IAClC,MAAM,EAAE,YAAY;CACrB,CAAC,CAAC"}

package/dist/orchestration/pipeline/ingest/select-strategy.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-strategy.d.ts","sourceRoot":"","sources":["../../../../src/orchestration/pipeline/ingest/select-strategy.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,YAAY,CAAC;AAC1D,OAAO,KAAK,EACV,iBAAiB,EACjB,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,EACjB,MAAM,qBAAqB,CAAC;AAE7B;;;;;;;;GAQG;AACH,MAAM,MAAM,gBAAgB,GAAG,MAAM,GAAG,MAAM,GAAG,mBAAmB,CAAC;AAErE;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,QAAQ,CAAC,KAAK,EAAE,kBAAkB,CAAC;IACnC,QAAQ,CAAC,kBAAkB,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3C,QAAQ,CAAC,UAAU,EAAE,gBAAgB,CAAC;IACtC,QAAQ,CAAC,aAAa,EAAE,QAAQ,CAC9B,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAClD,CAAC;CACH;AAED;;;GAGG;AACH,MAAM,WAAW,qBAAqB;IACpC,QAAQ,CAAC,aAAa,EAAE,iBAAiB,CAAC;IAC1C,uEAAuE;IACvE,QAAQ,CAAC,eAAe,EAAE,iBAAiB,GAAG,IAAI,CAAC;IACnD,QAAQ,CAAC,cAAc,EAAE,gBAAgB,CAAC;IAC1C,QAAQ,CAAC,oBAAoB,EAAE,MAAM,CAAC;IACtC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,QAAQ,CAAC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IACtC,QAAQ,CAAC,cAAc,EAAE,OAAO,CAAC;IACjC,QAAQ,CAAC,MAAM,EAAE,kBAAkB,CAAC;CACrC;AAED,qBAAa,4BAA6B,SAAQ,KAAK;aACzB,IAAI,EAAE,MAAM;gBAAZ,IAAI,EAAE,MAAM;CAIzC;AAED,qBAAa,+BAAgC,SAAQ,KAAK;aAEtC,QAAQ,EAAE,gBAAgB;aAC1B,IAAI,EAAE,MAAM;aACZ,MAAM,EAAE,MAAM;gBAFd,QAAQ,EAAE,gBAAgB,EAC1B,IAAI,EAAE,MAAM,EACZ,MAAM,EAAE,MAAM;CAQjC;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAAC,IAAI,EAAE;IACzC,aAAa,EAAE,iBAAiB,CAAC;IACjC,eAAe,EAAE,iBAAiB,GAAG,IAAI,CAAC;IAC1C,MAAM,EAAE,kBAAkB,CAAC;CAC5B,GAAG,qBAAqB,CAsFxB"}

package/dist/orchestration/pipeline/ingest/select-strategy.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"select-strategy.js","sourceRoot":"","sources":["../../../../src/orchestration/pipeline/ingest/select-strategy.ts"],"names":[],"mappings":"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"}

package/dist/orchestration/pipeline/memory/MemoryRouter.d.ts

@@ -0,0 +1,279 @@
+/**
+ * @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 type { IMemoryClassifier, MemoryClassifierResult } from './classifier.js';
+import { type MemoryBackendCostPoint } from './backend-costs.js';
+import { type AugmentedRoutingTable, type MemoryBackendId, type MemoryDispatchKey, type MemoryQueryCategory, type MemoryRouterPreset, type RoutingTable } from './routing-tables.js';
+import { type MemoryBudgetMode, type MemoryRoutingDecision } from './select-backend.js';
+import type { IMemoryDispatcher } from './dispatcher.js';
+/**
+ * Per-query USD budget policy. Combined into a single nested object so
+ * consumers can enable budget enforcement without flat-argument sprawl.
+ */
+export interface MemoryBudgetPolicy {
+    /**
+     * Budget ceiling per query in USD. When omitted, routing passes
+     * through the table's pick regardless of cost.
+     */
+    readonly perQueryUsd?: number;
+    /**
+     * How to handle budget overrun. Default `cheapest-fallback` for
+     * production safety (silently downgrades rather than throwing).
+     * See {@link MemoryBudgetMode}.
+     */
+    readonly mode?: MemoryBudgetMode;
+}
+/**
+ * Constructor options for {@link MemoryRouter}.
+ */
+export interface MemoryRouterOptions {
+    /** LLM-as-judge classifier. Usually {@link LLMMemoryClassifier}. */
+    readonly classifier: IMemoryClassifier;
+    /**
+     * Shipping preset to use. Defaults to `minimize-cost` — the same
+     * Pareto-best-for-cost preset we use on LongMemEval-S Phase B.
+     */
+    readonly preset?: MemoryRouterPreset;
+    /**
+     * Optional custom routing table override. When provided, replaces the
+     * preset's default table. The `preset` field is still used for
+     * telemetry labeling and must match.
+     */
+    readonly routingTable?: RoutingTable;
+    /**
+     * Optional per-category routing override that patches the resolved
+     * routing table. Useful when a workload needs to change a single
+     * category's dispatch without rewriting the whole table.
+     */
+    readonly mapping?: Partial<Record<MemoryQueryCategory, MemoryBackendId>>;
+    /**
+     * Optional budget policy. When omitted, no budget is enforced.
+     */
+    readonly budget?: MemoryBudgetPolicy;
+    /**
+     * Optional custom backend cost-points (for workloads whose cost /
+     * accuracy profile diverges from LongMemEval-S Phase B). When omitted,
+     * uses {@link DEFAULT_MEMORY_BACKEND_COSTS}.
+     */
+    readonly backendCosts?: Readonly<Record<MemoryBackendId, MemoryBackendCostPoint>>;
+    /**
+     * Default for {@link MemoryClassifierClassifyOptions.useFewShotPrompt}
+     * on every `decide()` call. Callers can still override per-call.
+     */
+    readonly useFewShotPrompt?: boolean;
+    /**
+     * Optional dispatcher. When supplied, {@link MemoryRouter.decideAndDispatch}
+     * is usable; otherwise callers must use {@link MemoryRouter.decide} and
+     * execute the chosen backend themselves.
+     */
+    readonly dispatcher?: IMemoryDispatcher<unknown, unknown>;
+    /**
+     * Optional augmented routing table. When supplied,
+     * {@link MemoryRouter.decideAugmented} and
+     * {@link MemoryRouter.decideAndDispatchAugmented} resolve each query
+     * to a composite {@link MemoryDispatchKey} (backend × retrieval-config)
+     * instead of the legacy single-axis backend pick.
+     *
+     * Existing consumers see no behavioral change unless they call the
+     * new augmented methods.
+     */
+    readonly augmentedTable?: AugmentedRoutingTable;
+}
+/**
+ * Per-call options for {@link MemoryRouter.decide}.
+ */
+export interface MemoryRouterDecideOptions {
+    /**
+     * Ground-truth category, passed through to the routing decision for
+     * telemetry. Not used in production. Benchmark adapters pass this when
+     * the gold label is available so downstream analysis can distinguish
+     * classifier misroutes from architectural misses.
+     */
+    readonly groundTruthCategory?: MemoryQueryCategory | null;
+    /**
+     * Per-call override of the few-shot prompt variant. When omitted,
+     * inherits the router's constructor-scoped default.
+     */
+    readonly useFewShotPrompt?: boolean;
+}
+/**
+ * Bundled result of a `decide()` call. Carries the classifier result
+ * (for cost tracking + debugging) alongside the routing decision.
+ */
+export interface MemoryRouterDecision {
+    readonly classifier: MemoryClassifierResult;
+    readonly routing: MemoryRoutingDecision;
+}
+/**
+ * Bundled result of a `decideAndDispatch()` call. Combines the full
+ * {@link MemoryRouterDecision} with the dispatched traces so telemetry
+ * and answer-generation can consume both in one step.
+ */
+export interface MemoryRouterDispatchedDecision<TTrace> {
+    readonly decision: MemoryRouterDecision;
+    readonly traces: TTrace[];
+    readonly backend: MemoryBackendId;
+}
+/**
+ * Bundled result of a `decideAugmented()` call. Carries the classifier
+ * result and the composite {@link MemoryDispatchKey} (backend ×
+ * retrieval-config) the augmented router resolved.
+ */
+export interface MemoryRouterAugmentedDecision {
+    readonly classifier: MemoryClassifierResult;
+    readonly dispatch: MemoryDispatchKey;
+}
+/**
+ * Bundled result of a `decideAndDispatchAugmented()` call. Combines
+ * the augmented decision with the dispatched traces.
+ */
+export interface MemoryRouterAugmentedDispatchedDecision<TTrace> {
+    readonly decision: MemoryRouterAugmentedDecision;
+    readonly traces: TTrace[];
+    readonly dispatch: MemoryDispatchKey;
+}
+/**
+ * Thrown when `decideAndDispatch` is called on a router that was
+ * constructed without a dispatcher.
+ */
+export declare class MemoryRouterDispatcherMissingError extends Error {
+    constructor();
+}
+/**
+ * Thrown when `decideAugmented` or `decideAndDispatchAugmented` is
+ * called on a router that was constructed without an
+ * {@link AugmentedRoutingTable}.
+ */
+export declare class MemoryRouterAugmentedTableMissingError extends Error {
+    constructor();
+}
+/**
+ * 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 '@framers/agentos/memory-router';
+ *
+ * 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 declare class MemoryRouter {
+    private readonly classifier;
+    private readonly preset;
+    private readonly routingTable;
+    private readonly augmentedTable;
+    private readonly budgetPerQuery;
+    private readonly budgetMode;
+    private readonly backendCosts;
+    private readonly defaultUseFewShotPrompt;
+    private readonly dispatcher;
+    constructor(options: MemoryRouterOptions);
+    /**
+     * 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.
+     */
+    decide(query: string, options?: MemoryRouterDecideOptions): Promise<MemoryRouterDecision>;
+    /**
+     * 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.
+     */
+    decideAndDispatch<TTrace, TPayload = undefined>(query: string, dispatchPayload?: TPayload, options?: MemoryRouterDecideOptions): Promise<MemoryRouterDispatchedDecision<TTrace>>;
+    /**
+     * 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.
+     */
+    decideAugmented(query: string, options?: MemoryRouterDecideOptions): Promise<MemoryRouterAugmentedDecision>;
+    /**
+     * 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.
+     */
+    decideAndDispatchAugmented<TTrace, TPayload = undefined>(query: string, dispatchPayload?: TPayload, options?: MemoryRouterDecideOptions): Promise<MemoryRouterAugmentedDispatchedDecision<TTrace>>;
+}
+//# sourceMappingURL=MemoryRouter.d.ts.map

package/dist/orchestration/pipeline/memory/MemoryRouter.d.ts.map

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