@ruvector/ruvllm 0.2.3 → 2.4.0

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

@@ -0,0 +1,62 @@
+/**
+ * RLM - Retrieval Language Model
+ *
+ * A recursive retrieval-augmented generation system that combines
+ * memory search with intelligent query decomposition and synthesis.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { RlmController } from '@ruvector/ruvllm';
+ *
+ * const rlm = new RlmController({
+ *   maxDepth: 3,
+ *   enableCache: true,
+ *   retrievalTopK: 10,
+ * });
+ *
+ * // Add knowledge
+ * await rlm.addMemory('TypeScript adds static typing to JavaScript.');
+ * await rlm.addMemory('React is a library for building user interfaces.');
+ *
+ * // Query with retrieval
+ * const answer = await rlm.query('Compare TypeScript and JavaScript');
+ * console.log(answer.text);
+ * console.log('Confidence:', answer.confidence);
+ * console.log('Sources:', answer.sources.length);
+ * ```
+ *
+ * @example Streaming
+ * ```typescript
+ * import { RlmController } from '@ruvector/ruvllm';
+ *
+ * const rlm = new RlmController();
+ *
+ * for await (const event of rlm.queryStream('Explain machine learning')) {
+ *   if (event.type === 'token') {
+ *     process.stdout.write(event.text);
+ *   } else {
+ *     console.log('\n\nQuality:', event.answer.qualityScore);
+ *   }
+ * }
+ * ```
+ *
+ * @example With Reflection
+ * ```typescript
+ * import { RlmController } from '@ruvector/ruvllm';
+ *
+ * const rlm = new RlmController({
+ *   enableReflection: true,
+ *   maxReflectionIterations: 2,
+ *   minQualityScore: 0.8,
+ * });
+ *
+ * // Answers will be iteratively refined until quality >= 0.8
+ * const answer = await rlm.query('Complex technical question...');
+ * ```
+ *
+ * @module rlm
+ */
+export * from './types';
+export { RlmController } from './controller';
+export { type DecompositionStrategy, type SubQuery, type QueryDecomposition, type SubAnswer, type RlmTrajectoryMetadata, type RlmTrainingExample, type ContrastivePair, type RlmTrainingConfig, type TrainingResult as RlmTrainingResult, type EvaluationResult as RlmEvaluationResult, DEFAULT_RLM_CONFIG, FAST_RLM_CONFIG, THOROUGH_RLM_CONFIG, ROUTING_FOCUSED_CONFIG, AGENT_DEFINITIONS, HARD_NEGATIVE_PAIRS, RlmTrainer, createRlmTrainer, createEmptyExample, createSubQuery, createSubAnswer, } from './training';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/rlm/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAyDG;AAGH,cAAc,SAAS,CAAC;AAGxB,OAAO,EAAE,aAAa,EAAE,MAAM,cAAc,CAAC;AAG7C,OAAO,EAEL,KAAK,qBAAqB,EAC1B,KAAK,QAAQ,EACb,KAAK,kBAAkB,EACvB,KAAK,SAAS,EACd,KAAK,qBAAqB,EAC1B,KAAK,kBAAkB,EACvB,KAAK,eAAe,EACpB,KAAK,iBAAiB,EACtB,KAAK,cAAc,IAAI,iBAAiB,EACxC,KAAK,gBAAgB,IAAI,mBAAmB,EAG5C,kBAAkB,EAClB,eAAe,EACf,mBAAmB,EACnB,sBAAsB,EACtB,iBAAiB,EACjB,mBAAmB,EAGnB,UAAU,EAGV,gBAAgB,EAChB,kBAAkB,EAClB,cAAc,EACd,eAAe,GAChB,MAAM,YAAY,CAAC"}

package/dist/cjs/rlm/index.js

@@ -0,0 +1,97 @@
+"use strict";
+/**
+ * RLM - Retrieval Language Model
+ *
+ * A recursive retrieval-augmented generation system that combines
+ * memory search with intelligent query decomposition and synthesis.
+ *
+ * @example Basic Usage
+ * ```typescript
+ * import { RlmController } from '@ruvector/ruvllm';
+ *
+ * const rlm = new RlmController({
+ *   maxDepth: 3,
+ *   enableCache: true,
+ *   retrievalTopK: 10,
+ * });
+ *
+ * // Add knowledge
+ * await rlm.addMemory('TypeScript adds static typing to JavaScript.');
+ * await rlm.addMemory('React is a library for building user interfaces.');
+ *
+ * // Query with retrieval
+ * const answer = await rlm.query('Compare TypeScript and JavaScript');
+ * console.log(answer.text);
+ * console.log('Confidence:', answer.confidence);
+ * console.log('Sources:', answer.sources.length);
+ * ```
+ *
+ * @example Streaming
+ * ```typescript
+ * import { RlmController } from '@ruvector/ruvllm';
+ *
+ * const rlm = new RlmController();
+ *
+ * for await (const event of rlm.queryStream('Explain machine learning')) {
+ *   if (event.type === 'token') {
+ *     process.stdout.write(event.text);
+ *   } else {
+ *     console.log('\n\nQuality:', event.answer.qualityScore);
+ *   }
+ * }
+ * ```
+ *
+ * @example With Reflection
+ * ```typescript
+ * import { RlmController } from '@ruvector/ruvllm';
+ *
+ * const rlm = new RlmController({
+ *   enableReflection: true,
+ *   maxReflectionIterations: 2,
+ *   minQualityScore: 0.8,
+ * });
+ *
+ * // Answers will be iteratively refined until quality >= 0.8
+ * const answer = await rlm.query('Complex technical question...');
+ * ```
+ *
+ * @module rlm
+ */
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createSubAnswer = exports.createSubQuery = exports.createEmptyExample = exports.createRlmTrainer = exports.RlmTrainer = exports.HARD_NEGATIVE_PAIRS = exports.AGENT_DEFINITIONS = exports.ROUTING_FOCUSED_CONFIG = exports.THOROUGH_RLM_CONFIG = exports.FAST_RLM_CONFIG = exports.DEFAULT_RLM_CONFIG = exports.RlmController = void 0;
+// Export all types
+__exportStar(require("./types"), exports);
+// Export the controller
+var controller_1 = require("./controller");
+Object.defineProperty(exports, "RlmController", { enumerable: true, get: function () { return controller_1.RlmController; } });
+// Export training module
+var training_1 = require("./training");
+// Constants
+Object.defineProperty(exports, "DEFAULT_RLM_CONFIG", { enumerable: true, get: function () { return training_1.DEFAULT_RLM_CONFIG; } });
+Object.defineProperty(exports, "FAST_RLM_CONFIG", { enumerable: true, get: function () { return training_1.FAST_RLM_CONFIG; } });
+Object.defineProperty(exports, "THOROUGH_RLM_CONFIG", { enumerable: true, get: function () { return training_1.THOROUGH_RLM_CONFIG; } });
+Object.defineProperty(exports, "ROUTING_FOCUSED_CONFIG", { enumerable: true, get: function () { return training_1.ROUTING_FOCUSED_CONFIG; } });
+Object.defineProperty(exports, "AGENT_DEFINITIONS", { enumerable: true, get: function () { return training_1.AGENT_DEFINITIONS; } });
+Object.defineProperty(exports, "HARD_NEGATIVE_PAIRS", { enumerable: true, get: function () { return training_1.HARD_NEGATIVE_PAIRS; } });
+// Classes
+Object.defineProperty(exports, "RlmTrainer", { enumerable: true, get: function () { return training_1.RlmTrainer; } });
+// Factory functions
+Object.defineProperty(exports, "createRlmTrainer", { enumerable: true, get: function () { return training_1.createRlmTrainer; } });
+Object.defineProperty(exports, "createEmptyExample", { enumerable: true, get: function () { return training_1.createEmptyExample; } });
+Object.defineProperty(exports, "createSubQuery", { enumerable: true, get: function () { return training_1.createSubQuery; } });
+Object.defineProperty(exports, "createSubAnswer", { enumerable: true, get: function () { return training_1.createSubAnswer; } });
+//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoiaW5kZXguanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi9zcmMvcmxtL2luZGV4LnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiI7QUFBQTs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBeURHOzs7Ozs7Ozs7Ozs7Ozs7OztBQUVILG1CQUFtQjtBQUNuQiwwQ0FBd0I7QUFFeEIsd0JBQXdCO0FBQ3hCLDJDQUE2QztBQUFwQywyR0FBQSxhQUFhLE9BQUE7QUFFdEIseUJBQXlCO0FBQ3pCLHVDQTZCb0I7QUFoQmxCLFlBQVk7QUFDWiw4R0FBQSxrQkFBa0IsT0FBQTtBQUNsQiwyR0FBQSxlQUFlLE9BQUE7QUFDZiwrR0FBQSxtQkFBbUIsT0FBQTtBQUNuQixrSEFBQSxzQkFBc0IsT0FBQTtBQUN0Qiw2R0FBQSxpQkFBaUIsT0FBQTtBQUNqQiwrR0FBQSxtQkFBbUIsT0FBQTtBQUVuQixVQUFVO0FBQ1Ysc0dBQUEsVUFBVSxPQUFBO0FBRVYsb0JBQW9CO0FBQ3BCLDRHQUFBLGdCQUFnQixPQUFBO0FBQ2hCLDhHQUFBLGtCQUFrQixPQUFBO0FBQ2xCLDBHQUFBLGNBQWMsT0FBQTtBQUNkLDJHQUFBLGVBQWUsT0FBQSIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogUkxNIC0gUmV0cmlldmFsIExhbmd1YWdlIE1vZGVsXG4gKlxuICogQSByZWN1cnNpdmUgcmV0cmlldmFsLWF1Z21lbnRlZCBnZW5lcmF0aW9uIHN5c3RlbSB0aGF0IGNvbWJpbmVzXG4gKiBtZW1vcnkgc2VhcmNoIHdpdGggaW50ZWxsaWdlbnQgcXVlcnkgZGVjb21wb3NpdGlvbiBhbmQgc3ludGhlc2lzLlxuICpcbiAqIEBleGFtcGxlIEJhc2ljIFVzYWdlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBpbXBvcnQgeyBSbG1Db250cm9sbGVyIH0gZnJvbSAnQHJ1dmVjdG9yL3J1dmxsbSc7XG4gKlxuICogY29uc3QgcmxtID0gbmV3IFJsbUNvbnRyb2xsZXIoe1xuICogICBtYXhEZXB0aDogMyxcbiAqICAgZW5hYmxlQ2FjaGU6IHRydWUsXG4gKiAgIHJldHJpZXZhbFRvcEs6IDEwLFxuICogfSk7XG4gKlxuICogLy8gQWRkIGtub3dsZWRnZVxuICogYXdhaXQgcmxtLmFkZE1lbW9yeSgnVHlwZVNjcmlwdCBhZGRzIHN0YXRpYyB0eXBpbmcgdG8gSmF2YVNjcmlwdC4nKTtcbiAqIGF3YWl0IHJsbS5hZGRNZW1vcnkoJ1JlYWN0IGlzIGEgbGlicmFyeSBmb3IgYnVpbGRpbmcgdXNlciBpbnRlcmZhY2VzLicpO1xuICpcbiAqIC8vIFF1ZXJ5IHdpdGggcmV0cmlldmFsXG4gKiBjb25zdCBhbnN3ZXIgPSBhd2FpdCBybG0ucXVlcnkoJ0NvbXBhcmUgVHlwZVNjcmlwdCBhbmQgSmF2YVNjcmlwdCcpO1xuICogY29uc29sZS5sb2coYW5zd2VyLnRleHQpO1xuICogY29uc29sZS5sb2coJ0NvbmZpZGVuY2U6JywgYW5zd2VyLmNvbmZpZGVuY2UpO1xuICogY29uc29sZS5sb2coJ1NvdXJjZXM6JywgYW5zd2VyLnNvdXJjZXMubGVuZ3RoKTtcbiAqIGBgYFxuICpcbiAqIEBleGFtcGxlIFN0cmVhbWluZ1xuICogYGBgdHlwZXNjcmlwdFxuICogaW1wb3J0IHsgUmxtQ29udHJvbGxlciB9IGZyb20gJ0BydXZlY3Rvci9ydXZsbG0nO1xuICpcbiAqIGNvbnN0IHJsbSA9IG5ldyBSbG1Db250cm9sbGVyKCk7XG4gKlxuICogZm9yIGF3YWl0IChjb25zdCBldmVudCBvZiBybG0ucXVlcnlTdHJlYW0oJ0V4cGxhaW4gbWFjaGluZSBsZWFybmluZycpKSB7XG4gKiAgIGlmIChldmVudC50eXBlID09PSAndG9rZW4nKSB7XG4gKiAgICAgcHJvY2Vzcy5zdGRvdXQud3JpdGUoZXZlbnQudGV4dCk7XG4gKiAgIH0gZWxzZSB7XG4gKiAgICAgY29uc29sZS5sb2coJ1xcblxcblF1YWxpdHk6JywgZXZlbnQuYW5zd2VyLnF1YWxpdHlTY29yZSk7XG4gKiAgIH1cbiAqIH1cbiAqIGBgYFxuICpcbiAqIEBleGFtcGxlIFdpdGggUmVmbGVjdGlvblxuICogYGBgdHlwZXNjcmlwdFxuICogaW1wb3J0IHsgUmxtQ29udHJvbGxlciB9IGZyb20gJ0BydXZlY3Rvci9ydXZsbG0nO1xuICpcbiAqIGNvbnN0IHJsbSA9IG5ldyBSbG1Db250cm9sbGVyKHtcbiAqICAgZW5hYmxlUmVmbGVjdGlvbjogdHJ1ZSxcbiAqICAgbWF4UmVmbGVjdGlvbkl0ZXJhdGlvbnM6IDIsXG4gKiAgIG1pblF1YWxpdHlTY29yZTogMC44LFxuICogfSk7XG4gKlxuICogLy8gQW5zd2VycyB3aWxsIGJlIGl0ZXJhdGl2ZWx5IHJlZmluZWQgdW50aWwgcXVhbGl0eSA+PSAwLjhcbiAqIGNvbnN0IGFuc3dlciA9IGF3YWl0IHJsbS5xdWVyeSgnQ29tcGxleCB0ZWNobmljYWwgcXVlc3Rpb24uLi4nKTtcbiAqIGBgYFxuICpcbiAqIEBtb2R1bGUgcmxtXG4gKi9cblxuLy8gRXhwb3J0IGFsbCB0eXBlc1xuZXhwb3J0ICogZnJvbSAnLi90eXBlcyc7XG5cbi8vIEV4cG9ydCB0aGUgY29udHJvbGxlclxuZXhwb3J0IHsgUmxtQ29udHJvbGxlciB9IGZyb20gJy4vY29udHJvbGxlcic7XG5cbi8vIEV4cG9ydCB0cmFpbmluZyBtb2R1bGVcbmV4cG9ydCB7XG4gIC8vIFR5cGVzXG4gIHR5cGUgRGVjb21wb3NpdGlvblN0cmF0ZWd5LFxuICB0eXBlIFN1YlF1ZXJ5LFxuICB0eXBlIFF1ZXJ5RGVjb21wb3NpdGlvbixcbiAgdHlwZSBTdWJBbnN3ZXIsXG4gIHR5cGUgUmxtVHJhamVjdG9yeU1ldGFkYXRhLFxuICB0eXBlIFJsbVRyYWluaW5nRXhhbXBsZSxcbiAgdHlwZSBDb250cmFzdGl2ZVBhaXIsXG4gIHR5cGUgUmxtVHJhaW5pbmdDb25maWcsXG4gIHR5cGUgVHJhaW5pbmdSZXN1bHQgYXMgUmxtVHJhaW5pbmdSZXN1bHQsXG4gIHR5cGUgRXZhbHVhdGlvblJlc3VsdCBhcyBSbG1FdmFsdWF0aW9uUmVzdWx0LFxuXG4gIC8vIENvbnN0YW50c1xuICBERUZBVUxUX1JMTV9DT05GSUcsXG4gIEZBU1RfUkxNX0NPTkZJRyxcbiAgVEhPUk9VR0hfUkxNX0NPTkZJRyxcbiAgUk9VVElOR19GT0NVU0VEX0NPTkZJRyxcbiAgQUdFTlRfREVGSU5JVElPTlMsXG4gIEhBUkRfTkVHQVRJVkVfUEFJUlMsXG5cbiAgLy8gQ2xhc3Nlc1xuICBSbG1UcmFpbmVyLFxuXG4gIC8vIEZhY3RvcnkgZnVuY3Rpb25zXG4gIGNyZWF0ZVJsbVRyYWluZXIsXG4gIGNyZWF0ZUVtcHR5RXhhbXBsZSxcbiAgY3JlYXRlU3ViUXVlcnksXG4gIGNyZWF0ZVN1YkFuc3dlcixcbn0gZnJvbSAnLi90cmFpbmluZyc7XG4iXX0=

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

@@ -0,0 +1,333 @@
+/**
+ * RLM (Recursive Learning Machine) Training Module
+ *
+ * Provides training capabilities for RuvLTRA models on RLM task routing
+ * and decomposition, including query decomposition, answer synthesis,
+ * and agent routing optimization.
+ *
+ * @module rlm/training
+ */
+/**
+ * Strategy for decomposing a complex query
+ */
+export type DecompositionStrategy = 'sequential' | 'parallel' | 'hierarchical' | 'dag-based' | 'iterative' | 'none';
+/**
+ * A sub-query in the decomposition
+ */
+export interface SubQuery {
+    /** Unique identifier within the decomposition */
+    id: number;
+    /** The sub-query text */
+    query: string;
+    /** Expected output type (e.g., "code", "analysis", "data") */
+    expectedType: string;
+    /** Dependencies (IDs of sub-queries that must complete first) */
+    dependencies: number[];
+    /** Recommended agent type for this sub-query */
+    recommendedAgent?: string;
+    /** Estimated complexity (0.0-1.0) */
+    complexity: number;
+    /** Optional context from parent query */
+    context?: string;
+}
+/**
+ * Decomposition of a complex query into sub-queries
+ */
+export interface QueryDecomposition {
+    /** Sub-queries in execution order */
+    subQueries: SubQuery[];
+    /** Decomposition strategy used */
+    strategy: DecompositionStrategy;
+    /** Reasoning for this decomposition */
+    rationale: string;
+    /** Total estimated complexity */
+    totalComplexity: number;
+    /** Whether decomposition was successful */
+    success: boolean;
+    /** Error message if decomposition failed */
+    error?: string;
+}
+/**
+ * Answer to a sub-query
+ */
+export interface SubAnswer {
+    /** ID of the sub-query this answers */
+    subQueryId: number;
+    /** The answer content */
+    content: string;
+    /** Confidence in this answer (0.0-1.0) */
+    confidence: number;
+    /** Agent that produced this answer */
+    agent: string;
+    /** Latency in milliseconds */
+    latencyMs: number;
+    /** Quality score (0.0-1.0) */
+    quality: number;
+    /** Whether this answer was successful */
+    success: boolean;
+    /** Error message if failed */
+    error?: string;
+    /** Intermediate reasoning/chain-of-thought */
+    reasoning?: string;
+}
+/**
+ * Metadata about the RLM execution trajectory
+ */
+export interface RlmTrajectoryMetadata {
+    /** Session ID */
+    sessionId?: string;
+    /** User ID */
+    userId?: string;
+    /** Total latency in milliseconds */
+    totalLatencyMs: number;
+    /** Number of retries */
+    retries: number;
+    /** Maximum parallel branches executed */
+    maxParallelism: number;
+    /** Models used during execution */
+    modelsUsed: string[];
+    /** Agents invoked */
+    agentsInvoked: string[];
+    /** Tools used */
+    toolsUsed: string[];
+    /** Custom attributes */
+    attributes: Record<string, string>;
+}
+/**
+ * A complete RLM training example
+ */
+export interface RlmTrainingExample {
+    /** Unique identifier */
+    id: string;
+    /** Original complex query */
+    query: string;
+    /** Query embedding (optional) */
+    queryEmbedding?: number[];
+    /** How the query was decomposed */
+    decomposition: QueryDecomposition;
+    /** Answers to each sub-query */
+    subAnswers: SubAnswer[];
+    /** Final synthesized answer */
+    finalAnswer: string;
+    /** Final answer embedding (optional) */
+    finalEmbedding?: number[];
+    /** Overall quality score (0.0-1.0) */
+    qualityScore: number;
+    /** Execution trajectory metadata */
+    trajectory: RlmTrajectoryMetadata;
+    /** Whether this example was successful */
+    success: boolean;
+    /** Lessons learned from this example */
+    lessons: string[];
+    /** Source of this example */
+    source: string;
+}
+/**
+ * A contrastive pair for agent routing training
+ */
+export interface ContrastivePair {
+    /** Anchor query */
+    anchor: string;
+    /** Anchor embedding (optional) */
+    anchorEmbedding?: number[];
+    /** Positive agent (correct routing) */
+    positiveAgent: string;
+    /** Negative agent (incorrect routing) */
+    negativeAgent: string;
+    /** Whether this is a hard negative */
+    isHardNegative: boolean;
+    /** Quality score of the anchor example */
+    quality: number;
+    /** Source example ID */
+    sourceId: string;
+}
+/**
+ * Configuration for RLM training
+ */
+export interface RlmTrainingConfig {
+    /** Learning rate for decomposition training */
+    decompositionLr: number;
+    /** Learning rate for synthesis training */
+    synthesisLr: number;
+    /** Learning rate for contrastive fine-tuning */
+    contrastiveLr: number;
+    /** Batch size */
+    batchSize: number;
+    /** Number of epochs */
+    epochs: number;
+    /** Contrastive margin for triplet loss */
+    contrastiveMargin: number;
+    /** Temperature for InfoNCE loss */
+    infonceTemperature: number;
+    /** Weight for decomposition loss */
+    decompositionWeight: number;
+    /** Weight for synthesis loss */
+    synthesisWeight: number;
+    /** Weight for routing loss */
+    routingWeight: number;
+    /** Minimum quality for updates */
+    qualityThreshold: number;
+    /** Evaluation interval (epochs) */
+    evaluationInterval: number;
+    /** Warmup steps */
+    warmupSteps: number;
+    /** Early stopping patience */
+    earlyStoppingPatience: number;
+    /** Validation split ratio */
+    validationSplit: number;
+    /** Random seed */
+    seed: number;
+}
+/**
+ * Training result for a phase
+ */
+export interface TrainingResult {
+    /** Training phase name */
+    phase: string;
+    /** Epochs completed */
+    epochsCompleted: number;
+    /** Total steps */
+    totalSteps: number;
+    /** Final training loss */
+    finalLoss: number;
+    /** Best validation loss */
+    bestValLoss: number;
+    /** Best epoch */
+    bestEpoch: number;
+    /** Final accuracy (for classification tasks) */
+    accuracy: number;
+    /** Loss history per epoch */
+    lossHistory: number[];
+    /** Validation loss history */
+    valLossHistory: number[];
+    /** Training duration in milliseconds */
+    durationMs: number;
+    /** Whether early stopping was triggered */
+    earlyStopped: boolean;
+}
+/**
+ * Evaluation result for the trained model
+ */
+export interface EvaluationResult {
+    /** Decomposition accuracy */
+    decompositionAccuracy: number;
+    /** Synthesis quality */
+    synthesisQuality: number;
+    /** Routing accuracy */
+    routingAccuracy: number;
+    /** Hard negative accuracy */
+    hardNegativeAccuracy: number;
+    /** Average latency in ms */
+    avgLatencyMs: number;
+    /** Total examples evaluated */
+    totalExamples: number;
+    /** Per-agent accuracy */
+    perAgentAccuracy: Record<string, number>;
+}
+/**
+ * Default RLM training configuration
+ */
+export declare const DEFAULT_RLM_CONFIG: RlmTrainingConfig;
+/**
+ * Fast training configuration
+ */
+export declare const FAST_RLM_CONFIG: RlmTrainingConfig;
+/**
+ * Thorough training configuration
+ */
+export declare const THOROUGH_RLM_CONFIG: RlmTrainingConfig;
+/**
+ * Routing-focused training configuration
+ */
+export declare const ROUTING_FOCUSED_CONFIG: RlmTrainingConfig;
+/**
+ * Agent types with descriptions and keywords
+ */
+export declare const AGENT_DEFINITIONS: Record<string, {
+    description: string;
+    keywords: string[];
+}>;
+/**
+ * Hard negative pairs (confusable agent combinations)
+ */
+export declare const HARD_NEGATIVE_PAIRS: [string, string][];
+/**
+ * RLM Trainer for RuvLTRA models
+ *
+ * Provides training capabilities for decomposition, synthesis, and routing tasks.
+ */
+export declare class RlmTrainer {
+    private config;
+    private currentEpoch;
+    private currentStep;
+    private bestValLoss;
+    private patienceCounter;
+    private lossHistory;
+    private valLossHistory;
+    /**
+     * Create a new RLM trainer
+     */
+    constructor(config?: Partial<RlmTrainingConfig>);
+    /**
+     * Train on decomposition task
+     *
+     * Learns to break complex queries into manageable sub-queries.
+     */
+    trainDecomposition(dataset: RlmTrainingExample[]): Promise<TrainingResult>;
+    /**
+     * Train on synthesis task
+     *
+     * Learns to combine sub-answers into coherent final responses.
+     */
+    trainSynthesis(dataset: RlmTrainingExample[]): Promise<TrainingResult>;
+    /**
+     * Contrastive fine-tuning for agent routing
+     *
+     * Uses triplet loss and InfoNCE to improve routing accuracy.
+     */
+    trainContrastive(pairs: ContrastivePair[]): Promise<TrainingResult>;
+    /**
+     * Evaluate trained model on test set
+     */
+    evaluate(testSet: RlmTrainingExample[]): Promise<EvaluationResult>;
+    /**
+     * Generate contrastive pairs from dataset
+     */
+    generateContrastivePairs(dataset: RlmTrainingExample[], hardNegativeRatio?: number): ContrastivePair[];
+    private resetState;
+    private splitDataset;
+    private splitPairs;
+    private createBatches;
+    private createPairBatches;
+    private shuffle;
+    private trainDecompositionBatch;
+    private trainSynthesisBatch;
+    private trainContrastiveBatch;
+    private validateDecomposition;
+    private validateSynthesis;
+    private validateContrastive;
+    private computeTripletLoss;
+    private computeInfoNCELoss;
+    private agentDistance;
+    private predictAgent;
+    private isHardNegative;
+    private findBestEpoch;
+}
+/**
+ * Create an RLM trainer with default configuration
+ */
+export declare function createRlmTrainer(config?: Partial<RlmTrainingConfig>): RlmTrainer;
+/**
+ * Create an empty RLM training example
+ */
+export declare function createEmptyExample(query: string): RlmTrainingExample;
+/**
+ * Create a sub-query
+ */
+export declare function createSubQuery(id: number, query: string, options?: Partial<SubQuery>): SubQuery;
+/**
+ * Create a sub-answer
+ */
+export declare function createSubAnswer(subQueryId: number, content: string, agent: string, options?: Partial<SubAnswer>): SubAnswer;
+export default RlmTrainer;
+//# sourceMappingURL=training.d.ts.map

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

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