@pyxmate/memory 0.31.1 → 0.31.2

package/dist/cli/pyx-mem.mjs

@@ -166,9 +166,35 @@ function getDefaultKeychain() {
   return new NapiKeychainProvider();
 }
 
+// src/cli/probe.ts
+var PROBE_PATH = "/api/memory/stats";
+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();
@@ -1262,7 +1301,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.2" : "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.2",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",