@pyxmate/memory 0.24.0 → 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.24.0" : "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: {} } }

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.24.0",
+  "version": "0.24.1",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",