@pyxmate/memory 1.31.0 → 1.32.0

package/dist/{chunk-M67SXB7C.mjs → chunk-F2G2TBLW.mjs}

@@ -2,7 +2,7 @@ import {
   RAGStrategy,
   assertGraphExtractionPayload,
   mergeExtractedEntities
-} from "./chunk-HTQBKJTD.mjs";
+} from "./chunk-MD5RCZCA.mjs";
 
 // ../client/src/disabled-memory.ts
 var DEFAULT_PAGE_LIMIT = 20;
@@ -405,6 +405,9 @@ var MemoryClient = class {
       const formData = new FormData();
       formData.append("file", file);
       if (options?.description) formData.append("description", options.description);
+      if (options?.agentId !== void 0) formData.append("agentId", options.agentId);
+      if (options?.metadata !== void 0)
+        formData.append("metadata", JSON.stringify(options.metadata));
       if (options?.namespaceId) formData.append("namespaceId", options.namespaceId);
       if (options?.documentKey !== void 0) {
         formData.append("documentKey", options.documentKey);

package/dist/{chunk-HTQBKJTD.mjs → chunk-MD5RCZCA.mjs}

@@ -473,14 +473,24 @@ function normalizeLog(input, defaultAgentId) {
 }
 function normalizeCorrectionRecord(input, defaultAgentId) {
   const value = requireObject(input, "input");
-  const keys = ["whatWasWrong", "whatToDoInstead", "appliesWhen", "project", "taskShape"];
+  const keys = [
+    "whatWasWrong",
+    "whatToDoInstead",
+    "appliesWhen",
+    "project",
+    "taskShape",
+    "agentId",
+    "metadata"
+  ];
   requireExactKeys(value, keys, "input");
   const normalized = {
     whatWasWrong: requireString(value.whatWasWrong, "input.whatWasWrong"),
     whatToDoInstead: requireString(value.whatToDoInstead, "input.whatToDoInstead"),
     appliesWhen: requireString(value.appliesWhen, "input.appliesWhen")
   };
-  withOptional(normalized, "agentId", defaultAgentId ?? void 0);
+  const attribution = normalizeMemoryAttribution(value);
+  withOptional(normalized, "agentId", attribution.agentId ?? defaultAgentId ?? void 0);
+  withOptional(normalized, "metadata", attribution.metadata);
   withOptional(normalized, "project", optionalNonemptyString(value.project, "input.project"));
   withOptional(normalized, "taskShape", optionalNonemptyString(value.taskShape, "input.taskShape"));
   return normalized;
@@ -777,6 +787,25 @@ function normalizeGraphRelationships(value) {
   });
 }
 var MCP_SERVER_OWNED_METADATA_KEYS = ["source", "topic", "project", "_kind"];
+var MEMORY_ATTRIBUTION_MAX_BYTES = 1024;
+function normalizeMemoryAttribution(value) {
+  const attribution = {};
+  const agentId = optionalNonemptyString(value.agentId, "input.agentId");
+  if (agentId !== void 0) attribution.agentId = agentId;
+  if (value.metadata !== void 0) {
+    const caller = requireObject(value.metadata, "input.metadata");
+    for (const key of Object.keys(caller)) {
+      if (key.startsWith("_") || MCP_SERVER_OWNED_METADATA_KEYS.some((owned) => owned === key)) {
+        throw new Error(`input.metadata.${key} is server-owned and cannot be caller-supplied`);
+      }
+    }
+    attribution.metadata = canonicalValue(caller, "input.metadata");
+  }
+  if (Buffer.byteLength(canonicalDataPlaneJson(attribution), "utf8") > MEMORY_ATTRIBUTION_MAX_BYTES) {
+    throw new Error(`input attribution exceeds ${MEMORY_ATTRIBUTION_MAX_BYTES} UTF-8 bytes`);
+  }
+  return attribution;
+}
 function normalizeMcpStoreMetadata(value) {
   const serverOwned = {
     source: "agent",
@@ -987,7 +1016,11 @@ function requireHostedFileIngestFilename(value, field) {
 }
 function normalizeFileIngestBegin(input) {
   const value = requireObject(input, "input");
-  requireExactKeys(value, ["jobId", "filename", "byteLength", "sha256", "description"], "input");
+  requireExactKeys(
+    value,
+    ["jobId", "filename", "byteLength", "sha256", "description", "agentId", "metadata"],
+    "input"
+  );
   const normalized = {
     jobId: requireHostedFileIngestJobId(value.jobId, "input.jobId"),
     filename: requireHostedFileIngestFilename(value.filename, "input.filename"),
@@ -1000,7 +1033,7 @@ function normalizeFileIngestBegin(input) {
     sha256: requireSha256Hex(value.sha256, "input.sha256")
   };
   withOptional(normalized, "description", optionalString(value.description, "input.description"));
-  return normalized;
+  return { ...normalized, ...normalizeMemoryAttribution(value) };
 }
 function normalizeFileIngestJob(input) {
   const value = requireObject(input, "input");
@@ -1940,6 +1973,7 @@ export {
   DATA_PLANE_OPERATION_COVERAGE,
   encodeListCursorToken,
   parseListCursorToken,
+  normalizeMemoryAttribution,
   requireHostedFileIngestFilename,
   normalizeHostedFileIngestPageDescriptor,
   canonicalDataPlaneJson,

package/dist/{chunk-N4KDRRLY.mjs → chunk-UIR5VDPF.mjs}

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

package/dist/cli/pyx-mem.mjs

@@ -144,7 +144,7 @@ async function runMcpInstall(target, scope, remote, noRules) {
 }
 async function runMcpCommand(parsed) {
   if (parsed.subcommand === void 0) {
-    const { mcpCommand, resolveMcpMode } = await import("../mcp-OPC3BV7H.mjs");
+    const { mcpCommand, resolveMcpMode } = await import("../mcp-HZDRKZWE.mjs");
     const resolved = resolveMcpMode({
       remote: parsed.flags.remote === true,
       bundled: parsed.flags.bundled === true
@@ -249,7 +249,7 @@ async function main() {
         process.stderr.write("Error: `pyx-mem insights` requires --json.\n");
         return EXIT.USAGE;
       }
-      const { insightsCommand } = await import("../insights-PD7Y6QDX.mjs");
+      const { insightsCommand } = await import("../insights-E7USP2C5.mjs");
       return insightsCommand({
         withIdentity: parsed.flags["with-identity"] === true,
         withProvenance: parsed.flags["with-provenance"] === true
@@ -260,7 +260,7 @@ async function main() {
         process.stderr.write("Error: `pyx-mem taxonomy` requires --json.\n");
         return EXIT.USAGE;
       }
-      const { taxonomyCommand } = await import("../taxonomy-EKDFDFXW.mjs");
+      const { taxonomyCommand } = await import("../taxonomy-65DFVGRY.mjs");
       return taxonomyCommand({ withIdentity: parsed.flags["with-identity"] === true });
     }
     case "logout": {

package/dist/dashboard.mjs

@@ -11,10 +11,10 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-N4KDRRLY.mjs";
-import "./chunk-M67SXB7C.mjs";
+} from "./chunk-UIR5VDPF.mjs";
+import "./chunk-F2G2TBLW.mjs";
 import "./chunk-RWQTBXUC.mjs";
-import "./chunk-HTQBKJTD.mjs";
+import "./chunk-MD5RCZCA.mjs";
 export {
   DashboardClient,
   Poller,

package/dist/data-plane-contract.mjs

@@ -27,7 +27,7 @@ import {
   parseHostedFileIngestJobView,
   parseHostedFileIngestPublishResult,
   requireHostedFileIngestFilename
-} from "./chunk-HTQBKJTD.mjs";
+} from "./chunk-MD5RCZCA.mjs";
 export {
   DATA_PLANE_CATALOG_VERSION,
   DATA_PLANE_COMPILER_LIMITS,

package/dist/index.d.ts

@@ -602,6 +602,8 @@ interface CorrectionInput {
     taskShape?: string;
     /** Optional agent id; defaults to the Memory instance's `agentId`. */
     agentId?: string;
+    /** Caller audit metadata; server-owned keys cannot be supplied over REST/MCP. */
+    metadata?: Record<string, unknown>;
 }
 /** Input to `Memory.fetchApplicableCorrections`. */
 interface FetchCorrectionsInput {
@@ -1155,6 +1157,9 @@ interface EnrichmentCallbacks {
  * (server v0.17.4+; required when `requireNamespaceForTenantWrites=true`).
  */
 interface IngestFileOptions {
+    /** Audit attribution frozen for this ingest and its enrichment callbacks. */
+    agentId?: string;
+    metadata?: Record<string, unknown>;
     description?: string;
     enrichment?: EnrichmentCallbacks;
     signal?: AbortSignal;
@@ -1479,6 +1484,8 @@ declare class MemoryClient implements ExtendedMemoryInterface {
         appliesWhen: string;
         project?: string;
         taskShape?: string;
+        agentId?: string;
+        metadata?: Record<string, unknown>;
     }): Promise<{
         id: string;
         createdAt: string;

package/dist/index.mjs

@@ -2,7 +2,7 @@ import {
   DisabledMemory,
   MemoryClient,
   MemoryServerError
-} from "./chunk-M67SXB7C.mjs";
+} from "./chunk-F2G2TBLW.mjs";
 import {
   DEFAULTS,
   MCP_ACTOR_META_KEY,
@@ -40,7 +40,7 @@ import {
   normalizeGraphLabel,
   normalizeNameKey,
   parseListCursorToken
-} from "./chunk-HTQBKJTD.mjs";
+} from "./chunk-MD5RCZCA.mjs";
 
 // src/preset.ts
 var DEFAULT_MEMORY_URL = `http://localhost:${DEFAULTS.MEMORY_SERVER_PORT}`;

package/dist/{insights-PD7Y6QDX.mjs → insights-E7USP2C5.mjs}

@@ -8,7 +8,7 @@ import {
   TAXONOMY_MAX_PROJECTS,
   normalizeMemoryActorLabel
 } from "./chunk-RWQTBXUC.mjs";
-import "./chunk-HTQBKJTD.mjs";
+import "./chunk-MD5RCZCA.mjs";
 import {
   EXIT
 } from "./chunk-4DXEQC6X.mjs";

package/dist/{mcp-OPC3BV7H.mjs → mcp-HZDRKZWE.mjs}

@@ -19,12 +19,13 @@ import {
 import {
   HOSTED_FILE_INGEST_PROTOCOL,
   HOSTED_FILE_INGEST_RETRYABLE_CODES,
+  normalizeMemoryAttribution,
   parseHostedFileIngestAuthorization,
   parseHostedFileIngestCommitResult,
   parseHostedFileIngestJobView,
   parseHostedFileIngestPublishResult,
   requireHostedFileIngestFilename
-} from "./chunk-HTQBKJTD.mjs";
+} from "./chunk-MD5RCZCA.mjs";
 import {
   syncMemoryRulesFromServer
 } from "./chunk-QR5K7ETI.mjs";
@@ -80,7 +81,10 @@ function parseIntent(raw, file) {
   if (value?.version !== 1 || typeof value.jobId !== "string" || typeof value.endpoint !== "string" || typeof value.delivered !== "boolean" || typeof value.createdAt !== "string" || typeof value.updatedAt !== "string" || typeof fp?.path !== "string" || typeof fp.byteLength !== "number" || typeof fp.sha256 !== "string") {
     throw new Error(`file ingest intent ${file} is not a version 1 record; remove it to continue`);
   }
-  return value;
+  return {
+    ...value,
+    fingerprint: { ...fp, ...normalizeMemoryAttribution(fp) }
+  };
 }
 async function readIntents(dir) {
   let names;
@@ -157,7 +161,14 @@ function parseArgs(args) {
   if (maxCostCents !== void 0 && maxCostMicrocents === void 0) {
     return "`maxCostCents` must be a non-negative number of cents.";
   }
+  let attribution;
+  try {
+    attribution = normalizeMemoryAttribution(args);
+  } catch (error) {
+    return error instanceof Error ? error.message : String(error);
+  }
   return {
+    ...attribution,
     path: isAbsolute(path) ? path : resolve(path),
     description: description || null,
     namespaceId: namespaceId ?? null,
@@ -483,7 +494,8 @@ ${NEW_IMPORT}`, true));
         filename: call.filename,
         byteLength: fingerprint.byteLength,
         sha256: fingerprint.sha256,
-        ...fingerprint.description === null ? {} : { description: fingerprint.description }
+        ...fingerprint.description === null ? {} : { description: fingerprint.description },
+        ...normalizeMemoryAttribution(fingerprint)
       },
       parseHostedFileIngestJobView
     );
@@ -577,7 +589,8 @@ Call this tool with cancel: true again to confirm.`,
         byteLength,
         sha256,
         description: args.description,
-        namespaceId: args.namespaceId
+        namespaceId: args.namespaceId,
+        ...normalizeMemoryAttribution(args)
       },
       lastState: null,
       delivered: false,
@@ -773,6 +786,15 @@ function createLocalFileUploader(credentials, readCredentials, fetchImpl = fetch
   return async (descriptor, args) => {
     try {
       await guard();
+      const attribution = normalizeMemoryAttribution(args);
+      for (const key of ["agentId", "metadata"]) {
+        if (attribution[key] !== void 0 && !descriptor.optionalArgs?.includes(key)) {
+          return mcpText(
+            `The server does not support ingest ${key}; upgrade it before sending attribution.`,
+            true
+          );
+        }
+      }
       const file = await readCappedLocalFile(args[descriptor.pathArg], descriptor);
       if (!file.ok) return file.result;
       const http = createHttpClient(credentials, fetchImpl);
@@ -783,7 +805,12 @@ function createLocalFileUploader(credentials, readCredentials, fetchImpl = fetch
           const form = new FormData();
           form.set(descriptor.fileField, new File([new Uint8Array(file.bytes)], file.name));
           for (const key of descriptor.optionalArgs ?? []) {
-            const value = args[key];
+            if (key === "metadata") {
+              if (attribution.metadata !== void 0)
+                form.set(key, JSON.stringify(attribution.metadata));
+              continue;
+            }
+            const value = key === "agentId" ? attribution.agentId : args[key];
             if (typeof value === "string" && value.length > 0) form.set(key, value);
           }
           return form;
@@ -874,7 +901,7 @@ function createProxyServer(client, version, uploadLocalFile, hostedFileIngest) {
   return server;
 }
 async function runMcpProxyServer(opts) {
-  const version = opts.version ?? (true ? "1.31.0" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "1.32.0" : "0.0.0-dev");
   const read = await opts.readCredentials();
   if (!read.ok) {
     throw new Error(

package/dist/react.mjs

@@ -11,10 +11,10 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-N4KDRRLY.mjs";
-import "./chunk-M67SXB7C.mjs";
+} from "./chunk-UIR5VDPF.mjs";
+import "./chunk-F2G2TBLW.mjs";
 import "./chunk-RWQTBXUC.mjs";
-import "./chunk-HTQBKJTD.mjs";
+import "./chunk-MD5RCZCA.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts
 import { useCallback as useCallback2, useMemo } from "react";

package/dist/{taxonomy-EKDFDFXW.mjs → taxonomy-65DFVGRY.mjs}

@@ -10,7 +10,7 @@ import {
   TAXONOMY_MAX_SAMPLE_TOPICS,
   TAXONOMY_MAX_TOP_ENTITIES
 } from "./chunk-RWQTBXUC.mjs";
-import "./chunk-HTQBKJTD.mjs";
+import "./chunk-MD5RCZCA.mjs";
 import {
   EXIT
 } from "./chunk-4DXEQC6X.mjs";

package/package.json

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