@ruvector/ruvllm 2.7.0 → 4.0.0

package/dist/cjs/streaming.d.ts

@@ -1,55 +0,0 @@
-/**
- * Streaming response support for RuvLLM
- */
-import { StreamChunk, StreamOptions, QueryResponse, GenerationConfig } from './types';
-/**
- * Async generator for streaming responses
- *
- * @example
- * ```typescript
- * import { RuvLLM, StreamingGenerator } from '@ruvector/ruvllm';
- *
- * const llm = new RuvLLM();
- * const streamer = new StreamingGenerator(llm);
- *
- * // Stream with async iterator
- * for await (const chunk of streamer.stream('Write a story')) {
- *   process.stdout.write(chunk.text);
- * }
- *
- * // Stream with callbacks
- * await streamer.streamWithCallbacks('Write a poem', {
- *   onChunk: (chunk) => console.log(chunk.text),
- *   onComplete: (response) => console.log('Done!', response.latencyMs),
- * });
- * ```
- */
-export declare class StreamingGenerator {
-    private llm;
-    constructor(llm: {
-        generate: (prompt: string, config?: GenerationConfig) => string;
-        query: (text: string, config?: GenerationConfig) => QueryResponse;
-    });
-    /**
-     * Stream response as async generator
-     *
-     * Note: This simulates streaming by chunking the full response.
-     * Native streaming requires native module support.
-     */
-    stream(prompt: string, config?: GenerationConfig): AsyncGenerator<StreamChunk>;
-    /**
-     * Stream with callback handlers
-     */
-    streamWithCallbacks(prompt: string, options: StreamOptions): Promise<QueryResponse>;
-    /**
-     * Collect stream into single response
-     */
-    collect(prompt: string, config?: GenerationConfig): Promise<string>;
-    private delay;
-}
-/**
- * Create a readable stream from response
- * (For Node.js stream compatibility)
- */
-export declare function createReadableStream(generator: AsyncGenerator<StreamChunk>): ReadableStream<string>;
-//# sourceMappingURL=streaming.d.ts.map

package/dist/cjs/streaming.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"streaming.d.ts","sourceRoot":"","sources":["../../src/streaming.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EACL,WAAW,EACX,aAAa,EACb,aAAa,EACb,gBAAgB,EACjB,MAAM,SAAS,CAAC;AAEjB;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,GAAG,CAGT;gBAEU,GAAG,EAAE;QACf,QAAQ,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,KAAK,MAAM,CAAC;QAChE,KAAK,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,KAAK,aAAa,CAAC;KACnE;IAID;;;;;OAKG;IACI,MAAM,CACX,MAAM,EAAE,MAAM,EACd,MAAM,CAAC,EAAE,gBAAgB,GACxB,cAAc,CAAC,WAAW,CAAC;IA8B9B;;OAEG;IACG,mBAAmB,CACvB,MAAM,EAAE,MAAM,EACd,OAAO,EAAE,aAAa,GACrB,OAAO,CAAC,aAAa,CAAC;IAqCzB;;OAEG;IACG,OAAO,CAAC,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,gBAAgB,GAAG,OAAO,CAAC,MAAM,CAAC;IAQzE,OAAO,CAAC,KAAK;CAGd;AAED;;;GAGG;AACH,wBAAgB,oBAAoB,CAClC,SAAS,EAAE,cAAc,CAAC,WAAW,CAAC,GACrC,cAAc,CAAC,MAAM,CAAC,CAWxB"}

package/dist/cjs/streaming.js

@@ -1,131 +0,0 @@
-"use strict";
-/**
- * Streaming response support for RuvLLM
- */
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.StreamingGenerator = void 0;
-exports.createReadableStream = createReadableStream;
-/**
- * Async generator for streaming responses
- *
- * @example
- * ```typescript
- * import { RuvLLM, StreamingGenerator } from '@ruvector/ruvllm';
- *
- * const llm = new RuvLLM();
- * const streamer = new StreamingGenerator(llm);
- *
- * // Stream with async iterator
- * for await (const chunk of streamer.stream('Write a story')) {
- *   process.stdout.write(chunk.text);
- * }
- *
- * // Stream with callbacks
- * await streamer.streamWithCallbacks('Write a poem', {
- *   onChunk: (chunk) => console.log(chunk.text),
- *   onComplete: (response) => console.log('Done!', response.latencyMs),
- * });
- * ```
- */
-class StreamingGenerator {
-    constructor(llm) {
-        this.llm = llm;
-    }
-    /**
-     * Stream response as async generator
-     *
-     * Note: This simulates streaming by chunking the full response.
-     * Native streaming requires native module support.
-     */
-    async *stream(prompt, config) {
-        const start = Date.now();
-        // Generate full response (native streaming would yield real chunks)
-        const fullText = this.llm.generate(prompt, config);
-        // Simulate streaming by yielding words
-        const words = fullText.split(/(\s+)/);
-        let accumulated = '';
-        let tokenCount = 0;
-        for (let i = 0; i < words.length; i++) {
-            accumulated += words[i];
-            tokenCount++;
-            // Yield every few tokens or at end
-            if (tokenCount % 3 === 0 || i === words.length - 1) {
-                yield {
-                    text: words.slice(Math.max(0, i - 2), i + 1).join(''),
-                    done: i === words.length - 1,
-                    tokenCount,
-                    latencyMs: Date.now() - start,
-                };
-                // Small delay to simulate streaming
-                await this.delay(10);
-            }
-        }
-    }
-    /**
-     * Stream with callback handlers
-     */
-    async streamWithCallbacks(prompt, options) {
-        const start = Date.now();
-        let fullText = '';
-        let tokenCount = 0;
-        try {
-            for await (const chunk of this.stream(prompt, options)) {
-                fullText += chunk.text;
-                tokenCount = chunk.tokenCount;
-                if (options.onChunk) {
-                    options.onChunk(chunk);
-                }
-            }
-            const response = {
-                text: fullText.trim(),
-                confidence: 0.8,
-                model: 'streaming',
-                contextSize: tokenCount,
-                latencyMs: Date.now() - start,
-                requestId: `stream-${Date.now()}-${Math.random().toString(36).slice(2)}`,
-            };
-            if (options.onComplete) {
-                options.onComplete(response);
-            }
-            return response;
-        }
-        catch (error) {
-            if (options.onError) {
-                options.onError(error);
-            }
-            throw error;
-        }
-    }
-    /**
-     * Collect stream into single response
-     */
-    async collect(prompt, config) {
-        let result = '';
-        for await (const chunk of this.stream(prompt, config)) {
-            result = chunk.text; // Each chunk is cumulative
-        }
-        return result.trim();
-    }
-    delay(ms) {
-        return new Promise(resolve => setTimeout(resolve, ms));
-    }
-}
-exports.StreamingGenerator = StreamingGenerator;
-/**
- * Create a readable stream from response
- * (For Node.js stream compatibility)
- */
-function createReadableStream(generator) {
-    return new ReadableStream({
-        async pull(controller) {
-            const { value, done } = await generator.next();
-            if (done) {
-                controller.close();
-            }
-            else {
-                controller.enqueue(value.text);
-            }
-        },
-    });
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoic3RyZWFtaW5nLmpzIiwic291cmNlUm9vdCI6IiIsInNvdXJjZXMiOlsiLi4vLi4vc3JjL3N0cmVhbWluZy50cyJdLCJuYW1lcyI6W10sIm1hcHBpbmdzIjoiO0FBQUE7O0dBRUc7OztBQWtKSCxvREFhQztBQXRKRDs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBcUJHO0FBQ0gsTUFBYSxrQkFBa0I7SUFNN0IsWUFBWSxHQUdYO1FBQ0MsSUFBSSxDQUFDLEdBQUcsR0FBRyxHQUFHLENBQUM7SUFDakIsQ0FBQztJQUVEOzs7OztPQUtHO0lBQ0gsS0FBSyxDQUFDLENBQUMsTUFBTSxDQUNYLE1BQWMsRUFDZCxNQUF5QjtRQUV6QixNQUFNLEtBQUssR0FBRyxJQUFJLENBQUMsR0FBRyxFQUFFLENBQUM7UUFFekIsb0VBQW9FO1FBQ3BFLE1BQU0sUUFBUSxHQUFHLElBQUksQ0FBQyxHQUFHLENBQUMsUUFBUSxDQUFDLE1BQU0sRUFBRSxNQUFNLENBQUMsQ0FBQztRQUVuRCx1Q0FBdUM7UUFDdkMsTUFBTSxLQUFLLEdBQUcsUUFBUSxDQUFDLEtBQUssQ0FBQyxPQUFPLENBQUMsQ0FBQztRQUN0QyxJQUFJLFdBQVcsR0FBRyxFQUFFLENBQUM7UUFDckIsSUFBSSxVQUFVLEdBQUcsQ0FBQyxDQUFDO1FBRW5CLEtBQUssSUFBSSxDQUFDLEdBQUcsQ0FBQyxFQUFFLENBQUMsR0FBRyxLQUFLLENBQUMsTUFBTSxFQUFFLENBQUMsRUFBRSxFQUFFLENBQUM7WUFDdEMsV0FBVyxJQUFJLEtBQUssQ0FBQyxDQUFDLENBQUMsQ0FBQztZQUN4QixVQUFVLEVBQUUsQ0FBQztZQUViLG1DQUFtQztZQUNuQyxJQUFJLFVBQVUsR0FBRyxDQUFDLEtBQUssQ0FBQyxJQUFJLENBQUMsS0FBSyxLQUFLLENBQUMsTUFBTSxHQUFHLENBQUMsRUFBRSxDQUFDO2dCQUNuRCxNQUFNO29CQUNKLElBQUksRUFBRSxLQUFLLENBQUMsS0FBSyxDQUFDLElBQUksQ0FBQyxHQUFHLENBQUMsQ0FBQyxFQUFFLENB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QVU7WUFDbkIsTUFBTSxFQUFFLEtBQUssRUFBRSxJQUFJLEVBQUUsR0FBRyxNQUFNLFNBQVMsQ0FBQyxJQUFJLEVBQUUsQ0FBQztZQUMvQyxJQUFJLElBQUksRUFBRSxDQUFDO2dCQUNULFVBQVUsQ0FBQyxLQUFLLEVBQUUsQ0FBQztZQUNyQixDQUFDO2lCQUFNLENBQUM7Z0JBQ04sVUFBVSxDQUFDLE9BQU8sQ0FBQyxLQUFLLENBQUMsSUFBSSxDQUFDLENBQUM7WUFDakMsQ0FBQztRQUNILENBQUM7S0FDRixDQUFDLENBQUM7QUFDTCxDQUFDIiwic291cmNlc0NvbnRlbnQiOlsiLyoqXG4gKiBTdHJlYW1pbmcgcmVzcG9uc2Ugc3VwcG9ydCBmb3IgUnV2TExNXG4gKi9cblxuaW1wb3J0IHtcbiAgU3RyZWFtQ2h1bmssXG4gIFN0cmVhbU9wdGlvbnMsXG4gIFF1ZXJ5UmVzcG9uc2UsXG4gIEdlbmVyYXRpb25Db25maWcsXG59IGZyb20gJy4vdHlwZXMnO1xuXG4vKipcbiAqIEFzeW5jIGdlbmVyYXRvciBmb3Igc3RyZWFtaW5nIHJlc3BvbnNlc1xuICpcbiAqIEBleGFtcGxlXG4gKiBgYGB0eXBlc2NyaXB0XG4gKiBpbXBvcnQgeyBSdXZMTE0sIFN0cmVhbWluZ0dlbmVyYXRvciB9IGZyb20gJ0BydXZlY3Rvci9ydXZsbG0nO1xuICpcbiAqIGNvbnN0IGxsbSA9IG5ldyBSdXZMTE0oKTtcbiAqIGNvbnN0IHN0cmVhbWVyID0gbmV3IFN0cmVhbWluZ0dlbmVyYXRvcihsbG0pO1xuICpcbiAqIC8vIFN0cmVhbSB3aXRoIGFzeW5jIGl0ZXJhdG9yXG4gKiBmb3IgYXdhaXQgKGNvbnN0IGNodW5rIG9mIHN0cmVhbWVyLnN0cmVhbSgnV3JpdGUgYSBzdG9yeScpKSB7XG4gKiAgIHByb2Nlc3Muc3Rkb3V0LndyaXRlKGNodW5rLnRleHQpO1xuICogfVxuICpcbiAqIC8vIFN0cmVhbSB3aXRoIGNhbGxiYWNrc1xuICogYXdhaXQgc3RyZWFtZXIuc3RyZWFtV2l0aENhbGxiYWNrcygnV3JpdGUgYSBwb2VtJywge1xuICogICBvbkNodW5rOiAoY2h1bmspID0+IGNvbnNvbGUubG9nKGNodW5rLnRleHQpLFxuICogICBvbkNvbXBsZXRlOiAocmVzcG9uc2UpID0+IGNvbnNvbGUubG9nKCdEb25lIScsIHJlc3BvbnNlLmxhdGVuY3lNcyksXG4gKiB9KTtcbiAqIGBgYFxuICovXG5leHBvcnQgY2xhc3MgU3RyZWFtaW5nR2VuZXJhdG9yIHtcbiAgcHJpdmF0ZSBsbG06IHtcbiAgICBnZW5lcmF0ZTogKHByb21wdDogc3RyaW5nLCBjb25maWc/OiBHZW5lcmF0aW9uQ29uZmlnKSA9PiBzdHJpbmc7XG4gICAgcXVlcnk6ICh0ZXh0OiBzdHJpbmcsIGNvbmZpZz86IEdlbmVyYXRpb25Db25maWcpID0+IFF1ZXJ5UmVzcG9uc2U7XG4gIH07XG5cbiAgY29uc3RydWN0b3IobGxtOiB7XG4gICAgZ2VuZXJhdGU6IChwcm9tcHQ6IHN0cmluZywgY29uZmlnPzogR2VuZXJhdGlvbkNvbmZpZykgPT4gc3RyaW5nO1xuICAgIHF1ZXJ5OiAodGV4dDogc3RyaW5nLCBjb25maWc/OiBHZW5lcmF0aW9uQ29uZmlnKSA9PiBRdWVyeVJlc3BvbnNlO1xuICB9KSB7XG4gICAgdGhpcy5sbG0gPSBsbG07XG4gIH1cblxuICAvKipcbiAgICogU3RyZWFtIHJlc3BvbnNlIGFzIGFzeW5jIGdlbmVyYXRvclxuICAgKlxuICAgKiBOb3RlOiBUaGlzIHNpbXVsYXRlcyBzdHJlYW1pbmcgYnkgY2h1bmtpbmcgdGhlIGZ1bGwgcmVzcG9uc2UuXG4gICAqIE5hdGl2ZSBzdHJlYW1pbmcgcmVxdWlyZXMgbmF0aXZlIG1vZHVsZSBzdXBwb3J0LlxuICAgKi9cbiAgYXN5bmMgKnN0cmVhbShcbiAgICBwcm9tcHQ6IHN0cmluZyxcbiAgICBjb25maWc/OiBHZW5lcmF0aW9uQ29uZmlnXG4gICk6IEFzeW5jR2VuZXJhdG9yPFN0cmVhbUNodW5rPiB7XG4gICAgY29uc3Qgc3RhcnQgPSBEYXRlLm5vdygpO1xuXG4gICAgLy8gR2VuZXJhdGUgZnVsbCByZXNwb25zZSAobmF0aXZlIHN0cmVhbWluZyB3b3VsZCB5aWVsZCByZWFsIGNodW5rcylcbiAgICBjb25zdCBmdWxsVGV4dCA9IHRoaXMubGxtLmdlbmVyYXRlKHByb21wdCwgY29uZmlnKTtcblxuICAgIC8vIFNpbXVsYXRlIHN0cmVhbWluZyBieSB5aWVsZGluZyB3b3Jkc1xuICAgIGNvbnN0IHdvcmRzID0gZnVsbFRleHQuc3BsaXQoLyhcXHMrKS8pO1xuICAgIGxldCBhY2N1bXVsYXRlZCA9ICcnO1xuICAgIGxldCB0b2tlbkNvdW50ID0gMDtcblxuICAgIGZvciAobGV0IGkgPSAwOyBpIDwgd29yZHMubGVuZ3RoOyBpKyspIHtcbiAgICAgIGFjY3VtdWxhdGVkICs9IHdvcmRzW2ldO1xuICAgICAgdG9rZW5Db3VudCsrO1xuXG4gICAgICAvLyBZaWVsZCBldmVyeSBmZXcgdG9rZW5zIG9yIGF0IGVuZFxuICAgICAgaWYgKHRva2VuQ291bnQgJSAzID09PSAwIHx8IGkgPT09IHdvcmRzLmxlbmd0aCAtIDEpIHtcbiAgICAgICAgeWllbGQge1xuICAgICAgICAgIHRleHQ6IHdvcmRzLnNsaWNlKE1hdGgubWF4KDAsIGkgLSAyKSwgaSArIDEpLmpvaW4oJycpLFxuICAgICAgICAgIGRvbmU6IGkgPT09IHdvcmRzLmxlbmd0aCAtIDEsXG4gICAgICAgICAgdG9rZW5Db3VudCxcbiAgICAgICAgICBsYXRlbmN5TXM6IERhdGUubm93KCkgLSBzdGFydCxcbiAgICAgICAgfTtcblxuICAgICAgICAvLyBTbWFsbCBkZWxheSB0byBzaW11bGF0ZSBzdHJlYW1pbmdcbiAgICAgICAgYXdhaXQgdGhpcy5kZWxheSgxMCk7XG4gICAgICB9XG4gICAgfVxuICB9XG5cbiAgLyoqXG4gICAqIFN0cmVhbSB3aXRoIGNhbGxiYWNrIGhhbmRsZXJzXG4gICAqL1xuICBhc3luYyBzdHJlYW1XaXRoQ2FsbGJhY2tzKFxuICAgIHByb21wdDogc3RyaW5nLFxuICAgIG9wdGlvbnM6IFN0cmVhbU9wdGlvbnNcbiAgKTogUHJvbWlzZTxRdWVyeVJlc3BvbnNlPiB7XG4gICAgY29uc3Qgc3RhcnQgPSBEYXRlLm5vdygpO1xuICAgIGxldCBmdWxsVGV4dCA9ICcnO1xuICAgIGxldCB0b2tlbkNvdW50ID0gMDtcblxuICAgIHRyeSB7XG4gICAgICBmb3IgYXdhaXQgKGNvbnN0IGNodW5rIG9mIHRoaXMuc3RyZWFtKHByb21wdCwgb3B0aW9ucykpIHtcbiAgICAgICAgZnVsbFRleHQgKz0gY2h1bmsudGV4dDtcbiAgICAgICAgdG9rZW5Db3VudCA9IGNodW5rLnRva2VuQ291bnQ7XG5cbiAgICAgICAgaWYgKG9wdGlvbnMub25DaHVuaykge1xuICAgICAgICAgIG9wdGlvbnMub25DaHVuayhjaHVuayk7XG4gICAgICAgIH1cbiAgICAgIH1cblxuICAgICAgY29uc3QgcmVzcG9uc2U6IFF1ZXJ5UmVzcG9uc2UgPSB7XG4gICAgICAgIHRleHQ6IGZ1bGxUZXh0LnRyaW0oKSxcbiAgICAgICAgY29uZmlkZW5jZTogMC44LFxuICAgICAgICBtb2RlbDogJ3N0cmVhbWluZycsXG4gICAgICAgIGNvbnRleHRTaXplOiB0b2tlbkNvdW50LFxuICAgICAgICBsYXRlbmN5TXM6IERhdGUubm93KCkgLSBzdGFydCxcbiAgICAgICAgcmVxdWVzdElkOiBgc3RyZWFtLSR7RGF0ZS5ub3coKX0tJHtNYXRoLnJhbmRvbSgpLnRvU3RyaW5nKDM2KS5zbGljZSgyKX1gLFxuICAgICAgfTtcblxuICAgICAgaWYgKG9wdGlvbnMub25Db21wbGV0ZSkge1xuICAgICAgICBvcHRpb25zLm9uQ29tcGxldGUocmVzcG9uc2UpO1xuICAgICAgfVxuXG4gICAgICByZXR1cm4gcmVzcG9uc2U7XG4gICAgfSBjYXRjaCAoZXJyb3IpIHtcbiAgICAgIGlmIChvcHRpb25zLm9uRXJyb3IpIHtcbiAgICAgICAgb3B0aW9ucy5vbkVycm9yKGVycm9yIGFzIEVycm9yKTtcbiAgICAgIH1cbiAgICAgIHRocm93IGVycm9yO1xuICAgIH1cbiAgfVxuXG4gIC8qKlxuICAgKiBDb2xsZWN0IHN0cmVhbSBpbnRvIHNpbmdsZSByZXNwb25zZVxuICAgKi9cbiAgYXN5bmMgY29sbGVjdChwcm9tcHQ6IHN0cmluZywgY29uZmlnPzogR2VuZXJhdGlvbkNvbmZpZyk6IFByb21pc2U8c3RyaW5nPiB7XG4gICAgbGV0IHJlc3VsdCA9ICcnO1xuICAgIGZvciBhd2FpdCAoY29uc3QgY2h1bmsgb2YgdGhpcy5zdHJlYW0ocHJvbXB0LCBjb25maWcpKSB7XG4gICAgICByZXN1bHQgPSBjaHVuay50ZXh0OyAvLyBFYWNoIGNodW5rIGlzIGN1bXVsYXRpdmVcbiAgICB9XG4gICAgcmV0dXJuIHJlc3VsdC50cmltKCk7XG4gIH1cblxuICBwcml2YXRlIGRlbGF5KG1zOiBudW1iZXIpOiBQcm9taXNlPHZvaWQ+IHtcbiAgICByZXR1cm4gbmV3IFByb21pc2UocmVzb2x2ZSA9PiBzZXRUaW1lb3V0KHJlc29sdmUsIG1zKSk7XG4gIH1cbn1cblxuLyoqXG4gKiBDcmVhdGUgYSByZWFkYWJsZSBzdHJlYW0gZnJvbSByZXNwb25zZVxuICogKEZvciBOb2RlLmpzIHN0cmVhbSBjb21wYXRpYmlsaXR5KVxuICovXG5leHBvcnQgZnVuY3Rpb24gY3JlYXRlUmVhZGFibGVTdHJlYW0oXG4gIGdlbmVyYXRvcjogQXN5bmNHZW5lcmF0b3I8U3RyZWFtQ2h1bms+XG4pOiBSZWFkYWJsZVN0cmVhbTxzdHJpbmc+IHtcbiAgcmV0dXJuIG5ldyBSZWFkYWJsZVN0cmVhbSh7XG4gICAgYXN5bmMgcHVsbChjb250cm9sbGVyKSB7XG4gICAgICBjb25zdCB7IHZhbHVlLCBkb25lIH0gPSBhd2FpdCBnZW5lcmF0b3IubmV4dCgpO1xuICAgICAgaWYgKGRvbmUpIHtcbiAgICAgICAgY29udHJvbGxlci5jbG9zZSgpO1xuICAgICAgfSBlbHNlIHtcbiAgICAgICAgY29udHJvbGxlci5lbnF1ZXVlKHZhbHVlLnRleHQpO1xuICAgICAgfVxuICAgIH0sXG4gIH0pO1xufVxuIl19

package/dist/cjs/training.d.ts

@@ -1,312 +0,0 @@
-/**
- * Training Pipeline for SONA
- *
- * Comprehensive training infrastructure with metrics tracking,
- * learning rate scheduling, and checkpoint management.
- *
- * @example
- * ```typescript
- * import { TrainingPipeline, TrainingConfig } from '@ruvector/ruvllm';
- *
- * const pipeline = new TrainingPipeline({
- *   learningRate: 0.001,
- *   batchSize: 32,
- *   epochs: 10,
- * });
- *
- * // Add training data
- * pipeline.addBatch(inputs, targets, qualities);
- *
- * // Run training
- * const result = pipeline.train();
- * console.log(`Final loss: ${result.finalLoss}`);
- * ```
- */
-import { Embedding, TrainingConfig, TrainingResult } from './types';
-import { LoraAdapter } from './lora';
-import { EwcManager } from './sona';
-/**
- * Training metrics
- */
-export interface TrainingMetrics {
-    /** Current epoch */
-    epoch: number;
-    /** Current step */
-    step: number;
-    /** Training loss */
-    trainLoss: number;
-    /** Validation loss */
-    valLoss: number;
-    /** Learning rate */
-    learningRate: number;
-    /** Gradient norm */
-    gradNorm: number;
-    /** Steps per second */
-    stepsPerSecond: number;
-    /** ETA in seconds */
-    etaSeconds: number;
-}
-/**
- * Training data batch
- */
-export interface TrainingBatch {
-    /** Input embeddings */
-    inputs: Embedding[];
-    /** Target outputs */
-    targets: Embedding[];
-    /** Quality scores */
-    qualities: number[];
-}
-/**
- * Checkpoint data
- */
-export interface Checkpoint {
-    /** Epoch number */
-    epoch: number;
-    /** Step number */
-    step: number;
-    /** Training loss at checkpoint */
-    loss: number;
-    /** Model weights (serialized) */
-    weights: string;
-    /** Timestamp */
-    timestamp: number;
-}
-/**
- * Result of a saveCheckpoint() call.
- */
-export interface CheckpointSaveResult {
-    /** Index of the checkpoint in the in-memory checkpoint list */
-    index: number;
-    /** Epoch the checkpoint captured */
-    epoch: number;
-    /** Step the checkpoint captured */
-    step: number;
-    /** Training loss at checkpoint time */
-    loss: number;
-    /** Absolute or as-given file path, when persisted to disk */
-    path?: string;
-    /** Serialized size in bytes, when persisted to disk */
-    bytes?: number;
-}
-/**
- * Learning Rate Scheduler
- */
-export declare class LRScheduler {
-    private config;
-    private initialLR;
-    private currentStep;
-    private totalSteps;
-    constructor(config: Required<TrainingConfig>, totalSteps: number);
-    /**
-     * Get learning rate for current step
-     */
-    getLR(): number;
-    /**
-     * Step the scheduler
-     */
-    step(): void;
-    /**
-     * Reset scheduler
-     */
-    reset(): void;
-}
-/**
- * Training Metrics Tracker
- */
-export declare class MetricsTracker {
-    private lossHistory;
-    private valLossHistory;
-    private gradNormHistory;
-    private startTime;
-    private stepTimes;
-    /**
-     * Record training loss
-     */
-    recordLoss(loss: number): void;
-    /**
-     * Record validation loss
-     */
-    recordValLoss(loss: number): void;
-    /**
-     * Record gradient norm
-     */
-    recordGradNorm(norm: number): void;
-    /**
-     * Record step time
-     */
-    recordStepTime(ms: number): void;
-    /**
-     * Get average loss over last N steps
-     */
-    avgLoss(n?: number): number;
-    /**
-     * Get average validation loss
-     */
-    avgValLoss(n?: number): number;
-    /**
-     * Get steps per second
-     */
-    stepsPerSecond(): number;
-    /**
-     * Get ETA in seconds
-     */
-    eta(remainingSteps: number): number;
-    /**
-     * Get best validation loss
-     */
-    bestValLoss(): number;
-    /**
-     * Get total duration
-     */
-    duration(): number;
-    /**
-     * Get all loss history
-     */
-    getLossHistory(): number[];
-    /**
-     * Get all validation loss history
-     */
-    getValLossHistory(): number[];
-    /**
-     * Reset tracker
-     */
-    reset(): void;
-}
-/**
- * Training Pipeline
- *
- * Full training infrastructure for SONA models.
- */
-export declare class TrainingPipeline {
-    private config;
-    private adapter;
-    private ewcManager;
-    private metrics;
-    private scheduler;
-    private batches;
-    private checkpoints;
-    private currentEpoch;
-    private currentStep;
-    private bestValLoss;
-    private patienceCounter;
-    /** Set by resumeFrom(); makes the next train() continue instead of restart. */
-    private resumePending;
-    constructor(config?: TrainingConfig, adapter?: LoraAdapter);
-    /**
-     * Add training batch
-     */
-    addBatch(inputs: Embedding[], targets: Embedding[], qualities: number[]): void;
-    /**
-     * Add training data
-     */
-    addData(data: Array<{
-        input: Embedding;
-        target: Embedding;
-        quality: number;
-    }>): void;
-    /**
-     * Run training.
-     *
-     * When {@link resumeFrom} primed the pipeline, this continues from the
-     * restored epoch (running the remaining epochs of `config.epochs`) and
-     * advances the LR scheduler to the restored step so the schedule is
-     * unbroken; metrics history is preserved. Without a resume the run is
-     * unchanged from a fresh start — same reset, same scheduler, same result
-     * shape as before this method learned to resume.
-     */
-    train(): TrainingResult;
-    /**
-     * Single training step
-     */
-    private trainStep;
-    /**
-     * Validation pass
-     */
-    private validate;
-    /**
-     * Save a checkpoint.
-     *
-     * Always records the checkpoint in the in-memory list (the behavior the
-     * training loop relies on). When `path` is given, additionally persists
-     * the checkpoint to disk as versioned JSON — before v2.5.7 this method
-     * was private, ignored any argument, and never wrote a file, so callers
-     * passing a path got `undefined` back and zero bytes on disk.
-     *
-     * @param path Optional file path; parent directories are created.
-     * @returns Where the checkpoint went — in-memory index, and file
-     *          path + byte size when persisted.
-     */
-    saveCheckpoint(path?: string): CheckpointSaveResult;
-    /**
-     * Load a checkpoint — by in-memory index, or from a file previously
-     * written by `saveCheckpoint(path)`.
-     *
-     * For v2 files, the envelope's adapter geometry is checked against the
-     * current adapter first; a mismatch (different inputDim/outputDim/rank)
-     * returns false and leaves the adapter untouched, so mis-shaped weights
-     * are never silently restored. v1 files carry no geometry and load as
-     * before (back-compat).
-     */
-    loadCheckpoint(indexOrPath: number | string): boolean;
-    /**
-     * Resume training from a checkpoint file.
-     *
-     * Loads the checkpoint (with the same v2 shape validation as
-     * {@link loadCheckpoint}) AND primes the pipeline so the next {@link train}
-     * call continues from the restored epoch/step rather than restarting. This
-     * is the explicit, least-invasive resume path: a plain `loadCheckpoint()`
-     * still restores weights only (train() from scratch), while `resumeFrom()`
-     * additionally makes the subsequent train() pick up where the run stopped.
-     *
-     * @returns true when the checkpoint loaded and resume was primed; false if
-     *          the file was missing, foreign, or shape-mismatched (in which case
-     *          no resume is armed).
-     */
-    resumeFrom(path: string): boolean;
-    /**
-     * Get current metrics
-     */
-    getMetrics(): TrainingMetrics;
-    /**
-     * Get adapter
-     */
-    getAdapter(): LoraAdapter;
-    /**
-     * Get EWC manager
-     */
-    getEwcManager(): EwcManager;
-    /**
-     * Get checkpoints
-     */
-    getCheckpoints(): Checkpoint[];
-    /**
-     * Reset pipeline
-     */
-    reset(): void;
-    private shuffleBatches;
-}
-/**
- * Training Factory
- *
- * Create pre-configured training pipelines for common scenarios.
- */
-export declare class TrainingFactory {
-    /**
-     * Create pipeline for quick fine-tuning
-     */
-    static quickFinetune(): TrainingPipeline;
-    /**
-     * Create pipeline for deep training
-     */
-    static deepTraining(): TrainingPipeline;
-    /**
-     * Create pipeline for continual learning
-     */
-    static continualLearning(ewcLambda?: number): TrainingPipeline;
-    /**
-     * Create pipeline for federated aggregation
-     */
-    static federatedAggregation(): TrainingPipeline;
-}
-//# sourceMappingURL=training.d.ts.map

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

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