@hasna/mementos 0.14.26 → 0.14.27

package/dist/cli.js

@@ -543,6 +543,15 @@ class MementosRemoteClient {
   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)}`);
   }
@@ -672,6 +681,8 @@ async function run(name, args) {
       return runHook(args);
     case "billing":
       return runBilling(args);
+    case "inbox":
+      return runInbox(args);
     case "capabilities":
       return client.listCapabilities();
     case "agents":
@@ -693,6 +704,31 @@ async function run(name, args) {
 ${helpText()}`);
   }
 }
+async function runInbox(args) {
+  const subcommand = args[0] ?? "list";
+  switch (subcommand) {
+    case "send": {
+      const agentName = args[1];
+      const message = args.slice(2).join(" ");
+      if (!agentName || !message)
+        throw new Error("usage: mementos inbox send <agentName> <message>");
+      return client.sendInboxMessage({ targetAgentName: agentName, message });
+    }
+    case "list": {
+      const options = parseInboxOptions(args.slice(1));
+      return client.listInboxMessages(options);
+    }
+    case "claim": {
+      const id = args[1];
+      if (!id)
+        throw new Error("usage: mementos inbox claim <id> [--agent <agentName>]");
+      const options = parseInboxOptions(args.slice(2));
+      return client.claimInboxMessage(id, options);
+    }
+    default:
+      throw new Error("usage: mementos inbox <send|list|claim>");
+  }
+}
 async function runBilling(args) {
   const subcommand = args[0] ?? "status";
   switch (subcommand) {
@@ -830,6 +866,28 @@ function parseSetupOptions(args) {
   }
   return options;
 }
+function parseInboxOptions(args) {
+  const options = {};
+  for (let index = 0;index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--agent" || arg === "--agent-name") {
+      options.agentName = args[++index];
+    } else if (arg === "--agent-id") {
+      options.agentId = args[++index];
+    } else if (arg === "--project") {
+      options.projectKey = args[++index];
+    } else if (arg === "--session") {
+      options.sessionId = args[++index];
+    } else if (arg === "--include-delivered") {
+      options.includeDelivered = true;
+    } else if (arg === "--limit") {
+      options.limit = Number(args[++index]);
+    } else {
+      throw new Error(`Unknown inbox option: ${arg}`);
+    }
+  }
+  return options;
+}
 function parseHosts(input) {
   const requested = input.split(",").map((host) => host.trim()).filter(Boolean);
   const unknown = requested.filter((host) => !SUPPORTED_AGENT_HOSTS.includes(host));
@@ -854,6 +912,7 @@ Usage:
   mementos setup agents [--dry-run|--verify|--uninstall]
   mementos inject <query>
   mementos hook <stop|user-prompt-submit|session-start|subagent-start|subagent-stop|pre-tool-use|post-tool-use|notification|setup|doctor>
+  mementos inbox <send|list|claim>
   mementos billing <status|credits|buy>
   mementos capabilities
   mementos agents

package/dist/index.js

@@ -43,6 +43,15 @@ class MementosRemoteClient {
   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)}`);
   }
@@ -137,7 +146,7 @@ function readErrorMessage(payload, status) {
 }
 // src/mcp-runtime.ts
 import { createInterface } from "readline";
-var MEMENTOS_MCP_VERSION = "0.14.26";
+var MEMENTOS_MCP_VERSION = "0.14.27";
 var AUTHLESS_SCHEMA = {
   type: "object",
   properties: {},
@@ -205,6 +214,27 @@ var REMOTE_MCP_TOOLS = [
     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.",

package/dist/mcp-runtime.d.ts

@@ -1,5 +1,5 @@
 import { MementosRemoteClient } from "./remote-client";
-export declare const MEMENTOS_MCP_VERSION = "0.14.26";
+export declare const MEMENTOS_MCP_VERSION = "0.14.27";
 export interface RemoteMcpTool {
     name: string;
     description: string;

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

@@ -1 +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,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,EA4G3C,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"}
+{"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.js

@@ -48,6 +48,15 @@ class MementosRemoteClient {
   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)}`);
   }
@@ -142,7 +151,7 @@ function readErrorMessage(payload, status) {
 }
 
 // src/mcp-runtime.ts
-var MEMENTOS_MCP_VERSION = "0.14.26";
+var MEMENTOS_MCP_VERSION = "0.14.27";
 var AUTHLESS_SCHEMA = {
   type: "object",
   properties: {},
@@ -210,6 +219,27 @@ var REMOTE_MCP_TOOLS = [
     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.",

package/dist/remote-client.d.ts

@@ -28,6 +28,9 @@ export declare class MementosRemoteClient {
     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>;

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

@@ -1 +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;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"}
+{"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@hasna/mementos",
-  "version": "0.14.26",
+  "version": "0.14.27",
   "description": "Remote-only mementos.md SaaS CLI and MCP client",
   "type": "module",
   "main": "dist/index.js",