@pyxmate/memory 0.23.1 → 0.24.1

package/dist/{chunk-D5PMQYZM.mjs → chunk-CCGW6QRX.mjs}

@@ -101,6 +101,18 @@ var MemoryClient = class {
     const stats = await this.fetchApi("/api/memory/stats");
     return { ...stats, connected: true };
   }
+  /**
+   * Fetch the running server's topology snapshot (build variant, declared
+   * role, embedding location, active model profile). Round-trips the
+   * server's `GET /status` envelope through {@link fetchApi}, surfacing any
+   * non-success response as {@link MemoryServerError}. Auth-header
+   * forwarding is unchanged from other client methods even though `/status`
+   * is server-side public — the server simply ignores credentials on that
+   * route.
+   */
+  async status() {
+    return this.fetchApi("/status");
+  }
   async shutdown() {
   }
   async list(params = {}) {

package/dist/{chunk-4DRKAXJE.mjs → chunk-FSFVD3MB.mjs}

@@ -1,6 +1,6 @@
 import {
   MemoryClient
-} from "./chunk-D5PMQYZM.mjs";
+} from "./chunk-CCGW6QRX.mjs";
 
 // ../dashboard/src/aggregations/consolidation-analytics.ts
 function analyzeConsolidationLog(entries) {

package/dist/cli/pyx-mem.mjs

@@ -15343,6 +15343,25 @@ var searchMemoriesTool = {
   }
 };
 
+// src/mcp/tools/status.ts
+var inputShape6 = {};
+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.",
+    inputSchema: inputShape6,
+    annotations: { readOnlyHint: true, openWorldHint: true }
+  },
+  handler: (deps) => async () => {
+    const creds = await deps.readCredentials();
+    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;
+  }
+};
+
 // src/mcp/tools/store.ts
 var entityTypes = ["PERSON", "ORGANIZATION", "CONCEPT", "TOOL", "LOCATION", "EVENT"];
 var relationshipTypes = [
@@ -15356,7 +15375,7 @@ var relationshipTypes = [
   "WORKS_AT",
   "LOCATED_IN"
 ];
-var inputShape6 = {
+var inputShape7 = {
   content: external_exports.string().min(1).describe("Concise factual statement to persist; decision, not deliberation."),
   topic: external_exports.string().min(1).describe("Required metadata.topic for retrieval grouping."),
   project: external_exports.string().min(1).describe("Required metadata.project namespace."),
@@ -15387,7 +15406,7 @@ var storeMemoryTool = {
   config: {
     title: "Store pyx-memory entry",
     description: "Store one concise factual memory with required topic and project metadata. Provide entities/relationships when content names people, tools, orgs, locations, or events.",
-    inputSchema: inputShape6,
+    inputSchema: inputShape7,
     annotations: { readOnlyHint: false, idempotentHint: false, openWorldHint: true }
   },
   handler: (deps) => async (raw) => {
@@ -15422,7 +15441,7 @@ var storeMemoryTool = {
 };
 
 // src/mcp/tools/summarize.ts
-var inputShape7 = {
+var inputShape8 = {
   entityName: external_exports.string().min(1).describe(
     "Entity name to synthesize a profile for (PERSON, ORG, CONCEPT, TOOL, LOCATION, EVENT)."
   ),
@@ -15437,7 +15456,7 @@ var summarizeMemoryEntityTool = {
   config: {
     title: "Synthesize pyx-memory entity",
     description: "Fetch or refresh a reusable synthesis/profile for an entity (person, customer, project, tool, organization). Default fetches existing; set refresh:true to rebuild.",
-    inputSchema: inputShape7,
+    inputSchema: inputShape8,
     annotations: { readOnlyHint: false, idempotentHint: true, openWorldHint: true }
   },
   handler: (deps) => async (raw) => {
@@ -15472,14 +15491,15 @@ var ALL_TOOLS = [
   listMemoriesTool,
   deleteMemoryTool,
   ingestMemoryFileTool,
-  summarizeMemoryEntityTool
+  summarizeMemoryEntityTool,
+  statusTool
 ];
 var ALL_TOOL_NAMES = ALL_TOOLS.map((t) => t.name);
 
 // src/mcp/server.ts
 async function runMcpServer(opts) {
   const fetchImpl = opts.fetchImpl ?? fetch;
-  const version2 = opts.version ?? (true ? "0.23.1" : "0.0.0-dev");
+  const version2 = opts.version ?? (true ? "0.24.1" : "0.0.0-dev");
   const server = new McpServer(
     { name: "pyx-memory", version: version2 },
     { instructions: PYX_MEMORY_INSTRUCTIONS, capabilities: { tools: {} } }
@@ -15830,13 +15850,113 @@ Restart Gemini CLI to make the tools available. No API key was written to settin
 function geminiConfigPath(home, scope) {
   return scope === "project" ? join(process.cwd(), ".gemini", "settings.json") : join(home, ".gemini", "settings.json");
 }
+function mcpInstallPiCommand(opts = {}) {
+  const scope = opts.scope ?? "user";
+  if (!validateScope(scope)) return EXIT.USAGE;
+  const home = opts._homeDir ?? homedir();
+  const filePath = scope === "user" ? join(home, ".pi", "agent", "mcp.json") : join(process.cwd(), ".pi", "mcp.json");
+  return writeJsonAndReport(filePath, "Pi", {
+    prereq: "pi has no native MCP support \u2014 install the third-party adapter once:\n  pi install npm:pi-mcp-adapter"
+  });
+}
+function mcpInstallOpenClawCommand(opts = {}) {
+  const scope = opts.scope ?? "user";
+  if (!validateScope(scope)) return EXIT.USAGE;
+  const spawnSync = opts._spawnSync ?? nodeSpawnSync;
+  const probe = spawnSync("openclaw", ["--version"], { stdio: "pipe" });
+  if (probe.error || probe.status !== 0) {
+    printOpenClawManualInstructions();
+    return EXIT.OK;
+  }
+  const entryJson = JSON.stringify(ENTRY);
+  const cmd = ["mcp", "set", SERVER_NAME, entryJson];
+  const res = spawnSync("openclaw", cmd, { stdio: "inherit" });
+  if (res.status !== 0) {
+    process.stderr.write(
+      `\`openclaw ${cmd.join(" ")}\` exited with code ${res.status ?? "null"}.
+`
+    );
+    printOpenClawManualInstructions();
+    return EXIT.USAGE;
+  }
+  process.stdout.write(
+    `Installed pyx-memory MCP server in OpenClaw.
+Restart OpenClaw to make the tools available. No API key was written to openclaw.json \u2014 credentials live in the OS credential store.
+`
+  );
+  return EXIT.OK;
+}
+function printOpenClawManualInstructions() {
+  const entryJson = JSON.stringify(ENTRY);
+  process.stdout.write(
+    [
+      "The `openclaw` CLI is not on PATH, or the install command failed.",
+      "",
+      "Run this once OpenClaw is installed:",
+      `  openclaw mcp set ${SERVER_NAME} '${entryJson}'`,
+      "",
+      "Or add this entry manually under `mcp.servers` in your OpenClaw config",
+      "(run `openclaw config file` to print the active config path):",
+      "",
+      JSON.stringify({ mcp: { servers: { [SERVER_NAME]: ENTRY } } }, null, 2),
+      "",
+      "Do NOT add your pyx-memory API key here. Run `pyx-mem login` to store it in the OS credential store.",
+      ""
+    ].join("\n")
+  );
+}
+function mcpInstallHermesCommand(opts = {}) {
+  const scope = opts.scope ?? "user";
+  if (!validateScope(scope)) return EXIT.USAGE;
+  const spawnSync = opts._spawnSync ?? nodeSpawnSync;
+  const probe = spawnSync("hermes", ["--version"], { stdio: "pipe" });
+  if (probe.error || probe.status !== 0) {
+    printHermesManualInstructions();
+    return EXIT.OK;
+  }
+  const cmd = ["mcp", "add", SERVER_NAME, "--command", "pyx-mem", "--args", "mcp"];
+  const res = spawnSync("hermes", cmd, { stdio: "inherit" });
+  if (res.status !== 0) {
+    process.stderr.write(`\`hermes ${cmd.join(" ")}\` exited with code ${res.status ?? "null"}.
+`);
+    printHermesManualInstructions();
+    return EXIT.USAGE;
+  }
+  process.stdout.write(
+    `Installed pyx-memory MCP server in Hermes.
+Restart Hermes to make the tools available. No API key was written to config.yaml \u2014 credentials live in the OS credential store.
+`
+  );
+  return EXIT.OK;
+}
+function printHermesManualInstructions() {
+  process.stdout.write(
+    [
+      "The `hermes` CLI is not on PATH, or the install command failed.",
+      "",
+      "Run this once Hermes is installed:",
+      `  hermes mcp add ${SERVER_NAME} --command pyx-mem --args mcp`,
+      "",
+      "Or add this block under `mcp_servers:` in your Hermes config",
+      "(typically ~/.hermes/config.yaml):",
+      "",
+      `${SERVER_NAME}:`,
+      "  command: pyx-mem",
+      "  args:",
+      "    - mcp",
+      "",
+      "Do NOT add your pyx-memory API key here. Run `pyx-mem login` to store it in the OS credential store.",
+      ""
+    ].join("\n")
+  );
+}
 function validateScope(scope) {
   if (VALID_SCOPES.has(scope)) return true;
   process.stderr.write(`Error: invalid --scope \`${scope}\`. Expected: local | user | project.
 `);
   return false;
 }
-function writeJsonAndReport(filePath, agentLabel) {
+function writeJsonAndReport(filePath, agentLabel, opts = {}) {
   const result = mergeWriteJsonMcpEntry({
     filePath,
     serverName: SERVER_NAME,
@@ -15850,6 +15970,10 @@ function writeJsonAndReport(filePath, agentLabel) {
 `
     );
   }
+  if ((result.status === "installed" || result.status === "already-installed") && opts.prereq) {
+    process.stdout.write(`Prerequisite: ${opts.prereq}
+`);
+  }
   return result.exitCode;
 }
 
@@ -15910,7 +16034,7 @@ Commands:
   mcp                                          Start stdio MCP server.
   mcp install <target> [--scope user|local|project]
                                                Install pyx-memory MCP config for your AI agent.
-                                               Targets: claude-code, codex, cursor, cline, continue, windsurf, gemini-cli.
+                                               Targets: claude-code, codex, cursor, cline, continue, windsurf, gemini-cli, pi, openclaw, hermes.
 
 Notes:
   - Credentials are stored only in the OS credential store (Keychain / libsecret / Credential Manager).
@@ -15963,15 +16087,43 @@ function parseArgs(argv) {
 }
 
 // src/cli/pyx-mem.ts
-var VALID_TARGETS = [
-  "claude-code",
-  "codex",
-  "cursor",
-  "cline",
-  "continue",
-  "windsurf",
-  "gemini-cli"
-];
+var INSTALL_TARGETS = {
+  "claude-code": mcpInstallClaudeCodeCommand,
+  codex: mcpInstallCodexCommand,
+  cursor: mcpInstallCursorCommand,
+  cline: mcpInstallClineCommand,
+  continue: mcpInstallContinueCommand,
+  windsurf: mcpInstallWindsurfCommand,
+  "gemini-cli": mcpInstallGeminiCliCommand,
+  pi: mcpInstallPiCommand,
+  openclaw: mcpInstallOpenClawCommand,
+  hermes: mcpInstallHermesCommand
+};
+var VALID_TARGETS = Object.keys(INSTALL_TARGETS);
+function runMcpInstall(target, scope) {
+  if (target === void 0 || !Object.hasOwn(INSTALL_TARGETS, target)) {
+    process.stderr.write(
+      `Error: unknown install target \`${target ?? ""}\`. Expected: ${VALID_TARGETS.join(", ")}.
+`
+    );
+    return EXIT.USAGE;
+  }
+  const handler = INSTALL_TARGETS[target];
+  return handler({ scope });
+}
+function runMcpCommand(parsed) {
+  if (parsed.subcommand === void 0) return mcpCommand();
+  if (parsed.subcommand === "install") {
+    const target = parsed.positional[0];
+    const scope = typeof parsed.flags.scope === "string" ? parsed.flags.scope : void 0;
+    return runMcpInstall(target, scope);
+  }
+  process.stderr.write(
+    `Error: unknown subcommand \`mcp ${parsed.subcommand}\`. Run \`pyx-mem --help\`.
+`
+  );
+  return EXIT.USAGE;
+}
 async function main() {
   const parsed = parseArgs(process.argv.slice(2));
   if (parsed.flags.help === true || parsed.flags.h === true) {
@@ -15994,40 +16146,8 @@ async function main() {
       return logoutCommand();
     case "doctor":
       return doctorCommand({ json: parsed.flags.json === true });
-    case "mcp": {
-      if (parsed.subcommand === void 0) return mcpCommand();
-      if (parsed.subcommand === "install") {
-        const target = parsed.positional[0];
-        const scope = typeof parsed.flags.scope === "string" ? parsed.flags.scope : void 0;
-        switch (target) {
-          case "claude-code":
-            return mcpInstallClaudeCodeCommand({ scope });
-          case "codex":
-            return mcpInstallCodexCommand({ scope });
-          case "cursor":
-            return mcpInstallCursorCommand({ scope });
-          case "cline":
-            return mcpInstallClineCommand({ scope });
-          case "continue":
-            return mcpInstallContinueCommand({ scope });
-          case "windsurf":
-            return mcpInstallWindsurfCommand({ scope });
-          case "gemini-cli":
-            return mcpInstallGeminiCliCommand({ scope });
-          default:
-            process.stderr.write(
-              `Error: unknown install target \`${target ?? ""}\`. Expected: ${VALID_TARGETS.join(", ")}.
-`
-            );
-            return EXIT.USAGE;
-        }
-      }
-      process.stderr.write(
-        `Error: unknown subcommand \`mcp ${parsed.subcommand}\`. Run \`pyx-mem --help\`.
-`
-      );
-      return EXIT.USAGE;
-    }
+    case "mcp":
+      return runMcpCommand(parsed);
     default:
       process.stderr.write(
         `Error: unknown command \`${parsed.command}\`. Run \`pyx-mem --help\`.

package/dist/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-4DRKAXJE.mjs";
-import "./chunk-D5PMQYZM.mjs";
+} from "./chunk-FSFVD3MB.mjs";
+import "./chunk-CCGW6QRX.mjs";
 import "./chunk-7P6ASYW6.mjs";
 export {
   DashboardClient,

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-import { StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$1, MemoryType as MemoryType$1, PrincipalContext as PrincipalContext$1, MemoryStats as MemoryStats$1, WikiLintReport as WikiLintReport$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, IngestEvent as IngestEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1 } from '@pyx-memory/shared';
+import { StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$1, MemoryType as MemoryType$1, PrincipalContext as PrincipalContext$1, MemoryStats as MemoryStats$1, WikiLintReport as WikiLintReport$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, Topology as Topology$1, IngestEvent as IngestEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1 } from '@pyx-memory/shared';
 
 /** Parameters for paginated entry listing. */
 interface MemoryListParams {
@@ -211,6 +211,16 @@ declare class MemoryClient implements ExtendedMemoryInterface {
     delete(id: string): Promise<boolean>;
     clearSession(sessionId: string): Promise<number>;
     stats(): Promise<MemoryStats$1>;
+    /**
+     * Fetch the running server's topology snapshot (build variant, declared
+     * role, embedding location, active model profile). Round-trips the
+     * server's `GET /status` envelope through {@link fetchApi}, surfacing any
+     * non-success response as {@link MemoryServerError}. Auth-header
+     * forwarding is unchanged from other client methods even though `/status`
+     * is server-side public — the server simply ignores credentials on that
+     * route.
+     */
+    status(): Promise<Topology$1>;
     shutdown(): Promise<void>;
     list(params?: MemoryListParams): Promise<MemoryListResult>;
     /**
@@ -323,6 +333,45 @@ interface ApiResponse<T> {
     data?: T;
     error?: string;
 }
+/**
+ * Build variant of the running pyx-memory image. Detected from the actual
+ * availability of `@huggingface/transformers` at boot — `full` keeps the
+ * local-embedding stack bundled, `cloud` has it pruned (EMBEDDING_PROVIDER=http
+ * is mandatory). The detected value is authoritative; the optional
+ * `PYX_BUILD_VARIANT` env stamp is a sanity check that throws on drift.
+ */
+type TopologyServiceVariant = 'cloud' | 'full';
+/**
+ * Where embedding work happens. `inline` means the server computes vectors
+ * in-process (EMBEDDING_PROVIDER=local); `remote` means it delegates to an
+ * HTTP embedding service (EMBEDDING_PROVIDER=http). The endpoint URL itself
+ * is internal infrastructure and is intentionally NOT exposed here.
+ */
+type TopologyEmbeddingLocation = 'inline' | 'remote';
+/**
+ * Public topology snapshot returned by `GET /status`. Reflects actual runtime
+ * capability (variant detected from import probe, embedding location derived
+ * from configured provider) plus the active embedding profile. Never leaks
+ * embedding-service URLs or other infrastructure host fragments — those stay
+ * behind the admin surface.
+ */
+interface Topology {
+    service: {
+        variant: TopologyServiceVariant;
+        /**
+         * Operator-declared role label (`PYX_DEPLOYMENT_ROLE`). Free-form string.
+         * Structurally absent from the response when the env var is unset or empty.
+         */
+        declaredRole?: string;
+        version: string;
+    };
+    embedding: {
+        location: TopologyEmbeddingLocation;
+        modelKey: string;
+        modelId: string;
+        dimensions: number;
+    };
+}
 
 /** ISO 8601 timestamp string */
 type Timestamp = string;
@@ -907,4 +956,4 @@ interface PrincipalContext {
 /** Sentinel tenant ID used in single-tenant deployments. */
 declare const SINGLE_TENANT_ID = "_single";
 
-export { type AgentId, type ApiResponse, type ConsolidationRunResult, DEFAULTS, EmbeddingProviderName, type EnrichmentCallbacks, type ExtendedMemoryInterface, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemoryLogFilters, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, type MoveEntriesFilter, MoveFailureReason, type MoveResult, type MoveTarget, NamespaceIsolation, type PrincipalContext, RAGStrategy, SINGLE_TENANT_ID, SensitivityLevel, type StoreInput, StoreTarget, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, VectorProvider, type WikiLintReport };
+export { type AgentId, type ApiResponse, type ConsolidationRunResult, DEFAULTS, EmbeddingProviderName, type EnrichmentCallbacks, type ExtendedMemoryInterface, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemoryLogFilters, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, type MoveEntriesFilter, MoveFailureReason, type MoveResult, type MoveTarget, NamespaceIsolation, type PrincipalContext, RAGStrategy, SINGLE_TENANT_ID, SensitivityLevel, type StoreInput, StoreTarget, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyServiceVariant, VectorProvider, type WikiLintReport };

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   MemoryClient,
   MemoryServerError
-} from "./chunk-D5PMQYZM.mjs";
+} from "./chunk-CCGW6QRX.mjs";
 import "./chunk-7P6ASYW6.mjs";
 
 // ../shared/src/constants/defaults.ts

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-4DRKAXJE.mjs";
-import "./chunk-D5PMQYZM.mjs";
+} from "./chunk-FSFVD3MB.mjs";
+import "./chunk-CCGW6QRX.mjs";
 import "./chunk-7P6ASYW6.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts

package/package.json

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