@agentage/server-memory 0.7.0 → 0.9.0

package/README.md

@@ -32,6 +32,22 @@ import { createMemoryServer, loadLocalServer } from '@agentage/server-memory';
 //                   await server.connect(new StreamableHTTPServerTransport(...));
 ```
 
+## Telemetry (optional, off by default)
+
+Nothing is collected and nothing extra is installed: `@agentage/observability` is **not** a
+dependency, because `npx @agentage/server-memory` should stay a small cold start. Install the kit
+alongside and the bin picks it up on its own - traces and one wide event per tool call:
+
+```bash
+npm i -g @agentage/observability   # or just use the agentage CLI, which ships with it
+```
+
+Absent, the server behaves exactly as before (`AGENTAGE_DEBUG=1` prints one stderr line saying the
+kit was not found). Present, it is still inert until `OTEL_EXPORTER_OTLP_ENDPOINT` names a
+collector; `OTEL_SERVICE_NAME` defaults to `agentage-server-memory`. Either way **stdout carries
+only JSON-RPC** - every kit line goes to stderr, which `test/observability.test.ts` asserts in both
+directions.
+
 ## Develop
 
 ```bash

package/dist/bin/server-memory.js

@@ -6,16 +6,45 @@
 // 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 reason = (err) => (err instanceof Error ? err.message : String(err));
+// Optional observability. @agentage/observability is deliberately NOT a dependency: this package is
+// run through `npx`, and the kit would triple a cold start's install. Installed alongside (global,
+// or via the agentage CLI) its bootstrap adds tool spans, wide events and crash capture; absent, it
+// is a silent skip. Either way stdout stays the JSON-RPC wire - the kit logs to stderr only, and
+// stays inert until OTEL_EXPORTER_OTLP_ENDPOINT names a collector.
+const startObservability = async () => {
+    // The kit (1.0.0) announces an enabled tracer with one console.log, which on this process would
+    // land mid-handshake on the JSON-RPC wire. Divert stdout to stderr while it boots; drop this once
+    // the kit writes that line to stderr itself.
+    const stdoutWrite = process.stdout.write;
+    process.stdout.write = process.stderr.write.bind(process.stderr);
+    try {
+        if (!process.env.OTEL_SERVICE_NAME)
+            process.env.OTEL_SERVICE_NAME = 'agentage-server-memory';
+        await import('@agentage/observability/bootstrap');
+    }
+    catch (err) {
+        if (process.env.AGENTAGE_DEBUG) {
+            process.stderr.write(`[server-memory] observability off: ${reason(err)}\n`);
+        }
+    }
+    finally {
+        process.stdout.write = stdoutWrite;
+    }
+};
+// Loaded behind the bootstrap, not at the top: the kit instruments MCP tool registration through
+// module hooks, which only see a module imported after they are registered.
+await startObservability();
+const { StdioServerTransport } = await import('@modelcontextprotocol/sdk/server/stdio.js');
+const { loadLocalServer } = await import('../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.stderr.write(`[server-memory] fatal: ${reason(err)}\n`);
     process.exit(1);
 });
+export {};
 //# sourceMappingURL=server-memory.js.map

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

@@ -1 +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"}
+{"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,MAAM,MAAM,GAAG,CAAC,GAAY,EAAU,EAAE,CAAC,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC;AAE5F,oGAAoG;AACpG,mGAAmG;AACnG,oGAAoG;AACpG,iGAAiG;AACjG,mEAAmE;AACnE,MAAM,kBAAkB,GAAG,KAAK,IAAmB,EAAE;IACnD,gGAAgG;IAChG,kGAAkG;IAClG,6CAA6C;IAC7C,MAAM,WAAW,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC;IACzC,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAgC,CAAC;IAChG,IAAI,CAAC;QACH,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,iBAAiB;YAAE,OAAO,CAAC,GAAG,CAAC,iBAAiB,GAAG,wBAAwB,CAAC;QAC7F,MAAM,MAAM,CAAC,mCAAmC,CAAC,CAAC;IACpD,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,IAAI,OAAO,CAAC,GAAG,CAAC,cAAc,EAAE,CAAC;YAC/B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,sCAAsC,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;QAC9E,CAAC;IACH,CAAC;YAAS,CAAC;QACT,OAAO,CAAC,MAAM,CAAC,KAAK,GAAG,WAAW,CAAC;IACrC,CAAC;AACH,CAAC,CAAC;AAEF,iGAAiG;AACjG,4EAA4E;AAC5E,MAAM,kBAAkB,EAAE,CAAC;AAC3B,MAAM,EAAE,oBAAoB,EAAE,GAAG,MAAM,MAAM,CAAC,2CAA2C,CAAC,CAAC;AAC3F,MAAM,EAAE,eAAe,EAAE,GAAG,MAAM,MAAM,CAAC,2BAA2B,CAAC,CAAC;AAEtE,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,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,0BAA0B,MAAM,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAChE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentage/server-memory",
-  "version": "0.7.0",
+  "version": "0.9.0",
   "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",
@@ -46,6 +46,8 @@
     "zod": "^4.4.3"
   },
   "devDependencies": {
+    "@agentage/observability": "^1.2.0",
+    "@opentelemetry/api": "^1.9.1",
     "@types/node": "^26.1.2",
     "@typescript-eslint/eslint-plugin": "^8.18.0",
     "@typescript-eslint/parser": "^8.18.0",