feat(neotoma-adapter): memory_events-driven write path + history-preserving probe (#1737)

src/adapter.ts

@@ -1,4 +1,5 @@
 import type {
+  Scenario,
   Session,
   ProbeOptions,
   ProbeResult,
@@ -11,6 +12,21 @@ export interface MemoryAdapter {
 
   init(): Promise<void>;
 
+  /**
+   * OPTIONAL lifecycle hook. The runner calls this once per scenario (after
+   * `reset()` and before any `processSession()` call) when the adapter
+   * implements it. It hands the adapter the full {@link Scenario}, including
+   * the typed `memory_events` that carry the structured truth (value, history,
+   * introduced/updated/retracted session indices). Adapters that prefer to
+   * drive their write path from `memory_events` rather than re-deriving facts
+   * from raw conversation text can use this.
+   *
+   * Backward-compatible: adapters that do not implement it (e.g.
+   * {@link BaselineAdapter}) keep working unchanged — the runner only calls it
+   * when present.
+   */
+  setScenario?(scenario: Scenario): void;
+
   /**
    * Feed a conversation session into the memory system.
    * The adapter should store facts, entities, and relationships