@hasna/mementos 0.14.30 → 0.14.31

package/README.md

@@ -48,6 +48,17 @@ plus host instruction files that tell the agent to use `memory.search`,
 `memory.save`, and `mementos inject` as the hosted fallback path when native
 hooks are unavailable.
 
+## Brain workers
+
+```bash
+mementos brain workers
+mementos brain fire "summarize this session" --worker memory --worker recap --persist --project platform-mementos
+```
+
+Brain runs are hosted Cerebras-backed jobs queued through mementos.md billing
+and run history. The CLI only sends the request to the hosted API; it does not
+run local workers or keep local memory.
+
 ## Bridge
 
 ```bash

package/dist/cli.js

@@ -823,6 +823,12 @@ class MementosRemoteClient {
   createRun(slug, input = {}) {
     return this.request(`/runs/${encodeURIComponent(slug)}`, { method: "POST", body: input });
   }
+  listBrainWorkers() {
+    return this.request("/brain/workers");
+  }
+  fireBrain(input = {}) {
+    return this.request("/brain/fire", { method: "POST", body: input });
+  }
   getRun(id) {
     return this.request(`/runs/${encodeURIComponent(id)}`);
   }
@@ -936,6 +942,8 @@ async function run(name, args) {
       return runBridge(args);
     case "billing":
       return runBilling(args);
+    case "brain":
+      return runBrain(args);
     case "inbox":
       return runInbox(args);
     case "capabilities":
@@ -1070,6 +1078,20 @@ async function runBilling(args) {
       throw new Error("usage: mementos billing <status|credits|buy>");
   }
 }
+async function runBrain(args) {
+  const subcommand = args[0] ?? "workers";
+  switch (subcommand) {
+    case "workers":
+    case "list":
+      return client.listBrainWorkers();
+    case "fire": {
+      const input = parseBrainFireOptions(args.slice(1));
+      return client.fireBrain(input);
+    }
+    default:
+      throw new Error("usage: mementos brain <workers|fire>");
+  }
+}
 async function runAuth(args) {
   const subcommand = args[0] ?? "help";
   if (subcommand !== "signup" && subcommand !== "login") {
@@ -1309,6 +1331,46 @@ function parseInboxOptions(args) {
   }
   return options;
 }
+function parseBrainFireOptions(args) {
+  const options = {};
+  const workers = [];
+  const text = [];
+  for (let index = 0;index < args.length; index += 1) {
+    const arg = args[index];
+    if (arg === "--input" || arg === "--prompt" || arg === "--message") {
+      options.input = args[++index] ?? "";
+    } else if (arg === "--worker") {
+      const worker = args[++index];
+      if (worker)
+        workers.push(worker);
+    } else if (arg === "--workers") {
+      workers.push(...splitCsv(args[++index] ?? ""));
+    } else if (arg === "--persist") {
+      options.persist = true;
+    } else if (arg === "--project") {
+      options.projectKey = args[++index];
+    } else if (arg === "--session") {
+      options.sessionId = args[++index];
+    } else if (arg === "--max-workers") {
+      options.maxWorkers = readRequiredPositiveInteger(args[++index], "--max-workers");
+    } else if (arg === "--max-input-chars") {
+      options.maxInputChars = readRequiredPositiveInteger(args[++index], "--max-input-chars");
+    } else if (arg === "--max-output-tokens") {
+      options.maxOutputTokens = readRequiredPositiveInteger(args[++index], "--max-output-tokens");
+    } else if (arg.startsWith("--")) {
+      throw new Error(`Unknown brain option: ${arg}`);
+    } else {
+      text.push(arg);
+    }
+  }
+  const input = readHookText(options.input) ?? text.join(" ").trim();
+  if (!input)
+    throw new Error("usage: mementos brain fire <input> [--worker <id>] [--persist] [--project <key>] [--session <id>]");
+  options.input = input;
+  if (workers.length > 0)
+    options.workers = workers;
+  return Object.fromEntries(Object.entries(options).filter(([, value]) => value !== undefined && value !== ""));
+}
 function parseHosts(input) {
   const requested = input.split(",").map((host) => host.trim()).filter(Boolean);
   const unknown = requested.filter((host) => !SUPPORTED_AGENT_HOSTS.includes(host));
@@ -1328,6 +1390,15 @@ function readPositiveInteger(input) {
   const value = Number(input);
   return Number.isInteger(value) && value > 0 ? value : undefined;
 }
+function readRequiredPositiveInteger(input, label) {
+  const value = readPositiveInteger(input);
+  if (!value)
+    throw new Error(`${label} must be a positive integer`);
+  return value;
+}
+function splitCsv(input) {
+  return input.split(",").map((item) => item.trim()).filter(Boolean);
+}
 function sleep(ms) {
   return new Promise((resolve) => setTimeout(resolve, ms));
 }
@@ -1348,6 +1419,7 @@ Usage:
   mementos bridge <start|status|stop|install|uninstall|logs|run>
   mementos inbox <send|list|claim>
   mementos billing <status|credits|buy>
+  mementos brain <workers|fire>
   mementos capabilities
   mementos agents
   mementos usage

package/dist/index.js

@@ -70,6 +70,12 @@ class MementosRemoteClient {
   createRun(slug, input = {}) {
     return this.request(`/runs/${encodeURIComponent(slug)}`, { method: "POST", body: input });
   }
+  listBrainWorkers() {
+    return this.request("/brain/workers");
+  }
+  fireBrain(input = {}) {
+    return this.request("/brain/fire", { method: "POST", body: input });
+  }
   getRun(id) {
     return this.request(`/runs/${encodeURIComponent(id)}`);
   }
@@ -146,7 +152,7 @@ function readErrorMessage(payload, status) {
 }
 // src/mcp-runtime.ts
 import { createInterface } from "readline";
-var MEMENTOS_MCP_VERSION = "0.14.30";
+var MEMENTOS_MCP_VERSION = "0.14.31";
 var AUTHLESS_SCHEMA = {
   type: "object",
   properties: {},
@@ -245,11 +251,17 @@ var REMOTE_MCP_TOOLS = [
       return client.createRun(slug, body);
     }
   },
+  {
+    name: "brain.workers",
+    description: "List hosted mementos.md Cerebras brain workers.",
+    inputSchema: AUTHLESS_SCHEMA,
+    run: (_input, client) => client.listBrainWorkers()
+  },
   {
     name: "brain.fire",
     description: "Queue hosted mementos.md Cerebras brain workers.",
     inputSchema: OPEN_SCHEMA,
-    run: (input, client) => client.createRun("brain.fire", input)
+    run: (input, client) => client.fireBrain(input)
   },
   {
     name: "runs.get",

package/dist/mcp-runtime.d.ts

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

@@ -75,6 +75,12 @@ class MementosRemoteClient {
   createRun(slug, input = {}) {
     return this.request(`/runs/${encodeURIComponent(slug)}`, { method: "POST", body: input });
   }
+  listBrainWorkers() {
+    return this.request("/brain/workers");
+  }
+  fireBrain(input = {}) {
+    return this.request("/brain/fire", { method: "POST", body: input });
+  }
   getRun(id) {
     return this.request(`/runs/${encodeURIComponent(id)}`);
   }
@@ -151,7 +157,7 @@ function readErrorMessage(payload, status) {
 }
 
 // src/mcp-runtime.ts
-var MEMENTOS_MCP_VERSION = "0.14.30";
+var MEMENTOS_MCP_VERSION = "0.14.31";
 var AUTHLESS_SCHEMA = {
   type: "object",
   properties: {},
@@ -250,11 +256,17 @@ var REMOTE_MCP_TOOLS = [
       return client.createRun(slug, body);
     }
   },
+  {
+    name: "brain.workers",
+    description: "List hosted mementos.md Cerebras brain workers.",
+    inputSchema: AUTHLESS_SCHEMA,
+    run: (_input, client) => client.listBrainWorkers()
+  },
   {
     name: "brain.fire",
     description: "Queue hosted mementos.md Cerebras brain workers.",
     inputSchema: OPEN_SCHEMA,
-    run: (input, client) => client.createRun("brain.fire", input)
+    run: (input, client) => client.fireBrain(input)
   },
   {
     name: "runs.get",

package/dist/remote-client.d.ts

@@ -37,6 +37,8 @@ export declare class MementosRemoteClient {
     memoryUsage(): Promise<unknown>;
     listRuns(input?: Record<string, unknown>): Promise<unknown>;
     createRun(slug: string, input?: Record<string, unknown>): Promise<unknown>;
+    listBrainWorkers(): Promise<unknown>;
+    fireBrain(input?: Record<string, unknown>): Promise<unknown>;
     getRun(id: string): Promise<unknown>;
     listApprovals(): Promise<unknown>;
     billingStatus(): 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,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"}
+{"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,gBAAgB;IAIhB,SAAS,CAAC,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM;IAI7C,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.30",
+  "version": "0.14.31",
   "description": "Remote-only mementos.md SaaS CLI and MCP client",
   "type": "module",
   "main": "dist/index.js",