@agentage/server-memory 0.0.2

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Agentage Contributors
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,45 @@
+# @agentage/server-memory
+
+The **MCP server** for agentage Memory exposes your local vaults
+(`~/.agentage/vaults.json`, read through [`@agentage/memory-core`](https://github.com/agentage/memory-core))
+as the frozen 6 `memory__*` tools over stdio. The open, cross-vendor counterpart to
+`@modelcontextprotocol/server-memory`.
+
+This package is intentionally **small** - it is just the MCP definition (the 6-tool Zod
+schema + `.mcpc.json`, the text renderer, `createMemoryServer`, and a ~15-line stdio bin).
+All memory logic (backends, git, search, routing) lives in `@agentage/memory-core`.
+
+## Use it
+
+```bash
+# one-time, offline: scaffold ~/.agentage + a starter vault
+#   (memory-core's `init`, also surfaced by the agentage CLI)
+npx @agentage/server-memory          # serves ~/.agentage/vaults.json over stdio
+```
+
+Point any stdio MCP client (Windsurf, Zed, Claude Desktop) at `npx @agentage/server-memory`.
+
+## Reused by the CLI daemon
+
+The server builder is transport-agnostic, so the agentage CLI reuses the exact same
+pieces and only swaps the transport:
+
+```ts
+import { createMemoryServer, loadLocalServer } from '@agentage/server-memory';
+
+// stdio bin:        await (await loadLocalServer()).connect(new StdioServerTransport());
+// CLI daemon:       const server = createMemoryServer(registry, { scope: 'local' });
+//                   await server.connect(new StreamableHTTPServerTransport(...));
+```
+
+## Develop
+
+```bash
+npm install        # links @agentage/memory-core via file:../memory-core
+npm test           # vitest: contract (tools/list = 6) + tools (in-memory) + e2e (init -> spawned bin -> round-trip)
+npm run verify     # type-check + lint + format:check + test + build
+```
+
+`@agentage/memory-core` is a local `file:` link until both packages publish to npm; build
+core before running here (the e2e does this automatically). The 6-tool schema and
+`.mcpc.json` snapshot are the frozen MCP contract - keep them in sync if the contract changes.

package/dist/bin/server-memory.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=server-memory.d.ts.map

package/dist/bin/server-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-memory.d.ts","sourceRoot":"","sources":["../../src/bin/server-memory.ts"],"names":[],"mappings":""}

package/dist/bin/server-memory.js

@@ -0,0 +1,21 @@
+#!/usr/bin/env node
+// @agentage/server-memory - the stdio MCP keystone. `npx @agentage/server-memory`
+// exposes the user's local vaults (~/.agentage/vaults.json, read via
+// @agentage/memory-core) as the 6 memory__* tools over stdio, for stdio-only clients
+// (Windsurf, Zed) and as the published npm artifact. Zero memory logic - it binds the
+// memory-core server to a StdioServerTransport.
+//
+// stdout is the JSON-RPC wire; all diagnostics MUST go to stderr.
+import { StdioServerTransport } from '@modelcontextprotocol/sdk/server/stdio.js';
+import { loadLocalServer } from '../server/local-server.js';
+const main = async () => {
+    const server = await loadLocalServer();
+    await server.connect(new StdioServerTransport());
+    // The transport keeps the process alive until the client disconnects (stdin EOF).
+};
+main().catch((err) => {
+    const message = err instanceof Error ? err.message : String(err);
+    process.stderr.write(`[server-memory] fatal: ${message}\n`);
+    process.exit(1);
+});
+//# sourceMappingURL=server-memory.js.map

package/dist/bin/server-memory.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-memory.js","sourceRoot":"","sources":["../../src/bin/server-memory.ts"],"names":[],"mappings":";AACA,kFAAkF;AAClF,qEAAqE;AACrE,qFAAqF;AACrF,sFAAsF;AACtF,gDAAgD;AAChD,EAAE;AACF,kEAAkE;AAElE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAE5D,MAAM,IAAI,GAAG,KAAK,IAAmB,EAAE;IACrC,MAAM,MAAM,GAAG,MAAM,eAAe,EAAE,CAAC;IACvC,MAAM,MAAM,CAAC,OAAO,CAAC,IAAI,oBAAoB,EAAE,CAAC,CAAC;IACjD,kFAAkF;AACpF,CAAC,CAAC;AAEF,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAY,EAAE,EAAE;IAC5B,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,OAAO,IAAI,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,5 @@
+export { MEMORY_TOOLS, type MemoryToolDef } from './server/memory-tools.schema.js';
+export { createMemoryServer, SERVER_NAME, SERVER_TITLE, SERVER_VERSION, type CreateServerOptions, } from './server/create-memory-server.js';
+export { registerTools } from './server/register-tools.js';
+export { loadLocalServer } from './server/local-server.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,iCAAiC,CAAC;AACnF,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,cAAc,EACd,KAAK,mBAAmB,GACzB,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/index.js

@@ -0,0 +1,6 @@
+// @agentage/server-memory public API - the MCP layer over @agentage/memory-core.
+export { MEMORY_TOOLS } from './server/memory-tools.schema.js';
+export { createMemoryServer, SERVER_NAME, SERVER_TITLE, SERVER_VERSION, } from './server/create-memory-server.js';
+export { registerTools } from './server/register-tools.js';
+export { loadLocalServer } from './server/local-server.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":"AAAA,iFAAiF;AACjF,OAAO,EAAE,YAAY,EAAsB,MAAM,iCAAiC,CAAC;AACnF,OAAO,EACL,kBAAkB,EAClB,WAAW,EACX,YAAY,EACZ,cAAc,GAEf,MAAM,kCAAkC,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,4BAA4B,CAAC;AAC3D,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC"}

package/dist/server/create-memory-server.d.ts

@@ -0,0 +1,13 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type McpScope, type VaultRegistry } from '@agentage/memory-core';
+export declare const SERVER_NAME = "agentage-memory";
+export declare const SERVER_TITLE = "Agentage Memory";
+export declare const SERVER_VERSION = "0.0.1";
+export interface CreateServerOptions {
+    scope: McpScope;
+    version?: string;
+    readOnly?: boolean;
+    only?: string;
+}
+export declare const createMemoryServer: (reg: VaultRegistry, opts: CreateServerOptions) => McpServer;
+//# sourceMappingURL=create-memory-server.d.ts.map

package/dist/server/create-memory-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-memory-server.d.ts","sourceRoot":"","sources":["../../src/server/create-memory-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAgB,KAAK,QAAQ,EAAE,KAAK,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAGxF,eAAO,MAAM,WAAW,oBAAoB,CAAC;AAC7C,eAAO,MAAM,YAAY,oBAAoB,CAAC;AAC9C,eAAO,MAAM,cAAc,UAAU,CAAC;AAEtC,MAAM,WAAW,mBAAmB;IAClC,KAAK,EAAE,QAAQ,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAiBD,eAAO,MAAM,kBAAkB,GAAI,KAAK,aAAa,EAAE,MAAM,mBAAmB,KAAG,SAiBlF,CAAC"}

package/dist/server/create-memory-server.js

@@ -0,0 +1,33 @@
+import { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { createRouter } from '@agentage/memory-core';
+import { registerTools } from './register-tools.js';
+export const SERVER_NAME = 'agentage-memory';
+export const SERVER_TITLE = 'Agentage Memory';
+export const SERVER_VERSION = '0.0.1';
+const instructionsFor = (vaultIds) => {
+    const line = vaultIds.length > 1
+        ? `\nThis connection serves these vaults: ${vaultIds.join(', ')}. A path starting @<vault>/ addresses that vault (e.g. @${vaultIds[1]}/notes.md); every other path goes to the default vault. memory__list with no folder shows the vaults.`
+        : '';
+    return (`agentage Memory is the user's persistent memory, shared across every AI they use. Engage it proactively: check it when past context could help, and save decisions, preferences, and durable facts as you learn them.\n` +
+        `Memories are plain markdown files at POSIX paths (e.g. work/tasks/plan.md). Browse with memory__list, find by keyword with memory__search (single literal substring), read one with memory__read. Save with memory__write (new note or full rewrite) or memory__edit (in place: str_replace for small changes, append to add). Read a memory before editing it.` +
+        line);
+};
+// Build an MCP server exposing the frozen 6 tools over the registry's surfaced
+// vaults (those whose mcp scope includes opts.scope). Transport-agnostic: connect
+// it to a stdio or Streamable-HTTP transport. The vault router federates per-call.
+export const createMemoryServer = (reg, opts) => {
+    const scoped = reg.surfaced(opts.scope);
+    const surfaced = opts.only ? scoped.filter((h) => h.id === opts.only) : scoped;
+    const fallbackDefault = reg.default();
+    const defaultHandle = surfaced.find((h) => h.id === fallbackDefault?.id) ?? surfaced[0];
+    const router = createRouter(surfaced, defaultHandle);
+    const server = new McpServer({
+        name: SERVER_NAME,
+        title: SERVER_TITLE,
+        version: opts.version ?? SERVER_VERSION,
+        websiteUrl: 'https://agentage.io',
+    }, { capabilities: { tools: {} }, instructions: instructionsFor(surfaced.map((h) => h.id)) });
+    registerTools(server, router, { readOnly: opts.readOnly });
+    return server;
+};
+//# sourceMappingURL=create-memory-server.js.map

package/dist/server/create-memory-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-memory-server.js","sourceRoot":"","sources":["../../src/server/create-memory-server.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,YAAY,EAAqC,MAAM,uBAAuB,CAAC;AACxF,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAEpD,MAAM,CAAC,MAAM,WAAW,GAAG,iBAAiB,CAAC;AAC7C,MAAM,CAAC,MAAM,YAAY,GAAG,iBAAiB,CAAC;AAC9C,MAAM,CAAC,MAAM,cAAc,GAAG,OAAO,CAAC;AAStC,MAAM,eAAe,GAAG,CAAC,QAAkB,EAAU,EAAE;IACrD,MAAM,IAAI,GACR,QAAQ,CAAC,MAAM,GAAG,CAAC;QACjB,CAAC,CAAC,0CAA0C,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,2DAA2D,QAAQ,CAAC,CAAC,CAAC,uGAAuG;QAC5O,CAAC,CAAC,EAAE,CAAC;IACT,OAAO,CACL,yNAAyN;QACzN,iWAAiW;QACjW,IAAI,CACL,CAAC;AACJ,CAAC,CAAC;AAEF,+EAA+E;AAC/E,kFAAkF;AAClF,mFAAmF;AACnF,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,GAAkB,EAAE,IAAyB,EAAa,EAAE;IAC7F,MAAM,MAAM,GAAG,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IACxC,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;IAC/E,MAAM,eAAe,GAAG,GAAG,CAAC,OAAO,EAAE,CAAC;IACtC,MAAM,aAAa,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,eAAe,EAAE,EAAE,CAAC,IAAI,QAAQ,CAAC,CAAC,CAAC,CAAC;IACxF,MAAM,MAAM,GAAG,YAAY,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;IACrD,MAAM,MAAM,GAAG,IAAI,SAAS,CAC1B;QACE,IAAI,EAAE,WAAW;QACjB,KAAK,EAAE,YAAY;QACnB,OAAO,EAAE,IAAI,CAAC,OAAO,IAAI,cAAc;QACvC,UAAU,EAAE,qBAAqB;KAClC,EACD,EAAE,YAAY,EAAE,EAAE,KAAK,EAAE,EAAE,EAAE,EAAE,YAAY,EAAE,eAAe,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,CAC1F,CAAC;IACF,aAAa,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,QAAQ,EAAE,IAAI,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC3D,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC"}

package/dist/server/local-server.d.ts

@@ -0,0 +1,6 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+export interface LocalServerOptions {
+    configDir?: string;
+}
+export declare const loadLocalServer: (opts?: LocalServerOptions) => Promise<McpServer>;
+//# sourceMappingURL=local-server.d.ts.map

package/dist/server/local-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-server.d.ts","sourceRoot":"","sources":["../../src/server/local-server.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AASzE,MAAM,WAAW,kBAAkB;IACjC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAgBD,eAAO,MAAM,eAAe,GAAU,OAAM,kBAAuB,KAAG,OAAO,CAAC,SAAS,CAStF,CAAC"}

package/dist/server/local-server.js

@@ -0,0 +1,26 @@
+import { createRegistry, loadConfig, } from '@agentage/memory-core';
+import { createMemoryServer } from './create-memory-server.js';
+const truthy = (v) => v === '1' || v === 'true' || v === 'yes';
+// Resolve config from the environment first (so `npx` works with no file):
+//   AGENTAGE_VAULTS_DIR -> autodiscover every subfolder of that dir as a vault;
+//   otherwise           -> read ~/.agentage/vaults.json (or the zero-config default).
+const resolveConfig = async (configDir) => {
+    const vaultsDir = process.env.AGENTAGE_VAULTS_DIR;
+    if (vaultsDir)
+        return { version: 1, vaultsDir, autodiscover: true, autoInit: true };
+    return loadConfig({ configDir });
+};
+// The whole local stack in one call: resolve config -> registry (memory-core) -> an
+// MCP server over the surfaced vaults. Honors env knobs: AGENTAGE_VAULTS_DIR,
+// AGENTAGE_VAULT (one vault), AGENTAGE_SCOPE (local|remote), AGENTAGE_READONLY.
+export const loadLocalServer = async (opts = {}) => {
+    const config = await resolveConfig(opts.configDir);
+    const registry = await createRegistry(config);
+    const scope = process.env.AGENTAGE_SCOPE || 'local';
+    return createMemoryServer(registry, {
+        scope,
+        readOnly: truthy(process.env.AGENTAGE_READONLY),
+        only: process.env.AGENTAGE_VAULT || undefined,
+    });
+};
+//# sourceMappingURL=local-server.js.map

package/dist/server/local-server.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"local-server.js","sourceRoot":"","sources":["../../src/server/local-server.ts"],"names":[],"mappings":"AACA,OAAO,EACL,cAAc,EACd,UAAU,GAGX,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAM/D,MAAM,MAAM,GAAG,CAAC,CAAqB,EAAW,EAAE,CAAC,CAAC,KAAK,GAAG,IAAI,CAAC,KAAK,MAAM,IAAI,CAAC,KAAK,KAAK,CAAC;AAE5F,2EAA2E;AAC3E,gFAAgF;AAChF,sFAAsF;AACtF,MAAM,aAAa,GAAG,KAAK,EAAE,SAAkB,EAAyB,EAAE;IACxE,MAAM,SAAS,GAAG,OAAO,CAAC,GAAG,CAAC,mBAAmB,CAAC;IAClD,IAAI,SAAS;QAAE,OAAO,EAAE,OAAO,EAAE,CAAC,EAAE,SAAS,EAAE,YAAY,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC;IACpF,OAAO,UAAU,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC;AACnC,CAAC,CAAC;AAEF,oFAAoF;AACpF,8EAA8E;AAC9E,gFAAgF;AAChF,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,OAA2B,EAAE,EAAsB,EAAE;IACzF,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IACnD,MAAM,QAAQ,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC9C,MAAM,KAAK,GAAI,OAAO,CAAC,GAAG,CAAC,cAA2B,IAAI,OAAO,CAAC;IAClE,OAAO,kBAAkB,CAAC,QAAQ,EAAE;QAClC,KAAK;QACL,QAAQ,EAAE,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB,CAAC;QAC/C,IAAI,EAAE,OAAO,CAAC,GAAG,CAAC,cAAc,IAAI,SAAS;KAC9C,CAAC,CAAC;AACL,CAAC,CAAC"}

package/dist/server/memory-tools.schema.d.ts

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+export interface MemoryToolDef {
+    name: string;
+    title: string;
+    description: string;
+    annotations: {
+        readOnlyHint: boolean;
+        destructiveHint: boolean;
+        openWorldHint: boolean;
+        idempotentHint?: boolean;
+    };
+    input: z.ZodRawShape;
+    output: z.ZodRawShape;
+}
+export declare const MEMORY_TOOLS: readonly MemoryToolDef[];
+//# sourceMappingURL=memory-tools.schema.d.ts.map

package/dist/server/memory-tools.schema.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"memory-tools.schema.d.ts","sourceRoot":"","sources":["../../src/server/memory-tools.schema.ts"],"names":[],"mappings":"AAIA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAkLxB,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE;QACX,YAAY,EAAE,OAAO,CAAC;QACtB,eAAe,EAAE,OAAO,CAAC;QACzB,aAAa,EAAE,OAAO,CAAC;QACvB,cAAc,CAAC,EAAE,OAAO,CAAC;KAC1B,CAAC;IACF,KAAK,EAAE,CAAC,CAAC,WAAW,CAAC;IACrB,MAAM,EAAE,CAAC,CAAC,WAAW,CAAC;CACvB;AAED,eAAO,MAAM,YAAY,EAAE,SAAS,aAAa,EAsEvC,CAAC"}

package/dist/server/memory-tools.schema.js

@@ -0,0 +1,205 @@
+// The frozen 6-tool surface. Changing any tool name or shape is a breaking change to
+// the MCP contract, guarded by the .mcpc.json snapshot test. Descriptions are
+// multi-sentence and cross-model-tuned; input param keys stay snake_case.
+import { z } from 'zod';
+const pathField = z
+    .string()
+    .trim()
+    .min(1)
+    .max(1024)
+    .describe('Exact POSIX .md address - not a title or search query. Case-sensitive, no leading slash. e.g. work/tasks/foo.md');
+const limitField = z
+    .number()
+    .int()
+    .min(1)
+    .max(50)
+    .describe('Optional. Max results in this page; defaults to 20, capped at 50.')
+    .optional();
+const cursorField = z
+    .string()
+    .min(1)
+    .describe("Opaque pagination token - pass the previous response's nextCursor here verbatim for the next page. Omit for the first page; never construct or edit it.")
+    .optional();
+const folderField = z
+    .string()
+    .trim()
+    .max(1024)
+    .describe('Folder, POSIX, no leading slash (trailing slash optional), e.g. work/tasks. Matches that folder only - not a string prefix. Omit = whole memory')
+    .optional();
+const tagsField = z
+    .array(z.string().trim().min(1).max(128))
+    .max(50)
+    .describe('Tags to filter by (frontmatter tags: or inline #tag), AND-matched (all must be present), case-sensitive, bare without #. e.g. [project, active]. Omit = no tag filter')
+    .optional();
+const frontmatterField = z
+    .record(z.string(), z.unknown())
+    .describe('YAML metadata as a key->value map (no --- fences), e.g. {"type":"task","status":"active","tags":["project"]}. write replaces the whole map; edit shallow-merges top-level keys (nested values replaced wholesale; a key cannot be removed via edit - use write to fully replace)')
+    .optional();
+const searchInput = {
+    query: z
+        .string()
+        .trim()
+        .min(1)
+        .describe('Literal text to find (case-insensitive). Matched as ONE exact substring across titles/bodies/tags - not semantic, not split into words - so a multi-word query matches only that exact phrase; search a SINGLE distinctive keyword. e.g. pkce'),
+    folder: folderField,
+    tags: tagsField,
+    limit: limitField,
+    cursor: cursorField,
+};
+const searchOutput = {
+    results: z.array(z.object({
+        path: z.string(),
+        title: z.string(),
+        snippet: z.string(),
+        score: z.number(),
+        updated: z.string(),
+    })),
+    nextCursor: z.string().optional(),
+};
+const readInput = { path: pathField };
+const readOutput = {
+    path: z.string(),
+    title: z.string(),
+    frontmatter: z.record(z.string(), z.unknown()),
+    body: z.string(),
+    tags: z.array(z.string()),
+    updated: z.string(),
+    deleted: z.boolean(),
+};
+const listInput = {
+    folder: folderField,
+    depth: z
+        .number()
+        .int()
+        .min(1)
+        .max(2)
+        .describe('Optional. 1 = direct children of the folder only; 2 (default) = also expand each subfolder one more level.')
+        .optional(),
+    tags: tagsField,
+};
+const treeFileSchema = z.object({
+    type: z.literal('file'),
+    path: z.string(),
+    title: z.string(),
+    updated: z.string(),
+});
+const treeSubfolderSchema = z.object({
+    type: z.literal('folder'),
+    path: z.string(),
+    files: z.number().describe('Recursive file count inside this folder'),
+    truncated: z
+        .boolean()
+        .describe('True = this folder was NOT expanded (over the per-folder entry limit or the response budget); call memory__list with this folder path to see inside')
+        .optional(),
+});
+const treeFolderSchema = treeSubfolderSchema.extend({
+    entries: z
+        .array(z.discriminatedUnion('type', [treeFileSchema, treeSubfolderSchema]))
+        .describe('Direct children, present when this folder is expanded (within depth and limits)')
+        .optional(),
+});
+const listOutput = {
+    folder: z.string().describe('The browsed folder, normalized; empty = memory root'),
+    entries: z.array(z.discriminatedUnion('type', [treeFileSchema, treeFolderSchema])),
+    truncated: z
+        .boolean()
+        .describe('True = something was omitted anywhere in this response (a folder over the per-folder limit, or the response budget); narrow with a subfolder or memory__search'),
+    files: z.number().describe('Total files under the browsed folder (after the tags filter)'),
+};
+const writeInput = {
+    path: pathField,
+    body: z
+        .string()
+        .describe('The complete Markdown body, excluding frontmatter (no --- fences). write overwrites the entire existing body.'),
+    frontmatter: frontmatterField,
+};
+const writeOutput = { path: z.string(), updated: z.string() };
+const editInput = {
+    path: pathField,
+    body: z
+        .string()
+        .describe('Markdown body, excluding frontmatter (no --- fences). With mode=replace it becomes the new body; with mode=append it is added to the end. Not used with mode=str_replace. Omit to change only frontmatter.')
+        .optional(),
+    frontmatter: frontmatterField,
+    mode: z
+        .enum(['replace', 'append', 'str_replace'])
+        .describe('Optional. "str_replace" swaps old_str for new_str in place; "append" adds body to the end; omit or "replace" overwrites the whole body. Frontmatter always shallow-merges regardless.')
+        .optional(),
+    old_str: z
+        .string()
+        .min(1)
+        .describe('mode=str_replace only. The exact existing body text to replace - must match verbatim (including whitespace) and appear exactly once. Read the memory first to copy it.')
+        .optional(),
+    new_str: z
+        .string()
+        .describe('mode=str_replace only. The replacement text. Omit to delete old_str.')
+        .optional(),
+};
+const deleteInput = { path: pathField };
+const deleteOutput = { path: z.string(), deleted: z.literal(true) };
+export const MEMORY_TOOLS = [
+    {
+        name: 'memory__search',
+        title: 'Search memory',
+        description: 'Find memories by literal text, ranked by match count. Matches the query as ONE case-insensitive substring (not semantic, not tokenized) across titles/bodies/tags - so search a SINGLE keyword, not a phrase. Returns path+snippet+score (score = number of matches, not a relevance %), never full bodies. Use when you have a keyword to rank by; to browse the folder tree instead, use memory__list. Zero hits? try a synonym.',
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        input: searchInput,
+        output: searchOutput,
+    },
+    {
+        name: 'memory__read',
+        title: 'Read memory',
+        description: 'Read ONE memory by its exact path: returns full frontmatter + body. Use a path you got from memory__search/list, a prior write/edit, or the user - do not invent or guess one from a title. No known path? use memory__search first.',
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        input: readInput,
+        output: readOutput,
+    },
+    {
+        name: 'memory__list',
+        title: 'Browse memory',
+        description: 'Browse the memory as a folder tree: the files and subfolders under a folder, 2 levels deep by default, with per-folder file counts - no bodies, no ranking. Use to see what exists and how it is organized, or to list every note carrying a tag (tags filter); have a keyword to rank by instead? use memory__search. A folder shown without its own entries has more inside: call memory__list again with that folder. Folders over the per-folder entry limit are flagged truncated and not expanded - browse them directly or narrow with memory__search.',
+        annotations: { readOnlyHint: true, destructiveHint: false, openWorldHint: false },
+        input: listInput,
+        output: listOutput,
+    },
+    {
+        name: 'memory__write',
+        title: 'Write memory',
+        description: 'Create a NEW memory or fully OVERWRITE an existing one at path - replaces the entire body and frontmatter (idempotent; the saved memory persists for every AI). Use when you have the complete final content. To change only part of an existing memory, use memory__edit. Store durable knowledge and notes only - never secrets, passwords, API keys, one-time codes, or payment/government identifiers (these are refused).',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: true,
+            openWorldHint: false,
+        },
+        input: writeInput,
+        output: writeOutput,
+    },
+    {
+        name: 'memory__edit',
+        title: 'Edit memory',
+        description: 'Amend an EXISTING memory in place: mode=str_replace swaps one exact text match (old_str -> new_str) without resending the note - the default choice for small changes; append adds to the end; replace overwrites the whole body; frontmatter shallow-merges. Fails with not-found if the path does not exist - use memory__write to create. Do not introduce secrets, passwords, API keys, one-time codes, or payment/government identifiers (these are refused).',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: false,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+        input: editInput,
+        output: writeOutput,
+    },
+    {
+        name: 'memory__delete',
+        title: 'Delete memory',
+        description: 'Soft-delete (forget) a memory by path; recoverable from git history. Returns not-found if the path does not exist. To remove only part of a memory, use memory__edit.',
+        annotations: {
+            readOnlyHint: false,
+            destructiveHint: true,
+            idempotentHint: false,
+            openWorldHint: false,
+        },
+        input: deleteInput,
+        output: deleteOutput,
+    },
+];
+//# sourceMappingURL=memory-tools.schema.js.map

package/dist/server/memory-tools.schema.js.map

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

package/dist/server/register-tools.d.ts

@@ -0,0 +1,7 @@
+import type { McpServer } from '@modelcontextprotocol/sdk/server/mcp.js';
+import { type Router } from '@agentage/memory-core';
+export interface RegisterOptions {
+    readOnly?: boolean;
+}
+export declare const registerTools: (server: McpServer, router: Router, opts?: RegisterOptions) => void;
+//# sourceMappingURL=register-tools.d.ts.map

package/dist/server/register-tools.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"register-tools.d.ts","sourceRoot":"","sources":["../../src/server/register-tools.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AAEzE,OAAO,EAIL,KAAK,MAAM,EAGZ,MAAM,uBAAuB,CAAC;AA+C/B,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAKD,eAAO,MAAM,aAAa,GACxB,QAAQ,SAAS,EACjB,QAAQ,MAAM,EACd,OAAM,eAAoB,KACzB,IAqEF,CAAC"}

package/dist/server/register-tools.js

@@ -0,0 +1,90 @@
+import { UnknownVaultError, } from '@agentage/memory-core';
+import { MEMORY_TOOLS } from './memory-tools.schema.js';
+import { renderDelete, renderEdit, renderList, renderRead, renderSearch, renderWrite, } from './render-markdown.js';
+const byName = new Map(MEMORY_TOOLS.map((t) => [t.name, t]));
+const toolConfig = (name) => {
+    const def = byName.get(name);
+    if (!def)
+        throw new Error(`unknown tool: ${name}`);
+    return {
+        title: def.title,
+        description: def.description,
+        inputSchema: def.input,
+        outputSchema: def.output,
+        annotations: def.annotations,
+    };
+};
+const ok = (data, text) => ({
+    content: [{ type: 'text', text }],
+    structuredContent: data,
+});
+const isError = (text) => ({
+    content: [{ type: 'text', text }],
+    isError: true,
+});
+const notFound = (path, hint = 'Use memory__search to find the right path, or memory__list to browse.') => isError(`No memory at path "${path}". ${hint}`);
+// Map an UnknownVaultError to a tool error; let other throws propagate to the SDK.
+const guard = async (fn) => {
+    try {
+        return await fn();
+    }
+    catch (e) {
+        if (e instanceof UnknownVaultError)
+            return isError(e.message);
+        throw e;
+    }
+};
+// Register the frozen 6-tool surface onto the federated router. write/edit return
+// {path,updated} (the commit SHA is internal, stripped); errors surface as isError.
+// With readOnly, only search/read/list are registered.
+export const registerTools = (server, router, opts = {}) => {
+    server.registerTool('memory__search', toolConfig('memory__search'), (args) => guard(async () => {
+        const query = args;
+        const result = await router.search(query);
+        return ok(result, renderSearch(query, result));
+    }));
+    server.registerTool('memory__read', toolConfig('memory__read'), (args) => guard(async () => {
+        const { path } = args;
+        const view = await router.read(path);
+        return view ? ok(view, renderRead(view)) : notFound(path);
+    }));
+    server.registerTool('memory__list', toolConfig('memory__list'), (args) => guard(async () => {
+        const query = args;
+        const result = await router.list(query);
+        return ok(result, renderList(query, result));
+    }));
+    if (opts.readOnly)
+        return;
+    server.registerTool('memory__write', toolConfig('memory__write'), (args) => guard(async () => {
+        const input = args;
+        const r = await router.write(input);
+        const view = { path: r.path, updated: r.updated };
+        return ok(view, renderWrite(view));
+    }));
+    server.registerTool('memory__edit', toolConfig('memory__edit'), (args) => guard(async () => {
+        const input = args;
+        if (input.mode === 'str_replace') {
+            if (!input.old_str)
+                return isError('mode=str_replace needs old_str: the exact body text to replace. Add new_str for the replacement, or omit it to delete old_str.');
+            if (input.body !== undefined)
+                return isError('mode=str_replace edits in place via old_str/new_str - do not send body. Use mode=replace to overwrite the whole body.');
+        }
+        else if (input.old_str !== undefined || input.new_str !== undefined) {
+            return isError('old_str/new_str work only with mode="str_replace".');
+        }
+        else if (input.body === undefined && input.frontmatter === undefined) {
+            return isError('memory__edit needs a change: provide body (with mode) and/or frontmatter. To create a new memory, use memory__write.');
+        }
+        const r = await router.edit({ ...input, mode: input.mode ?? 'replace' });
+        if (!r)
+            return notFound(input.path, 'Use memory__write to create it.');
+        const view = { path: r.path, updated: r.updated };
+        return ok(view, renderEdit(view));
+    }));
+    server.registerTool('memory__delete', toolConfig('memory__delete'), (args) => guard(async () => {
+        const { path } = args;
+        const deleted = await router.delete(path);
+        return deleted ? ok({ path, deleted: true }, renderDelete(path)) : notFound(path);
+    }));
+};
+//# sourceMappingURL=register-tools.js.map

package/dist/server/register-tools.js.map

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

package/dist/server/render-markdown.d.ts

@@ -0,0 +1,8 @@
+import { type ListQuery, type ListResult, type MemoryView, type SearchQuery, type SearchResult, type WriteResult } from '@agentage/memory-core';
+export declare const renderSearch: (q: SearchQuery, result: SearchResult) => string;
+export declare const renderList: (q: ListQuery, result: ListResult) => string;
+export declare const renderRead: (view: MemoryView) => string;
+export declare const renderWrite: (r: Pick<WriteResult, "path" | "updated">) => string;
+export declare const renderEdit: (r: Pick<WriteResult, "path" | "updated">) => string;
+export declare const renderDelete: (path: string) => string;
+//# sourceMappingURL=render-markdown.d.ts.map

package/dist/server/render-markdown.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"render-markdown.d.ts","sourceRoot":"","sources":["../../src/server/render-markdown.ts"],"names":[],"mappings":"AAGA,OAAO,EAEL,KAAK,SAAS,EACd,KAAK,UAAU,EACf,KAAK,UAAU,EACf,KAAK,WAAW,EAChB,KAAK,YAAY,EAGjB,KAAK,WAAW,EACjB,MAAM,uBAAuB,CAAC;AAmB/B,eAAO,MAAM,YAAY,GAAI,GAAG,WAAW,EAAE,QAAQ,YAAY,KAAG,MAOnE,CAAC;AAIF,eAAO,MAAM,UAAU,GAAI,GAAG,SAAS,EAAE,QAAQ,UAAU,KAAG,MAqC7D,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,MAAM,UAAU,KAAG,MAGzC,CAAC;AAEN,eAAO,MAAM,WAAW,GAAI,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,KAAG,MACgC,CAAC;AAExG,eAAO,MAAM,UAAU,GAAI,GAAG,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,SAAS,CAAC,KAAG,MACtB,CAAC;AAEjD,eAAO,MAAM,YAAY,GAAI,MAAM,MAAM,KAAG,MAC2D,CAAC"}

package/dist/server/render-markdown.js

@@ -0,0 +1,56 @@
+// The model reads content[].text; we render lean per-tool markdown there (never a
+// JSON dump) while structuredContent carries the typed object.
+import { serializeDoc, } from '@agentage/memory-core';
+const UNSAFE_RANGES = [
+    [0x200b, 0x200d],
+    [0xfeff, 0xfeff],
+    [0x202a, 0x202e],
+    [0x2066, 0x2069],
+];
+const hex = (n) => `\\u${n.toString(16).padStart(4, '0')}`;
+const UNSAFE_CHARS = new RegExp(`[${UNSAFE_RANGES.map(([a, b]) => `${hex(a)}-${hex(b)}`).join('')}]`, 'g');
+const sanitize = (s) => s.replace(/<!--[\s\S]*?-->/g, '').replace(UNSAFE_CHARS, '');
+const moreLine = (tool, cursor) => cursor ? `\n\nMore: call ${tool} again with cursor \`${cursor}\`` : '';
+export const renderSearch = (q, result) => {
+    if (!result.results.length)
+        return `No memories matched "${sanitize(q.query)}".`;
+    const rows = result.results.map((h, i) => `${i + 1}. **${sanitize(h.title)}** — \`${h.path}\` · score ${h.score} · updated ${h.updated}\n   ${sanitize(h.snippet)}`);
+    return `Found ${result.results.length} memories for "${sanitize(q.query)}":\n\n${rows.join('\n')}${moreLine('memory__search', result.nextCursor)}`;
+};
+const count = (n, one, many) => `${n} ${n === 1 ? one : many}`;
+export const renderList = (q, result) => {
+    const scope = [
+        q.tags?.length ? ` tagged \`${q.tags.join(', ')}\`` : '',
+        q.folder ? ` under \`${q.folder}\`` : '',
+    ].join('');
+    if (!result.entries.length)
+        return `No memories${scope || ' in this memory'}.`;
+    const name = (path) => path.slice(path.lastIndexOf('/') + 1);
+    const fileLine = (f) => `- ${name(f.path)} · ${f.updated.slice(0, 10)}`;
+    const stubLine = (f) => `- ${name(f.path)}/ · ${count(f.files, 'file', 'files')} (${f.truncated ? 'too many entries to expand' : 'not expanded'} - list \`${f.path}\`)`;
+    const loose = [];
+    const sections = [];
+    for (const e of result.entries) {
+        if (e.type === 'file')
+            loose.push(fileLine(e));
+        else if (!e.entries)
+            loose.push(stubLine(e));
+        else
+            sections.push([
+                `**${e.path}/** · ${count(e.files, 'file', 'files')}`,
+                ...e.entries.map((c) => (c.type === 'file' ? fileLine(c) : stubLine(c))),
+            ].join('\n'));
+    }
+    const folders = result.entries.filter((e) => e.type === 'folder').length;
+    const head = `${count(result.files, 'memory', 'memories')}${scope}${folders ? ` · ${count(folders, 'folder', 'folders')}` : ''}`;
+    const blocks = [loose.join('\n'), ...sections].filter(Boolean);
+    const note = result.truncated
+        ? '\n\nSome entries were omitted (per-folder limit): list a subfolder directly or use memory__search.'
+        : '';
+    return `${head}\n\n${blocks.join('\n\n')}${note}`;
+};
+export const renderRead = (view) => `${view.deleted ? '(soft-deleted - recoverable)\n\n' : ''}${sanitize(serializeDoc(view.frontmatter, view.body))}`;
+export const renderWrite = (r) => `Wrote \`${r.path}\` (updated ${r.updated}). To change part of it, call memory__edit with this path.`;
+export const renderEdit = (r) => `Edited \`${r.path}\` (updated ${r.updated}).`;
+export const renderDelete = (path) => `Deleted \`${path}\` (soft-delete, recoverable). Recreate with memory__write if this was unintended.`;
+//# sourceMappingURL=render-markdown.js.map

package/dist/server/render-markdown.js.map

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

package/package.json

@@ -0,0 +1,60 @@
+{
+  "name": "@agentage/server-memory",
+  "version": "0.0.2",
+  "description": "The agentage Memory MCP server: exposes your local vaults as the frozen 6 memory__* tools over stdio. The open, cross-vendor counterpart to @modelcontextprotocol/server-memory.",
+  "type": "module",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/agentage/server-memory.git"
+  },
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": "./dist/index.js"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "bin": {
+    "agentage-server-memory": "dist/bin/server-memory.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "engines": {
+    "node": ">=22.0.0",
+    "npm": ">=10.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "type-check": "tsc --noEmit",
+    "lint": "eslint src test",
+    "lint:fix": "eslint src test --fix",
+    "format": "prettier --write \"{src,test}/**/*.ts\"",
+    "format:check": "prettier --check \"{src,test}/**/*.ts\"",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "test:coverage": "vitest run --coverage",
+    "clean": "rm -rf dist *.tsbuildinfo coverage",
+    "verify": "npm run type-check && npm run lint && npm run format:check && npm run test && npm run build",
+    "prepublishOnly": "npm run verify"
+  },
+  "dependencies": {
+    "@agentage/memory-core": "^0.1.0",
+    "@modelcontextprotocol/sdk": "^1.29.0",
+    "zod": "^4.4.3"
+  },
+  "devDependencies": {
+    "@types/node": "^22.10.0",
+    "@typescript-eslint/eslint-plugin": "^8.18.0",
+    "@typescript-eslint/parser": "^8.18.0",
+    "@vitest/coverage-v8": "^2.1.8",
+    "eslint": "^9.17.0",
+    "eslint-config-prettier": "^9.1.0",
+    "eslint-plugin-prettier": "^5.2.1",
+    "prettier": "^3.4.2",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}