@pyxmate/memory 1.26.5 → 1.27.0

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

@@ -164,6 +164,20 @@ var DATA_PLANE_COMPILER_LIMITS = {
   graphEntities: 1e3,
   graphRelationships: 2e3
 };
+var MCP_SESSION_MESSAGE = {
+  methods: ["initialize", "notifications/initialized", "tools/list", "prompts/list", "ping"],
+  tool: "get_memory_rules",
+  /** A connect message is a few hundred bytes; a longer body is work, unread. */
+  maxBytes: 16 * 1024
+};
+var MCP_SESSION_METHODS = new Set(MCP_SESSION_MESSAGE.methods);
+function isMcpSessionJsonRpc(message) {
+  if (typeof message !== "object" || message === null || Array.isArray(message)) return false;
+  const { jsonrpc, method, params } = message;
+  if (jsonrpc !== "2.0" || typeof method !== "string") return false;
+  if (method === "tools/call") return params?.name === MCP_SESSION_MESSAGE.tool;
+  return MCP_SESSION_METHODS.has(method);
+}
 var HOSTED_FILE_INGEST_PROTOCOL = {
   version: 1,
   capability: "hosted-file-ingest-v1",
@@ -1918,6 +1932,8 @@ export {
   DATA_PLANE_MANIFEST_FRAME,
   DATA_PLANE_HTTP_RESPONSE_FRAME,
   DATA_PLANE_COMPILER_LIMITS,
+  MCP_SESSION_MESSAGE,
+  isMcpSessionJsonRpc,
   HOSTED_FILE_INGEST_PROTOCOL,
   HOSTED_FILE_INGEST_LIMITS,
   HOSTED_FILE_INGEST_JOB_STATES,

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

@@ -2,7 +2,7 @@ import {
   RAGStrategy,
   assertGraphExtractionPayload,
   mergeExtractedEntities
-} from "./chunk-VXXRCAKS.mjs";
+} from "./chunk-HTQBKJTD.mjs";
 
 // ../client/src/disabled-memory.ts
 var DEFAULT_PAGE_LIMIT = 20;

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

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

package/dist/{chunk-KZKGRND2.mjs → chunk-RWQTBXUC.mjs}

@@ -9,6 +9,8 @@ var TAXONOMY_MAX_TOP_ENTITIES = 15;
 var TAXONOMY_MAX_SAMPLE_TOPICS = 8;
 var TAXONOMY_MAX_PROJECTS = 8;
 var MEMORY_PROJECT_LABEL_MAX_CHARS = 80;
+var MCP_ACTOR_META_KEY = "pyx.dev/actor";
+var MEMORY_ACTOR_LABEL_MAX_CHARS = 80;
 
 // ../shared/src/document-source.ts
 import { createHash } from "crypto";
@@ -25,6 +27,13 @@ function documentImageSource(documentKey) {
   return documentSource("document-image", documentKey);
 }
 
+// ../shared/src/mcp/actor.ts
+function normalizeMemoryActorLabel(value) {
+  if (typeof value !== "string" || /[\p{Cc}\p{Cs}]/u.test(value)) return null;
+  const label = value.trim();
+  return label.length > 0 && [...label].length <= MEMORY_ACTOR_LABEL_MAX_CHARS ? label : null;
+}
+
 // ../shared/src/mcp/search-response.ts
 var STRIPPED_ENTRY_FIELDS = /* @__PURE__ */ new Set(["contentHash", "embedding", "tenantId", "userId", "teamId"]);
 function isRecord(value) {
@@ -147,9 +156,12 @@ export {
   TAXONOMY_MAX_SAMPLE_TOPICS,
   TAXONOMY_MAX_PROJECTS,
   MEMORY_PROJECT_LABEL_MAX_CHARS,
+  MCP_ACTOR_META_KEY,
+  MEMORY_ACTOR_LABEL_MAX_CHARS,
   documentGraphSource,
   documentContentSource,
   documentImageSource,
+  normalizeMemoryActorLabel,
   projectSearchResponseForMcp,
   secretElevationNoticeFor,
   withSecretElevationNotice,

package/dist/cli/pyx-mem.mjs

@@ -5,12 +5,14 @@ import {
   buildDesignGuide
 } from "../chunk-QD7G23CN.mjs";
 import {
+  MCP_ACTOR_META_KEY,
   MEMORY_PROJECT_LABEL_MAX_CHARS,
   TAXONOMY_MAX_CATEGORIES,
   TAXONOMY_MAX_PROJECTS,
   TAXONOMY_MAX_SAMPLE_TOPICS,
-  TAXONOMY_MAX_TOP_ENTITIES
-} from "../chunk-KZKGRND2.mjs";
+  TAXONOMY_MAX_TOP_ENTITIES,
+  normalizeMemoryActorLabel
+} from "../chunk-RWQTBXUC.mjs";
 import {
   HOSTED_FILE_INGEST_PROTOCOL,
   HOSTED_FILE_INGEST_RETRYABLE_CODES,
@@ -19,7 +21,7 @@ import {
   parseHostedFileIngestJobView,
   parseHostedFileIngestPublishResult,
   requireHostedFileIngestFilename
-} from "../chunk-VXXRCAKS.mjs";
+} from "../chunk-HTQBKJTD.mjs";
 
 // src/cli/exit-codes.ts
 var EXIT = {
@@ -1281,15 +1283,25 @@ var insightsSchema = z.object({
     })
   ).max(5)
 });
-var insightsResponseSchema = z.union([
-  insightsSchema,
-  z.object({ success: z.literal(true), data: insightsSchema }).transform(({ data }) => data)
-]);
+var actorSchema = z.string().refine((value) => normalizeMemoryActorLabel(value) === value).nullable().default(null);
+var insightsWithProvenanceSchema = insightsSchema.extend({
+  recentApplied: z.array(
+    insightsSchema.shape.recentApplied.element.extend({
+      writtenBy: actorSchema,
+      writtenAt: z.iso.datetime({ offset: true }).nullable().default(null),
+      appliedBy: actorSchema
+    })
+  ).max(5)
+});
 async function insightsCommand(opts = {}) {
+  const schema = opts.withProvenance === true ? insightsWithProvenanceSchema : insightsSchema;
   const result = await readSurface({
     surface: "insights",
     request: { method: "GET", path: "/api/memory/insights" },
-    schema: insightsResponseSchema,
+    schema: z.union([
+      schema,
+      z.object({ success: z.literal(true), data: schema }).transform(({ data }) => data)
+    ]),
     minimumServiceVersion: "1.19.0",
     keychain: opts.keychain,
     fetchImpl: opts.fetchImpl
@@ -2271,7 +2283,7 @@ var NEXT_BY_CODE = /* @__PURE__ */ new Map([
   ],
   [
     "file_ingest_job_limit",
-    "Your plan allows no more unfinished imports on this instance: finish or cancel another one (cancel: true with its path), then call this tool again with the same arguments."
+    "This instance already has as many unfinished imports as it allows: finish or cancel another one (cancel: true with its path), then call this tool again with the same arguments."
   ],
   [
     "file_ingest_disabled",
@@ -2279,7 +2291,7 @@ var NEXT_BY_CODE = /* @__PURE__ */ new Map([
   ],
   [
     "file_too_large",
-    "The file exceeds your plan's file-size cap: upgrade the plan and call again with the same arguments, or call with cancel: true to drop this import."
+    "The file is larger than hosted file ingest accepts: call with cancel: true to drop this import, then import a smaller file."
   ],
   [
     "file_ingest_cancel_requested",
@@ -2479,13 +2491,13 @@ ${RESUME}`);
     switch (auth.state) {
       case "quota_paused":
         return stop(
-          `the project's memory quota has no room for ${chunks}.`,
-          `Free memory space or upgrade the plan, then ${resume}.`
+          `the import was paused before storing ${chunks}.`,
+          `${resume[0]?.toUpperCase()}${resume.slice(1)}.`
         );
       case "limit_exceeded":
         return stop(
-          "the document exceeds the plan limits for extracted text or chunks.",
-          `Upgrade the plan, then ${resume}; or call with cancel: true to abandon job ${call.intent.jobId}.`
+          "the document exceeds the hosted limits for extracted text or chunks.",
+          `Call with cancel: true to abandon job ${call.intent.jobId}, then import the document in smaller parts.`
         );
       case "cancel_requested":
         return stop(
@@ -2935,7 +2947,14 @@ function createProxyServer(client, version, uploadLocalFile, hostedFileIngest) {
       if (bridge?.kind === "local" && uploadLocalFile) {
         return await uploadLocalFile(bridge.descriptor, args);
       }
-      return client.callTool(req.params);
+      const actor = normalizeMemoryActorLabel(server.getClientVersion()?.name);
+      const params = { ...req.params };
+      if (actor !== null || params._meta !== void 0) {
+        params._meta = { ...params._meta };
+        delete params._meta[MCP_ACTOR_META_KEY];
+        if (actor !== null) params._meta[MCP_ACTOR_META_KEY] = actor;
+      }
+      return client.callTool(params);
     });
   }
   if (caps?.prompts) {
@@ -2951,7 +2970,7 @@ function createProxyServer(client, version, uploadLocalFile, hostedFileIngest) {
   return server;
 }
 async function runMcpProxyServer(opts) {
-  const version = opts.version ?? (true ? "1.26.5" : "0.0.0-dev");
+  const version = opts.version ?? (true ? "1.27.0" : "0.0.0-dev");
   const read = await opts.readCredentials();
   if (!read.ok) {
     throw new Error(
@@ -4195,6 +4214,7 @@ Commands:
   status [--json]                              Show endpoint, key presence, MCP config status.
   overview --json                              Read memory count and three recent safe labels.
   insights --json [--with-identity]            Read body-free memory usage and coverage aggregates.
+      [--with-provenance]                      Add last writer, save time and applier to recent items.
   taxonomy --json [--with-identity]            Read knowledge-graph cluster composition (read-only).
                                                --with-identity adds credentialFingerprint (the same
                                                value as status --json) so a host can tell which
@@ -4402,7 +4422,10 @@ async function main() {
         process.stderr.write("Error: `pyx-mem insights` requires --json.\n");
         return EXIT.USAGE;
       }
-      return insightsCommand({ withIdentity: parsed.flags["with-identity"] === true });
+      return insightsCommand({
+        withIdentity: parsed.flags["with-identity"] === true,
+        withProvenance: parsed.flags["with-provenance"] === true
+      });
     case "taxonomy":
       if (parsed.flags.json !== true) {
         process.stderr.write("Error: `pyx-mem taxonomy` requires --json.\n");

package/dist/dashboard.mjs

@@ -11,10 +11,10 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-NDXE3TIS.mjs";
-import "./chunk-LQDQHLVP.mjs";
-import "./chunk-KZKGRND2.mjs";
-import "./chunk-VXXRCAKS.mjs";
+} from "./chunk-N4KDRRLY.mjs";
+import "./chunk-M67SXB7C.mjs";
+import "./chunk-RWQTBXUC.mjs";
+import "./chunk-HTQBKJTD.mjs";
 export {
   DashboardClient,
   Poller,

package/dist/{data-plane-contract-CGU0qjv4.d.ts → data-plane-contract-Dni6d9pq.d.ts}

@@ -14,9 +14,29 @@ declare const DATA_PLANE_COMPILER_LIMITS: {
     readonly graphEntities: 1000;
     readonly graphRelationships: 2000;
 };
+/**
+ * MCP connect messages: they open or describe a session, read no tenant data
+ * and run nothing, yet every client connect sends several. The memory runtime
+ * and the hosted gateway both charge them to a finite bucket of their own
+ * instead of the work budget. `get_memory_rules` returns static text.
+ */
+declare const MCP_SESSION_MESSAGE: {
+    readonly methods: readonly ["initialize", "notifications/initialized", "tools/list", "prompts/list", "ping"];
+    readonly tool: "get_memory_rules";
+    /** A connect message is a few hundred bytes; a longer body is work, unread. */
+    readonly maxBytes: number;
+};
+/**
+ * Whether `message`, the whole decoded JSON body of one MCP POST (at most
+ * MCP_SESSION_MESSAGE.maxBytes), is a connect message: a single JSON-RPC 2.0
+ * message whose method is a session method or a call of the rules tool. A
+ * batch, any other tool call or anything malformed is work.
+ */
+declare function isMcpSessionJsonRpc(message: unknown): boolean;
 /**
  * Hosted file ingest protocol v1 (docs/specs/hosted-file-ingest/spec.md). The
- * tenant enforces these absolute caps; the gateway enforces per-plan caps.
+ * tenant enforces these absolute caps; the gateway enforces the same caps for
+ * every organization, plus its own bounds on concurrent jobs and DOCX size.
  */
 declare const HOSTED_FILE_INGEST_PROTOCOL: {
     readonly version: 1;
@@ -379,4 +399,4 @@ interface HostedFileIngestAuthorization {
 }
 declare function parseHostedFileIngestAuthorization(input: unknown): HostedFileIngestAuthorization;
 
-export { type HostedFileIngestManifest as A, type HostedFileIngestPageDescriptor as B, type CanonicalDataPlaneObject as C, DATA_PLANE_CATALOG_VERSION as D, type HostedFileIngestPublishResult as E, canonicalDataPlaneJson as F, compileDataPlaneRequest as G, HOSTED_FILE_INGEST_GATEWAY_STATES as H, hashDataPlaneHttpResponseV1 as I, hashDataPlaneManifestV1 as J, hashDataPlaneStepInputV1 as K, normalizeHostedFileIngestPageDescriptor as L, parseHostedFileIngestAuthorization as M, parseHostedFileIngestCommitResult as N, parseHostedFileIngestJobView as O, parseHostedFileIngestPublishResult as P, requireHostedFileIngestFilename as Q, type SupportedDataPlaneCatalogOperation as S, type CanonicalDataPlaneValue as a, type CompileContext as b, type CompileDataPlaneRequest as c, type CompileDataPlaneResult as d, encodeListCursorToken as e, type CompiledDataPlaneExecutionPlan as f, DATA_PLANE_COMPILER_LIMITS as g, DATA_PLANE_CONTRACT_VERSION as h, DATA_PLANE_HTTP_RESPONSE_FRAME as i, DATA_PLANE_MANIFEST_FRAME as j, DATA_PLANE_MANIFEST_VERSION as k, DATA_PLANE_OPERATION_COVERAGE as l, DATA_PLANE_SEARCH_EMBEDDING_CONTRACT as m, DATA_PLANE_STEP_INPUT_FRAME as n, type DataPlaneCatalogOperation as o, parseListCursorToken as p, type DataPlaneUnsupportedReasonCode as q, HOSTED_FILE_INGEST_JOB_STATES as r, HOSTED_FILE_INGEST_LIMITS as s, HOSTED_FILE_INGEST_PROTOCOL as t, HOSTED_FILE_INGEST_RETRYABLE_CODES as u, type HostedFileIngestAuthorization as v, type HostedFileIngestCommitResult as w, type HostedFileIngestGatewayState as x, type HostedFileIngestJobState as y, type HostedFileIngestJobView as z };
+export { type HostedFileIngestManifest as A, type HostedFileIngestPageDescriptor as B, type CanonicalDataPlaneObject as C, DATA_PLANE_CATALOG_VERSION as D, type HostedFileIngestPublishResult as E, canonicalDataPlaneJson as F, compileDataPlaneRequest as G, HOSTED_FILE_INGEST_GATEWAY_STATES as H, hashDataPlaneHttpResponseV1 as I, hashDataPlaneManifestV1 as J, hashDataPlaneStepInputV1 as K, isMcpSessionJsonRpc as L, MCP_SESSION_MESSAGE as M, normalizeHostedFileIngestPageDescriptor as N, parseHostedFileIngestAuthorization as O, parseHostedFileIngestCommitResult as P, parseHostedFileIngestJobView as Q, parseHostedFileIngestPublishResult as R, type SupportedDataPlaneCatalogOperation as S, requireHostedFileIngestFilename as T, type CanonicalDataPlaneValue as a, type CompileContext as b, type CompileDataPlaneRequest as c, type CompileDataPlaneResult as d, encodeListCursorToken as e, type CompiledDataPlaneExecutionPlan as f, DATA_PLANE_COMPILER_LIMITS as g, DATA_PLANE_CONTRACT_VERSION as h, DATA_PLANE_HTTP_RESPONSE_FRAME as i, DATA_PLANE_MANIFEST_FRAME as j, DATA_PLANE_MANIFEST_VERSION as k, DATA_PLANE_OPERATION_COVERAGE as l, DATA_PLANE_SEARCH_EMBEDDING_CONTRACT as m, DATA_PLANE_STEP_INPUT_FRAME as n, type DataPlaneCatalogOperation as o, parseListCursorToken as p, type DataPlaneUnsupportedReasonCode as q, HOSTED_FILE_INGEST_JOB_STATES as r, HOSTED_FILE_INGEST_LIMITS as s, HOSTED_FILE_INGEST_PROTOCOL as t, HOSTED_FILE_INGEST_RETRYABLE_CODES as u, type HostedFileIngestAuthorization as v, type HostedFileIngestCommitResult as w, type HostedFileIngestGatewayState as x, type HostedFileIngestJobState as y, type HostedFileIngestJobView as z };

package/dist/data-plane-contract.d.ts

@@ -1 +1 @@
-export { C as CanonicalDataPlaneObject, a as CanonicalDataPlaneValue, b as CompileContext, c as CompileDataPlaneRequest, d as CompileDataPlaneResult, f as CompiledDataPlaneExecutionPlan, D as DATA_PLANE_CATALOG_VERSION, g as DATA_PLANE_COMPILER_LIMITS, h as DATA_PLANE_CONTRACT_VERSION, i as DATA_PLANE_HTTP_RESPONSE_FRAME, j as DATA_PLANE_MANIFEST_FRAME, k as DATA_PLANE_MANIFEST_VERSION, l as DATA_PLANE_OPERATION_COVERAGE, m as DATA_PLANE_SEARCH_EMBEDDING_CONTRACT, n as DATA_PLANE_STEP_INPUT_FRAME, o as DataPlaneCatalogOperation, q as DataPlaneUnsupportedReasonCode, H as HOSTED_FILE_INGEST_GATEWAY_STATES, r as HOSTED_FILE_INGEST_JOB_STATES, s as HOSTED_FILE_INGEST_LIMITS, t as HOSTED_FILE_INGEST_PROTOCOL, u as HOSTED_FILE_INGEST_RETRYABLE_CODES, v as HostedFileIngestAuthorization, w as HostedFileIngestCommitResult, x as HostedFileIngestGatewayState, y as HostedFileIngestJobState, z as HostedFileIngestJobView, A as HostedFileIngestManifest, B as HostedFileIngestPageDescriptor, E as HostedFileIngestPublishResult, S as SupportedDataPlaneCatalogOperation, F as canonicalDataPlaneJson, G as compileDataPlaneRequest, I as hashDataPlaneHttpResponseV1, J as hashDataPlaneManifestV1, K as hashDataPlaneStepInputV1, L as normalizeHostedFileIngestPageDescriptor, M as parseHostedFileIngestAuthorization, N as parseHostedFileIngestCommitResult, O as parseHostedFileIngestJobView, P as parseHostedFileIngestPublishResult, Q as requireHostedFileIngestFilename } from './data-plane-contract-CGU0qjv4.js';
+export { C as CanonicalDataPlaneObject, a as CanonicalDataPlaneValue, b as CompileContext, c as CompileDataPlaneRequest, d as CompileDataPlaneResult, f as CompiledDataPlaneExecutionPlan, D as DATA_PLANE_CATALOG_VERSION, g as DATA_PLANE_COMPILER_LIMITS, h as DATA_PLANE_CONTRACT_VERSION, i as DATA_PLANE_HTTP_RESPONSE_FRAME, j as DATA_PLANE_MANIFEST_FRAME, k as DATA_PLANE_MANIFEST_VERSION, l as DATA_PLANE_OPERATION_COVERAGE, m as DATA_PLANE_SEARCH_EMBEDDING_CONTRACT, n as DATA_PLANE_STEP_INPUT_FRAME, o as DataPlaneCatalogOperation, q as DataPlaneUnsupportedReasonCode, H as HOSTED_FILE_INGEST_GATEWAY_STATES, r as HOSTED_FILE_INGEST_JOB_STATES, s as HOSTED_FILE_INGEST_LIMITS, t as HOSTED_FILE_INGEST_PROTOCOL, u as HOSTED_FILE_INGEST_RETRYABLE_CODES, v as HostedFileIngestAuthorization, w as HostedFileIngestCommitResult, x as HostedFileIngestGatewayState, y as HostedFileIngestJobState, z as HostedFileIngestJobView, A as HostedFileIngestManifest, B as HostedFileIngestPageDescriptor, E as HostedFileIngestPublishResult, M as MCP_SESSION_MESSAGE, S as SupportedDataPlaneCatalogOperation, F as canonicalDataPlaneJson, G as compileDataPlaneRequest, I as hashDataPlaneHttpResponseV1, J as hashDataPlaneManifestV1, K as hashDataPlaneStepInputV1, L as isMcpSessionJsonRpc, N as normalizeHostedFileIngestPageDescriptor, O as parseHostedFileIngestAuthorization, P as parseHostedFileIngestCommitResult, Q as parseHostedFileIngestJobView, R as parseHostedFileIngestPublishResult, T as requireHostedFileIngestFilename } from './data-plane-contract-Dni6d9pq.js';

package/dist/data-plane-contract.mjs

@@ -14,18 +14,20 @@ import {
   HOSTED_FILE_INGEST_LIMITS,
   HOSTED_FILE_INGEST_PROTOCOL,
   HOSTED_FILE_INGEST_RETRYABLE_CODES,
+  MCP_SESSION_MESSAGE,
   canonicalDataPlaneJson,
   compileDataPlaneRequest,
   hashDataPlaneHttpResponseV1,
   hashDataPlaneManifestV1,
   hashDataPlaneStepInputV1,
+  isMcpSessionJsonRpc,
   normalizeHostedFileIngestPageDescriptor,
   parseHostedFileIngestAuthorization,
   parseHostedFileIngestCommitResult,
   parseHostedFileIngestJobView,
   parseHostedFileIngestPublishResult,
   requireHostedFileIngestFilename
-} from "./chunk-VXXRCAKS.mjs";
+} from "./chunk-HTQBKJTD.mjs";
 export {
   DATA_PLANE_CATALOG_VERSION,
   DATA_PLANE_COMPILER_LIMITS,
@@ -41,11 +43,13 @@ export {
   HOSTED_FILE_INGEST_LIMITS,
   HOSTED_FILE_INGEST_PROTOCOL,
   HOSTED_FILE_INGEST_RETRYABLE_CODES,
+  MCP_SESSION_MESSAGE,
   canonicalDataPlaneJson,
   compileDataPlaneRequest,
   hashDataPlaneHttpResponseV1,
   hashDataPlaneManifestV1,
   hashDataPlaneStepInputV1,
+  isMcpSessionJsonRpc,
   normalizeHostedFileIngestPageDescriptor,
   parseHostedFileIngestAuthorization,
   parseHostedFileIngestCommitResult,

package/dist/index.d.ts

@@ -1,6 +1,6 @@
 import { MemoryType as MemoryType$1, StoreInput as StoreInput$1, MemoryEntry as MemoryEntry$1, MemorySearchParams as MemorySearchParams$1, MemorySearchResult as MemorySearchResult$1, PrincipalContext as PrincipalContext$1, SensitivityLevel as SensitivityLevel$1, MemoryStats as MemoryStats$1, MemoryInsights as MemoryInsights$1, LineageParams as LineageParams$1, LineageResult as LineageResult$1, ReinforceParams as ReinforceParams$1, ReinforceResult as ReinforceResult$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, GraphEnrichEvent as GraphEnrichEvent$1, GraphNode as GraphNode$1, GraphTraversalResult as GraphTraversalResult$1, CorrectionRecord as CorrectionRecord$1 } from '@pyx-memory/shared';
 export { documentContentSource, documentGraphSource, documentImageSource } from '@pyx-memory/shared';
-export { e as encodeListCursorToken, p as parseListCursorToken } from './data-plane-contract-CGU0qjv4.js';
+export { e as encodeListCursorToken, p as parseListCursorToken } from './data-plane-contract-Dni6d9pq.js';
 
 /** ISO 8601 timestamp string */
 type Timestamp = string;
@@ -776,6 +776,9 @@ interface MemoryInsights {
         topic: string | null;
         project: string | null;
         at: string;
+        writtenBy?: string | null;
+        writtenAt?: string | null;
+        appliedBy?: string | null;
     }>;
 }
 interface GraphRepairResult {
@@ -1534,6 +1537,8 @@ declare const TAXONOMY_MAX_TOP_ENTITIES = 15;
 declare const TAXONOMY_MAX_SAMPLE_TOPICS = 8;
 declare const TAXONOMY_MAX_PROJECTS = 8;
 declare const MEMORY_PROJECT_LABEL_MAX_CHARS = 80;
+declare const MCP_ACTOR_META_KEY = "pyx.dev/actor";
+declare const MEMORY_ACTOR_LABEL_MAX_CHARS = 80;
 
 /**
  * Result shape returned by an LLM entity extractor — entities + relations.
@@ -1599,6 +1604,8 @@ declare function mergeExtractedEntities(callerEntities: IngestEntity[] | undefin
     relationships: IngestRelationship[];
 };
 
+declare function normalizeMemoryActorLabel(value: unknown): string | null;
+
 declare function projectSearchResponseForMcp(payload: unknown): unknown;
 
 /**
@@ -2004,4 +2011,4 @@ interface CreatePyxMemoryOptions {
 }
 declare function createPyxMemory(opts?: CreatePyxMemoryOptions): MemoryClient;
 
-export { type AgentId, type ApiResponse, type ConsolidationJudgementsResult, type ConsolidationMerge, type ConsolidationPair, type ConsolidationPairSide, type ConsolidationRunResult, type CorrectionInput, type CorrectionRecord, type CreatePyxMemoryOptions, DEFAULTS, DEPRECATED_RAG_STRATEGIES, DisabledMemory, type DroppedGraphRelationship, type DueScanInput, EmbeddingProviderName, type EnrichmentCallbacks, type EnrichmentPurpose, type EntityExtractionResult, type ExpandAnchorStatus, type ExpandParams, type ExpandResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type FileDownloadOptions, type GraphEnrichEvent, type GraphEnrichFileOptions, type GraphEnrichPreparedEvent, type GraphEnrichResult, type GraphEnrichResultEvent, type GraphEnrichment, type GraphEnrichmentStatus, type GraphExtractionPayload, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphRepairResult, type GraphTelemetrySnapshot, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, type LineageParams, type LineageResult, type LineageVersion, MEMORY_PROJECT_LABEL_MAX_CHARS, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInsightMetrics, type MemoryInsights, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemoryLogFilters, type MemoryProjectInsight, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, type MoveEntriesFilter, MoveFailureReason, type MoveResult, type MoveTarget, NamespaceIsolation, type PrincipalContext, RAGStrategy, type ReinforceParams, type ReinforceResult, type ReinforceSignal, SESSION_ORDINAL_MAX, SINGLE_TENANT_ID, type SecretElevationAggregate, type SecretElevationNotice, SensitivityLevel, type SourceEvidence, type StoreInput, StoreTarget, TAXONOMY_MAX_CATEGORIES, TAXONOMY_MAX_PROJECTS, TAXONOMY_MAX_SAMPLE_TOPICS, TAXONOMY_MAX_TOP_ENTITIES, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyExtractionProvider, type TopologyServiceVariant, type UsageHygieneSnapshot, VectorProvider, type VectorStatus, type WikiLintReport, assertGraphExtractionPayload, createPyxMemory, isSessionOrdinal, mergeExtractedEntities, normalizeGraphLabel, normalizeNameKey, projectSearchResponseForMcp, secretElevationAggregate, secretElevationNoticeFor, withSecretElevationNotice };
+export { type AgentId, type ApiResponse, type ConsolidationJudgementsResult, type ConsolidationMerge, type ConsolidationPair, type ConsolidationPairSide, type ConsolidationRunResult, type CorrectionInput, type CorrectionRecord, type CreatePyxMemoryOptions, DEFAULTS, DEPRECATED_RAG_STRATEGIES, DisabledMemory, type DroppedGraphRelationship, type DueScanInput, EmbeddingProviderName, type EnrichmentCallbacks, type EnrichmentPurpose, type EntityExtractionResult, type ExpandAnchorStatus, type ExpandParams, type ExpandResult, type ExtendedMemoryInterface, type FetchCorrectionsInput, type FileDownloadOptions, type GraphEnrichEvent, type GraphEnrichFileOptions, type GraphEnrichPreparedEvent, type GraphEnrichResult, type GraphEnrichResultEvent, type GraphEnrichment, type GraphEnrichmentStatus, type GraphExtractionPayload, type GraphFailureMode, type GraphNode, type GraphRelationship, type GraphRepairResult, type GraphTelemetrySnapshot, type GraphTraversalResult, type IngestEntity, type IngestErrorEvent, type IngestEvent, type IngestFileOptions, type IngestHeartbeatEvent, type IngestProgressEvent, type IngestRelationship, type IngestResultEvent, type IngestStage, type IngestionResult, type LineageParams, type LineageResult, type LineageVersion, MCP_ACTOR_META_KEY, MEMORY_ACTOR_LABEL_MAX_CHARS, MEMORY_PROJECT_LABEL_MAX_CHARS, MemoryClient, type MemoryClientOptions, type MemoryEntry, type MemoryIngestRequest, type MemoryInsightMetrics, type MemoryInsights, type MemoryInterface, type MemoryListParams, type MemoryListResult, type MemoryLogFilters, type MemoryProjectInsight, type MemorySearchParams, type MemorySearchResult, MemoryServerError, type MemoryStats, MemoryType, type MoveEntriesFilter, MoveFailureReason, type MoveResult, type MoveTarget, NamespaceIsolation, type PrincipalContext, RAGStrategy, type ReinforceParams, type ReinforceResult, type ReinforceSignal, SESSION_ORDINAL_MAX, SINGLE_TENANT_ID, type SecretElevationAggregate, type SecretElevationNotice, SensitivityLevel, type SourceEvidence, type StoreInput, StoreTarget, TAXONOMY_MAX_CATEGORIES, TAXONOMY_MAX_PROJECTS, TAXONOMY_MAX_SAMPLE_TOPICS, TAXONOMY_MAX_TOP_ENTITIES, type TemporalQueryFilters, type TenantScopeOptions, type Timestamp, type Topology, type TopologyExtractionProvider, type TopologyServiceVariant, type UsageHygieneSnapshot, VectorProvider, type VectorStatus, type WikiLintReport, assertGraphExtractionPayload, createPyxMemory, isSessionOrdinal, mergeExtractedEntities, normalizeGraphLabel, normalizeMemoryActorLabel, normalizeNameKey, projectSearchResponseForMcp, secretElevationAggregate, secretElevationNoticeFor, withSecretElevationNotice };

package/dist/index.mjs

@@ -2,9 +2,11 @@ import {
   DisabledMemory,
   MemoryClient,
   MemoryServerError
-} from "./chunk-LQDQHLVP.mjs";
+} from "./chunk-M67SXB7C.mjs";
 import {
   DEFAULTS,
+  MCP_ACTOR_META_KEY,
+  MEMORY_ACTOR_LABEL_MAX_CHARS,
   MEMORY_PROJECT_LABEL_MAX_CHARS,
   MoveFailureReason,
   NamespaceIsolation,
@@ -16,11 +18,12 @@ import {
   documentContentSource,
   documentGraphSource,
   documentImageSource,
+  normalizeMemoryActorLabel,
   projectSearchResponseForMcp,
   secretElevationAggregate,
   secretElevationNoticeFor,
   withSecretElevationNotice
-} from "./chunk-KZKGRND2.mjs";
+} from "./chunk-RWQTBXUC.mjs";
 import {
   DEPRECATED_RAG_STRATEGIES,
   EmbeddingProviderName,
@@ -37,7 +40,7 @@ import {
   normalizeGraphLabel,
   normalizeNameKey,
   parseListCursorToken
-} from "./chunk-VXXRCAKS.mjs";
+} from "./chunk-HTQBKJTD.mjs";
 
 // src/preset.ts
 var DEFAULT_MEMORY_URL = `http://localhost:${DEFAULTS.MEMORY_SERVER_PORT}`;
@@ -57,6 +60,8 @@ export {
   DEPRECATED_RAG_STRATEGIES,
   DisabledMemory,
   EmbeddingProviderName,
+  MCP_ACTOR_META_KEY,
+  MEMORY_ACTOR_LABEL_MAX_CHARS,
   MEMORY_PROJECT_LABEL_MAX_CHARS,
   MemoryClient,
   MemoryServerError,
@@ -82,6 +87,7 @@ export {
   isSessionOrdinal,
   mergeExtractedEntities,
   normalizeGraphLabel,
+  normalizeMemoryActorLabel,
   normalizeNameKey,
   parseListCursorToken,
   projectSearchResponseForMcp,

package/dist/react.mjs

@@ -11,10 +11,10 @@ import {
   toGraphologyFormat,
   transformGraphData,
   unreachableHealth
-} from "./chunk-NDXE3TIS.mjs";
-import "./chunk-LQDQHLVP.mjs";
-import "./chunk-KZKGRND2.mjs";
-import "./chunk-VXXRCAKS.mjs";
+} from "./chunk-N4KDRRLY.mjs";
+import "./chunk-M67SXB7C.mjs";
+import "./chunk-RWQTBXUC.mjs";
+import "./chunk-HTQBKJTD.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": "1.26.5",
+  "version": "1.27.0",
   "type": "module",
   "description": "SDK for pyx-memory — Memory as a Service for AI agents",
   "license": "MIT",