@ruvector/ruvllm 2.6.2 → 2.7.0

package/dist/cjs/rlm/types.d.ts

@@ -1,189 +0,0 @@
-/**
- * RLM (Retrieval Language Model) Type Definitions
- *
- * Types for the recursive retrieval-augmented generation system
- * that breaks down complex queries into sub-queries and synthesizes
- * answers from retrieved memory spans.
- */
-/**
- * Configuration for the RLM controller
- *
- * @example
- * ```typescript
- * const config: RlmConfig = {
- *   maxDepth: 3,
- *   maxSubQueries: 5,
- *   tokenBudget: 4096,
- *   enableCache: true,
- *   cacheTtl: 300000, // 5 minutes
- *   retrievalTopK: 10,
- *   minQualityScore: 0.7,
- *   enableReflection: true,
- *   maxReflectionIterations: 2,
- * };
- * ```
- */
-export interface RlmConfig {
-    /** Maximum recursion depth for sub-queries (default: 3) */
-    maxDepth?: number;
-    /** Maximum number of sub-queries per level (default: 5) */
-    maxSubQueries?: number;
-    /** Token budget for generation (default: 4096) */
-    tokenBudget?: number;
-    /** Enable response caching (default: true) */
-    enableCache?: boolean;
-    /** Cache TTL in milliseconds (default: 300000 = 5 minutes) */
-    cacheTtl?: number;
-    /** Number of memory spans to retrieve (default: 10) */
-    retrievalTopK?: number;
-    /** Minimum quality score to accept answer (default: 0.7) */
-    minQualityScore?: number;
-    /** Enable self-reflection loop (default: false) */
-    enableReflection?: boolean;
-    /** Maximum reflection iterations (default: 2) */
-    maxReflectionIterations?: number;
-}
-/**
- * Answer produced by the RLM controller
- *
- * @example
- * ```typescript
- * const answer: RlmAnswer = {
- *   text: 'Machine learning is a subset of artificial intelligence...',
- *   confidence: 0.92,
- *   qualityScore: 0.88,
- *   sources: [
- *     { id: 'mem-1', text: 'ML definition from textbook', similarityScore: 0.95, metadata: {} },
- *   ],
- *   subQueries: [
- *     { query: 'What is artificial intelligence?', answer: 'AI is...', depth: 1 },
- *   ],
- *   tokenUsage: { prompt: 512, completion: 256, total: 768 },
- *   cached: false,
- * };
- * ```
- */
-export interface RlmAnswer {
-    /** The generated answer text */
-    text: string;
-    /** Overall confidence in the answer (0.0 - 1.0) */
-    confidence: number;
-    /** Quality score based on source coverage and coherence (0.0 - 1.0) */
-    qualityScore: number;
-    /** Memory spans used to generate the answer */
-    sources: MemorySpan[];
-    /** Sub-queries generated and answered (if recursive) */
-    subQueries?: SubQuery[];
-    /** Token usage statistics */
-    tokenUsage: TokenUsage;
-    /** Whether this answer was served from cache */
-    cached: boolean;
-}
-/**
- * A span of memory retrieved for context
- *
- * @example
- * ```typescript
- * const span: MemorySpan = {
- *   id: 'mem-abc123',
- *   text: 'Relevant context from memory...',
- *   similarityScore: 0.89,
- *   source: 'documentation',
- *   metadata: { timestamp: Date.now(), category: 'technical' },
- * };
- * ```
- */
-export interface MemorySpan {
-    /** Unique identifier for the memory span */
-    id: string;
-    /** The text content of the memory span */
-    text: string;
-    /** Cosine similarity score to the query (0.0 - 1.0) */
-    similarityScore: number;
-    /** Optional source identifier (e.g., document name, URL) */
-    source?: string;
-    /** Additional metadata associated with this span */
-    metadata: Record<string, unknown>;
-}
-/**
- * A sub-query generated during recursive retrieval
- */
-export interface SubQuery {
-    /** The generated sub-query text */
-    query: string;
-    /** The answer to the sub-query */
-    answer: string;
-    /** Recursion depth at which this sub-query was generated */
-    depth: number;
-}
-/**
- * Token usage statistics for a query
- */
-export interface TokenUsage {
-    /** Tokens used in the prompt (including context) */
-    prompt: number;
-    /** Tokens generated in the completion */
-    completion: number;
-    /** Total tokens used (prompt + completion) */
-    total: number;
-}
-/**
- * Streaming token event
- *
- * Discriminated union for streaming responses:
- * - `type: 'token'` - A partial token was generated
- * - `type: 'done'` - Generation complete with final answer
- *
- * @example
- * ```typescript
- * for await (const event of controller.queryStream('What is AI?')) {
- *   if (event.type === 'token') {
- *     process.stdout.write(event.text);
- *   } else {
- *     console.log('\n\nFinal answer:', event.answer.text);
- *   }
- * }
- * ```
- */
-export type StreamToken = {
-    /** Token event type */
-    type: 'token';
-    /** The partial text token */
-    text: string;
-    /** Always false for token events */
-    done: false;
-} | {
-    /** Done event type */
-    type: 'done';
-    /** The complete answer */
-    answer: RlmAnswer;
-    /** Always true for done events */
-    done: true;
-};
-/**
- * Internal cache entry for RLM answers
- */
-export interface RlmCacheEntry {
-    /** The cached answer */
-    answer: RlmAnswer;
-    /** Timestamp when the entry was cached */
-    timestamp: number;
-    /** Query hash for cache key */
-    queryHash: string;
-}
-/**
- * Reflection result from self-evaluation loop
- */
-export interface ReflectionResult {
-    /** Whether the answer passed reflection criteria */
-    passed: boolean;
-    /** Critique of the current answer */
-    critique?: string;
-    /** Suggested improvements */
-    suggestions?: string[];
-    /** Updated quality score after reflection */
-    updatedScore: number;
-    /** Number of reflection iterations performed */
-    iterations: number;
-}
-//# sourceMappingURL=types.d.ts.map

package/dist/cjs/rlm/types.d.ts.map

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

package/dist/cjs/rlm/types.js

@@ -1,10 +0,0 @@
-"use strict";
-/**
- * RLM (Retrieval Language Model) Type Definitions
- *
- * Types for the recursive retrieval-augmented generation system
- * that breaks down complex queries into sub-queries and synthesizes
- * answers from retrieved memory spans.
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidHlwZXMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvcmxtL3R5cGVzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7O0dBTUciLCJzb3VyY2VzQ29udGVudCI6WyIvKipcbiAqIFJMTSAoUmV0cmlldmFsIExhbmd1YWdlIE1vZGVsKSBUeXBlIERlZmluaXRpb25zXG4gKlxuICogVHlwZXMgZm9yIHRoZSByZWN1cnNpdmUgcmV0cmlldmFsLWF1Z21lbnRlZCBnZW5lcmF0aW9uIHN5c3RlbVxuICogdGhhdCBicmVha3MgZG93biBjb21wbGV4IHF1ZXJpZXMgaW50byBzdWItcXVlcmllcyBhbmQgc3ludGhlc2l6ZXNcbiAqIGFuc3dlcnMgZnJvbSByZXRyaWV2ZWQgbWVtb3J5IHNwYW5zLlxuICovXG5cbi8qKlxuICogQ29uZmlndXJhdGlvbiBmb3IgdGhlIFJMTSBjb250cm9sbGVyXG4gKlxuICogQGV4YW1wbGVcbiAqIGBgYHR5cGVzY3JpcHRcbiAqIGNvbnN0IGNvbmZpZzogUmxtQ29uZmlnID0ge1xuICogICBtYXhEZXB0aDogMyxcbiAqICAgbWF4U3ViUXVlcmllczogNSxcbiAqICAgdG9rZW5CdWRnZXQ6IDQwOTYsXG4gKiAgIGVuYWJsZUNhY2hlOiB0cnVlLFxuICogICBjYWNoZVR0bDogMzAwMDAwLCAvLyA1IG1pbnV0ZXNcbiAqICAgcmV0cmlldmFsVG9wSzogMTAsXG4gKiAgIG1pblF1YWxpdHlTY29yZTogMC43LFxuICogICBlbmFibGVSZWZsZWN0aW9uOiB0cnVlLFxuICogICBtYXhSZWZsZWN0aW9uSXRlcmF0aW9uczogMixcbiAqIH07XG4gKiBgYGBcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBSbG1Db25maWcge1xuICAvKiogTWF4aW11bSByZWN1cnNpb24gZGVwdGggZm9yIHN1Yi1xdWVyaWVzIChkZWZhdWx0OiAzKSAqL1xuICBtYXhEZXB0aD86IG51bWJlcjtcblxuICAvKiogTWF4aW11bSBudW1iZXIgb2Ygc3ViLXF1ZXJpZXMgcGVyIGxldmVsIChkZWZhdWx0OiA1KSAqL1xuICBtYXhTdWJRdWVyaWVzPzogbnVtYmVyO1xuXG4gIC8qKiBUb2tlbiBidWRnZXQgZm9yIGdlbmVyYXRpb24gKGRlZmF1bHQ6IDQwOTYpICovXG4gIHRva2VuQnVkZ2V0PzogbnVtYmVyO1xuXG4gIC8qKiBFbmFibGUgcmVzcG9uc2UgY2FjaGluZyAoZGVmYXVsdDogdHJ1ZSkgKi9cbiAgZW5hYmxlQ2FjaGU/OiBib29sZWFuO1xuXG4gIC8qKiBDYWNoZSBUVEwgaW4gbWlsbGlzZWNvbmRzIChkZWZhdWx0OiAzMDAwMDAgPSA1IG1pbnV0ZXMpICovXG4gIGNhY2hlVHRsPzogbnVtYmVyO1xuXG4gIC8qKiBOdW1iZXIgb2YgbWVtb3J5IHNwYW5zIHRvIHJldHJpZXZlIChkZWZhdWx0OiAxMCkgKi9cbiAgcmV0cmlldmFsVG9wSz86IG51bWJlcjtcblxuICAvKiogTWluaW11bSBxdWFsaXR5IHNjb3JlIHRvIGFjY2VwdCBhbnN3ZXIgKGRlZmF1bHQ6IDAuNykgKi9cbiAgbWluUXVhbGl0eVNjb3JlPzogbnVtYmVyO1xuXG4gIC8qKiBFbmFibGUgc2VsZi1yZWZsZWN0aW9uIGxvb3AgKGRlZmF1bHQ6IGZhbHNlKSAqL1xuICBlbmFibGVSZWZsZWN0aW9uPzogYm9vbGVhbjtcblxuICAvKiogTWF4aW11bSByZWZsZWN0aW9uIGl0ZXJhdGlvbnMgKGRlZmF1bHQ6IDIpICovXG4gIG1heFJlZmxlY3Rpb25JdGVyYXRpb25zPzogbnVtYmVyO1xufVxuXG4vKipcbiAqIEFuc3dlciBwcm9kdWNlZCBieSB0aGUgUkxNIGNvbnRyb2xsZXJcbiAqXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3QgYW5zd2VyOiBSbG1BbnN3ZXIgPSB7XG4gKiAgIHRleHQ6ICdNYWNoaW5lIGxlYXJuaW5nIGlzIGEgc3Vic2V0IG9mIGFydGlmaWNpYWwgaW50ZWxsaWdlbmNlLi4uJyxcbiAqICAgY29uZmlkZW5jZTogMC45MixcbiAqICAgcXVhbGl0eVNjb3JlOiAwLjg4LFxuICogICBzb3VyY2VzOiBbXG4gKiAgICAgeyBpZDogJ21lbS0xJywgdGV4dDogJ01MIGRlZmluaXRpb24gZnJvbSB0ZXh0Ym9vaycsIHNpbWlsYXJpdHlTY29yZTogMC45NSwgbWV0YWRhdGE6IHt9IH0sXG4gKiAgIF0sXG4gKiAgIHN1YlF1ZXJpZXM6IFtcbiAqICAgICB7IHF1ZXJ5OiAnV2hhdCBpcyBhcnRpZmljaWFsIGludGVsbGlnZW5jZT8nLCBhbnN3ZXI6ICdBSSBpcy4uLicsIGRlcHRoOiAxIH0sXG4gKiAgIF0sXG4gKiAgIHRva2VuVXNhZ2U6IHsgcHJvbXB0OiA1MTIsIGNvbXBsZXRpb246IDI1NiwgdG90YWw6IDc2OCB9LFxuICogICBjYWNoZWQ6IGZhbHNlLFxuICogfTtcbiAqIGBgYFxuICovXG5leHBvcnQgaW50ZXJmYWNlIFJsbUFuc3dlciB7XG4gIC8qKiBUaGUgZ2VuZXJhdGVkIGFuc3dlciB0ZXh0ICovXG4gIHRleHQ6IHN0cmluZztcblxuICAvKiogT3ZlcmFsbCBjb25maWRlbmNlIGluIHRoZSBhbnN3ZXIgKDAuMCAtIDEuMCkgKi9cbiAgY29uZmlkZW5jZTogbnVtYmVyO1xuXG4gIC8qKiBRdWFsaXR5IHNjb3JlIGJhc2VkIG9uIHNvdXJjZSBjb3ZlcmFnZSBhbmQgY29oZXJlbmNlICgwLjAgLSAxLjApICovXG4gIHF1YWxpdHlTY29yZTogbnVtYmVyO1xuXG4gIC8qKiBNZW1vcnkgc3BhbnMgdXNlZCB0byBnZW5lcmF0ZSB0aGUgYW5zd2VyICovXG4gIHNvdXJjZXM6IE1lbW9yeVNwYW5bXTtcblxuICAvKiogU3ViLXF1ZXJpZXMgZ2VuZXJhdGVkIGFuZCBhbnN3ZXJlZCAoaWYgcmVjdXJzaXZlKSAqL1xuICBzdWJRdWVyaWVzPzogU3ViUXVlcnlbXTtcblxuICAvKiogVG9rZW4gdXNhZ2Ugc3RhdGlzdGljcyAqL1xuICB0b2tlblVzYWdlOiBUb2tlblVzYWdlO1xuXG4gIC8qKiBXaGV0aGVyIHRoaXMgYW5zd2VyIHdhcyBzZXJ2ZWQgZnJvbSBjYWNoZSAqL1xuICBjYWNoZWQ6IGJvb2xlYW47XG59XG5cbi8qKlxuICogQSBzcGFuIG9mIG1lbW9yeSByZXRyaWV2ZWQgZm9yIGNvbnRleHRcbiAqXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogY29uc3Qgc3BhbjogTWVtb3J5U3BhbiA9IHtcbiAqICAgaWQ6ICdtZW0tYWJjMTIzJyxcbiAqICAgdGV4dDogJ1JlbGV2YW50IGNvbnRleHQgZnJvbSBtZW1vcnkuLi4nLFxuICogICBzaW1pbGFyaXR5U2NvcmU6IDAuODksXG4gKiAgIHNvdXJjZTogJ2RvY3VtZW50YXRpb24nLFxuICogICBtZXRhZGF0YTogeyB0aW1lc3RhbXA6IERhdGUubm93KCksIGNhdGVnb3J5OiAndGVjaG5pY2FsJyB9LFxuICogfTtcbiAqIGBgYFxuICovXG5leHBvcnQgaW50ZXJmYWNlIE1lbW9yeVNwYW4ge1xuICAvKiogVW5pcXVlIGlkZW50aWZpZXIgZm9yIHRoZSBtZW1vcnkgc3BhbiAqL1xuICBpZDogc3RyaW5nO1xuXG4gIC8qKiBUaGUgdGV4dCBjb250ZW50IG9mIHRoZSBtZW1vcnkgc3BhbiAqL1xuICB0ZXh0OiBzdHJpbmc7XG5cbiAgLyoqIENvc2luZSBzaW1pbGFyaXR5IHNjb3JlIHRvIHRoZSBxdWVyeSAoMC4wIC0gMS4wKSAqL1xuICBzaW1pbGFyaXR5U2NvcmU6IG51bWJlcjtcblxuICAvKiogT3B0aW9uYWwgc291cmNlIGlkZW50aWZpZXIgKGUuZy4sIGRvY3VtZW50IG5hbWUsIFVSTCkgKi9cbiAgc291cmNlPzogc3RyaW5nO1xuXG4gIC8qKiBBZGRpdGlvbmFsIG1ldGFkYXRhIGFzc29jaWF0ZWQgd2l0aCB0aGlzIHNwYW4gKi9cbiAgbWV0YWRhdGE6IFJlY29yZDxzdHJpbmcsIHVua25vd24+O1xufVxuXG4vKipcbiAqIEEgc3ViLXF1ZXJ5IGdlbmVyYXRlZCBkdXJpbmcgcmVjdXJzaXZlIHJldHJpZXZhbFxuICovXG5leHBvcnQgaW50ZXJmYWNlIFN1YlF1ZXJ5IHtcbiAgLyoqIFRoZSBnZW5lcmF0ZWQgc3ViLXF1ZXJ5IHRleHQgKi9cbiAgcXVlcnk6IHN0cmluZztcblxuICAvKiogVGhlIGFuc3dlciB0byB0aGUgc3ViLXF1ZXJ5ICovXG4gIGFuc3dlcjogc3RyaW5nO1xuXG4gIC8qKiBSZWN1cnNpb24gZGVwdGggYXQgd2hpY2ggdGhpcyBzdWItcXVlcnkgd2FzIGdlbmVyYXRlZCAqL1xuICBkZXB0aDogbnVtYmVyO1xufVxuXG4vKipcbiAqIFRva2VuIHVzYWdlIHN0YXRpc3RpY3MgZm9yIGEgcXVlcnlcbiAqL1xuZXhwb3J0IGludGVyZmFjZSBUb2tlblVzYWdlIHtcbiAgLyoqIFRva2VucyB1c2VkIGluIHRoZSBwcm9tcHQgKGluY2x1ZGluZyBjb250ZXh0KSAqL1xuICBwcm9tcHQ6IG51bWJlcjtcblxuICAvKiogVG9rZW5zIGdlbmVyYXRlZCBpbiB0aGUgY29tcGxldGlvbiAqL1xuICBjb21wbGV0aW9uOiBudW1iZXI7XG5cbiAgLyoqIFRvdGFsIHRva2VucyB1c2VkIChwcm9tcHQgKyBjb21wbGV0aW9uKSAqL1xuICB0b3RhbDogbnVtYmVyO1xufVxuXG4vKipcbiAqIFN0cmVhbWluZyB0b2tlbiBldmVudFxuICpcbiAqIERpc2NyaW1pbmF0ZWQgdW5pb24gZm9yIHN0cmVhbWluZyByZXNwb25zZXM6XG4gKiAtIGB0eXBlOiAndG9rZW4nYCAtIEEgcGFydGlhbCB0b2tlbiB3YXMgZ2VuZXJhdGVkXG4gKiAtIGB0eXBlOiAnZG9uZSdgIC0gR2VuZXJhdGlvbiBjb21wbGV0ZSB3aXRoIGZpbmFsIGFuc3dlclxuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBmb3IgYXdhaXQgKGNvbnN0IGV2ZW50IG9mIGNvbnRyb2xsZXIucXVlcnlTdHJlYW0oJ1doYXQgaXMgQUk/JykpIHtcbiAqICAgaWYgKGV2ZW50LnR5cGUgPT09ICd0b2tlbicpIHtcbiAqICAgICBwcm9jZXNzLnN0ZG91dC53cml0ZShldmVudC50ZXh0KTtcbiAqICAgfSBlbHNlIHtcbiAqICAgICBjb25zb2xlLmxvZygnXFxuXFxuRmluYWwgYW5zd2VyOicsIGV2ZW50LmFuc3dlci50ZXh0KTtcbiAqICAgfVxuICogfVxuICogYGBgXG4gKi9cbmV4cG9ydCB0eXBlIFN0cmVhbVRva2VuID1cbiAgfCB7XG4gICAgICAvKiogVG9rZW4gZXZlbnQgdHlwZSAqL1xuICAgICAgdHlwZTogJ3Rva2VuJztcbiAgICAgIC8qKiBUaGUgcGFydGlhbCB0ZXh0IHRva2VuICovXG4gICAgICB0ZXh0OiBzdHJpbmc7XG4gICAgICAvKiogQWx3YXlzIGZhbHNlIGZvciB0b2tlbiBldmVudHMgKi9cbiAgICAgIGRvbmU6IGZhbHNlO1xuICAgIH1cbiAgfCB7XG4gICAgICAvKiogRG9uZSBldmVudCB0eXBlICovXG4gICAgICB0eXBlOiAnZG9uZSc7XG4gICAgICAvKiogVGhlIGNvbXBsZXRlIGFuc3dlciAqL1xuICAgICAgYW5zd2VyOiBSbG1BbnN3ZXI7XG4gICAgICAvKiogQWx3YXlzIHRydWUgZm9yIGRvbmUgZXZlbnRzICovXG4gICAgICBkb25lOiB0cnVlO1xuICAgIH07XG5cbi8qKlxuICogSW50ZXJuYWwgY2FjaGUgZW50cnkgZm9yIFJMTSBhbnN3ZXJzXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmxtQ2FjaGVFbnRyeSB7XG4gIC8qKiBUaGUgY2FjaGVkIGFuc3dlciAqL1xuICBhbnN3ZXI6IFJsbUFuc3dlcjtcblxuICAvKiogVGltZXN0YW1wIHdoZW4gdGhlIGVudHJ5IHdhcyBjYWNoZWQgKi9cbiAgdGltZXN0YW1wOiBudW1iZXI7XG5cbiAgLyoqIFF1ZXJ5IGhhc2ggZm9yIGNhY2hlIGtleSAqL1xuICBxdWVyeUhhc2g6IHN0cmluZztcbn1cblxuLyoqXG4gKiBSZWZsZWN0aW9uIHJlc3VsdCBmcm9tIHNlbGYtZXZhbHVhdGlvbiBsb29wXG4gKi9cbmV4cG9ydCBpbnRlcmZhY2UgUmVmbGVjdGlvblJlc3VsdCB7XG4gIC8qKiBXaGV0aGVyIHRoZSBhbnN3ZXIgcGFzc2VkIHJlZmxlY3Rpb24gY3JpdGVyaWEgKi9cbiAgcGFzc2VkOiBib29sZWFuO1xuXG4gIC8qKiBDcml0aXF1ZSBvZiB0aGUgY3VycmVudCBhbnN3ZXIgKi9cbiAgY3JpdGlxdWU/OiBzdHJpbmc7XG5cbiAgLyoqIFN1Z2dlc3RlZCBpbXByb3ZlbWVudHMgKi9cbiAgc3VnZ2VzdGlvbnM/OiBzdHJpbmdbXTtcblxuICAvKiogVXBkYXRlZCBxdWFsaXR5IHNjb3JlIGFmdGVyIHJlZmxlY3Rpb24gKi9cbiAgdXBkYXRlZFNjb3JlOiBudW1iZXI7XG5cbiAgLyoqIE51bWJlciBvZiByZWZsZWN0aW9uIGl0ZXJhdGlvbnMgcGVyZm9ybWVkICovXG4gIGl0ZXJhdGlvbnM6IG51bWJlcjtcbn1cbiJdfQ==

package/dist/esm/rlm/controller.d.ts

@@ -1,245 +0,0 @@
-/**
- * RLM Controller - Recursive Retrieval Language Model
- *
- * Implements a recursive retrieval-augmented generation system that:
- * 1. Breaks down complex queries into sub-queries
- * 2. Retrieves relevant memory spans for each query
- * 3. Synthesizes coherent answers from retrieved context
- * 4. Optionally reflects on and refines answers
- *
- * @example Basic Usage
- * ```typescript
- * import { RlmController } from '@ruvector/ruvllm';
- *
- * const rlm = new RlmController({
- *   maxDepth: 3,
- *   retrievalTopK: 10,
- *   enableCache: true,
- * });
- *
- * // Add knowledge to memory
- * await rlm.addMemory('Machine learning is a subset of AI that enables systems to learn from data.');
- * await rlm.addMemory('Deep learning uses neural networks with many layers.');
- *
- * // Query with recursive retrieval
- * const answer = await rlm.query('Explain the relationship between ML and deep learning');
- * console.log(answer.text);
- * console.log('Sources:', answer.sources.length);
- * console.log('Confidence:', answer.confidence);
- * ```
- *
- * @example Streaming
- * ```typescript
- * const rlm = new RlmController();
- *
- * for await (const event of rlm.queryStream('What is AI?')) {
- *   if (event.type === 'token') {
- *     process.stdout.write(event.text);
- *   } else {
- *     console.log('\n\nDone! Quality:', event.answer.qualityScore);
- *   }
- * }
- * ```
- *
- * @example With Reflection
- * ```typescript
- * const rlm = new RlmController({
- *   enableReflection: true,
- *   maxReflectionIterations: 2,
- *   minQualityScore: 0.8,
- * });
- *
- * const answer = await rlm.query('Complex multi-part question...');
- * // Answer will be iteratively refined until quality >= 0.8
- * ```
- */
-import { RlmConfig, RlmAnswer, MemorySpan, StreamToken } from './types.js';
-import { RuvLLM } from '../engine.js';
-/**
- * RlmController - Recursive Retrieval Language Model Controller
- *
- * Orchestrates retrieval-augmented generation with recursive sub-query
- * decomposition, memory search, and optional self-reflection.
- */
-export declare class RlmController {
-    private config;
-    private cache;
-    private engine;
-    private memoryIdCounter;
-    /**
-     * Create a new RLM controller
-     *
-     * @param config - Configuration options
-     * @param engine - Optional RuvLLM engine instance (creates new if not provided)
-     *
-     * @example
-     * ```typescript
-     * // With default config
-     * const rlm = new RlmController();
-     *
-     * // With custom config
-     * const rlm = new RlmController({
-     *   maxDepth: 5,
-     *   enableReflection: true,
-     * });
-     *
-     * // With existing engine
-     * const engine = new RuvLLM({ learningEnabled: true });
-     * const rlm = new RlmController({}, engine);
-     * ```
-     */
-    constructor(config?: RlmConfig, engine?: RuvLLM);
-    /**
-     * Query the RLM with recursive retrieval
-     *
-     * @param input - The query string
-     * @returns Promise resolving to the answer with sources and metadata
-     *
-     * @example
-     * ```typescript
-     * const answer = await rlm.query('What is the capital of France?');
-     * console.log(answer.text); // "The capital of France is Paris..."
-     * console.log(answer.confidence); // 0.95
-     * console.log(answer.sources); // [{ id: '...', text: '...', similarityScore: 0.92 }]
-     * ```
-     */
-    query(input: string): Promise<RlmAnswer>;
-    /**
-     * Query with streaming response
-     *
-     * @param input - The query string
-     * @yields StreamToken events (either partial tokens or final answer)
-     *
-     * @example
-     * ```typescript
-     * for await (const event of rlm.queryStream('Explain quantum computing')) {
-     *   if (event.type === 'token') {
-     *     // Partial token received
-     *     process.stdout.write(event.text);
-     *   } else {
-     *     // Generation complete
-     *     console.log('\n\nSources:', event.answer.sources.length);
-     *   }
-     * }
-     * ```
-     */
-    queryStream(input: string): AsyncGenerator<StreamToken>;
-    /**
-     * Add content to memory for retrieval
-     *
-     * @param text - The text content to store
-     * @param metadata - Optional metadata to associate with the memory
-     * @returns Promise resolving to the memory span ID
-     *
-     * @example
-     * ```typescript
-     * const id1 = await rlm.addMemory(
-     *   'TypeScript is a typed superset of JavaScript.',
-     *   { source: 'documentation', category: 'programming' }
-     * );
-     *
-     * const id2 = await rlm.addMemory(
-     *   'React is a JavaScript library for building UIs.'
-     * );
-     * ```
-     */
-    addMemory(text: string, metadata?: Record<string, unknown>): Promise<string>;
-    /**
-     * Search memory for relevant spans
-     *
-     * @param query - The search query
-     * @param topK - Number of results to return (default: config.retrievalTopK)
-     * @returns Promise resolving to array of memory spans
-     *
-     * @example
-     * ```typescript
-     * const spans = await rlm.searchMemory('JavaScript frameworks', 5);
-     * for (const span of spans) {
-     *   console.log(`[${span.similarityScore.toFixed(2)}] ${span.text}`);
-     * }
-     * ```
-     */
-    searchMemory(query: string, topK?: number): Promise<MemorySpan[]>;
-    /**
-     * Clear the response cache
-     *
-     * @example
-     * ```typescript
-     * rlm.clearCache();
-     * console.log('Cache cleared');
-     * ```
-     */
-    clearCache(): void;
-    /**
-     * Get current cache statistics
-     *
-     * @returns Object with cache size and hit rate info
-     */
-    getCacheStats(): {
-        size: number;
-        entries: number;
-    };
-    /**
-     * Update configuration at runtime
-     *
-     * @param config - Partial configuration to merge
-     */
-    updateConfig(config: Partial<RlmConfig>): void;
-    /**
-     * Get current configuration
-     */
-    getConfig(): Required<RlmConfig>;
-    /**
-     * Generate sub-queries for complex questions
-     */
-    private generateSubQueries;
-    /**
-     * Decompose a complex query into simpler parts
-     */
-    private decomposeQuery;
-    /**
-     * Build context string from sources and sub-queries
-     */
-    private buildContext;
-    /**
-     * Build the full prompt with context
-     */
-    private buildPrompt;
-    /**
-     * Get generation config based on RLM settings
-     */
-    private getGenerationConfig;
-    /**
-     * Estimate token usage
-     */
-    private estimateTokenUsage;
-    /**
-     * Calculate quality score based on sources and confidence
-     */
-    private calculateQualityScore;
-    /**
-     * Apply self-reflection to improve answer
-     */
-    private applyReflection;
-    /**
-     * Get cached answer if valid
-     */
-    private getCached;
-    /**
-     * Set cache entry
-     */
-    private setCache;
-    /**
-     * Simple hash function for cache keys
-     */
-    private hashQuery;
-    /**
-     * Prune expired cache entries
-     */
-    private pruneCache;
-    /**
-     * Utility delay function for streaming simulation
-     */
-    private delay;
-}
-//# sourceMappingURL=controller.d.ts.map

package/dist/esm/rlm/controller.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"controller.d.ts","sourceRoot":"","sources":["../../../src/rlm/controller.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAsDG;AAEH,OAAO,EACL,SAAS,EACT,SAAS,EACT,UAAU,EAGV,WAAW,EAGZ,MAAM,SAAS,CAAC;AAEjB,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAkBnC;;;;;GAKG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,MAAM,CAAsB;IACpC,OAAO,CAAC,KAAK,CAA6B;IAC1C,OAAO,CAAC,MAAM,CAAS;IACvB,OAAO,CAAC,eAAe,CAAS;IAEhC;;;;;;;;;;;;;;;;;;;;;OAqBG;gBACS,MAAM,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,EAAE,MAAM;IAO/C;;;;;;;;;;;;;OAaG;IACG,KAAK,CAAC,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,SAAS,CAAC;IAsD9C;;;;;;;;;;;;;;;;;;OAkBG;IACI,WAAW,CAAC,KAAK,EAAE,MAAM,GAAG,cAAc,CAAC,WAAW,CAAC;IA2D9D;;;;;;;;;;;;;;;;;;OAkBG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC;IAMlF;;;;;;;;;;;;;;OAcG;IACG,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,UAAU,EAAE,CAAC;IAavE;;;;;;;;OAQG;IACH,UAAU,IAAI,IAAI;IAIlB;;;;OAIG;IACH,aAAa,IAAI;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAA;KAAE;IAOlD;;;;OAIG;IACH,YAAY,CAAC,MAAM,EAAE,OAAO,CAAC,SAAS,CAAC,GAAG,IAAI;IAI9C;;OAEG;IACH,SAAS,IAAI,QAAQ,CAAC,SAAS,CAAC;IAQhC;;OAEG;YACW,kBAAkB;IAkChC;;OAEG;IACH,OAAO,CAAC,cAAc;IAyBtB;;OAEG;IACH,OAAO,CAAC,YAAY;IAuBpB;;OAEG;IACH,OAAO,CAAC,WAAW;IAQnB;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAQ3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAY1B;;OAEG;IACH,OAAO,CAAC,qBAAqB;IAY7B;;OAEG;YACW,eAAe;IA0D7B;;OAEG;IACH,OAAO,CAAC,SAAS;IAiBjB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAchB;;OAEG;IACH,OAAO,CAAC,SAAS;IAUjB;;OAEG;IACH,OAAO,CAAC,UAAU;IA0BlB;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}