@remnic/core 9.21.0 → 9.22.0

package/dist/chunk-56BSXSHC.js

@@ -0,0 +1,158 @@
+// src/access-mcp-admin-tools.ts
+var MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED = {
+  cwd: {
+    type: "string",
+    description: "Accepted for MCP client compatibility (git-context auto-injection); ignored by this tool."
+  },
+  projectTag: {
+    type: "string",
+    description: "Accepted for MCP client compatibility; ignored by this tool."
+  }
+};
+var MCP_ADMIN_OPS_TOOLS = [
+  {
+    name: "engram.capsule_export",
+    description: "Export a portable Remnic capsule archive from the namespace-scoped memory store.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        name: {
+          type: "string",
+          description: "Capsule id (alphanumeric with single dashes, max 64 characters)."
+        },
+        namespace: { type: "string" },
+        since: {
+          type: "string",
+          description: "Only include files modified on or after this ISO 8601 timestamp."
+        },
+        includeKinds: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional top-level directory allow-list."
+        },
+        peerIds: {
+          type: "array",
+          items: { type: "string" },
+          description: "Optional peer id allow-list for the peers/ subtree."
+        },
+        includeTranscripts: { type: "boolean" },
+        encrypt: { type: "boolean" },
+        ...MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED
+      },
+      required: ["name"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "engram.capsule_import",
+    description: "Import a Remnic capsule archive into the namespace-scoped memory store.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        archivePath: {
+          type: "string",
+          description: "Path to a .capsule.json.gz or .capsule.json.gz.enc archive."
+        },
+        namespace: { type: "string" },
+        mode: {
+          type: "string",
+          enum: ["skip", "overwrite", "fork"],
+          description: "Conflict handling mode. Defaults to skip."
+        },
+        passphrase: {
+          type: "string",
+          description: "Passphrase for encrypted capsule archives."
+        },
+        ...MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED
+      },
+      required: ["archivePath"],
+      additionalProperties: false
+    }
+  },
+  {
+    name: "engram.capsule_list",
+    description: "List capsule archives in the namespace-scoped capsule store.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        namespace: { type: "string" },
+        sessionKey: {
+          type: "string",
+          description: "Optional session key used to derive namespace principal when no trusted transport principal is present."
+        },
+        ...MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: "engram.memory_governance_run",
+    description: "Run Remnic memory governance in a bounded shadow/apply pass.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        namespace: { type: "string" },
+        mode: { type: "string", enum: ["shadow", "apply"] },
+        recentDays: { type: "number" },
+        maxMemories: { type: "number" },
+        batchSize: { type: "number" }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: "engram.entity_synthesis_run",
+    description: "Bulk-drain the entity synthesis queue (issue #2136). Processes up to maxEntities (default 25, max 200) queued entity names into canonical syntheses; loop until processed < requested to drain fully.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        namespace: { type: "string" },
+        maxEntities: { type: "number" }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: "engram.procedure_mining_run",
+    description: "Run procedural memory mining from causal trajectories (issue #519). Respects procedural.enabled; writes under procedures/ when clusters qualify.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        namespace: { type: "string" }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    name: "engram.pattern_reinforcement_run",
+    description: "Run the pattern-reinforcement maintenance job (issue #687 PR 2/4). Clusters duplicate non-procedural memories by normalized content, promotes the most-recent member to canonical, and supersedes the older duplicates. Gated on patternReinforcementEnabled and the patternReinforcementCadenceMs floor \u2014 pass force=true to bypass the cadence for an ad-hoc operator run.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        namespace: { type: "string" },
+        force: { type: "boolean" }
+      },
+      additionalProperties: false
+    }
+  },
+  {
+    // The canonical `remnic.procedural_stats` alias is added automatically
+    // by `withToolAliases` — the dual-naming invariant keeps both names
+    // alive for the legacy surface.
+    name: "engram.procedural_stats",
+    description: "Procedural memory stats (issue #567): counts by status, recent write activity, and the active procedural.* config. Read-only, namespace-scoped.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        namespace: { type: "string" }
+      },
+      additionalProperties: false
+    }
+  }
+];
+
+export {
+  MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED,
+  MCP_ADMIN_OPS_TOOLS
+};
+//# sourceMappingURL=chunk-56BSXSHC.js.map

package/dist/chunk-56BSXSHC.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/access-mcp-admin-tools.ts"],"sourcesContent":["/**\n * MCP tool-listing entries for the admin/maintenance operation surface\n * (capsules, governance, entity synthesis, procedure mining, pattern\n * reinforcement, procedural stats). Extracted from access-mcp.ts (#2136)\n * to keep the transport file under its structural-ratchet ceiling; the\n * dispatch name map and operation handlers stay in their existing homes.\n */\n/** Git-context schema props accepted-and-ignored by every tool (issue #569\n * compatibility surface) — defined here so the tool tables and the transport\n * share one copy without an import cycle. */\nexport const MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED: Record<string, unknown> = {\n  cwd: {\n    type: \"string\",\n    description: \"Accepted for MCP client compatibility (git-context auto-injection); ignored by this tool.\",\n  },\n  projectTag: {\n    type: \"string\",\n    description: \"Accepted for MCP client compatibility; ignored by this tool.\",\n  },\n};\n\nexport const MCP_ADMIN_OPS_TOOLS: Array<{\n  name: string;\n  description: string;\n  inputSchema: Record<string, unknown>;\n}> = [\n{\n  name: \"engram.capsule_export\",\n  description: \"Export a portable Remnic capsule archive from the namespace-scoped memory store.\",\n  inputSchema: {\n    type: \"object\",\n    properties: {\n      name: {\n        type: \"string\",\n        description: \"Capsule id (alphanumeric with single dashes, max 64 characters).\",\n      },\n      namespace: { type: \"string\" },\n      since: {\n        type: \"string\",\n        description: \"Only include files modified on or after this ISO 8601 timestamp.\",\n      },\n      includeKinds: {\n        type: \"array\",\n        items: { type: \"string\" },\n        description: \"Optional top-level directory allow-list.\",\n      },\n      peerIds: {\n        type: \"array\",\n        items: { type: \"string\" },\n        description: \"Optional peer id allow-list for the peers/ subtree.\",\n      },\n      includeTranscripts: { type: \"boolean\" },\n      encrypt: { type: \"boolean\" },\n      ...MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED,\n    },\n    required: [\"name\"],\n    additionalProperties: false,\n  },\n},\n{\n  name: \"engram.capsule_import\",\n  description: \"Import a Remnic capsule archive into the namespace-scoped memory store.\",\n  inputSchema: {\n    type: \"object\",\n    properties: {\n      archivePath: {\n        type: \"string\",\n        description: \"Path to a .capsule.json.gz or .capsule.json.gz.enc archive.\",\n      },\n      namespace: { type: \"string\" },\n      mode: {\n        type: \"string\",\n        enum: [\"skip\", \"overwrite\", \"fork\"],\n        description: \"Conflict handling mode. Defaults to skip.\",\n      },\n      passphrase: {\n        type: \"string\",\n        description: \"Passphrase for encrypted capsule archives.\",\n      },\n      ...MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED,\n    },\n    required: [\"archivePath\"],\n    additionalProperties: false,\n  },\n},\n{\n  name: \"engram.capsule_list\",\n  description: \"List capsule archives in the namespace-scoped capsule store.\",\n  inputSchema: {\n    type: \"object\",\n    properties: {\n      namespace: { type: \"string\" },\n      sessionKey: {\n        type: \"string\",\n        description:\n          \"Optional session key used to derive namespace principal when no trusted transport principal is present.\",\n      },\n      ...MCP_GIT_CONTEXT_SCHEMA_PROPS_IGNORED,\n    },\n    additionalProperties: false,\n  },\n},\n{\n  name: \"engram.memory_governance_run\",\n  description: \"Run Remnic memory governance in a bounded shadow/apply pass.\",\n  inputSchema: {\n    type: \"object\",\n    properties: {\n      namespace: { type: \"string\" },\n      mode: { type: \"string\", enum: [\"shadow\", \"apply\"] },\n      recentDays: { type: \"number\" },\n      maxMemories: { type: \"number\" },\n      batchSize: { type: \"number\" },\n    },\n    additionalProperties: false,\n  },\n},\n{\n  name: \"engram.entity_synthesis_run\",\n  description:\n    \"Bulk-drain the entity synthesis queue (issue #2136). Processes up to maxEntities (default 25, max 200) queued entity names into canonical syntheses; loop until processed < requested to drain fully.\",\n  inputSchema: {\n    type: \"object\",\n    properties: {\n      namespace: { type: \"string\" },\n      maxEntities: { type: \"number\" },\n    },\n    additionalProperties: false,\n  },\n},\n{\n  name: \"engram.procedure_mining_run\",\n  description:\n    \"Run procedural memory mining from causal trajectories (issue #519). Respects procedural.enabled; writes under procedures/ when clusters qualify.\",\n  inputSchema: {\n    type: \"object\",\n    properties: {\n      namespace: { type: \"string\" },\n    },\n    additionalProperties: false,\n  },\n},\n{\n  name: \"engram.pattern_reinforcement_run\",\n  description:\n    \"Run the pattern-reinforcement maintenance job (issue #687 PR 2/4). Clusters duplicate non-procedural memories by normalized content, promotes the most-recent member to canonical, and supersedes the older duplicates. Gated on patternReinforcementEnabled and the patternReinforcementCadenceMs floor — pass force=true to bypass the cadence for an ad-hoc operator run.\",\n  inputSchema: {\n    type: \"object\",\n    properties: {\n      namespace: { type: \"string\" },\n      force: { type: \"boolean\" },\n    },\n    additionalProperties: false,\n  },\n},\n{\n  // The canonical `remnic.procedural_stats` alias is added automatically\n  // by `withToolAliases` — the dual-naming invariant keeps both names\n  // alive for the legacy surface.\n  name: \"engram.procedural_stats\",\n  description:\n    \"Procedural memory stats (issue #567): counts by status, recent write activity, and the active procedural.* config. Read-only, namespace-scoped.\",\n  inputSchema: {\n    type: \"object\",\n    properties: {\n      namespace: { type: \"string\" },\n    },\n    additionalProperties: false,\n  },\n},\n];\n"],"mappings":"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","names":[]}

package/dist/{chunk-62QM5MKY.js → chunk-6ANPNUVL.js}

@@ -30,6 +30,9 @@ import {
 import {
   planSessionTranscriptMigration
 } from "./chunk-P5FPO2BR.js";
+import {
+  decideDisclosureEscalation
+} from "./chunk-H7XKCNR6.js";
 import {
   toRecallExplainJson
 } from "./chunk-GEUDRENF.js";
@@ -37,11 +40,11 @@ import {
   estimateRecallTokens
 } from "./chunk-JFDEYXF7.js";
 import {
-  decideDisclosureEscalation
-} from "./chunk-H7XKCNR6.js";
+  offlineSyncStorageForSnapshot
+} from "./chunk-UGH6VPPO.js";
 import {
   namespaceCollectionName
-} from "./chunk-SB4OKS6C.js";
+} from "./chunk-A5N6ISRK.js";
 import {
   buildProposedActions,
   buildQualityScore,
@@ -49,16 +52,7 @@ import {
   listMemoryGovernanceRuns,
   readMemoryGovernanceRunArtifact,
   runMemoryGovernance
-} from "./chunk-B7C3TF5H.js";
-import {
-  recordObjectiveStateSnapshotsFromObservedMessages
-} from "./chunk-ICP53SKG.js";
-import {
-  objectiveStateStoreOverrideForNamespace
-} from "./chunk-6HMYUWXR.js";
-import {
-  offlineSyncStorageForSnapshot
-} from "./chunk-UGH6VPPO.js";
+} from "./chunk-BRT7KEXU.js";
 import {
   combineNamespaces,
   defaultGitInvoker,
@@ -73,6 +67,12 @@ import {
   resolveWritableNamespaceValue,
   sanitizeFragment
 } from "./chunk-MQVINOJQ.js";
+import {
+  recordObjectiveStateSnapshotsFromObservedMessages
+} from "./chunk-ICP53SKG.js";
+import {
+  objectiveStateStoreOverrideForNamespace
+} from "./chunk-6HMYUWXR.js";
 import {
   recordMemoryOutcome
 } from "./chunk-EIR5VLIH.js";
@@ -114,13 +114,13 @@ import {
   enqueuePassiveCorrectionNotification,
   parseBriefingFocus,
   parseBriefingWindow
-} from "./chunk-Q3FWRDCP.js";
+} from "./chunk-SACPRJ7F.js";
 import {
   parseEntityFile,
   qmdCollectionPathParts,
   qmdResultPathCandidates,
   selfDeps
-} from "./chunk-4F6AANKS.js";
+} from "./chunk-QMGIQUBG.js";
 import {
   supersessionKeysForFact
 } from "./chunk-DNHVPZOD.js";
@@ -169,6 +169,9 @@ import {
 import {
   computeContentHash
 } from "./chunk-W5H6ZRPT.js";
+import {
+  exportCapsule
+} from "./chunk-KQAFEZQX.js";
 import {
   assertFleetWideOperationAllowed,
   assertOperationAllowed,
@@ -177,22 +180,15 @@ import {
   isNamespaceAllowed,
   tokenCapabilityStore
 } from "./chunk-7AMFUATK.js";
+import {
+  evaluateActionConfidence
+} from "./chunk-Z2YFLXHU.js";
 import {
   sanitizeMemoryContent
 } from "./chunk-5GKPFL3S.js";
 import {
   expandTildePath
 } from "./chunk-EYIEWJNI.js";
-import {
-  buildHandleIndexForResults,
-  isHandleToken
-} from "./chunk-JAKIDQB2.js";
-import {
-  exportCapsule
-} from "./chunk-KQAFEZQX.js";
-import {
-  evaluateActionConfidence
-} from "./chunk-Z2YFLXHU.js";
 import {
   OFFLINE_SYNC_SNAPSHOT_FORMAT,
   applyOfflineSyncChangeset,
@@ -205,14 +201,9 @@ import {
   readOfflineSyncFileContentChunk
 } from "./chunk-E4OCKU67.js";
 import {
-  EngramAccessForbiddenError,
-  EngramAccessInputError,
-  NamespaceNotWritableError
-} from "./chunk-2Z24E5W2.js";
-import {
-  AccessIdempotencyStore,
-  hashAccessIdempotencyPayload
-} from "./chunk-VFUEZZBS.js";
+  buildHandleIndexForResults,
+  isHandleToken
+} from "./chunk-JAKIDQB2.js";
 import {
   defaultNamespaceAtFlatRoot,
   mergeMemorySearchDefaultFallback,
@@ -242,6 +233,15 @@ import {
   resolveRecallEnhancementCapabilities,
   resolveSecurityCapabilities
 } from "./chunk-RDQGLJRR.js";
+import {
+  EngramAccessForbiddenError,
+  EngramAccessInputError,
+  NamespaceNotWritableError
+} from "./chunk-2Z24E5W2.js";
+import {
+  AccessIdempotencyStore,
+  hashAccessIdempotencyPayload
+} from "./chunk-VFUEZZBS.js";
 import {
   abortError,
   throwIfAborted
@@ -4839,6 +4839,7 @@ var OPERATION_NAMES = [
   "capsule_import",
   "capsule_list",
   "memory_governance_run",
+  "entity_synthesis_run",
   "procedure_mining_run",
   "pattern_reinforcement_run",
   "procedural_stats",
@@ -6688,6 +6689,36 @@ var AccessAdminOpsSurface = class {
       reportPath: result.reportPath
     };
   }
+  /**
+   * Operator-triggered bulk drain of the entity synthesis queue (issue #2136).
+   * Every automatic call site processes at most 5 entities per event, which a
+   * busy deployment's queue inflow outruns; this surface drains a bounded
+   * batch on demand. `maxEntities` is clamped to 200 per call so a single
+   * request stays bounded; loop until `processed < requested` to drain fully.
+   */
+  async entitySynthesisRun(request, principal) {
+    const resolvedNamespace = this.deps.writableNamespaceFor(
+      request.namespace,
+      void 0,
+      request.authenticatedPrincipal ?? principal
+    );
+    let requested = 25;
+    if (request.maxEntities !== void 0) {
+      if (typeof request.maxEntities !== "number" || !Number.isInteger(request.maxEntities) || request.maxEntities < 1) {
+        throw new Error(
+          `Invalid maxEntities: ${String(request.maxEntities)} (expected an integer >= 1)`
+        );
+      }
+      requested = Math.min(200, request.maxEntities);
+    }
+    const processed = await this.deps.orchestrator.entitySynthesisCoordinator.processQueue(
+      resolvedNamespace,
+      requested
+    );
+    const storage = await this.deps.orchestrator.getStorage(resolvedNamespace);
+    const remaining = (await storage.readEntitySynthesisQueue()).length;
+    return { namespace: resolvedNamespace, requested, processed, remaining };
+  }
   async conversationIndexUpdate(request = {}) {
     if (!resolveIndexingCapabilities(this.deps.orchestrator.config).conversationIndex) {
       return {
@@ -10422,6 +10453,9 @@ var EngramAccessService = class {
       principal
     );
   }
+  async entitySynthesisRun(request, principal) {
+    return this.accessAdminOpsSurface.entitySynthesisRun(request, principal);
+  }
   async procedureMiningRun(request, principal) {
     const resolvedNamespace = this.writableNamespaceFor(
       request.namespace,
@@ -12385,4 +12419,4 @@ export {
   EngramAccessService,
   AccessAdminOpsSurface
 };
-//# sourceMappingURL=chunk-62QM5MKY.js.map
+//# sourceMappingURL=chunk-6ANPNUVL.js.map