@remnic/core 1.0.2 → 1.1.0

package/dist/schemas.js

@@ -17,12 +17,13 @@ import {
   MemorySummarySchema,
   ProactiveExtractionResultSchema,
   ProactiveQuestionsResultSchema,
+  ProcedureStepExtractSchema,
   ProfileConsolidationResultSchema,
   SuggestedLinksSchema,
   buildProfileConsolidationResultSchema,
   parseMemoryActionEligibilityContext,
   parseMemoryActionType
-} from "./chunk-MWGVGUIS.js";
+} from "./chunk-UEYA6UC7.js";
 export {
   BehaviorLoopAdjustmentSchema,
   BehaviorLoopPolicyStateSchema,
@@ -42,6 +43,7 @@ export {
   MemorySummarySchema,
   ProactiveExtractionResultSchema,
   ProactiveQuestionsResultSchema,
+  ProcedureStepExtractSchema,
   ProfileConsolidationResultSchema,
   SuggestedLinksSchema,
   buildProfileConsolidationResultSchema,

package/dist/sdk-compat.d.ts

@@ -3,6 +3,8 @@ interface SdkCapabilities {
     hasBeforePromptBuild: boolean;
     /** api.registerMemoryPromptSection() exists */
     hasRegisterMemoryPromptSection: boolean;
+    /** api.registerMemoryCapability() exists (new SDK >=2026.4.5) */
+    hasRegisterMemoryCapability: boolean;
     /** definePluginEntry from openclaw/plugin-sdk/plugin-entry is importable */
     hasDefinePluginEntry: boolean;
     /** api.runtime.* namespace exists */

package/dist/sdk-compat.js

@@ -5,14 +5,17 @@ import {
 // src/sdk-compat.ts
 function detectSdkCapabilities(api) {
   const hasRegisterMemoryPromptSection = typeof api.registerMemoryPromptSection === "function";
+  const hasRegisterMemoryCapability = typeof api.registerMemoryCapability === "function";
   const hasRuntimeNamespace = typeof api.runtime === "object" && api.runtime !== null;
   const hasRegistrationMode = typeof api.registrationMode === "string";
-  const sdkVersion = (hasRuntimeNamespace && typeof api.runtime?.version === "string" ? api.runtime.version : null) ?? readEnvVar("OPENCLAW_SERVICE_VERSION") ?? "legacy";
-  const isNewSdk = hasRegisterMemoryPromptSection || hasRuntimeNamespace || hasRegistrationMode;
-  const hasNewHookSystem = hasRegisterMemoryPromptSection || hasRegistrationMode;
+  const runtimeVersion = hasRuntimeNamespace && typeof api.runtime?.version === "string" ? api.runtime.version : null;
+  const isNewSdk = hasRegisterMemoryPromptSection || hasRegisterMemoryCapability || hasRuntimeNamespace || hasRegistrationMode;
+  const sdkVersion = runtimeVersion ?? (isNewSdk ? readEnvVar("OPENCLAW_SERVICE_VERSION") : null) ?? "legacy";
+  const hasNewHookSystem = hasRegisterMemoryPromptSection || hasRegisterMemoryCapability || hasRegistrationMode;
   return {
     hasBeforePromptBuild: hasNewHookSystem,
     hasRegisterMemoryPromptSection,
+    hasRegisterMemoryCapability,
     hasDefinePluginEntry: isNewSdk,
     // entry point is less risky, keep broad detection
     hasRuntimeNamespace,

package/dist/sdk-compat.js.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/sdk-compat.ts"],"sourcesContent":["/**\n * Runtime SDK capability detection.\n *\n * Probes the injected api object at registration time to determine which\n * OpenClaw SDK features are available. All hook registrations and entry-point\n * patterns branch on these flags so engram works on both old (≤2026.3.13)\n * and new (≥2026.3.22) runtimes.\n */\nimport { readEnvVar } from \"./runtime/env.js\";\n\nexport interface SdkCapabilities {\n  /** api.on(\"before_prompt_build\", ...) is available */\n  hasBeforePromptBuild: boolean;\n  /** api.registerMemoryPromptSection() exists */\n  hasRegisterMemoryPromptSection: boolean;\n  /** definePluginEntry from openclaw/plugin-sdk/plugin-entry is importable */\n  hasDefinePluginEntry: boolean;\n  /** api.runtime.* namespace exists */\n  hasRuntimeNamespace: boolean;\n  /** api.registrationMode is present */\n  hasRegistrationMode: boolean;\n  /** Hooks receive typed event/context objects */\n  hasTypedHooks: boolean;\n  /** Detected SDK version string, or \"legacy\" */\n  sdkVersion: string;\n  /** api.registrationMode value when present */\n  registrationMode: \"full\" | \"setup-only\" | \"setup-runtime\" | undefined;\n}\n\nexport function detectSdkCapabilities(api: Record<string, unknown>): SdkCapabilities {\n  const hasRegisterMemoryPromptSection =\n    typeof (api as any).registerMemoryPromptSection === \"function\";\n  const hasRuntimeNamespace =\n    typeof (api as any).runtime === \"object\" && (api as any).runtime !== null;\n  const hasRegistrationMode = typeof (api as any).registrationMode === \"string\";\n\n  const sdkVersion: string =\n    (hasRuntimeNamespace && typeof (api as any).runtime?.version === \"string\"\n      ? (api as any).runtime.version\n      : null) ??\n    readEnvVar(\"OPENCLAW_SERVICE_VERSION\") ??\n    \"legacy\";\n\n  // New SDK is indicated by any of the new API surfaces being present.\n  const isNewSdk =\n    hasRegisterMemoryPromptSection || hasRuntimeNamespace || hasRegistrationMode;\n\n  // New hook system requires registerMemoryPromptSection or registrationMode.\n  // Just having runtime.version is NOT sufficient — some legacy builds expose it.\n  const hasNewHookSystem = hasRegisterMemoryPromptSection || hasRegistrationMode;\n\n  return {\n    hasBeforePromptBuild: hasNewHookSystem,\n    hasRegisterMemoryPromptSection,\n    hasDefinePluginEntry: isNewSdk, // entry point is less risky, keep broad detection\n    hasRuntimeNamespace,\n    hasRegistrationMode,\n    hasTypedHooks: hasNewHookSystem,\n    sdkVersion,\n    registrationMode: hasRegistrationMode\n      ? ((api as any).registrationMode as SdkCapabilities[\"registrationMode\"])\n      : undefined,\n  };\n}\n"],"mappings":";;;;;AA6BO,SAAS,sBAAsB,KAA+C;AACnF,QAAM,iCACJ,OAAQ,IAAY,gCAAgC;AACtD,QAAM,sBACJ,OAAQ,IAAY,YAAY,YAAa,IAAY,YAAY;AACvE,QAAM,sBAAsB,OAAQ,IAAY,qBAAqB;AAErE,QAAM,cACH,uBAAuB,OAAQ,IAAY,SAAS,YAAY,WAC5D,IAAY,QAAQ,UACrB,SACJ,WAAW,0BAA0B,KACrC;AAGF,QAAM,WACJ,kCAAkC,uBAAuB;AAI3D,QAAM,mBAAmB,kCAAkC;AAE3D,SAAO;AAAA,IACL,sBAAsB;AAAA,IACtB;AAAA,IACA,sBAAsB;AAAA;AAAA,IACtB;AAAA,IACA;AAAA,IACA,eAAe;AAAA,IACf;AAAA,IACA,kBAAkB,sBACZ,IAAY,mBACd;AAAA,EACN;AACF;","names":[]}
+{"version":3,"sources":["../src/sdk-compat.ts"],"sourcesContent":["/**\n * Runtime SDK capability detection.\n *\n * Probes the injected api object at registration time to determine which\n * OpenClaw SDK features are available. All hook registrations and entry-point\n * patterns branch on these flags so engram works on both old (≤2026.3.13)\n * and new (≥2026.3.22) runtimes.\n */\nimport { readEnvVar } from \"./runtime/env.js\";\n\nexport interface SdkCapabilities {\n  /** api.on(\"before_prompt_build\", ...) is available */\n  hasBeforePromptBuild: boolean;\n  /** api.registerMemoryPromptSection() exists */\n  hasRegisterMemoryPromptSection: boolean;\n  /** api.registerMemoryCapability() exists (new SDK >=2026.4.5) */\n  hasRegisterMemoryCapability: boolean;\n  /** definePluginEntry from openclaw/plugin-sdk/plugin-entry is importable */\n  hasDefinePluginEntry: boolean;\n  /** api.runtime.* namespace exists */\n  hasRuntimeNamespace: boolean;\n  /** api.registrationMode is present */\n  hasRegistrationMode: boolean;\n  /** Hooks receive typed event/context objects */\n  hasTypedHooks: boolean;\n  /** Detected SDK version string, or \"legacy\" */\n  sdkVersion: string;\n  /** api.registrationMode value when present */\n  registrationMode: \"full\" | \"setup-only\" | \"setup-runtime\" | undefined;\n}\n\nexport function detectSdkCapabilities(api: Record<string, unknown>): SdkCapabilities {\n  const hasRegisterMemoryPromptSection =\n    typeof (api as any).registerMemoryPromptSection === \"function\";\n  const hasRegisterMemoryCapability =\n    typeof (api as any).registerMemoryCapability === \"function\";\n  const hasRuntimeNamespace =\n    typeof (api as any).runtime === \"object\" && (api as any).runtime !== null;\n  const hasRegistrationMode = typeof (api as any).registrationMode === \"string\";\n\n  const runtimeVersion =\n    hasRuntimeNamespace && typeof (api as any).runtime?.version === \"string\"\n      ? (api as any).runtime.version\n      : null;\n  const isNewSdk =\n    hasRegisterMemoryPromptSection || hasRegisterMemoryCapability || hasRuntimeNamespace || hasRegistrationMode;\n  const sdkVersion: string =\n    runtimeVersion ??\n    (isNewSdk ? readEnvVar(\"OPENCLAW_SERVICE_VERSION\") : null) ??\n    \"legacy\";\n\n  // New SDK is indicated by any of the new API surfaces being present.\n  // New hook system requires one of the authoritative new-SDK signals:\n  //   - registerMemoryPromptSection (pre-capability new SDKs, ≥2026.3.22)\n  //   - registerMemoryCapability   (capability-based SDKs, ≥2026.4.5; the\n  //     deprecated registerMemoryPromptSection may be absent)\n  //   - registrationMode           (explicit registration lifecycle signal)\n  // Just having runtime.version is NOT sufficient — some legacy builds\n  // expose it. Omitting registerMemoryCapability here would cause the\n  // legacy before_agent_start hook to be registered on new SDKs that only\n  // expose registerMemoryCapability, silently breaking memory injection.\n  const hasNewHookSystem =\n    hasRegisterMemoryPromptSection || hasRegisterMemoryCapability || hasRegistrationMode;\n\n  return {\n    hasBeforePromptBuild: hasNewHookSystem,\n    hasRegisterMemoryPromptSection,\n    hasRegisterMemoryCapability,\n    hasDefinePluginEntry: isNewSdk, // entry point is less risky, keep broad detection\n    hasRuntimeNamespace,\n    hasRegistrationMode,\n    hasTypedHooks: hasNewHookSystem,\n    sdkVersion,\n    registrationMode: hasRegistrationMode\n      ? ((api as any).registrationMode as SdkCapabilities[\"registrationMode\"])\n      : undefined,\n  };\n}\n"],"mappings":";;;;;AA+BO,SAAS,sBAAsB,KAA+C;AACnF,QAAM,iCACJ,OAAQ,IAAY,gCAAgC;AACtD,QAAM,8BACJ,OAAQ,IAAY,6BAA6B;AACnD,QAAM,sBACJ,OAAQ,IAAY,YAAY,YAAa,IAAY,YAAY;AACvE,QAAM,sBAAsB,OAAQ,IAAY,qBAAqB;AAErE,QAAM,iBACJ,uBAAuB,OAAQ,IAAY,SAAS,YAAY,WAC3D,IAAY,QAAQ,UACrB;AACN,QAAM,WACJ,kCAAkC,+BAA+B,uBAAuB;AAC1F,QAAM,aACJ,mBACC,WAAW,WAAW,0BAA0B,IAAI,SACrD;AAYF,QAAM,mBACJ,kCAAkC,+BAA+B;AAEnE,SAAO;AAAA,IACL,sBAAsB;AAAA,IACtB;AAAA,IACA;AAAA,IACA,sBAAsB;AAAA;AAAA,IACtB;AAAA,IACA;AAAA,IACA,eAAe;AAAA,IACf;AAAA,IACA,kBAAkB,sBACZ,IAAY,mBACd;AAAA,EACN;AACF;","names":[]}

package/dist/semantic-chunking.d.ts

@@ -0,0 +1,87 @@
+import { Chunk } from './chunking.js';
+
+/**
+ * Semantic Chunking with Smoothing-Based Topic Boundaries (Issue #368)
+ *
+ * An optional alternative to the recursive chunker in chunking.ts.
+ * Uses sentence embeddings + cosine similarity + smoothing to detect
+ * natural topic boundaries, producing more coherent chunks.
+ */
+
+interface SemanticChunkingConfig {
+    /** Target tokens per chunk. Default: 200. */
+    targetTokens: number;
+    /** Minimum tokens for a segment before merging with neighbor. Default: 100. */
+    minTokens: number;
+    /** Maximum tokens for a segment before recursive splitting. Default: 400. */
+    maxTokens: number;
+    /** Window size for the moving-average smoothing filter. Default: 3. */
+    smoothingWindowSize: number;
+    /** How many standard deviations below the mean constitutes a boundary. Default: 1.0. */
+    boundaryThresholdStdDevs: number;
+    /** Batch size for embedding requests. Default: 32. */
+    embeddingBatchSize: number;
+    /** Fall back to recursive chunking when embeddings are unavailable. Default: true. */
+    fallbackToRecursive: boolean;
+}
+declare const DEFAULT_SEMANTIC_CHUNKING_CONFIG: SemanticChunkingConfig;
+interface SemanticChunk extends Chunk {
+    /** Optional topic hint derived from position. */
+    topicLabel?: string;
+    /** Cosine similarity score at the trailing boundary of this chunk. */
+    boundaryScore: number;
+}
+interface SemanticChunkResult {
+    /** Whether content was split into multiple chunks. */
+    chunked: boolean;
+    /** The chunks produced. */
+    chunks: SemanticChunk[];
+    /** Sentence indices where topic splits occurred. */
+    boundaries: number[];
+    /** Which algorithm produced the result. */
+    method: "semantic" | "recursive-fallback";
+}
+/** Caller-provided function that embeds an array of texts, returning vectors. */
+type EmbedFn = (texts: string[]) => Promise<number[][]>;
+/**
+ * Cosine similarity between two vectors.
+ * Returns a value in [-1, 1]. Identical direction = 1, orthogonal = 0.
+ *
+ * NOTE: This duplicates cosineSimilarity in recall-mmr.ts and embedding-fallback.ts.
+ * Consider extracting to a shared math utility in a future refactor.
+ */
+declare function cosineSimilarity(a: number[], b: number[]): number;
+/**
+ * Arithmetic mean of a numeric series.
+ */
+declare function mean(series: number[]): number;
+/**
+ * Population standard deviation of a numeric series.
+ */
+declare function stddev(series: number[]): number;
+/**
+ * Simple moving average over a 1D series.
+ * The window is centered: for window size W, each output[i] averages
+ * series[i - floor(W/2) .. i + floor(W/2)], clamped to bounds.
+ *
+ * Even window sizes are rounded up to the next odd value so the window
+ * is symmetric around the center point (Finding 4, PR #420).
+ */
+declare function movingAverage(series: number[], windowSize: number): number[];
+/**
+ * Find indices in the series that are local minima AND below the threshold.
+ * A local minimum is a point lower than both its immediate neighbors
+ * (or lower-or-equal at series boundaries).
+ */
+declare function findLocalMinima(series: number[], threshold: number): number[];
+/**
+ * Semantic chunking with smoothing-based topic boundary detection.
+ *
+ * @param content   - Full text to chunk.
+ * @param embedFn   - Async function that embeds an array of texts.
+ * @param config    - Optional partial config overrides.
+ * @returns SemanticChunkResult
+ */
+declare function semanticChunkContent(content: string, embedFn: EmbedFn, config?: Partial<SemanticChunkingConfig>): Promise<SemanticChunkResult>;
+
+export { DEFAULT_SEMANTIC_CHUNKING_CONFIG, type EmbedFn, type SemanticChunk, type SemanticChunkResult, type SemanticChunkingConfig, cosineSimilarity, findLocalMinima, mean, movingAverage, semanticChunkContent, stddev };

package/dist/semantic-chunking.js

@@ -0,0 +1,20 @@
+import {
+  DEFAULT_SEMANTIC_CHUNKING_CONFIG,
+  cosineSimilarity,
+  findLocalMinima,
+  mean,
+  movingAverage,
+  semanticChunkContent,
+  stddev
+} from "./chunk-KVE7R4CG.js";
+import "./chunk-4WMCPJWX.js";
+export {
+  DEFAULT_SEMANTIC_CHUNKING_CONFIG,
+  cosineSimilarity,
+  findLocalMinima,
+  mean,
+  movingAverage,
+  semanticChunkContent,
+  stddev
+};
+//# sourceMappingURL=semantic-chunking.js.map

package/dist/semantic-chunking.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":[],"sourcesContent":[],"mappings":"","names":[]}

package/dist/semantic-consolidation-DrvSYRdB.d.ts

@@ -0,0 +1,119 @@
+import { PluginConfig, MemoryFile } from './types.js';
+import { R as RolloutSummaryInput, M as MaterializeResult } from './codex-materialize-CQlLTzke.js';
+import { LoggerBackend } from './logger.js';
+
+/**
+ * memory-extension-host/types.ts — Types for third-party memory extension discovery.
+ *
+ * Memory extensions live under ~/.remnic/memory_extensions/<slug>/ and provide
+ * instructions.md (required), schema.json (optional), and examples/*.md (optional).
+ */
+interface DiscoveredExtension {
+    readonly name: string;
+    readonly root: string;
+    readonly instructionsPath: string;
+    readonly instructions: string;
+    readonly schema?: ExtensionSchema;
+    readonly examplesPaths: string[];
+}
+interface ExtensionSchema {
+    readonly memoryTypes?: Array<"fact" | "preference" | "procedure" | "reference">;
+    readonly groupingHints?: string[];
+    readonly version?: string;
+}
+
+/**
+ * memory-extension-host/host-discovery.ts — Discover third-party memory extensions.
+ *
+ * Scans a root directory (typically ~/.remnic/memory_extensions/) for valid
+ * extension subdirectories. Each extension must contain an instructions.md.
+ * The discovery process is read-only and NEVER reads or executes files under
+ * any extension's scripts/ directory.
+ */
+
+/** Total token budget for all discovered extension instructions combined. */
+declare const REMNIC_EXTENSIONS_TOTAL_TOKEN_LIMIT = 5000;
+/**
+ * Discover all valid memory extensions under the given root directory.
+ *
+ * Returns extensions sorted by name. Skips entries with warnings when:
+ * - The slug is invalid (not lowercase alphanumeric + hyphens, or > 64 chars)
+ * - instructions.md is missing
+ * - schema.json is malformed (extension still returned but schema is undefined)
+ *
+ * NEVER reads files under any extension's scripts/ directory.
+ */
+declare function discoverMemoryExtensions(root: string, log: Pick<LoggerBackend, "warn" | "debug">): Promise<DiscoveredExtension[]>;
+/**
+ * Resolve the memory extensions root directory from config.
+ * If memoryExtensionsRoot is empty, derive from memoryDir by going up to
+ * the Remnic home dir and appending memory_extensions.
+ *
+ * Moved here from semantic-consolidation.ts (#428 Finding 3) because this
+ * is a generic config-to-path resolver with no consolidation logic.
+ */
+declare function resolveExtensionsRoot(config: PluginConfig): string;
+
+/**
+ * semantic-consolidation.ts — Semantic Consolidation Engine
+ *
+ * Finds clusters of semantically similar memories using token overlap,
+ * synthesizes canonical versions via LLM, and archives the originals.
+ * Reduces memory store bloat while preserving all unique information.
+ */
+
+interface ConsolidationCluster {
+    category: string;
+    memories: MemoryFile[];
+    overlapScore: number;
+    canonicalContent?: string;
+}
+interface SemanticConsolidationResult {
+    clustersFound: number;
+    memoriesConsolidated: number;
+    memoriesArchived: number;
+    errors: number;
+    clusters: ConsolidationCluster[];
+}
+/**
+ * Find clusters of semantically similar memories using token overlap.
+ */
+declare function findSimilarClusters(memories: MemoryFile[], config: {
+    threshold: number;
+    minClusterSize: number;
+    excludeCategories: string[];
+    maxPerRun: number;
+}): ConsolidationCluster[];
+/**
+ * Build the LLM prompt for synthesizing a canonical memory from a cluster.
+ */
+declare function buildConsolidationPrompt(cluster: ConsolidationCluster): string;
+/**
+ * Parse the LLM response to extract the canonical content.
+ */
+declare function parseConsolidationResponse(response: string): string;
+/**
+ * Discover extensions and build the block to append to a consolidation prompt.
+ * Returns "" when extensions are disabled or none are found.
+ */
+declare function buildExtensionsBlockForConsolidation(config: PluginConfig): Promise<string>;
+/**
+ * Optional post-consolidation hook — materializes the namespace into Codex's
+ * native memory layout when the consolidation run finishes. Kept here (rather
+ * than in orchestrator.ts) so #378 doesn't conflict with Wave 1 edits.
+ *
+ * Safe to call regardless of config state: honors `codexMaterializeMemories`
+ * and `codexMaterializeOnConsolidation` and silently becomes a no-op when
+ * either is disabled.
+ */
+declare function materializeAfterSemanticConsolidation(options: {
+    config: PluginConfig;
+    namespace?: string;
+    memories?: MemoryFile[];
+    memoryDir?: string;
+    codexHome?: string;
+    rolloutSummaries?: RolloutSummaryInput[];
+    now?: Date;
+}): Promise<MaterializeResult | null>;
+
+export { type ConsolidationCluster as C, type DiscoveredExtension as D, type ExtensionSchema as E, REMNIC_EXTENSIONS_TOTAL_TOKEN_LIMIT as R, type SemanticConsolidationResult as S, buildConsolidationPrompt as a, buildExtensionsBlockForConsolidation as b, discoverMemoryExtensions as d, findSimilarClusters as f, materializeAfterSemanticConsolidation as m, parseConsolidationResponse as p, resolveExtensionsRoot as r };

package/dist/semantic-consolidation.d.ts

@@ -1,42 +1,4 @@
-import { MemoryFile } from './types.js';
-
-/**
- * semantic-consolidation.ts — Semantic Consolidation Engine
- *
- * Finds clusters of semantically similar memories using token overlap,
- * synthesizes canonical versions via LLM, and archives the originals.
- * Reduces memory store bloat while preserving all unique information.
- */
-
-interface ConsolidationCluster {
-    category: string;
-    memories: MemoryFile[];
-    overlapScore: number;
-    canonicalContent?: string;
-}
-interface SemanticConsolidationResult {
-    clustersFound: number;
-    memoriesConsolidated: number;
-    memoriesArchived: number;
-    errors: number;
-    clusters: ConsolidationCluster[];
-}
-/**
- * Find clusters of semantically similar memories using token overlap.
- */
-declare function findSimilarClusters(memories: MemoryFile[], config: {
-    threshold: number;
-    minClusterSize: number;
-    excludeCategories: string[];
-    maxPerRun: number;
-}): ConsolidationCluster[];
-/**
- * Build the LLM prompt for synthesizing a canonical memory from a cluster.
- */
-declare function buildConsolidationPrompt(cluster: ConsolidationCluster): string;
-/**
- * Parse the LLM response to extract the canonical content.
- */
-declare function parseConsolidationResponse(response: string): string;
-
-export { type ConsolidationCluster, type SemanticConsolidationResult, buildConsolidationPrompt, findSimilarClusters, parseConsolidationResponse };
+import './types.js';
+import './codex-materialize-CQlLTzke.js';
+export { C as ConsolidationCluster, S as SemanticConsolidationResult, a as buildConsolidationPrompt, b as buildExtensionsBlockForConsolidation, f as findSimilarClusters, m as materializeAfterSemanticConsolidation, p as parseConsolidationResponse, r as resolveExtensionsRoot } from './semantic-consolidation-DrvSYRdB.js';
+import './logger.js';

package/dist/semantic-consolidation.js

@@ -1,12 +1,33 @@
 import {
   buildConsolidationPrompt,
+  buildExtensionsBlockForConsolidation,
   findSimilarClusters,
+  materializeAfterSemanticConsolidation,
   parseConsolidationResponse
-} from "./chunk-2CJCWDMR.js";
+} from "./chunk-SYUK3VLY.js";
+import {
+  resolveExtensionsRoot
+} from "./chunk-EJI5XIBB.js";
 import "./chunk-DT5TVLJE.js";
+import "./chunk-GV6NLQ4X.js";
+import "./chunk-3WHVNEN7.js";
+import "./chunk-4KAN3GZ3.js";
+import "./chunk-6ZH4TU6I.js";
+import "./chunk-SCU65EZI.js";
+import "./chunk-BOUYNNYD.js";
+import "./chunk-6PFRXT4K.js";
+import "./chunk-TP4FZJIZ.js";
+import "./chunk-DM2T26WE.js";
+import "./chunk-QSVPYQPG.js";
+import "./chunk-M62O4P4T.js";
+import "./chunk-4DJQYKMN.js";
+import "./chunk-2ODBA7MQ.js";
 export {
   buildConsolidationPrompt,
+  buildExtensionsBlockForConsolidation,
   findSimilarClusters,
-  parseConsolidationResponse
+  materializeAfterSemanticConsolidation,
+  parseConsolidationResponse,
+  resolveExtensionsRoot
 };
 //# sourceMappingURL=semantic-consolidation.js.map

package/dist/semantic-rule-promotion.js

@@ -1,16 +1,19 @@
 import {
   promoteSemanticRuleFromMemory
-} from "./chunk-L7WO3MZ4.js";
-import "./chunk-QWUUMMIK.js";
-import "./chunk-U4PV25RD.js";
-import "./chunk-ESSMF2FR.js";
-import "./chunk-TP4FZJIZ.js";
+} from "./chunk-7ECD5ATE.js";
+import "./chunk-GV6NLQ4X.js";
+import "./chunk-3WHVNEN7.js";
+import "./chunk-4KAN3GZ3.js";
+import "./chunk-6ZH4TU6I.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-BOUYNNYD.js";
+import "./chunk-6PFRXT4K.js";
+import "./chunk-TP4FZJIZ.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-M62O4P4T.js";
-import "./chunk-KWBU5S5U.js";
+import "./chunk-4DJQYKMN.js";
+import "./chunk-2ODBA7MQ.js";
 export {
   promoteSemanticRuleFromMemory
 };

package/dist/semantic-rule-verifier.js

@@ -1,17 +1,20 @@
 import {
   searchVerifiedSemanticRules
-} from "./chunk-J47FNDR7.js";
-import "./chunk-QWUUMMIK.js";
-import "./chunk-U4PV25RD.js";
-import "./chunk-ESSMF2FR.js";
-import "./chunk-TP4FZJIZ.js";
+} from "./chunk-JIU55F3X.js";
+import "./chunk-DT5TVLJE.js";
+import "./chunk-GV6NLQ4X.js";
+import "./chunk-3WHVNEN7.js";
+import "./chunk-4KAN3GZ3.js";
+import "./chunk-6ZH4TU6I.js";
 import "./chunk-SCU65EZI.js";
 import "./chunk-BOUYNNYD.js";
+import "./chunk-6PFRXT4K.js";
+import "./chunk-TP4FZJIZ.js";
 import "./chunk-DM2T26WE.js";
 import "./chunk-QSVPYQPG.js";
 import "./chunk-M62O4P4T.js";
-import "./chunk-DT5TVLJE.js";
-import "./chunk-KWBU5S5U.js";
+import "./chunk-4DJQYKMN.js";
+import "./chunk-2ODBA7MQ.js";
 export {
   searchVerifiedSemanticRules
 };

package/dist/session-observer-state.js

@@ -1,9 +1,9 @@
 import {
   SessionObserverState,
   normalizeObserverBands
-} from "./chunk-ZKYI7UVO.js";
+} from "./chunk-JR4ZC3G4.js";
 import "./chunk-Z5LAYHGJ.js";
-import "./chunk-KWBU5S5U.js";
+import "./chunk-2ODBA7MQ.js";
 export {
   SessionObserverState,
   normalizeObserverBands

package/dist/session-toggles.d.ts

@@ -0,0 +1,22 @@
+interface SessionToggleStore {
+    isDisabled(sessionKey: string, agentId: string): Promise<boolean>;
+    resolve(sessionKey: string, agentId: string): Promise<{
+        disabled: boolean;
+        source: "primary" | "secondary" | "none";
+        updatedAt?: string;
+    }>;
+    setDisabled(sessionKey: string, agentId: string, disabled: boolean): Promise<void>;
+    clear(sessionKey: string, agentId: string): Promise<void>;
+    list(): Promise<Array<{
+        sessionKey: string;
+        agentId: string;
+        disabled: boolean;
+        updatedAt: string;
+    }>>;
+}
+interface FileToggleStoreOptions {
+    secondaryReadOnlyPath?: string;
+}
+declare function createFileToggleStore(filePath: string, options?: FileToggleStoreOptions): SessionToggleStore;
+
+export { type SessionToggleStore, createFileToggleStore };

package/dist/session-toggles.js

@@ -0,0 +1,116 @@
+// src/session-toggles.ts
+import { mkdir, readFile, writeFile } from "fs/promises";
+import path from "path";
+function encodeToggleKey(sessionKey, agentId) {
+  return `${encodeURIComponent(sessionKey)}::${encodeURIComponent(agentId)}`;
+}
+function decodeToggleKey(key) {
+  const [encodedSessionKey, encodedAgentId] = key.split("::");
+  if (!encodedSessionKey || !encodedAgentId) return null;
+  return {
+    sessionKey: decodeURIComponent(encodedSessionKey),
+    agentId: decodeURIComponent(encodedAgentId)
+  };
+}
+async function safeReadToggleFile(filePath) {
+  try {
+    const raw = await readFile(filePath, "utf8");
+    const parsed = JSON.parse(raw);
+    if (!parsed || typeof parsed !== "object" || typeof parsed.entries !== "object") {
+      return { version: 1, entries: {} };
+    }
+    return {
+      version: 1,
+      entries: Object.fromEntries(
+        Object.entries(parsed.entries).filter(
+          ([, value]) => value && typeof value === "object" && typeof value.disabled === "boolean" && typeof value.updatedAt === "string"
+        )
+      )
+    };
+  } catch {
+    return { version: 1, entries: {} };
+  }
+}
+function createFileToggleStore(filePath, options = {}) {
+  let writeChain = Promise.resolve();
+  async function queueWrite(operation) {
+    const run = writeChain.catch(() => void 0).then(operation);
+    writeChain = run.catch(() => void 0);
+    await run;
+  }
+  async function writeToggleFile(next) {
+    await mkdir(path.dirname(filePath), { recursive: true });
+    await writeFile(filePath, JSON.stringify(next, null, 2), "utf8");
+  }
+  async function readPrimary() {
+    return safeReadToggleFile(filePath);
+  }
+  async function readSecondary() {
+    if (!options.secondaryReadOnlyPath) return { version: 1, entries: {} };
+    return safeReadToggleFile(options.secondaryReadOnlyPath);
+  }
+  return {
+    async isDisabled(sessionKey, agentId) {
+      const resolved = await this.resolve(sessionKey, agentId);
+      return resolved.disabled;
+    },
+    async resolve(sessionKey, agentId) {
+      const key = encodeToggleKey(sessionKey, agentId);
+      const primary = await readPrimary();
+      if (primary.entries[key]) {
+        return {
+          disabled: primary.entries[key].disabled,
+          source: "primary",
+          updatedAt: primary.entries[key].updatedAt
+        };
+      }
+      const secondary = await readSecondary();
+      if (secondary.entries[key]) {
+        return {
+          disabled: secondary.entries[key].disabled,
+          source: "secondary",
+          updatedAt: secondary.entries[key].updatedAt
+        };
+      }
+      return { disabled: false, source: "none" };
+    },
+    async setDisabled(sessionKey, agentId, disabled) {
+      const key = encodeToggleKey(sessionKey, agentId);
+      await queueWrite(async () => {
+        const current = await readPrimary();
+        current.entries[key] = {
+          disabled,
+          updatedAt: (/* @__PURE__ */ new Date()).toISOString()
+        };
+        await writeToggleFile(current);
+      });
+    },
+    async clear(sessionKey, agentId) {
+      const key = encodeToggleKey(sessionKey, agentId);
+      await queueWrite(async () => {
+        const current = await readPrimary();
+        delete current.entries[key];
+        await writeToggleFile(current);
+      });
+    },
+    async list() {
+      const current = await readPrimary();
+      return Object.entries(current.entries).map(([key, value]) => {
+        const decoded = decodeToggleKey(key);
+        if (!decoded) return null;
+        return {
+          sessionKey: decoded.sessionKey,
+          agentId: decoded.agentId,
+          disabled: value.disabled,
+          updatedAt: value.updatedAt
+        };
+      }).filter(
+        (value) => value !== null
+      );
+    }
+  };
+}
+export {
+  createFileToggleStore
+};
+//# sourceMappingURL=session-toggles.js.map

package/dist/session-toggles.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/session-toggles.ts"],"sourcesContent":["import { mkdir, readFile, writeFile } from \"node:fs/promises\";\nimport path from \"node:path\";\n\nexport interface SessionToggleStore {\n  isDisabled(sessionKey: string, agentId: string): Promise<boolean>;\n  resolve(sessionKey: string, agentId: string): Promise<{\n    disabled: boolean;\n    source: \"primary\" | \"secondary\" | \"none\";\n    updatedAt?: string;\n  }>;\n  setDisabled(sessionKey: string, agentId: string, disabled: boolean): Promise<void>;\n  clear(sessionKey: string, agentId: string): Promise<void>;\n  list(): Promise<Array<{ sessionKey: string; agentId: string; disabled: boolean; updatedAt: string }>>;\n}\n\ninterface ToggleEntry {\n  disabled: boolean;\n  updatedAt: string;\n}\n\ninterface ToggleFile {\n  version: 1;\n  entries: Record<string, ToggleEntry>;\n}\n\ninterface FileToggleStoreOptions {\n  secondaryReadOnlyPath?: string;\n}\n\nfunction encodeToggleKey(sessionKey: string, agentId: string): string {\n  return `${encodeURIComponent(sessionKey)}::${encodeURIComponent(agentId)}`;\n}\n\nfunction decodeToggleKey(key: string): { sessionKey: string; agentId: string } | null {\n  const [encodedSessionKey, encodedAgentId] = key.split(\"::\");\n  if (!encodedSessionKey || !encodedAgentId) return null;\n  return {\n    sessionKey: decodeURIComponent(encodedSessionKey),\n    agentId: decodeURIComponent(encodedAgentId),\n  };\n}\n\nasync function safeReadToggleFile(filePath: string): Promise<ToggleFile> {\n  try {\n    const raw = await readFile(filePath, \"utf8\");\n    const parsed = JSON.parse(raw) as Partial<ToggleFile>;\n    if (!parsed || typeof parsed !== \"object\" || typeof parsed.entries !== \"object\") {\n      return { version: 1, entries: {} };\n    }\n    return {\n      version: 1,\n      entries: Object.fromEntries(\n        Object.entries(parsed.entries).filter(\n          ([, value]) =>\n            value &&\n            typeof value === \"object\" &&\n            typeof value.disabled === \"boolean\" &&\n            typeof value.updatedAt === \"string\",\n        ),\n      ) as Record<string, ToggleEntry>,\n    };\n  } catch {\n    return { version: 1, entries: {} };\n  }\n}\n\nexport function createFileToggleStore(\n  filePath: string,\n  options: FileToggleStoreOptions = {},\n): SessionToggleStore {\n  let writeChain = Promise.resolve();\n\n  async function queueWrite(operation: () => Promise<void>): Promise<void> {\n    const run = writeChain.catch(() => undefined).then(operation);\n    writeChain = run.catch(() => undefined);\n    await run;\n  }\n\n  async function writeToggleFile(next: ToggleFile): Promise<void> {\n    await mkdir(path.dirname(filePath), { recursive: true });\n    await writeFile(filePath, JSON.stringify(next, null, 2), \"utf8\");\n  }\n\n  async function readPrimary(): Promise<ToggleFile> {\n    return safeReadToggleFile(filePath);\n  }\n\n  async function readSecondary(): Promise<ToggleFile> {\n    if (!options.secondaryReadOnlyPath) return { version: 1, entries: {} };\n    return safeReadToggleFile(options.secondaryReadOnlyPath);\n  }\n\n  return {\n    async isDisabled(sessionKey: string, agentId: string): Promise<boolean> {\n      const resolved = await this.resolve(sessionKey, agentId);\n      return resolved.disabled;\n    },\n\n    async resolve(sessionKey: string, agentId: string) {\n      const key = encodeToggleKey(sessionKey, agentId);\n      const primary = await readPrimary();\n      if (primary.entries[key]) {\n        return {\n          disabled: primary.entries[key].disabled,\n          source: \"primary\" as const,\n          updatedAt: primary.entries[key].updatedAt,\n        };\n      }\n      const secondary = await readSecondary();\n      if (secondary.entries[key]) {\n        return {\n          disabled: secondary.entries[key].disabled,\n          source: \"secondary\" as const,\n          updatedAt: secondary.entries[key].updatedAt,\n        };\n      }\n      return { disabled: false, source: \"none\" as const };\n    },\n\n    async setDisabled(sessionKey: string, agentId: string, disabled: boolean): Promise<void> {\n      const key = encodeToggleKey(sessionKey, agentId);\n      await queueWrite(async () => {\n        const current = await readPrimary();\n        current.entries[key] = {\n          disabled,\n          updatedAt: new Date().toISOString(),\n        };\n        await writeToggleFile(current);\n      });\n    },\n\n    async clear(sessionKey: string, agentId: string): Promise<void> {\n      const key = encodeToggleKey(sessionKey, agentId);\n      await queueWrite(async () => {\n        const current = await readPrimary();\n        delete current.entries[key];\n        await writeToggleFile(current);\n      });\n    },\n\n    async list() {\n      const current = await readPrimary();\n      return Object.entries(current.entries)\n        .map(([key, value]) => {\n          const decoded = decodeToggleKey(key);\n          if (!decoded) return null;\n          return {\n            sessionKey: decoded.sessionKey,\n            agentId: decoded.agentId,\n            disabled: value.disabled,\n            updatedAt: value.updatedAt,\n          };\n        })\n        .filter((value): value is { sessionKey: string; agentId: string; disabled: boolean; updatedAt: string } =>\n          value !== null\n        );\n    },\n  };\n}\n"],"mappings":"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","names":[]}