@memoraone/mcp 0.1.21 → 0.1.23

package/dist/index.cjs

@@ -34,7 +34,6 @@ __export(index_exports, {
 });
 module.exports = __toCommonJS(index_exports);
 var path6 = __toESM(require("path"), 1);
-var crypto5 = __toESM(require("crypto"), 1);
 var import_node_url2 = require("url");
 var import_mcp = require("@modelcontextprotocol/sdk/server/mcp.js");
 var import_types = require("@modelcontextprotocol/sdk/types.js");
@@ -281,6 +280,13 @@ var memoraClient_default = MemoraClient;
 var fs2 = __toESM(require("fs/promises"), 1);
 var path2 = __toESM(require("path"), 1);
 var uuidRegex2 = /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i;
+function normalizeEnvironment(raw) {
+  if (raw === void 0 || raw === null || typeof raw !== "string") {
+    return void 0;
+  }
+  const trimmed = raw.trim();
+  return trimmed === "" ? void 0 : trimmed;
+}
 function parseAndValidateM1(content, markerPath) {
   let parsed2;
   try {
@@ -297,7 +303,8 @@ function parseAndValidateM1(content, markerPath) {
   }
   const apiKeyRaw = parsed2?.MEMORAONE_API_KEY ?? parsed2?.api_key;
   const apiKey = apiKeyRaw !== void 0 && apiKeyRaw !== null && typeof apiKeyRaw === "string" && apiKeyRaw.trim() !== "" ? apiKeyRaw.trim() : null;
-  return { projectId: projectId.trim(), apiKey };
+  const environment = normalizeEnvironment(parsed2?.environment);
+  return environment === void 0 ? { projectId: projectId.trim(), apiKey } : { projectId: projectId.trim(), apiKey, environment };
 }
 async function resolveProjectIdFromExplicitM1Path() {
   const raw = process.env.MEMORAONE_M1_PATH;
@@ -307,8 +314,8 @@ async function resolveProjectIdFromExplicitM1Path() {
   const markerPath = path2.resolve(raw);
   try {
     const content = await fs2.readFile(markerPath, "utf8");
-    const { projectId, apiKey } = parseAndValidateM1(content, markerPath);
-    return { projectId, apiKey, foundAt: markerPath };
+    const { projectId, apiKey, environment } = parseAndValidateM1(content, markerPath);
+    return environment === void 0 ? { projectId, apiKey, foundAt: markerPath } : { projectId, apiKey, environment, foundAt: markerPath };
   } catch (err) {
     if (err?.code === "ENOENT") {
       return null;
@@ -322,9 +329,9 @@ async function findM1WalkingUp(workspaceRoot) {
     const markerPath = path2.join(current, "memoraone.m1");
     try {
       const content = await fs2.readFile(markerPath, "utf8");
-      const { projectId, apiKey } = parseAndValidateM1(content, markerPath);
+      const { projectId, apiKey, environment } = parseAndValidateM1(content, markerPath);
       const repoRoot = path2.dirname(markerPath);
-      return { projectId, apiKey, repoRoot, markerPath };
+      return environment === void 0 ? { projectId, apiKey, repoRoot, markerPath } : { projectId, apiKey, environment, repoRoot, markerPath };
     } catch (err) {
       if (err?.code !== "ENOENT") {
         throw err;
@@ -384,6 +391,7 @@ async function resolveAuthoritativeBinding(workspaceRoot) {
       workspaceRoot: path2.dirname(explicitBinding.foundAt),
       m1Path: explicitBinding.foundAt,
       apiKey: resolved.apiKey,
+      ...explicitBinding.environment !== void 0 ? { environment: explicitBinding.environment } : {},
       bindingSource: "explicit-m1-path",
       apiKeySource: resolved.apiKeySource
     };
@@ -401,6 +409,7 @@ async function resolveAuthoritativeBinding(workspaceRoot) {
         workspaceRoot: binding.repoRoot,
         m1Path: binding.markerPath,
         apiKey: resolved.apiKey,
+        ...binding.environment !== void 0 ? { environment: binding.environment } : {},
         bindingSource: "workspace-search",
         apiKeySource: resolved.apiKeySource
       };
@@ -481,6 +490,7 @@ async function registerRepoSource(client, projectId, repoPath, ideType) {
 
 // src/tools/postEvent.ts
 var import_v42 = require("zod/v4");
+var postEventDescription = 'Append a durable project-change note to the MemoraOne timeline. Use after meaningful repository or project changes: decisions, fixes, new endpoints, schema changes, migrations, important wiring, or durable product behavior changes \u2014 not for trivial edits, formatting-only changes, or temporary WIP. Recommended shape: kind "note"; content.title (concise title); content.body (one durable, fact-promotable project-change statement); metadata.source (agent name, e.g. "cursor"); metadata.purpose "dev-log"; metadata.schema "v1".';
 var postEventShape = {
   kind: import_v42.z.string().min(1),
   actor: import_v42.z.object({
@@ -589,6 +599,9 @@ var setProjectShape = {
   projectId: import_v411.z.string().min(1).optional()
 };
 
+// src/tools/bindingStatus.ts
+var bindingStatusShape = {};
+
 // src/tools/handlers/postEvent.ts
 var import_v412 = require("zod/v4");
 var crypto3 = __toESM(require("crypto"), 1);
@@ -661,6 +674,32 @@ var postEventInputSchema = import_v412.z.object({
   content: import_v412.z.record(import_v412.z.string(), import_v412.z.any()),
   metadata: import_v412.z.record(import_v412.z.string(), import_v412.z.any()).optional()
 });
+function buildPostEventContentFields(content) {
+  if (typeof content.message === "string") {
+    return { message: content.message };
+  }
+  if (typeof content.text === "string") {
+    return { message: content.text };
+  }
+  const title = typeof content.title === "string" ? content.title : void 0;
+  const body = typeof content.body === "string" ? content.body : void 0;
+  if (title !== void 0 || body !== void 0) {
+    const message = body ?? title ?? "";
+    const structuredContent = {};
+    for (const [key, value] of Object.entries(content)) {
+      if (key === "message" || key === "text") continue;
+      structuredContent[key] = value;
+    }
+    const new_value = {
+      message,
+      ...title !== void 0 ? { title } : {},
+      ...body !== void 0 ? { body } : {},
+      content: structuredContent
+    };
+    return { message, new_value };
+  }
+  return { message: JSON.stringify(content) };
+}
 async function handlePostEvent(client, args) {
   const nonce = crypto3.randomBytes(8).toString("hex");
   console.error(
@@ -672,7 +711,7 @@ async function handlePostEvent(client, args) {
     throw new Error("No project selected. Use memora_list_projects and memora_set_project to select a project.");
   }
   const content = parsed2.content ?? {};
-  const message = typeof content.message === "string" ? content.message : typeof content.text === "string" ? content.text : JSON.stringify(content);
+  const { message, new_value } = buildPostEventContentFields(content);
   const body = {
     kind: parsed2.kind,
     message,
@@ -682,6 +721,7 @@ async function handlePostEvent(client, args) {
       identifier: config2.agentName,
       ...parsed2.actor.id ? { id: parsed2.actor.id } : {}
     },
+    ...new_value ? { new_value } : {},
     ...parsed2.metadata ? { metadata: parsed2.metadata } : {}
   };
   try {
@@ -866,7 +906,8 @@ async function handleAskWithMemory(client, args) {
   }
   return {
     answer: res.answer,
-    used: res.used ?? {}
+    used: res.used ?? {},
+    ...res.retrieval !== void 0 ? { retrieval: res.retrieval } : {}
   };
 }
 
@@ -1411,47 +1452,79 @@ async function handleSetProject(args) {
   return { ok: true, projectKey: resolvedProjectKey };
 }
 
-// src/index.ts
-var notInitializedResult = {
-  content: [
-    {
-      type: "text",
-      text: "MemoraOne MCP not initialized (project binding missing)."
-    }
-  ]
-};
-var initializeDiagDumped = false;
-var uriToPath = (uri) => {
-  if (uri.startsWith("file://")) {
-    return (0, import_node_url2.fileURLToPath)(uri);
+// src/tools/handlers/bindingStatus.ts
+function buildBindingStatus(binding) {
+  const status = {
+    projectId: binding.projectId,
+    workspaceRoot: binding.workspaceRoot,
+    m1Path: binding.m1Path,
+    bindingSource: binding.bindingSource,
+    apiKeySource: binding.apiKeySource
+  };
+  if (binding.environment !== void 0) {
+    status.environment = binding.environment;
   }
-  return uri;
-};
-function getCursorWorkspaceRootFromEnv() {
-  const raw = process.env.WORKSPACE_FOLDER_PATHS;
-  if (raw === void 0 || raw.trim() === "") {
-    return void 0;
+  return status;
+}
+function handleBindingStatus(binding) {
+  if (!binding) {
+    throw new Error("[memoraone-mcp] Binding status unavailable (not initialized)");
   }
-  const parts = raw.split(path6.delimiter).map((p) => p.trim()).filter(Boolean);
-  const first = parts[0];
-  return first ? path6.resolve(first) : void 0;
+  return buildBindingStatus(binding);
+}
+
+// src/heartbeat.ts
+var crypto5 = __toESM(require("crypto"), 1);
+function fingerprintApiKey(apiKey) {
+  return crypto5.createHash("sha256").update(apiKey).digest("hex").slice(0, 12);
 }
 function isHeartbeatDebugEnabled() {
   const value = String(process.env.MEMORAONE_DEBUG_HEARTBEAT ?? "").trim().toLowerCase();
   return ["1", "true", "yes", "on"].includes(value);
 }
-function fingerprintApiKey(apiKey) {
-  return crypto5.createHash("sha256").update(apiKey).digest("hex").slice(0, 12);
+function resolveHeartbeatIntervalMs() {
+  return Number.isFinite(config2.heartbeatIntervalMs) ? Math.max(1e3, config2.heartbeatIntervalMs) : 3e4;
+}
+async function sendProjectHeartbeat(client, ctx) {
+  try {
+    const pid = ctx.projectId?.trim();
+    if (isHeartbeatDebugEnabled()) {
+      process.stderr.write(
+        `[memoraone-mcp][diag] heartbeat projectId=${pid ?? "unknown"} apiKeySource=${ctx.apiKeySource ?? "unknown"} apiKeyFingerprint=${ctx.apiKeyFingerprint ?? "unknown"} ideType=${ctx.ideType ?? "unknown"}
+`
+      );
+    }
+    if (!pid) {
+      throw new Error("[memoraone-mcp] Cannot send heartbeat without an active project binding");
+    }
+    const body = {};
+    if (ctx.ideType) body.ide_type = ctx.ideType;
+    await client.post(`/v1/projects/${pid}/heartbeat`, body, {
+      log: false,
+      headers: {
+        "x-project-id": pid
+      }
+    });
+  } catch (err) {
+    process.stderr.write(
+      `[memoraone-mcp][info] heartbeat error (silent) ${String(err)}
+`
+    );
+  }
 }
-function inferIdeType(params) {
-  if (config2.ideType) {
-    return config2.ideType;
+
+// src/ideType.ts
+function inferIdeType(params, options = {}) {
+  const env2 = options.env ?? process.env;
+  const argv = (options.argv ?? process.argv).join(" ").toLowerCase();
+  const configIdeType = options.configIdeType ?? config2.ideType;
+  if (configIdeType) {
+    return configIdeType;
   }
   const clientInfoName = String(params?.clientInfo?.name ?? "").toLowerCase();
   const clientInfoVersion = String(params?.clientInfo?.version ?? "").toLowerCase();
-  const termProgram = String(process.env.TERM_PROGRAM ?? "").toLowerCase();
-  const argv = process.argv.join(" ").toLowerCase();
-  const envKeys = Object.keys(process.env);
+  const termProgram = String(env2.TERM_PROGRAM ?? "").toLowerCase();
+  const envKeys = Object.keys(env2);
   const hasCursorSignals = envKeys.some((key) => key.startsWith("CURSOR_")) || termProgram === "cursor" || clientInfoName.includes("cursor") || clientInfoVersion.includes("cursor") || argv.includes("cursor");
   if (hasCursorSignals) {
     return "cursor";
@@ -1463,7 +1536,7 @@ function inferIdeType(params) {
       "JETBRAINS_REMOTE_RUN",
       "INTELLIJ_ENVIRONMENT_READER"
     ].includes(key)
-  ) || String(process.env.TERMINAL_EMULATOR ?? "").toLowerCase().includes("jetbrains") || /(jetbrains|intellij|pycharm|webstorm|goland|rubymine|clion|phpstorm|rider|datagrip)/.test(
+  ) || String(env2.TERMINAL_EMULATOR ?? "").toLowerCase().includes("jetbrains") || /(jetbrains|intellij|pycharm|webstorm|goland|rubymine|clion|phpstorm|rider|datagrip)/.test(
     clientInfoName
   ) || /(jetbrains|intellij|pycharm|webstorm|goland|rubymine|clion|phpstorm|rider|datagrip)/.test(
     argv
@@ -1477,32 +1550,31 @@ function inferIdeType(params) {
   }
   return void 0;
 }
-async function sendHeartbeat(client, runtime) {
-  try {
-    const pid = runtime.projectId?.trim();
-    if (isHeartbeatDebugEnabled()) {
-      process.stderr.write(
-        `[memoraone-mcp][diag] heartbeat projectId=${pid ?? "unknown"} apiKeySource=${runtime.apiKeySource ?? "unknown"} apiKeyFingerprint=${runtime.apiKeyFingerprint ?? "unknown"}
-`
-      );
-    }
-    if (!pid) {
-      throw new Error("[memoraone-mcp] Cannot send heartbeat without an active project binding");
+
+// src/index.ts
+var notInitializedResult = {
+  content: [
+    {
+      type: "text",
+      text: "MemoraOne MCP not initialized (project binding missing)."
     }
-    const body = {};
-    if (runtime.ideType) body.ide_type = runtime.ideType;
-    await client.post(`/v1/projects/${pid}/heartbeat`, body, {
-      log: false,
-      headers: {
-        "x-project-id": pid
-      }
-    });
-  } catch (err) {
-    process.stderr.write(
-      `[memoraone-mcp][info] heartbeat error (silent) ${String(err)}
-`
-    );
+  ]
+};
+var initializeDiagDumped = false;
+var uriToPath = (uri) => {
+  if (uri.startsWith("file://")) {
+    return (0, import_node_url2.fileURLToPath)(uri);
   }
+  return uri;
+};
+function getCursorWorkspaceRootFromEnv() {
+  const raw = process.env.WORKSPACE_FOLDER_PATHS;
+  if (raw === void 0 || raw.trim() === "") {
+    return void 0;
+  }
+  const parts = raw.split(path6.delimiter).map((p) => p.trim()).filter(Boolean);
+  const first = parts[0];
+  return first ? path6.resolve(first) : void 0;
 }
 function redactSensitiveFields(obj) {
   if (obj === null || obj === void 0) return obj;
@@ -1594,6 +1666,7 @@ async function main(opts = {}) {
     projectId: null,
     apiKeySource: null,
     apiKeyFingerprint: null,
+    authoritativeBinding: opts.authoritativeBinding ?? null,
     ideType: void 0
   };
   let workspaceRoot;
@@ -1643,7 +1716,7 @@ async function main(opts = {}) {
   const registeredToolNames = [];
   server.tool(
     "memora_post_event",
-    "Forward an event to MemoraOne timeline",
+    postEventDescription,
     postEventShape,
     async (args) => runWithSessionContext(sessionContext, async () => {
       if (!runtime.client || !runtime.projectId) return notInitializedResult;
@@ -1719,6 +1792,19 @@ async function main(opts = {}) {
     })
   );
   registeredToolNames.push("memora_set_project");
+  server.tool(
+    "memora_status",
+    "Return non-secret project binding metadata for this MCP session",
+    bindingStatusShape,
+    async () => runWithSessionContext(sessionContext, async () => {
+      if (!runtime.authoritativeBinding) return notInitializedResult;
+      const result = handleBindingStatus(runtime.authoritativeBinding);
+      return {
+        content: [{ type: "text", text: JSON.stringify(result) }]
+      };
+    })
+  );
+  registeredToolNames.push("memora_status");
   registerToolWithWorklog(
     server,
     runtime,
@@ -1800,6 +1886,9 @@ async function main(opts = {}) {
       try {
         const params = request.params;
         runtime.ideType = inferIdeType(params);
+        if (runtime.ideType && opts.onSessionIdeTypeKnown) {
+          opts.onSessionIdeTypeKnown(runtime.ideType);
+        }
         if (!initializeDiagDumped) {
           initializeDiagDumped = true;
           const folders = Array.isArray(params.workspaceFolders) ? params.workspaceFolders.map((f) => ({ name: f?.name, uri: f?.uri })) : params.workspaceFolders;
@@ -1869,10 +1958,12 @@ async function main(opts = {}) {
         runtime.projectId = projectId;
         runtime.apiKeySource = binding.apiKeySource;
         runtime.apiKeyFingerprint = fingerprintApiKey(apiKeyToUse);
+        runtime.authoritativeBinding = binding;
         runtime.client = new memoraClient_default(config2, projectId, apiKeyToUse);
         workspaceRoot = binding.workspaceRoot;
+        const environmentLog = binding.environment !== void 0 ? ` environment=${binding.environment}` : "";
         process.stderr.write(
-          `[memoraone-mcp] registering workspace source bindingSource=${binding.bindingSource} workspaceRoot=${workspaceRoot ?? "(unset)"} m1Path=${binding.m1Path}
+          `[memoraone-mcp] registering workspace source bindingSource=${binding.bindingSource} workspaceRoot=${workspaceRoot ?? "(unset)"} m1Path=${binding.m1Path}${environmentLog}
 `
         );
         await registerRepoSource(
@@ -1886,8 +1977,9 @@ async function main(opts = {}) {
           console.error("[memoraone-mcp][auth] project_id:", projectId);
           console.error("[memoraone-mcp][auth] api_key source:", binding.apiKeySource);
         }
+        const bindingEnvironmentLog = binding.environment !== void 0 ? ` environment=${binding.environment}` : "";
         console.error(
-          `[memoraone-mcp] ${sessionLabel} authoritative binding: project=${binding.projectId} workspace=${binding.workspaceRoot} m1=${binding.m1Path} source=${binding.bindingSource} apiKeySource=${binding.apiKeySource}`
+          `[memoraone-mcp] ${sessionLabel} authoritative binding: project=${binding.projectId} workspace=${binding.workspaceRoot} m1=${binding.m1Path} source=${binding.bindingSource} apiKeySource=${binding.apiKeySource}${bindingEnvironmentLog}`
         );
         bindingReadyResolve?.(runtime.client);
         return server.server._oninitialize(request);
@@ -1904,14 +1996,25 @@ async function main(opts = {}) {
   await server.connect(transport);
   const activeClient = await bindingReady;
   let heartbeatInterval = null;
-  if (config2.heartbeatEnabled) {
-    await sendHeartbeat(activeClient, runtime);
-    const intervalMs = Number.isFinite(config2.heartbeatIntervalMs) ? Math.max(1e3, config2.heartbeatIntervalMs) : 3e4;
+  const daemonSession = Boolean(opts.sessionSocket);
+  if (config2.heartbeatEnabled && daemonSession) {
+    console.error(
+      `[memoraone-mcp] ${sessionLabel} defers heartbeat to daemon for project ${runtime.projectId}`
+    );
+  } else if (config2.heartbeatEnabled) {
+    const intervalMs = resolveHeartbeatIntervalMs();
+    const heartbeatCtx = {
+      projectId: runtime.projectId,
+      ideType: runtime.ideType,
+      apiKeySource: runtime.apiKeySource,
+      apiKeyFingerprint: runtime.apiKeyFingerprint
+    };
     console.error(
       `[memoraone-mcp] ${sessionLabel} owns heartbeat for project ${runtime.projectId} interval=${intervalMs}ms`
     );
+    await sendProjectHeartbeat(activeClient, heartbeatCtx);
     heartbeatInterval = setInterval(() => {
-      sendHeartbeat(activeClient, runtime).catch(() => {
+      sendProjectHeartbeat(activeClient, heartbeatCtx).catch(() => {
       });
     }, intervalMs);
   }
@@ -1920,10 +2023,14 @@ async function main(opts = {}) {
   const shutdown = (signal, exitProcess = true) => {
     process.off("SIGINT", onSigInt);
     process.off("SIGTERM", onSigTerm);
-    if (heartbeatInterval) clearInterval(heartbeatInterval);
-    heartbeatInterval = null;
-    if (runtime.projectId) {
-      console.error(`[memoraone-mcp] ${sessionLabel} released heartbeat for project ${runtime.projectId}`);
+    if (heartbeatInterval) {
+      clearInterval(heartbeatInterval);
+      heartbeatInterval = null;
+      if (runtime.projectId) {
+        console.error(
+          `[memoraone-mcp] ${sessionLabel} released session heartbeat for project ${runtime.projectId}`
+        );
+      }
     }
     if (devMode) {
       console.error(`[memoraone-mcp] ${sessionLabel} received ${signal}, shutting down`);

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@memoraone/mcp",
-  "version": "0.1.21",
+  "version": "0.1.23",
   "type": "module",
   "main": "dist/index.cjs",
   "bin": {