@pyxmate/memory 1.26.6 → 1.27.0

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,
@@ -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
@@ -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.6" : "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

@@ -13,7 +13,7 @@ import {
   unreachableHealth
 } from "./chunk-N4KDRRLY.mjs";
 import "./chunk-M67SXB7C.mjs";
-import "./chunk-KZKGRND2.mjs";
+import "./chunk-RWQTBXUC.mjs";
 import "./chunk-HTQBKJTD.mjs";
 export {
   DashboardClient,

package/dist/index.d.ts

@@ -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

@@ -5,6 +5,8 @@ import {
 } 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,
@@ -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

@@ -13,7 +13,7 @@ import {
   unreachableHealth
 } from "./chunk-N4KDRRLY.mjs";
 import "./chunk-M67SXB7C.mjs";
-import "./chunk-KZKGRND2.mjs";
+import "./chunk-RWQTBXUC.mjs";
 import "./chunk-HTQBKJTD.mjs";
 
 // ../dashboard/src/hooks/use-consolidation-log.ts

package/package.json

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