@hasna/mementos 0.10.11 → 0.10.13

package/dist/lib/remote-sync.d.ts

@@ -0,0 +1,49 @@
+/**
+ * Remote sync — push/pull memories to/from a remote mementos-serve instance.
+ *
+ * The remote must be running `mementos-serve`. Point at it via:
+ *   MEMENTOS_REMOTE_URL=http://apple01:19428
+ * or pass the URL directly to push/pull functions.
+ */
+declare const DEFAULT_PORT = 19428;
+export interface RemoteSyncOptions {
+    remoteUrl?: string;
+    scope?: "global" | "shared" | "private";
+    agentId?: string;
+    projectId?: string;
+    since?: string;
+    limit?: number;
+    overwrite?: boolean;
+}
+export interface RemoteSyncResult {
+    pushed?: number;
+    pulled?: number;
+    errors: string[];
+    remote_url: string;
+}
+/**
+ * Push local memories to a remote mementos-serve instance.
+ * Uses POST /api/memories/import on the remote.
+ */
+export declare function pushToRemote(opts?: RemoteSyncOptions): Promise<RemoteSyncResult>;
+/**
+ * Pull memories from a remote mementos-serve instance into local DB.
+ * Uses POST /api/memories/export on the remote.
+ */
+export declare function pullFromRemote(opts?: RemoteSyncOptions): Promise<RemoteSyncResult>;
+/**
+ * Bidirectional sync: push local then pull remote.
+ * On key conflict, newer timestamp wins.
+ */
+export declare function syncWithRemote(opts?: RemoteSyncOptions): Promise<RemoteSyncResult>;
+/**
+ * Check if a remote mementos-serve is reachable.
+ */
+export declare function pingRemote(url?: string): Promise<{
+    ok: boolean;
+    url: string;
+    status?: number;
+    error?: string;
+}>;
+export { DEFAULT_PORT };
+//# sourceMappingURL=remote-sync.d.ts.map

package/dist/lib/remote-sync.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-sync.d.ts","sourceRoot":"","sources":["../../src/lib/remote-sync.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAKH,QAAA,MAAM,YAAY,QAAQ,CAAC;AAE3B,MAAM,WAAW,iBAAiB;IAChC,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IACxC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,SAAS,CAAC,EAAE,OAAO,CAAC;CACrB;AAED,MAAM,WAAW,gBAAgB;IAC/B,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,MAAM,EAAE,CAAC;IACjB,UAAU,EAAE,MAAM,CAAC;CACpB;AAqBD;;;GAGG;AACH,wBAAsB,YAAY,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CA4B1F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAyB5F;AAED;;;GAGG;AACH,wBAAsB,cAAc,CAAC,IAAI,GAAE,iBAAsB,GAAG,OAAO,CAAC,gBAAgB,CAAC,CAU5F;AAED;;GAEG;AACH,wBAAsB,UAAU,CAAC,GAAG,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC;IAAE,EAAE,EAAE,OAAO,CAAC;IAAC,GAAG,EAAE,MAAM,CAAC;IAAC,MAAM,CAAC,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,MAAM,CAAA;CAAE,CAAC,CAUrH;AAED,OAAO,EAAE,YAAY,EAAE,CAAC"}

package/dist/mcp/index.js

@@ -3461,6 +3461,104 @@ var init_memory_broadcast = __esm(() => {
   CONVERSATIONS_API = process.env.CONVERSATIONS_API_URL || "http://localhost:7020";
 });
 
+// src/lib/remote-sync.ts
+var exports_remote_sync = {};
+__export(exports_remote_sync, {
+  syncWithRemote: () => syncWithRemote,
+  pushToRemote: () => pushToRemote,
+  pullFromRemote: () => pullFromRemote,
+  pingRemote: () => pingRemote,
+  DEFAULT_PORT: () => DEFAULT_PORT
+});
+function resolveUrl(url) {
+  const raw = url ?? process.env["MEMENTOS_REMOTE_URL"] ?? "";
+  if (!raw)
+    throw new Error("No remote URL. Set MEMENTOS_REMOTE_URL or pass url.");
+  return raw.replace(/\/$/, "");
+}
+async function fetchJson(url, init) {
+  const res = await fetch(url, {
+    ...init,
+    headers: { "Content-Type": "application/json", ...init?.headers },
+    signal: AbortSignal.timeout(15000)
+  });
+  if (!res.ok) {
+    const text = await res.text().catch(() => "");
+    throw new Error(`Remote ${res.status}: ${text.slice(0, 200)}`);
+  }
+  return res.json();
+}
+async function pushToRemote(opts = {}) {
+  const baseUrl = resolveUrl(opts.remoteUrl);
+  const errors2 = [];
+  const memories = listMemories({
+    scope: opts.scope,
+    agent_id: opts.agentId,
+    project_id: opts.projectId,
+    limit: opts.limit ?? 1e4
+  });
+  if (!memories.length) {
+    return { pushed: 0, errors: [], remote_url: baseUrl };
+  }
+  const result = await fetchJson(`${baseUrl}/api/memories/import`, {
+    method: "POST",
+    body: JSON.stringify({ memories, overwrite: opts.overwrite ?? true })
+  });
+  return {
+    pushed: result.imported,
+    errors: [...errors2, ...result.errors],
+    remote_url: baseUrl
+  };
+}
+async function pullFromRemote(opts = {}) {
+  const baseUrl = resolveUrl(opts.remoteUrl);
+  const errors2 = [];
+  const filter = { limit: opts.limit ?? 1e4 };
+  if (opts.scope)
+    filter.scope = opts.scope;
+  if (opts.agentId)
+    filter.agent_id = opts.agentId;
+  if (opts.projectId)
+    filter.project_id = opts.projectId;
+  const result = await fetchJson(`${baseUrl}/api/memories/export`, { method: "POST", body: JSON.stringify(filter) });
+  let pulled = 0;
+  for (const mem of result.memories) {
+    try {
+      createMemory(mem, opts.overwrite !== false ? "merge" : "create");
+      pulled++;
+    } catch (e) {
+      errors2.push(`Failed to import "${mem.key}": ${e instanceof Error ? e.message : String(e)}`);
+    }
+  }
+  return { pulled, errors: errors2, remote_url: baseUrl };
+}
+async function syncWithRemote(opts = {}) {
+  const baseUrl = resolveUrl(opts.remoteUrl);
+  const pushResult = await pushToRemote({ ...opts, remoteUrl: baseUrl });
+  const pullResult = await pullFromRemote({ ...opts, remoteUrl: baseUrl, overwrite: false });
+  return {
+    pushed: pushResult.pushed,
+    pulled: pullResult.pulled,
+    errors: [...pushResult.errors, ...pullResult.errors],
+    remote_url: baseUrl
+  };
+}
+async function pingRemote(url) {
+  const baseUrl = resolveUrl(url);
+  try {
+    const res = await fetch(`${baseUrl}/api/health`, {
+      signal: AbortSignal.timeout(5000)
+    });
+    return { ok: res.ok, url: baseUrl, status: res.status };
+  } catch (e) {
+    return { ok: false, url: baseUrl, error: e instanceof Error ? e.message : String(e) };
+  }
+}
+var DEFAULT_PORT = 19428;
+var init_remote_sync = __esm(() => {
+  init_memories();
+});
+
 // src/mcp/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -9733,6 +9831,48 @@ ${lines.join(`
     return { content: [{ type: "text", text: formatError(e) }], isError: true };
   }
 });
+server.tool("memory_sync_push", "Push local memories to a remote mementos-serve instance. Set MEMENTOS_REMOTE_URL or pass url.", {
+  url: exports_external.string().optional().describe("Remote URL (e.g. http://apple01:19428). Defaults to MEMENTOS_REMOTE_URL env var."),
+  scope: exports_external.enum(["global", "shared", "private"]).optional(),
+  agent_id: exports_external.string().optional(),
+  project_id: exports_external.string().optional(),
+  limit: exports_external.coerce.number().optional()
+}, async (args) => {
+  try {
+    const { pushToRemote: pushToRemote2 } = await Promise.resolve().then(() => (init_remote_sync(), exports_remote_sync));
+    const result = await pushToRemote2({ remoteUrl: args.url, scope: args.scope, agentId: args.agent_id, projectId: args.project_id, limit: args.limit });
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
+server.tool("memory_sync_pull", "Pull memories from a remote mementos-serve instance into local DB. Set MEMENTOS_REMOTE_URL or pass url.", {
+  url: exports_external.string().optional().describe("Remote URL. Defaults to MEMENTOS_REMOTE_URL env var."),
+  scope: exports_external.enum(["global", "shared", "private"]).optional(),
+  agent_id: exports_external.string().optional(),
+  project_id: exports_external.string().optional(),
+  limit: exports_external.coerce.number().optional(),
+  overwrite: exports_external.coerce.boolean().optional().describe("Overwrite existing memories with same key (default: false = keep newer)")
+}, async (args) => {
+  try {
+    const { pullFromRemote: pullFromRemote2 } = await Promise.resolve().then(() => (init_remote_sync(), exports_remote_sync));
+    const result = await pullFromRemote2({ remoteUrl: args.url, scope: args.scope, agentId: args.agent_id, projectId: args.project_id, limit: args.limit, overwrite: args.overwrite });
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
+server.tool("memory_sync_status", "Check if a remote mementos-serve is reachable. Set MEMENTOS_REMOTE_URL or pass url.", {
+  url: exports_external.string().optional().describe("Remote URL. Defaults to MEMENTOS_REMOTE_URL env var.")
+}, async (args) => {
+  try {
+    const { pingRemote: pingRemote2 } = await Promise.resolve().then(() => (init_remote_sync(), exports_remote_sync));
+    const result = await pingRemote2(args.url);
+    return { content: [{ type: "text", text: JSON.stringify(result) }] };
+  } catch (e) {
+    return { content: [{ type: "text", text: formatError(e) }], isError: true };
+  }
+});
 server.tool("memory_stats", "Get aggregate statistics about stored memories", {}, async () => {
   try {
     const db = getDatabase();
@@ -10464,6 +10604,9 @@ server.tool("memory_context", "Get memories relevant to current context, filtere
     if (memories.length === 0) {
       return { content: [{ type: "text", text: "No memories in current context." }] };
     }
+    for (const m of memories) {
+      touchMemory(m.id);
+    }
     const lines = memories.map((m) => `[${m.scope}/${m.category}] ${m.key}: ${m.value} (importance: ${m.importance})`);
     return { content: [{ type: "text", text: lines.join(`
 `) }] };

package/dist/server/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AA6gDH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkI9C"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/server/index.ts"],"names":[],"mappings":";AACA;;;GAGG;AAihDH,wBAAgB,WAAW,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAkI9C"}

package/dist/server/index.js

@@ -5296,6 +5296,9 @@ function matchRoute(method, pathname) {
   }
   return null;
 }
+addRoute("GET", "/api/health", () => {
+  return json({ ok: true, version: "1", db: getDbPath2() });
+});
 addRoute("GET", "/api/memories", (_req, url) => {
   const q = getSearchParams(url);
   const filter = {};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.10.11",
+  "version": "0.10.13",
   "description": "Universal memory system for AI agents - CLI + MCP server + library API",
   "type": "module",
   "main": "dist/index.js",