@aexol/spectral 0.9.183 → 0.9.185

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;AAWpC,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;AAicD,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;AAwcD,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,8 +25,7 @@
  *   - Access to observational memory via the recall tool
  */
 import { agentLoop } from "../sdk/agent-core/index.js";
-import { buildIsolatedRequestTimePrunedMessages, COMPACT_CONTEXT_TOOL_NAME, createIsolatedDcpNudgePayloadHook, } from "../memory/tools/compact-context.js";
-import { loadConfig } from "../memory/config.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";
@@ -446,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;
@@ -468,10 +471,6 @@ async function runSingleAgent(defaultCwd, agents, agentName, task, cwd, step, si
         const config = {
             model,
             apiKey: auth.apiKey,
-            onPayload: createIsolatedDcpNudgePayloadHook({
-                config: loadConfig(effectiveCwd),
-                policy: ctx.settingsManager?.getCompactionPolicy?.(),
-            }),
             headers: auth.headers,
             convertToLlm: (msgs) => msgs.filter((m) => m.role === "user" || m.role === "assistant" || m.role === "toolResult"),
             toolExecution: "parallel",
@@ -479,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);
+                    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":"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"}
+{"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/config.d.ts

@@ -23,18 +23,8 @@ export interface Config {
     observerMaxChunkTokens?: number;
     reflectorMaxTurnsPerPass?: number;
     prunerMaxTurnsPerPass?: number;
-    /** Raw source tokens since last compaction before adding DCP-lite nudges. */
-    dcpNudgeMinRawTokens: number;
-    /** Absolute context tokens before adding DCP-lite nudges. Mirrors DCP compress.minContextLimit. */
-    dcpNudgeMinContextTokens: number;
-    /** Context-window percent before adding DCP-lite nudges. */
-    dcpNudgeContextPercent: number;
-    /** Minimum turns between repeated DCP-lite nudges. */
-    dcpNudgeTurnInterval: number;
-    /** Provider requests after a user prompt before adding an in-run DCP-lite nudge. */
-    dcpInRunNudgeIterationThreshold: number;
-    /** Minimum provider requests between repeated in-run DCP-lite nudges. */
-    dcpInRunNudgeFrequency: number;
+    /** Absolute context tokens at which DCP-lite auto older-history compaction triggers. Default: 50_000. */
+    autoCompactionContextTokens: number;
     /** @deprecated Use reflectorMaxTurnsPerPass and prunerMaxTurnsPerPass. */
     compactionMaxToolCalls?: number;
     interAgent?: InterAgentConfig;

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

@@ -1 +1 @@
-{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/memory/config.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAChC,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4DAA4D;IAC5D,qBAAqB,CAAC,EAAE,SAAS,CAAC;IAClC,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACtB,0BAA0B,EAAE,MAAM,CAAC;IACnC,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,6EAA6E;IAC7E,oBAAoB,EAAE,MAAM,CAAC;IAC7B,mGAAmG;IACnG,wBAAwB,EAAE,MAAM,CAAC;IACjC,4DAA4D;IAC5D,sBAAsB,EAAE,MAAM,CAAC;IAC/B,sDAAsD;IACtD,oBAAoB,EAAE,MAAM,CAAC;IAC7B,oFAAoF;IACpF,+BAA+B,EAAE,MAAM,CAAC;IACxC,yEAAyE;IACzE,sBAAsB,EAAE,MAAM,CAAC;IAC/B,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,qBAAqB,EAAE,MAAM,CAAC;CAC9B;AAcD,eAAO,MAAM,QAAQ,EAAE,MAatB,CAAC;AAsEF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAMrE;AAED,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnF;AAyBD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAUpF;AAED,gEAAgE;AAChE,wBAAsB,eAAe,CACpC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,OAAO,CAAC,MAAM,CAAC,CAUjB"}
+{"version":3,"file":"config.d.ts","sourceRoot":"","sources":["../../src/memory/config.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,SAAS,GAAG,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;AAE/D,MAAM,WAAW,gBAAgB;IAChC,yFAAyF;IACzF,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,4DAA4D;IAC5D,qBAAqB,CAAC,EAAE,SAAS,CAAC;IAClC,wEAAwE;IACxE,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,+DAA+D;IAC/D,UAAU,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,MAAM,WAAW,MAAM;IACtB,0BAA0B,EAAE,MAAM,CAAC;IACnC,yBAAyB,EAAE,MAAM,CAAC;IAClC,yBAAyB,EAAE,MAAM,CAAC;IAClC,OAAO,EAAE,OAAO,CAAC;IACjB,QAAQ,EAAE,OAAO,CAAC;IAClB,eAAe,CAAC,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAC;QAAC,EAAE,EAAE,MAAM,CAAA;KAAE,CAAC;IACnD,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,wBAAwB,CAAC,EAAE,MAAM,CAAC;IAClC,qBAAqB,CAAC,EAAE,MAAM,CAAC;IAC/B,yGAAyG;IACzG,2BAA2B,EAAE,MAAM,CAAC;IACpC,0EAA0E;IAC1E,sBAAsB,CAAC,EAAE,MAAM,CAAC;IAChC,UAAU,CAAC,EAAE,gBAAgB,CAAC;CAC9B;AAED,MAAM,WAAW,mBAAmB;IACnC,sBAAsB,EAAE,MAAM,CAAC;IAC/B,wBAAwB,EAAE,MAAM,CAAC;IACjC,qBAAqB,EAAE,MAAM,CAAC;CAC9B;AAUD,eAAO,MAAM,QAAQ,EAAE,MAQtB,CAAC;AA0DF,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,MAAM,GAAG,mBAAmB,CAMrE;AAED,wBAAgB,aAAa,CAAC,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,OAAO,CAAC,MAAM,CAAC,CAOnF;AAyBD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,EAAE,GAAG,GAAE,MAAM,CAAC,UAAwB,GAAG,MAAM,CAUpF;AAED,gEAAgE;AAChE,wBAAsB,eAAe,CACpC,GAAG,EAAE,MAAM,EACX,GAAG,GAAE,MAAM,CAAC,UAAwB,GAClC,OAAO,CAAC,MAAM,CAAC,CAUjB"}

package/dist/memory/config.js

@@ -9,12 +9,7 @@ export const DEFAULTS = {
     passive: false,
     debugLog: false,
     observerMaxChunkTokens: 30_000,
-    dcpNudgeMinRawTokens: 15_000,
-    dcpNudgeMinContextTokens: 50_000,
-    dcpNudgeContextPercent: 35,
-    dcpNudgeTurnInterval: 5,
-    dcpInRunNudgeIterationThreshold: 15,
-    dcpInRunNudgeFrequency: 5,
+    autoCompactionContextTokens: 50_000,
 };
 const SETTINGS_KEY = "observational-memory";
 const PASSIVE_ENV = "PI_OBSERVATIONAL_MEMORY_PASSIVE";
@@ -33,14 +28,6 @@ function normalizeTurnLimit(normalized, key) {
         normalized[key] = value;
     }
 }
-function normalizePercent(normalized, key) {
-    if (!(key in normalized))
-        return;
-    const value = normalized[key];
-    if (typeof value === "number" && Number.isFinite(value) && value > 0 && value <= 100)
-        return;
-    delete normalized[key];
-}
 const RELEVANCE_VALUES = ["low", "medium", "high", "critical"];
 function normalizeInterAgentConfig(value) {
     if (!value || typeof value !== "object")
@@ -69,12 +56,7 @@ function normalizeSettingsConfig(value) {
     normalizeTurnLimit(normalized, "observerMaxChunkTokens");
     normalizeTurnLimit(normalized, "reflectorMaxTurnsPerPass");
     normalizeTurnLimit(normalized, "prunerMaxTurnsPerPass");
-    normalizeTurnLimit(normalized, "dcpNudgeMinRawTokens");
-    normalizeTurnLimit(normalized, "dcpNudgeMinContextTokens");
-    normalizeTurnLimit(normalized, "dcpNudgeTurnInterval");
-    normalizeTurnLimit(normalized, "dcpInRunNudgeIterationThreshold");
-    normalizeTurnLimit(normalized, "dcpInRunNudgeFrequency");
-    normalizePercent(normalized, "dcpNudgeContextPercent");
+    normalizeTurnLimit(normalized, "autoCompactionContextTokens");
     normalizeTurnLimit(normalized, "compactionMaxToolCalls");
     if ("interAgent" in normalized) {
         const normalizedInterAgent = normalizeInterAgentConfig(normalized.interAgent);

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;