@osmosis-ai/core 0.1.0

package/dist/store/index.js

@@ -0,0 +1,230 @@
+import Database from 'better-sqlite3';
+import { randomUUID } from 'node:crypto';
+import { validateCreateAtom, validateCreateToolAtom, validateCreateNegativeAtom } from '../validation/index.js';
+const SCHEMA_SQL = `
+CREATE TABLE IF NOT EXISTS atoms (
+  id TEXT PRIMARY KEY,
+  type TEXT NOT NULL,
+  observation TEXT NOT NULL,
+  context TEXT NOT NULL,
+  confidence REAL NOT NULL,
+  fitness_score REAL NOT NULL,
+  trust_tier TEXT NOT NULL DEFAULT 'quarantine',
+  source_agent_hash TEXT NOT NULL,
+  created_at TEXT NOT NULL,
+  updated_at TEXT NOT NULL,
+  decay_rate REAL NOT NULL DEFAULT 0.99,
+
+  -- ToolAtom fields (nullable)
+  tool_name TEXT,
+  params_hash TEXT,
+  outcome TEXT,
+  error_signature TEXT,
+  latency_ms REAL,
+  reliability_score REAL,
+
+  -- NegativeAtom fields (nullable)
+  anti_pattern TEXT,
+  failure_cluster_size INTEGER,
+  error_type TEXT,
+  severity TEXT,
+
+  -- Dedup & fitness fields
+  evidence_count INTEGER NOT NULL DEFAULT 1,
+  use_count INTEGER NOT NULL DEFAULT 0,
+  success_after_use INTEGER NOT NULL DEFAULT 0,
+  failure_after_use INTEGER NOT NULL DEFAULT 0,
+  last_used TEXT
+);
+
+CREATE INDEX IF NOT EXISTS idx_atoms_type ON atoms(type);
+CREATE INDEX IF NOT EXISTS idx_atoms_tool_name ON atoms(tool_name);
+CREATE INDEX IF NOT EXISTS idx_atoms_confidence ON atoms(confidence);
+CREATE INDEX IF NOT EXISTS idx_atoms_fitness ON atoms(fitness_score);
+CREATE INDEX IF NOT EXISTS idx_atoms_updated_at ON atoms(updated_at);
+`;
+// Migration: add columns if they don't exist (for existing DBs)
+const MIGRATIONS = [
+    `ALTER TABLE atoms ADD COLUMN evidence_count INTEGER NOT NULL DEFAULT 1`,
+    `ALTER TABLE atoms ADD COLUMN use_count INTEGER NOT NULL DEFAULT 0`,
+    `ALTER TABLE atoms ADD COLUMN success_after_use INTEGER NOT NULL DEFAULT 0`,
+    `ALTER TABLE atoms ADD COLUMN failure_after_use INTEGER NOT NULL DEFAULT 0`,
+    `ALTER TABLE atoms ADD COLUMN last_used TEXT`,
+];
+/**
+ * Jaccard similarity between two strings (based on word bigrams).
+ */
+export function jaccardSimilarity(a, b) {
+    const bigrams = (s) => {
+        const words = s.toLowerCase().split(/\s+/).filter(Boolean);
+        const set = new Set();
+        for (let i = 0; i < words.length - 1; i++) {
+            set.add(words[i] + ' ' + words[i + 1]);
+        }
+        // Also add unigrams for short texts
+        for (const w of words)
+            set.add(w);
+        return set;
+    };
+    const setA = bigrams(a);
+    const setB = bigrams(b);
+    if (setA.size === 0 && setB.size === 0)
+        return 1;
+    let intersection = 0;
+    for (const x of setA)
+        if (setB.has(x))
+            intersection++;
+    const union = setA.size + setB.size - intersection;
+    return union === 0 ? 1 : intersection / union;
+}
+export class AtomStore {
+    db;
+    constructor(dbPath = ':memory:') {
+        this.db = new Database(dbPath);
+        this.db.pragma('journal_mode = WAL');
+        this.migrate();
+    }
+    /** Run schema migrations */
+    migrate() {
+        this.db.exec(SCHEMA_SQL);
+        // Apply column migrations for existing DBs (ignore if already exists)
+        for (const sql of MIGRATIONS) {
+            try {
+                this.db.exec(sql);
+            }
+            catch { /* column already exists */ }
+        }
+    }
+    /** Find atoms with similar observation text */
+    findSimilar(observation, threshold = 0.7) {
+        const all = this.getAll();
+        return all.filter(a => jaccardSimilarity(a.observation, observation) >= threshold);
+    }
+    /** Insert a base/pattern/skill/context atom (with validation and dedup) */
+    createAtom(data) {
+        validateCreateAtom(data);
+        // Dedup check
+        const similar = this.findSimilar(data.observation, 0.9);
+        if (similar.length > 0) {
+            const best = similar[0];
+            this._mergeAtom(best.id, data.fitness_score, data.confidence);
+            return this.getById(best.id);
+        }
+        const now = new Date().toISOString();
+        const atom = { id: randomUUID(), ...data, created_at: now, updated_at: now };
+        this.db.prepare(`
+      INSERT INTO atoms (id, type, observation, context, confidence, fitness_score,
+        trust_tier, source_agent_hash, created_at, updated_at, decay_rate, evidence_count)
+      VALUES (@id, @type, @observation, @context, @confidence, @fitness_score,
+        @trust_tier, @source_agent_hash, @created_at, @updated_at, @decay_rate, 1)
+    `).run(atom);
+        return atom;
+    }
+    /** Insert a ToolAtom (with validation and dedup) */
+    createToolAtom(data) {
+        validateCreateToolAtom(data);
+        const similar = this.findSimilar(data.observation, 0.9);
+        if (similar.length > 0) {
+            const best = similar[0];
+            this._mergeAtom(best.id, data.fitness_score, data.confidence);
+            return this.getById(best.id);
+        }
+        const now = new Date().toISOString();
+        const atom = { id: randomUUID(), ...data, created_at: now, updated_at: now };
+        this.db.prepare(`
+      INSERT INTO atoms (id, type, observation, context, confidence, fitness_score,
+        trust_tier, source_agent_hash, created_at, updated_at, decay_rate,
+        tool_name, params_hash, outcome, error_signature, latency_ms, reliability_score, evidence_count)
+      VALUES (@id, @type, @observation, @context, @confidence, @fitness_score,
+        @trust_tier, @source_agent_hash, @created_at, @updated_at, @decay_rate,
+        @tool_name, @params_hash, @outcome, @error_signature, @latency_ms, @reliability_score, 1)
+    `).run(atom);
+        return atom;
+    }
+    /** Insert a NegativeAtom (with validation and dedup) */
+    createNegativeAtom(data) {
+        validateCreateNegativeAtom(data);
+        const similar = this.findSimilar(data.observation, 0.9);
+        if (similar.length > 0) {
+            const best = similar[0];
+            this._mergeAtom(best.id, data.fitness_score, data.confidence);
+            return this.getById(best.id);
+        }
+        const now = new Date().toISOString();
+        const atom = { id: randomUUID(), ...data, created_at: now, updated_at: now };
+        this.db.prepare(`
+      INSERT INTO atoms (id, type, observation, context, confidence, fitness_score,
+        trust_tier, source_agent_hash, created_at, updated_at, decay_rate,
+        anti_pattern, failure_cluster_size, error_type, severity, evidence_count)
+      VALUES (@id, @type, @observation, @context, @confidence, @fitness_score,
+        @trust_tier, @source_agent_hash, @created_at, @updated_at, @decay_rate,
+        @anti_pattern, @failure_cluster_size, @error_type, @severity, 1)
+    `).run(atom);
+        return atom;
+    }
+    /** Merge: keep higher fitness, increment evidence_count */
+    _mergeAtom(existingId, newFitness, newConfidence) {
+        this.db.prepare(`
+      UPDATE atoms SET
+        fitness_score = MAX(fitness_score, ?),
+        confidence = MAX(confidence, ?),
+        evidence_count = evidence_count + 1,
+        updated_at = ?
+      WHERE id = ?
+    `).run(newFitness, newConfidence, new Date().toISOString(), existingId);
+    }
+    /** Get atom by ID */
+    getById(id) {
+        const row = this.db.prepare('SELECT * FROM atoms WHERE id = ?').get(id);
+        return row ?? null;
+    }
+    /** Query atoms by type */
+    queryByType(type) {
+        return this.db.prepare('SELECT * FROM atoms WHERE type = ?').all(type);
+    }
+    /** Query tool atoms by tool_name */
+    queryByToolName(toolName) {
+        return this.db.prepare('SELECT * FROM atoms WHERE type = ? AND tool_name = ?').all('tool', toolName);
+    }
+    /** Query atoms with confidence >= threshold */
+    queryByConfidence(threshold) {
+        return this.db.prepare('SELECT * FROM atoms WHERE confidence >= ? ORDER BY confidence DESC').all(threshold);
+    }
+    /** Full-text search on observation */
+    search(query) {
+        return this.db.prepare('SELECT * FROM atoms WHERE observation LIKE ? ORDER BY fitness_score DESC')
+            .all(`%${query}%`);
+    }
+    /** Update fitness score for a specific atom */
+    updateFitnessScore(id, newScore) {
+        this.db.prepare('UPDATE atoms SET fitness_score = ?, updated_at = ? WHERE id = ?')
+            .run(newScore, new Date().toISOString(), id);
+    }
+    /** Record a usage event */
+    recordUsage(id, success) {
+        const col = success ? 'success_after_use' : 'failure_after_use';
+        this.db.prepare(`
+      UPDATE atoms SET use_count = use_count + 1, ${col} = ${col} + 1,
+        last_used = ?, updated_at = ? WHERE id = ?
+    `).run(new Date().toISOString(), new Date().toISOString(), id);
+    }
+    /** Apply decay: multiply fitness_score by decay_rate for all atoms */
+    applyDecay() {
+        const result = this.db.prepare('UPDATE atoms SET fitness_score = fitness_score * decay_rate, updated_at = ? WHERE fitness_score > 0').run(new Date().toISOString());
+        return result.changes;
+    }
+    /** Delete atom by ID */
+    deleteAtom(id) {
+        const result = this.db.prepare('DELETE FROM atoms WHERE id = ?').run(id);
+        return result.changes > 0;
+    }
+    /** Get all atoms */
+    getAll() {
+        return this.db.prepare('SELECT * FROM atoms').all();
+    }
+    /** Close the database */
+    close() {
+        this.db.close();
+    }
+}
+//# sourceMappingURL=index.js.map

package/dist/store/index.js.map

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

package/dist/types/index.d.ts

@@ -0,0 +1,53 @@
+export type TrustTier = 'quarantine' | 'local' | 'verified' | 'canonical';
+export type AtomType = 'tool' | 'negative' | 'pattern' | 'skill' | 'context';
+export type Outcome = 'success' | 'failure' | 'partial';
+export type Severity = 'low' | 'medium' | 'high' | 'critical';
+export interface KnowledgeAtom {
+    id: string;
+    type: AtomType;
+    observation: string;
+    context: string;
+    confidence: number;
+    fitness_score: number;
+    trust_tier: TrustTier;
+    source_agent_hash: string;
+    created_at: string;
+    updated_at: string;
+    decay_rate: number;
+}
+export interface ToolAtom extends KnowledgeAtom {
+    type: 'tool';
+    tool_name: string;
+    params_hash: string;
+    outcome: Outcome;
+    error_signature: string | null;
+    latency_ms: number | null;
+    reliability_score: number;
+}
+export interface NegativeAtom extends KnowledgeAtom {
+    type: 'negative';
+    anti_pattern: string;
+    failure_cluster_size: number;
+    error_type: string;
+    severity: Severity;
+}
+export interface PatternAtom extends KnowledgeAtom {
+    type: 'pattern';
+}
+export interface SkillAtom extends KnowledgeAtom {
+    type: 'skill';
+}
+export interface ContextAtom extends KnowledgeAtom {
+    type: 'context';
+}
+export type AnyAtom = ToolAtom | NegativeAtom | PatternAtom | SkillAtom | ContextAtom;
+export interface OutcomeSignals {
+    completed_without_error: boolean;
+    revisited_within_1hr: boolean;
+    human_accepted: boolean | null;
+    convergence_steps: number;
+    error_free: boolean;
+}
+export type CreateToolAtom = Omit<ToolAtom, 'id' | 'created_at' | 'updated_at'>;
+export type CreateNegativeAtom = Omit<NegativeAtom, 'id' | 'created_at' | 'updated_at'>;
+export type CreateAtom = Omit<KnowledgeAtom, 'id' | 'created_at' | 'updated_at'>;

package/dist/types/index.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.js.map

package/dist/types/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/types/index.ts"],"names":[],"mappings":""}

package/dist/validation/index.d.ts

@@ -0,0 +1,119 @@
+import { z } from 'zod';
+export declare const CreateAtomSchema: z.ZodObject<{
+    type: z.ZodEnum<{
+        tool: "tool";
+        negative: "negative";
+        pattern: "pattern";
+        skill: "skill";
+        context: "context";
+    }>;
+    observation: z.ZodString;
+    context: z.ZodString;
+    confidence: z.ZodNumber;
+    fitness_score: z.ZodNumber;
+    trust_tier: z.ZodEnum<{
+        quarantine: "quarantine";
+        local: "local";
+        verified: "verified";
+        canonical: "canonical";
+    }>;
+    source_agent_hash: z.ZodString;
+    decay_rate: z.ZodNumber;
+}, z.core.$strip>;
+export declare const CreateToolAtomSchema: z.ZodObject<{
+    observation: z.ZodString;
+    context: z.ZodString;
+    confidence: z.ZodNumber;
+    fitness_score: z.ZodNumber;
+    trust_tier: z.ZodEnum<{
+        quarantine: "quarantine";
+        local: "local";
+        verified: "verified";
+        canonical: "canonical";
+    }>;
+    source_agent_hash: z.ZodString;
+    decay_rate: z.ZodNumber;
+    type: z.ZodLiteral<"tool">;
+    tool_name: z.ZodString;
+    params_hash: z.ZodString;
+    outcome: z.ZodEnum<{
+        success: "success";
+        failure: "failure";
+        partial: "partial";
+    }>;
+    error_signature: z.ZodNullable<z.ZodString>;
+    latency_ms: z.ZodNullable<z.ZodNumber>;
+    reliability_score: z.ZodNumber;
+}, z.core.$strip>;
+export declare const CreateNegativeAtomSchema: z.ZodObject<{
+    observation: z.ZodString;
+    context: z.ZodString;
+    confidence: z.ZodNumber;
+    fitness_score: z.ZodNumber;
+    trust_tier: z.ZodEnum<{
+        quarantine: "quarantine";
+        local: "local";
+        verified: "verified";
+        canonical: "canonical";
+    }>;
+    source_agent_hash: z.ZodString;
+    decay_rate: z.ZodNumber;
+    type: z.ZodLiteral<"negative">;
+    anti_pattern: z.ZodString;
+    failure_cluster_size: z.ZodNumber;
+    error_type: z.ZodString;
+    severity: z.ZodEnum<{
+        low: "low";
+        medium: "medium";
+        high: "high";
+        critical: "critical";
+    }>;
+}, z.core.$strip>;
+export declare const OutcomeSignalsSchema: z.ZodObject<{
+    completed_without_error: z.ZodBoolean;
+    revisited_within_1hr: z.ZodBoolean;
+    human_accepted: z.ZodNullable<z.ZodBoolean>;
+    convergence_steps: z.ZodNumber;
+    error_free: z.ZodBoolean;
+}, z.core.$strip>;
+/** Validate and return typed data, or throw ZodError */
+export declare function validateCreateAtom(data: unknown): {
+    type: "tool" | "negative" | "pattern" | "skill" | "context";
+    observation: string;
+    context: string;
+    confidence: number;
+    fitness_score: number;
+    trust_tier: "quarantine" | "local" | "verified" | "canonical";
+    source_agent_hash: string;
+    decay_rate: number;
+};
+export declare function validateCreateToolAtom(data: unknown): {
+    observation: string;
+    context: string;
+    confidence: number;
+    fitness_score: number;
+    trust_tier: "quarantine" | "local" | "verified" | "canonical";
+    source_agent_hash: string;
+    decay_rate: number;
+    type: "tool";
+    tool_name: string;
+    params_hash: string;
+    outcome: "success" | "failure" | "partial";
+    error_signature: string | null;
+    latency_ms: number | null;
+    reliability_score: number;
+};
+export declare function validateCreateNegativeAtom(data: unknown): {
+    observation: string;
+    context: string;
+    confidence: number;
+    fitness_score: number;
+    trust_tier: "quarantine" | "local" | "verified" | "canonical";
+    source_agent_hash: string;
+    decay_rate: number;
+    type: "negative";
+    anti_pattern: string;
+    failure_cluster_size: number;
+    error_type: string;
+    severity: "low" | "medium" | "high" | "critical";
+};

package/dist/validation/index.js

@@ -0,0 +1,55 @@
+import { z } from 'zod';
+// ── Shared enums ─────────────────────────────────────────────
+const TrustTierSchema = z.enum(['quarantine', 'local', 'verified', 'canonical']);
+const AtomTypeSchema = z.enum(['tool', 'negative', 'pattern', 'skill', 'context']);
+const OutcomeSchema = z.enum(['success', 'failure', 'partial']);
+const SeveritySchema = z.enum(['low', 'medium', 'high', 'critical']);
+const unit = z.number().min(0).max(1);
+// ── Base CreateAtom ──────────────────────────────────────────
+export const CreateAtomSchema = z.object({
+    type: AtomTypeSchema,
+    observation: z.string().min(1),
+    context: z.string(),
+    confidence: unit,
+    fitness_score: unit,
+    trust_tier: TrustTierSchema,
+    source_agent_hash: z.string().min(1),
+    decay_rate: unit,
+});
+// ── CreateToolAtom ───────────────────────────────────────────
+export const CreateToolAtomSchema = CreateAtomSchema.extend({
+    type: z.literal('tool'),
+    tool_name: z.string().min(1),
+    params_hash: z.string(),
+    outcome: OutcomeSchema,
+    error_signature: z.string().nullable(),
+    latency_ms: z.number().nullable(),
+    reliability_score: unit,
+});
+// ── CreateNegativeAtom ───────────────────────────────────────
+export const CreateNegativeAtomSchema = CreateAtomSchema.extend({
+    type: z.literal('negative'),
+    anti_pattern: z.string().min(1),
+    failure_cluster_size: z.number().int().min(0),
+    error_type: z.string().min(1),
+    severity: SeveritySchema,
+});
+// ── OutcomeSignals ───────────────────────────────────────────
+export const OutcomeSignalsSchema = z.object({
+    completed_without_error: z.boolean(),
+    revisited_within_1hr: z.boolean(),
+    human_accepted: z.boolean().nullable(),
+    convergence_steps: z.number().int().min(0),
+    error_free: z.boolean(),
+});
+/** Validate and return typed data, or throw ZodError */
+export function validateCreateAtom(data) {
+    return CreateAtomSchema.parse(data);
+}
+export function validateCreateToolAtom(data) {
+    return CreateToolAtomSchema.parse(data);
+}
+export function validateCreateNegativeAtom(data) {
+    return CreateNegativeAtomSchema.parse(data);
+}
+//# sourceMappingURL=index.js.map

package/dist/validation/index.js.map

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

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@osmosis-ai/core",
+  "version": "0.1.0",
+  "description": "Core knowledge atom types, local SQLite store, and instrumentation stubs for Osmosis",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.7.0",
+    "zod": "^4.3.6"
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.12",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT"
+}

package/src/__tests__/api.test.ts

@@ -0,0 +1,103 @@
+import { describe, it, expect, beforeEach, afterEach } from 'vitest';
+import { createServer } from '../api/index.js';
+import { AtomStore } from '../store/index.js';
+import type { Server } from 'node:http';
+
+const PORT = 19876;
+
+function req(path: string, opts: RequestInit = {}): Promise<Response> {
+  return fetch(`http://localhost:${PORT}${path}`, opts);
+}
+
+describe('REST API', () => {
+  let store: AtomStore;
+  let server: Server;
+
+  beforeEach(async () => {
+    store = new AtomStore(':memory:');
+    server = createServer(store, PORT);
+    await new Promise(r => server.once('listening', r));
+  });
+
+  afterEach(async () => {
+    await new Promise<void>(r => server.close(() => r()));
+    store.close();
+  });
+
+  it('POST /atoms creates a context atom', async () => {
+    const res = await req('/atoms', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({
+        type: 'context', observation: 'API test', context: '{}',
+        confidence: 0.5, fitness_score: 0.5, trust_tier: 'local',
+        source_agent_hash: 'test', decay_rate: 0.99,
+      }),
+    });
+    expect(res.status).toBe(201);
+    const body = await res.json();
+    expect(body.id).toBeTruthy();
+  });
+
+  it('POST /atoms rejects invalid data', async () => {
+    const res = await req('/atoms', {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify({ type: 'context', observation: '' }),
+    });
+    expect(res.status).toBe(400);
+  });
+
+  it('GET /atoms returns all', async () => {
+    store.createAtom({
+      type: 'context', observation: 'api get test', context: '{}',
+      confidence: 0.5, fitness_score: 0.5, trust_tier: 'local',
+      source_agent_hash: 'test', decay_rate: 0.99,
+    });
+    const res = await req('/atoms');
+    const body = await res.json();
+    expect(body).toHaveLength(1);
+  });
+
+  it('GET /atoms/:id returns one atom', async () => {
+    const atom = store.createAtom({
+      type: 'context', observation: 'api id test', context: '{}',
+      confidence: 0.5, fitness_score: 0.5, trust_tier: 'local',
+      source_agent_hash: 'test', decay_rate: 0.99,
+    });
+    const res = await req(`/atoms/${atom.id}`);
+    expect(res.status).toBe(200);
+    const body = await res.json();
+    expect(body.id).toBe(atom.id);
+  });
+
+  it('GET /atoms/:id returns 404 for missing', async () => {
+    const res = await req('/atoms/00000000-0000-0000-0000-000000000000');
+    expect(res.status).toBe(404);
+  });
+
+  it('GET /atoms/search?q= searches', async () => {
+    store.createAtom({
+      type: 'context', observation: 'screenshot fails on lazy load', context: '{}',
+      confidence: 0.5, fitness_score: 0.5, trust_tier: 'local',
+      source_agent_hash: 'test', decay_rate: 0.99,
+    });
+    const res = await req('/atoms/search?q=screenshot');
+    const body = await res.json();
+    expect(body).toHaveLength(1);
+  });
+
+  it('GET /atoms?type= filters by type', async () => {
+    store.createToolAtom({
+      type: 'tool', observation: 'tool filter test', context: '{}',
+      confidence: 0.5, fitness_score: 0.5, trust_tier: 'local',
+      source_agent_hash: 'test', decay_rate: 0.99,
+      tool_name: 'test.tool', params_hash: 'x',
+      outcome: 'success', error_signature: null,
+      latency_ms: null, reliability_score: 1,
+    });
+    const res = await req('/atoms?type=tool');
+    const body = await res.json();
+    expect(body).toHaveLength(1);
+  });
+});