@pyxmate/memory 0.35.0 → 0.36.0

package/dist/{chunk-KQV3VYZO.mjs → chunk-DEMDFWI4.mjs}

@@ -1,6 +1,6 @@
 import {
   MemoryClient
-} from "./chunk-C2KBUNUM.mjs";
+} from "./chunk-EXUSQ2GR.mjs";
 
 // ../dashboard/src/aggregations/consolidation-analytics.ts
 function analyzeConsolidationLog(entries) {
@@ -171,21 +171,15 @@ var DashboardClient = class extends MemoryClient {
       `/api/memory/graph/relationships?limit=${limit}`
     );
   }
-  async graphFull(limit = 50) {
-    const relationshipLimit = limit * 4;
-    const [nodesResponse, relsResponse] = await Promise.all([
-      this.fetchApi(
-        `/api/memory/graph/nodes?limit=${limit}`
-      ),
-      this.graphRelationships(relationshipLimit).catch(() => ({
-        relationships: [],
-        totalCount: 0
-      }))
-    ]);
-    return {
-      nodes: nodesResponse.nodes,
-      relationships: relsResponse.relationships
-    };
+  /**
+   * Coherent graph projection (server ≥0.34): edges + ALL their endpoint nodes
+   * + true store totals. The former nodes+relationships pair fetch (graphFull)
+   * could not feed a graph view — links whose endpoints fell outside the
+   * arbitrary N-node sample were silently dropped, collapsing dense graphs to
+   * a handful of rendered links.
+   */
+  async graphSubgraph(edges = 2e3) {
+    return this.fetchApi(`/api/memory/graph/subgraph?edges=${edges}`);
   }
   async fetchHealthRaw() {
     return this.fetchApi("/health");

package/dist/{chunk-C2KBUNUM.mjs → chunk-EXUSQ2GR.mjs}

@@ -105,6 +105,7 @@ var MemoryClient = class {
       searchParams.set("eventTimeEnd", params.eventTimeRange[1]);
     }
     if (params.asOf) searchParams.set("asOf", params.asOf);
+    if (params.anchorTime) searchParams.set("anchorTime", params.anchorTime);
     if (params.abstentionThreshold != null)
       searchParams.set("abstentionThreshold", String(params.abstentionThreshold));
     return this.fetchApi(`/api/memory/search?${searchParams}`);

package/dist/cli/pyx-mem.mjs

@@ -555,7 +555,7 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 
 // src/mcp/instructions.ts
-var PYX_MEMORY_INSTRUCTIONS = `Use pyx-memory to search durable project/user memory before assuming prior decisions, and to store concise facts after corrections, bug fixes, design decisions, integration discoveries, gotchas, explicit preferences, or "remember this" requests. Store decisions, not deliberation. Include topic and project. When content names people, organizations, tools, places, events, or key concepts, you (the caller) must extract and pass both entities and relationships \u2014 the server does not auto-extract them. Edges matter as much as nodes: without relationships the graph cannot connect related memories. Use file ingest for documents/images worth persisting; images require a description.`;
+var PYX_MEMORY_INSTRUCTIONS = `Use pyx-memory to search durable project/user memory before assuming prior decisions, and to store concise facts after corrections, bug fixes, design decisions, integration discoveries, gotchas, explicit preferences, or "remember this" requests. Store decisions, not deliberation. Include topic and project. Pass eventTime (ISO-8601, when the fact happened or took effect) for any fact that can change or go stale \u2014 job/status changes, decisions that supersede earlier ones, dated events; recency ordering, dated ("as of") queries, and stale-vs-current conflict resolution all key off it. When a question names a time \u2014 explicit or relative ("last year", "\uB450 \uB2EC \uC804") \u2014 resolve it to an absolute ISO-8601 timestamp yourself and pass it as search anchorTime: results then rank by proximity to that time instead of now, without excluding anything. When content names people, organizations, tools, places, events, or key concepts, you (the caller) must extract and pass both entities and relationships \u2014 the server does not auto-extract them. Edges matter as much as nodes: without relationships the graph cannot connect related memories. Use file ingest for documents/images worth persisting; images require a description.`;
 
 // src/mcp/sampling.ts
 function createSamplingClient(server) {
@@ -1024,6 +1024,9 @@ var inputShape5 = {
   eventTimeStart: z8.string().optional().describe("Inclusive event-time start (ISO-8601); must be paired with eventTimeEnd."),
   eventTimeEnd: z8.string().optional().describe("Inclusive event-time end (ISO-8601); must be paired with eventTimeStart."),
   asOf: z8.string().optional().describe("Only include memories ingested before this ISO-8601 timestamp."),
+  anchorTime: z8.string().optional().describe(
+    'Soft recency ANCHOR (ISO-8601) \u2014 ranks results by proximity to this time instead of now; never excludes anything. When the question names a relative time ("two months ago", "last year", "3\uB144 \uC804"), resolve it against the current date yourself and pass the absolute timestamp here; prefer this over eventTimeStart/End unless a strict window is required, because hard filters drop last-known-before facts.'
+  ),
   ...scopeShape
 };
 var searchMemoriesTool = {
@@ -1055,7 +1058,8 @@ var searchMemoriesTool = {
         abstentionThreshold: args.abstentionThreshold,
         eventTimeStart: args.eventTimeStart,
         eventTimeEnd: args.eventTimeEnd,
-        asOf: args.asOf
+        asOf: args.asOf,
+        anchorTime: args.anchorTime
       },
       scope: args
     });
@@ -1175,7 +1179,9 @@ var inputShape7 = {
     "Storage targets. Include 'graph' when you provide entities/relationships or want zero graph write counts reported."
   ),
   importance: z10.number().int().min(1).max(10).optional().describe("Importance 1\u201310."),
-  eventTime: z10.string().optional().describe("ISO-8601 timestamp of when the event happened (bi-temporal)."),
+  eventTime: z10.string().optional().describe(
+    'ISO-8601 time the fact happened or took effect (bi-temporal). Pass for any fact that can change or go stale \u2014 recency ordering, dated ("as of") queries, and stale-vs-current conflict resolution key off it.'
+  ),
   source: z10.string().optional().describe("Free-form origin (filename, URL, conversation id)."),
   agentId: z10.string().optional().describe("Agent identifier stored alongside the entry."),
   sessionId: z10.string().optional().describe("Session identifier for grouping."),
@@ -1330,7 +1336,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.35.0" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "0.36.0" : "0.0.0-dev");
   const server = new McpServer(
     { name: "pyx-memory", version },
     { instructions: PYX_MEMORY_INSTRUCTIONS, capabilities: { tools: {} } }

package/dist/dashboard.d.ts

@@ -1,4 +1,4 @@
-import { MemoryType, MemoryEntry, MemoryStats, GraphRelationship, GraphNode } from '@pyx-memory/shared';
+import { MemoryType, MemoryEntry, GraphNode, GraphRelationship, MemoryStats } from '@pyx-memory/shared';
 import { MemoryClient } from '@pyx-memory/client';
 
 interface RawHealthResponse {
@@ -13,6 +13,15 @@ interface RawHealthResponse {
         storageUsedBytes: number;
     };
 }
+/** GET /api/memory/graph/subgraph — edges + ALL their endpoint nodes + true store totals. */
+interface SubgraphResponse {
+    nodes: GraphNode[];
+    relationships: GraphRelationship[];
+    categoryTotals: Record<string, number>;
+    totalNodes: number;
+    totalEdges: number;
+    truncated: boolean;
+}
 interface HealthData {
     status: 'ok' | 'degraded' | 'unreachable';
     uptime: number;
@@ -175,10 +184,14 @@ declare class DashboardClient extends MemoryClient {
         relationships: GraphRelationship[];
         totalCount: number;
     }>;
-    graphFull(limit?: number): Promise<{
-        nodes: GraphNode[];
-        relationships: GraphRelationship[];
-    }>;
+    /**
+     * Coherent graph projection (server ≥0.34): edges + ALL their endpoint nodes
+     * + true store totals. The former nodes+relationships pair fetch (graphFull)
+     * could not feed a graph view — links whose endpoints fell outside the
+     * arbitrary N-node sample were silently dropped, collapsing dense graphs to
+     * a handful of rendered links.
+     */
+    graphSubgraph(edges?: number): Promise<SubgraphResponse>;
     fetchHealthRaw(): Promise<RawHealthResponse>;
 }
 
@@ -213,4 +226,4 @@ declare class Poller<T> {
     private emit;
 }
 
-export { type ConsolidationAnalytics, type ConsolidationLogEntry, type D3ForceData, type D3ForceLink, type D3ForceNode, DashboardClient, type EntryFilters, type GraphVizData, type GraphVizEdge, type GraphVizNode, type GraphologyData, type GraphologyEdge, type GraphologyNode, type HealthData, type HookResult, type MemoryMetrics, type PaginatedEntries, Poller, type PollerOptions, type PollerState, type RawHealthResponse, type TransformOptions, type TypeDistribution, analyzeConsolidationLog, computeMetrics, computeTypeDistribution, enrichHealth, formatBytes, formatUptime, toD3ForceFormat, toGraphologyFormat, transformGraphData, unreachableHealth };
+export { type ConsolidationAnalytics, type ConsolidationLogEntry, type D3ForceData, type D3ForceLink, type D3ForceNode, DashboardClient, type EntryFilters, type GraphVizData, type GraphVizEdge, type GraphVizNode, type GraphologyData, type GraphologyEdge, type GraphologyNode, type HealthData, type HookResult, type MemoryMetrics, type PaginatedEntries, Poller, type PollerOptions, type PollerState, type RawHealthResponse, type SubgraphResponse, type TransformOptions, type TypeDistribution, analyzeConsolidationLog, computeMetrics, computeTypeDistribution, enrichHealth, formatBytes, formatUptime, toD3ForceFormat, toGraphologyFormat, transformGraphData, unreachableHealth };

package/dist/dashboard.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-KQV3VYZO.mjs";
-import "./chunk-C2KBUNUM.mjs";
+} from "./chunk-DEMDFWI4.mjs";
+import "./chunk-EXUSQ2GR.mjs";
 import "./chunk-KSTI4M52.mjs";
 export {
   DashboardClient,

package/dist/index.d.ts

@@ -554,6 +554,15 @@ interface MemorySearchParams {
     eventTimeRange?: [string, string];
     /** Filter results to entries ingested before this cutoff (ISO 8601). Falls back to createdAt when ingestTime is null. */
     asOf?: string;
+    /**
+     * Soft recency ANCHOR (ISO 8601) — never a filter. Candidates are ranked by
+     * proximity to this time instead of now, and conflicting assertions
+     * re-order around it. Resolving relative-time expressions ("two months
+     * ago", "3년 전") to an absolute timestamp is the CALLER's side of the
+     * agentic contract — language understanding never enters the engine. Wins
+     * over the query-text year parse (hybrid strategy).
+     */
+    anchorTime?: string;
     /** Confidence threshold below which the system recommends abstention (0.0–1.0). Default: 0.3. */
     abstentionThreshold?: number;
     /**

package/dist/index.mjs

@@ -1,7 +1,7 @@
 import {
   MemoryClient,
   MemoryServerError
-} from "./chunk-C2KBUNUM.mjs";
+} from "./chunk-EXUSQ2GR.mjs";
 import {
   DEFAULTS,
   DEPRECATED_RAG_STRATEGIES,

package/dist/react.d.ts

@@ -1,5 +1,5 @@
 import { HookResult, ConsolidationAnalytics, TransformOptions, GraphVizData, EntryFilters, PaginatedEntries, HealthData, TypeDistribution } from './dashboard.js';
-export { ConsolidationLogEntry, D3ForceData, D3ForceLink, D3ForceNode, DashboardClient, GraphVizEdge, GraphVizNode, GraphologyData, GraphologyEdge, GraphologyNode, MemoryMetrics, Poller, PollerOptions, PollerState, RawHealthResponse, analyzeConsolidationLog, computeMetrics, computeTypeDistribution, enrichHealth, formatBytes, formatUptime, toD3ForceFormat, toGraphologyFormat, transformGraphData, unreachableHealth } from './dashboard.js';
+export { ConsolidationLogEntry, D3ForceData, D3ForceLink, D3ForceNode, DashboardClient, GraphVizEdge, GraphVizNode, GraphologyData, GraphologyEdge, GraphologyNode, MemoryMetrics, Poller, PollerOptions, PollerState, RawHealthResponse, SubgraphResponse, analyzeConsolidationLog, computeMetrics, computeTypeDistribution, enrichHealth, formatBytes, formatUptime, toD3ForceFormat, toGraphologyFormat, transformGraphData, unreachableHealth } from './dashboard.js';
 import { MemoryStats } from '@pyx-memory/shared';
 import '@pyx-memory/client';
 
@@ -7,8 +7,16 @@ declare function useConsolidationLog(serverUrl: string, limit?: number, interval
 
 interface UseKnowledgeGraphOptions extends TransformOptions {
     intervalMs?: number;
-    limit?: number;
+    /** Edge render budget forwarded to the subgraph endpoint (server caps at 10k). */
+    edges?: number;
 }
+/**
+ * Polls the coherent subgraph (server ≥0.34): every relationship arrives with
+ * both endpoint nodes hydrated, so no link is dropped for a missing endpoint.
+ * nodeCount/edgeCount/nodeTypes report true store totals — including isolated
+ * entities the connected projection doesn't render — while nodes/edges are the
+ * rendered projection.
+ */
 declare function useKnowledgeGraph(serverUrl: string, opts?: UseKnowledgeGraphOptions): HookResult<GraphVizData>;
 
 declare function useMemoryEntries(serverUrl: string, filters?: EntryFilters, intervalMs?: number): HookResult<PaginatedEntries>;

package/dist/react.mjs

@@ -11,8 +11,8 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-KQV3VYZO.mjs";
-import "./chunk-C2KBUNUM.mjs";
+} from "./chunk-DEMDFWI4.mjs";
+import "./chunk-EXUSQ2GR.mjs";
 import "./chunk-KSTI4M52.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts
@@ -75,16 +75,22 @@ function useConsolidationLog(serverUrl, limit = 20, intervalMs = DEFAULT_POLL_IN
 // ../dashboard/src/hooks/use-knowledge-graph.ts
 import { useCallback as useCallback3, useMemo as useMemo2 } from "react";
 function useKnowledgeGraph(serverUrl, opts = {}) {
-  const { intervalMs = DEFAULT_POLL_INTERVAL_MS, limit = 50, minWeight, maxNodes } = opts;
+  const { intervalMs = DEFAULT_POLL_INTERVAL_MS, edges, minWeight, maxNodes } = opts;
   const client = useMemo2(() => new DashboardClient(serverUrl), [serverUrl]);
   const stableTransformOpts = useMemo2(
     () => ({ minWeight, maxNodes }),
     [minWeight, maxNodes]
   );
   const fetcher = useCallback3(async () => {
-    const { nodes, relationships } = await client.graphFull(limit);
-    return transformGraphData(nodes, relationships, stableTransformOpts);
-  }, [client, limit, stableTransformOpts]);
+    const subgraph = await client.graphSubgraph(edges);
+    const viz = transformGraphData(subgraph.nodes, subgraph.relationships, stableTransformOpts);
+    return {
+      ...viz,
+      nodeCount: subgraph.totalNodes,
+      edgeCount: subgraph.totalEdges,
+      nodeTypes: subgraph.categoryTotals
+    };
+  }, [client, edges, stableTransformOpts]);
   return usePolling(fetcher, { intervalMs });
 }
 

package/package.json

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