@osmosis-ai/core 0.1.0

package/dist/api/index.d.ts

@@ -0,0 +1,12 @@
+import { type Server } from 'node:http';
+import { AtomStore } from '../store/index.js';
+/**
+ * Create an HTTP server for the AtomStore.
+ *
+ * Routes:
+ *   POST   /atoms              — create atom (validates, dedup, insert)
+ *   GET    /atoms               — list/filter atoms (?type=, ?tool_name=)
+ *   GET    /atoms/search?q=     — text search
+ *   GET    /atoms/:id           — get single atom
+ */
+export declare function createServer(store: AtomStore, port?: number): Server;

package/dist/api/index.js

@@ -0,0 +1,87 @@
+import { createServer as createHttpServer } from 'node:http';
+function json(res, status, data) {
+    res.writeHead(status, { 'Content-Type': 'application/json' });
+    res.end(JSON.stringify(data));
+}
+function readBody(req) {
+    return new Promise((resolve, reject) => {
+        const chunks = [];
+        req.on('data', (c) => chunks.push(c));
+        req.on('end', () => resolve(Buffer.concat(chunks).toString()));
+        req.on('error', reject);
+    });
+}
+/**
+ * Create an HTTP server for the AtomStore.
+ *
+ * Routes:
+ *   POST   /atoms              — create atom (validates, dedup, insert)
+ *   GET    /atoms               — list/filter atoms (?type=, ?tool_name=)
+ *   GET    /atoms/search?q=     — text search
+ *   GET    /atoms/:id           — get single atom
+ */
+export function createServer(store, port = 3917) {
+    const server = createHttpServer(async (req, res) => {
+        const url = new URL(req.url ?? '/', `http://localhost:${port}`);
+        const path = url.pathname;
+        const method = req.method ?? 'GET';
+        try {
+            // POST /atoms
+            if (method === 'POST' && path === '/atoms') {
+                const body = JSON.parse(await readBody(req));
+                let atom;
+                if (body.type === 'tool') {
+                    atom = store.createToolAtom(body);
+                }
+                else if (body.type === 'negative') {
+                    atom = store.createNegativeAtom(body);
+                }
+                else {
+                    atom = store.createAtom(body);
+                }
+                return json(res, 201, atom);
+            }
+            // GET /atoms/search?q=...
+            if (method === 'GET' && path === '/atoms/search') {
+                const q = url.searchParams.get('q') ?? '';
+                return json(res, 200, store.search(q));
+            }
+            // GET /atoms/:id
+            const idMatch = path.match(/^\/atoms\/([^/]+)$/);
+            if (method === 'GET' && idMatch) {
+                const atom = store.getById(idMatch[1]);
+                if (!atom)
+                    return json(res, 404, { error: 'Not found' });
+                return json(res, 200, atom);
+            }
+            // GET /atoms?type=&tool_name=&since=
+            if (method === 'GET' && path === '/atoms') {
+                const type = url.searchParams.get('type');
+                const toolName = url.searchParams.get('tool_name');
+                const since = url.searchParams.get('since');
+                let atoms;
+                if (toolName) {
+                    atoms = store.queryByToolName(toolName);
+                }
+                else if (type) {
+                    atoms = store.queryByType(type);
+                }
+                else {
+                    atoms = store.getAll();
+                }
+                if (since) {
+                    atoms = atoms.filter(a => a.updated_at > since);
+                }
+                return json(res, 200, atoms);
+            }
+            json(res, 404, { error: 'Not found' });
+        }
+        catch (err) {
+            const status = err.name === 'ZodError' ? 400 : 500;
+            json(res, status, { error: err.message ?? 'Internal error' });
+        }
+    });
+    server.listen(port);
+    return server;
+}
+//# sourceMappingURL=index.js.map

package/dist/api/index.js.map

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

package/dist/capture/index.d.ts

@@ -0,0 +1,10 @@
+import type { OutcomeSignals } from '../types/index.js';
+import { AtomStore } from '../store/index.js';
+/**
+ * Capture a tool call and persist it as a ToolAtom in the local store.
+ */
+export declare function captureToolCall(store: AtomStore, toolName: string, params: Record<string, unknown>, result: unknown, error?: string | null, latencyMs?: number | null): string;
+/**
+ * Capture outcome signals for a task and persist as a base atom.
+ */
+export declare function captureOutcome(store: AtomStore, taskId: string, signals: OutcomeSignals): string;

package/dist/capture/index.js

@@ -0,0 +1,52 @@
+import { createHash } from 'node:crypto';
+/**
+ * Capture a tool call and persist it as a ToolAtom in the local store.
+ */
+export function captureToolCall(store, toolName, params, result, error, latencyMs) {
+    const paramsHash = createHash('sha256').update(JSON.stringify(params)).digest('hex').slice(0, 16);
+    const outcome = error ? 'failure' : 'success';
+    const atom = store.createToolAtom({
+        type: 'tool',
+        observation: error
+            ? `Tool "${toolName}" failed: ${error}`
+            : `Tool "${toolName}" succeeded`,
+        context: JSON.stringify({ params_summary: Object.keys(params), has_result: result != null }),
+        confidence: error ? 0.3 : 0.7,
+        fitness_score: error ? 0.2 : 0.8,
+        trust_tier: 'local',
+        source_agent_hash: 'local',
+        decay_rate: 0.99,
+        tool_name: toolName,
+        params_hash: paramsHash,
+        outcome,
+        error_signature: error ?? null,
+        latency_ms: latencyMs ?? null,
+        reliability_score: error ? 0.0 : 1.0,
+    });
+    return atom.id;
+}
+/**
+ * Capture outcome signals for a task and persist as a base atom.
+ */
+export function captureOutcome(store, taskId, signals) {
+    // Score using PRD v1 weights:
+    // completion without error (0.3), no revisit within 1hr (0.2),
+    // human acceptance (0.3), convergence speed (0.1), error-free (0.1)
+    const score = (signals.completed_without_error ? 0.3 : 0) +
+        (!signals.revisited_within_1hr ? 0.2 : 0) +
+        (signals.human_accepted === true ? 0.3 : signals.human_accepted === null ? 0.15 : 0) +
+        Math.max(0, 0.1 * (1 - signals.convergence_steps / 20)) +
+        (signals.error_free ? 0.1 : 0);
+    const atom = store.createAtom({
+        type: 'context',
+        observation: `Task ${taskId} outcome: score=${score.toFixed(3)}`,
+        context: JSON.stringify(signals),
+        confidence: score,
+        fitness_score: score,
+        trust_tier: 'local',
+        source_agent_hash: 'local',
+        decay_rate: 0.99,
+    });
+    return atom.id;
+}
+//# sourceMappingURL=index.js.map

package/dist/capture/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/capture/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAc,MAAM,aAAa,CAAC;AAIrD;;GAEG;AACH,MAAM,UAAU,eAAe,CAC7B,KAAgB,EAChB,QAAgB,EAChB,MAA+B,EAC/B,MAAe,EACf,KAAqB,EACrB,SAAyB;IAEzB,MAAM,UAAU,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;IAClG,MAAM,OAAO,GAAY,KAAK,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC;IAEvD,MAAM,IAAI,GAAG,KAAK,CAAC,cAAc,CAAC;QAChC,IAAI,EAAE,MAAM;QACZ,WAAW,EAAE,KAAK;YAChB,CAAC,CAAC,SAAS,QAAQ,aAAa,KAAK,EAAE;YACvC,CAAC,CAAC,SAAS,QAAQ,aAAa;QAClC,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,IAAI,IAAI,EAAE,CAAC;QAC5F,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QAC7B,aAAa,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;QAChC,UAAU,EAAE,OAAO;QACnB,iBAAiB,EAAE,OAAO;QAC1B,UAAU,EAAE,IAAI;QAChB,SAAS,EAAE,QAAQ;QACnB,WAAW,EAAE,UAAU;QACvB,OAAO;QACP,eAAe,EAAE,KAAK,IAAI,IAAI;QAC9B,UAAU,EAAE,SAAS,IAAI,IAAI;QAC7B,iBAAiB,EAAE,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG;KACrC,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,cAAc,CAC5B,KAAgB,EAChB,MAAc,EACd,OAAuB;IAEvB,8BAA8B;IAC9B,+DAA+D;IAC/D,oEAAoE;IACpE,MAAM,KAAK,GACT,CAAC,OAAO,CAAC,uBAAuB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3C,CAAC,CAAC,OAAO,CAAC,oBAAoB,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC;QACzC,CAAC,OAAO,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,cAAc,KAAK,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;QACpF,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,GAAG,GAAG,CAAC,CAAC,GAAG,OAAO,CAAC,iBAAiB,GAAG,EAAE,CAAC,CAAC;QACvD,CAAC,OAAO,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IAEjC,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC;QAC5B,IAAI,EAAE,SAAS;QACf,WAAW,EAAE,QAAQ,MAAM,mBAAmB,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE;QAChE,OAAO,EAAE,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC;QAChC,UAAU,EAAE,KAAK;QACjB,aAAa,EAAE,KAAK;QACpB,UAAU,EAAE,OAAO;QACnB,iBAAiB,EAAE,OAAO;QAC1B,UAAU,EAAE,IAAI;KACjB,CAAC,CAAC;IAEH,OAAO,IAAI,CAAC,EAAE,CAAC;AACjB,CAAC"}

package/dist/distill/index.d.ts

@@ -0,0 +1,35 @@
+import type { KnowledgeAtom } from '../types/index.js';
+export interface ToolTrace {
+    toolName: string;
+    params: Record<string, unknown>;
+    result: unknown;
+    error: string | null;
+    latencyMs: number;
+    outcome: 'success' | 'failure' | 'partial';
+    agentId: string;
+    timestamp: string;
+}
+export type DistillFn = (trace: ToolTrace) => Promise<KnowledgeAtom | null>;
+/**
+ * Stub distillation — returns null. Will be replaced with LLM call later.
+ */
+export declare function distillTrace(_trace: ToolTrace): Promise<KnowledgeAtom | null>;
+export declare class BatchDistiller {
+    private buffer;
+    private readonly batchSize;
+    private readonly distillFn;
+    constructor(options?: {
+        batchSize?: number;
+        distillFn?: DistillFn;
+    });
+    /** Add a trace to the buffer. Returns true if batch is full. */
+    add(trace: ToolTrace): boolean;
+    /** Number of pending traces */
+    get pending(): number;
+    /** Check if batch is ready to process */
+    get ready(): boolean;
+    /** Flush and process the current batch. Returns distilled atoms (nulls filtered). */
+    flush(): Promise<KnowledgeAtom[]>;
+    /** Drain all traces without processing */
+    drain(): ToolTrace[];
+}

package/dist/distill/index.js

@@ -0,0 +1,41 @@
+/**
+ * Stub distillation — returns null. Will be replaced with LLM call later.
+ */
+export async function distillTrace(_trace) {
+    // Stub: actual LLM distillation will be implemented in a later phase
+    return null;
+}
+// ── BatchDistiller ───────────────────────────────────────────
+export class BatchDistiller {
+    buffer = [];
+    batchSize;
+    distillFn;
+    constructor(options) {
+        this.batchSize = options?.batchSize ?? 10;
+        this.distillFn = options?.distillFn ?? distillTrace;
+    }
+    /** Add a trace to the buffer. Returns true if batch is full. */
+    add(trace) {
+        this.buffer.push(trace);
+        return this.buffer.length >= this.batchSize;
+    }
+    /** Number of pending traces */
+    get pending() {
+        return this.buffer.length;
+    }
+    /** Check if batch is ready to process */
+    get ready() {
+        return this.buffer.length >= this.batchSize;
+    }
+    /** Flush and process the current batch. Returns distilled atoms (nulls filtered). */
+    async flush() {
+        const batch = this.buffer.splice(0);
+        const results = await Promise.all(batch.map(t => this.distillFn(t)));
+        return results.filter((a) => a !== null);
+    }
+    /** Drain all traces without processing */
+    drain() {
+        return this.buffer.splice(0);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/distill/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/distill/index.ts"],"names":[],"mappings":"AAiBA;;GAEG;AACH,MAAM,CAAC,KAAK,UAAU,YAAY,CAAC,MAAiB;IAClD,qEAAqE;IACrE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,gEAAgE;AAChE,MAAM,OAAO,cAAc;IACjB,MAAM,GAAgB,EAAE,CAAC;IAChB,SAAS,CAAS;IAClB,SAAS,CAAY;IAEtC,YAAY,OAAuD;QACjE,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,EAAE,CAAC;QAC1C,IAAI,CAAC,SAAS,GAAG,OAAO,EAAE,SAAS,IAAI,YAAY,CAAC;IACtD,CAAC;IAED,gEAAgE;IAChE,GAAG,CAAC,KAAgB;QAClB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;QACxB,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC;IAC9C,CAAC;IAED,+BAA+B;IAC/B,IAAI,OAAO;QACT,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC;IAC5B,CAAC;IAED,yCAAyC;IACzC,IAAI,KAAK;QACP,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,IAAI,IAAI,CAAC,SAAS,CAAC;IAC9C,CAAC;IAED,qFAAqF;IACrF,KAAK,CAAC,KAAK;QACT,MAAM,KAAK,GAAG,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;QACpC,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QACrE,OAAO,OAAO,CAAC,MAAM,CAAC,CAAC,CAAC,EAAsB,EAAE,CAAC,CAAC,KAAK,IAAI,CAAC,CAAC;IAC/D,CAAC;IAED,0CAA0C;IAC1C,KAAK;QACH,OAAO,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC;IAC/B,CAAC;CACF"}

package/dist/fitness/index.d.ts

@@ -0,0 +1,14 @@
+import type { AtomStore } from '../store/index.js';
+/**
+ * Calculate fitness for a single atom using the PRD formula:
+ *   fitness = usage_rate × success_ratio × recency_factor
+ *
+ * - usage_rate = use_count / max(1, max_use_count_across_all)  — normalized
+ * - success_ratio = success_after_use / max(1, success_after_use + failure_after_use)
+ * - recency_factor = exp(-λ × days_since_last_use), λ = 0.05
+ */
+export declare function computeFitness(useCount: number, successAfterUse: number, failureAfterUse: number, lastUsed: string | null, maxUseCount: number, now?: Date): number;
+/**
+ * Batch-recalculate fitness for all atoms in the store.
+ */
+export declare function recalculateFitness(store: AtomStore): void;

package/dist/fitness/index.js

@@ -0,0 +1,39 @@
+/**
+ * Calculate fitness for a single atom using the PRD formula:
+ *   fitness = usage_rate × success_ratio × recency_factor
+ *
+ * - usage_rate = use_count / max(1, max_use_count_across_all)  — normalized
+ * - success_ratio = success_after_use / max(1, success_after_use + failure_after_use)
+ * - recency_factor = exp(-λ × days_since_last_use), λ = 0.05
+ */
+export function computeFitness(useCount, successAfterUse, failureAfterUse, lastUsed, maxUseCount, now = new Date()) {
+    const usageRate = maxUseCount > 0 ? useCount / maxUseCount : 0;
+    const total = successAfterUse + failureAfterUse;
+    const successRatio = total > 0 ? successAfterUse / total : 0.5; // neutral if unused
+    const daysSinceUse = lastUsed
+        ? Math.max(0, (now.getTime() - new Date(lastUsed).getTime()) / (1000 * 60 * 60 * 24))
+        : 30; // default to 30 days if never used
+    const lambda = 0.05;
+    const recencyFactor = Math.exp(-lambda * daysSinceUse);
+    return Math.min(1, Math.max(0, usageRate * successRatio * recencyFactor));
+}
+/**
+ * Batch-recalculate fitness for all atoms in the store.
+ */
+export function recalculateFitness(store) {
+    const atoms = store.getAll();
+    // Find max use_count for normalization
+    let maxUseCount = 1;
+    for (const atom of atoms) {
+        const uc = atom.use_count ?? 0;
+        if (uc > maxUseCount)
+            maxUseCount = uc;
+    }
+    const now = new Date();
+    for (const atom of atoms) {
+        const a = atom;
+        const score = computeFitness(a.use_count ?? 0, a.success_after_use ?? 0, a.failure_after_use ?? 0, a.last_used ?? null, maxUseCount, now);
+        store.updateFitnessScore(atom.id, score);
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/fitness/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/fitness/index.ts"],"names":[],"mappings":"AAEA;;;;;;;GAOG;AACH,MAAM,UAAU,cAAc,CAC5B,QAAgB,EAChB,eAAuB,EACvB,eAAuB,EACvB,QAAuB,EACvB,WAAmB,EACnB,MAAY,IAAI,IAAI,EAAE;IAEtB,MAAM,SAAS,GAAG,WAAW,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC,CAAC;IAC/D,MAAM,KAAK,GAAG,eAAe,GAAG,eAAe,CAAC;IAChD,MAAM,YAAY,GAAG,KAAK,GAAG,CAAC,CAAC,CAAC,CAAC,eAAe,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,oBAAoB;IACpF,MAAM,YAAY,GAAG,QAAQ;QAC3B,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC,GAAG,CAAC,OAAO,EAAE,GAAG,IAAI,IAAI,CAAC,QAAQ,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,IAAI,GAAG,EAAE,GAAG,EAAE,GAAG,EAAE,CAAC,CAAC;QACrF,CAAC,CAAC,EAAE,CAAC,CAAC,mCAAmC;IAC3C,MAAM,MAAM,GAAG,IAAI,CAAC;IACpB,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,MAAM,GAAG,YAAY,CAAC,CAAC;IAEvD,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,SAAS,GAAG,YAAY,GAAG,aAAa,CAAC,CAAC,CAAC;AAC5E,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,kBAAkB,CAAC,KAAgB;IACjD,MAAM,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC;IAC7B,uCAAuC;IACvC,IAAI,WAAW,GAAG,CAAC,CAAC;IACpB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,EAAE,GAAI,IAAY,CAAC,SAAS,IAAI,CAAC,CAAC;QACxC,IAAI,EAAE,GAAG,WAAW;YAAE,WAAW,GAAG,EAAE,CAAC;IACzC,CAAC;IAED,MAAM,GAAG,GAAG,IAAI,IAAI,EAAE,CAAC;IACvB,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,MAAM,CAAC,GAAG,IAAW,CAAC;QACtB,MAAM,KAAK,GAAG,cAAc,CAC1B,CAAC,CAAC,SAAS,IAAI,CAAC,EAChB,CAAC,CAAC,iBAAiB,IAAI,CAAC,EACxB,CAAC,CAAC,iBAAiB,IAAI,CAAC,EACxB,CAAC,CAAC,SAAS,IAAI,IAAI,EACnB,WAAW,EACX,GAAG,CACJ,CAAC;QACF,KAAK,CAAC,kBAAkB,CAAC,IAAI,CAAC,EAAE,EAAE,KAAK,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,10 @@
+export type { KnowledgeAtom, ToolAtom, NegativeAtom, PatternAtom, SkillAtom, ContextAtom, AnyAtom, OutcomeSignals, CreateAtom, CreateToolAtom, CreateNegativeAtom, AtomType, TrustTier, Outcome, Severity, } from './types/index.js';
+export { AtomStore, jaccardSimilarity } from './store/index.js';
+export { captureToolCall, captureOutcome } from './capture/index.js';
+export { CreateAtomSchema, CreateToolAtomSchema, CreateNegativeAtomSchema, OutcomeSignalsSchema, validateCreateAtom, validateCreateToolAtom, validateCreateNegativeAtom, } from './validation/index.js';
+export { computeFitness, recalculateFitness } from './fitness/index.js';
+export { createServer } from './api/index.js';
+export { searchAtoms, getTopAtoms } from './retrieval/index.js';
+export { distillTrace, BatchDistiller } from './distill/index.js';
+export type { ToolTrace, DistillFn } from './distill/index.js';
+export { seedAtoms } from './seeds/index.js';

package/dist/index.js

@@ -0,0 +1,17 @@
+// Store
+export { AtomStore, jaccardSimilarity } from './store/index.js';
+// Capture
+export { captureToolCall, captureOutcome } from './capture/index.js';
+// Validation
+export { CreateAtomSchema, CreateToolAtomSchema, CreateNegativeAtomSchema, OutcomeSignalsSchema, validateCreateAtom, validateCreateToolAtom, validateCreateNegativeAtom, } from './validation/index.js';
+// Fitness
+export { computeFitness, recalculateFitness } from './fitness/index.js';
+// API
+export { createServer } from './api/index.js';
+// Retrieval
+export { searchAtoms, getTopAtoms } from './retrieval/index.js';
+// Distill
+export { distillTrace, BatchDistiller } from './distill/index.js';
+// Seeds
+export { seedAtoms } from './seeds/index.js';
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAmBA,QAAQ;AACR,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAEhE,UAAU;AACV,OAAO,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAErE,aAAa;AACb,OAAO,EACL,gBAAgB,EAChB,oBAAoB,EACpB,wBAAwB,EACxB,oBAAoB,EACpB,kBAAkB,EAClB,sBAAsB,EACtB,0BAA0B,GAC3B,MAAM,uBAAuB,CAAC;AAE/B,UAAU;AACV,OAAO,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExE,MAAM;AACN,OAAO,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAE9C,YAAY;AACZ,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAEhE,UAAU;AACV,OAAO,EAAE,YAAY,EAAE,cAAc,EAAE,MAAM,oBAAoB,CAAC;AAGlE,QAAQ;AACR,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC"}

package/dist/retrieval/index.d.ts

@@ -0,0 +1,11 @@
+import type { KnowledgeAtom, AtomType } from '../types/index.js';
+import type { AtomStore } from '../store/index.js';
+/**
+ * Search atoms using FTS5 full-text search, ranked by relevance × fitness_score.
+ * Falls back to LIKE search if FTS table doesn't exist.
+ */
+export declare function searchAtoms(store: AtomStore, query: string, limit?: number): KnowledgeAtom[];
+/**
+ * Get top atoms by fitness score, optionally filtered by type.
+ */
+export declare function getTopAtoms(store: AtomStore, type?: AtomType, limit?: number): KnowledgeAtom[];

package/dist/retrieval/index.js

@@ -0,0 +1,51 @@
+/**
+ * Search atoms using FTS5 full-text search, ranked by relevance × fitness_score.
+ * Falls back to LIKE search if FTS table doesn't exist.
+ */
+export function searchAtoms(store, query, limit = 10) {
+    const db = store.db;
+    // Ensure FTS5 table exists
+    try {
+        db.exec(`
+      CREATE VIRTUAL TABLE IF NOT EXISTS atoms_fts USING fts5(
+        id UNINDEXED, observation, context, content=atoms, content_rowid=rowid
+      );
+    `);
+        // Rebuild FTS index from current atoms
+        db.exec(`INSERT OR REPLACE INTO atoms_fts(atoms_fts) VALUES('rebuild')`);
+    }
+    catch {
+        // FTS5 not available, fall back to LIKE
+        return store.search(query).slice(0, limit);
+    }
+    try {
+        // Escape FTS5 special chars
+        const escaped = query.replace(/['"*()]/g, ' ').trim();
+        if (!escaped)
+            return [];
+        const rows = db.prepare(`
+      SELECT a.*, bm25(atoms_fts) as rank
+      FROM atoms_fts f
+      JOIN atoms a ON a.id = f.id
+      WHERE atoms_fts MATCH ?
+      ORDER BY (bm25(atoms_fts) * -1) * a.fitness_score DESC
+      LIMIT ?
+    `).all(escaped, limit);
+        return rows.map(({ rank, ...atom }) => atom);
+    }
+    catch {
+        // Fall back to LIKE search
+        return store.search(query).slice(0, limit);
+    }
+}
+/**
+ * Get top atoms by fitness score, optionally filtered by type.
+ */
+export function getTopAtoms(store, type, limit = 10) {
+    const db = store.db;
+    if (type) {
+        return db.prepare('SELECT * FROM atoms WHERE type = ? ORDER BY fitness_score DESC LIMIT ?').all(type, limit);
+    }
+    return db.prepare('SELECT * FROM atoms ORDER BY fitness_score DESC LIMIT ?').all(limit);
+}
+//# sourceMappingURL=index.js.map

package/dist/retrieval/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/retrieval/index.ts"],"names":[],"mappings":"AAGA;;;GAGG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,KAAa,EAAE,QAAgB,EAAE;IAC7E,MAAM,EAAE,GAAI,KAAa,CAAC,EAAE,CAAC;IAE7B,2BAA2B;IAC3B,IAAI,CAAC;QACH,EAAE,CAAC,IAAI,CAAC;;;;KAIP,CAAC,CAAC;QACH,uCAAuC;QACvC,EAAE,CAAC,IAAI,CAAC,+DAA+D,CAAC,CAAC;IAC3E,CAAC;IAAC,MAAM,CAAC;QACP,wCAAwC;QACxC,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;IAED,IAAI,CAAC;QACH,4BAA4B;QAC5B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,UAAU,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QACtD,IAAI,CAAC,OAAO;YAAE,OAAO,EAAE,CAAC;QAExB,MAAM,IAAI,GAAG,EAAE,CAAC,OAAO,CAAC;;;;;;;KAOvB,CAAC,CAAC,GAAG,CAAC,OAAO,EAAE,KAAK,CAAyC,CAAC;QAE/D,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,IAAI,EAAE,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC;IAAC,MAAM,CAAC;QACP,2BAA2B;QAC3B,OAAO,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAC;IAC7C,CAAC;AACH,CAAC;AAED;;GAEG;AACH,MAAM,UAAU,WAAW,CAAC,KAAgB,EAAE,IAAe,EAAE,QAAgB,EAAE;IAC/E,MAAM,EAAE,GAAI,KAAa,CAAC,EAAE,CAAC;IAE7B,IAAI,IAAI,EAAE,CAAC;QACT,OAAO,EAAE,CAAC,OAAO,CACf,wEAAwE,CACzE,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,CAAoB,CAAC;IACxC,CAAC;IAED,OAAO,EAAE,CAAC,OAAO,CACf,yDAAyD,CAC1D,CAAC,GAAG,CAAC,KAAK,CAAoB,CAAC;AAClC,CAAC"}

package/dist/seeds/index.d.ts

@@ -0,0 +1,5 @@
+import type { AtomStore } from '../store/index.js';
+/**
+ * Seed the store with 15 realistic knowledge atoms from common OpenClaw agent experiences.
+ */
+export declare function seedAtoms(store: AtomStore): void;

package/dist/seeds/index.js

@@ -0,0 +1,131 @@
+/**
+ * Seed the store with 15 realistic knowledge atoms from common OpenClaw agent experiences.
+ */
+export function seedAtoms(store) {
+    // 1. browser.screenshot fails on lazy-loaded pages
+    store.createToolAtom({
+        type: 'tool',
+        observation: 'browser.screenshot fails on lazy-loaded pages — images appear blank. Add a 2s delay or scroll first to trigger loading.',
+        context: JSON.stringify({ tool: 'browser.screenshot', workaround: 'delay 2000ms or scroll to trigger lazy load' }),
+        confidence: 0.9, fitness_score: 0.85, trust_tier: 'local', source_agent_hash: 'seed',
+        decay_rate: 0.99, tool_name: 'browser.screenshot', params_hash: 'seed',
+        outcome: 'failure', error_signature: 'blank screenshot on lazy-loaded content', latency_ms: 3200, reliability_score: 0.4,
+    });
+    // 2. exec with long-running commands needs timeout
+    store.createToolAtom({
+        type: 'tool',
+        observation: 'exec commands that run >60s will be killed by default timeout. Always pass explicit timeout parameter for builds, tests, or installs.',
+        context: JSON.stringify({ tool: 'exec', tip: 'set timeout: 120+ for npm install, builds' }),
+        confidence: 0.95, fitness_score: 0.9, trust_tier: 'local', source_agent_hash: 'seed',
+        decay_rate: 0.99, tool_name: 'exec', params_hash: 'seed',
+        outcome: 'failure', error_signature: 'process killed by timeout', latency_ms: 60000, reliability_score: 0.3,
+    });
+    // 3. web_fetch returns truncated content
+    store.createToolAtom({
+        type: 'tool',
+        observation: 'web_fetch returns truncated content for pages >50KB. Use maxChars parameter or fetch specific sections with CSS selectors.',
+        context: JSON.stringify({ tool: 'web_fetch', limit: '50KB default' }),
+        confidence: 0.85, fitness_score: 0.8, trust_tier: 'local', source_agent_hash: 'seed',
+        decay_rate: 0.99, tool_name: 'web_fetch', params_hash: 'seed',
+        outcome: 'partial', error_signature: null, latency_ms: 2500, reliability_score: 0.6,
+    });
+    // 4. API rate limiting
+    store.createNegativeAtom({
+        type: 'negative',
+        observation: 'Calling external APIs without rate limiting causes retry storms — exponential backoff quickly burns through quotas.',
+        context: JSON.stringify({ pattern: 'retry storm', fix: 'add exponential backoff with jitter' }),
+        confidence: 0.9, fitness_score: 0.85, trust_tier: 'local', source_agent_hash: 'seed',
+        decay_rate: 0.99, anti_pattern: 'unbounded API retries without backoff',
+        failure_cluster_size: 5, error_type: 'rate_limit_exceeded', severity: 'high',
+    });
+    // 5. git push without pull
+    store.createNegativeAtom({
+        type: 'negative',
+        observation: 'git push without pulling first causes force-push disasters when remote has diverged. Always git pull --rebase before push.',
+        context: JSON.stringify({ pattern: 'force push', fix: 'git pull --rebase origin <branch> first' }),
+        confidence: 0.95, fitness_score: 0.9, trust_tier: 'local', source_agent_hash: 'seed',
+        decay_rate: 0.99, anti_pattern: 'git push without checking remote state',
+        failure_cluster_size: 3, error_type: 'rejected_non_fast_forward', severity: 'critical',
+    });
+    // 6. browser.navigate needs network idle
+    store.createToolAtom({
+        type: 'tool',
+        observation: 'browser.navigate often returns before page is fully loaded. Wait for network idle or a specific element before interacting.',
+        context: JSON.stringify({ tool: 'browser.navigate', tip: 'use snapshot after navigate to confirm load' }),
+        confidence: 0.85, fitness_score: 0.8, trust_tier: 'local', source_agent_hash: 'seed',
+        decay_rate: 0.99, tool_name: 'browser.navigate', params_hash: 'seed',
+        outcome: 'partial', error_signature: null, latency_ms: 1500, reliability_score: 0.5,
+    });
+    // 7. Agent iteration pattern
+    store.createAtom({
+        type: 'pattern',
+        observation: 'When an agent iterates more than 3 times on the same approach, it usually means the approach is wrong. Step back and try a different strategy.',
+        context: JSON.stringify({ threshold: 3, action: 'change approach' }),
+        confidence: 0.8, fitness_score: 0.75, trust_tier: 'local', source_agent_hash: 'seed', decay_rate: 0.99,
+    });
+    // 8. Playwright vs Puppeteer
+    store.createAtom({
+        type: 'context',
+        observation: 'Playwright is faster than Puppeteer for parallel page loads and has better auto-waiting. Prefer it for browser automation tasks.',
+        context: JSON.stringify({ comparison: 'playwright > puppeteer for parallel' }),
+        confidence: 0.7, fitness_score: 0.65, trust_tier: 'local', source_agent_hash: 'seed', decay_rate: 0.99,
+    });
+    // 9. File read with offset for large files
+    store.createToolAtom({
+        type: 'tool',
+        observation: 'Read tool truncates at 2000 lines or 50KB. For large files, use offset/limit parameters to paginate through content.',
+        context: JSON.stringify({ tool: 'Read', tip: 'use offset to continue reading' }),
+        confidence: 0.9, fitness_score: 0.85, trust_tier: 'local', source_agent_hash: 'seed',
+        decay_rate: 0.99, tool_name: 'Read', params_hash: 'seed',
+        outcome: 'success', error_signature: null, latency_ms: 50, reliability_score: 0.9,
+    });
+    // 10. TypeScript project references
+    store.createAtom({
+        type: 'context',
+        observation: 'In monorepos with TypeScript project references, build packages in dependency order. Core before dependent packages.',
+        context: JSON.stringify({ tip: 'tsc --build for composite projects' }),
+        confidence: 0.85, fitness_score: 0.8, trust_tier: 'local', source_agent_hash: 'seed', decay_rate: 0.99,
+    });
+    // 11. exec command chaining
+    store.createToolAtom({
+        type: 'tool',
+        observation: 'Use && to chain exec commands rather than separate calls — reduces latency and ensures sequential execution with early exit on failure.',
+        context: JSON.stringify({ tool: 'exec', tip: 'chain with && for atomic operations' }),
+        confidence: 0.8, fitness_score: 0.75, trust_tier: 'local', source_agent_hash: 'seed',
+        decay_rate: 0.99, tool_name: 'exec', params_hash: 'seed-chain',
+        outcome: 'success', error_signature: null, latency_ms: 100, reliability_score: 0.9,
+    });
+    // 12. Don't rm -rf without confirmation
+    store.createNegativeAtom({
+        type: 'negative',
+        observation: 'Never use rm -rf on user directories without explicit confirmation. Use trash command or move to temp location first.',
+        context: JSON.stringify({ pattern: 'destructive delete', fix: 'use trash or ask first' }),
+        confidence: 0.95, fitness_score: 0.95, trust_tier: 'local', source_agent_hash: 'seed',
+        decay_rate: 0.99, anti_pattern: 'rm -rf without confirmation',
+        failure_cluster_size: 2, error_type: 'data_loss', severity: 'critical',
+    });
+    // 13. browser snapshot refs
+    store.createToolAtom({
+        type: 'tool',
+        observation: 'browser.snapshot refs change between calls. Always take a fresh snapshot before clicking — stale refs cause "element not found" errors.',
+        context: JSON.stringify({ tool: 'browser.snapshot', tip: 'snapshot immediately before act' }),
+        confidence: 0.9, fitness_score: 0.85, trust_tier: 'local', source_agent_hash: 'seed',
+        decay_rate: 0.99, tool_name: 'browser.snapshot', params_hash: 'seed',
+        outcome: 'failure', error_signature: 'element ref not found', latency_ms: 200, reliability_score: 0.5,
+    });
+    // 14. JSON parse errors in web_fetch
+    store.createAtom({
+        type: 'pattern',
+        observation: 'When web_fetch returns markdown, don\'t try to JSON.parse it. Check content type first or wrap in try/catch with fallback.',
+        context: JSON.stringify({ pattern: 'content type mismatch' }),
+        confidence: 0.8, fitness_score: 0.75, trust_tier: 'local', source_agent_hash: 'seed', decay_rate: 0.99,
+    });
+    // 15. Vitest vs Jest in ESM projects
+    store.createAtom({
+        type: 'context',
+        observation: 'Vitest works natively with ESM and TypeScript. Jest requires extensive configuration for ESM. Use Vitest for modern TS projects.',
+        context: JSON.stringify({ comparison: 'vitest > jest for ESM+TS' }),
+        confidence: 0.75, fitness_score: 0.7, trust_tier: 'local', source_agent_hash: 'seed', decay_rate: 0.99,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/seeds/index.js.map

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

package/dist/store/index.d.ts

@@ -0,0 +1,43 @@
+import type { KnowledgeAtom, ToolAtom, NegativeAtom, CreateAtom, CreateToolAtom, CreateNegativeAtom, AtomType } from '../types/index.js';
+/**
+ * Jaccard similarity between two strings (based on word bigrams).
+ */
+export declare function jaccardSimilarity(a: string, b: string): number;
+export declare class AtomStore {
+    private db;
+    constructor(dbPath?: string);
+    /** Run schema migrations */
+    migrate(): void;
+    /** Find atoms with similar observation text */
+    findSimilar(observation: string, threshold?: number): KnowledgeAtom[];
+    /** Insert a base/pattern/skill/context atom (with validation and dedup) */
+    createAtom(data: CreateAtom): KnowledgeAtom;
+    /** Insert a ToolAtom (with validation and dedup) */
+    createToolAtom(data: CreateToolAtom): ToolAtom;
+    /** Insert a NegativeAtom (with validation and dedup) */
+    createNegativeAtom(data: CreateNegativeAtom): NegativeAtom;
+    /** Merge: keep higher fitness, increment evidence_count */
+    private _mergeAtom;
+    /** Get atom by ID */
+    getById(id: string): KnowledgeAtom | null;
+    /** Query atoms by type */
+    queryByType(type: AtomType): KnowledgeAtom[];
+    /** Query tool atoms by tool_name */
+    queryByToolName(toolName: string): ToolAtom[];
+    /** Query atoms with confidence >= threshold */
+    queryByConfidence(threshold: number): KnowledgeAtom[];
+    /** Full-text search on observation */
+    search(query: string): KnowledgeAtom[];
+    /** Update fitness score for a specific atom */
+    updateFitnessScore(id: string, newScore: number): void;
+    /** Record a usage event */
+    recordUsage(id: string, success: boolean): void;
+    /** Apply decay: multiply fitness_score by decay_rate for all atoms */
+    applyDecay(): number;
+    /** Delete atom by ID */
+    deleteAtom(id: string): boolean;
+    /** Get all atoms */
+    getAll(): KnowledgeAtom[];
+    /** Close the database */
+    close(): void;
+}