@hasna/mementos 0.14.25 → 0.14.27

package/dist/agent-setup.d.ts

@@ -24,7 +24,24 @@ export interface AgentSetupPlan {
     hosts: SupportedAgentHost[];
     mcpCommand: string;
 }
+export interface AgentSetupDiagnostic {
+    apiUrl: string;
+    hostResults: AgentSetupHostResult[];
+    localDatabaseFiles: string[];
+    localStorage: {
+        path: string;
+        status: "absent" | "present";
+    };
+    ok: boolean;
+    remoteOnly: true;
+    tokenConfigured: boolean;
+    tokenSource?: string;
+}
+export interface AgentSetupDiagnosticOptions extends AgentSetupOptions {
+    env?: Record<string, string | undefined>;
+}
 export declare function buildAgentSetupPlan(options?: AgentSetupOptions): AgentSetupPlan;
+export declare function diagnoseAgentSetup(options?: AgentSetupDiagnosticOptions): AgentSetupDiagnostic;
 export declare function installAgentSetup(options?: AgentSetupOptions): AgentSetupPlan;
 export declare function renderSignupInstructions(apiUrl?: string): {
     signupUrl: string;

package/dist/agent-setup.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"agent-setup.d.ts","sourceRoot":"","sources":["../src/agent-setup.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,8DAA+D,CAAC;AAElG,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CAChF;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CA0CnF;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAqCjF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,SAAwB;;;EAStE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAW9D"}
+{"version":3,"file":"agent-setup.d.ts","sourceRoot":"","sources":["../src/agent-setup.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,qBAAqB,8DAA+D,CAAC;AAElG,MAAM,MAAM,kBAAkB,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAExE,MAAM,WAAW,iBAAiB;IAChC,MAAM,CAAC,EAAE,SAAS,GAAG,QAAQ,GAAG,WAAW,CAAC;IAC5C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,KAAK,CAAC,EAAE,kBAAkB,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,cAAc;IAC7B,UAAU,CAAC,EAAE,OAAO,CAAC;IACrB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,kBAAkB,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,MAAM,EAAE,SAAS,GAAG,WAAW,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,CAAC;CAChF;AAED,MAAM,WAAW,cAAc;IAC7B,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,cAAc,EAAE,CAAC;IACxB,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,KAAK,EAAE,kBAAkB,EAAE,CAAC;IAC5B,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,MAAM,CAAC;IACf,WAAW,EAAE,oBAAoB,EAAE,CAAC;IACpC,kBAAkB,EAAE,MAAM,EAAE,CAAC;IAC7B,YAAY,EAAE;QACZ,IAAI,EAAE,MAAM,CAAC;QACb,MAAM,EAAE,QAAQ,GAAG,SAAS,CAAC;KAC9B,CAAC;IACF,EAAE,EAAE,OAAO,CAAC;IACZ,UAAU,EAAE,IAAI,CAAC;IACjB,eAAe,EAAE,OAAO,CAAC;IACzB,WAAW,CAAC,EAAE,MAAM,CAAC;CACtB;AAED,MAAM,WAAW,2BAA4B,SAAQ,iBAAiB;IACpE,GAAG,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC1C;AAED,wBAAgB,mBAAmB,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CA0CnF;AAED,wBAAgB,kBAAkB,CAAC,OAAO,GAAE,2BAAgC,GAAG,oBAAoB,CAyBlG;AAED,wBAAgB,iBAAiB,CAAC,OAAO,GAAE,iBAAsB,GAAG,cAAc,CAqCjF;AAED,wBAAgB,wBAAwB,CAAC,MAAM,SAAwB;;;EAStE;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,MAAM,CAW9D"}

package/dist/cli.js

@@ -2,7 +2,7 @@
 // @bun
 
 // src/agent-setup.ts
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { dirname, join } from "path";
 var SUPPORTED_AGENT_HOSTS = ["claude-code", "codex", "opencode", "antigravity"];
@@ -50,6 +50,30 @@ function buildAgentSetupPlan(options = {}) {
     mcpCommand
   };
 }
+function diagnoseAgentSetup(options = {}) {
+  const plan = installAgentSetup({ ...options, action: "verify" });
+  const home = options.homeDir ?? homedir();
+  const localStoragePath = join(home, ".hasna", "mementos");
+  const localDatabaseFiles = [
+    ...findLocalDatabaseFiles(localStoragePath),
+    ...findLocalDatabaseFiles(join(home, ".config", "mementos"))
+  ];
+  const env = options.env ?? process.env;
+  const tokenSource = ["MEMENTOS_API_TOKEN", "MEMENTOS_PLATFORM_TOKEN", "PLATFORM_API_TOKEN", "APP_API_KEY"].find((key) => Boolean(env[key]));
+  return {
+    apiUrl: options.apiUrl ?? "https://mementos.md",
+    hostResults: plan.hostResults,
+    localDatabaseFiles,
+    localStorage: {
+      path: localStoragePath,
+      status: existsSync(localStoragePath) ? "present" : "absent"
+    },
+    ok: plan.hostResults.every((result) => result.status === "present") && !existsSync(localStoragePath) && localDatabaseFiles.length === 0,
+    remoteOnly: true,
+    tokenConfigured: Boolean(tokenSource),
+    ...tokenSource ? { tokenSource } : {}
+  };
+}
 function installAgentSetup(options = {}) {
   const plan = buildAgentSetupPlan(options);
   if (options.action === "verify") {
@@ -459,6 +483,21 @@ function readMemoryRows(payload) {
 function readText(input) {
   return typeof input === "string" && input.trim() ? input.trim() : undefined;
 }
+function findLocalDatabaseFiles(dir) {
+  const localDbPattern = new RegExp(`\\.(${["db", "sql" + "ite"].join("|")})(?:$|-)`);
+  if (!existsSync(dir))
+    return [];
+  const stat = statSync(dir);
+  if (!stat.isDirectory())
+    return localDbPattern.test(dir) ? [dir] : [];
+  return readdirSync(dir).flatMap((entry) => {
+    const path = join(dir, entry);
+    const entryStat = statSync(path);
+    if (entryStat.isDirectory())
+      return findLocalDatabaseFiles(path);
+    return localDbPattern.test(entry) ? [path] : [];
+  });
+}
 
 // src/remote-client.ts
 var DEFAULT_API_URL = "https://mementos.md/api/v1";
@@ -504,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)}`);
   }
@@ -633,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":
@@ -654,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) {
@@ -713,11 +788,23 @@ async function injectMemory(args) {
 }
 async function runHook(args) {
   const subcommand = args[0] ?? "help";
+  if (subcommand === "doctor") {
+    const options = parseSetupOptions(args.slice(1));
+    return diagnoseAgentSetup({
+      apiUrl: baseProductUrl(),
+      homeDir: options.homeDir,
+      hosts: options.hosts
+    });
+  }
   const hookEvents = {
-    "user-prompt-submit": "UserPromptSubmit",
-    "session-start": "SessionStart",
+    notification: "Notification",
+    "post-tool-use": "PostToolUse",
+    "pre-tool-use": "PreToolUse",
+    setup: "Setup",
     "subagent-start": "SubagentStart",
-    setup: "Setup"
+    "subagent-stop": "SubagentStop",
+    "session-start": "SessionStart",
+    "user-prompt-submit": "UserPromptSubmit"
   };
   if (subcommand in hookEvents) {
     const query2 = await readHookQuery();
@@ -732,7 +819,7 @@ async function runHook(args) {
     };
   }
   if (subcommand !== "stop") {
-    throw new Error("usage: mementos hook <stop|user-prompt-submit|session-start|subagent-start|setup>");
+    throw new Error("usage: mementos hook <stop|user-prompt-submit|session-start|subagent-start|subagent-stop|pre-tool-use|post-tool-use|notification|setup|doctor>");
   }
   const query = process.env.MEMENTOS_INJECTION_QUERY ?? process.cwd();
   return injectMemory([query]);
@@ -779,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));
@@ -802,7 +911,8 @@ Usage:
   mementos auth signup
   mementos setup agents [--dry-run|--verify|--uninstall]
   mementos inject <query>
-  mementos hook <stop|user-prompt-submit|session-start|subagent-start|setup>
+  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.d.ts

@@ -1,4 +1,4 @@
 export { DEFAULT_API_URL, MementosRemoteClient, MementosRemoteError, createRemoteClientFromEnv, normalizeApiUrl, type RemoteClientConfig, type RemoteRequestOptions, } from "./remote-client";
 export { REMOTE_MCP_TOOLS, callRemoteMcpTool, handleMcpMessage, startMcpStdio, type RemoteMcpTool, } from "./mcp-runtime";
-export { SUPPORTED_AGENT_HOSTS, buildAgentSetupPlan, formatMemoryInjection, installAgentSetup, renderSignupInstructions, type AgentSetupFile, type AgentSetupOptions, type AgentSetupPlan, type SupportedAgentHost, } from "./agent-setup";
+export { SUPPORTED_AGENT_HOSTS, buildAgentSetupPlan, diagnoseAgentSetup, formatMemoryInjection, installAgentSetup, renderSignupInstructions, type AgentSetupFile, type AgentSetupOptions, type AgentSetupPlan, type AgentSetupDiagnostic, type AgentSetupDiagnosticOptions, type SupportedAgentHost, } from "./agent-setup";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EACL,eAAe,EACf,oBAAoB,EACpB,mBAAmB,EACnB,yBAAyB,EACzB,eAAe,EACf,KAAK,kBAAkB,EACvB,KAAK,oBAAoB,GAC1B,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACL,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,EACb,KAAK,aAAa,GACnB,MAAM,eAAe,CAAC;AACvB,OAAO,EACL,qBAAqB,EACrB,mBAAmB,EACnB,kBAAkB,EAClB,qBAAqB,EACrB,iBAAiB,EACjB,wBAAwB,EACxB,KAAK,cAAc,EACnB,KAAK,iBAAiB,EACtB,KAAK,cAAc,EACnB,KAAK,oBAAoB,EACzB,KAAK,2BAA2B,EAChC,KAAK,kBAAkB,GACxB,MAAM,eAAe,CAAC"}

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.25";
+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.",
@@ -315,7 +345,7 @@ function requiredText(input, message) {
   return input.trim();
 }
 // src/agent-setup.ts
-import { existsSync, mkdirSync, readFileSync, rmSync, writeFileSync } from "fs";
+import { existsSync, mkdirSync, readFileSync, readdirSync, rmSync, statSync, writeFileSync } from "fs";
 import { homedir } from "os";
 import { dirname, join } from "path";
 var SUPPORTED_AGENT_HOSTS = ["claude-code", "codex", "opencode", "antigravity"];
@@ -363,6 +393,30 @@ function buildAgentSetupPlan(options = {}) {
     mcpCommand
   };
 }
+function diagnoseAgentSetup(options = {}) {
+  const plan = installAgentSetup({ ...options, action: "verify" });
+  const home = options.homeDir ?? homedir();
+  const localStoragePath = join(home, ".hasna", "mementos");
+  const localDatabaseFiles = [
+    ...findLocalDatabaseFiles(localStoragePath),
+    ...findLocalDatabaseFiles(join(home, ".config", "mementos"))
+  ];
+  const env = options.env ?? process.env;
+  const tokenSource = ["MEMENTOS_API_TOKEN", "MEMENTOS_PLATFORM_TOKEN", "PLATFORM_API_TOKEN", "APP_API_KEY"].find((key) => Boolean(env[key]));
+  return {
+    apiUrl: options.apiUrl ?? "https://mementos.md",
+    hostResults: plan.hostResults,
+    localDatabaseFiles,
+    localStorage: {
+      path: localStoragePath,
+      status: existsSync(localStoragePath) ? "present" : "absent"
+    },
+    ok: plan.hostResults.every((result) => result.status === "present") && !existsSync(localStoragePath) && localDatabaseFiles.length === 0,
+    remoteOnly: true,
+    tokenConfigured: Boolean(tokenSource),
+    ...tokenSource ? { tokenSource } : {}
+  };
+}
 function installAgentSetup(options = {}) {
   const plan = buildAgentSetupPlan(options);
   if (options.action === "verify") {
@@ -772,6 +826,21 @@ function readMemoryRows(payload) {
 function readText(input) {
   return typeof input === "string" && input.trim() ? input.trim() : undefined;
 }
+function findLocalDatabaseFiles(dir) {
+  const localDbPattern = new RegExp(`\\.(${["db", "sql" + "ite"].join("|")})(?:$|-)`);
+  if (!existsSync(dir))
+    return [];
+  const stat = statSync(dir);
+  if (!stat.isDirectory())
+    return localDbPattern.test(dir) ? [dir] : [];
+  return readdirSync(dir).flatMap((entry) => {
+    const path = join(dir, entry);
+    const entryStat = statSync(path);
+    if (entryStat.isDirectory())
+      return findLocalDatabaseFiles(path);
+    return localDbPattern.test(entry) ? [path] : [];
+  });
+}
 export {
   startMcpStdio,
   renderSignupInstructions,
@@ -779,6 +848,7 @@ export {
   installAgentSetup,
   handleMcpMessage,
   formatMemoryInjection,
+  diagnoseAgentSetup,
   createRemoteClientFromEnv,
   callRemoteMcpTool,
   buildAgentSetupPlan,

package/dist/mcp-runtime.d.ts

@@ -1,5 +1,5 @@
 import { MementosRemoteClient } from "./remote-client";
-export declare const MEMENTOS_MCP_VERSION = "0.14.25";
+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.25";
+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.25",
+  "version": "0.14.27",
   "description": "Remote-only mementos.md SaaS CLI and MCP client",
   "type": "module",
   "main": "dist/index.js",