@osmosis-ai/mesh-server 0.1.0

package/dist/config.d.ts

@@ -0,0 +1,10 @@
+export interface MeshServerConfig {
+    /** Port to listen on (default: 7433) */
+    port: number;
+    /** Path to SQLite database for mesh storage (default: ':memory:') */
+    dbPath: string;
+    /** Allow anonymous contributions (default: true) */
+    allowAnonymous: boolean;
+}
+export declare const DEFAULT_MESH_CONFIG: MeshServerConfig;
+export declare function resolveMeshConfig(partial?: Partial<MeshServerConfig>): MeshServerConfig;

package/dist/config.js

@@ -0,0 +1,9 @@
+export const DEFAULT_MESH_CONFIG = {
+    port: 7433,
+    dbPath: ':memory:',
+    allowAnonymous: true,
+};
+export function resolveMeshConfig(partial) {
+    return { ...DEFAULT_MESH_CONFIG, ...partial };
+}
+//# sourceMappingURL=config.js.map

package/dist/config.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"config.js","sourceRoot":"","sources":["../src/config.ts"],"names":[],"mappings":"AASA,MAAM,CAAC,MAAM,mBAAmB,GAAqB;IACnD,IAAI,EAAE,IAAI;IACV,MAAM,EAAE,UAAU;IAClB,cAAc,EAAE,IAAI;CACrB,CAAC;AAEF,MAAM,UAAU,iBAAiB,CAAC,OAAmC;IACnE,OAAO,EAAE,GAAG,mBAAmB,EAAE,GAAG,OAAO,EAAE,CAAC;AAChD,CAAC"}

package/dist/entrypoint.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/entrypoint.js

@@ -0,0 +1,31 @@
+/**
+ * Production entrypoint for the Osmosis mesh server.
+ * Reads config from environment variables and starts the server.
+ */
+import { startMeshServer } from './index.js';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+const port = parseInt(process.env.MESH_PORT || '7433', 10);
+const dbPath = process.env.MESH_DB_PATH || '/data/mesh.db';
+// Ensure data directory exists
+try {
+    mkdirSync(dirname(dbPath), { recursive: true });
+}
+catch { }
+// startMeshServer already calls server.listen() internally
+const handle = startMeshServer({ port, dbPath, allowAnonymous: true });
+console.log(`🧠 Osmosis mesh server running on port ${port}`);
+console.log(`   Database: ${dbPath}`);
+console.log(`   Ready to accept contributions`);
+// Graceful shutdown
+process.on('SIGTERM', () => {
+    console.log('Shutting down...');
+    handle.stop();
+    process.exit(0);
+});
+process.on('SIGINT', () => {
+    console.log('Shutting down...');
+    handle.stop();
+    process.exit(0);
+});
+//# sourceMappingURL=entrypoint.js.map

package/dist/entrypoint.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"entrypoint.js","sourceRoot":"","sources":["../src/entrypoint.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,OAAO,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAC;AACpC,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAEpC,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,IAAI,MAAM,EAAE,EAAE,CAAC,CAAC;AAC3D,MAAM,MAAM,GAAG,OAAO,CAAC,GAAG,CAAC,YAAY,IAAI,eAAe,CAAC;AAE3D,+BAA+B;AAC/B,IAAI,CAAC;IACH,SAAS,CAAC,OAAO,CAAC,MAAM,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;AAClD,CAAC;AAAC,MAAM,CAAC,CAAA,CAAC;AAEV,2DAA2D;AAC3D,MAAM,MAAM,GAAG,eAAe,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,cAAc,EAAE,IAAI,EAAE,CAAC,CAAC;AAEvE,OAAO,CAAC,GAAG,CAAC,0CAA0C,IAAI,EAAE,CAAC,CAAC;AAC9D,OAAO,CAAC,GAAG,CAAC,gBAAgB,MAAM,EAAE,CAAC,CAAC;AACtC,OAAO,CAAC,GAAG,CAAC,kCAAkC,CAAC,CAAC;AAEhD,oBAAoB;AACpB,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,GAAG,EAAE;IACzB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,GAAG,EAAE;IACxB,OAAO,CAAC,GAAG,CAAC,kBAAkB,CAAC,CAAC;IAChC,MAAM,CAAC,IAAI,EAAE,CAAC;IACd,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+import { AtomStore } from '@osmosis-ai/core';
+import { type MeshServerConfig } from './config.js';
+import type { Server } from 'node:http';
+export { createMeshServer } from './server.js';
+export { resolveMeshConfig, DEFAULT_MESH_CONFIG } from './config.js';
+export type { MeshServerConfig } from './config.js';
+export interface MeshServerHandle {
+    store: AtomStore;
+    server: Server;
+    stop(): void;
+}
+export declare function startMeshServer(partial?: Partial<MeshServerConfig>): MeshServerHandle;

package/dist/index.js

@@ -0,0 +1,19 @@
+import { AtomStore } from '@osmosis-ai/core';
+import { createMeshServer } from './server.js';
+import { resolveMeshConfig } from './config.js';
+export { createMeshServer } from './server.js';
+export { resolveMeshConfig, DEFAULT_MESH_CONFIG } from './config.js';
+export function startMeshServer(partial) {
+    const config = resolveMeshConfig(partial);
+    const store = new AtomStore(config.dbPath);
+    const server = createMeshServer(store, config);
+    return {
+        store,
+        server,
+        stop() {
+            server.close();
+            store.close();
+        },
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AAC7C,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAyB,MAAM,aAAa,CAAC;AAGvE,OAAO,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAC/C,OAAO,EAAE,iBAAiB,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AASrE,MAAM,UAAU,eAAe,CAAC,OAAmC;IACjE,MAAM,MAAM,GAAG,iBAAiB,CAAC,OAAO,CAAC,CAAC;IAC1C,MAAM,KAAK,GAAG,IAAI,SAAS,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC3C,MAAM,MAAM,GAAG,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC;IAE/C,OAAO;QACL,KAAK;QACL,MAAM;QACN,IAAI;YACF,MAAM,CAAC,KAAK,EAAE,CAAC;YACf,KAAK,CAAC,KAAK,EAAE,CAAC;QAChB,CAAC;KACF,CAAC;AACJ,CAAC"}

package/dist/server.d.ts

@@ -0,0 +1,13 @@
+import { type Server } from 'node:http';
+import { AtomStore } from '@osmosis-ai/core';
+import type { MeshServerConfig } from './config.js';
+/**
+ * Create the centralized mesh HTTP server.
+ *
+ * Routes:
+ *   POST /mesh/contribute         — submit atoms to the mesh
+ *   GET  /mesh/atoms?since=<ISO>  — get atoms since timestamp
+ *   GET  /mesh/query?q=&type=&limit= — query mesh for relevant knowledge
+ *   GET  /mesh/stats              — mesh statistics
+ */
+export declare function createMeshServer(store: AtomStore, config: MeshServerConfig): Server;

package/dist/server.js

@@ -0,0 +1,116 @@
+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 the centralized mesh HTTP server.
+ *
+ * Routes:
+ *   POST /mesh/contribute         — submit atoms to the mesh
+ *   GET  /mesh/atoms?since=<ISO>  — get atoms since timestamp
+ *   GET  /mesh/query?q=&type=&limit= — query mesh for relevant knowledge
+ *   GET  /mesh/stats              — mesh statistics
+ */
+export function createMeshServer(store, config) {
+    const server = createHttpServer(async (req, res) => {
+        const url = new URL(req.url ?? '/', `http://localhost:${config.port}`);
+        const path = url.pathname;
+        const method = req.method ?? 'GET';
+        try {
+            // POST /mesh/contribute — accept atoms from clients
+            if (method === 'POST' && path === '/mesh/contribute') {
+                const body = JSON.parse(await readBody(req));
+                const atoms = Array.isArray(body) ? body : [body];
+                const results = [];
+                for (const atomData of atoms) {
+                    // Strip client-side auto fields; mesh generates its own
+                    const { id, created_at, updated_at, ...data } = atomData;
+                    // Force quarantine trust tier on mesh
+                    data.trust_tier = 'quarantine';
+                    let result;
+                    if (data.type === 'tool') {
+                        result = store.createToolAtom(data);
+                    }
+                    else if (data.type === 'negative') {
+                        result = store.createNegativeAtom(data);
+                    }
+                    else {
+                        result = store.createAtom(data);
+                    }
+                    // Detect dedup: if evidence_count > 1, it was merged
+                    const ec = result.evidence_count;
+                    results.push({
+                        id: result.id,
+                        status: ec && ec > 1 ? 'deduped' : 'created',
+                    });
+                }
+                return json(res, 200, { accepted: results.length, results });
+            }
+            // GET /mesh/atoms?since=<ISO>
+            if (method === 'GET' && path === '/mesh/atoms') {
+                const since = url.searchParams.get('since');
+                let atoms = store.getAll();
+                if (since) {
+                    atoms = atoms.filter(a => a.updated_at > since);
+                }
+                return json(res, 200, atoms);
+            }
+            // GET /mesh/query?q=<search>&type=<type>&limit=<n>
+            if (method === 'GET' && path === '/mesh/query') {
+                const q = url.searchParams.get('q') ?? '';
+                const type = url.searchParams.get('type');
+                const limit = parseInt(url.searchParams.get('limit') ?? '20', 10);
+                let atoms;
+                if (q) {
+                    atoms = store.search(q);
+                }
+                else if (type) {
+                    atoms = store.queryByType(type);
+                }
+                else {
+                    atoms = store.getAll();
+                }
+                if (type && q) {
+                    atoms = atoms.filter(a => a.type === type);
+                }
+                atoms = atoms.slice(0, limit);
+                return json(res, 200, atoms);
+            }
+            // GET /mesh/stats
+            if (method === 'GET' && path === '/mesh/stats') {
+                const all = store.getAll();
+                const contributors = new Set(all.map(a => a.source_agent_hash));
+                const topAtoms = [...all]
+                    .sort((a, b) => b.fitness_score - a.fitness_score)
+                    .slice(0, 10);
+                return json(res, 200, {
+                    totalAtoms: all.length,
+                    contributors: contributors.size,
+                    topAtoms: topAtoms.map(a => ({
+                        id: a.id,
+                        type: a.type,
+                        observation: a.observation.slice(0, 120),
+                        fitness_score: a.fitness_score,
+                    })),
+                });
+            }
+            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(config.port);
+    return server;
+}
+//# sourceMappingURL=server.js.map

package/dist/server.js.map

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

package/package.json

@@ -0,0 +1,23 @@
+{
+  "name": "@osmosis-ai/mesh-server",
+  "version": "0.1.0",
+  "description": "Centralized mesh server for Osmosis knowledge sharing",
+  "type": "module",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:watch": "vitest"
+  },
+  "dependencies": {
+    "@osmosis-ai/core": "*"
+  },
+  "devDependencies": {
+    "better-sqlite3": "^11.7.0",
+    "@types/better-sqlite3": "^7.6.12",
+    "typescript": "^5.7.0",
+    "vitest": "^3.0.0"
+  },
+  "license": "MIT"
+}

package/src/__tests__/mesh-server.test.ts

@@ -0,0 +1,107 @@
+import { describe, it, expect, afterEach } from 'vitest';
+import { AtomStore } from '@osmosis-ai/core';
+import { startMeshServer, type MeshServerHandle } from '../index.js';
+
+const PORT = 19600;
+
+function makeToolAtom(toolName: string, observation: string) {
+  return {
+    type: 'tool' as const,
+    observation,
+    context: `testing ${toolName}`,
+    confidence: 0.8,
+    fitness_score: 0.7,
+    trust_tier: 'local' as const,
+    source_agent_hash: 'test-agent-' + toolName,
+    decay_rate: 0.99,
+    tool_name: toolName,
+    params_hash: 'abc123',
+    outcome: 'success' as const,
+    error_signature: null,
+    latency_ms: 100,
+    reliability_score: 0.9,
+  };
+}
+
+describe('mesh server', () => {
+  let mesh: MeshServerHandle;
+
+  afterEach(() => {
+    try { mesh?.stop(); } catch {}
+  });
+
+  it('POST /mesh/contribute accepts atoms', async () => {
+    mesh = startMeshServer({ port: PORT, dbPath: ':memory:' });
+    const res = await fetch(`http://localhost:${PORT}/mesh/contribute`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(makeToolAtom('test', 'test observation')),
+    });
+    expect(res.ok).toBe(true);
+    const body = await res.json() as any;
+    expect(body.accepted).toBe(1);
+    expect(mesh.store.getAll().length).toBe(1);
+    // Contributed atoms are quarantined
+    expect(mesh.store.getAll()[0]!.trust_tier).toBe('quarantine');
+  });
+
+  it('GET /mesh/atoms returns all atoms', async () => {
+    mesh = startMeshServer({ port: PORT, dbPath: ':memory:' });
+    mesh.store.createToolAtom(makeToolAtom('t1', 'obs one'));
+    mesh.store.createToolAtom(makeToolAtom('t2', 'obs two completely different'));
+
+    const res = await fetch(`http://localhost:${PORT}/mesh/atoms`);
+    const atoms = await res.json() as any[];
+    expect(atoms.length).toBe(2);
+  });
+
+  it('GET /mesh/atoms?since= filters by time', async () => {
+    mesh = startMeshServer({ port: PORT, dbPath: ':memory:' });
+    mesh.store.createToolAtom(makeToolAtom('old', 'old observation'));
+    const since = new Date().toISOString();
+    await new Promise(r => setTimeout(r, 50));
+    mesh.store.createToolAtom(makeToolAtom('new', 'completely new different observation'));
+
+    const res = await fetch(`http://localhost:${PORT}/mesh/atoms?since=${encodeURIComponent(since)}`);
+    const atoms = await res.json() as any[];
+    expect(atoms.length).toBe(1);
+    expect(atoms[0].tool_name).toBe('new');
+  });
+
+  it('GET /mesh/query searches atoms', async () => {
+    mesh = startMeshServer({ port: PORT, dbPath: ':memory:' });
+    mesh.store.createToolAtom(makeToolAtom('browser', 'browser click fails'));
+    mesh.store.createToolAtom(makeToolAtom('fetch', 'fetch times out'));
+
+    const res = await fetch(`http://localhost:${PORT}/mesh/query?q=browser`);
+    const atoms = await res.json() as any[];
+    expect(atoms.length).toBe(1);
+  });
+
+  it('GET /mesh/stats returns statistics', async () => {
+    mesh = startMeshServer({ port: PORT, dbPath: ':memory:' });
+    mesh.store.createToolAtom(makeToolAtom('t1', 'obs one'));
+    mesh.store.createToolAtom(makeToolAtom('t2', 'obs two completely different'));
+
+    const res = await fetch(`http://localhost:${PORT}/mesh/stats`);
+    const stats = await res.json() as any;
+    expect(stats.totalAtoms).toBe(2);
+    expect(stats.contributors).toBeGreaterThanOrEqual(1);
+  });
+
+  it('batch contribute accepts array', async () => {
+    mesh = startMeshServer({ port: PORT, dbPath: ':memory:' });
+    const atoms = [
+      makeToolAtom('t1', 'first observation'),
+      makeToolAtom('t2', 'second completely different observation'),
+    ];
+    const res = await fetch(`http://localhost:${PORT}/mesh/contribute`, {
+      method: 'POST',
+      headers: { 'Content-Type': 'application/json' },
+      body: JSON.stringify(atoms),
+    });
+    const body = await res.json() as any;
+    expect(body.accepted).toBe(2);
+    expect(mesh.store.getAll().length).toBe(2);
+  });
+});

package/src/config.ts

@@ -0,0 +1,18 @@
+export interface MeshServerConfig {
+  /** Port to listen on (default: 7433) */
+  port: number;
+  /** Path to SQLite database for mesh storage (default: ':memory:') */
+  dbPath: string;
+  /** Allow anonymous contributions (default: true) */
+  allowAnonymous: boolean;
+}
+
+export const DEFAULT_MESH_CONFIG: MeshServerConfig = {
+  port: 7433,
+  dbPath: ':memory:',
+  allowAnonymous: true,
+};
+
+export function resolveMeshConfig(partial?: Partial<MeshServerConfig>): MeshServerConfig {
+  return { ...DEFAULT_MESH_CONFIG, ...partial };
+}

package/src/entrypoint.ts

@@ -0,0 +1,35 @@
+/**
+ * Production entrypoint for the Osmosis mesh server.
+ * Reads config from environment variables and starts the server.
+ */
+import { startMeshServer } from './index.js';
+import { mkdirSync } from 'node:fs';
+import { dirname } from 'node:path';
+
+const port = parseInt(process.env.MESH_PORT || '7433', 10);
+const dbPath = process.env.MESH_DB_PATH || '/data/mesh.db';
+
+// Ensure data directory exists
+try {
+  mkdirSync(dirname(dbPath), { recursive: true });
+} catch {}
+
+// startMeshServer already calls server.listen() internally
+const handle = startMeshServer({ port, dbPath, allowAnonymous: true });
+
+console.log(`🧠 Osmosis mesh server running on port ${port}`);
+console.log(`   Database: ${dbPath}`);
+console.log(`   Ready to accept contributions`);
+
+// Graceful shutdown
+process.on('SIGTERM', () => {
+  console.log('Shutting down...');
+  handle.stop();
+  process.exit(0);
+});
+
+process.on('SIGINT', () => {
+  console.log('Shutting down...');
+  handle.stop();
+  process.exit(0);
+});

package/src/index.ts

@@ -0,0 +1,29 @@
+import { AtomStore } from '@osmosis-ai/core';
+import { createMeshServer } from './server.js';
+import { resolveMeshConfig, type MeshServerConfig } from './config.js';
+import type { Server } from 'node:http';
+
+export { createMeshServer } from './server.js';
+export { resolveMeshConfig, DEFAULT_MESH_CONFIG } from './config.js';
+export type { MeshServerConfig } from './config.js';
+
+export interface MeshServerHandle {
+  store: AtomStore;
+  server: Server;
+  stop(): void;
+}
+
+export function startMeshServer(partial?: Partial<MeshServerConfig>): MeshServerHandle {
+  const config = resolveMeshConfig(partial);
+  const store = new AtomStore(config.dbPath);
+  const server = createMeshServer(store, config);
+
+  return {
+    store,
+    server,
+    stop() {
+      server.close();
+      store.close();
+    },
+  };
+}

package/src/server.ts

@@ -0,0 +1,130 @@
+import { createServer as createHttpServer, type IncomingMessage, type ServerResponse, type Server } from 'node:http';
+import { AtomStore } from '@osmosis-ai/core';
+import type { KnowledgeAtom } from '@osmosis-ai/core';
+import type { MeshServerConfig } from './config.js';
+
+function json(res: ServerResponse, status: number, data: unknown): void {
+  res.writeHead(status, { 'Content-Type': 'application/json' });
+  res.end(JSON.stringify(data));
+}
+
+function readBody(req: IncomingMessage): Promise<string> {
+  return new Promise((resolve, reject) => {
+    const chunks: Buffer[] = [];
+    req.on('data', (c: Buffer) => chunks.push(c));
+    req.on('end', () => resolve(Buffer.concat(chunks).toString()));
+    req.on('error', reject);
+  });
+}
+
+/**
+ * Create the centralized mesh HTTP server.
+ *
+ * Routes:
+ *   POST /mesh/contribute         — submit atoms to the mesh
+ *   GET  /mesh/atoms?since=<ISO>  — get atoms since timestamp
+ *   GET  /mesh/query?q=&type=&limit= — query mesh for relevant knowledge
+ *   GET  /mesh/stats              — mesh statistics
+ */
+export function createMeshServer(store: AtomStore, config: MeshServerConfig): Server {
+  const server = createHttpServer(async (req: IncomingMessage, res: ServerResponse) => {
+    const url = new URL(req.url ?? '/', `http://localhost:${config.port}`);
+    const path = url.pathname;
+    const method = req.method ?? 'GET';
+
+    try {
+      // POST /mesh/contribute — accept atoms from clients
+      if (method === 'POST' && path === '/mesh/contribute') {
+        const body = JSON.parse(await readBody(req));
+        const atoms: any[] = Array.isArray(body) ? body : [body];
+        const results: Array<{ id: string; status: 'created' | 'deduped' }> = [];
+
+        for (const atomData of atoms) {
+          // Strip client-side auto fields; mesh generates its own
+          const { id, created_at, updated_at, ...data } = atomData;
+          // Force quarantine trust tier on mesh
+          data.trust_tier = 'quarantine';
+
+          let result: KnowledgeAtom;
+          if (data.type === 'tool') {
+            result = store.createToolAtom(data);
+          } else if (data.type === 'negative') {
+            result = store.createNegativeAtom(data);
+          } else {
+            result = store.createAtom(data);
+          }
+
+          // Detect dedup: if evidence_count > 1, it was merged
+          const ec = (result as any).evidence_count;
+          results.push({
+            id: result.id,
+            status: ec && ec > 1 ? 'deduped' : 'created',
+          });
+        }
+
+        return json(res, 200, { accepted: results.length, results });
+      }
+
+      // GET /mesh/atoms?since=<ISO>
+      if (method === 'GET' && path === '/mesh/atoms') {
+        const since = url.searchParams.get('since');
+        let atoms = store.getAll();
+        if (since) {
+          atoms = atoms.filter(a => a.updated_at > since);
+        }
+        return json(res, 200, atoms);
+      }
+
+      // GET /mesh/query?q=<search>&type=<type>&limit=<n>
+      if (method === 'GET' && path === '/mesh/query') {
+        const q = url.searchParams.get('q') ?? '';
+        const type = url.searchParams.get('type');
+        const limit = parseInt(url.searchParams.get('limit') ?? '20', 10);
+
+        let atoms: KnowledgeAtom[];
+        if (q) {
+          atoms = store.search(q);
+        } else if (type) {
+          atoms = store.queryByType(type as any);
+        } else {
+          atoms = store.getAll();
+        }
+
+        if (type && q) {
+          atoms = atoms.filter(a => a.type === type);
+        }
+
+        atoms = atoms.slice(0, limit);
+        return json(res, 200, atoms);
+      }
+
+      // GET /mesh/stats
+      if (method === 'GET' && path === '/mesh/stats') {
+        const all = store.getAll();
+        const contributors = new Set(all.map(a => a.source_agent_hash));
+        const topAtoms = [...all]
+          .sort((a, b) => b.fitness_score - a.fitness_score)
+          .slice(0, 10);
+
+        return json(res, 200, {
+          totalAtoms: all.length,
+          contributors: contributors.size,
+          topAtoms: topAtoms.map(a => ({
+            id: a.id,
+            type: a.type,
+            observation: a.observation.slice(0, 120),
+            fitness_score: a.fitness_score,
+          })),
+        });
+      }
+
+      json(res, 404, { error: 'Not found' });
+    } catch (err: any) {
+      const status = err.name === 'ZodError' ? 400 : 500;
+      json(res, status, { error: err.message ?? 'Internal error' });
+    }
+  });
+
+  server.listen(config.port);
+  return server;
+}

package/tsconfig.json

@@ -0,0 +1,23 @@
+{
+  "compilerOptions": {
+    "target": "ES2022",
+    "module": "ES2022",
+    "moduleResolution": "bundler",
+    "lib": ["ES2022"],
+    "outDir": "dist",
+    "rootDir": "src",
+    "declaration": true,
+    "strict": true,
+    "esModuleInterop": true,
+    "skipLibCheck": true,
+    "forceConsistentCasingInFileNames": true,
+    "resolveJsonModule": true,
+    "sourceMap": true,
+    "composite": true
+  },
+  "include": ["src"],
+  "exclude": ["node_modules", "dist", "**/*.test.ts"],
+  "references": [
+    { "path": "../core" }
+  ]
+}