ai-memory-layer 2.0.0

package/bin/memory-server.mjs

@@ -0,0 +1,157 @@
+#!/usr/bin/env node
+
+const args = process.argv.slice(2);
+
+function getArg(name) {
+  const index = args.indexOf(`--${name}`);
+  if (index === -1) return undefined;
+  return args[index + 1];
+}
+
+if (args.includes('--help') || args.includes('-h')) {
+  console.log(`
+memory-layer - Drop-in memory server for AI systems
+
+Usage:
+  memory-layer serve [options]
+  memory-layer inspect <knowledge|audits|monitor|compactions|reverification|changes> [options]
+
+Options:
+  --db <path>          Database path (default: ':memory:')
+  --database-url <url> Postgres connection string for hosted mode
+  --scope <scope>      Default scope identifier (default: 'default')
+  --summarizer <type>  Summarizer: extractive|claude|openai (default: extractive)
+  --extractor <type>   Extractor: regex|claude|openai|none (default: regex)
+  --preset <preset>    Preset: ai_ide|chat_agent|autonomous_agent
+  --quality-mode <m>   Quality mode: fast_adoption|balanced_memory|high_fidelity_memory
+  --quality-tier <t>   Legacy tier: offline_default|local_semantic|provider_backed
+  --cross-scope-level  Cross-scope level: scope|workspace|system|tenant
+  --transport <type>   Transport: mcp|http|both (default: mcp)
+  --port <port>        HTTP port (default: 3100)
+  --host <host>        HTTP host (default: 127.0.0.1)
+  --api-key <key>      Bearer auth key for HTTP requests
+  --admin-key <key>    Admin key for compaction and maintenance endpoints
+  --body-limit <n>     Maximum HTTP request body bytes (default: 1048576)
+  --help               Show this help message
+  --tenant <id>        Explicit tenant for inspect mode
+  --system <id>        Explicit system for inspect mode
+  --workspace <id>     Explicit workspace for inspect mode
+  --collaboration <id> Explicit collaboration for inspect mode
+  --scope-id <id>      Explicit scope_id for inspect mode
+  --id <n>             Knowledge id for inspect mode
+  --knowledge-id <n>   Filter audits to a specific knowledge id
+  --limit <n>          Limit rows for inspect mode
+  --cursor <n>         Pagination cursor for inspect knowledge
+  --since <iso>        Lower bound for inspect changes
+  --run                Execute reverification instead of only listing due items
+
+Environment variables:
+  MEMORY_DB_PATH       Database path
+  MEMORY_SCOPE         Default scope
+  MEMORY_DATABASE_URL  Postgres connection string
+  MEMORY_SUMMARIZER    Summarizer type
+  MEMORY_EXTRACTOR     Extractor type
+  MEMORY_PRESET        Preset name
+  MEMORY_QUALITY_MODE  Hosted quality mode
+  MEMORY_QUALITY_TIER  Legacy hosted quality tier
+  MEMORY_CROSS_SCOPE_LEVEL Default hosted cross-scope level
+  MEMORY_API_KEY       API key for HTTP bearer auth
+  MEMORY_ADMIN_API_KEY Admin key for privileged endpoints
+  MEMORY_TRANSPORT     Transport type (mcp|http|both)
+  MEMORY_HOST          HTTP host
+  MEMORY_BODY_LIMIT    Maximum HTTP request body bytes
+
+Examples:
+  npx memory-layer serve --db ./memory.db --preset ai_ide
+  npx memory-layer serve --transport http --port 3100
+  npx memory-layer serve --transport both --db ./shared.db
+  npx memory-layer inspect knowledge --db ./memory.db --limit 20
+  npx memory-layer inspect reverification --db ./memory.db --run
+  `);
+  process.exit(0);
+}
+
+const command = args[0];
+if (command && command !== 'serve' && command !== 'inspect') {
+  console.error(`Unknown command: ${command}. Use 'serve', 'inspect', or --help.`);
+  process.exit(1);
+}
+
+const config = {
+  dbPath: getArg('db') ?? process.env.MEMORY_DB_PATH ?? ':memory:',
+  databaseUrl: getArg('database-url') ?? process.env.MEMORY_DATABASE_URL ?? undefined,
+  scope: getArg('scope') ?? process.env.MEMORY_SCOPE ?? 'default',
+  summarizer: getArg('summarizer') ?? process.env.MEMORY_SUMMARIZER ?? 'extractive',
+  extractor: getArg('extractor') ?? process.env.MEMORY_EXTRACTOR ?? 'regex',
+  preset: getArg('preset') ?? process.env.MEMORY_PRESET ?? undefined,
+  qualityMode: getArg('quality-mode') ?? process.env.MEMORY_QUALITY_MODE ?? undefined,
+  qualityTier: getArg('quality-tier') ?? process.env.MEMORY_QUALITY_TIER ?? undefined,
+  crossScopeLevel: getArg('cross-scope-level') ?? process.env.MEMORY_CROSS_SCOPE_LEVEL ?? undefined,
+  apiKey: getArg('api-key') ?? process.env.MEMORY_API_KEY ?? undefined,
+  adminApiKey: getArg('admin-key') ?? process.env.MEMORY_ADMIN_API_KEY ?? undefined,
+  host: getArg('host') ?? process.env.MEMORY_HOST ?? '127.0.0.1',
+  bodyLimitBytes: Number(getArg('body-limit') ?? process.env.MEMORY_BODY_LIMIT ?? 1048576),
+};
+
+if (config.extractor === 'none') {
+  config.extractor = false;
+}
+
+const transport = getArg('transport') ?? process.env.MEMORY_TRANSPORT ?? 'mcp';
+const port = Number(getArg('port') ?? process.env.MEMORY_PORT ?? 3100);
+
+async function main() {
+  if (command === 'inspect') {
+    const target = args[1] ?? 'knowledge';
+    const { runInspectCommand } = await import('../dist/cli/inspect.js');
+    const output = await runInspectCommand(target, {
+      dbPath: config.dbPath,
+      databaseUrl: config.databaseUrl,
+      scope: config.scope,
+      tenantId: getArg('tenant'),
+      systemId: getArg('system'),
+      workspaceId: getArg('workspace'),
+      collaborationId: getArg('collaboration'),
+      scopeId: getArg('scope-id'),
+      qualityMode: config.qualityMode,
+      qualityTier: config.qualityTier,
+      crossScopeLevel: getArg('cross-scope-level') ?? process.env.MEMORY_CROSS_SCOPE_LEVEL,
+      id: getArg('id') ? Number(getArg('id')) : undefined,
+      knowledgeId: getArg('knowledge-id') ? Number(getArg('knowledge-id')) : undefined,
+      limit: getArg('limit') ? Number(getArg('limit')) : undefined,
+      cursor: getArg('cursor') ? Number(getArg('cursor')) : undefined,
+      since: getArg('since'),
+      run: args.includes('--run'),
+    });
+    console.log(output);
+    return;
+  }
+
+  if (transport === 'mcp' || transport === 'both') {
+    const { startMcpServer } = await import('../dist/server/mcp-server.js');
+    if (transport === 'mcp') {
+      await startMcpServer(config);
+      return;
+    }
+    // For 'both', start MCP in background (it reads stdin)
+    startMcpServer(config).catch((err) => {
+      console.error('MCP server error:', err);
+    });
+  }
+
+  if (transport === 'http' || transport === 'both') {
+    const { startHttpServer } = await import('../dist/server/http-server.js');
+    const { server } = await startHttpServer({ ...config, port });
+    console.error(`memory-layer HTTP server listening on ${config.host}:${port}`);
+
+    process.on('SIGINT', () => {
+      server.close();
+      process.exit(0);
+    });
+  }
+}
+
+main().catch((error) => {
+  console.error('Failed to start memory-layer server:', error);
+  process.exit(1);
+});

package/dist/adapters/memory/embeddings.d.ts

@@ -0,0 +1,4 @@
+import type { EmbeddingAdapter } from '../../contracts/embedding.js';
+import type { StorageAdapter } from '../../contracts/storage.js';
+export declare function createInMemoryEmbeddingAdapter(adapter: StorageAdapter): EmbeddingAdapter;
+//# sourceMappingURL=embeddings.d.ts.map

package/dist/adapters/memory/embeddings.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"embeddings.d.ts","sourceRoot":"","sources":["../../../src/adapters/memory/embeddings.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAA2C,MAAM,8BAA8B,CAAC;AAE9G,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AAgBjE,wBAAgB,8BAA8B,CAAC,OAAO,EAAE,cAAc,GAAG,gBAAgB,CAwDxF"}

package/dist/adapters/memory/embeddings.js

@@ -0,0 +1,53 @@
+function cosineSimilarity(a, b) {
+    if (a.length !== b.length || a.length === 0)
+        return 0;
+    let dot = 0;
+    let normA = 0;
+    let normB = 0;
+    for (let index = 0; index < a.length; index += 1) {
+        dot += a[index] * b[index];
+        normA += a[index] * a[index];
+        normB += b[index] * b[index];
+    }
+    if (normA === 0 || normB === 0)
+        return 0;
+    return dot / (Math.sqrt(normA) * Math.sqrt(normB));
+}
+export function createInMemoryEmbeddingAdapter(adapter) {
+    const vectors = new Map();
+    function scoreKnowledge(knowledgeIds, queryVector, limit, minSimilarity) {
+        return knowledgeIds
+            .map((knowledgeMemoryId) => ({
+            knowledgeMemoryId,
+            similarity: cosineSimilarity(queryVector, vectors.get(knowledgeMemoryId) ?? new Float32Array()),
+        }))
+            .filter((result) => result.similarity >= minSimilarity)
+            .sort((left, right) => right.similarity - left.similarity)
+            .slice(0, limit);
+    }
+    return {
+        storeEmbedding(knowledgeMemoryId, vector) {
+            vectors.set(knowledgeMemoryId, new Float32Array(vector));
+        },
+        getEmbedding(knowledgeMemoryId) {
+            const vector = vectors.get(knowledgeMemoryId);
+            return vector ? new Float32Array(vector) : null;
+        },
+        findSimilar(scope, queryVector, options) {
+            const limit = options?.limit ?? 10;
+            const minSimilarity = options?.minSimilarity ?? 0;
+            const ids = adapter.getActiveKnowledgeMemory(scope).map((item) => item.id);
+            return scoreKnowledge(ids, queryVector, limit, minSimilarity);
+        },
+        findSimilarCrossScope(scope, level, queryVector, options) {
+            const limit = options?.limit ?? 10;
+            const minSimilarity = options?.minSimilarity ?? 0;
+            const ids = adapter.getActiveKnowledgeCrossScope(scope, level).map((item) => item.id);
+            return scoreKnowledge(ids, queryVector, limit, minSimilarity);
+        },
+        deleteEmbedding(knowledgeMemoryId) {
+            vectors.delete(knowledgeMemoryId);
+        },
+    };
+}
+//# sourceMappingURL=embeddings.js.map

package/dist/adapters/memory/embeddings.js.map

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

package/dist/adapters/memory/index.d.ts

@@ -0,0 +1,7 @@
+import type { StorageAdapter } from '../../contracts/storage.js';
+import { type TelemetryOptions } from '../../core/telemetry.js';
+export declare function createInMemoryAdapter(telemetry?: TelemetryOptions): StorageAdapter;
+export declare function createInMemoryAdapterWithEmbeddings(telemetry?: TelemetryOptions): StorageAdapter & {
+    embeddings: import('../../contracts/embedding.js').EmbeddingAdapter;
+};
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/memory/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/memory/index.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,4BAA4B,CAAC;AA2BjE,OAAO,EAAmB,KAAK,gBAAgB,EAAE,MAAM,yBAAyB,CAAC;AA4IjF,wBAAgB,qBAAqB,CAAC,SAAS,CAAC,EAAE,gBAAgB,GAAG,cAAc,CA2mBlF;AAED,wBAAgB,mCAAmC,CACjD,SAAS,CAAC,EAAE,gBAAgB,GAC3B,cAAc,GAAG;IAAE,UAAU,EAAE,OAAO,8BAA8B,EAAE,gBAAgB,CAAA;CAAE,CAI1F"}