aura-code 0.3.0

package/dist/ruby/episode-capture.js

@@ -0,0 +1,193 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getEpisodeStats = exports.deleteEpisode = exports.loadEpisodes = exports.saveEpisode = exports.episodeStore = void 0;
+exports.estimateTokens = estimateTokens;
+const fs = __importStar(require("fs"));
+const path = __importStar(require("path"));
+const competence_js_1 = require("./competence.js");
+// ─────────────────────────────────────────────────────────────────────────────
+// Episode persistence
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// Stores alternation episodes under ~/.aura/episodes/{projectHash}/ so
+// Ruby competence and fine-tune readiness can be computed per project.
+/**
+ * Rough character-based token estimation (≈1 token per 4 characters).
+ * Used only for episode recording when the provider does not report usage
+ * (e.g. MiMo streaming, Google Gemini streaming).
+ */
+function estimateTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+/**
+ * On-disk episode persistence for the Ruby Principle.
+ * Mirrors {@link sessionStore} — atomic `.tmp` writes, namespaced by project hash.
+ */
+exports.episodeStore = {
+    defaultDir() {
+        return path.join(process.env.HOME ?? '/tmp', '.aura', 'episodes');
+    },
+    /**
+     * First 8 characters of the base64 encoding of `projectRoot`.
+     */
+    projectHash(projectRoot) {
+        return Buffer.from(projectRoot, 'utf8').toString('base64').slice(0, 8);
+    },
+    /** Directory containing all episodes for a project. */
+    projectDir(projectRoot) {
+        return path.join(this.defaultDir(), this.projectHash(projectRoot));
+    },
+    /** Full path to one episode file. */
+    episodePath(projectRoot, id) {
+        return path.join(this.projectDir(projectRoot), `${id}.json`);
+    },
+    /**
+     * Persists one episode to `~/.aura/episodes/{projectHash}/{id}.json`.
+     *
+     * When the provider did not report token usage (totalTokens === 0), fills in
+     * a character-based estimate from the episode's output text so that fine-tune
+     * readiness and competence tracking still have meaningful token counts.
+     */
+    async saveEpisode(projectRoot, episode) {
+        // Fill estimated tokens when the provider reported 0
+        if (episode.rubyAttempted && !episode.tokensUsed.ruby) {
+            const est = estimateTokens(episode.rubyOutput);
+            if (est > 0)
+                episode = { ...episode, tokensUsed: { ...episode.tokensUsed, ruby: est } };
+        }
+        if (episode.largeModelUsed && !episode.tokensUsed.largeModel) {
+            const est = estimateTokens(episode.largeModelOutput);
+            if (est > 0)
+                episode = { ...episode, tokensUsed: { ...episode.tokensUsed, largeModel: est } };
+        }
+        const dir = this.projectDir(projectRoot);
+        if (!fs.existsSync(dir))
+            fs.mkdirSync(dir, { recursive: true });
+        const filePath = this.episodePath(projectRoot, episode.id);
+        const tmp = filePath + '.tmp';
+        await fs.promises.writeFile(tmp, JSON.stringify(episode, null, 2), 'utf8');
+        await fs.promises.rename(tmp, filePath);
+    },
+    /**
+     * Loads episodes for a project, newest first.
+     * Never throws — returns `[]` on missing dir or parse errors.
+     */
+    async loadEpisodes(projectRoot, limit) {
+        try {
+            const dir = this.projectDir(projectRoot);
+            if (!fs.existsSync(dir))
+                return [];
+            const files = fs.readdirSync(dir).filter(f => f.endsWith('.json'));
+            const episodes = [];
+            for (const file of files) {
+                const raw = await fs.promises.readFile(path.join(dir, file), 'utf8');
+                try {
+                    const parsed = JSON.parse(raw);
+                    if (parsed?.id && typeof parsed.timestamp === 'number') {
+                        episodes.push(parsed);
+                    }
+                }
+                catch {
+                    /* skip corrupt file */
+                }
+            }
+            episodes.sort((a, b) => b.timestamp - a.timestamp);
+            if (limit !== undefined && limit > 0) {
+                return episodes.slice(0, limit);
+            }
+            return episodes;
+        }
+        catch {
+            return [];
+        }
+    },
+    /**
+     * Removes one episode file. Safe when the file does not exist.
+     */
+    async deleteEpisode(projectRoot, id) {
+        const filePath = this.episodePath(projectRoot, id);
+        if (!fs.existsSync(filePath))
+            return;
+        await fs.promises.unlink(filePath);
+    },
+    /**
+     * Aggregates episode counters and fine-tune readiness for a project.
+     * Never throws — returns zeroed stats on error.
+     */
+    async getEpisodeStats(projectRoot) {
+        try {
+            const episodes = await this.loadEpisodes(projectRoot);
+            let rubySuccesses = 0;
+            let rubyFailures = 0;
+            let largeModelInterventions = 0;
+            for (const ep of episodes) {
+                if (ep.rubyAttempted) {
+                    if (ep.rubySucceeded)
+                        rubySuccesses++;
+                    else
+                        rubyFailures++;
+                }
+                if (ep.largeModelUsed)
+                    largeModelInterventions++;
+            }
+            return {
+                total: episodes.length,
+                rubySuccesses,
+                rubyFailures,
+                largeModelInterventions,
+                readyForFineTune: (0, competence_js_1.shouldFineTune)(episodes),
+            };
+        }
+        catch {
+            return {
+                total: 0,
+                rubySuccesses: 0,
+                rubyFailures: 0,
+                largeModelInterventions: 0,
+                readyForFineTune: false,
+            };
+        }
+    },
+};
+// Named re-exports (callers may import functions directly)
+exports.saveEpisode = exports.episodeStore.saveEpisode.bind(exports.episodeStore);
+exports.loadEpisodes = exports.episodeStore.loadEpisodes.bind(exports.episodeStore);
+exports.deleteEpisode = exports.episodeStore.deleteEpisode.bind(exports.episodeStore);
+exports.getEpisodeStats = exports.episodeStore.getEpisodeStats.bind(exports.episodeStore);
+// estimateTokens is already a top-level export above
+//# sourceMappingURL=episode-capture.js.map

package/dist/ruby/episode-capture.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"episode-capture.js","sourceRoot":"","sources":["../../src/ruby/episode-capture.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAiBA,wCAGC;AApBD,uCAAyB;AACzB,2CAA6B;AAE7B,mDAAiD;AAEjD,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAChF,EAAE;AACF,uEAAuE;AACvE,uEAAuE;AAEvE;;;;GAIG;AACH,SAAgB,cAAc,CAAC,IAAwB;IACrD,IAAI,CAAC,IAAI;QAAE,OAAO,CAAC,CAAC;IACpB,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;AACpC,CAAC;AAWD;;;GAGG;AACU,QAAA,YAAY,GAAG;IAC1B,UAAU;QACR,OAAO,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,IAAI,IAAI,MAAM,EAAE,OAAO,EAAE,UAAU,CAAC,CAAC;IACpE,CAAC;IAED;;OAEG;IACH,WAAW,CAAC,WAAmB;QAC7B,OAAO,MAAM,CAAC,IAAI,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IACzE,CAAC;IAED,uDAAuD;IACvD,UAAU,CAAC,WAAmB;QAC5B,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,EAAE,IAAI,CAAC,WAAW,CAAC,WAAW,CAAC,CAAC,CAAC;IACrE,CAAC;IAED,qCAAqC;IACrC,WAAW,CAAC,WAAmB,EAAE,EAAU;QACzC,OAAO,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC/D,CAAC;IAED;;;;;;OAMG;IACH,KAAK,CAAC,WAAW,CAAC,WAAmB,EAAE,OAAgB;QACrD,qDAAqD;QACrD,IAAI,OAAO,CAAC,aAAa,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,EAAE,CAAC;YACtD,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC;YAC/C,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,IAAI,EAAE,GAAG,EAAE,EAAE,CAAC;QAC1F,CAAC;QACD,IAAI,OAAO,CAAC,cAAc,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,UAAU,EAAE,CAAC;YAC7D,MAAM,GAAG,GAAG,cAAc,CAAC,OAAO,CAAC,gBAAgB,CAAC,CAAC;YACrD,IAAI,GAAG,GAAG,CAAC;gBAAE,OAAO,GAAG,EAAE,GAAG,OAAO,EAAE,UAAU,EAAE,EAAE,GAAG,OAAO,CAAC,UAAU,EAAE,UAAU,EAAE,GAAG,EAAE,EAAE,CAAC;QAChG,CAAC;QAED,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;QACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;YAAE,EAAE,CAAC,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAChE,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,OAAO,CAAC,EAAE,CAAC,CAAC;QAC3D,MAAM,GAAG,GAAG,QAAQ,GAAG,MAAM,CAAC;QAC9B,MAAM,EAAE,CAAC,QAAQ,CAAC,SAAS,CAAC,GAAG,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,MAAM,CAAC,CAAC;QAC3E,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAC1C,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,YAAY,CAAC,WAAmB,EAAE,KAAc;QACpD,IAAI,CAAC;YACH,MAAM,GAAG,GAAG,IAAI,CAAC,UAAU,CAAC,WAAW,CAAC,CAAC;YACzC,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC;gBAAE,OAAO,EAAE,CAAC;YAEnC,MAAM,KAAK,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,CAAC;YACnE,MAAM,QAAQ,GAAc,EAAE,CAAC;YAE/B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,MAAM,GAAG,GAAG,MAAM,EAAE,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,IAAI,CAAC,EAAE,MAAM,CAAC,CAAC;gBACrE,IAAI,CAAC;oBACH,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAY,CAAC;oBAC1C,IAAI,MAAM,EAAE,EAAE,IAAI,OAAO,MAAM,CAAC,SAAS,KAAK,QAAQ,EAAE,CAAC;wBACvD,QAAQ,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;oBACxB,CAAC;gBACH,CAAC;gBAAC,MAAM,CAAC;oBACP,uBAAuB;gBACzB,CAAC;YACH,CAAC;YAED,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,SAAS,CAAC,CAAC;YACnD,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;gBACrC,OAAO,QAAQ,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;YAClC,CAAC;YACD,OAAO,QAAQ,CAAC;QAClB,CAAC;QAAC,MAAM,CAAC;YACP,OAAO,EAAE,CAAC;QACZ,CAAC;IACH,CAAC;IAED;;OAEG;IACH,KAAK,CAAC,aAAa,CAAC,WAAmB,EAAE,EAAU;QACjD,MAAM,QAAQ,GAAG,IAAI,CAAC,WAAW,CAAC,WAAW,EAAE,EAAE,CAAC,CAAC;QACnD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC;YAAE,OAAO;QACrC,MAAM,EAAE,CAAC,QAAQ,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACrC,CAAC;IAED;;;OAGG;IACH,KAAK,CAAC,eAAe,CAAC,WAAmB;QACvC,IAAI,CAAC;YACH,MAAM,QAAQ,GAAG,MAAM,IAAI,CAAC,YAAY,CAAC,WAAW,CAAC,CAAC;YACtD,IAAI,aAAa,GAAG,CAAC,CAAC;YACtB,IAAI,YAAY,GAAG,CAAC,CAAC;YACrB,IAAI,uBAAuB,GAAG,CAAC,CAAC;YAEhC,KAAK,MAAM,EAAE,IAAI,QAAQ,EAAE,CAAC;gBAC1B,IAAI,EAAE,CAAC,aAAa,EAAE,CAAC;oBACrB,IAAI,EAAE,CAAC,aAAa;wBAAE,aAAa,EAAE,CAAC;;wBACjC,YAAY,EAAE,CAAC;gBACtB,CAAC;gBACD,IAAI,EAAE,CAAC,cAAc;oBAAE,uBAAuB,EAAE,CAAC;YACnD,CAAC;YAED,OAAO;gBACL,KAAK,EAAE,QAAQ,CAAC,MAAM;gBACtB,aAAa;gBACb,YAAY;gBACZ,uBAAuB;gBACvB,gBAAgB,EAAE,IAAA,8BAAc,EAAC,QAAQ,CAAC;aAC3C,CAAC;QACJ,CAAC;QAAC,MAAM,CAAC;YACP,OAAO;gBACL,KAAK,EAAE,CAAC;gBACR,aAAa,EAAE,CAAC;gBAChB,YAAY,EAAE,CAAC;gBACf,uBAAuB,EAAE,CAAC;gBAC1B,gBAAgB,EAAE,KAAK;aACxB,CAAC;QACJ,CAAC;IACH,CAAC;CACF,CAAC;AAEF,2DAA2D;AAC9C,QAAA,WAAW,GAAG,oBAAY,CAAC,WAAW,CAAC,IAAI,CAAC,oBAAY,CAAC,CAAC;AAC1D,QAAA,YAAY,GAAG,oBAAY,CAAC,YAAY,CAAC,IAAI,CAAC,oBAAY,CAAC,CAAC;AAC5D,QAAA,aAAa,GAAG,oBAAY,CAAC,aAAa,CAAC,IAAI,CAAC,oBAAY,CAAC,CAAC;AAC9D,QAAA,eAAe,GAAG,oBAAY,CAAC,eAAe,CAAC,IAAI,CAAC,oBAAY,CAAC,CAAC;AAC/E,qDAAqD"}

package/dist/ruby/fine-tune.d.ts

@@ -0,0 +1,16 @@
+import type { FineTuneJob } from './types.js';
+/**
+ * Creates a specialised Ollama model via `ollama create` and a generated Modelfile.
+ * Returns a completed or failed {@link FineTuneJob}; does not throw.
+ */
+export declare function fineTuneWithOllama(baseModel: string, trainingDataPath: string, outputModelName: string): Promise<FineTuneJob>;
+/**
+ * Uploads JSONL training data and starts an OpenAI fine-tuning job.
+ * Returns `failed` when `OPENAI_API_KEY` is unset; does not throw.
+ */
+export declare function fineTuneWithOpenAI(trainingDataPath: string, baseModel?: string): Promise<FineTuneJob>;
+/**
+ * Refreshes a {@link FineTuneJob} from Ollama tags or the OpenAI fine-tuning API.
+ * Never throws — returns the input job on unrecoverable errors.
+ */
+export declare function checkJobStatus(job: FineTuneJob): Promise<FineTuneJob>;

package/dist/ruby/fine-tune.js

@@ -0,0 +1,253 @@
+"use strict";
+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 __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fineTuneWithOllama = fineTuneWithOllama;
+exports.fineTuneWithOpenAI = fineTuneWithOpenAI;
+exports.checkJobStatus = checkJobStatus;
+const fs = __importStar(require("fs"));
+const os = __importStar(require("os"));
+const path = __importStar(require("path"));
+const child_process_1 = require("child_process");
+const util_1 = require("util");
+const crypto_1 = require("crypto");
+const openai_1 = __importDefault(require("openai"));
+const env_js_1 = require("../util/env.js");
+const execFileAsync = (0, util_1.promisify)(child_process_1.execFile);
+// ─────────────────────────────────────────────────────────────────────────────
+// Ollama — Modelfile-based specialization (no native fine-tune API)
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Creates a specialised Ollama model via `ollama create` and a generated Modelfile.
+ * Returns a completed or failed {@link FineTuneJob}; does not throw.
+ */
+async function fineTuneWithOllama(baseModel, trainingDataPath, outputModelName) {
+    const id = `ollama-${(0, crypto_1.randomUUID)()}`;
+    const startedAt = Date.now();
+    let trainingExamples = 0;
+    try {
+        const raw = await fs.promises.readFile(trainingDataPath, 'utf8');
+        const lines = raw.split('\n').filter(l => l.trim());
+        trainingExamples = lines.length;
+        const snippets = [];
+        for (const line of lines.slice(0, 50)) {
+            try {
+                const row = JSON.parse(line);
+                const user = row.messages?.find(m => m.role === 'user')?.content ?? '';
+                const assistant = row.messages?.find(m => m.role === 'assistant')?.content ?? '';
+                if (user || assistant) {
+                    snippets.push(`User: ${user}\nAssistant: ${assistant}`);
+                }
+            }
+            catch {
+                /* skip bad line */
+            }
+        }
+        const systemBlock = [
+            'You are a specialized coding assistant.',
+            'Learn from these corrected examples where a larger model intervened:',
+            ...snippets,
+        ].join('\n\n');
+        const modelfile = [
+            `FROM ${baseModel}`,
+            'SYSTEM """',
+            systemBlock.replace(/"""/g, "'''"),
+            '"""',
+        ].join('\n');
+        const tmpDir = await fs.promises.mkdtemp(path.join(os.tmpdir(), 'rubycode-ft-'));
+        const modelfilePath = path.join(tmpDir, 'Modelfile');
+        await fs.promises.writeFile(modelfilePath, modelfile, 'utf8');
+        await execFileAsync('ollama', ['create', outputModelName, '-f', modelfilePath], {
+            timeout: 300_000,
+        });
+        return {
+            id,
+            status: 'completed',
+            baseModel,
+            trainingExamples,
+            outputModel: outputModelName,
+            startedAt,
+            completedAt: Date.now(),
+        };
+    }
+    catch (e) {
+        return {
+            id,
+            status: 'failed',
+            baseModel,
+            trainingExamples,
+            outputModel: outputModelName,
+            startedAt,
+            completedAt: Date.now(),
+            error: String(e),
+        };
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// OpenAI — native fine-tuning API
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Uploads JSONL training data and starts an OpenAI fine-tuning job.
+ * Returns `failed` when `OPENAI_API_KEY` is unset; does not throw.
+ */
+async function fineTuneWithOpenAI(trainingDataPath, baseModel = 'gpt-3.5-turbo') {
+    const startedAt = Date.now();
+    const apiKey = (0, env_js_1.getApiKey)('OPENAI_API_KEY');
+    if (!apiKey) {
+        return {
+            id: `openai-${(0, crypto_1.randomUUID)()}`,
+            status: 'failed',
+            baseModel,
+            trainingExamples: 0,
+            outputModel: '',
+            startedAt,
+            completedAt: Date.now(),
+            error: 'OPENAI_API_KEY is not set',
+        };
+    }
+    try {
+        const raw = await fs.promises.readFile(trainingDataPath, 'utf8');
+        const trainingExamples = raw.split('\n').filter(l => l.trim()).length;
+        const client = new openai_1.default({ apiKey });
+        const file = await client.files.create({
+            file: fs.createReadStream(trainingDataPath),
+            purpose: 'fine-tune',
+        });
+        const job = await client.fineTuning.jobs.create({
+            training_file: file.id,
+            model: baseModel,
+        });
+        return {
+            id: `openai-${job.id}`,
+            status: 'running',
+            baseModel,
+            trainingExamples,
+            outputModel: job.fine_tuned_model ?? '',
+            startedAt,
+        };
+    }
+    catch (e) {
+        return {
+            id: `openai-${(0, crypto_1.randomUUID)()}`,
+            status: 'failed',
+            baseModel,
+            trainingExamples: 0,
+            outputModel: '',
+            startedAt,
+            completedAt: Date.now(),
+            error: String(e),
+        };
+    }
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Job status
+// ─────────────────────────────────────────────────────────────────────────────
+/**
+ * Refreshes a {@link FineTuneJob} from Ollama tags or the OpenAI fine-tuning API.
+ * Never throws — returns the input job on unrecoverable errors.
+ */
+async function checkJobStatus(job) {
+    try {
+        if (!job?.id)
+            return job;
+        if (job.id.startsWith('openai-')) {
+            return checkOpenAIJobStatus(job);
+        }
+        return checkOllamaJobStatus(job);
+    }
+    catch {
+        return job;
+    }
+}
+async function checkOllamaJobStatus(job) {
+    if (job.status === 'failed' || job.status === 'completed')
+        return job;
+    try {
+        const res = await fetch('http://localhost:11434/api/tags');
+        if (!res.ok)
+            return { ...job, status: 'failed', error: 'Ollama tags API unreachable' };
+        const body = (await res.json());
+        const names = (body.models ?? []).map(m => m.name);
+        const exists = names.some(n => n === job.outputModel ||
+            n.startsWith(`${job.outputModel}:`) ||
+            n.split(':')[0] === job.outputModel);
+        if (exists) {
+            return { ...job, status: 'completed', completedAt: job.completedAt ?? Date.now() };
+        }
+        return { ...job, status: 'failed', error: `Model ${job.outputModel} not found in Ollama` };
+    }
+    catch (e) {
+        return { ...job, status: 'failed', error: String(e), completedAt: Date.now() };
+    }
+}
+async function checkOpenAIJobStatus(job) {
+    const apiKey = (0, env_js_1.getApiKey)('OPENAI_API_KEY');
+    if (!apiKey) {
+        return {
+            ...job,
+            status: 'failed',
+            error: 'OPENAI_API_KEY is not set',
+            completedAt: Date.now(),
+        };
+    }
+    const openaiId = job.id.replace(/^openai-/, '');
+    try {
+        const client = new openai_1.default({ apiKey });
+        const remote = await client.fineTuning.jobs.retrieve(openaiId);
+        const statusMap = {
+            validating_files: 'pending',
+            queued: 'pending',
+            running: 'running',
+            succeeded: 'completed',
+            failed: 'failed',
+            cancelled: 'failed',
+        };
+        const status = statusMap[remote.status] ?? job.status;
+        const terminal = status === 'completed' || status === 'failed';
+        return {
+            ...job,
+            status,
+            outputModel: remote.fine_tuned_model ?? job.outputModel,
+            completedAt: terminal ? Date.now() : job.completedAt,
+            error: remote.error?.message ?? job.error,
+        };
+    }
+    catch (e) {
+        return { ...job, status: 'failed', error: String(e), completedAt: Date.now() };
+    }
+}
+//# sourceMappingURL=fine-tune.js.map

package/dist/ruby/fine-tune.js.map

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

package/dist/ruby/index.d.ts

@@ -0,0 +1,10 @@
+export { RubyModel } from './ruby-model.js';
+export { RubyAlternator } from './alternator.js';
+export type { AlternatorOptions, AlternatorRunResult } from './alternator.js';
+export { assessCompetence, updateCompetence, getCompetenceReport, shouldFineTune, } from './competence.js';
+export { saveEpisode, loadEpisodes, getEpisodeStats, } from './episode-capture.js';
+export type { EpisodeStats } from './episode-capture.js';
+export { generateTrainingData, exportJSONL, } from './training-data.js';
+export { fineTuneWithOllama, fineTuneWithOpenAI, checkJobStatus, } from './fine-tune.js';
+export type { Episode, RubyConfig, CompetenceLevel, AlternationDecision, TrainingExample, FineTuneJob, TaskCategory, } from './types.js';
+export { DEFAULT_RUBY_CONFIG } from './types.js';

package/dist/ruby/index.js

@@ -0,0 +1,26 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.DEFAULT_RUBY_CONFIG = exports.checkJobStatus = exports.fineTuneWithOpenAI = exports.fineTuneWithOllama = exports.exportJSONL = exports.generateTrainingData = exports.getEpisodeStats = exports.loadEpisodes = exports.saveEpisode = exports.shouldFineTune = exports.getCompetenceReport = exports.updateCompetence = exports.assessCompetence = exports.RubyAlternator = exports.RubyModel = void 0;
+var ruby_model_js_1 = require("./ruby-model.js");
+Object.defineProperty(exports, "RubyModel", { enumerable: true, get: function () { return ruby_model_js_1.RubyModel; } });
+var alternator_js_1 = require("./alternator.js");
+Object.defineProperty(exports, "RubyAlternator", { enumerable: true, get: function () { return alternator_js_1.RubyAlternator; } });
+var competence_js_1 = require("./competence.js");
+Object.defineProperty(exports, "assessCompetence", { enumerable: true, get: function () { return competence_js_1.assessCompetence; } });
+Object.defineProperty(exports, "updateCompetence", { enumerable: true, get: function () { return competence_js_1.updateCompetence; } });
+Object.defineProperty(exports, "getCompetenceReport", { enumerable: true, get: function () { return competence_js_1.getCompetenceReport; } });
+Object.defineProperty(exports, "shouldFineTune", { enumerable: true, get: function () { return competence_js_1.shouldFineTune; } });
+var episode_capture_js_1 = require("./episode-capture.js");
+Object.defineProperty(exports, "saveEpisode", { enumerable: true, get: function () { return episode_capture_js_1.saveEpisode; } });
+Object.defineProperty(exports, "loadEpisodes", { enumerable: true, get: function () { return episode_capture_js_1.loadEpisodes; } });
+Object.defineProperty(exports, "getEpisodeStats", { enumerable: true, get: function () { return episode_capture_js_1.getEpisodeStats; } });
+var training_data_js_1 = require("./training-data.js");
+Object.defineProperty(exports, "generateTrainingData", { enumerable: true, get: function () { return training_data_js_1.generateTrainingData; } });
+Object.defineProperty(exports, "exportJSONL", { enumerable: true, get: function () { return training_data_js_1.exportJSONL; } });
+var fine_tune_js_1 = require("./fine-tune.js");
+Object.defineProperty(exports, "fineTuneWithOllama", { enumerable: true, get: function () { return fine_tune_js_1.fineTuneWithOllama; } });
+Object.defineProperty(exports, "fineTuneWithOpenAI", { enumerable: true, get: function () { return fine_tune_js_1.fineTuneWithOpenAI; } });
+Object.defineProperty(exports, "checkJobStatus", { enumerable: true, get: function () { return fine_tune_js_1.checkJobStatus; } });
+var types_js_1 = require("./types.js");
+Object.defineProperty(exports, "DEFAULT_RUBY_CONFIG", { enumerable: true, get: function () { return types_js_1.DEFAULT_RUBY_CONFIG; } });
+//# sourceMappingURL=index.js.map

package/dist/ruby/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/ruby/index.ts"],"names":[],"mappings":";;;AAAA,iDAA4C;AAAnC,0GAAA,SAAS,OAAA;AAClB,iDAAiD;AAAxC,+GAAA,cAAc,OAAA;AAEvB,iDAKyB;AAJvB,iHAAA,gBAAgB,OAAA;AAChB,iHAAA,gBAAgB,OAAA;AAChB,oHAAA,mBAAmB,OAAA;AACnB,+GAAA,cAAc,OAAA;AAEhB,2DAI8B;AAH5B,iHAAA,WAAW,OAAA;AACX,kHAAA,YAAY,OAAA;AACZ,qHAAA,eAAe,OAAA;AAGjB,uDAG4B;AAF1B,wHAAA,oBAAoB,OAAA;AACpB,+GAAA,WAAW,OAAA;AAEb,+CAIwB;AAHtB,kHAAA,kBAAkB,OAAA;AAClB,kHAAA,kBAAkB,OAAA;AAClB,8GAAA,cAAc,OAAA;AAWhB,uCAAiD;AAAxC,+GAAA,mBAAmB,OAAA"}

package/dist/ruby/ruby-model.d.ts

@@ -0,0 +1,36 @@
+import type { LLMProvider, ToolDefinition, HistoryMessage, LLMResponse, StreamChunk } from '../providers/types.js';
+import type { RubyConfig } from './types.js';
+/**
+ * {@link LLMProvider} implementation for the Ruby Principle small model.
+ * Delegates completions to {@link OpenAICompatibleProvider} against Ollama.
+ */
+export declare class RubyModel implements LLMProvider {
+    readonly name = "Ruby";
+    supportsTools: boolean;
+    model: string;
+    private readonly config;
+    private delegate;
+    constructor(config: RubyConfig);
+    /**
+     * One-shot completion via the Ollama OpenAI-compatible endpoint.
+     */
+    complete(system: string, history: HistoryMessage[], tools: ToolDefinition[]): Promise<LLMResponse>;
+    /**
+     * Streaming completion via the Ollama OpenAI-compatible endpoint.
+     */
+    stream(system: string, history: HistoryMessage[], tools: ToolDefinition[]): AsyncGenerator<StreamChunk>;
+    /**
+     * Returns true when Ollama is reachable and lists {@link model}.
+     * Never throws.
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Returns the current Ollama model tag in use.
+     */
+    getVersion(): Promise<string>;
+    /**
+     * Switches the active Ollama model and rebuilds the delegate provider.
+     */
+    updateModel(newModelName: string): Promise<void>;
+    private buildDelegate;
+}

package/dist/ruby/ruby-model.js

@@ -0,0 +1,81 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.RubyModel = void 0;
+const openai_compatible_js_1 = require("../providers/openai-compatible.js");
+/**
+ * {@link LLMProvider} implementation for the Ruby Principle small model.
+ * Delegates completions to {@link OpenAICompatibleProvider} against Ollama.
+ */
+class RubyModel {
+    name = 'Ruby';
+    supportsTools = true;
+    model;
+    config;
+    delegate;
+    constructor(config) {
+        this.config = config;
+        this.model = config.modelName;
+        this.delegate = this.buildDelegate();
+    }
+    /**
+     * One-shot completion via the Ollama OpenAI-compatible endpoint.
+     */
+    async complete(system, history, tools) {
+        return this.delegate.complete(system, history, tools);
+    }
+    /**
+     * Streaming completion via the Ollama OpenAI-compatible endpoint.
+     */
+    async *stream(system, history, tools) {
+        yield* this.delegate.stream(system, history, tools);
+    }
+    /**
+     * Returns true when Ollama is reachable and lists {@link model}.
+     * Never throws.
+     */
+    async isAvailable() {
+        try {
+            const root = ollamaRoot(this.config.ollamaBaseUrl);
+            const controller = new AbortController();
+            const timer = setTimeout(() => controller.abort(), 3_000);
+            const res = await fetch(`${root}/api/tags`, { signal: controller.signal });
+            clearTimeout(timer);
+            if (!res.ok)
+                return false;
+            const body = (await res.json());
+            const names = (body.models ?? []).map(m => m.name);
+            const wanted = this.model;
+            return names.some(n => n === wanted || n.startsWith(`${wanted}:`) || n.split(':')[0] === wanted);
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Returns the current Ollama model tag in use.
+     */
+    async getVersion() {
+        return this.model;
+    }
+    /**
+     * Switches the active Ollama model and rebuilds the delegate provider.
+     */
+    async updateModel(newModelName) {
+        this.model = newModelName;
+        this.config.modelName = newModelName;
+        this.delegate = this.buildDelegate();
+    }
+    buildDelegate() {
+        return new openai_compatible_js_1.OpenAICompatibleProvider({
+            model: this.model,
+            baseUrl: this.config.ollamaBaseUrl,
+            apiKey: 'ollama',
+        }, 'Ruby');
+    }
+}
+exports.RubyModel = RubyModel;
+function ollamaRoot(baseUrl) {
+    const trimmed = (baseUrl ?? 'http://localhost:11434/v1').replace(/\/v1\/?$/, '').replace(/\/$/, '');
+    return trimmed || 'http://localhost:11434';
+}
+//# sourceMappingURL=ruby-model.js.map

package/dist/ruby/ruby-model.js.map

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