@pyxmate/memory 1.13.0 → 1.15.0

package/dist/agent-contract.mjs

@@ -13,7 +13,7 @@ import {
   buildAgentSnippet,
   buildDesignGuide,
   buildGraphStructuringPrompt
-} from "./chunk-OUSGU272.mjs";
+} from "./chunk-3BTAAGMM.mjs";
 export {
   AGENT_TARGETS,
   PERSISTENT_MEMORY_SECTION,

package/dist/{chunk-OUSGU272.mjs → chunk-3BTAAGMM.mjs}

@@ -12,33 +12,34 @@ var PERSISTENT_MEMORY_SECTION = [
   "- When the user references prior work, search for it.",
   "- When investigating a bug, search for prior occurrences and fixes.",
   '- When a question names a time \u2014 explicit or relative ("last year") \u2014 resolve it to an absolute ISO-8601 timestamp and pass it as search `anchorTime`: results rank by proximity to that time (soft \u2014 never excludes).',
-  "- Match search `effort` to risk: use `quick` for routine recall; use `deep` when quick returns nothing, prior state may be archived/superseded, or full history matters.",
+  "- Match search `effort` to risk: use `quick` for routine recall; use `deep` when quick returns nothing, state may be superseded, or full history matters.",
   "- For count/list questions pass `enumerationConcept` (the category phrase, any language); for Korean/cross-lingual recall add `enableRerank: true` (hybrid-only, slower).",
-  '- To trace how a fact changed ("what did X use before Y", how it evolved), call `lineage` with `subject` + `relation` or an `entryId` instead of stitching together searches.',
+  '- To trace how a fact changed ("what did X use before Y"), call `lineage` with `subject` + `relation` or an `entryId` instead of stitching together searches.',
+  "- When answering about current goals, priorities, or active work: treat explicitly completed or closed items as no longer active; when one goal explicitly replaces another, act on the replacement; goals stated to run concurrently stay active until each is individually completed or replaced; choose priorities only among still-active goals.",
   "- Recalled memories reflect what was true when written \u2014 verify named files, functions, flags, and versions before acting.",
   "",
   "Reinforce and correct:",
   "",
-  "- After a retrieved memory actually informs your work (you cited it or acted on it), call `reinforce` on that memory. Recall keeps useful memories in the `quick`/`medium` tiers.",
-  "- When the user corrects a mistake, call `record_correction` with what was wrong, what to do instead, and when it applies.",
-  "- Before starting a task, call `fetch_applicable_corrections` with the task shape; pyx never auto-applies them, so decide which corrections fit.",
+  "- After a retrieved memory actually informs your work (you cited it or acted on it), call `reinforce` on that memory.",
+  "- When corrected, call `record_correction` with what was wrong, the replacement, when it applies, and service/file identifiers in `appliesWhen`; identifier overlap enables cross-phrase/language recall.",
+  "- Before starting a task, call `fetch_applicable_corrections` with the task shape (name identifiers); pyx never auto-applies them, so decide which corrections fit.",
   "",
-  "Store when durable state settles \u2014 usually before a final response/handoff. Treat it as a check, not automatic: if nothing durable changed, store nothing. When it did, capture only:",
+  "Store when durable state settles, usually before a final response/handoff; if nothing durable changed, store nothing. Capture:",
   "",
-  '- Facts (default) \u2014 corrections/preferences; bug fixes with root cause and fix; architecture/design decisions with reasoning; integration/API/auth/endpoint details; gotchas with what broke and the fix; explicit "remember this" requests. One fact per memory.',
+  '- Facts (default) \u2014 one correction/preference, root-cause fix, reasoned design decision, integration detail, gotcha, or explicit "remember this" request per memory.',
   "- Process (`type: long-term`) \u2014 a reusable workflow, convention, or playbook a fresh session should follow. Store it once stabilized or adopted.",
   "- Trajectory (`type: episodic`) \u2014 only at a real milestone, handoff, or user-requested checkpoint: one dated snapshot of what changed, where it stands, and the open frontier. Not a running log.",
-  "- Evolution \u2014 when a prior fact or decision changes, store the new state with its `eventTime` rather than overwriting the old one, so `lineage` can trace how and why it evolved. Route explicit corrections through `record_correction`.",
+  "- Evolution \u2014 when a prior fact or decision changes, store the new state with its `eventTime` rather than overwriting the old one, so `lineage` can trace how and why it evolved.",
   "",
   "Memory rules:",
   "",
   "- Always include `topic` and `project`.",
   "- Store concise facts and decisions, not deliberation.",
   "- Keep one memory per concept; do not bundle unrelated facts.",
-  "- Do not store ephemeral file contents, raw logs, or step-by-step progress. Aggregate high-frequency streams into the dated fact or summary they support (with `eventTime`), never one memory or graph node per sample.",
+  "- Do not store ephemeral files, raw logs, or progress. Aggregate high-frequency streams into a dated fact/summary with `eventTime`; never one memory or graph node per sample.",
   '- Pass `eventTime` (ISO-8601, when the fact happened or took effect) for facts that can change or go stale. Recency ordering, dated ("as of") queries, and stale-vs-current resolution key off it.',
-  "- Graph is a retrieval structure. When content names people, organizations, tools, places, events, or key concepts, pass `entities` and `relationships` when you can (caller-wins). For multi-entity stores, connect them with at least one relationship, or use `triples`. Relationships matter as much as entities. Entity-free memories are valid.",
-  '- Use specific durable entities. Never create a catch-all hub node ("me", "health") linked to everything; mega-hubs degrade traversal. Bounded `IS_A` category nodes are the exception.',
+  "- Graph is for retrieval. For named people, organizations, tools, places, events, or concepts, pass `entities` + `relationships` (caller-wins); connect multi-entity stores with a relationship or `triples`. Relationships matter as much as entities. Entity-free memories are valid.",
+  '- Use specific durable entities, never catch-all hubs ("me", "health"); bounded `IS_A` categories are the exception.',
   '- For countable categories the user may later enumerate, add a canonical category `CONCEPT` node and an `IS_A` edge from each member to it (`"yoga"` IS_A `"fitness classes"`).',
   "- Taxonomy: when a store response reports unnamed clusters, call get_taxonomy_state and name each via name_cluster (short, domain-true, user's language); rename only when composition clearly changed.",
   "- Ingest documents/images only when they are worth persisting; images require a short description so they are searchable.",

package/dist/{chunk-HOBDPIHO.mjs → chunk-3FRA37TI.mjs}

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

package/dist/chunk-A3L46P2G.mjs

@@ -0,0 +1,57 @@
+// ../shared/src/graph/extraction.ts
+function normalizeGraphLabel(value, fallback) {
+  const normalized = value.trim().toUpperCase().replace(/[^A-Z0-9]+/g, "_").replace(/^_+|_+$/g, "");
+  return normalized.length > 0 ? normalized : fallback;
+}
+function normalizeNameKey(name) {
+  return name.trim().toLowerCase().replace(/\s+/g, " ");
+}
+function relationshipKey(relationship) {
+  return [
+    relationship.source.trim().toLowerCase(),
+    relationship.target.trim().toLowerCase(),
+    normalizeGraphLabel(relationship.type, "RELATED_TO")
+  ].join("\0");
+}
+function mergeExtractedEntities(callerEntities, callerRelationships, extracted) {
+  const entities = [...callerEntities ?? []];
+  const relationships = [...callerRelationships ?? []];
+  const nameByLowercase = /* @__PURE__ */ new Map();
+  for (const entity of entities) {
+    const key = entity.name.toLowerCase();
+    if (!nameByLowercase.has(key)) nameByLowercase.set(key, entity.name);
+  }
+  for (const entity of extracted.entities) {
+    const key = entity.name.toLowerCase();
+    if (nameByLowercase.has(key)) continue;
+    entities.push({ ...entity, type: normalizeGraphLabel(entity.type, "CONCEPT") });
+    nameByLowercase.set(key, entity.name);
+  }
+  for (const relationship of extracted.relations) {
+    const source = nameByLowercase.get(relationship.source.toLowerCase());
+    const target = nameByLowercase.get(relationship.target.toLowerCase());
+    if (source && target) {
+      relationships.push({
+        ...relationship,
+        source,
+        target,
+        type: normalizeGraphLabel(relationship.type, "RELATED_TO")
+      });
+    }
+  }
+  const seenRelationships = /* @__PURE__ */ new Set();
+  const dedupedRelationships = [];
+  for (const relationship of relationships) {
+    const key = relationshipKey(relationship);
+    if (seenRelationships.has(key)) continue;
+    seenRelationships.add(key);
+    dedupedRelationships.push(relationship);
+  }
+  return { entities, relationships: dedupedRelationships };
+}
+
+export {
+  normalizeGraphLabel,
+  normalizeNameKey,
+  mergeExtractedEntities
+};

package/dist/{chunk-5BLT7RSY.mjs → chunk-IEBF7BQF.mjs}

@@ -1,3 +1,7 @@
+import {
+  mergeExtractedEntities
+} from "./chunk-A3L46P2G.mjs";
+
 // ../shared/src/constants/defaults.ts
 var DEFAULTS = {
   DATA_DIR: "./data",
@@ -6,58 +10,6 @@ var DEFAULTS = {
 };
 var TAXONOMY_MAX_CATEGORIES = 10;
 
-// ../shared/src/graph/extraction.ts
-function normalizeGraphLabel(value, fallback) {
-  const normalized = value.trim().toUpperCase().replace(/[^A-Z0-9]+/g, "_").replace(/^_+|_+$/g, "");
-  return normalized.length > 0 ? normalized : fallback;
-}
-function normalizeNameKey(name) {
-  return name.trim().toLowerCase().replace(/\s+/g, " ");
-}
-function relationshipKey(relationship) {
-  return [
-    relationship.source.trim().toLowerCase(),
-    relationship.target.trim().toLowerCase(),
-    normalizeGraphLabel(relationship.type, "RELATED_TO")
-  ].join("\0");
-}
-function mergeExtractedEntities(callerEntities, callerRelationships, extracted) {
-  const entities = [...callerEntities ?? []];
-  const relationships = [...callerRelationships ?? []];
-  const nameByLowercase = /* @__PURE__ */ new Map();
-  for (const entity of entities) {
-    const key = entity.name.toLowerCase();
-    if (!nameByLowercase.has(key)) nameByLowercase.set(key, entity.name);
-  }
-  for (const entity of extracted.entities) {
-    const key = entity.name.toLowerCase();
-    if (nameByLowercase.has(key)) continue;
-    entities.push({ ...entity, type: normalizeGraphLabel(entity.type, "CONCEPT") });
-    nameByLowercase.set(key, entity.name);
-  }
-  for (const relationship of extracted.relations) {
-    const source = nameByLowercase.get(relationship.source.toLowerCase());
-    const target = nameByLowercase.get(relationship.target.toLowerCase());
-    if (source && target) {
-      relationships.push({
-        ...relationship,
-        source,
-        target,
-        type: normalizeGraphLabel(relationship.type, "RELATED_TO")
-      });
-    }
-  }
-  const seenRelationships = /* @__PURE__ */ new Set();
-  const dedupedRelationships = [];
-  for (const relationship of relationships) {
-    const key = relationshipKey(relationship);
-    if (seenRelationships.has(key)) continue;
-    seenRelationships.add(key);
-    dedupedRelationships.push(relationship);
-  }
-  return { entities, relationships: dedupedRelationships };
-}
-
 // ../shared/src/types/isolation.ts
 var NamespaceIsolation = {
   SHARED: "shared",
@@ -230,6 +182,15 @@ var MemoryClient = class {
   encodePathSegment(segment) {
     return encodeURIComponent(segment);
   }
+  authorityHeaders(options) {
+    if (!options) return {};
+    const key = options.idempotencyKey;
+    if (key === void 0) return {};
+    if (typeof key !== "string" || key.length === 0 || !key.isWellFormed() || new TextEncoder().encode(key).byteLength > 256) {
+      throw new Error("idempotencyKey must be 1-256 well-formed UTF-8 bytes");
+    }
+    return { "Idempotency-Key": key };
+  }
   async initialize() {
     const response = await fetch(`${this.baseUrl}/health`, {
       headers: this._authHeaders
@@ -259,10 +220,11 @@ var MemoryClient = class {
     return this.fetchApi("/api/memory/ingest", {
       method: "POST",
       body: JSON.stringify(payload),
+      headers: this.authorityHeaders(options),
       ...options?.signal ? { signal: options.signal } : {}
     });
   }
-  async search(params) {
+  async search(params, authority) {
     if (params.enableMultiHop) {
       throw new Error(
         "enableMultiHop is embedded-only (the HTTP API does not forward it); use the embedded Memory class for iterative multi-hop retrieval"
@@ -285,20 +247,25 @@ var MemoryClient = class {
     if (enumerationConcept) searchParams.set("enumerationConcept", enumerationConcept);
     if (params.abstentionThreshold != null)
       searchParams.set("abstentionThreshold", String(params.abstentionThreshold));
-    return this.fetchApi(`/api/memory/search?${searchParams}`);
+    return this.fetchApi(`/api/memory/search?${searchParams}`, {
+      headers: this.authorityHeaders(authority)
+    });
   }
-  async get(id) {
+  async get(id, authority) {
     try {
-      return await this.fetchApi(`/api/memory/entries/${this.encodePathSegment(id)}`);
+      return await this.fetchApi(`/api/memory/entries/${this.encodePathSegment(id)}`, {
+        headers: this.authorityHeaders(authority)
+      });
     } catch (error) {
       if (error instanceof MemoryServerError && error.isNotFound) return null;
       throw error;
     }
   }
-  async delete(id) {
+  async delete(id, authority) {
     try {
       await this.fetchApi(`/api/memory/entries/${this.encodePathSegment(id)}`, {
-        method: "DELETE"
+        method: "DELETE",
+        headers: this.authorityHeaders(authority)
       });
       return true;
     } catch (error) {
@@ -334,7 +301,7 @@ var MemoryClient = class {
   }
   async shutdown() {
   }
-  async list(params = {}) {
+  async list(params = {}, authority) {
     const searchParams = new URLSearchParams();
     if (params.page != null) searchParams.set("page", String(params.page));
     if (params.limit != null) searchParams.set("limit", String(params.limit));
@@ -344,7 +311,9 @@ var MemoryClient = class {
       searchParams.set("includeKinds", params.includeKinds.join(","));
     }
     const qs = searchParams.toString();
-    return this.fetchApi(`/api/memory/entries${qs ? `?${qs}` : ""}`);
+    return this.fetchApi(`/api/memory/entries${qs ? `?${qs}` : ""}`, {
+      headers: this.authorityHeaders(authority)
+    });
   }
   // --- File ingest ---
   /**
@@ -805,7 +774,7 @@ var MemoryClient = class {
     );
     return result.entries;
   }
-  async lineage(params) {
+  async lineage(params, authority) {
     const searchParams = new URLSearchParams();
     if (params.subject) searchParams.set("subject", params.subject);
     if (params.relation) searchParams.set("relation", params.relation);
@@ -818,12 +787,15 @@ var MemoryClient = class {
       searchParams.set("eventTimeEnd", params.eventTimeRange[1]);
     }
     const qs = searchParams.toString();
-    return this.fetchApi(`/api/memory/lineage${qs ? `?${qs}` : ""}`);
+    return this.fetchApi(`/api/memory/lineage${qs ? `?${qs}` : ""}`, {
+      headers: this.authorityHeaders(authority)
+    });
   }
-  async reinforce(params) {
+  async reinforce(params, authority) {
     return this.fetchApi("/api/memory/reinforce", {
       method: "POST",
-      body: JSON.stringify(params)
+      body: JSON.stringify(params),
+      headers: this.authorityHeaders(authority)
     });
   }
   async log(filters = {}) {
@@ -915,6 +887,18 @@ var MemoryClient = class {
     if (input.limit !== void 0) params.set("limit", String(input.limit));
     return this.fetchApi(`/api/memory/corrections?${params}`);
   }
+  /**
+   * H26 B-d — deterministic prospective due-scan: entries with
+   * `eventTime ∈ [from, from+windowDays]` (inclusive), eventTime ascending,
+   * no relevance ranking. `GET /api/memory/due`.
+   */
+  async dueScan(input) {
+    const params = new URLSearchParams({ windowDays: String(input.windowDays) });
+    if (input.from) params.set("from", input.from);
+    if (input.namespaceId) params.set("namespaceId", input.namespaceId);
+    if (input.limit !== void 0) params.set("limit", String(input.limit));
+    return this.fetchApi(`/api/memory/due?${params}`);
+  }
   async fetchApi(path, options) {
     const signal = options?.signal ?? AbortSignal.timeout(this._requestTimeoutMs);
     let res;
@@ -975,9 +959,6 @@ var MemoryClient = class {
 export {
   DEFAULTS,
   TAXONOMY_MAX_CATEGORIES,
-  normalizeGraphLabel,
-  normalizeNameKey,
-  mergeExtractedEntities,
   NamespaceIsolation,
   MemoryType,
   SensitivityLevel,

package/dist/cli/pyx-mem.mjs

@@ -2,7 +2,7 @@
 import {
   PERSISTENT_MEMORY_SECTION,
   buildDesignGuide
-} from "../chunk-OUSGU272.mjs";
+} from "../chunk-3BTAAGMM.mjs";
 
 // src/cli/exit-codes.ts
 var EXIT = {
@@ -551,6 +551,7 @@ function createReadCredentials(providerFactory) {
 }
 
 // src/mcp/proxy-server.ts
+import { createHash, randomUUID } from "crypto";
 import { readFile, stat } from "fs/promises";
 import { basename, isAbsolute, resolve } from "path";
 import { Client as McpClient } from "@modelcontextprotocol/sdk/client/index.js";
@@ -566,6 +567,12 @@ import {
 
 // src/mcp/http-client.ts
 var DEFAULT_TIMEOUT_MS = 15e3;
+function validateIdempotencyKey(key) {
+  if (key.length === 0 || !key.isWellFormed() || new TextEncoder().encode(key).byteLength > 256) {
+    throw new Error("idempotencyKey must be 1-256 well-formed UTF-8 bytes");
+  }
+  return key;
+}
 function createHttpClient(credentials, fetchImpl = fetch) {
   const baseUrl = credentials.endpoint.replace(/\/+$/, "");
   function buildUrl(path, query) {
@@ -578,7 +585,7 @@ function createHttpClient(credentials, fetchImpl = fetch) {
     }
     return url.toString();
   }
-  function buildHeaders(scope, contentType) {
+  function buildHeaders(scope, contentType, idempotencyKey) {
     const headers = new Headers();
     headers.set("Authorization", `Bearer ${credentials.apiKey}`);
     headers.set("Accept", "application/json");
@@ -587,6 +594,9 @@ function createHttpClient(credentials, fetchImpl = fetch) {
     if (scope?.userId) headers.set("X-User-Id", scope.userId);
     if (scope?.teamId) headers.set("X-Team-Id", scope.teamId);
     if (scope?.callerAccessLevel) headers.set("X-Caller-Access-Level", scope.callerAccessLevel);
+    if (idempotencyKey !== void 0) {
+      headers.set("Idempotency-Key", validateIdempotencyKey(idempotencyKey));
+    }
     return headers;
   }
   async function send(url, method, headers, body) {
@@ -613,12 +623,16 @@ function createHttpClient(credentials, fetchImpl = fetch) {
     async requestJson(input) {
       const url = buildUrl(input.path, input.query);
       const hasBody = input.body !== void 0;
-      const headers = buildHeaders(input.scope, hasBody ? "application/json" : void 0);
+      const headers = buildHeaders(
+        input.scope,
+        hasBody ? "application/json" : void 0,
+        input.idempotencyKey
+      );
       return send(url, input.method, headers, hasBody ? JSON.stringify(input.body) : void 0);
     },
     async requestMultipart(input) {
       const url = buildUrl(input.path);
-      const headers = buildHeaders(input.scope);
+      const headers = buildHeaders(input.scope, void 0, input.idempotencyKey);
       const form = await input.formData();
       return send(url, "POST", headers, form);
     }
@@ -673,6 +687,23 @@ var LOCAL_UPLOAD_META_KEY = "pyx.dev/local-upload";
 
 // src/mcp/proxy-server.ts
 var REMOTE_MCP_PATH = "/mcp";
+function createMcpIdempotentFetch(fetchImpl = fetch, sessionNonce = randomUUID()) {
+  const wrapped = async (input, init) => {
+    const upstream = input instanceof Request ? input : new Request(String(input), init);
+    const method = init?.method ?? upstream.method;
+    const body = init?.body ?? (input instanceof Request ? await input.clone().text() : void 0);
+    const headers = new Headers(init?.headers ?? upstream.headers);
+    if (method.toUpperCase() === "POST" && !headers.has("Idempotency-Key")) {
+      if (typeof body !== "string") {
+        throw new Error("remote MCP POST body must be text for stable request idempotency");
+      }
+      const key = createHash("sha256").update("pyx-mcp-idempotency-v1\0").update(sessionNonce).update("\0").update(body).digest("hex");
+      headers.set("Idempotency-Key", `mcp-${key}`);
+    }
+    return fetchImpl(input, { ...init, method, headers, body });
+  };
+  return Object.assign(wrapped, { preconnect: fetch.preconnect });
+}
 function extractLocalUpload(meta) {
   if (meta === null || typeof meta !== "object") return void 0;
   const descriptor = meta[LOCAL_UPLOAD_META_KEY];
@@ -798,7 +829,7 @@ function createProxyServer(client, version, uploadLocalFile) {
   return server;
 }
 async function runMcpProxyServer(opts) {
-  const version = opts.version ?? (true ? "1.13.0" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "1.15.0" : "0.0.0-dev");
   const read = await opts.readCredentials();
   if (!read.ok) {
     const text = read.result.content.map((c) => c.type === "text" ? c.text : "").join(" ").trim();
@@ -808,7 +839,8 @@ async function runMcpProxyServer(opts) {
   const url = new URL(`${endpoint.replace(/\/+$/, "")}${REMOTE_MCP_PATH}`);
   const client = new McpClient({ name: "pyx-mem-proxy", version }, { capabilities: {} });
   const clientTransport = new StreamableHTTPClientTransport(url, {
-    requestInit: { headers: { Authorization: `Bearer ${apiKey}` } }
+    requestInit: { headers: { Authorization: `Bearer ${apiKey}` } },
+    fetch: createMcpIdempotentFetch()
   });
   try {
     await client.connect(clientTransport);

package/dist/dashboard.mjs

@@ -11,8 +11,9 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-HOBDPIHO.mjs";
-import "./chunk-5BLT7RSY.mjs";
+} from "./chunk-3FRA37TI.mjs";
+import "./chunk-IEBF7BQF.mjs";
+import "./chunk-A3L46P2G.mjs";
 export {
   DashboardClient,
   Poller,