@framers/agentos 0.2.6 → 0.2.8

package/dist/ingest-router/IngestRouter.d.ts

@@ -0,0 +1,72 @@
+/**
+ * @file IngestRouter.ts
+ * @description Top-level input-stage orchestrator that composes the
+ * ingest classifier and the pure {@link selectIngestStrategy} into a
+ * single per-content routing call.
+ *
+ * Same shape as MemoryRouter (recall-stage) so the multi-stage guardrails
+ * orchestrator can compose them uniformly. Decide-only and decide+dispatch
+ * flows are both supported.
+ *
+ * @module @framers/agentos/ingest-router/IngestRouter
+ */
+import type { IIngestClassifier, IngestClassifierResult } from './classifier.js';
+import { type IngestStrategyCostPoint } from './costs.js';
+import { type IngestContentKind, type IngestRouterPreset, type IngestRoutingTable, type IngestStrategyId } from './routing-tables.js';
+import { type IngestBudgetMode, type IngestRoutingDecision } from './select-strategy.js';
+import type { IIngestDispatcher } from './dispatcher.js';
+export interface IngestBudgetPolicy {
+    readonly perIngestUsd?: number;
+    readonly mode?: IngestBudgetMode;
+}
+export interface IngestRouterOptions {
+    readonly classifier: IIngestClassifier;
+    readonly preset?: IngestRouterPreset;
+    readonly routingTable?: IngestRoutingTable;
+    readonly mapping?: Partial<Record<IngestContentKind, IngestStrategyId>>;
+    readonly budget?: IngestBudgetPolicy;
+    readonly strategyCosts?: Readonly<Record<IngestStrategyId, IngestStrategyCostPoint>>;
+    readonly useFewShotPrompt?: boolean;
+    readonly dispatcher?: IIngestDispatcher<unknown, unknown>;
+}
+export interface IngestRouterDecideOptions {
+    /**
+     * Optional manual override of the classifier. When set, the classifier
+     * is NOT invoked and the routing table is consulted with this kind
+     * directly. Useful when the caller already knows the content kind
+     * (e.g., file extension determines code vs structured-data).
+     */
+    readonly manualKind?: IngestContentKind;
+    readonly groundTruthKind?: IngestContentKind | null;
+    readonly useFewShotPrompt?: boolean;
+}
+export interface IngestRouterDecision {
+    readonly classifier: IngestClassifierResult;
+    readonly routing: IngestRoutingDecision;
+}
+export interface IngestRouterDispatchedResult<TOutcome> {
+    readonly decision: IngestRouterDecision;
+    readonly outcome: TOutcome;
+    readonly strategy: IngestStrategyId;
+}
+export declare class IngestRouterDispatcherMissingError extends Error {
+    constructor();
+}
+/**
+ * Public input-stage orchestrator. One instance per ingest endpoint;
+ * reuse across content events.
+ */
+export declare class IngestRouter {
+    private readonly classifier;
+    private readonly preset;
+    private readonly routingTable;
+    private readonly budgetPerIngestUsd;
+    private readonly budgetMode;
+    private readonly strategyCosts;
+    private readonly defaultUseFewShotPrompt;
+    private readonly dispatcher;
+    constructor(options: IngestRouterOptions);
+    decide(content: string, options?: IngestRouterDecideOptions): Promise<IngestRouterDecision>;
+    decideAndDispatch<TOutcome, TPayload = undefined>(content: string, dispatchPayload?: TPayload, options?: IngestRouterDecideOptions): Promise<IngestRouterDispatchedResult<TOutcome>>;
+}
+//# sourceMappingURL=IngestRouter.d.ts.map

package/dist/ingest-router/IngestRouter.d.ts.map

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

package/dist/ingest-router/IngestRouter.js

@@ -0,0 +1,98 @@
+/**
+ * @file IngestRouter.ts
+ * @description Top-level input-stage orchestrator that composes the
+ * ingest classifier and the pure {@link selectIngestStrategy} into a
+ * single per-content routing call.
+ *
+ * Same shape as MemoryRouter (recall-stage) so the multi-stage guardrails
+ * orchestrator can compose them uniformly. Decide-only and decide+dispatch
+ * flows are both supported.
+ *
+ * @module @framers/agentos/ingest-router/IngestRouter
+ */
+import { DEFAULT_INGEST_COSTS, } from './costs.js';
+import { PRESET_INGEST_TABLES, } from './routing-tables.js';
+import { selectIngestStrategy, } from './select-strategy.js';
+export class IngestRouterDispatcherMissingError extends Error {
+    constructor() {
+        super('IngestRouter.decideAndDispatch requires a dispatcher. ' +
+            'Either pass a dispatcher in options or call `decide` and dispatch yourself.');
+        this.name = 'IngestRouterDispatcherMissingError';
+    }
+}
+/**
+ * Public input-stage orchestrator. One instance per ingest endpoint;
+ * reuse across content events.
+ */
+export class IngestRouter {
+    constructor(options) {
+        this.classifier = options.classifier;
+        this.preset = options.preset ?? 'raw-chunks';
+        this.dispatcher = options.dispatcher ?? null;
+        const baseTable = options.routingTable ?? PRESET_INGEST_TABLES[this.preset];
+        if (options.mapping) {
+            const patched = {
+                ...baseTable.defaultMapping,
+            };
+            for (const key of Object.keys(options.mapping)) {
+                const ov = options.mapping[key];
+                if (ov)
+                    patched[key] = ov;
+            }
+            this.routingTable = Object.freeze({
+                preset: baseTable.preset,
+                defaultMapping: Object.freeze(patched),
+            });
+        }
+        else {
+            this.routingTable = baseTable;
+        }
+        this.budgetPerIngestUsd = options.budget?.perIngestUsd ?? null;
+        this.budgetMode = options.budget?.mode ?? 'cheapest-fallback';
+        this.strategyCosts = options.strategyCosts ?? DEFAULT_INGEST_COSTS;
+        this.defaultUseFewShotPrompt = options.useFewShotPrompt ?? false;
+    }
+    async decide(content, options) {
+        let classifier;
+        if (options?.manualKind) {
+            classifier = {
+                kind: options.manualKind,
+                tokensIn: 0,
+                tokensOut: 0,
+                model: 'manual',
+            };
+        }
+        else {
+            const useFewShot = options?.useFewShotPrompt ?? this.defaultUseFewShotPrompt;
+            classifier = await this.classifier.classify(content, useFewShot ? { useFewShotPrompt: true } : undefined);
+        }
+        const routing = selectIngestStrategy({
+            predictedKind: classifier.kind,
+            groundTruthKind: options?.groundTruthKind ?? null,
+            config: {
+                table: this.routingTable,
+                budgetPerIngestUsd: this.budgetPerIngestUsd,
+                budgetMode: this.budgetMode,
+                strategyCosts: this.strategyCosts,
+            },
+        });
+        return { classifier, routing };
+    }
+    async decideAndDispatch(content, dispatchPayload, options) {
+        if (!this.dispatcher) {
+            throw new IngestRouterDispatcherMissingError();
+        }
+        const decision = await this.decide(content, options);
+        const dispatched = (await this.dispatcher.dispatch({
+            strategy: decision.routing.chosenStrategy,
+            content,
+            payload: dispatchPayload,
+        }));
+        return {
+            decision,
+            outcome: dispatched.outcome,
+            strategy: dispatched.strategy,
+        };
+    }
+}
+//# sourceMappingURL=IngestRouter.js.map

package/dist/ingest-router/IngestRouter.js.map

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

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

@@ -0,0 +1,63 @@
+/**
+ * @file classifier.ts
+ * @description LLM-as-judge classifier that maps a piece of content to
+ * one of the six {@link IngestContentKind} values.
+ *
+ * Same shape as the memory-router classifier — deliberately so the
+ * multi-stage guardrails orchestrator can compose them with one mental
+ * model.
+ *
+ * @module @framers/agentos/ingest-router/classifier
+ */
+import { type IngestContentKind } from './routing-tables.js';
+export interface IngestClassifierLLMRequest {
+    readonly system: string;
+    readonly user: string;
+    readonly maxTokens: number;
+    readonly temperature: number;
+}
+export interface IngestClassifierLLMResponse {
+    readonly text: string;
+    readonly tokensIn: number;
+    readonly tokensOut: number;
+    readonly model: string;
+}
+export interface IIngestClassifierLLM {
+    invoke(request: IngestClassifierLLMRequest): Promise<IngestClassifierLLMResponse>;
+}
+export interface IngestClassifierClassifyOptions {
+    /** Use the few-shot prompt variant (more accurate on ambiguous content). */
+    readonly useFewShotPrompt?: boolean;
+}
+export interface IngestClassifierResult {
+    readonly kind: IngestContentKind;
+    readonly tokensIn: number;
+    readonly tokensOut: number;
+    readonly model: string;
+}
+export interface IIngestClassifier {
+    classify(content: string, options?: IngestClassifierClassifyOptions): Promise<IngestClassifierResult>;
+}
+export declare const INGEST_CLASSIFIER_SYSTEM_PROMPT = "You are classifying a piece of content into one of six ingest kinds for memory storage.\n\nReturn ONLY the kind token (no explanation, no quotes, no punctuation).\n\nKinds:\n- short-conversation: 1-3 turns of chat dialog. Examples: a one-message Q&A, a brief support exchange.\n- long-conversation: extended chat sessions across many turns. Examples: a 50-turn coding conversation, a 30-turn customer support thread.\n- long-article: prose document over ~500 words. Examples: a blog post, a research paper section, a long email.\n- code: source code, configuration files, schemas. Examples: a TypeScript module, a SQL migration, a JSON schema.\n- structured-data: tabular or JSON-style records. Examples: a CSV, a JSON list of records, a database export.\n- multimodal: content that includes images, video frames, or audio. Examples: a PDF with figures, a presentation slide.";
+export declare const INGEST_CLASSIFIER_SYSTEM_PROMPT_FEWSHOT = "You are classifying a piece of content into one of six ingest kinds for memory storage.\n\nReturn ONLY the kind token (no explanation, no quotes, no punctuation).\n\nKinds:\n- short-conversation: 1-3 turns of chat dialog.\n- long-conversation: extended chat sessions across many turns.\n- long-article: prose document over ~500 words.\n- code: source code, configuration files, schemas.\n- structured-data: tabular or JSON-style records.\n- multimodal: content that includes images, video frames, or audio.\n\nExamples:\n\nContent: \"user: hi\\nassistant: hi! how can I help?\"\nKind: short-conversation\n\nContent: \"[3000 words of a research paper introduction]\"\nKind: long-article\n\nContent: \"export function fibonacci(n: number): number { return n < 2 ? n : fibonacci(n-1) + fibonacci(n-2); }\"\nKind: code\n\nContent: \"[CSV with 50 rows of user records]\"\nKind: structured-data\n\nContent: \"[40 turns of a customer-support thread]\"\nKind: long-conversation\n\nContent: \"[image bytes + caption text]\"\nKind: multimodal";
+export declare const SAFE_INGEST_FALLBACK_KIND: IngestContentKind;
+export declare function normalizeIngestClassifierOutput(raw: string): string;
+export declare function parseIngestClassifierOutput(raw: string): IngestContentKind;
+export interface LLMIngestClassifierOptions {
+    readonly llm: IIngestClassifierLLM;
+    readonly maxTokens?: number;
+    /**
+     * Maximum content characters to forward to the classifier. Most ingest
+     * decisions can be made from the first ~1k chars (kind detection
+     * doesn't require the full body). Default 1000.
+     */
+    readonly maxContentChars?: number;
+}
+export declare class LLMIngestClassifier implements IIngestClassifier {
+    private readonly llm;
+    private readonly maxTokens;
+    private readonly maxContentChars;
+    constructor(options: LLMIngestClassifierOptions);
+    classify(content: string, options?: IngestClassifierClassifyOptions): Promise<IngestClassifierResult>;
+}
+//# sourceMappingURL=classifier.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.d.ts","sourceRoot":"","sources":["../../src/ingest-router/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,qBAAqB,CAAC;AAM7B,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;CAC9B;AAED,MAAM,WAAW,2BAA2B;IAC1C,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CACJ,OAAO,EAAE,0BAA0B,GAClC,OAAO,CAAC,2BAA2B,CAAC,CAAC;CACzC;AAMD,MAAM,WAAW,+BAA+B;IAC9C,4EAA4E;IAC5E,QAAQ,CAAC,gBAAgB,CAAC,EAAE,OAAO,CAAC;CACrC;AAED,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,IAAI,EAAE,iBAAiB,CAAC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;CACxB;AAED,MAAM,WAAW,iBAAiB;IAChC,QAAQ,CACN,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,+BAA+B,GACxC,OAAO,CAAC,sBAAsB,CAAC,CAAC;CACpC;AAMD,eAAO,MAAM,+BAA+B,g3BAU4E,CAAC;AAEzH,eAAO,MAAM,uCAAuC,6gCA8BnC,CAAC;AAElB,eAAO,MAAM,yBAAyB,EAAE,iBAAwC,CAAC;AAEjF,wBAAgB,+BAA+B,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAcnE;AAED,wBAAgB,2BAA2B,CAAC,GAAG,EAAE,MAAM,GAAG,iBAAiB,CAY1E;AAMD,MAAM,WAAW,0BAA0B;IACzC,QAAQ,CAAC,GAAG,EAAE,oBAAoB,CAAC;IACnC,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;IAC5B;;;;OAIG;IACH,QAAQ,CAAC,eAAe,CAAC,EAAE,MAAM,CAAC;CACnC;AAED,qBAAa,mBAAoB,YAAW,iBAAiB;IAC3D,OAAO,CAAC,QAAQ,CAAC,GAAG,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,eAAe,CAAS;gBAE7B,OAAO,EAAE,0BAA0B;IAMzC,QAAQ,CACZ,OAAO,EAAE,MAAM,EACf,OAAO,CAAC,EAAE,+BAA+B,GACxC,OAAO,CAAC,sBAAsB,CAAC;CAqBnC"}

package/dist/ingest-router/classifier.js

@@ -0,0 +1,111 @@
+/**
+ * @file classifier.ts
+ * @description LLM-as-judge classifier that maps a piece of content to
+ * one of the six {@link IngestContentKind} values.
+ *
+ * Same shape as the memory-router classifier — deliberately so the
+ * multi-stage guardrails orchestrator can compose them with one mental
+ * model.
+ *
+ * @module @framers/agentos/ingest-router/classifier
+ */
+import { INGEST_CONTENT_KINDS, } from './routing-tables.js';
+// ============================================================================
+// Prompts
+// ============================================================================
+export const INGEST_CLASSIFIER_SYSTEM_PROMPT = `You are classifying a piece of content into one of six ingest kinds for memory storage.
+
+Return ONLY the kind token (no explanation, no quotes, no punctuation).
+
+Kinds:
+- short-conversation: 1-3 turns of chat dialog. Examples: a one-message Q&A, a brief support exchange.
+- long-conversation: extended chat sessions across many turns. Examples: a 50-turn coding conversation, a 30-turn customer support thread.
+- long-article: prose document over ~500 words. Examples: a blog post, a research paper section, a long email.
+- code: source code, configuration files, schemas. Examples: a TypeScript module, a SQL migration, a JSON schema.
+- structured-data: tabular or JSON-style records. Examples: a CSV, a JSON list of records, a database export.
+- multimodal: content that includes images, video frames, or audio. Examples: a PDF with figures, a presentation slide.`;
+export const INGEST_CLASSIFIER_SYSTEM_PROMPT_FEWSHOT = `You are classifying a piece of content into one of six ingest kinds for memory storage.
+
+Return ONLY the kind token (no explanation, no quotes, no punctuation).
+
+Kinds:
+- short-conversation: 1-3 turns of chat dialog.
+- long-conversation: extended chat sessions across many turns.
+- long-article: prose document over ~500 words.
+- code: source code, configuration files, schemas.
+- structured-data: tabular or JSON-style records.
+- multimodal: content that includes images, video frames, or audio.
+
+Examples:
+
+Content: "user: hi\\nassistant: hi! how can I help?"
+Kind: short-conversation
+
+Content: "[3000 words of a research paper introduction]"
+Kind: long-article
+
+Content: "export function fibonacci(n: number): number { return n < 2 ? n : fibonacci(n-1) + fibonacci(n-2); }"
+Kind: code
+
+Content: "[CSV with 50 rows of user records]"
+Kind: structured-data
+
+Content: "[40 turns of a customer-support thread]"
+Kind: long-conversation
+
+Content: "[image bytes + caption text]"
+Kind: multimodal`;
+export const SAFE_INGEST_FALLBACK_KIND = 'short-conversation';
+export function normalizeIngestClassifierOutput(raw) {
+    const lines = raw.split('\n');
+    let firstLine = '';
+    for (const ln of lines) {
+        if (ln.trim().length > 0) {
+            firstLine = ln;
+            break;
+        }
+    }
+    let cleaned = firstLine.trim().toLowerCase();
+    cleaned = cleaned.replace(/^(kind|category|type|answer|label|class)\s*[:\-=]\s*/, '');
+    cleaned = cleaned.replace(/^["'`]+|["'`]+$/g, '');
+    cleaned = cleaned.replace(/[.,;!?]+$/g, '');
+    return cleaned.trim();
+}
+export function parseIngestClassifierOutput(raw) {
+    const cleaned = normalizeIngestClassifierOutput(raw);
+    for (const token of INGEST_CONTENT_KINDS) {
+        if (cleaned === token ||
+            cleaned.startsWith(`${token} `) ||
+            cleaned.startsWith(`${token}\n`)) {
+            return token;
+        }
+    }
+    return SAFE_INGEST_FALLBACK_KIND;
+}
+export class LLMIngestClassifier {
+    constructor(options) {
+        this.llm = options.llm;
+        this.maxTokens = options.maxTokens ?? 16;
+        this.maxContentChars = options.maxContentChars ?? 1000;
+    }
+    async classify(content, options) {
+        const system = options?.useFewShotPrompt
+            ? INGEST_CLASSIFIER_SYSTEM_PROMPT_FEWSHOT
+            : INGEST_CLASSIFIER_SYSTEM_PROMPT;
+        const truncated = content.slice(0, this.maxContentChars);
+        const user = `Content: ${truncated}\n\nKind:`;
+        const response = await this.llm.invoke({
+            system,
+            user,
+            maxTokens: this.maxTokens,
+            temperature: 0,
+        });
+        return {
+            kind: parseIngestClassifierOutput(response.text),
+            tokensIn: response.tokensIn,
+            tokensOut: response.tokensOut,
+            model: response.model,
+        };
+    }
+}
+//# sourceMappingURL=classifier.js.map

package/dist/ingest-router/classifier.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"classifier.js","sourceRoot":"","sources":["../../src/ingest-router/classifier.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,EACL,oBAAoB,GAErB,MAAM,qBAAqB,CAAC;AAiD7B,+EAA+E;AAC/E,UAAU;AACV,+EAA+E;AAE/E,MAAM,CAAC,MAAM,+BAA+B,GAAG;;;;;;;;;;wHAUyE,CAAC;AAEzH,MAAM,CAAC,MAAM,uCAAuC,GAAG;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBA8BtC,CAAC;AAElB,MAAM,CAAC,MAAM,yBAAyB,GAAsB,oBAAoB,CAAC;AAEjF,MAAM,UAAU,+BAA+B,CAAC,GAAW;IACzD,MAAM,KAAK,GAAG,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;IAC9B,IAAI,SAAS,GAAG,EAAE,CAAC;IACnB,KAAK,MAAM,EAAE,IAAI,KAAK,EAAE,CAAC;QACvB,IAAI,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACzB,SAAS,GAAG,EAAE,CAAC;YACf,MAAM;QACR,CAAC;IACH,CAAC;IACD,IAAI,OAAO,GAAG,SAAS,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC;IAC7C,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,sDAAsD,EAAE,EAAE,CAAC,CAAC;IACtF,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAC;IAClD,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,YAAY,EAAE,EAAE,CAAC,CAAC;IAC5C,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC;AAED,MAAM,UAAU,2BAA2B,CAAC,GAAW;IACrD,MAAM,OAAO,GAAG,+BAA+B,CAAC,GAAG,CAAC,CAAC;IACrD,KAAK,MAAM,KAAK,IAAI,oBAAoB,EAAE,CAAC;QACzC,IACE,OAAO,KAAK,KAAK;YACjB,OAAO,CAAC,UAAU,CAAC,GAAG,KAAK,GAAG,CAAC;YAC/B,OAAO,CAAC,UAAU,CAAC,GAAG,KAAK,IAAI,CAAC,EAChC,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC;IACH,CAAC;IACD,OAAO,yBAAyB,CAAC;AACnC,CAAC;AAiBD,MAAM,OAAO,mBAAmB;IAK9B,YAAY,OAAmC;QAC7C,IAAI,CAAC,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;QACvB,IAAI,CAAC,SAAS,GAAG,OAAO,CAAC,SAAS,IAAI,EAAE,CAAC;QACzC,IAAI,CAAC,eAAe,GAAG,OAAO,CAAC,eAAe,IAAI,IAAI,CAAC;IACzD,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,OAAe,EACf,OAAyC;QAEzC,MAAM,MAAM,GAAG,OAAO,EAAE,gBAAgB;YACtC,CAAC,CAAC,uCAAuC;YACzC,CAAC,CAAC,+BAA+B,CAAC;QACpC,MAAM,SAAS,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC,EAAE,IAAI,CAAC,eAAe,CAAC,CAAC;QACzD,MAAM,IAAI,GAAG,YAAY,SAAS,WAAW,CAAC;QAE9C,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC;YACrC,MAAM;YACN,IAAI;YACJ,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,WAAW,EAAE,CAAC;SACf,CAAC,CAAC;QAEH,OAAO;YACL,IAAI,EAAE,2BAA2B,CAAC,QAAQ,CAAC,IAAI,CAAC;YAChD,QAAQ,EAAE,QAAQ,CAAC,QAAQ;YAC3B,SAAS,EAAE,QAAQ,CAAC,SAAS;YAC7B,KAAK,EAAE,QAAQ,CAAC,KAAK;SACtB,CAAC;IACJ,CAAC;CACF"}

package/dist/ingest-router/costs.d.ts

@@ -0,0 +1,48 @@
+/**
+ * @file costs.ts
+ * @description Cost-points for ingest strategies.
+ *
+ * Unlike retrieval where Phase B measurements give us per-category
+ * accuracy + cost data, ingest cost is dominated by LLM-call counts at
+ * write time and is much more workload-dependent (a long-article may
+ * have 1 summarize call; a long-conversation may have 30 observation
+ * extraction calls). The numbers below are illustrative averages; for
+ * production-budget enforcement, consumers should override with measured
+ * values from their own workload.
+ *
+ * @module @framers/agentos/ingest-router/costs
+ */
+import type { IngestStrategyId } from './routing-tables.js';
+/**
+ * Cost-point for one ingest strategy. The router uses this to apply
+ * budget constraints + pick a cheaper fallback when a strategy doesn't
+ * fit a per-ingest USD ceiling.
+ */
+export interface IngestStrategyCostPoint {
+    readonly strategy: IngestStrategyId;
+    /** Average USD per ingest event (one session / one document). */
+    readonly avgCostPerIngest: number;
+    /**
+     * Average latency per ingest in milliseconds. For short content this
+     * is roughly proportional to the number of LLM calls.
+     */
+    readonly avgLatencyMs: number;
+    /**
+     * Free-form label describing what this strategy actually writes
+     * (chunks, summarized chunks, observations, fact triples, etc.).
+     * Useful for telemetry + dashboards.
+     */
+    readonly outputDescription: string;
+}
+export declare const RAW_CHUNKS_COST: IngestStrategyCostPoint;
+export declare const SUMMARIZED_COST: IngestStrategyCostPoint;
+export declare const OBSERVATIONAL_COST: IngestStrategyCostPoint;
+export declare const FACT_GRAPH_COST: IngestStrategyCostPoint;
+export declare const HYBRID_COST: IngestStrategyCostPoint;
+export declare const SKIP_COST: IngestStrategyCostPoint;
+/**
+ * Default cost-points registry. Override per workload by passing a
+ * custom map to {@link IngestRouter} at construction.
+ */
+export declare const DEFAULT_INGEST_COSTS: Readonly<Record<IngestStrategyId, IngestStrategyCostPoint>>;
+//# sourceMappingURL=costs.d.ts.map

package/dist/ingest-router/costs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"costs.d.ts","sourceRoot":"","sources":["../../src/ingest-router/costs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,iEAAiE;IACjE,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC;;;OAGG;IACH,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;OAIG;IACH,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;CACpC;AAED,eAAO,MAAM,eAAe,EAAE,uBAKD,CAAC;AAE9B,eAAO,MAAM,eAAe,EAAE,uBAKD,CAAC;AAE9B,eAAO,MAAM,kBAAkB,EAAE,uBAKJ,CAAC;AAE9B,eAAO,MAAM,eAAe,EAAE,uBAKD,CAAC;AAE9B,eAAO,MAAM,WAAW,EAAE,uBAKG,CAAC;AAE9B,eAAO,MAAM,SAAS,EAAE,uBAKK,CAAC;AAE9B;;;GAGG;AACH,eAAO,MAAM,oBAAoB,EAAE,QAAQ,CACzC,MAAM,CAAC,gBAAgB,EAAE,uBAAuB,CAAC,CAQjD,CAAC"}

package/dist/ingest-router/costs.js

@@ -0,0 +1,63 @@
+/**
+ * @file costs.ts
+ * @description Cost-points for ingest strategies.
+ *
+ * Unlike retrieval where Phase B measurements give us per-category
+ * accuracy + cost data, ingest cost is dominated by LLM-call counts at
+ * write time and is much more workload-dependent (a long-article may
+ * have 1 summarize call; a long-conversation may have 30 observation
+ * extraction calls). The numbers below are illustrative averages; for
+ * production-budget enforcement, consumers should override with measured
+ * values from their own workload.
+ *
+ * @module @framers/agentos/ingest-router/costs
+ */
+export const RAW_CHUNKS_COST = Object.freeze({
+    strategy: 'raw-chunks',
+    avgCostPerIngest: 0.0001, // embedding-only
+    avgLatencyMs: 200,
+    outputDescription: 'raw turns/chunks with embeddings',
+});
+export const SUMMARIZED_COST = Object.freeze({
+    strategy: 'summarized',
+    avgCostPerIngest: 0.005, // one LLM summarize call per session/document
+    avgLatencyMs: 1500,
+    outputDescription: 'session/document summary prefixed to every chunk',
+});
+export const OBSERVATIONAL_COST = Object.freeze({
+    strategy: 'observational',
+    avgCostPerIngest: 0.020, // multi-call observation extraction
+    avgLatencyMs: 6000,
+    outputDescription: 'structured observation log replacing raw turns',
+});
+export const FACT_GRAPH_COST = Object.freeze({
+    strategy: 'fact-graph',
+    avgCostPerIngest: 0.015, // triple extraction
+    avgLatencyMs: 4500,
+    outputDescription: 'fact triples + entity-relation graph',
+});
+export const HYBRID_COST = Object.freeze({
+    strategy: 'hybrid',
+    avgCostPerIngest: 0.030, // raw + summarized + observational
+    avgLatencyMs: 8000,
+    outputDescription: 'parallel raw-chunks + summarized + observational outputs',
+});
+export const SKIP_COST = Object.freeze({
+    strategy: 'skip',
+    avgCostPerIngest: 0,
+    avgLatencyMs: 0,
+    outputDescription: 'content discarded; nothing written to memory',
+});
+/**
+ * Default cost-points registry. Override per workload by passing a
+ * custom map to {@link IngestRouter} at construction.
+ */
+export const DEFAULT_INGEST_COSTS = Object.freeze({
+    'raw-chunks': RAW_CHUNKS_COST,
+    summarized: SUMMARIZED_COST,
+    observational: OBSERVATIONAL_COST,
+    'fact-graph': FACT_GRAPH_COST,
+    hybrid: HYBRID_COST,
+    skip: SKIP_COST,
+});
+//# sourceMappingURL=costs.js.map

package/dist/ingest-router/costs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"costs.js","sourceRoot":"","sources":["../../src/ingest-router/costs.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;GAaG;AA0BH,MAAM,CAAC,MAAM,eAAe,GAA4B,MAAM,CAAC,MAAM,CAAC;IACpE,QAAQ,EAAE,YAAqB;IAC/B,gBAAgB,EAAE,MAAM,EAAE,iBAAiB;IAC3C,YAAY,EAAE,GAAG;IACjB,iBAAiB,EAAE,kCAAkC;CACtD,CAA4B,CAAC;AAE9B,MAAM,CAAC,MAAM,eAAe,GAA4B,MAAM,CAAC,MAAM,CAAC;IACpE,QAAQ,EAAE,YAAqB;IAC/B,gBAAgB,EAAE,KAAK,EAAE,8CAA8C;IACvE,YAAY,EAAE,IAAI;IAClB,iBAAiB,EAAE,kDAAkD;CACtE,CAA4B,CAAC;AAE9B,MAAM,CAAC,MAAM,kBAAkB,GAA4B,MAAM,CAAC,MAAM,CAAC;IACvE,QAAQ,EAAE,eAAwB;IAClC,gBAAgB,EAAE,KAAK,EAAE,oCAAoC;IAC7D,YAAY,EAAE,IAAI;IAClB,iBAAiB,EAAE,gDAAgD;CACpE,CAA4B,CAAC;AAE9B,MAAM,CAAC,MAAM,eAAe,GAA4B,MAAM,CAAC,MAAM,CAAC;IACpE,QAAQ,EAAE,YAAqB;IAC/B,gBAAgB,EAAE,KAAK,EAAE,oBAAoB;IAC7C,YAAY,EAAE,IAAI;IAClB,iBAAiB,EAAE,sCAAsC;CAC1D,CAA4B,CAAC;AAE9B,MAAM,CAAC,MAAM,WAAW,GAA4B,MAAM,CAAC,MAAM,CAAC;IAChE,QAAQ,EAAE,QAAiB;IAC3B,gBAAgB,EAAE,KAAK,EAAE,mCAAmC;IAC5D,YAAY,EAAE,IAAI;IAClB,iBAAiB,EAAE,0DAA0D;CAC9E,CAA4B,CAAC;AAE9B,MAAM,CAAC,MAAM,SAAS,GAA4B,MAAM,CAAC,MAAM,CAAC;IAC9D,QAAQ,EAAE,MAAe;IACzB,gBAAgB,EAAE,CAAC;IACnB,YAAY,EAAE,CAAC;IACf,iBAAiB,EAAE,8CAA8C;CAClE,CAA4B,CAAC;AAE9B;;;GAGG;AACH,MAAM,CAAC,MAAM,oBAAoB,GAE7B,MAAM,CAAC,MAAM,CAAC;IAChB,YAAY,EAAE,eAAe;IAC7B,UAAU,EAAE,eAAe;IAC3B,aAAa,EAAE,kBAAkB;IACjC,YAAY,EAAE,eAAe;IAC7B,MAAM,EAAE,WAAW;IACnB,IAAI,EAAE,SAAS;CAChB,CAAC,CAAC"}

package/dist/ingest-router/dispatcher.d.ts

@@ -0,0 +1,35 @@
+/**
+ * @file dispatcher.ts
+ * @description Backend-execution layer for {@link IngestRouter}.
+ *
+ * Same routing-table-of-functions pattern as memory-router's
+ * {@link FunctionMemoryDispatcher}. Caller registers per-strategy
+ * executors at construction; dispatcher picks the right one per call.
+ *
+ * @module @framers/agentos/ingest-router/dispatcher
+ */
+import type { IngestStrategyId } from './routing-tables.js';
+export type IngestStrategyExecutor<TOutcome, TPayload = undefined> = (content: string, payload: TPayload) => Promise<TOutcome>;
+export interface IngestDispatchArgs<TPayload = undefined> {
+    readonly strategy: IngestStrategyId;
+    readonly content: string;
+    readonly payload?: TPayload;
+}
+export interface IngestDispatchResult<TOutcome> {
+    readonly outcome: TOutcome;
+    readonly strategy: IngestStrategyId;
+}
+export interface IIngestDispatcher<TOutcome = unknown, TPayload = unknown> {
+    dispatch(args: IngestDispatchArgs<TPayload>): Promise<IngestDispatchResult<TOutcome>>;
+}
+export declare class UnsupportedIngestStrategyError extends Error {
+    readonly strategy: IngestStrategyId;
+    constructor(strategy: IngestStrategyId);
+}
+export type IngestStrategyRegistry<TOutcome, TPayload> = Partial<Record<IngestStrategyId, IngestStrategyExecutor<TOutcome, TPayload>>>;
+export declare class FunctionIngestDispatcher<TOutcome, TPayload = undefined> implements IIngestDispatcher<TOutcome, TPayload> {
+    private readonly registry;
+    constructor(registry: IngestStrategyRegistry<TOutcome, TPayload>);
+    dispatch(args: IngestDispatchArgs<TPayload>): Promise<IngestDispatchResult<TOutcome>>;
+}
+//# sourceMappingURL=dispatcher.d.ts.map

package/dist/ingest-router/dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.d.ts","sourceRoot":"","sources":["../../src/ingest-router/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAE5D,MAAM,MAAM,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,IAAI,CACnE,OAAO,EAAE,MAAM,EACf,OAAO,EAAE,QAAQ,KACd,OAAO,CAAC,QAAQ,CAAC,CAAC;AAEvB,MAAM,WAAW,kBAAkB,CAAC,QAAQ,GAAG,SAAS;IACtD,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;IACpC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,OAAO,CAAC,EAAE,QAAQ,CAAC;CAC7B;AAED,MAAM,WAAW,oBAAoB,CAAC,QAAQ;IAC5C,QAAQ,CAAC,OAAO,EAAE,QAAQ,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,gBAAgB,CAAC;CACrC;AAED,MAAM,WAAW,iBAAiB,CAAC,QAAQ,GAAG,OAAO,EAAE,QAAQ,GAAG,OAAO;IACvE,QAAQ,CACN,IAAI,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GACjC,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;CAC5C;AAED,qBAAa,8BAA+B,SAAQ,KAAK;aAC3B,QAAQ,EAAE,gBAAgB;gBAA1B,QAAQ,EAAE,gBAAgB;CAOvD;AAED,MAAM,MAAM,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,IAAI,OAAO,CAC9D,MAAM,CAAC,gBAAgB,EAAE,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC,CACrE,CAAC;AAEF,qBAAa,wBAAwB,CAAC,QAAQ,EAAE,QAAQ,GAAG,SAAS,CAClE,YAAW,iBAAiB,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAEhD,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAA6C;gBAE1D,QAAQ,EAAE,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAI1D,QAAQ,CACZ,IAAI,EAAE,kBAAkB,CAAC,QAAQ,CAAC,GACjC,OAAO,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC;CAQ3C"}

package/dist/ingest-router/dispatcher.js

@@ -0,0 +1,32 @@
+/**
+ * @file dispatcher.ts
+ * @description Backend-execution layer for {@link IngestRouter}.
+ *
+ * Same routing-table-of-functions pattern as memory-router's
+ * {@link FunctionMemoryDispatcher}. Caller registers per-strategy
+ * executors at construction; dispatcher picks the right one per call.
+ *
+ * @module @framers/agentos/ingest-router/dispatcher
+ */
+export class UnsupportedIngestStrategyError extends Error {
+    constructor(strategy) {
+        super(`IngestDispatcher: strategy '${strategy}' is not registered. ` +
+            `Supply an executor for this strategy at construction.`);
+        this.strategy = strategy;
+        this.name = 'UnsupportedIngestStrategyError';
+    }
+}
+export class FunctionIngestDispatcher {
+    constructor(registry) {
+        this.registry = registry;
+    }
+    async dispatch(args) {
+        const exec = this.registry[args.strategy];
+        if (!exec) {
+            throw new UnsupportedIngestStrategyError(args.strategy);
+        }
+        const outcome = await exec(args.content, args.payload);
+        return { outcome, strategy: args.strategy };
+    }
+}
+//# sourceMappingURL=dispatcher.js.map

package/dist/ingest-router/dispatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"dispatcher.js","sourceRoot":"","sources":["../../src/ingest-router/dispatcher.ts"],"names":[],"mappings":"AAAA;;;;;;;;;GASG;AA0BH,MAAM,OAAO,8BAA+B,SAAQ,KAAK;IACvD,YAA4B,QAA0B;QACpD,KAAK,CACH,+BAA+B,QAAQ,uBAAuB;YAC5D,uDAAuD,CAC1D,CAAC;QAJwB,aAAQ,GAAR,QAAQ,CAAkB;QAKpD,IAAI,CAAC,IAAI,GAAG,gCAAgC,CAAC;IAC/C,CAAC;CACF;AAMD,MAAM,OAAO,wBAAwB;IAKnC,YAAY,QAAoD;QAC9D,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;IAC3B,CAAC;IAED,KAAK,CAAC,QAAQ,CACZ,IAAkC;QAElC,MAAM,IAAI,GAAG,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1C,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,IAAI,8BAA8B,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,IAAI,CAAC,OAAmB,CAAC,CAAC;QACnE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC;IAC9C,CAAC;CACF"}

package/dist/ingest-router/index.d.ts

@@ -0,0 +1,43 @@
+/**
+ * AgentOS IngestRouter Module
+ *
+ * Input-stage LLM-as-judge orchestrator for memory ingest. Sibling of
+ * {@link MemoryRouter} (recall-stage), {@link QueryRouter} (Q&A-stage),
+ * and the output-stage guardrails. Together they form the agentos
+ * multi-stage guardrails pattern.
+ *
+ * Where MemoryRouter picks the recall architecture for a query,
+ * IngestRouter picks the storage architecture for incoming content. The
+ * choice affects what's STORED, which downstream MemoryRouter then queries.
+ *
+ * **Architecture Overview:**
+ * ```
+ *   Content stream
+ *         │
+ *         ▼
+ *  ┌────────────────────────────────────────────────┐
+ *  │              IngestRouter                      │
+ *  │  classify content → pick strategy → store      │
+ *  └────────────────────────────────────────────────┘
+ *         │             │              │
+ *         ▼             ▼              ▼
+ *   raw-chunks      summarized    observational
+ *   fact-graph      hybrid        skip
+ * ```
+ *
+ * @module @framers/agentos/ingest-router
+ */
+export type { IngestContentKind, IngestStrategyId, IngestRouterPreset, IngestRoutingTable, } from './routing-tables.js';
+export { INGEST_CONTENT_KINDS } from './routing-tables.js';
+export type { IngestStrategyCostPoint } from './costs.js';
+export type { IngestBudgetMode, IngestRouterConfig, IngestRoutingDecision, } from './select-strategy.js';
+export type { IIngestClassifier, IIngestClassifierLLM, IngestClassifierLLMRequest, IngestClassifierLLMResponse, IngestClassifierClassifyOptions, IngestClassifierResult, LLMIngestClassifierOptions, } from './classifier.js';
+export type { IIngestDispatcher, IngestDispatchArgs, IngestDispatchResult, IngestStrategyExecutor, IngestStrategyRegistry, } from './dispatcher.js';
+export type { IngestBudgetPolicy, IngestRouterOptions, IngestRouterDecideOptions, IngestRouterDecision, IngestRouterDispatchedResult, } from './IngestRouter.js';
+export { RAW_CHUNKS_TABLE, SUMMARIZED_TABLE, OBSERVATIONAL_TABLE, HYBRID_TABLE, PRESET_INGEST_TABLES, } from './routing-tables.js';
+export { RAW_CHUNKS_COST, SUMMARIZED_COST, OBSERVATIONAL_COST, FACT_GRAPH_COST, HYBRID_COST, SKIP_COST, DEFAULT_INGEST_COSTS, } from './costs.js';
+export { selectIngestStrategy, IngestRouterUnknownKindError, IngestRouterBudgetExceededError, } from './select-strategy.js';
+export { INGEST_CLASSIFIER_SYSTEM_PROMPT, INGEST_CLASSIFIER_SYSTEM_PROMPT_FEWSHOT, SAFE_INGEST_FALLBACK_KIND, LLMIngestClassifier, normalizeIngestClassifierOutput, parseIngestClassifierOutput, } from './classifier.js';
+export { FunctionIngestDispatcher, UnsupportedIngestStrategyError, } from './dispatcher.js';
+export { IngestRouter, IngestRouterDispatcherMissingError, } from './IngestRouter.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/ingest-router/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ingest-router/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"}