@hasna/mementos 0.14.30 → 0.14.32

package/dist/mcp-runtime.d.ts

@@ -1,24 +0,0 @@
-import { MementosRemoteClient } from "./remote-client";
-export declare const MEMENTOS_MCP_VERSION = "0.14.30";
-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

@@ -1 +0,0 @@
-{"version":3,"file":"mcp-runtime.d.ts","sourceRoot":"","sources":["../src/mcp-runtime.ts"],"names":[],"mappings":"AACA,OAAO,EAA6B,oBAAoB,EAAE,MAAM,iBAAiB,CAAC;AAElF,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,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,EAiI3C,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

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

package/dist/mcp.d.ts.map

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

package/dist/mcp.js

@@ -1,354 +0,0 @@
-#!/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 });
-  }
-  sendInboxMessage(input) {
-    return this.request("/inbox", { method: "POST", body: input });
-  }
-  listInboxMessages(input = {}) {
-    return this.request("/inbox", { query: input });
-  }
-  claimInboxMessage(id, input = {}) {
-    return this.request(`/inbox/${encodeURIComponent(id)}/claim`, { 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");
-  }
-  listCreditPacks() {
-    return this.request("/billing/credits");
-  }
-  buyCredits(input) {
-    return this.request("/billing/credits", { method: "POST", body: input });
-  }
-  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 MEMENTOS_MCP_VERSION = "0.14.30";
-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: "inbox.send",
-    description: "Send a hosted mementos.md inbox message to an agent.",
-    inputSchema: OPEN_SCHEMA,
-    run: (input, client) => client.sendInboxMessage(input)
-  },
-  {
-    name: "inbox.list",
-    description: "List hosted mementos.md inbox messages for an agent.",
-    inputSchema: OPEN_SCHEMA,
-    run: (input, client) => client.listInboxMessages(input)
-  },
-  {
-    name: "inbox.claim",
-    description: "Claim and mark a hosted mementos.md inbox message delivered.",
-    inputSchema: OPEN_SCHEMA,
-    run: (input, client) => {
-      const { id, ...body } = input;
-      return client.claimInboxMessage(requiredText(id, "inbox message id is required"), body);
-    }
-  },
-  {
-    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()
-  },
-  {
-    name: "billing.credits",
-    description: "List hosted mementos.md credit packs.",
-    inputSchema: AUTHLESS_SCHEMA,
-    run: (_input, client) => client.listCreditPacks()
-  },
-  {
-    name: "billing.buy",
-    description: "Create a hosted mementos.md credit checkout session.",
-    inputSchema: OPEN_SCHEMA,
-    run: (input, client) => {
-      const credits = Number(input.credits);
-      if (!Number.isInteger(credits) || credits < 1)
-        throw new Error("credits must be a positive integer");
-      return client.buyCredits({ credits });
-    }
-  }
-];
-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: MEMENTOS_MCP_VERSION },
-        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

@@ -1,49 +0,0 @@
-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>;
-    sendInboxMessage(input: Record<string, unknown>): Promise<unknown>;
-    listInboxMessages(input?: Record<string, unknown>): Promise<unknown>;
-    claimInboxMessage(id: string, 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>;
-    listCreditPacks(): Promise<unknown>;
-    buyCredits(input: Record<string, unknown>): 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

@@ -1 +0,0 @@
-{"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,gBAAgB,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAI/C,iBAAiB,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAIrD,iBAAiB,CAAC,EAAE,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAIjE,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;IAIb,eAAe;IAIf,UAAU,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC;IAInC,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"}