@pyxmate/memory 0.26.1 → 0.26.4

package/dist/{chunk-CE3ZBDTM.mjs → chunk-4BJCSQOO.mjs}

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

package/dist/{chunk-AKQIZAFT.mjs → chunk-5X2HOMDQ.mjs}

@@ -1,6 +1,6 @@
 import {
   mergeExtractedEntities
-} from "./chunk-573W637Y.mjs";
+} from "./chunk-SSUYQJUI.mjs";
 
 // ../client/src/memory-client.ts
 var MemoryServerError = class extends Error {
@@ -125,8 +125,11 @@ var MemoryClient = class {
     );
     return result.cleared;
   }
-  async stats() {
-    const stats = await this.fetchApi("/api/memory/stats");
+  async stats(options = {}) {
+    const searchParams = new URLSearchParams();
+    if (options.graphVisibility) searchParams.set("graphVisibility", options.graphVisibility);
+    const qs = searchParams.toString();
+    const stats = await this.fetchApi(`/api/memory/stats${qs ? `?${qs}` : ""}`);
     return { ...stats, connected: true };
   }
   /**
@@ -517,9 +520,7 @@ var MemoryClient = class {
     return result.nodes;
   }
   async graphEdges() {
-    return this.fetchApi(
-      "/api/memory/graph/edges"
-    );
+    return this.fetchApi("/api/memory/graph/edges");
   }
   async graphQuery(query) {
     return this.fetchApi("/api/memory/graph/query", {
@@ -575,6 +576,9 @@ var MemoryClient = class {
     });
     return result.deleted;
   }
+  async repairGraph() {
+    return this.fetchApi("/api/memory/graph/repair", { method: "POST" });
+  }
   async deleteBySource(source) {
     const result = await this.fetchApi(
       `/api/memory/source/${this.encodePathSegment(source)}`,
@@ -630,6 +634,35 @@ var MemoryClient = class {
     );
     return result.entry;
   }
+  /**
+   * v0.26 user-profile snapshot — upsert. The server derives `userId`
+   * from `X-User-Id` (caller wires it via `defaultHeaders` on the
+   * client constructor or per-request middleware); the body cannot
+   * override it. See spec §Requirements 10.
+   */
+  async upsertUserProfile(input) {
+    return this.fetchApi("/api/memory/profile/user", {
+      method: "PUT",
+      body: JSON.stringify(input)
+    });
+  }
+  /**
+   * v0.26 user-profile snapshot — fetch by namespace. Returns `null` on
+   * HTTP 404 (`isNotFound`), rethrows any other non-2xx as
+   * `MemoryServerError`. Mirrors `get()`'s 404-to-null pattern so callers
+   * can branch on "no profile yet" without inspecting status codes.
+   */
+  async getUserProfile(namespaceId) {
+    const params = new URLSearchParams({ namespaceId });
+    try {
+      return await this.fetchApi(
+        `/api/memory/profile/user?${params}`
+      );
+    } catch (error) {
+      if (error instanceof MemoryServerError && error.isNotFound) return null;
+      throw error;
+    }
+  }
   async fetchApi(path, options) {
     const signal = options?.signal ?? AbortSignal.timeout(this._requestTimeoutMs);
     let res;

package/dist/{chunk-573W637Y.mjs → chunk-SSUYQJUI.mjs}

@@ -58,9 +58,11 @@ var SensitivityLevel = {
 var RAGStrategy = {
   NAIVE: "naive",
   GRAPH: "graph",
-  AGENTIC: "agentic",
   HYBRID: "hybrid"
 };
+var DEPRECATED_RAG_STRATEGIES = /* @__PURE__ */ new Map([
+  ["agentic", "strategy.deprecated:agentic \u2014 removed in v0.26, use hybrid"]
+]);
 var VectorProvider = {
   LANCEDB: "lancedb"
 };
@@ -110,6 +112,7 @@ export {
   MemoryType,
   SensitivityLevel,
   RAGStrategy,
+  DEPRECATED_RAG_STRATEGIES,
   VectorProvider,
   EmbeddingProviderName,
   StoreTarget,

package/dist/cli/pyx-mem.mjs

@@ -2,7 +2,7 @@
 import {
   __export,
   mergeExtractedEntities
-} from "../chunk-573W637Y.mjs";
+} from "../chunk-SSUYQJUI.mjs";
 
 // src/cli/exit-codes.ts
 var EXIT = {
@@ -15334,11 +15334,66 @@ var listMemoriesTool = {
   }
 };
 
+// src/mcp/tools/profile.ts
+var getInputShape = {
+  namespaceId: external_exports.string().min(1).describe("Namespace id whose user-profile to fetch."),
+  ...scopeShape
+};
+var getUserProfileTool = {
+  name: "get_user_profile",
+  config: {
+    title: "Get pyx-memory user profile",
+    description: "Fetch the current user-profile snapshot for a namespace. HTTP proxy to GET /api/memory/profile/user \u2014 returns `{content, updatedAt, contentSize}` or a not-found error.",
+    inputSchema: getInputShape,
+    annotations: { readOnlyHint: true, openWorldHint: true }
+  },
+  handler: (deps) => async (raw) => {
+    const args = raw;
+    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: "/api/memory/profile/user",
+      query: { namespaceId: args.namespaceId },
+      scope: args
+    });
+    return res.ok ? mcpJson(res.data) : res.result;
+  }
+};
+var upsertInputShape = {
+  namespaceId: external_exports.string().min(1).describe("Namespace id to upsert the user-profile into."),
+  content: external_exports.string().min(1).describe("Full freeform profile content (UTF-8, \u22648192 bytes; server enforces the cap)."),
+  ...scopeShape
+};
+var upsertUserProfileTool = {
+  name: "upsert_user_profile",
+  config: {
+    title: "Upsert pyx-memory user profile",
+    description: "Upsert the user-profile snapshot for a namespace. HTTP proxy to PUT /api/memory/profile/user \u2014 returns `{updatedAt, contentSize}`. Idempotent: re-upsert preserves `createdAt` and refreshes `updatedAt`.",
+    inputSchema: upsertInputShape,
+    annotations: { readOnlyHint: false, openWorldHint: true }
+  },
+  handler: (deps) => async (raw) => {
+    const args = raw;
+    const creds = await deps.readCredentials();
+    if (!creds.ok) return creds.result;
+    const http = createHttpClient(creds.credentials, deps.fetchImpl);
+    const res = await http.requestJson({
+      method: "PUT",
+      path: "/api/memory/profile/user",
+      body: { namespaceId: args.namespaceId, content: args.content },
+      scope: args
+    });
+    return res.ok ? mcpJson(res.data) : res.result;
+  }
+};
+
 // src/mcp/tools/search.ts
 var inputShape5 = {
   query: external_exports.string().min(1).describe("Required natural-language search text."),
   limit: external_exports.number().int().min(1).max(100).optional().describe("Maximum results; server clamps to 1\u2013100. Default 5."),
-  strategy: external_exports.enum(["naive", "graph", "agentic", "hybrid"]).optional().describe(
+  strategy: external_exports.enum(["naive", "graph", "hybrid"]).optional().describe(
     "RAG strategy. Server default is `naive`; use `hybrid` for cross-encoder reranking, multi-entity decomposition, and confidence scoring."
   ),
   type: external_exports.enum(["short-term", "long-term", "working", "episodic", "summary"]).optional().describe("Filter by memory type."),
@@ -15614,14 +15669,16 @@ var ALL_TOOLS = [
   deleteMemoryTool,
   ingestMemoryFileTool,
   summarizeMemoryEntityTool,
-  statusTool
+  statusTool,
+  getUserProfileTool,
+  upsertUserProfileTool
 ];
 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.26.1" : "0.0.0-dev");
+  const version2 = opts.version ?? (true ? "0.26.4" : "0.0.0-dev");
   const server = new McpServer(
     { name: "pyx-memory", version: version2 },
     { instructions: PYX_MEMORY_INSTRUCTIONS, capabilities: { tools: {} } }

package/dist/dashboard.mjs

@@ -11,9 +11,9 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-CE3ZBDTM.mjs";
-import "./chunk-AKQIZAFT.mjs";
-import "./chunk-573W637Y.mjs";
+} from "./chunk-4BJCSQOO.mjs";
+import "./chunk-5X2HOMDQ.mjs";
+import "./chunk-SSUYQJUI.mjs";
 export {
   DashboardClient,
   Poller,

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, EntityExtractionResult as EntityExtractionResult$1, Topology as Topology$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, GraphRepairResult as GraphRepairResult$1, ExtractedImageMeta as ExtractedImageMeta$1, IngestEntity as IngestEntity$1, IngestRelationship as IngestRelationship$1, EntityExtractionResult as EntityExtractionResult$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 {
@@ -56,6 +56,11 @@ interface MemoryLogFilters {
 /** Options for scoping operations to a specific tenant. */
 interface TenantScopeOptions {
     tenantId?: string;
+    /**
+     * Graph count mode for stats(). Use raw on admin-health paths
+     * that should avoid the visible graph projection.
+     */
+    graphVisibility?: 'visible' | 'raw';
     /**
      * Calling principal. When supplied alongside or instead of tenantId,
      * the operation applies the AuthzPlan visibility filter — get/delete
@@ -111,6 +116,8 @@ interface ExtendedMemoryInterface extends MemoryInterface {
     reindex(): Promise<void>;
     /** Delete all entries matching a source, cleaning up all stores. */
     deleteBySource(source: string): Promise<number>;
+    /** Repair stale graph references left by older delete paths or crashed cleanup. */
+    repairGraph(): Promise<GraphRepairResult$1>;
     /**
      * Chronological feed of memory entries (Karpathy `log.md` primitive).
      * Cursor-based via `since` (created_at lower bound). No totalCount.
@@ -248,7 +255,7 @@ declare class MemoryClient implements ExtendedMemoryInterface {
     get(id: string): Promise<MemoryEntry$1 | null>;
     delete(id: string): Promise<boolean>;
     clearSession(sessionId: string): Promise<number>;
-    stats(): Promise<MemoryStats$1>;
+    stats(options?: TenantScopeOptions): Promise<MemoryStats$1>;
     /**
      * Fetch the running server's topology snapshot (build variant, declared
      * role, embedding location, active model profile). Round-trips the
@@ -319,6 +326,8 @@ declare class MemoryClient implements ExtendedMemoryInterface {
         stats: {
             nodeCount: number;
             edgeCount: number;
+            rawNodeCount?: number;
+            rawEdgeCount?: number;
         };
     }>;
     graphQuery(query: {
@@ -334,12 +343,37 @@ declare class MemoryClient implements ExtendedMemoryInterface {
     runDecay(): Promise<number>;
     reindex(): Promise<void>;
     clearGraph(): Promise<number>;
+    repairGraph(): Promise<GraphRepairResult$1>;
     deleteBySource(source: string): Promise<number>;
     queryAsOf(asOfDate: string, filters?: TemporalQueryFilters): Promise<MemoryEntry$1[]>;
     log(filters?: MemoryLogFilters): Promise<MemoryEntry$1[]>;
     queryByEventTime(startTime: string, endTime: string, filters?: TemporalQueryFilters): Promise<MemoryEntry$1[]>;
     summarizeEntity(name: string): Promise<MemoryEntry$1>;
     getEntitySynthesis(name: string): Promise<MemoryEntry$1 | null>;
+    /**
+     * v0.26 user-profile snapshot — upsert. The server derives `userId`
+     * from `X-User-Id` (caller wires it via `defaultHeaders` on the
+     * client constructor or per-request middleware); the body cannot
+     * override it. See spec §Requirements 10.
+     */
+    upsertUserProfile(input: {
+        namespaceId: string;
+        content: string;
+    }): Promise<{
+        updatedAt: string;
+        contentSize: number;
+    }>;
+    /**
+     * v0.26 user-profile snapshot — fetch by namespace. Returns `null` on
+     * HTTP 404 (`isNotFound`), rethrows any other non-2xx as
+     * `MemoryServerError`. Mirrors `get()`'s 404-to-null pattern so callers
+     * can branch on "no profile yet" without inspecting status codes.
+     */
+    getUserProfile(namespaceId: string): Promise<{
+        content: string;
+        updatedAt: string;
+        contentSize: number;
+    } | null>;
     protected fetchApi<T>(path: string, options?: RequestInit): Promise<T>;
     /**
      * Map fetch-layer rejections into a typed `MemoryServerError` so callers
@@ -388,10 +422,20 @@ type SensitivityLevel = (typeof SensitivityLevel)[keyof typeof SensitivityLevel]
 declare const RAGStrategy: {
     readonly NAIVE: "naive";
     readonly GRAPH: "graph";
-    readonly AGENTIC: "agentic";
     readonly HYBRID: "hybrid";
 };
 type RAGStrategy = (typeof RAGStrategy)[keyof typeof RAGStrategy];
+/**
+ * Strategy identifiers that were public in earlier versions and have been
+ * removed. Server/SDK reject requests using these with a stable
+ * `strategy.deprecated:<name>` error code (not the generic "invalid
+ * strategy" message) so callers and dashboards can detect the removal
+ * cleanly across a version bump.
+ *
+ * v0.26: `agentic` removed (Codex pair: silent-catch in agentic.ts
+ * violated Production-ready; behavior subsumed by HybridRAGEngine).
+ */
+declare const DEPRECATED_RAG_STRATEGIES: ReadonlyMap<string, string>;
 declare const VectorProvider: {
     readonly LANCEDB: "lancedb";
 };
@@ -634,11 +678,20 @@ interface MemoryStats {
     recentAccessCount: number;
     graphNodeCount?: number;
     graphEdgeCount?: number;
+    /** Raw graph node count before tenant/ReBAC visibility filtering (raw stats mode only). */
+    graphRawNodeCount?: number;
+    /** Raw graph edge count before tenant/ReBAC visibility filtering (raw stats mode only). */
+    graphRawEdgeCount?: number;
     /** Name of the active graph store ('neo4j', 'sqlite', or undefined if none). */
     graphStore?: string;
     /** Whether the memory service is connected. False when using DisabledMemory. */
     connected?: boolean;
 }
+interface GraphRepairResult {
+    staleEdgesDeleted: number;
+    staleNodeRefsRemoved: number;
+    orphanNodesDeleted: number;
+}
 interface GraphNode {
     id: string;
     name: string;
@@ -1036,4 +1089,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 EntityExtractionResult, 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, mergeExtractedEntities };
+export { type AgentId, type ApiResponse, type ConsolidationRunResult, DEFAULTS, DEPRECATED_RAG_STRATEGIES, EmbeddingProviderName, type EnrichmentCallbacks, type EntityExtractionResult, type ExtendedMemoryInterface, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphRepairResult, 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, mergeExtractedEntities };

package/dist/index.mjs

@@ -1,9 +1,10 @@
 import {
   MemoryClient,
   MemoryServerError
-} from "./chunk-AKQIZAFT.mjs";
+} from "./chunk-5X2HOMDQ.mjs";
 import {
   DEFAULTS,
+  DEPRECATED_RAG_STRATEGIES,
   EmbeddingProviderName,
   MemoryType,
   MoveFailureReason,
@@ -14,9 +15,10 @@ import {
   StoreTarget,
   VectorProvider,
   mergeExtractedEntities
-} from "./chunk-573W637Y.mjs";
+} from "./chunk-SSUYQJUI.mjs";
 export {
   DEFAULTS,
+  DEPRECATED_RAG_STRATEGIES,
   EmbeddingProviderName,
   MemoryClient,
   MemoryServerError,

package/dist/react.mjs

@@ -11,9 +11,9 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-CE3ZBDTM.mjs";
-import "./chunk-AKQIZAFT.mjs";
-import "./chunk-573W637Y.mjs";
+} from "./chunk-4BJCSQOO.mjs";
+import "./chunk-5X2HOMDQ.mjs";
+import "./chunk-SSUYQJUI.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts
 import { useCallback as useCallback2, useMemo } from "react";

package/package.json

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