@remnic/core 1.1.0 → 1.1.1

package/dist/schemas.d.ts

@@ -7,13 +7,13 @@ declare const MemoryActionEligibilityContextSchema: z.ZodObject<{
     importance: z.ZodNumber;
     source: z.ZodEnum<["extraction", "consolidation", "replay", "manual", "unknown"]>;
 }, "strict", z.ZodTypeAny, {
+    source: "extraction" | "consolidation" | "replay" | "manual" | "unknown";
     confidence: number;
-    source: "unknown" | "extraction" | "consolidation" | "replay" | "manual";
     lifecycleState: "active" | "archived" | "candidate" | "validated" | "stale";
     importance: number;
 }, {
+    source: "extraction" | "consolidation" | "replay" | "manual" | "unknown";
     confidence: number;
-    source: "unknown" | "extraction" | "consolidation" | "replay" | "manual";
     lifecycleState: "active" | "archived" | "candidate" | "validated" | "stale";
     importance: number;
 }>;
@@ -54,7 +54,7 @@ declare const ProcedureStepExtractSchema: z.ZodObject<{
     optional?: boolean | null | undefined;
 }>;
 declare const ExtractedFactSchema: z.ZodObject<{
-    category: z.ZodEnum<["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule", "procedure"]>;
+    category: z.ZodEnum<["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule", "procedure", "reasoning_trace"]>;
     content: z.ZodString;
     confidence: z.ZodNumber;
     tags: z.ZodArray<z.ZodString, "many">;
@@ -95,11 +95,63 @@ declare const ExtractedFactSchema: z.ZodObject<{
         expectedOutcome?: string | null | undefined;
         optional?: boolean | null | undefined;
     }>, "many">>>;
+    reasoningTrace: z.ZodNullable<z.ZodOptional<z.ZodEffects<z.ZodObject<{
+        steps: z.ZodArray<z.ZodObject<{
+            order: z.ZodNumber;
+            description: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            description: string;
+            order: number;
+        }, {
+            description: string;
+            order: number;
+        }>, "many">;
+        finalAnswer: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        final_answer: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        observedOutcome: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        observed_outcome: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        steps: {
+            description: string;
+            order: number;
+        }[];
+        finalAnswer?: string | null | undefined;
+        final_answer?: string | null | undefined;
+        observedOutcome?: string | null | undefined;
+        observed_outcome?: string | null | undefined;
+    }, {
+        steps: {
+            description: string;
+            order: number;
+        }[];
+        finalAnswer?: string | null | undefined;
+        final_answer?: string | null | undefined;
+        observedOutcome?: string | null | undefined;
+        observed_outcome?: string | null | undefined;
+    }>, {
+        steps: {
+            description: string;
+            order: number;
+        }[];
+        finalAnswer?: string | null | undefined;
+        final_answer?: string | null | undefined;
+        observedOutcome?: string | null | undefined;
+        observed_outcome?: string | null | undefined;
+    }, {
+        steps: {
+            description: string;
+            order: number;
+        }[];
+        finalAnswer?: string | null | undefined;
+        final_answer?: string | null | undefined;
+        observedOutcome?: string | null | undefined;
+        observed_outcome?: string | null | undefined;
+    }>>>;
 }, "strip", z.ZodTypeAny, {
-    category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure";
+    tags: string[];
     content: string;
+    category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace";
     confidence: number;
-    tags: string[];
     entityRef?: string | null | undefined;
     structuredAttributes?: Record<string, string> | null | undefined;
     promptedByQuestion?: string | null | undefined;
@@ -113,11 +165,21 @@ declare const ExtractedFactSchema: z.ZodObject<{
         expectedOutcome?: string | null | undefined;
         optional?: boolean | null | undefined;
     }[] | null | undefined;
+    reasoningTrace?: {
+        steps: {
+            description: string;
+            order: number;
+        }[];
+        finalAnswer?: string | null | undefined;
+        final_answer?: string | null | undefined;
+        observedOutcome?: string | null | undefined;
+        observed_outcome?: string | null | undefined;
+    } | null | undefined;
 }, {
-    category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure";
+    tags: string[];
     content: string;
+    category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace";
     confidence: number;
-    tags: string[];
     entityRef?: string | null | undefined;
     structuredAttributes?: Record<string, string> | null | undefined;
     promptedByQuestion?: string | null | undefined;
@@ -131,6 +193,16 @@ declare const ExtractedFactSchema: z.ZodObject<{
         expectedOutcome?: string | null | undefined;
         optional?: boolean | null | undefined;
     }[] | null | undefined;
+    reasoningTrace?: {
+        steps: {
+            description: string;
+            order: number;
+        }[];
+        finalAnswer?: string | null | undefined;
+        final_answer?: string | null | undefined;
+        observedOutcome?: string | null | undefined;
+        observed_outcome?: string | null | undefined;
+    } | null | undefined;
 }>;
 declare const EntityMentionSchema: z.ZodObject<{
     name: z.ZodString;
@@ -229,7 +301,7 @@ declare const ExtractedRelationshipSchema: z.ZodObject<{
 }>;
 declare const ProactiveExtractionResultSchema: z.ZodObject<{
     facts: z.ZodArray<z.ZodObject<{
-        category: z.ZodEnum<["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule", "procedure"]>;
+        category: z.ZodEnum<["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule", "procedure", "reasoning_trace"]>;
         content: z.ZodString;
         confidence: z.ZodNumber;
         tags: z.ZodArray<z.ZodString, "many">;
@@ -270,11 +342,63 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
             expectedOutcome?: string | null | undefined;
             optional?: boolean | null | undefined;
         }>, "many">>>;
+        reasoningTrace: z.ZodNullable<z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            steps: z.ZodArray<z.ZodObject<{
+                order: z.ZodNumber;
+                description: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                description: string;
+                order: number;
+            }, {
+                description: string;
+                order: number;
+            }>, "many">;
+            finalAnswer: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            final_answer: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            observedOutcome: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            observed_outcome: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        }, {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        }>, {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        }, {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
-        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure";
+        tags: string[];
         content: string;
+        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace";
         confidence: number;
-        tags: string[];
         entityRef?: string | null | undefined;
         structuredAttributes?: Record<string, string> | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -288,11 +412,21 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
             expectedOutcome?: string | null | undefined;
             optional?: boolean | null | undefined;
         }[] | null | undefined;
+        reasoningTrace?: {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        } | null | undefined;
     }, {
-        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure";
+        tags: string[];
         content: string;
+        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace";
         confidence: number;
-        tags: string[];
         entityRef?: string | null | undefined;
         structuredAttributes?: Record<string, string> | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -306,6 +440,16 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
             expectedOutcome?: string | null | undefined;
             optional?: boolean | null | undefined;
         }[] | null | undefined;
+        reasoningTrace?: {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        } | null | undefined;
     }>, "many">;
     profileUpdates: z.ZodArray<z.ZodString, "many">;
     entities: z.ZodArray<z.ZodObject<{
@@ -365,10 +509,10 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
     }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
     facts: {
-        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure";
+        tags: string[];
         content: string;
+        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace";
         confidence: number;
-        tags: string[];
         entityRef?: string | null | undefined;
         structuredAttributes?: Record<string, string> | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -382,6 +526,16 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
             expectedOutcome?: string | null | undefined;
             optional?: boolean | null | undefined;
         }[] | null | undefined;
+        reasoningTrace?: {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        } | null | undefined;
     }[];
     entities: {
         facts: string[];
@@ -403,10 +557,10 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
     }[] | null | undefined;
 }, {
     facts: {
-        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure";
+        tags: string[];
         content: string;
+        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace";
         confidence: number;
-        tags: string[];
         entityRef?: string | null | undefined;
         structuredAttributes?: Record<string, string> | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -420,6 +574,16 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
             expectedOutcome?: string | null | undefined;
             optional?: boolean | null | undefined;
         }[] | null | undefined;
+        reasoningTrace?: {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        } | null | undefined;
     }[];
     entities: {
         facts: string[];
@@ -442,7 +606,7 @@ declare const ProactiveExtractionResultSchema: z.ZodObject<{
 }>;
 declare const ExtractionResultSchema: z.ZodObject<{
     facts: z.ZodArray<z.ZodObject<{
-        category: z.ZodEnum<["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule", "procedure"]>;
+        category: z.ZodEnum<["fact", "preference", "correction", "entity", "decision", "relationship", "principle", "commitment", "moment", "skill", "rule", "procedure", "reasoning_trace"]>;
         content: z.ZodString;
         confidence: z.ZodNumber;
         tags: z.ZodArray<z.ZodString, "many">;
@@ -483,11 +647,63 @@ declare const ExtractionResultSchema: z.ZodObject<{
             expectedOutcome?: string | null | undefined;
             optional?: boolean | null | undefined;
         }>, "many">>>;
+        reasoningTrace: z.ZodNullable<z.ZodOptional<z.ZodEffects<z.ZodObject<{
+            steps: z.ZodArray<z.ZodObject<{
+                order: z.ZodNumber;
+                description: z.ZodString;
+            }, "strip", z.ZodTypeAny, {
+                description: string;
+                order: number;
+            }, {
+                description: string;
+                order: number;
+            }>, "many">;
+            finalAnswer: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            final_answer: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            observedOutcome: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+            observed_outcome: z.ZodNullable<z.ZodOptional<z.ZodString>>;
+        }, "strip", z.ZodTypeAny, {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        }, {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        }>, {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        }, {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        }>>>;
     }, "strip", z.ZodTypeAny, {
-        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure";
+        tags: string[];
         content: string;
+        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace";
         confidence: number;
-        tags: string[];
         entityRef?: string | null | undefined;
         structuredAttributes?: Record<string, string> | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -501,11 +717,21 @@ declare const ExtractionResultSchema: z.ZodObject<{
             expectedOutcome?: string | null | undefined;
             optional?: boolean | null | undefined;
         }[] | null | undefined;
+        reasoningTrace?: {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        } | null | undefined;
     }, {
-        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure";
+        tags: string[];
         content: string;
+        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace";
         confidence: number;
-        tags: string[];
         entityRef?: string | null | undefined;
         structuredAttributes?: Record<string, string> | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -519,6 +745,16 @@ declare const ExtractionResultSchema: z.ZodObject<{
             expectedOutcome?: string | null | undefined;
             optional?: boolean | null | undefined;
         }[] | null | undefined;
+        reasoningTrace?: {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        } | null | undefined;
     }>, "many">;
     profileUpdates: z.ZodArray<z.ZodString, "many">;
     entities: z.ZodArray<z.ZodObject<{
@@ -592,10 +828,10 @@ declare const ExtractionResultSchema: z.ZodObject<{
     }>, "many">>>;
 }, "strip", z.ZodTypeAny, {
     facts: {
-        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure";
+        tags: string[];
         content: string;
+        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace";
         confidence: number;
-        tags: string[];
         entityRef?: string | null | undefined;
         structuredAttributes?: Record<string, string> | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -609,6 +845,16 @@ declare const ExtractionResultSchema: z.ZodObject<{
             expectedOutcome?: string | null | undefined;
             optional?: boolean | null | undefined;
         }[] | null | undefined;
+        reasoningTrace?: {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        } | null | undefined;
     }[];
     entities: {
         facts: string[];
@@ -636,10 +882,10 @@ declare const ExtractionResultSchema: z.ZodObject<{
     identityReflection?: string | null | undefined;
 }, {
     facts: {
-        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure";
+        tags: string[];
         content: string;
+        category: "fact" | "preference" | "correction" | "entity" | "decision" | "relationship" | "principle" | "commitment" | "moment" | "skill" | "rule" | "procedure" | "reasoning_trace";
         confidence: number;
-        tags: string[];
         entityRef?: string | null | undefined;
         structuredAttributes?: Record<string, string> | null | undefined;
         promptedByQuestion?: string | null | undefined;
@@ -653,6 +899,16 @@ declare const ExtractionResultSchema: z.ZodObject<{
             expectedOutcome?: string | null | undefined;
             optional?: boolean | null | undefined;
         }[] | null | undefined;
+        reasoningTrace?: {
+            steps: {
+                description: string;
+                order: number;
+            }[];
+            finalAnswer?: string | null | undefined;
+            final_answer?: string | null | undefined;
+            observedOutcome?: string | null | undefined;
+            observed_outcome?: string | null | undefined;
+        } | null | undefined;
     }[];
     entities: {
         facts: string[];
@@ -943,8 +1199,8 @@ declare const BehaviorLoopAdjustmentSchema: z.ZodObject<{
     reason: z.ZodString;
     appliedAt: z.ZodString;
 }, "strip", z.ZodTypeAny, {
-    confidence: number;
     reason: string;
+    confidence: number;
     parameter: string;
     previousValue: number;
     nextValue: number;
@@ -952,8 +1208,8 @@ declare const BehaviorLoopAdjustmentSchema: z.ZodObject<{
     evidenceCount: number;
     appliedAt: string;
 }, {
-    confidence: number;
     reason: string;
+    confidence: number;
     parameter: string;
     previousValue: number;
     nextValue: number;
@@ -977,8 +1233,8 @@ declare const BehaviorLoopPolicyStateSchema: z.ZodObject<{
         reason: z.ZodString;
         appliedAt: z.ZodString;
     }, "strip", z.ZodTypeAny, {
-        confidence: number;
         reason: string;
+        confidence: number;
         parameter: string;
         previousValue: number;
         nextValue: number;
@@ -986,8 +1242,8 @@ declare const BehaviorLoopPolicyStateSchema: z.ZodObject<{
         evidenceCount: number;
         appliedAt: string;
     }, {
-        confidence: number;
         reason: string;
+        confidence: number;
         parameter: string;
         previousValue: number;
         nextValue: number;
@@ -1004,8 +1260,8 @@ declare const BehaviorLoopPolicyStateSchema: z.ZodObject<{
     maxDeltaPerCycle: number;
     protectedParams: string[];
     adjustments: {
-        confidence: number;
         reason: string;
+        confidence: number;
         parameter: string;
         previousValue: number;
         nextValue: number;
@@ -1021,8 +1277,8 @@ declare const BehaviorLoopPolicyStateSchema: z.ZodObject<{
     maxDeltaPerCycle: number;
     protectedParams: string[];
     adjustments: {
-        confidence: number;
         reason: string;
+        confidence: number;
         parameter: string;
         previousValue: number;
         nextValue: number;

package/dist/schemas.js

@@ -23,7 +23,7 @@ import {
   buildProfileConsolidationResultSchema,
   parseMemoryActionEligibilityContext,
   parseMemoryActionType
-} from "./chunk-UEYA6UC7.js";
+} from "./chunk-NZLQTHS5.js";
 export {
   BehaviorLoopAdjustmentSchema,
   BehaviorLoopPolicyStateSchema,

package/dist/{semantic-consolidation-DrvSYRdB.d.ts → semantic-consolidation-CxJU6MJk.d.ts}

@@ -1,6 +1,7 @@
 import { PluginConfig, MemoryFile } from './types.js';
 import { R as RolloutSummaryInput, M as MaterializeResult } from './codex-materialize-CQlLTzke.js';
 import { LoggerBackend } from './logger.js';
+import { ConsolidationOperator } from './consolidation-operator.js';
 
 /**
  * memory-extension-host/types.ts — Types for third-party memory extension discovery.
@@ -92,6 +93,66 @@ declare function buildConsolidationPrompt(cluster: ConsolidationCluster): string
  * Parse the LLM response to extract the canonical content.
  */
 declare function parseConsolidationResponse(response: string): string;
+/**
+ * Structured result from an operator-aware consolidation LLM call.
+ *
+ * - `operator` — the consolidation operator the LLM chose for this cluster.
+ *   Falls back to the heuristic default when the LLM omits or returns an
+ *   unknown value (the parser never surfaces an invalid operator; see
+ *   `parseOperatorAwareConsolidationResponse`).
+ * - `output` — the canonical content (same format the legacy prompt
+ *   returns).  Callers persist this as the body of the new memory.
+ */
+interface OperatorAwareConsolidationResult {
+    operator: ConsolidationOperator;
+    output: string;
+}
+/**
+ * Heuristic default operator for a cluster.  Used as the fallback when the
+ * LLM does not return a parseable operator, and as the "floor" decision in
+ * `parseOperatorAwareConsolidationResponse`.
+ *
+ * Current heuristic (kept deliberately conservative — PR 3 only):
+ *
+ *   - Two or more memories being collapsed into one canonical blob is a
+ *     MERGE by definition.  This is the path the current clustering
+ *     pipeline exercises.
+ *   - A cluster of size 1 that still reaches consolidation (future path,
+ *     e.g. supersession of a single older memory by a newer value) is an
+ *     UPDATE.
+ *   - SPLIT is never selected by the heuristic because the current write
+ *     path emits exactly one canonical memory per cluster.  The prompt
+ *     reserves SPLIT for future cluster shapes where the LLM decides one
+ *     logical source actually encodes several distinct facts — at which
+ *     point the orchestrator would need to write multiple outputs.
+ */
+declare function chooseConsolidationOperator(cluster: ConsolidationCluster): ConsolidationOperator;
+/**
+ * Build the operator-aware LLM prompt.  The LLM is asked to return a
+ * JSON object `{ "operator": <split|merge|update>, "output": <content> }`.
+ *
+ * The prompt is additive: it still asks for a single canonical blob under
+ * `output`, so the upstream write path does not change.  Future expansions
+ * (SPLIT emitting multiple outputs) are explicitly documented as
+ * out-of-scope for the parser — `parseOperatorAwareConsolidationResponse`
+ * collapses any SPLIT response into a single canonical output for now.
+ */
+declare function buildOperatorAwareConsolidationPrompt(cluster: ConsolidationCluster): string;
+/**
+ * Parse an operator-aware consolidation response.
+ *
+ * Contract:
+ *   - Accepts strict JSON `{ "operator": "...", "output": "..." }`.
+ *   - Tolerates a JSON payload wrapped in a fenced code block (```json ...```).
+ *   - Falls back to the heuristic operator when the JSON is malformed,
+ *     the `operator` field is missing / unknown, or the raw response is
+ *     a plain blob with no JSON at all.  This keeps PR 3 backwards
+ *     compatible with older models that ignore the JSON instruction.
+ *   - Never throws.  A missing / empty `output` field falls back to the
+ *     trimmed raw response so the caller still writes something rather
+ *     than dropping the cluster.
+ */
+declare function parseOperatorAwareConsolidationResponse(response: string, cluster: ConsolidationCluster): OperatorAwareConsolidationResult;
 /**
  * Discover extensions and build the block to append to a consolidation prompt.
  * Returns "" when extensions are disabled or none are found.
@@ -116,4 +177,4 @@ declare function materializeAfterSemanticConsolidation(options: {
     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 };
+export { type ConsolidationCluster as C, type DiscoveredExtension as D, type ExtensionSchema as E, type OperatorAwareConsolidationResult as O, REMNIC_EXTENSIONS_TOTAL_TOKEN_LIMIT as R, type SemanticConsolidationResult as S, buildConsolidationPrompt as a, buildExtensionsBlockForConsolidation as b, buildOperatorAwareConsolidationPrompt as c, discoverMemoryExtensions as d, chooseConsolidationOperator as e, findSimilarClusters as f, parseOperatorAwareConsolidationResponse as g, materializeAfterSemanticConsolidation as m, parseConsolidationResponse as p, resolveExtensionsRoot as r };

package/dist/semantic-consolidation.d.ts

@@ -1,4 +1,5 @@
 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';
+export { C as ConsolidationCluster, O as OperatorAwareConsolidationResult, S as SemanticConsolidationResult, a as buildConsolidationPrompt, b as buildExtensionsBlockForConsolidation, c as buildOperatorAwareConsolidationPrompt, e as chooseConsolidationOperator, f as findSimilarClusters, m as materializeAfterSemanticConsolidation, p as parseConsolidationResponse, g as parseOperatorAwareConsolidationResponse, r as resolveExtensionsRoot } from './semantic-consolidation-CxJU6MJk.js';
+export { CONSOLIDATION_OPERATORS, ConsolidationOperator, isConsolidationOperator, isValidDerivedFromEntry } from './consolidation-operator.js';
 import './logger.js';