@justfortytwo/memory 0.1.0

package/dist/migrations/003_approvals.js

@@ -0,0 +1,37 @@
+// Durable backing for gate's ApprovalStore + AuditLogger seam (see
+// gate-approval-store.ts). `approvals` holds staged one-shot approvals keyed by
+// tool_use_id; `audit_log` is an append-only trail. Both live on memory's db so a
+// host can give the gate a transactional store instead of its JSONL default.
+export async function up(k) {
+    await k.schema
+        .createTable('approvals', (t) => {
+        t.string('id').primary(); // pa_<uuid>
+        t.string('tool').notNullable();
+        t.string('target').notNullable();
+        t.text('payload').notNullable().defaultTo('{}');
+        t.string('tier').notNullable();
+        t.string('tool_use_id').notNullable();
+        t.string('session_id').nullable();
+        t.string('status').notNullable().defaultTo('pending'); // pending|approved|denied|executed|expired
+        t.string('decided_by').nullable(); // who approved/denied (audit attribution)
+        t.string('created_at').notNullable();
+        t.string('updated_at').notNullable();
+        // One staged row per tool_use_id (gate's "most-recent-wins" contract);
+        // addPending upserts, so a re-request replaces the prior row deterministically.
+        t.unique(['tool_use_id']);
+        t.index(['status']);
+    })
+        .createTable('audit_log', (t) => {
+        t.increments('id').primary();
+        t.datetime('ts', { useTz: false }).notNullable().defaultTo(k.fn.now());
+        t.string('actor').notNullable();
+        t.string('kind').notNullable();
+        t.text('content').notNullable();
+        t.string('approval_status').nullable();
+        t.text('meta').notNullable().defaultTo('{}');
+    });
+}
+export async function down(k) {
+    await k.schema.dropTableIfExists('audit_log').dropTableIfExists('approvals');
+}
+//# sourceMappingURL=003_approvals.js.map

package/dist/migrations/003_approvals.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"003_approvals.js","sourceRoot":"","sources":["../../src/migrations/003_approvals.ts"],"names":[],"mappings":"AAEA,mEAAmE;AACnE,gFAAgF;AAChF,kFAAkF;AAClF,6EAA6E;AAC7E,MAAM,CAAC,KAAK,UAAU,EAAE,CAAC,CAAO;IAC9B,MAAM,CAAC,CAAC,MAAM;SACX,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE;QAC9B,CAAC,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC,CAAc,YAAY;QACnD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC;QACjC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;QAChD,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,CAAC,CAAC,MAAM,CAAC,aAAa,CAAC,CAAC,WAAW,EAAE,CAAC;QACtC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC;QAClC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,SAAS,CAAC,CAAC,CAAC,2CAA2C;QAClG,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAM,0CAA0C;QAClF,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,CAAC,CAAC,MAAM,CAAC,YAAY,CAAC,CAAC,WAAW,EAAE,CAAC;QACrC,uEAAuE;QACvE,gFAAgF;QAChF,CAAC,CAAC,MAAM,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC;QAC1B,CAAC,CAAC,KAAK,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;IACtB,CAAC,CAAC;SACD,WAAW,CAAC,WAAW,EAAE,CAAC,CAAC,EAAE,EAAE;QAC9B,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,CAAC;QAC7B,CAAC,CAAC,QAAQ,CAAC,IAAI,EAAE,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC;QACvE,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC;QAC/B,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,WAAW,EAAE,CAAC;QAChC,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,CAAC,QAAQ,EAAE,CAAC;QACvC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,WAAW,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC;IAC/C,CAAC,CAAC,CAAC;AACP,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,CAAO;IAChC,MAAM,CAAC,CAAC,MAAM,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC,iBAAiB,CAAC,WAAW,CAAC,CAAC;AAC/E,CAAC"}

package/dist/tools.d.ts

@@ -0,0 +1,2 @@
+import type { Tool } from '@modelcontextprotocol/sdk/types.js';
+export declare function toolDefinitions(): Tool[];

package/dist/tools.js

@@ -0,0 +1,66 @@
+// Wire schema for the generic memory tool surface. Keep in sync with
+// contract.ts (memoryToolContract) — that file is the version-tracked
+// human contract; this file is what the MCP ListTools handler returns.
+export function toolDefinitions() {
+    return [
+        {
+            name: 'store',
+            description: 'Store a memory (content + free-form provenance) and embed it for recall. Set `supersedes` to replace a prior memory (history is kept; never a silent overwrite).',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    content: { type: 'string' },
+                    source: { type: 'string', description: 'Free-form provenance, e.g. owner, web, tool:foo.' },
+                    observed: { type: 'string', description: 'Free-form, e.g. stated, inferred, imported.' },
+                    date: { type: 'string', description: 'ISO date the memory pertains to. Defaults to today (UTC).' },
+                    tags: { type: 'array', items: { type: 'string' } },
+                    meta: { type: 'object', description: 'Arbitrary structured provenance.' },
+                    supersedes: { type: 'number', description: 'Id of a memory this one replaces.' },
+                },
+                required: ['content'],
+            },
+        },
+        {
+            name: 'query',
+            description: 'Structured query over the memory store (source/observed/tag/time). Returns live rows only unless live_only=false.',
+            inputSchema: {
+                type: 'object',
+                properties: {
+                    source: { type: 'string' }, observed: { type: 'string' }, tag: { type: 'string' },
+                    since: { type: 'string' }, until: { type: 'string' },
+                    live_only: { type: 'boolean' }, limit: { type: 'number' },
+                },
+            },
+        },
+        {
+            name: 'recall',
+            description: 'Semantic top-k recall over the memory store by meaning.',
+            inputSchema: { type: 'object', properties: { text: { type: 'string' }, k: { type: 'number' } }, required: ['text'] },
+        },
+        {
+            name: 'recall_docs',
+            description: 'Semantic top-k recall over reindexed markdown documents (the doc_vec index built by reindex).',
+            inputSchema: { type: 'object', properties: { text: { type: 'string' }, k: { type: 'number' } }, required: ['text'] },
+        },
+        {
+            name: 'lexical',
+            description: 'Full-text keyword search over the memory store (FTS5).',
+            inputSchema: { type: 'object', properties: { text: { type: 'string' }, k: { type: 'number' } }, required: ['text'] },
+        },
+        {
+            name: 'reindex',
+            description: 'Self-heal the doc recall index from a directory of markdown files. Pass the directory in `root`.',
+            inputSchema: { type: 'object', properties: { root: { type: 'string' } }, required: ['root'] },
+        },
+        {
+            name: 'export_range',
+            description: 'Render a date range of memories to markdown (for debugging/export).',
+            inputSchema: {
+                type: 'object',
+                properties: { since: { type: 'string' }, until: { type: 'string' } },
+                required: ['since', 'until'],
+            },
+        },
+    ];
+}
+//# sourceMappingURL=tools.js.map

package/dist/tools.js.map

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

package/package.json

@@ -0,0 +1,68 @@
+{
+  "name": "@justfortytwo/memory",
+  "version": "0.1.0",
+  "description": "Standalone semantic-memory MCP server (SQLite + sqlite-vec + Ollama embedder). persona-agnostic.",
+  "license": "MIT",
+  "author": {
+    "name": "Enrico Deleo",
+    "url": "https://enricodeleo.com"
+  },
+  "homepage": "https://forty-two.it",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/justfortytwo/memory.git"
+  },
+  "type": "module",
+  "engines": {
+    "node": ">=18"
+  },
+  "bin": {
+    "fortytwo-memory": "dist/index.js"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js",
+    "./contract": "./dist/contract.js"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsc",
+    "start": "node dist/index.js",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "migrate": "node dist/migrate.js",
+    "prepublishOnly": "npm run build"
+  },
+  "dependencies": {
+    "@modelcontextprotocol/sdk": "^1.0.0",
+    "better-sqlite3": "^11.0.0",
+    "knex": "^3.1.0",
+    "sqlite-vec": "^0.1.6"
+  },
+  "peerDependencies": {
+    "@justfortytwo/gate": "^0.1.0",
+    "@justfortytwo/salience": "^0.1.0"
+  },
+  "peerDependenciesMeta": {
+    "@justfortytwo/gate": {
+      "optional": true
+    },
+    "@justfortytwo/salience": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@types/better-sqlite3": "^7.6.0",
+    "@types/node": "^20.0.0",
+    "typescript": "^5.4.0",
+    "vitest": "^1.6.0"
+  },
+  "publishConfig": {
+    "access": "public"
+  }
+}