@hasna/mementos 0.14.21 → 0.14.22

package/dist/mcp-runtime.d.ts

@@ -0,0 +1,23 @@
+import { MementosRemoteClient } from "./remote-client";
+export interface RemoteMcpTool {
+    name: string;
+    description: string;
+    inputSchema: Record<string, unknown>;
+    run: (input: Record<string, unknown>, client: MementosRemoteClient) => Promise<unknown>;
+}
+export declare const REMOTE_MCP_TOOLS: RemoteMcpTool[];
+export declare function callRemoteMcpTool(name: string, input?: Record<string, unknown>, client?: MementosRemoteClient): Promise<unknown>;
+export declare function handleMcpMessage(message: any, client?: MementosRemoteClient): Promise<{
+    jsonrpc: string;
+    id: unknown;
+    result: unknown;
+} | {
+    jsonrpc: string;
+    id: unknown;
+    error: {
+        code: number;
+        message: string;
+    };
+}>;
+export declare function startMcpStdio(client?: MementosRemoteClient): void;
+//# sourceMappingURL=mcp-runtime.d.ts.map

package/dist/mcp-runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"mcp-runtime.d.ts","sourceRoot":"","sources":["../src/mcp-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAElF,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACrC,GAAG,EAAE,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,MAAM,EAAE,oBAAoB,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;CACzF;AAaD,eAAO,MAAM,gBAAgB,EAAE,aAAa,EA4F3C,CAAC;AAEF,wBAAsB,iBAAiB,CACrC,IAAI,EAAE,MAAM,EACZ,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,EACnC,MAAM,uBAA8B,oBAKrC;AAED,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,GAAG,EAAE,MAAM,uBAA8B;;;;;;;;;;;GA8BxF;AAED,wBAAgB,aAAa,CAAC,MAAM,uBAA8B,QAUjE"}

package/dist/mcp.d.ts

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

package/dist/mcp.d.ts.map

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

package/dist/mcp.js

@@ -0,0 +1,300 @@
+#!/usr/bin/env bun
+// @bun
+
+// src/mcp-runtime.ts
+import { createInterface } from "readline";
+
+// src/remote-client.ts
+var DEFAULT_API_URL = "https://mementos.md/api/v1";
+
+class MementosRemoteError extends Error {
+  status;
+  response;
+  constructor(message, status, response) {
+    super(message);
+    this.name = "MementosRemoteError";
+    this.status = status;
+    this.response = response;
+  }
+}
+
+class MementosRemoteClient {
+  apiUrl;
+  token;
+  fetchImpl;
+  constructor(config = {}) {
+    this.apiUrl = normalizeApiUrl(config.apiUrl ?? DEFAULT_API_URL);
+    this.token = config.token;
+    this.fetchImpl = config.fetch ?? fetch;
+  }
+  listCapabilities() {
+    return this.request("/capabilities", { requiresAuth: false });
+  }
+  listAgents() {
+    return this.request("/agents");
+  }
+  registerAgent(input) {
+    return this.request("/agents/register", { method: "POST", body: input });
+  }
+  heartbeatAgent(input) {
+    return this.request("/agents/heartbeat", { method: "POST", body: input });
+  }
+  saveMemory(input) {
+    return this.request("/memories", { method: "POST", body: input });
+  }
+  searchMemories(input = {}) {
+    return this.request("/memories", { query: input });
+  }
+  injectionContext(input = {}) {
+    return this.request("/injections/context", { method: "POST", body: input });
+  }
+  getMemory(id) {
+    return this.request(`/memories/${encodeURIComponent(id)}`);
+  }
+  updateMemory(id, input) {
+    return this.request(`/memories/${encodeURIComponent(id)}`, { method: "PATCH", body: input });
+  }
+  deleteMemory(id) {
+    return this.request(`/memories/${encodeURIComponent(id)}`, { method: "DELETE" });
+  }
+  memoryUsage() {
+    return this.request("/usage");
+  }
+  listRuns(input = {}) {
+    return this.request("/runs", { query: input });
+  }
+  createRun(slug, input = {}) {
+    return this.request(`/runs/${encodeURIComponent(slug)}`, { method: "POST", body: input });
+  }
+  getRun(id) {
+    return this.request(`/runs/${encodeURIComponent(id)}`);
+  }
+  listApprovals() {
+    return this.request("/approvals");
+  }
+  billingStatus() {
+    return this.request("/billing/status");
+  }
+  async request(path, options = {}) {
+    const method = options.method ?? "GET";
+    const requiresAuth = options.requiresAuth !== false;
+    if (requiresAuth && !this.token) {
+      throw new MementosRemoteError("MEMENTOS_API_TOKEN is required for hosted mementos.md requests", 401, null);
+    }
+    const url = new URL(`${this.apiUrl}${path.startsWith("/") ? path : `/${path}`}`);
+    for (const [key, value] of Object.entries(options.query ?? {})) {
+      if (value === undefined || value === null || value === "")
+        continue;
+      url.searchParams.set(key, String(value));
+    }
+    const headers = new Headers({ accept: "application/json" });
+    if (requiresAuth)
+      headers.set("authorization", `Bearer ${this.token}`);
+    if (options.body !== undefined)
+      headers.set("content-type", "application/json");
+    const response = await this.fetchImpl(url, {
+      method,
+      headers,
+      body: options.body === undefined ? undefined : JSON.stringify(options.body)
+    });
+    const payload = await readPayload(response);
+    if (!response.ok) {
+      throw new MementosRemoteError(readErrorMessage(payload, response.status), response.status, payload);
+    }
+    return payload;
+  }
+}
+function createRemoteClientFromEnv(env = process.env) {
+  return new MementosRemoteClient({
+    apiUrl: env.MEMENTOS_API_URL,
+    token: env.MEMENTOS_API_TOKEN ?? env.MEMENTOS_PLATFORM_TOKEN ?? env.PLATFORM_API_TOKEN ?? env.APP_API_KEY
+  });
+}
+function normalizeApiUrl(input) {
+  const trimmed = input.trim().replace(/\/+$/, "");
+  if (!trimmed)
+    return DEFAULT_API_URL;
+  return trimmed.endsWith("/api/v1") ? trimmed : `${trimmed}/api/v1`;
+}
+async function readPayload(response) {
+  const text = await response.text();
+  if (!text)
+    return null;
+  try {
+    return JSON.parse(text);
+  } catch {
+    return text;
+  }
+}
+function readErrorMessage(payload, status) {
+  if (typeof payload === "object" && payload !== null && "error" in payload) {
+    const value = payload.error;
+    if (typeof value === "string" && value.trim())
+      return value;
+  }
+  return `mementos.md request failed with status ${status}`;
+}
+
+// src/mcp-runtime.ts
+var AUTHLESS_SCHEMA = {
+  type: "object",
+  properties: {},
+  additionalProperties: false
+};
+var OPEN_SCHEMA = {
+  type: "object",
+  additionalProperties: true
+};
+var REMOTE_MCP_TOOLS = [
+  {
+    name: "capabilities.list",
+    description: "List hosted mementos.md capabilities.",
+    inputSchema: AUTHLESS_SCHEMA,
+    run: (_input, client) => client.listCapabilities()
+  },
+  {
+    name: "agent.register",
+    description: "Register a hosted mementos.md agent.",
+    inputSchema: OPEN_SCHEMA,
+    run: (input, client) => client.registerAgent(input)
+  },
+  {
+    name: "agent.heartbeat",
+    description: "Record a heartbeat for a hosted mementos.md agent.",
+    inputSchema: OPEN_SCHEMA,
+    run: (input, client) => client.heartbeatAgent(input)
+  },
+  {
+    name: "memory.save",
+    description: "Save a hosted mementos.md memory.",
+    inputSchema: OPEN_SCHEMA,
+    run: (input, client) => client.saveMemory(input)
+  },
+  {
+    name: "memory.search",
+    description: "Search hosted mementos.md memories.",
+    inputSchema: OPEN_SCHEMA,
+    run: (input, client) => client.searchMemories(input)
+  },
+  {
+    name: "memory.get",
+    description: "Read a hosted mementos.md memory by id.",
+    inputSchema: OPEN_SCHEMA,
+    run: (input, client) => client.getMemory(requiredText(input.id, "memory id is required"))
+  },
+  {
+    name: "memory.update",
+    description: "Update a hosted mementos.md memory by id.",
+    inputSchema: OPEN_SCHEMA,
+    run: (input, client) => {
+      const { id, ...body } = input;
+      return client.updateMemory(requiredText(id, "memory id is required"), body);
+    }
+  },
+  {
+    name: "memory.delete",
+    description: "Delete a hosted mementos.md memory by id.",
+    inputSchema: OPEN_SCHEMA,
+    run: (input, client) => client.deleteMemory(requiredText(input.id, "memory id is required"))
+  },
+  {
+    name: "memory.usage",
+    description: "Read hosted mementos.md memory usage.",
+    inputSchema: AUTHLESS_SCHEMA,
+    run: (_input, client) => client.memoryUsage()
+  },
+  {
+    name: "runs.create",
+    description: "Queue a hosted mementos.md run.",
+    inputSchema: OPEN_SCHEMA,
+    run: (input, client) => {
+      const slug = requiredText(input.slug, "run slug is required");
+      const body = readObject(input.input) ?? {};
+      return client.createRun(slug, body);
+    }
+  },
+  {
+    name: "brain.fire",
+    description: "Queue hosted mementos.md Cerebras brain workers.",
+    inputSchema: OPEN_SCHEMA,
+    run: (input, client) => client.createRun("brain.fire", input)
+  },
+  {
+    name: "runs.get",
+    description: "Read a hosted mementos.md run by id.",
+    inputSchema: OPEN_SCHEMA,
+    run: (input, client) => client.getRun(requiredText(input.id, "run id is required"))
+  },
+  {
+    name: "approvals.list",
+    description: "List hosted mementos.md approval requests.",
+    inputSchema: AUTHLESS_SCHEMA,
+    run: (_input, client) => client.listApprovals()
+  },
+  {
+    name: "billing.status",
+    description: "Read hosted mementos.md billing status.",
+    inputSchema: AUTHLESS_SCHEMA,
+    run: (_input, client) => client.billingStatus()
+  }
+];
+async function callRemoteMcpTool(name, input = {}, client = createRemoteClientFromEnv()) {
+  const tool = REMOTE_MCP_TOOLS.find((candidate) => candidate.name === name);
+  if (!tool)
+    throw new Error(`Unknown MCP tool: ${name}`);
+  return tool.run(input, client);
+}
+async function handleMcpMessage(message, client = createRemoteClientFromEnv()) {
+  const id = message?.id ?? null;
+  try {
+    if (message?.method === "initialize") {
+      return jsonRpcResult(id, {
+        protocolVersion: "2024-11-05",
+        serverInfo: { name: "mementos", version: "0.14.22" },
+        capabilities: { tools: {} }
+      });
+    }
+    if (message?.method === "tools/list") {
+      return jsonRpcResult(id, {
+        tools: REMOTE_MCP_TOOLS.map(({ run: _run, ...tool }) => tool)
+      });
+    }
+    if (message?.method === "tools/call") {
+      const result = await callRemoteMcpTool(String(message.params?.name ?? ""), readObject(message.params?.arguments) ?? {}, client);
+      return jsonRpcResult(id, { content: [{ type: "json", json: result }] });
+    }
+    return jsonRpcError(id, -32601, `Unknown method: ${String(message?.method ?? "")}`);
+  } catch (error) {
+    return jsonRpcError(id, -32000, error.message);
+  }
+}
+function startMcpStdio(client = createRemoteClientFromEnv()) {
+  const lines = createInterface({ input: process.stdin });
+  lines.on("line", async (line) => {
+    try {
+      const response = await handleMcpMessage(JSON.parse(line), client);
+      process.stdout.write(`${JSON.stringify(response)}
+`);
+    } catch (error) {
+      process.stdout.write(`${JSON.stringify(jsonRpcError(null, -32700, error.message))}
+`);
+    }
+  });
+}
+function jsonRpcResult(id, result) {
+  return { jsonrpc: "2.0", id, result };
+}
+function jsonRpcError(id, code, message) {
+  return { jsonrpc: "2.0", id, error: { code, message } };
+}
+function readObject(input) {
+  return typeof input === "object" && input !== null && !Array.isArray(input) ? input : undefined;
+}
+function requiredText(input, message) {
+  if (typeof input !== "string" || !input.trim())
+    throw new Error(message);
+  return input.trim();
+}
+
+// src/mcp.ts
+startMcpStdio();

package/dist/remote-client.d.ts

@@ -0,0 +1,44 @@
+export declare const DEFAULT_API_URL = "https://mementos.md/api/v1";
+export interface RemoteClientConfig {
+    apiUrl?: string;
+    token?: string;
+    fetch?: FetchLike;
+}
+export interface RemoteRequestOptions {
+    method?: "GET" | "POST" | "PATCH" | "DELETE";
+    body?: unknown;
+    query?: Record<string, unknown>;
+    requiresAuth?: boolean;
+}
+export type FetchLike = (input: URL | RequestInfo, init?: RequestInit) => Promise<Response>;
+export declare class MementosRemoteError extends Error {
+    readonly status: number;
+    readonly response: unknown;
+    constructor(message: string, status: number, response: unknown);
+}
+export declare class MementosRemoteClient {
+    readonly apiUrl: string;
+    private readonly token?;
+    private readonly fetchImpl;
+    constructor(config?: RemoteClientConfig);
+    listCapabilities(): Promise<unknown>;
+    listAgents(): Promise<unknown>;
+    registerAgent(input: Record<string, unknown>): Promise<unknown>;
+    heartbeatAgent(input: Record<string, unknown>): Promise<unknown>;
+    saveMemory(input: Record<string, unknown>): Promise<unknown>;
+    searchMemories(input?: Record<string, unknown>): Promise<unknown>;
+    injectionContext(input?: Record<string, unknown>): Promise<unknown>;
+    getMemory(id: string): Promise<unknown>;
+    updateMemory(id: string, input: Record<string, unknown>): Promise<unknown>;
+    deleteMemory(id: string): Promise<unknown>;
+    memoryUsage(): Promise<unknown>;
+    listRuns(input?: Record<string, unknown>): Promise<unknown>;
+    createRun(slug: string, input?: Record<string, unknown>): Promise<unknown>;
+    getRun(id: string): Promise<unknown>;
+    listApprovals(): Promise<unknown>;
+    billingStatus(): Promise<unknown>;
+    request(path: string, options?: RemoteRequestOptions): Promise<unknown>;
+}
+export declare function createRemoteClientFromEnv(env?: Record<string, string | undefined>): MementosRemoteClient;
+export declare function normalizeApiUrl(input: string): string;
+//# sourceMappingURL=remote-client.d.ts.map

package/dist/remote-client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remote-client.d.ts","sourceRoot":"","sources":["../src/remote-client.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,eAAe,+BAA+B,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,SAAS,CAAC;CACnB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,CAAC,EAAE,KAAK,GAAG,MAAM,GAAG,OAAO,GAAG,QAAQ,CAAC;IAC7C,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAChC,YAAY,CAAC,EAAE,OAAO,CAAC;CACxB;AAED,MAAM,MAAM,SAAS,GAAG,CAAC,KAAK,EAAE,GAAG,GAAG,WAAW,EAAE,IAAI,CAAC,EAAE,WAAW,KAAK,OAAO,CAAC,QAAQ,CAAC,CAAC;AAE5F,qBAAa,mBAAoB,SAAQ,KAAK;IAC5C,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;gBAEf,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO;CAM/D;AAED,qBAAa,oBAAoB;IAC/B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAC,CAAS;IAChC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAY;gBAE1B,MAAM,GAAE,kBAAuB;IAM3C,gBAAgB;IAIhB,UAAU;IAIV,aAAa,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI5C,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI7C,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIzC,cAAc,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAIlD,gBAAgB,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAIpD,SAAS,CAAC,EAAE,EAAE,MAAM;IAIpB,YAAY,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAIvD,YAAY,CAAC,EAAE,EAAE,MAAM;IAIvB,WAAW;IAIX,QAAQ,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAI5C,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAI3D,MAAM,CAAC,EAAE,EAAE,MAAM;IAIjB,aAAa;IAIb,aAAa;IAIP,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,GAAE,oBAAyB;CA4B/D;AAED,wBAAgB,yBAAyB,CAAC,GAAG,GAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAe,GAAG,oBAAoB,CAKrH;AAED,wBAAgB,eAAe,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,CAIrD"}

package/package.json

@@ -1,84 +1,44 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.14.21",
-  "description": "Universal memory system for AI agents - CLI + MCP server + library API",
+  "version": "0.14.22",
+  "description": "Remote-only mementos.md SaaS CLI and MCP client",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "bin": {
-    "mementos": "dist/cli/index.js",
-    "mementos-mcp": "dist/mcp/index.js",
-    "mementos-serve": "dist/server/index.js"
+    "mementos": "dist/cli.js",
+    "mementos-mcp": "dist/mcp.js"
   },
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
-    },
-    "./sdk": {
-      "types": "./dist/sdk/index.d.ts",
-      "import": "./dist/sdk/index.js"
     }
   },
   "files": [
     "dist",
-    "dashboard/dist",
-    "LICENSE",
-    "README.md"
+    "README.md",
+    "LICENSE"
   ],
   "scripts": {
-    "build": "bun build src/cli/index.tsx --outdir dist/cli --target bun --external ink --external react --external chalk --external @modelcontextprotocol/sdk && bun build src/mcp/index.ts --outdir dist/mcp --target bun --external @modelcontextprotocol/sdk && bun build src/server/index.ts --outdir dist/server --target bun && bun build src/index.ts --outdir dist --target bun && bun build src/sdk/index.ts --outdir dist/sdk --target bun",
-    "prepare": "bun run build",
-    "typecheck": "tsc --noEmit",
-    "test": "bun test",
-    "dev:cli": "bun run src/cli/index.tsx",
-    "dev:mcp": "bun run src/mcp/index.ts",
-    "dev:serve": "bun run src/server/index.ts",
-    "postinstall": "mkdir -p $HOME/.hasna/mementos $HOME/.hasna/mementos/profiles $HOME/.hasna/mementos/agents $HOME/.hasna/mementos/training 2>/dev/null || true"
+    "build": "bun build src/index.ts --outfile dist/index.js --target bun && bun build src/cli.ts --outfile dist/cli.js --target bun && bun build src/mcp.ts --outfile dist/mcp.js --target bun && tsc --emitDeclarationOnly -p tsconfig.build.json",
+    "typecheck": "tsc --noEmit -p tsconfig.json",
+    "test": "bun test"
   },
   "keywords": [
-    "memory",
     "mementos",
     "mcp",
-    "ai",
-    "coding-agent",
-    "claude",
-    "codex",
-    "gemini",
-    "cli",
-    "sqlite"
+    "saas",
+    "remote",
+    "agents"
   ],
   "publishConfig": {
     "registry": "https://registry.npmjs.org",
     "access": "public"
   },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/hasna/mementos.git"
-  },
-  "homepage": "https://github.com/hasna/mementos",
-  "bugs": {
-    "url": "https://github.com/hasna/mementos/issues"
-  },
   "engines": {
     "bun": ">=1.0.0"
   },
   "author": "Andrei Hasna <andrei@hasna.com>",
-  "license": "Apache-2.0",
-  "dependencies": {
-    "@hasna/cloud": "^0.1.24",
-    "@modelcontextprotocol/sdk": "^1.12.1",
-    "chalk": "^5.4.1",
-    "commander": "^13.1.0",
-    "ink": "^5.2.0",
-    "pdf-parse": "^1.1.1",
-    "react": "^18.3.1",
-    "tesseract.js": "^5.1.1",
-    "zod": "^3.24.2"
-  },
-  "devDependencies": {
-    "@types/bun": "^1.2.4",
-    "@types/react": "^18.3.18",
-    "typescript": "^5.7.3"
-  }
+  "license": "Apache-2.0"
 }