@aexol/spectral 0.9.184 → 0.9.186

package/dist/agent/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAIX,SAAS,EAET,MAAM,4BAA4B,CAAC;AASpC,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACN,KAAK,WAAW,EAKhB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQrD,OAAO,KAAK,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAuG7G;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC,GACpF,MAAM,CAYR;AA0JD;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,CAK3D;AAoBD,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,GACnB,SAAS,EAAE,CAoCb;AA6bD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACxC,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IACN,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,IAAI,CAgaN"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/agent/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAIX,SAAS,EAET,MAAM,4BAA4B,CAAC;AAUpC,OAAO,EACN,KAAK,YAAY,EACjB,KAAK,gBAAgB,EACrB,MAAM,8BAA8B,CAAC;AAGtC,OAAO,EACN,KAAK,WAAW,EAKhB,MAAM,aAAa,CAAC;AAErB,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAQrD,OAAO,KAAK,EAAE,gBAAgB,IAAI,oBAAoB,EAAE,MAAM,8CAA8C,CAAC;AAuG7G;;;;;;;;;GASG;AACH,wBAAgB,yBAAyB,CACxC,gBAAgB,EAAE,MAAM,GAAG,SAAS,EACpC,KAAK,EAAE,IAAI,CAAC,WAAW,EAAE,MAAM,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,GAAG,QAAQ,CAAC,GACpF,MAAM,CAYR;AA0JD;;;GAGG;AACH,wBAAgB,oCAAoC,CACnD,cAAc,EAAE,gBAAgB,CAAC,gBAAgB,CAAC,GAChD,IAAI,CAAC,oBAAoB,CAAC,gBAAgB,CAAC,EAAE,WAAW,CAAC,CAK3D;AAoBD,wBAAgB,oBAAoB,CACnC,GAAG,EAAE,MAAM,EACX,GAAG,EAAE,YAAY,EACjB,GAAG,EAAE,gBAAgB,GACnB,SAAS,EAAE,CAoCb;AAycD,MAAM,CAAC,OAAO,UAAU,iBAAiB,CACxC,GAAG,EAAE,YAAY,EACjB,IAAI,CAAC,EAAE;IACN,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,iBAAiB,CAAC,EAAE,CAAC,KAAK,EAAE,WAAW,KAAK,IAAI,CAAC;IACjD,MAAM,CAAC,EAAE,MAAM,CAAC;CAChB,GACC,IAAI,CAgaN"}

package/dist/agent/index.js

@@ -25,7 +25,7 @@
  *   - Access to observational memory via the recall tool
  */
 import { agentLoop } from "../sdk/agent-core/index.js";
-import { buildIsolatedRequestTimePrunedMessages, COMPACT_CONTEXT_TOOL_NAME, } from "../memory/tools/compact-context.js";
+import { buildIsolatedRequestTimePrunedMessagesResult, COMPACT_CONTEXT_TOOL_NAME, } from "../memory/tools/compact-context.js";
 import { StringEnum } from "../sdk/ai/index.js";
 import { mutateSystemPrompt } from "../sdk/coding-agent/core/system-prompt-mutator.js";
 import { Type } from "typebox";
@@ -445,6 +445,10 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
     // Accumulated thinking deltas for the live subagent sheet. This stays outside
     // final `SingleResult` so the public subagent tool_result contract is unchanged.
     let thinkingText = "";
+    // Per-run frozen DCP-lite cut for the isolated subagent loop. Reusing the
+    // same summary + anchor across provider requests keeps the subagent prompt
+    // prefix byte-stable within a single run.
+    let isolatedPruneFrozen = null;
     // Responses API reasoning metadata that lets the UI classify accumulated
     // subagent thinking as activity (mirrors the main-session thinking metadata).
     let thinkingMetadata;
@@ -474,7 +478,9 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
                 // Pure request-time DCP adapter: policy-derived, invocation-local, and
                 // never connected to the parent Runtime or SessionManager.
                 try {
-                    return buildIsolatedRequestTimePrunedMessages(messages);
+                    const pruned = buildIsolatedRequestTimePrunedMessagesResult(messages, undefined, undefined, isolatedPruneFrozen, model.contextWindow);
+                    isolatedPruneFrozen = pruned.frozen;
+                    return pruned.messages;
                 }
                 catch {
                     return messages;

package/dist/memory/branch.d.ts

@@ -121,4 +121,17 @@ export interface MemoryState {
     pendingObs: ObservationRecord[];
 }
 export declare function getMemoryState(entries: Entry[]): MemoryState;
+/**
+ * Build a synthetic branch entry array that is sufficient for
+ * `recallMemorySources` to recover the same memory id outside of its original
+ * session/branch.
+ *
+ * This is the cross-session recall archive unit: it contains only the source
+ * entries referenced by the requested observation/reflection, the observation
+ * entries needed to resolve direct and supporting observations, and (for
+ * reflections) a restored-memory snapshot entry carrying the reflection
+ * provenance. It is deliberately keyed by memory id so it can be persisted in
+ * the project-scoped store without dragging the whole branch along.
+ */
+export declare function buildRecallSourceArchiveEntries(entries: Entry[], memoryState: Pick<MemoryState, "reflections" | "committedObs" | "pendingObs">, memoryId: string): Entry[] | undefined;
 //# sourceMappingURL=branch.d.ts.map

package/dist/memory/branch.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/memory/branch.ts"],"names":[],"mappings":"AAAA,OAAO,EAQN,KAAK,gBAAgB,EACrB,KAAK,oBAAoB,EACzB,KAAK,iBAAiB,EACtB,KAAK,gBAAgB,EAGrB,MAAM,YAAY,CAAC;AAIpB,MAAM,MAAM,KAAK,GAAG;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,gBAAgB,CAAC,EAAE,MAAM,CAAC;CAC1B,CAAC;AAEF,wBAAgB,aAAa,CAAC,KAAK,EAAE,KAAK,GAAG,OAAO,CAInD;AAUD,MAAM,MAAM,sBAAsB,GAC/B;IACA,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,iBAAiB,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,KAAK,EAAE,CAAC;CACvB,GACA;IACA,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;CAC3B,GACA;IACA,MAAM,EAAE,oBAAoB,CAAC;IAC7B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEJ,MAAM,MAAM,8BAA8B,GACvC;IACA,MAAM,EAAE,WAAW,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,EAAE,CAAC;IACZ,SAAS,EAAE,KAAK,CAAC;CACjB,GACA;IACA,MAAM,EAAE,OAAO,CAAC;IAChB,aAAa,EAAE,MAAM,CAAC;IACtB,OAAO,EAAE,sBAAsB,EAAE,CAAC;IAClC,SAAS,EAAE,OAAO,CAAC;CACnB,CAAC;AAEJ,MAAM,MAAM,uBAAuB,GAChC;IACA,MAAM,EAAE,IAAI,CAAC;IACb,WAAW,EAAE,iBAAiB,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,KAAK,EAAE,CAAC;CACvB,GACA;IACA,MAAM,EAAE,WAAW,CAAC;IACpB,WAAW,EAAE,iBAAiB,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;CAC/B,GACA;IACA,MAAM,EAAE,oBAAoB,CAAC;IAC7B,WAAW,EAAE,iBAAiB,CAAC;IAC/B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,cAAc,EAAE,MAAM,EAAE,CAAC;IACzB,aAAa,EAAE,KAAK,EAAE,CAAC;IACvB,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;CAC5B,CAAC;AAEJ,MAAM,MAAM,2BAA2B,GAAG;IACzC,UAAU,EAAE,gBAAgB,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;CACxB,CAAC;AAEF,MAAM,MAAM,sCAAsC,GAAG;IACpD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,MAAM,MAAM,qCAAqC,GAAG;IACnD,UAAU,EAAE,gBAAgB,CAAC;IAC7B,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,yBAAyB,GAClC;IACA,MAAM,EAAE,WAAW,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,EAAE,CAAC;IACtB,wBAAwB,EAAE,EAAE,CAAC;IAC7B,YAAY,EAAE,EAAE,CAAC;IACjB,aAAa,EAAE,EAAE,CAAC;IAClB,iCAAiC,EAAE,EAAE,CAAC;IACtC,+BAA+B,EAAE,EAAE,CAAC;IACpC,qBAAqB,EAAE,EAAE,CAAC;IAC1B,iBAAiB,EAAE,EAAE,CAAC;IACtB,SAAS,EAAE,KAAK,CAAC;IACjB,OAAO,EAAE,KAAK,CAAC;CACf,GACA;IACA,MAAM,EAAE,OAAO,CAAC;IAChB,QAAQ,EAAE,MAAM,CAAC;IACjB,iBAAiB,EAAE,2BAA2B,EAAE,CAAC;IACjD,wBAAwB,EAAE,uBAAuB,EAAE,CAAC;IACpD,YAAY,EAAE,uBAAuB,EAAE,CAAC;IACxC,aAAa,EAAE,KAAK,EAAE,CAAC;IACvB,iCAAiC,EAAE,sCAAsC,EAAE,CAAC;IAC5E,+BAA+B,EAAE,qCAAqC,EAAE,CAAC;IACzE,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CACjB,CAAC;AASJ,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAKhE;AAED,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAYnE;AA+BD,wBAAgB,uBAAuB,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAQhE;AAED,wBAAgB,4BAA4B,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,MAAM,CAIrE;AAYD,wBAAgB,eAAe,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAKxF;AAED,wBAAgB,aAAa,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,mBAAmB,EAAE,MAAM,GAAG,KAAK,EAAE,CASpF;AAED,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,KAAK,EAAE,CAUhG;AA0JD,wBAAgB,wBAAwB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,aAAa,EAAE,MAAM,GAAG,8BAA8B,CAqChH;AAoBD,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,KAAK,EAAE,EAAE,QAAQ,EAAE,MAAM,GAAG,yBAAyB,CA6FjG;AAED,wBAAgB,6BAA6B,CAC5C,OAAO,EAAE,KAAK,EAAE,EAChB,qBAAqB,EAAE,MAAM,GAAG,SAAS,EACzC,mBAAmB,EAAE,MAAM,GACzB,oBAAoB,EAAE,CAyBxB;AA8BD,MAAM,WAAW,WAAW;IAC3B,WAAW,EAAE,gBAAgB,EAAE,CAAC;IAChC,YAAY,EAAE,iBAAiB,EAAE,CAAC;IAClC,UAAU,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,KAAK,EAAE,GAAG,WAAW,CAQ5D"}
+{"version":3,"file":"branch.d.ts","sourceRoot":"","sources":["../../src/memory/branch.ts"],"names":[],"mappings":"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"}

package/dist/memory/branch.js

@@ -468,3 +468,103 @@ export function getMemoryState(entries) {
         pendingObs: pendingData.flatMap((d) => d.records),
     };
 }
+/**
+ * Build a synthetic branch entry array that is sufficient for
+ * `recallMemorySources` to recover the same memory id outside of its original
+ * session/branch.
+ *
+ * This is the cross-session recall archive unit: it contains only the source
+ * entries referenced by the requested observation/reflection, the observation
+ * entries needed to resolve direct and supporting observations, and (for
+ * reflections) a restored-memory snapshot entry carrying the reflection
+ * provenance. It is deliberately keyed by memory id so it can be persisted in
+ * the project-scoped store without dragging the whole branch along.
+ */
+export function buildRecallSourceArchiveEntries(entries, memoryState, memoryId) {
+    const allObservations = [...memoryState.committedObs, ...memoryState.pendingObs];
+    const selectedObservationRecords = [];
+    const seenObservationKeys = new Set();
+    const recordKey = (observation) => [
+        observation.id,
+        observation.content,
+        observation.timestamp,
+        observation.relevance,
+        JSON.stringify(observation.sourceEntryIds ?? null),
+    ].join("\u0000");
+    const addObservation = (observation) => {
+        const key = recordKey(observation);
+        if (seenObservationKeys.has(key))
+            return;
+        seenObservationKeys.add(key);
+        selectedObservationRecords.push(observation);
+    };
+    for (const observation of allObservations) {
+        if (observation.id === memoryId)
+            addObservation(observation);
+    }
+    const reflections = [];
+    for (const reflection of memoryState.reflections) {
+        if (!isReflectionRecord(reflection) || reflection.id !== memoryId)
+            continue;
+        reflections.push(reflection);
+        for (const observationId of reflection.supportingObservationIds) {
+            for (const observation of allObservations) {
+                if (observation.id === observationId)
+                    addObservation(observation);
+            }
+        }
+    }
+    if (reflections.length === 0 && selectedObservationRecords.length === 0) {
+        return undefined;
+    }
+    const sourceEntryIds = new Set();
+    for (const observation of selectedObservationRecords) {
+        for (const sourceEntryId of observation.sourceEntryIds ?? []) {
+            sourceEntryIds.add(sourceEntryId);
+        }
+    }
+    const sourceEntries = entries.filter((entry) => {
+        if (!isSourceEntry(entry))
+            return false;
+        for (const requestedId of sourceEntryIds) {
+            if (sourceEntryMatchesRequestedId(entry, requestedId))
+                return true;
+        }
+        return false;
+    });
+    const archiveEntries = [...sourceEntries];
+    let observationEntryIndex = 0;
+    for (const observation of selectedObservationRecords) {
+        archiveEntries.push({
+            type: "custom",
+            id: `recall-archive-observation:${memoryId}:${observationEntryIndex++}`,
+            customType: OBSERVATION_CUSTOM_TYPE,
+            data: {
+                records: [observation],
+                coversFromId: "",
+                coversUpToId: "",
+                tokenCount: 0,
+            },
+        });
+    }
+    if (reflections.length > 0) {
+        archiveEntries.push({
+            type: "custom",
+            id: `recall-archive-snapshot:${memoryId}`,
+            customType: OBSERVATIONAL_MEMORY_SNAPSHOT_CUSTOM_TYPE,
+            data: {
+                type: "observational-memory-snapshot",
+                version: 1,
+                coveredSourceCount: sourceEntries.length,
+                summary: "",
+                details: {
+                    type: "observational-memory",
+                    version: 4,
+                    observations: selectedObservationRecords,
+                    reflections,
+                },
+            },
+        });
+    }
+    return archiveEntries;
+}

package/dist/memory/hooks/compaction-hook.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA+C,MAAM,iCAAiC,CAAC;AAajH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAiB7C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA0MhF"}
+{"version":3,"file":"compaction-hook.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/compaction-hook.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAA+C,MAAM,iCAAiC,CAAC;AAejH,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAkB7C,wBAAgB,sBAAsB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAkPhF"}

package/dist/memory/hooks/compaction-hook.js

@@ -1,8 +1,9 @@
 import { debugLog, withDebugLogContext } from "../debug-log.js";
 import { getProjectObsStore } from "../project-observations-store.js";
 import { relayProjectObservations } from "../inter-agent-relay.js";
-import { collectObservationsByCoverage, findLastCompactionIndex, getMemoryState, } from "../branch.js";
+import { buildRecallSourceArchiveEntries, collectObservationsByCoverage, findLastCompactionIndex, getMemoryState, } from "../branch.js";
 import { migrateLegacyReflections, renderSummary, } from "../compaction.js";
+import { reflectionId, } from "../types.js";
 import { deterministicPrune } from "../deterministic-pruner.js";
 function plural(count, singular, pluralForm = `${singular}s`) {
     return `${count.toLocaleString()} ${count === 1 ? singular : pluralForm}`;
@@ -89,6 +90,7 @@ export function registerCompactionHook(ext, runtime) {
                     if (hasUI)
                         ui?.notify(`Observational memory: no new observations — carrying forward ${memoryState.committedObs.length} observation${memoryState.committedObs.length === 1 ? "" : "s"}, ${workingReflections.length} reflection${workingReflections.length === 1 ? "" : "s"}`, "info");
                     persistProjectObservations(ctx, workingReflections);
+                    persistProjectRecallSources(ctx, entries, memoryState.committedObs, workingReflections);
                     return {
                         compaction: {
                             summary,
@@ -158,6 +160,7 @@ export function registerCompactionHook(ext, runtime) {
                 if (hasUI)
                     ui?.notify(`Observational memory: compaction assembled — ${finalObservations.length} observation${finalObservations.length === 1 ? "" : "s"}, ${finalReflections.length} reflection${finalReflections.length === 1 ? "" : "s"}`, "info");
                 persistProjectObservations(ctx, finalReflections);
+                persistProjectRecallSources(ctx, entries, finalObservations, finalReflections);
                 return {
                     compaction: {
                         summary,
@@ -197,4 +200,43 @@ export function registerCompactionHook(ext, runtime) {
         });
         relayProjectObservations(ctx.cwd, projectId, sessionId, projectObs, "reflection");
     }
+    function persistProjectRecallSources(ctx, entries, observations, reflections) {
+        const store = getProjectObsStore();
+        if (!store)
+            return;
+        const projectId = store.getProjectByCwd(ctx.cwd);
+        if (!projectId)
+            return;
+        const sessionId = ctx.sessionManager.getSessionId?.();
+        if (!sessionId)
+            return;
+        const memoryIds = new Set();
+        for (const observation of observations)
+            memoryIds.add(observation.id);
+        for (const reflection of reflections) {
+            const id = reflectionId(reflection);
+            if (id)
+                memoryIds.add(id);
+        }
+        if (memoryIds.size === 0)
+            return;
+        const memoryState = { reflections, committedObs: observations, pendingObs: [] };
+        let persisted = 0;
+        for (const memoryId of memoryIds) {
+            const existing = store.getProjectRecallSource?.(projectId, memoryId);
+            if (existing && existing.length > 0)
+                continue;
+            const archiveEntries = buildRecallSourceArchiveEntries(entries, memoryState, memoryId);
+            if (!archiveEntries || archiveEntries.length === 0)
+                continue;
+            store.upsertProjectRecallSource?.(projectId, memoryId, archiveEntries);
+            persisted += 1;
+        }
+        debugLog("compaction.project_recall_sources", {
+            projectId,
+            sessionId,
+            candidates: memoryIds.size,
+            persisted,
+        });
+    }
 }

package/dist/memory/hooks/observer-trigger.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"observer-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/observer-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAWpE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAY7C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CA8KjF"}
+{"version":3,"file":"observer-trigger.d.ts","sourceRoot":"","sources":["../../../src/memory/hooks/observer-trigger.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAapE,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAY7C,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAmLjF"}

package/dist/memory/hooks/observer-trigger.js

@@ -1,6 +1,6 @@
 import { debugLog, withDebugLogContext } from "../debug-log.js";
 import { resolveTurnLimits } from "../config.js";
-import { firstRawIdAfter, getMemoryState, lastObservationCoverEndIdx, rawTailEntriesBetween, rawTokensSinceLastBound, } from "../branch.js";
+import { buildRecallSourceArchiveEntries, firstRawIdAfter, getMemoryState, lastObservationCoverEndIdx, rawTailEntriesBetween, rawTokensSinceLastBound, } from "../branch.js";
 import { observationsToPromptLines, runObserver } from "../observer.js";
 import { serializeSourceAddressedBranchEntries } from "../serialize.js";
 import { estimateEntryTokens, estimateStringTokens } from "../tokens.js";
@@ -153,7 +153,7 @@ export function registerObserverTrigger(ext, runtime) {
                     records,
                 });
                 ext.appendEntry(OBSERVATION_CUSTOM_TYPE, data);
-                relayObservationRecords(cwd, ctx.sessionManager.getSessionId?.(), records);
+                relayObservationRecords(cwd, ctx.sessionManager.getSessionId?.(), records, chunkEntries);
                 debugLog("observer.appended", { count: records.length, tokenCount: observationTokens, coversFromId, coversUpToId: effectiveCoversUpToId });
                 if (hasUI && ui)
                     ui.notify(`Observational memory: ${records.length} observation${records.length === 1 ? "" : "s"} recorded (~${observationTokens.toLocaleString()} tokens)`, "info");
@@ -165,7 +165,7 @@ export function registerObserverTrigger(ext, runtime) {
         }));
     });
 }
-function relayObservationRecords(cwd, sessionId, records) {
+function relayObservationRecords(cwd, sessionId, records, sourceEntries) {
     if (!sessionId || records.length === 0)
         return;
     const store = getProjectObsStore();
@@ -174,5 +174,11 @@ function relayObservationRecords(cwd, sessionId, records) {
     const projectId = store.getProjectByCwd(cwd);
     if (!projectId)
         return;
+    for (const record of records) {
+        const archiveEntries = buildRecallSourceArchiveEntries(sourceEntries, { reflections: [], committedObs: [record], pendingObs: [] }, record.id);
+        if (!archiveEntries || archiveEntries.length === 0)
+            continue;
+        store.upsertProjectRecallSource?.(projectId, record.id, archiveEntries);
+    }
     relayProjectObservations(cwd, projectId, sessionId, records, "observation");
 }

package/dist/memory/index.d.ts

@@ -1,3 +1,16 @@
 import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
+/**
+ * Observational memory extension entry point.
+ *
+ * The extension is composed of two independent layers:
+ *   - `session-memory.ts`: session/branch-scoped memory (observer,
+ *     deterministic prune, summary render, session snapshot persistence).
+ *   - `project-observation-memory.ts`: per-machine + per-cwd, cross-session
+ *     project observations (write/read/recall/share/receive tools plus
+ *     inter-agent broker wiring).
+ *
+ * This default export keeps the original registration contract so it is still
+ * registered exactly once as `observationalMemory(ext)`.
+ */
 export default function observationalMemory(ext: ExtensionAPI): void;
 //# sourceMappingURL=index.d.ts.map

package/dist/memory/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAgBjE,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,GAAG,EAAE,YAAY,QAqB5D"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/memory/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAKjE;;;;;;;;;;;;GAYG;AACH,MAAM,CAAC,OAAO,UAAU,mBAAmB,CAAC,GAAG,EAAE,YAAY,QAQ5D"}

package/dist/memory/index.js

@@ -1,32 +1,23 @@
-import { registerStatusCommand } from "./commands/status.js";
-import { registerViewCommand } from "./commands/view.js";
-import { registerCompactionHook } from "./hooks/compaction-hook.js";
-import { registerCompactionTrigger } from "./hooks/compaction-trigger.js";
-import { registerInterAgentReceiver } from "./hooks/inter-agent-receiver.js";
-import { registerObserverTrigger } from "./hooks/observer-trigger.js";
 import { Runtime } from "./runtime.js";
-import { registerToolOutputCompressor } from "./tool-output-compressor.js";
-import { registerCompactContextTool } from "./tools/compact-context.js";
-import { registerRecallTool } from "./tools/recall-observation.js";
-import { registerReadProjectObservationsTool } from "./tools/read-project-observations.js";
-import { registerReceiveAgentObservationsTool } from "./tools/receive-agent-observations.js";
-import { registerShareProjectObservationTool } from "./tools/share-project-observation.js";
-import { registerWriteProjectObservationTool } from "./tools/write-project-observation.js";
+import { registerProjectObservationMemory } from "./project-observation-memory.js";
+import { registerSessionMemory } from "./session-memory.js";
+/**
+ * Observational memory extension entry point.
+ *
+ * The extension is composed of two independent layers:
+ *   - `session-memory.ts`: session/branch-scoped memory (observer,
+ *     deterministic prune, summary render, session snapshot persistence).
+ *   - `project-observation-memory.ts`: per-machine + per-cwd, cross-session
+ *     project observations (write/read/recall/share/receive tools plus
+ *     inter-agent broker wiring).
+ *
+ * This default export keeps the original registration contract so it is still
+ * registered exactly once as `observationalMemory(ext)`.
+ */
 export default function observationalMemory(ext) {
     const runtime = new Runtime();
     // Log extension load so we can confirm it's running in serve mode.
     process.stderr.write("[obs-mem] extension loaded\n");
-    registerObserverTrigger(ext, runtime);
-    registerCompactContextTool(ext, runtime);
-    registerCompactionTrigger(ext, runtime);
-    registerCompactionHook(ext, runtime);
-    registerToolOutputCompressor(ext, runtime);
-    registerStatusCommand(ext, runtime);
-    registerViewCommand(ext, runtime);
-    registerRecallTool(ext);
-    registerReadProjectObservationsTool(ext);
-    registerWriteProjectObservationTool(ext);
-    registerShareProjectObservationTool(ext);
-    registerReceiveAgentObservationsTool(ext);
-    registerInterAgentReceiver(ext);
+    registerSessionMemory(ext, runtime);
+    registerProjectObservationMemory(ext);
 }

package/dist/memory/project-observation-memory.d.ts

@@ -0,0 +1,16 @@
+import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
+/**
+ * Project-observation memory layer.
+ *
+ * This layer owns the five project-observation tools
+ * (`write_project_observation`, `read_project_observations`, `recall`,
+ * `share_project_observation`, `receive_agent_observations`) plus the
+ * `project-observations-store.ts` shim and the inter-agent broker wiring.
+ *
+ * Storage is per-machine + per-cwd + cross-session: observations are keyed by
+ * the local project resolved from the absolute working directory and persisted
+ * in the same-machine SQLite store. There is no cloud/team sync and no
+ * cross-machine fan-out.
+ */
+export declare function registerProjectObservationMemory(ext: ExtensionAPI): void;
+//# sourceMappingURL=project-observation-memory.d.ts.map

package/dist/memory/project-observation-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project-observation-memory.d.ts","sourceRoot":"","sources":["../../src/memory/project-observation-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAQjE;;;;;;;;;;;;GAYG;AACH,wBAAgB,gCAAgC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAQxE"}

package/dist/memory/project-observation-memory.js

@@ -0,0 +1,27 @@
+import { registerInterAgentReceiver } from "./hooks/inter-agent-receiver.js";
+import { registerRecallTool } from "./tools/recall-observation.js";
+import { registerReadProjectObservationsTool } from "./tools/read-project-observations.js";
+import { registerReceiveAgentObservationsTool } from "./tools/receive-agent-observations.js";
+import { registerShareProjectObservationTool } from "./tools/share-project-observation.js";
+import { registerWriteProjectObservationTool } from "./tools/write-project-observation.js";
+/**
+ * Project-observation memory layer.
+ *
+ * This layer owns the five project-observation tools
+ * (`write_project_observation`, `read_project_observations`, `recall`,
+ * `share_project_observation`, `receive_agent_observations`) plus the
+ * `project-observations-store.ts` shim and the inter-agent broker wiring.
+ *
+ * Storage is per-machine + per-cwd + cross-session: observations are keyed by
+ * the local project resolved from the absolute working directory and persisted
+ * in the same-machine SQLite store. There is no cloud/team sync and no
+ * cross-machine fan-out.
+ */
+export function registerProjectObservationMemory(ext) {
+    registerRecallTool(ext);
+    registerReadProjectObservationsTool(ext);
+    registerWriteProjectObservationTool(ext);
+    registerShareProjectObservationTool(ext);
+    registerReceiveAgentObservationsTool(ext);
+    registerInterAgentReceiver(ext);
+}

package/dist/memory/project-observations-store.d.ts

@@ -3,8 +3,14 @@
  * memory extension so the `read_project_observations` tool can query
  * cross-session observations.
  *
+ * Storage is per-machine + per-cwd: observations are keyed by the local
+ * project resolved from the absolute working directory and persisted in the
+ * same-machine SQLite store. They are shared across sessions on this machine
+ * but are NOT synced across machines or teams.
+ *
  * Set once by the SessionStreamManager at startup. Read by tools at runtime.
  */
+import type { Entry } from "./branch.js";
 export interface ProjectObservationsStore {
     insertProjectObservations(projectId: string, sessionId: string, observations: Array<{
         id: string;
@@ -25,6 +31,8 @@ export interface ProjectObservationsStore {
         sessionId: string;
     } | null;
     getProjectByCwd(cwd: string): string | null;
+    upsertProjectRecallSource?(projectId: string, memoryId: string, entries: Entry[]): void;
+    getProjectRecallSource?(projectId: string, memoryId: string): Entry[] | null;
 }
 export declare function setProjectObsStore(store: ProjectObservationsStore): void;
 export declare function getProjectObsStore(): ProjectObservationsStore | null;

package/dist/memory/project-observations-store.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"project-observations-store.d.ts","sourceRoot":"","sources":["../../src/memory/project-observations-store.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,WAAW,wBAAwB;IACxC,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EACvE,SAAS,EAAE,MAAM,GACf,IAAI,CAAC;IACR,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACZ,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACnB;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnG,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;CAC5C;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAExE;AAED,wBAAgB,kBAAkB,IAAI,wBAAwB,GAAG,IAAI,CAEpE"}
+{"version":3,"file":"project-observations-store.d.ts","sourceRoot":"","sources":["../../src/memory/project-observations-store.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,WAAW,wBAAwB;IACxC,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,MAAM,EACjB,YAAY,EAAE,KAAK,CAAC;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,EACvE,SAAS,EAAE,MAAM,GACf,IAAI,CAAC;IACR,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,KAAK,EAAE,MAAM,EACb,KAAK,CAAC,EAAE,MAAM,GACZ,KAAK,CAAC;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;IACvF,yBAAyB,CACxB,SAAS,EAAE,MAAM,EACjB,aAAa,EAAE,MAAM,GACnB;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IACnG,eAAe,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC;IAC5C,yBAAyB,CAAC,CACzB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,OAAO,EAAE,KAAK,EAAE,GACd,IAAI,CAAC;IACR,sBAAsB,CAAC,CACtB,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,GACd,KAAK,EAAE,GAAG,IAAI,CAAC;CAClB;AAID,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,wBAAwB,GAAG,IAAI,CAExE;AAED,wBAAgB,kBAAkB,IAAI,wBAAwB,GAAG,IAAI,CAEpE"}

package/dist/memory/project-observations-store.js

@@ -3,6 +3,11 @@
  * memory extension so the `read_project_observations` tool can query
  * cross-session observations.
  *
+ * Storage is per-machine + per-cwd: observations are keyed by the local
+ * project resolved from the absolute working directory and persisted in the
+ * same-machine SQLite store. They are shared across sessions on this machine
+ * but are NOT synced across machines or teams.
+ *
  * Set once by the SessionStreamManager at startup. Read by tools at runtime.
  */
 let _store = null;

package/dist/memory/prompts.d.ts

@@ -1,7 +1,7 @@
 export declare const MEMORY_STAKES = "These records are the ONLY information the assistant will have about past interactions once the raw conversation is compacted out of context. Anything you do not capture here will be forgotten. Anything you distort here will be remembered wrong. Take this seriously.";
-export declare const OBSERVATION_CONTENT_RULES = "Observation content rules:\n\nFormat.\n- Single line of plain prose. No markdown, no bullets, no code fences, no XML/HTML tags, no emojis.\n- Do NOT include the timestamp or relevance inside the content string \u2014 those are separate fields.\n- No structured fields embedded in the text (no \"key: value\" lines, no JSON).\n\nPreserve user assertions exactly.\nWhen the user TELLS you something about themselves, their project, or their environment, capture it as an assertion. When the user ASKS something, capture it as a question. Assertions are authoritative \u2014 a later question on the same topic does not invalidate them.\n  BAD:  User wondered if they have two kids.\n  GOOD: User stated they have two kids.\n  BAD:  User discussed auth middleware.\n  GOOD: User asked how to configure JWT auth middleware.\nWhy this matters: if the user says \"I use Postgres\" and later asks \"what db am I on?\", downstream agents must treat the assertion as the answer, not the question.\n\nPreserve unusual phrasing.\nWhen the user uses non-standard terminology, quote their exact words so future runs can recognize the term.\n  BAD:  User exercised yesterday.\n  GOOD: User stated they did a \"movement session\" (their term) yesterday.\n\nUse precise action verbs. Replace vague verbs with ones that clarify the nature of the action.\n  BAD:  User got a new subscription.\n  GOOD: User subscribed to the Pro plan.\n  BAD:  User stopped getting the newsletter.\n  GOOD: User unsubscribed from the newsletter.\n  BAD:  User got the library.\n  GOOD: User installed the zod package via pnpm.\n\nFrame state changes as supersession so the old state is explicit.\n  BAD:  User prefers React Query now.\n  GOOD: User will use React Query (switching from SWR).\nWhy this matters: without supersession framing, the reflector may crystallize both the old and the new as equally valid preferences.\n\nMark concrete completions explicitly.\nUse \"completed:\", \"resolved:\", \"confirmed working\", or similar phrasing so future runs know not to redo the work.\n  BAD:  Wrote the login handler.\n  GOOD: completed: implemented login handler at src/auth/login.ts; user confirmed tests pass.\nWhy this matters: without a completion marker, a later assistant may re-implement work that is already done, wasting the user's time and risking regressions.\n\nSplit compound statements into separate observations.\nIf a single message contains multiple independent facts, intents, or events, emit one observation per fact. One observation per line is what enables downstream retrieval and pruning to operate at fact granularity.\n  BAD:  User will visit their parents this weekend and needs to clean the garage.\n  GOOD: User will visit their parents this weekend. + User stated they need to clean the garage this weekend.\n  BAD:  User started a new job and is moving to a new apartment next week.\n  GOOD: User started a new job. + User will move to a new apartment next week.\n  BAD:  Assistant recommended Lucia, NextAuth, and Clerk for auth, and user chose Lucia.\n  GOOD: Assistant recommended auth libraries: Lucia (session-based, minimal), NextAuth (OAuth-heavy, Next-native), Clerk (hosted, paid). + User chose Lucia.\nWhy this matters: a future query like \"which auth library did the user pick?\" can match a single-fact observation cleanly; a compound observation hides the decision inside a recommendation list.\n\nGroup repeated similar tool calls into a single observation rather than one per call.\n  BAD:  Agent viewed src/auth.ts. Agent viewed src/users.ts. Agent viewed src/routes.ts.\n  GOOD: Agent surveyed auth-related files (src/auth.ts, src/users.ts, src/routes.ts) and located token validation in src/auth.ts:45.";
+export declare const OBSERVATION_CONTENT_RULES = "Observation content rules:\n\nFormat.\n- Single line of plain prose. No markdown, no bullets, no code fences, no XML/HTML tags, no emojis.\n- Do NOT include the timestamp or relevance inside the content string \u2014 those are separate fields.\n- No structured fields embedded in the text (no \"key: value\" lines, no JSON).\n\nPreserve user assertions exactly.\nWhen the user TELLS you something about themselves, their project, or their environment, capture it as an assertion. When the user ASKS something, capture it as a question. Assertions are authoritative \u2014 a later question on the same topic does not invalidate them.\n  BAD:  User wondered if they have two kids.\n  GOOD: User stated they have two kids.\n  BAD:  User discussed auth middleware.\n  GOOD: User asked how to configure JWT auth middleware.\nWhy this matters: if the user says \"I use Postgres\" and later asks \"what db am I on?\", downstream agents must treat the assertion as the answer, not the question.\n\nPreserve unusual phrasing.\nWhen the user uses non-standard terminology, quote their exact words so future runs can recognize the term.\n  BAD:  User exercised yesterday.\n  GOOD: User stated they did a \"movement session\" (their term) yesterday.\n\nUse precise action verbs. Replace vague verbs with ones that clarify the nature of the action.\n  BAD:  User got a new subscription.\n  GOOD: User subscribed to the Pro plan.\n  BAD:  User stopped getting the newsletter.\n  GOOD: User unsubscribed from the newsletter.\n  BAD:  User got the library.\n  GOOD: User installed the zod package via pnpm.\n\nFrame state changes as supersession so the old state is explicit.\n  BAD:  User prefers React Query now.\n  GOOD: User will use React Query (switching from SWR).\nWhy this matters: without supersession framing, later reflection may crystallize both the old and the new as equally valid preferences.\n\nMark concrete completions explicitly.\nUse \"completed:\", \"resolved:\", \"confirmed working\", or similar phrasing so future runs know not to redo the work.\n  BAD:  Wrote the login handler.\n  GOOD: completed: implemented login handler at src/auth/login.ts; user confirmed tests pass.\nWhy this matters: without a completion marker, a later assistant may re-implement work that is already done, wasting the user's time and risking regressions.\n\nSplit compound statements into separate observations.\nIf a single message contains multiple independent facts, intents, or events, emit one observation per fact. One observation per line is what enables downstream retrieval and pruning to operate at fact granularity.\n  BAD:  User will visit their parents this weekend and needs to clean the garage.\n  GOOD: User will visit their parents this weekend. + User stated they need to clean the garage this weekend.\n  BAD:  User started a new job and is moving to a new apartment next week.\n  GOOD: User started a new job. + User will move to a new apartment next week.\n  BAD:  Assistant recommended Lucia, NextAuth, and Clerk for auth, and user chose Lucia.\n  GOOD: Assistant recommended auth libraries: Lucia (session-based, minimal), NextAuth (OAuth-heavy, Next-native), Clerk (hosted, paid). + User chose Lucia.\nWhy this matters: a future query like \"which auth library did the user pick?\" can match a single-fact observation cleanly; a compound observation hides the decision inside a recommendation list.\n\nGroup repeated similar tool calls into a single observation rather than one per call.\n  BAD:  Agent viewed src/auth.ts. Agent viewed src/users.ts. Agent viewed src/routes.ts.\n  GOOD: Agent surveyed auth-related files (src/auth.ts, src/users.ts, src/routes.ts) and located token validation in src/auth.ts:45.";
 export declare const DETAIL_PRESERVATION_SCHEMA = "Detail preservation. When an observation references specific things, preserve the distinguishing details so future queries can still find them:\n\n- File/location: full path + line number when relevant (src/auth.ts:45, not \"the auth file\").\n- Identifiers and names: package names, function names, variable names, handles, ticket ids, commit SHAs, error codes. Keep them verbatim.\n- Error messages: quote verbatim.\n    BAD:  Build failed with a type error.\n    GOOD: Build failed: TS2322: Type 'string | undefined' is not assignable to type 'string' at src/auth.ts:47.\n- Numerical results: exact values, units, and direction.\n    BAD:  Optimization made it faster.\n    GOOD: Optimization reduced p95 latency from 420ms to 180ms (57% faster).\n- Quantities and counts: \"3 failing tests (auth.test.ts, users.test.ts, routes.test.ts)\" not \"some failing tests\".\n- Recommendation or decision lists: preserve the distinguishing attribute per item.\n    BAD:  Assistant recommended 3 auth libraries.\n    GOOD: Assistant recommended auth libraries: Lucia (session-based, minimal), NextAuth (OAuth-heavy, Next-native), Clerk (hosted, paid).\n- Role / participation: capture the user's role at an event, not just attendance.\n    BAD:  User worked on the migration.\n    GOOD: User led the migration from MySQL to Postgres.\n\nIf a detail is non-obvious from the code or git history, it belongs in the observation. If it is trivially re-derivable, it does not.";
 export declare const RELEVANCE_RUBRIC = "Relevance levels (pick one per observation; this field drives future pruning):\n\n- critical: user assertions about identity, role, or persistent preferences; explicit corrections (\"no, don't do X\"); concrete completions that future runs MUST NOT redo. These are load-bearing and will NEVER be dropped. Why this matters: if a \"critical\" item is lost, the assistant may redo finished work, contradict a correction, or misrepresent who the user is.\n- high: non-trivial technical decisions, architectural direction, unresolved blockers, key constraints. Worth keeping across many compactions.\n- medium: task-level context that helps within the current work but isn't durable. The default when you are unsure between medium and high.\n- low: routine tool-call acks, repetitive status updates, content trivially re-derivable from recent messages. The pruner will drop these first.\n\nDo NOT default to \"critical\" or \"high\". Most observations are medium or low. Reserve \"critical\" for things that would cause real damage if forgotten.\n\n  BAD:  relevance=critical for \"Agent ran tests and they passed.\"\n  GOOD: relevance=low for \"Agent ran tests and they passed.\" (routine; captured by a completion observation if it matters)\n\n  BAD:  relevance=medium for \"User said they are colorblind; red/green indicators do not work for them.\"\n  GOOD: relevance=critical for \"User said they are colorblind; red/green indicators do not work for them.\" (persistent constraint; forgetting it causes real harm)";
-export declare const OBSERVER_SYSTEM = "You are the observation agent for a coding assistant.\n\nThese records are the ONLY information the assistant will have about past interactions once the raw conversation is compacted out of context. Anything you do not capture here will be forgotten. Anything you distort here will be remembered wrong. Take this seriously.\n\nYour job is to compress a chunk of recent conversation into timestamped, rated observations by calling the record_observations tool. The observations you emit \u2014 together with the reflections crystallized from them \u2014 are the assistant's ONLY memory of this session after the raw conversation falls out of context.\n\nYou receive:\n- Current reflections (long-lived facts already crystallized).\n- Current observations (already-recorded observations, each shown as \"[`id`] YYYY-MM-DD HH:MM [relevance] content\").\n- A new chunk of conversation with source entry labels and inline message timestamps. Each source block starts with \"[Source entry id: <id>]\" followed by content formatted as \"[User @ YYYY-MM-DD HH:MM]:\", \"[Assistant @ ...]:\", \"[Tool result for <name> @ ...]:\", custom messages, or branch summaries.\n- A current local time fallback for observations that have no obvious message timestamp.\n\nHow you work:\n1. Read reflections and current observations so you know what is already captured.\n2. Read the conversation chunk and identify what new information it contains.\n3. Call record_observations with a batch covering part (or all) of the chunk.\n4. Read the progress receipt. If content remains uncovered, call again. You may call the tool many times.\n5. When the chunk is fully covered, STOP calling the tool and reply with a brief plain-text confirmation (one short sentence). That ends the run.\n\nWhat to emit:\n- Produce NEW observations for the new chunk only. Do not restate facts already present in reflections or current observations unless something has materially changed.\n- Use the timestamp from the relevant conversation message. Fall back to current local time ONLY when no message timestamp applies.\n- For every observation, include sourceEntryIds: the smallest exact set of \"[Source entry id: ...]\" ids that directly support the observation.\n- Never invent source entry ids. Use only ids printed in the chunk. If an observation spans multiple turns or tool results, include every supporting source entry id.\n- Observations with missing, empty, or invalid sourceEntryIds will be rejected and not recorded, so do not call record_observations until you can cite valid source ids.\n- Group repeated similar tool calls into a single observation rather than one per call.\n- Skip routine, low-information events. It is fine to emit zero observations if the chunk carries no new information \u2014 in that case, simply do not call the tool and end with a plain-text confirmation.\n\nObservation content rules:\n\nFormat.\n- Single line of plain prose. No markdown, no bullets, no code fences, no XML/HTML tags, no emojis.\n- Do NOT include the timestamp or relevance inside the content string \u2014 those are separate fields.\n- No structured fields embedded in the text (no \"key: value\" lines, no JSON).\n\nPreserve user assertions exactly.\nWhen the user TELLS you something about themselves, their project, or their environment, capture it as an assertion. When the user ASKS something, capture it as a question. Assertions are authoritative \u2014 a later question on the same topic does not invalidate them.\n  BAD:  User wondered if they have two kids.\n  GOOD: User stated they have two kids.\n  BAD:  User discussed auth middleware.\n  GOOD: User asked how to configure JWT auth middleware.\nWhy this matters: if the user says \"I use Postgres\" and later asks \"what db am I on?\", downstream agents must treat the assertion as the answer, not the question.\n\nPreserve unusual phrasing.\nWhen the user uses non-standard terminology, quote their exact words so future runs can recognize the term.\n  BAD:  User exercised yesterday.\n  GOOD: User stated they did a \"movement session\" (their term) yesterday.\n\nUse precise action verbs. Replace vague verbs with ones that clarify the nature of the action.\n  BAD:  User got a new subscription.\n  GOOD: User subscribed to the Pro plan.\n  BAD:  User stopped getting the newsletter.\n  GOOD: User unsubscribed from the newsletter.\n  BAD:  User got the library.\n  GOOD: User installed the zod package via pnpm.\n\nFrame state changes as supersession so the old state is explicit.\n  BAD:  User prefers React Query now.\n  GOOD: User will use React Query (switching from SWR).\nWhy this matters: without supersession framing, the reflector may crystallize both the old and the new as equally valid preferences.\n\nMark concrete completions explicitly.\nUse \"completed:\", \"resolved:\", \"confirmed working\", or similar phrasing so future runs know not to redo the work.\n  BAD:  Wrote the login handler.\n  GOOD: completed: implemented login handler at src/auth/login.ts; user confirmed tests pass.\nWhy this matters: without a completion marker, a later assistant may re-implement work that is already done, wasting the user's time and risking regressions.\n\nSplit compound statements into separate observations.\nIf a single message contains multiple independent facts, intents, or events, emit one observation per fact. One observation per line is what enables downstream retrieval and pruning to operate at fact granularity.\n  BAD:  User will visit their parents this weekend and needs to clean the garage.\n  GOOD: User will visit their parents this weekend. + User stated they need to clean the garage this weekend.\n  BAD:  User started a new job and is moving to a new apartment next week.\n  GOOD: User started a new job. + User will move to a new apartment next week.\n  BAD:  Assistant recommended Lucia, NextAuth, and Clerk for auth, and user chose Lucia.\n  GOOD: Assistant recommended auth libraries: Lucia (session-based, minimal), NextAuth (OAuth-heavy, Next-native), Clerk (hosted, paid). + User chose Lucia.\nWhy this matters: a future query like \"which auth library did the user pick?\" can match a single-fact observation cleanly; a compound observation hides the decision inside a recommendation list.\n\nGroup repeated similar tool calls into a single observation rather than one per call.\n  BAD:  Agent viewed src/auth.ts. Agent viewed src/users.ts. Agent viewed src/routes.ts.\n  GOOD: Agent surveyed auth-related files (src/auth.ts, src/users.ts, src/routes.ts) and located token validation in src/auth.ts:45.\n\nDetail preservation. When an observation references specific things, preserve the distinguishing details so future queries can still find them:\n\n- File/location: full path + line number when relevant (src/auth.ts:45, not \"the auth file\").\n- Identifiers and names: package names, function names, variable names, handles, ticket ids, commit SHAs, error codes. Keep them verbatim.\n- Error messages: quote verbatim.\n    BAD:  Build failed with a type error.\n    GOOD: Build failed: TS2322: Type 'string | undefined' is not assignable to type 'string' at src/auth.ts:47.\n- Numerical results: exact values, units, and direction.\n    BAD:  Optimization made it faster.\n    GOOD: Optimization reduced p95 latency from 420ms to 180ms (57% faster).\n- Quantities and counts: \"3 failing tests (auth.test.ts, users.test.ts, routes.test.ts)\" not \"some failing tests\".\n- Recommendation or decision lists: preserve the distinguishing attribute per item.\n    BAD:  Assistant recommended 3 auth libraries.\n    GOOD: Assistant recommended auth libraries: Lucia (session-based, minimal), NextAuth (OAuth-heavy, Next-native), Clerk (hosted, paid).\n- Role / participation: capture the user's role at an event, not just attendance.\n    BAD:  User worked on the migration.\n    GOOD: User led the migration from MySQL to Postgres.\n\nIf a detail is non-obvious from the code or git history, it belongs in the observation. If it is trivially re-derivable, it does not.\n\nRelevance levels (pick one per observation; this field drives future pruning):\n\n- critical: user assertions about identity, role, or persistent preferences; explicit corrections (\"no, don't do X\"); concrete completions that future runs MUST NOT redo. These are load-bearing and will NEVER be dropped. Why this matters: if a \"critical\" item is lost, the assistant may redo finished work, contradict a correction, or misrepresent who the user is.\n- high: non-trivial technical decisions, architectural direction, unresolved blockers, key constraints. Worth keeping across many compactions.\n- medium: task-level context that helps within the current work but isn't durable. The default when you are unsure between medium and high.\n- low: routine tool-call acks, repetitive status updates, content trivially re-derivable from recent messages. The pruner will drop these first.\n\nDo NOT default to \"critical\" or \"high\". Most observations are medium or low. Reserve \"critical\" for things that would cause real damage if forgotten.\n\n  BAD:  relevance=critical for \"Agent ran tests and they passed.\"\n  GOOD: relevance=low for \"Agent ran tests and they passed.\" (routine; captured by a completion observation if it matters)\n\n  BAD:  relevance=medium for \"User said they are colorblind; red/green indicators do not work for them.\"\n  GOOD: relevance=critical for \"User said they are colorblind; red/green indicators do not work for them.\" (persistent constraint; forgetting it causes real harm)\n\nTimestamp format: \"YYYY-MM-DD HH:MM\" (local time, 24-hour, to the minute). This goes in the timestamp field, not the content.\n\nRemember: these observations are the assistant's ONLY memory of this chunk once the raw messages fall out of context. Make them count.";
+export declare const OBSERVER_SYSTEM = "You are the observation agent for a coding assistant.\n\nThese records are the ONLY information the assistant will have about past interactions once the raw conversation is compacted out of context. Anything you do not capture here will be forgotten. Anything you distort here will be remembered wrong. Take this seriously.\n\nYour job is to compress a chunk of recent conversation into timestamped, rated observations by calling the record_observations tool. The observations you emit \u2014 together with the reflections crystallized from them \u2014 are the assistant's ONLY memory of this session after the raw conversation falls out of context.\n\nYou receive:\n- Current reflections (long-lived facts already crystallized).\n- Current observations (already-recorded observations, each shown as \"[`id`] YYYY-MM-DD HH:MM [relevance] content\").\n- A new chunk of conversation with source entry labels and inline message timestamps. Each source block starts with \"[Source entry id: <id>]\" followed by content formatted as \"[User @ YYYY-MM-DD HH:MM]:\", \"[Assistant @ ...]:\", \"[Tool result for <name> @ ...]:\", custom messages, or branch summaries.\n- A current local time fallback for observations that have no obvious message timestamp.\n\nHow you work:\n1. Read reflections and current observations so you know what is already captured.\n2. Read the conversation chunk and identify what new information it contains.\n3. Call record_observations with a batch covering part (or all) of the chunk.\n4. Read the progress receipt. If content remains uncovered, call again. You may call the tool many times.\n5. When the chunk is fully covered, STOP calling the tool and reply with a brief plain-text confirmation (one short sentence). That ends the run.\n\nWhat to emit:\n- Produce NEW observations for the new chunk only. Do not restate facts already present in reflections or current observations unless something has materially changed.\n- Use the timestamp from the relevant conversation message. Fall back to current local time ONLY when no message timestamp applies.\n- For every observation, include sourceEntryIds: the smallest exact set of \"[Source entry id: ...]\" ids that directly support the observation.\n- Never invent source entry ids. Use only ids printed in the chunk. If an observation spans multiple turns or tool results, include every supporting source entry id.\n- Observations with missing, empty, or invalid sourceEntryIds will be rejected and not recorded, so do not call record_observations until you can cite valid source ids.\n- Group repeated similar tool calls into a single observation rather than one per call.\n- Skip routine, low-information events. It is fine to emit zero observations if the chunk carries no new information \u2014 in that case, simply do not call the tool and end with a plain-text confirmation.\n\nObservation content rules:\n\nFormat.\n- Single line of plain prose. No markdown, no bullets, no code fences, no XML/HTML tags, no emojis.\n- Do NOT include the timestamp or relevance inside the content string \u2014 those are separate fields.\n- No structured fields embedded in the text (no \"key: value\" lines, no JSON).\n\nPreserve user assertions exactly.\nWhen the user TELLS you something about themselves, their project, or their environment, capture it as an assertion. When the user ASKS something, capture it as a question. Assertions are authoritative \u2014 a later question on the same topic does not invalidate them.\n  BAD:  User wondered if they have two kids.\n  GOOD: User stated they have two kids.\n  BAD:  User discussed auth middleware.\n  GOOD: User asked how to configure JWT auth middleware.\nWhy this matters: if the user says \"I use Postgres\" and later asks \"what db am I on?\", downstream agents must treat the assertion as the answer, not the question.\n\nPreserve unusual phrasing.\nWhen the user uses non-standard terminology, quote their exact words so future runs can recognize the term.\n  BAD:  User exercised yesterday.\n  GOOD: User stated they did a \"movement session\" (their term) yesterday.\n\nUse precise action verbs. Replace vague verbs with ones that clarify the nature of the action.\n  BAD:  User got a new subscription.\n  GOOD: User subscribed to the Pro plan.\n  BAD:  User stopped getting the newsletter.\n  GOOD: User unsubscribed from the newsletter.\n  BAD:  User got the library.\n  GOOD: User installed the zod package via pnpm.\n\nFrame state changes as supersession so the old state is explicit.\n  BAD:  User prefers React Query now.\n  GOOD: User will use React Query (switching from SWR).\nWhy this matters: without supersession framing, later reflection may crystallize both the old and the new as equally valid preferences.\n\nMark concrete completions explicitly.\nUse \"completed:\", \"resolved:\", \"confirmed working\", or similar phrasing so future runs know not to redo the work.\n  BAD:  Wrote the login handler.\n  GOOD: completed: implemented login handler at src/auth/login.ts; user confirmed tests pass.\nWhy this matters: without a completion marker, a later assistant may re-implement work that is already done, wasting the user's time and risking regressions.\n\nSplit compound statements into separate observations.\nIf a single message contains multiple independent facts, intents, or events, emit one observation per fact. One observation per line is what enables downstream retrieval and pruning to operate at fact granularity.\n  BAD:  User will visit their parents this weekend and needs to clean the garage.\n  GOOD: User will visit their parents this weekend. + User stated they need to clean the garage this weekend.\n  BAD:  User started a new job and is moving to a new apartment next week.\n  GOOD: User started a new job. + User will move to a new apartment next week.\n  BAD:  Assistant recommended Lucia, NextAuth, and Clerk for auth, and user chose Lucia.\n  GOOD: Assistant recommended auth libraries: Lucia (session-based, minimal), NextAuth (OAuth-heavy, Next-native), Clerk (hosted, paid). + User chose Lucia.\nWhy this matters: a future query like \"which auth library did the user pick?\" can match a single-fact observation cleanly; a compound observation hides the decision inside a recommendation list.\n\nGroup repeated similar tool calls into a single observation rather than one per call.\n  BAD:  Agent viewed src/auth.ts. Agent viewed src/users.ts. Agent viewed src/routes.ts.\n  GOOD: Agent surveyed auth-related files (src/auth.ts, src/users.ts, src/routes.ts) and located token validation in src/auth.ts:45.\n\nDetail preservation. When an observation references specific things, preserve the distinguishing details so future queries can still find them:\n\n- File/location: full path + line number when relevant (src/auth.ts:45, not \"the auth file\").\n- Identifiers and names: package names, function names, variable names, handles, ticket ids, commit SHAs, error codes. Keep them verbatim.\n- Error messages: quote verbatim.\n    BAD:  Build failed with a type error.\n    GOOD: Build failed: TS2322: Type 'string | undefined' is not assignable to type 'string' at src/auth.ts:47.\n- Numerical results: exact values, units, and direction.\n    BAD:  Optimization made it faster.\n    GOOD: Optimization reduced p95 latency from 420ms to 180ms (57% faster).\n- Quantities and counts: \"3 failing tests (auth.test.ts, users.test.ts, routes.test.ts)\" not \"some failing tests\".\n- Recommendation or decision lists: preserve the distinguishing attribute per item.\n    BAD:  Assistant recommended 3 auth libraries.\n    GOOD: Assistant recommended auth libraries: Lucia (session-based, minimal), NextAuth (OAuth-heavy, Next-native), Clerk (hosted, paid).\n- Role / participation: capture the user's role at an event, not just attendance.\n    BAD:  User worked on the migration.\n    GOOD: User led the migration from MySQL to Postgres.\n\nIf a detail is non-obvious from the code or git history, it belongs in the observation. If it is trivially re-derivable, it does not.\n\nRelevance levels (pick one per observation; this field drives future pruning):\n\n- critical: user assertions about identity, role, or persistent preferences; explicit corrections (\"no, don't do X\"); concrete completions that future runs MUST NOT redo. These are load-bearing and will NEVER be dropped. Why this matters: if a \"critical\" item is lost, the assistant may redo finished work, contradict a correction, or misrepresent who the user is.\n- high: non-trivial technical decisions, architectural direction, unresolved blockers, key constraints. Worth keeping across many compactions.\n- medium: task-level context that helps within the current work but isn't durable. The default when you are unsure between medium and high.\n- low: routine tool-call acks, repetitive status updates, content trivially re-derivable from recent messages. The pruner will drop these first.\n\nDo NOT default to \"critical\" or \"high\". Most observations are medium or low. Reserve \"critical\" for things that would cause real damage if forgotten.\n\n  BAD:  relevance=critical for \"Agent ran tests and they passed.\"\n  GOOD: relevance=low for \"Agent ran tests and they passed.\" (routine; captured by a completion observation if it matters)\n\n  BAD:  relevance=medium for \"User said they are colorblind; red/green indicators do not work for them.\"\n  GOOD: relevance=critical for \"User said they are colorblind; red/green indicators do not work for them.\" (persistent constraint; forgetting it causes real harm)\n\nTimestamp format: \"YYYY-MM-DD HH:MM\" (local time, 24-hour, to the minute). This goes in the timestamp field, not the content.\n\nRemember: these observations are the assistant's ONLY memory of this chunk once the raw messages fall out of context. Make them count.";
 export declare const CONTEXT_USAGE_INSTRUCTIONS = "These are condensed memories from earlier in this session.\n\n- Reflections: stable, long-lived facts about the user, project, decisions, and constraints. New reflection lines may include ids in brackets wrapped in backticks.\n- Observations: timestamped events from the conversation history, in chronological order. Observation lines include ids in brackets wrapped in backticks.\n\nTreat these as past records. When entries conflict, the most recent observation reflects the latest known state. Work that prior observations describe as completed should not be redone unless the user explicitly asks to revisit it.\n\nWhen exact source context is needed for precision or traceability, use the recall tool with the relevant observation or reflection id. This is especially useful when a reflection materially affects a decision or is too compressed to continue confidently. Do not use recall as broad search or inject raw source unless it is needed.";
 //# sourceMappingURL=prompts.d.ts.map

package/dist/memory/prompts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/memory/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,+QAA+Q,CAAC;AAE1S,eAAO,MAAM,yBAAyB,6oHAmD+F,CAAC;AAEtI,eAAO,MAAM,0BAA0B,67CAkB+F,CAAC;AAEvI,eAAO,MAAM,gBAAgB,8+CAasI,CAAC;AAEpK,eAAO,MAAM,eAAe,knTAoC2G,CAAC;AAExI,eAAO,MAAM,0BAA0B,07BAOoS,CAAC"}
+{"version":3,"file":"prompts.d.ts","sourceRoot":"","sources":["../../src/memory/prompts.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,+QAA+Q,CAAC;AAE1S,eAAO,MAAM,yBAAyB,gpHAmD+F,CAAC;AAEtI,eAAO,MAAM,0BAA0B,67CAkB+F,CAAC;AAEvI,eAAO,MAAM,gBAAgB,8+CAasI,CAAC;AAEpK,eAAO,MAAM,eAAe,qnTAoC2G,CAAC;AAExI,eAAO,MAAM,0BAA0B,07BAOoS,CAAC"}

package/dist/memory/prompts.js

@@ -30,7 +30,7 @@ Use precise action verbs. Replace vague verbs with ones that clarify the nature
 Frame state changes as supersession so the old state is explicit.
   BAD:  User prefers React Query now.
   GOOD: User will use React Query (switching from SWR).
-Why this matters: without supersession framing, the reflector may crystallize both the old and the new as equally valid preferences.
+Why this matters: without supersession framing, later reflection may crystallize both the old and the new as equally valid preferences.
 
 Mark concrete completions explicitly.
 Use "completed:", "resolved:", "confirmed working", or similar phrasing so future runs know not to redo the work.

package/dist/memory/session-memory.d.ts

@@ -0,0 +1,21 @@
+import type { ExtensionAPI } from "../sdk/coding-agent/index.js";
+import { Runtime } from "./runtime.js";
+/**
+ * Session/branch memory layer.
+ *
+ * This layer owns the branch-scoped observational-memory pipeline:
+ *   - the observer (`observer.ts` via `observer-trigger.ts`) extracts
+ *     observations from new conversation turns;
+ *   - the deterministic pruner (`deterministic-pruner.ts` via
+ *     `compaction-hook.ts`) drops low-value observations at compaction time;
+ *   - the summary render path (`compaction.ts`) produces the compacted memory
+ *     that is persisted into `session_memory_snapshots`;
+ *   - the snapshot persistence hooks (`compaction-hook.ts`,
+ *     `compaction-trigger.ts`, `observer-trigger.ts`) keep that session memory
+ *     alive across compactions.
+ *
+ * It is intentionally separate from `project-observation-memory.ts`, which
+ * owns the per-machine + per-cwd, cross-session project observation store.
+ */
+export declare function registerSessionMemory(ext: ExtensionAPI, runtime: Runtime): void;
+//# sourceMappingURL=session-memory.d.ts.map

package/dist/memory/session-memory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"session-memory.d.ts","sourceRoot":"","sources":["../../src/memory/session-memory.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AAMjE,OAAO,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAIvC;;;;;;;;;;;;;;;;GAgBG;AACH,wBAAgB,qBAAqB,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAS/E"}