@pyxmate/memory 0.31.1 → 0.31.3

package/dist/cli/pyx-mem.mjs

@@ -166,9 +166,35 @@ function getDefaultKeychain() {
   return new NapiKeychainProvider();
 }
 
+// src/cli/probe.ts
+var PROBE_PATH = "/api/memory/entries?limit=1";
+var PROBE_TIMEOUT_MS = 8e3;
+async function probeCredentials(args) {
+  const fetcher = args.fetcher ?? fetch;
+  const url = `${args.endpoint}${PROBE_PATH}`;
+  const ctl = new AbortController();
+  const timer = setTimeout(() => ctl.abort(), PROBE_TIMEOUT_MS);
+  try {
+    const res = await fetcher(url, {
+      method: "GET",
+      headers: { Authorization: `Bearer ${args.apiKey}`, Accept: "application/json" },
+      signal: ctl.signal
+    });
+    if (res.status === 401 || res.status === 403) return { kind: "invalid", status: res.status };
+    if (res.ok) return { kind: "ok", status: res.status };
+    return { kind: "unreachable", reason: `HTTP ${res.status}` };
+  } catch (err) {
+    const msg = err instanceof Error ? err.message : String(err);
+    return { kind: "unreachable", reason: msg };
+  } finally {
+    clearTimeout(timer);
+  }
+}
+
 // src/cli/commands/doctor.ts
 async function doctorCommand(opts = {}) {
   const provider = opts.keychain ?? getDefaultKeychain();
+  const fetcher = opts.fetchImpl ?? fetch;
   const checks = [];
   const accessCheck = await provider.check();
   if (accessCheck.ok) {
@@ -198,9 +224,10 @@ async function doctorCommand(opts = {}) {
     });
   }
   const accessOk = accessCheck.ok;
+  let creds = null;
   if (accessOk) {
     try {
-      const creds = await provider.read();
+      creds = await provider.read();
       if (creds) {
         checks.push({
           id: "credentials.present",
@@ -237,11 +264,45 @@ async function doctorCommand(opts = {}) {
       message: "skipped \u2014 keychain access failed"
     });
   }
-  checks.push({
-    id: "mcp.coldStart",
-    status: "skip",
-    message: "wired in Step 5 \u2014 Lazy MCP server"
-  });
+  if (creds) {
+    const probe = await probeCredentials({
+      endpoint: creds.endpoint,
+      apiKey: creds.apiKey,
+      fetcher
+    });
+    if (probe.kind === "ok") {
+      checks.push({
+        id: "backend.reachable",
+        status: "pass",
+        message: `pyx-memory API reachable (HTTP ${probe.status})`,
+        endpoint: creds.endpoint
+      });
+    } else if (probe.kind === "invalid") {
+      checks.push({
+        id: "backend.reachable",
+        status: "fail",
+        code: "key-rejected",
+        message: `API key rejected (HTTP ${probe.status})`,
+        endpoint: creds.endpoint,
+        guidance: "Re-login with a valid key: pyx-mem login"
+      });
+    } else {
+      checks.push({
+        id: "backend.reachable",
+        status: "fail",
+        code: "unreachable",
+        message: `no pyx-memory API at this endpoint (${probe.reason})`,
+        endpoint: creds.endpoint,
+        guidance: "Verify the endpoint is the API backend, not a web UI: pyx-mem login --endpoint <API_URL>"
+      });
+    }
+  } else {
+    checks.push({
+      id: "backend.reachable",
+      status: "skip",
+      message: "skipped \u2014 no credentials to probe"
+    });
+  }
   const ok = checks.every((c) => c.status !== "fail");
   if (opts.json) {
     process.stdout.write(`${JSON.stringify({ ok, checks })}
@@ -337,8 +398,6 @@ async function readSingleLineFromStdin() {
 
 // src/cli/commands/login.ts
 var DEFAULT_ENDPOINT = "https://memory.api.pyxmate.com";
-var PROBE_PATH = "/api/memory/stats";
-var PROBE_TIMEOUT_MS = 8e3;
 async function loginCommand(opts = {}) {
   const provider = opts.keychain ?? getDefaultKeychain();
   const fetcher = opts.fetchImpl ?? fetch;
@@ -396,26 +455,6 @@ No credentials were written. pyx-mem does not write plaintext token files.
   }
   return EXIT.OK;
 }
-async function probeCredentials(args) {
-  const url = `${args.endpoint}${PROBE_PATH}`;
-  const ctl = new AbortController();
-  const timer = setTimeout(() => ctl.abort(), PROBE_TIMEOUT_MS);
-  try {
-    const res = await args.fetcher(url, {
-      method: "GET",
-      headers: { Authorization: `Bearer ${args.apiKey}`, Accept: "application/json" },
-      signal: ctl.signal
-    });
-    if (res.status === 401 || res.status === 403) return { kind: "invalid", status: res.status };
-    if (res.ok) return { kind: "ok", status: res.status };
-    return { kind: "unreachable", reason: `HTTP ${res.status}` };
-  } catch (err) {
-    const msg = err instanceof Error ? err.message : String(err);
-    return { kind: "unreachable", reason: msg };
-  } finally {
-    clearTimeout(timer);
-  }
-}
 async function readExistingEndpoint(provider) {
   try {
     const creds = await provider.read();
@@ -598,30 +637,10 @@ function createHttpClient(credentials, fetchImpl = fetch) {
       clearTimeout(timer);
     }
     if (res.status === 401 || res.status === 403) {
-      return { ok: false, result: mcpAuthFailed(res.status) };
+      return { ok: false, status: res.status, result: mcpAuthFailed(res.status) };
     }
     const text = await res.text().catch(() => "");
-    if (res.status >= 500) {
-      return { ok: false, result: mcpServerError(res.status, text) };
-    }
-    let parsed;
-    if (text.length > 0) {
-      try {
-        parsed = JSON.parse(text);
-      } catch {
-        if (!res.ok) return { ok: false, result: mcpHttpError(res.status, text || "no body") };
-        return { ok: true, status: res.status, data: text };
-      }
-    }
-    if (!res.ok) {
-      const message = extractEnvelopeError(parsed) ?? text ?? `HTTP ${res.status}`;
-      return { ok: false, result: mcpHttpError(res.status, message) };
-    }
-    const envelopeError = extractEnvelopeError(parsed);
-    if (envelopeError) {
-      return { ok: false, result: mcpEnvelopeError(envelopeError) };
-    }
-    return { ok: true, status: res.status, data: parsed };
+    return parseHttpResponse(res, text);
   }
   return {
     async requestJson(input) {
@@ -638,6 +657,39 @@ function createHttpClient(credentials, fetchImpl = fetch) {
     }
   };
 }
+function parseHttpResponse(res, text) {
+  if (res.status >= 500) {
+    return { ok: false, status: res.status, result: mcpServerError(res.status, text) };
+  }
+  const parsed = parseJsonText(text);
+  if (!parsed.ok) {
+    if (!res.ok) {
+      return {
+        ok: false,
+        status: res.status,
+        result: mcpHttpError(res.status, text || "no body")
+      };
+    }
+    return { ok: true, status: res.status, data: text };
+  }
+  if (!res.ok) {
+    const message = extractEnvelopeError(parsed.value) ?? text ?? `HTTP ${res.status}`;
+    return { ok: false, status: res.status, result: mcpHttpError(res.status, message) };
+  }
+  const envelopeError = extractEnvelopeError(parsed.value);
+  if (envelopeError) {
+    return { ok: false, status: res.status, result: mcpEnvelopeError(envelopeError) };
+  }
+  return { ok: true, status: res.status, data: parsed.value };
+}
+function parseJsonText(text) {
+  if (text.length === 0) return { ok: true, value: void 0 };
+  try {
+    return { ok: true, value: JSON.parse(text) };
+  } catch {
+    return { ok: false };
+  }
+}
 function extractEnvelopeError(parsed) {
   if (parsed === null || typeof parsed !== "object") return null;
   const obj = parsed;
@@ -1012,7 +1064,7 @@ var statusTool = {
   name: "status",
   config: {
     title: "Get pyx-memory topology",
-    description: "Fetch the running pyx-memory server topology: build variant (cloud|full), declared deployment role, server version, embedding location (inline|remote), and active model profile. HTTP proxy to GET /status \u2014 no in-process branch.",
+    description: "Fetch the running pyx-memory server topology from GET /status when available. Hosted gateways that expose /health but not /status return an explicit topologyUnavailable result with the health payload.",
     inputSchema: inputShape6,
     annotations: { readOnlyHint: true, openWorldHint: true }
   },
@@ -1021,7 +1073,17 @@ var statusTool = {
     if (!creds.ok) return creds.result;
     const http = createHttpClient(creds.credentials, deps.fetchImpl);
     const res = await http.requestJson({ method: "GET", path: "/status" });
-    return res.ok ? mcpJson(res.data) : res.result;
+    if (res.ok) return mcpJson(res.data);
+    if (res.status !== 404) return res.result;
+    const health = await http.requestJson({ method: "GET", path: "/health" });
+    if (!health.ok) return res.result;
+    return mcpJson({
+      topologyUnavailable: true,
+      reason: "GET /status returned 404; this endpoint exposes /health but not topology status.",
+      statusEndpoint: "/status",
+      healthEndpoint: "/health",
+      health: health.data
+    });
   }
 };
 
@@ -1262,7 +1324,7 @@ var ALL_TOOL_NAMES = ALL_TOOLS.map((t) => t.name);
 // src/mcp/server.ts
 async function runMcpServer(opts) {
   const fetchImpl = opts.fetchImpl ?? fetch;
-  const version = opts.version ?? (true ? "0.31.1" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "0.31.3" : "0.0.0-dev");
   const server = new McpServer(
     { name: "pyx-memory", version },
     { instructions: PYX_MEMORY_INSTRUCTIONS, capabilities: { tools: {} } }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@pyxmate/memory",
-  "version": "0.31.1",
+  "version": "0.31.3",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",