@hasna/mementos 0.14.25 → 0.14.26

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";
@@ -713,11 +752,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 +783,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]);
@@ -802,7 +853,7 @@ 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 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

@@ -137,7 +137,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.26";
 var AUTHLESS_SCHEMA = {
   type: "object",
   properties: {},
@@ -315,7 +315,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 +363,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 +796,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 +818,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.26";
 export interface RemoteMcpTool {
     name: string;
     description: string;

package/dist/mcp.js

@@ -142,7 +142,7 @@ function readErrorMessage(payload, status) {
 }
 
 // src/mcp-runtime.ts
-var MEMENTOS_MCP_VERSION = "0.14.25";
+var MEMENTOS_MCP_VERSION = "0.14.26";
 var AUTHLESS_SCHEMA = {
   type: "object",
   properties: {},

package/package.json

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