myaiforone 1.0.0

package/dist/memory/index.js

@@ -0,0 +1,159 @@
+/**
+ * MemoryManager — orchestrates advanced memory for agents.
+ * - Semantic search over stored memories
+ * - Daily memory logging
+ * - Auto-compaction (prompts agent to save before context grows too large)
+ * - Indexes context.md, daily logs, and conversation exchanges
+ */
+import { randomUUID } from "node:crypto";
+import { readFileSync, existsSync } from "node:fs";
+import { join } from "node:path";
+import { getEmbeddingProvider, buildVocab } from "./embeddings.js";
+import { createStore } from "./store.js";
+import { hybridSearch, formatSearchResults } from "./search.js";
+import { appendDailyEntry, loadRecentDaily, listDailyFiles } from "./daily.js";
+import { log } from "../logger.js";
+// ─── Chunk text into ~400 token pieces ───────────────────────────────
+function chunkText(text, maxChars = 1200) {
+    const paragraphs = text.split(/\n\n+/);
+    const chunks = [];
+    let current = "";
+    for (const para of paragraphs) {
+        if (current.length + para.length > maxChars && current.length > 0) {
+            chunks.push(current.trim());
+            current = "";
+        }
+        current += para + "\n\n";
+    }
+    if (current.trim()) {
+        chunks.push(current.trim());
+    }
+    return chunks.length > 0 ? chunks : [text];
+}
+// ─── Auto-compaction thresholds ──────────────────────────────────────
+const COMPACTION_WARN_MESSAGES = 20; // suggest compaction after 20 messages
+const COMPACTION_FORCE_MESSAGES = 40; // strongly suggest after 40
+// ─── Create MemoryManager ────────────────────────────────────────────
+export async function createMemoryManager(memoryDir) {
+    const embedder = getEmbeddingProvider();
+    const store = await createStore(memoryDir);
+    const contextPath = join(memoryDir, "context.md");
+    // Initial index if store is empty
+    const count = await store.count();
+    if (count === 0) {
+        log.info(`Memory: empty store, indexing existing files...`);
+        await indexExistingFiles(memoryDir, contextPath, embedder, store);
+    }
+    return {
+        async search(query, topK = 5) {
+            const queryVector = await embedder.embed(query);
+            const allChunks = await store.getAll();
+            return hybridSearch(queryVector, query, allChunks, { topK });
+        },
+        async searchFormatted(query, topK = 5) {
+            const queryVector = await embedder.embed(query);
+            const allChunks = await store.getAll();
+            const results = hybridSearch(queryVector, query, allChunks, { topK });
+            return formatSearchResults(results);
+        },
+        async index(text, source, metadata) {
+            const chunks = chunkText(text);
+            const vectors = await embedder.embedBatch(chunks);
+            const memoryChunks = chunks.map((text, i) => ({
+                id: `${source}-${randomUUID().slice(0, 8)}`,
+                text,
+                vector: vectors[i],
+                source,
+                timestamp: new Date().toISOString(),
+                metadata,
+            }));
+            await store.addBatch(memoryChunks);
+        },
+        async indexExchange(userMessage, agentResponse, sender) {
+            // Log to daily file
+            appendDailyEntry(memoryDir, sender, userMessage, agentResponse);
+            // Index the exchange as a memory chunk
+            const summary = `User (${sender}): ${userMessage.slice(0, 200)}\nAgent: ${agentResponse.slice(0, 400)}`;
+            const vector = await embedder.embed(summary);
+            await store.add({
+                id: `conv-${Date.now()}`,
+                text: summary,
+                vector,
+                source: "conversation",
+                timestamp: new Date().toISOString(),
+                metadata: { sender },
+            });
+        },
+        loadDailyContext() {
+            return loadRecentDaily(memoryDir);
+        },
+        async reindex() {
+            await store.clear();
+            await indexExistingFiles(memoryDir, contextPath, embedder, store);
+            log.info(`Memory: reindexed`);
+        },
+        getCompactionPrompt(messageCount) {
+            if (messageCount >= COMPACTION_FORCE_MESSAGES) {
+                return `[SYSTEM: Your conversation has reached ${messageCount} messages. Before the context gets compressed, save any important decisions, facts, or context to ${contextPath} using the Write tool. Focus on: key decisions made, user preferences learned, project state, and anything you'd need to know if starting fresh. Merge with existing content — don't overwrite.]`;
+            }
+            if (messageCount >= COMPACTION_WARN_MESSAGES) {
+                return `[SYSTEM: You're at ${messageCount} messages. Consider using /opcompact to save important context soon, or I'll remind you again at ${COMPACTION_FORCE_MESSAGES} messages.]`;
+            }
+            return null;
+        },
+        async stats() {
+            return {
+                chunks: await store.count(),
+                store: store.name,
+                embeddings: embedder.name,
+            };
+        },
+    };
+}
+// ─── Index existing files into the store ─────────────────────────────
+async function indexExistingFiles(memoryDir, contextPath, embedder, store) {
+    const allTexts = [];
+    // Index context.md
+    if (existsSync(contextPath)) {
+        try {
+            const content = readFileSync(contextPath, "utf-8").trim();
+            if (content) {
+                const chunks = chunkText(content);
+                for (const chunk of chunks) {
+                    allTexts.push({ text: chunk, source: "context", timestamp: new Date().toISOString() });
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+    // Index daily files
+    const dailyFiles = listDailyFiles(memoryDir);
+    for (const { path, date } of dailyFiles) {
+        try {
+            const content = readFileSync(path, "utf-8").trim();
+            if (content) {
+                const chunks = chunkText(content);
+                for (const chunk of chunks) {
+                    allTexts.push({ text: chunk, source: "daily", timestamp: `${date}T00:00:00.000Z` });
+                }
+            }
+        }
+        catch { /* ignore */ }
+    }
+    if (allTexts.length === 0)
+        return;
+    // Build vocab for TF-IDF (if using local embeddings)
+    buildVocab(allTexts.map(t => t.text));
+    // Embed all at once
+    const vectors = await embedder.embedBatch(allTexts.map(t => t.text));
+    const memoryChunks = allTexts.map((t, i) => ({
+        id: `${t.source}-${randomUUID().slice(0, 8)}`,
+        text: t.text,
+        vector: vectors[i],
+        source: t.source,
+        timestamp: t.timestamp,
+    }));
+    await store.addBatch(memoryChunks);
+    log.info(`Memory: indexed ${memoryChunks.length} chunks from ${dailyFiles.length} daily files + context.md`);
+}
+//# sourceMappingURL=index.js.map

package/dist/memory/index.js.map

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

package/dist/memory/search.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Hybrid semantic search: cosine similarity + BM25 keyword + temporal decay.
+ */
+import type { MemoryChunk } from "./store.js";
+export interface SearchResult {
+    chunk: MemoryChunk;
+    score: number;
+    vectorScore: number;
+    keywordScore: number;
+    decayFactor: number;
+}
+export interface SearchOptions {
+    topK?: number;
+    vectorWeight?: number;
+    keywordWeight?: number;
+    decayWeight?: number;
+    minScore?: number;
+}
+export declare function hybridSearch(queryVector: number[], queryText: string, chunks: MemoryChunk[], options?: SearchOptions): SearchResult[];
+export declare function formatSearchResults(results: SearchResult[]): string;
+//# sourceMappingURL=search.d.ts.map

package/dist/memory/search.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.d.ts","sourceRoot":"","sources":["../../src/memory/search.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,WAAW,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;CACrB;AAmDD,MAAM,WAAW,aAAa;IAC5B,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,wBAAgB,YAAY,CAC1B,WAAW,EAAE,MAAM,EAAE,EACrB,SAAS,EAAE,MAAM,EACjB,MAAM,EAAE,WAAW,EAAE,EACrB,OAAO,GAAE,aAAkB,GAC1B,YAAY,EAAE,CA+BhB;AAID,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAWnE"}

package/dist/memory/search.js

@@ -0,0 +1,77 @@
+/**
+ * Hybrid semantic search: cosine similarity + BM25 keyword + temporal decay.
+ */
+import { cosineSimilarity } from "./embeddings.js";
+// ─── BM25 keyword scoring ────────────────────────────────────────────
+const BM25_K1 = 1.2;
+const BM25_B = 0.75;
+function tokenize(text) {
+    return text.toLowerCase().replace(/[^a-z0-9\s]/g, " ").split(/\s+/).filter(t => t.length > 1);
+}
+function bm25Score(query, document, avgDocLen) {
+    const queryTokens = tokenize(query);
+    const docTokens = tokenize(document);
+    if (queryTokens.length === 0 || docTokens.length === 0)
+        return 0;
+    const docLen = docTokens.length;
+    const tf = new Map();
+    for (const t of docTokens) {
+        tf.set(t, (tf.get(t) || 0) + 1);
+    }
+    let score = 0;
+    for (const qt of queryTokens) {
+        const freq = tf.get(qt) || 0;
+        if (freq === 0)
+            continue;
+        const numerator = freq * (BM25_K1 + 1);
+        const denominator = freq + BM25_K1 * (1 - BM25_B + BM25_B * (docLen / avgDocLen));
+        score += numerator / denominator;
+    }
+    // Normalize to 0-1 range (approximate)
+    return Math.min(score / queryTokens.length, 1);
+}
+// ─── Temporal decay ──────────────────────────────────────────────────
+const HALF_LIFE_DAYS = 30;
+const DECAY_LAMBDA = Math.LN2 / HALF_LIFE_DAYS;
+function temporalDecay(timestamp, source) {
+    // context.md and manual entries never decay
+    if (source === "context" || source === "manual")
+        return 1.0;
+    const ageMs = Date.now() - new Date(timestamp).getTime();
+    const ageDays = ageMs / (1000 * 60 * 60 * 24);
+    return Math.exp(-DECAY_LAMBDA * ageDays);
+}
+export function hybridSearch(queryVector, queryText, chunks, options = {}) {
+    const { topK = 5, vectorWeight = 0.6, keywordWeight = 0.3, decayWeight = 0.1, minScore = 0.1, } = options;
+    if (chunks.length === 0)
+        return [];
+    // Average document length for BM25
+    const avgDocLen = chunks.reduce((sum, c) => sum + tokenize(c.text).length, 0) / chunks.length;
+    const results = chunks.map(chunk => {
+        const vectorScore = cosineSimilarity(queryVector, chunk.vector);
+        const keywordScore = bm25Score(queryText, chunk.text, avgDocLen);
+        const decayFactor = temporalDecay(chunk.timestamp, chunk.source);
+        const score = vectorWeight * vectorScore +
+            keywordWeight * keywordScore +
+            decayWeight * decayFactor;
+        return { chunk, score, vectorScore, keywordScore, decayFactor };
+    });
+    return results
+        .filter(r => r.score >= minScore)
+        .sort((a, b) => b.score - a.score)
+        .slice(0, topK);
+}
+// ─── Format search results for prompt injection ──────────────────────
+export function formatSearchResults(results) {
+    if (results.length === 0)
+        return "";
+    const lines = ["[Relevant Memories]"];
+    for (const r of results) {
+        const date = r.chunk.timestamp.split("T")[0];
+        const source = r.chunk.source;
+        lines.push(`- [${date}/${source}] ${r.chunk.text}`);
+    }
+    lines.push("[/Relevant Memories]");
+    return lines.join("\n");
+}
+//# sourceMappingURL=search.js.map

package/dist/memory/search.js.map

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

package/dist/memory/store.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Vector store — JSON default, auto-upgrades to SQLite if better-sqlite3 is available.
+ * Stores text chunks with their embedding vectors for semantic search.
+ */
+export interface MemoryChunk {
+    id: string;
+    text: string;
+    vector: number[];
+    source: string;
+    timestamp: string;
+    metadata?: Record<string, string>;
+}
+export interface VectorStore {
+    name: string;
+    add(chunk: MemoryChunk): Promise<void>;
+    addBatch(chunks: MemoryChunk[]): Promise<void>;
+    getAll(): Promise<MemoryChunk[]>;
+    remove(id: string): Promise<void>;
+    clear(): Promise<void>;
+    count(): Promise<number>;
+}
+export declare function createStore(memoryDir: string): Promise<VectorStore>;
+//# sourceMappingURL=store.d.ts.map

package/dist/memory/store.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"store.d.ts","sourceRoot":"","sources":["../../src/memory/store.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAMH,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,KAAK,EAAE,WAAW,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IACvC,QAAQ,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAC/C,MAAM,IAAI,OAAO,CAAC,WAAW,EAAE,CAAC,CAAC;IACjC,MAAM,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAClC,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;IACvB,KAAK,IAAI,OAAO,CAAC,MAAM,CAAC,CAAC;CAC1B;AA0JD,wBAAsB,WAAW,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,WAAW,CAAC,CAQzE"}

package/dist/memory/store.js

@@ -0,0 +1,144 @@
+/**
+ * Vector store — JSON default, auto-upgrades to SQLite if better-sqlite3 is available.
+ * Stores text chunks with their embedding vectors for semantic search.
+ */
+import { readFileSync, writeFileSync, existsSync, mkdirSync } from "node:fs";
+import { join } from "node:path";
+import { log } from "../logger.js";
+// ─── JSON Store (default) ────────────────────────────────────────────
+class JSONStore {
+    name = "json";
+    filePath;
+    chunks = [];
+    loaded = false;
+    constructor(memoryDir) {
+        mkdirSync(memoryDir, { recursive: true });
+        this.filePath = join(memoryDir, "vectors.json");
+    }
+    load() {
+        if (this.loaded)
+            return;
+        if (existsSync(this.filePath)) {
+            try {
+                this.chunks = JSON.parse(readFileSync(this.filePath, "utf-8"));
+            }
+            catch {
+                this.chunks = [];
+            }
+        }
+        this.loaded = true;
+    }
+    save() {
+        writeFileSync(this.filePath, JSON.stringify(this.chunks));
+    }
+    async add(chunk) {
+        this.load();
+        // Replace if same ID exists
+        this.chunks = this.chunks.filter(c => c.id !== chunk.id);
+        this.chunks.push(chunk);
+        this.save();
+    }
+    async addBatch(chunks) {
+        this.load();
+        const newIds = new Set(chunks.map(c => c.id));
+        this.chunks = this.chunks.filter(c => !newIds.has(c.id));
+        this.chunks.push(...chunks);
+        this.save();
+    }
+    async getAll() {
+        this.load();
+        return [...this.chunks];
+    }
+    async remove(id) {
+        this.load();
+        this.chunks = this.chunks.filter(c => c.id !== id);
+        this.save();
+    }
+    async clear() {
+        this.chunks = [];
+        this.loaded = true;
+        this.save();
+    }
+    async count() {
+        this.load();
+        return this.chunks.length;
+    }
+}
+// ─── SQLite Store (auto-upgrade if available) ────────────────────────
+async function trySQLiteStore(memoryDir) {
+    try {
+        // Dynamic import — only works if better-sqlite3 is installed
+        // Use createRequire to avoid TypeScript module resolution errors
+        const { createRequire } = await import("node:module");
+        const require = createRequire(import.meta.url);
+        const Database = require("better-sqlite3");
+        const dbPath = join(memoryDir, "vectors.sqlite");
+        const db = new Database(dbPath);
+        // Create table
+        db.exec(`
+      CREATE TABLE IF NOT EXISTS chunks (
+        id TEXT PRIMARY KEY,
+        text TEXT NOT NULL,
+        vector TEXT NOT NULL,
+        source TEXT NOT NULL,
+        timestamp TEXT NOT NULL,
+        metadata TEXT
+      )
+    `);
+        const store = {
+            name: "sqlite",
+            async add(chunk) {
+                db.prepare(`
+          INSERT OR REPLACE INTO chunks (id, text, vector, source, timestamp, metadata)
+          VALUES (?, ?, ?, ?, ?, ?)
+        `).run(chunk.id, chunk.text, JSON.stringify(chunk.vector), chunk.source, chunk.timestamp, chunk.metadata ? JSON.stringify(chunk.metadata) : null);
+            },
+            async addBatch(chunks) {
+                const stmt = db.prepare(`
+          INSERT OR REPLACE INTO chunks (id, text, vector, source, timestamp, metadata)
+          VALUES (?, ?, ?, ?, ?, ?)
+        `);
+                const tx = db.transaction((items) => {
+                    for (const c of items) {
+                        stmt.run(c.id, c.text, JSON.stringify(c.vector), c.source, c.timestamp, c.metadata ? JSON.stringify(c.metadata) : null);
+                    }
+                });
+                tx(chunks);
+            },
+            async getAll() {
+                const rows = db.prepare("SELECT * FROM chunks").all();
+                return rows.map(r => ({
+                    id: r.id, text: r.text, vector: JSON.parse(r.vector),
+                    source: r.source, timestamp: r.timestamp,
+                    metadata: r.metadata ? JSON.parse(r.metadata) : undefined,
+                }));
+            },
+            async remove(id) {
+                db.prepare("DELETE FROM chunks WHERE id = ?").run(id);
+            },
+            async clear() {
+                db.exec("DELETE FROM chunks");
+            },
+            async count() {
+                const row = db.prepare("SELECT COUNT(*) as cnt FROM chunks").get();
+                return row.cnt;
+            },
+        };
+        log.info("Memory store: SQLite (better-sqlite3)");
+        return store;
+    }
+    catch {
+        return null;
+    }
+}
+// ─── Store factory ───────────────────────────────────────────────────
+export async function createStore(memoryDir) {
+    // Try SQLite first
+    const sqlite = await trySQLiteStore(memoryDir);
+    if (sqlite)
+        return sqlite;
+    // Fall back to JSON
+    log.info("Memory store: JSON (install better-sqlite3 for faster search at scale)");
+    return new JSONStore(memoryDir);
+}
+//# sourceMappingURL=store.js.map

package/dist/memory/store.js.map

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

package/dist/ollama-executor.d.ts

@@ -0,0 +1,17 @@
+export interface OllamaOptions {
+    model: string;
+    systemPrompt: string;
+    message: string;
+    baseUrl?: string;
+    timeout?: number;
+}
+export declare function executeOllama(opts: OllamaOptions): Promise<string>;
+export declare function streamOllama(opts: OllamaOptions): AsyncGenerator<string>;
+/**
+ * Check if Ollama is running and the model is available
+ */
+export declare function checkOllamaHealth(baseUrl?: string, model?: string): Promise<{
+    ok: boolean;
+    error?: string;
+}>;
+//# sourceMappingURL=ollama-executor.d.ts.map

package/dist/ollama-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ollama-executor.d.ts","sourceRoot":"","sources":["../src/ollama-executor.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,aAAa;IAC5B,KAAK,EAAE,MAAM,CAAC;IACd,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,wBAAsB,aAAa,CAAC,IAAI,EAAE,aAAa,GAAG,OAAO,CAAC,MAAM,CAAC,CAyCxE;AAED,wBAAuB,YAAY,CAAC,IAAI,EAAE,aAAa,GAAG,cAAc,CAAC,MAAM,CAAC,CAmD/E;AAED;;GAEG;AACH,wBAAsB,iBAAiB,CAAC,OAAO,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAgBlH"}

package/dist/ollama-executor.js

@@ -0,0 +1,112 @@
+import { log } from "./logger.js";
+export async function executeOllama(opts) {
+    const baseUrl = opts.baseUrl || "http://localhost:11434";
+    const timeout = opts.timeout || 300_000;
+    log.info(`[Ollama] Executing ${opts.model}: ${opts.message.slice(0, 200)}`);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+        const res = await fetch(`${baseUrl}/api/chat`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                model: opts.model,
+                messages: [
+                    { role: "system", content: opts.systemPrompt },
+                    { role: "user", content: opts.message },
+                ],
+                stream: false,
+            }),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            log.error(`[Ollama] Error ${res.status}: ${errText}`);
+            throw new Error(`Ollama API error ${res.status}: ${errText}`);
+        }
+        const data = await res.json();
+        if (data.error) {
+            throw new Error(`Ollama error: ${data.error}`);
+        }
+        const response = data.message?.content || "";
+        log.info(`[Ollama] Response from ${opts.model}: ${response.slice(0, 200)}`);
+        return response;
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+export async function* streamOllama(opts) {
+    const baseUrl = opts.baseUrl || "http://localhost:11434";
+    const timeout = opts.timeout || 300_000;
+    log.info(`[Ollama] Streaming ${opts.model}: ${opts.message.slice(0, 200)}`);
+    const controller = new AbortController();
+    const timer = setTimeout(() => controller.abort(), timeout);
+    try {
+        const res = await fetch(`${baseUrl}/api/chat`, {
+            method: "POST",
+            headers: { "Content-Type": "application/json" },
+            body: JSON.stringify({
+                model: opts.model,
+                messages: [
+                    { role: "system", content: opts.systemPrompt },
+                    { role: "user", content: opts.message },
+                ],
+                stream: true,
+            }),
+            signal: controller.signal,
+        });
+        if (!res.ok) {
+            const errText = await res.text();
+            throw new Error(`Ollama API error ${res.status}: ${errText}`);
+        }
+        const reader = res.body?.getReader();
+        if (!reader)
+            throw new Error("No response body");
+        const decoder = new TextDecoder();
+        while (true) {
+            const { done, value } = await reader.read();
+            if (done)
+                break;
+            const chunk = decoder.decode(value, { stream: true });
+            // Ollama streams newline-delimited JSON
+            for (const line of chunk.split("\n")) {
+                if (!line.trim())
+                    continue;
+                try {
+                    const parsed = JSON.parse(line);
+                    if (parsed.message?.content) {
+                        yield parsed.message.content;
+                    }
+                }
+                catch { /* skip unparseable lines */ }
+            }
+        }
+    }
+    finally {
+        clearTimeout(timer);
+    }
+}
+/**
+ * Check if Ollama is running and the model is available
+ */
+export async function checkOllamaHealth(baseUrl, model) {
+    const url = baseUrl || "http://localhost:11434";
+    try {
+        const res = await fetch(`${url}/api/tags`);
+        if (!res.ok)
+            return { ok: false, error: `Ollama not responding (${res.status})` };
+        if (model) {
+            const data = await res.json();
+            const models = data.models?.map(m => m.name.replace(/:latest$/, "")) || [];
+            if (!models.some(m => m === model || m.startsWith(model + ":"))) {
+                return { ok: false, error: `Model "${model}" not found. Available: ${models.join(", ")}` };
+            }
+        }
+        return { ok: true };
+    }
+    catch (err) {
+        return { ok: false, error: `Ollama not running at ${url}: ${err}` };
+    }
+}
+//# sourceMappingURL=ollama-executor.js.map

package/dist/ollama-executor.js.map

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

package/dist/openai-executor.d.ts

@@ -0,0 +1,38 @@
+/**
+ * OpenAI-compatible executor — handles OpenAI, xAI (Grok), Groq, Together, Mistral,
+ * and any other provider that implements the OpenAI Chat Completions API.
+ *
+ * Executor format: "openai:gpt-4o", "grok:grok-3", "groq:llama-3.3-70b-versatile",
+ *                  "together:meta-llama/Llama-3.3-70B-Instruct", "mistral:mistral-large-latest"
+ */
+export interface ProviderConfig {
+    name: string;
+    baseUrl: string;
+    keyField: string;
+    modelsEndpoint?: string;
+}
+export declare const PROVIDERS: Record<string, ProviderConfig>;
+export interface OpenAICompatOptions {
+    provider: string;
+    model: string;
+    apiKey: string;
+    systemPrompt: string;
+    message: string;
+    baseUrl?: string;
+    timeout?: number;
+    temperature?: number;
+    maxTokens?: number;
+}
+export declare function executeOpenAICompat(opts: OpenAICompatOptions): Promise<string>;
+export declare function streamOpenAICompat(opts: OpenAICompatOptions): AsyncGenerator<string>;
+export declare function checkOpenAICompatHealth(provider: string, apiKey: string, baseUrl?: string): Promise<{
+    ok: boolean;
+    error?: string;
+    models?: string[];
+}>;
+/**
+ * Resolve provider prefix to config.
+ * Returns null if the prefix is not an OpenAI-compatible provider.
+ */
+export declare function resolveProvider(prefix: string): ProviderConfig | null;
+//# sourceMappingURL=openai-executor.d.ts.map

package/dist/openai-executor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"openai-executor.d.ts","sourceRoot":"","sources":["../src/openai-executor.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,eAAO,MAAM,SAAS,EAAE,MAAM,CAAC,MAAM,EAAE,cAAc,CA0BpD,CAAC;AAGF,MAAM,WAAW,mBAAmB;IAClC,QAAQ,EAAE,MAAM,CAAC;IACjB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,EAAE,MAAM,CAAC;IACf,YAAY,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAqBD,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,mBAAmB,GAAG,OAAO,CAAC,MAAM,CAAC,CAiEpF;AAGD,wBAAuB,kBAAkB,CAAC,IAAI,EAAE,mBAAmB,GAAG,cAAc,CAAC,MAAM,CAAC,CAsE3F;AAGD,wBAAsB,uBAAuB,CAC3C,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,MAAM,EACd,OAAO,CAAC,EAAE,MAAM,GACf,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAAC,CA2B7D;AAED;;;GAGG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,GAAG,cAAc,GAAG,IAAI,CAErE"}