@aexol/spectral 0.9.184 → 0.9.186

package/dist/memory/session-memory.js

@@ -0,0 +1,33 @@
+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 { registerObserverTrigger } from "./hooks/observer-trigger.js";
+import { registerToolOutputCompressor } from "./tool-output-compressor.js";
+import { registerCompactContextTool } from "./tools/compact-context.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 function registerSessionMemory(ext, runtime) {
+    registerObserverTrigger(ext, runtime);
+    registerCompactContextTool(ext, runtime);
+    registerCompactionTrigger(ext, runtime);
+    registerCompactionHook(ext, runtime);
+    registerToolOutputCompressor(ext, runtime);
+    registerStatusCommand(ext, runtime);
+    registerViewCommand(ext, runtime);
+}

package/dist/memory/tool-output-compressor.d.ts

@@ -5,7 +5,6 @@
  * This is complementary to the conversation-level compaction pipeline:
  * - Compressor: compresses raw tool output (pre-context)
  * - Compaction: summarizes + prunes conversation history (post-context)
- * - Unified compaction: narrative summary + observation extraction (at compaction boundary)
  *
  * Strategies (mirroring RTK's four-pronged approach):
  *

package/dist/memory/tool-output-compressor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"tool-output-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/tool-output-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAEX,gBAAgB,EAIhB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAGN,KAAK,0BAA0B,EAC/B,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAO5C,MAAM,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAE1D,eAAO,MAAM,yBAAyB,EAAE,gBAEvC,CAAC;AAgsBF,MAAM,WAAW,gBAAgB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F;AA8BD,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,8BAA8B,CAElG;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE1E;AAkDD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EAC7F,GAAG,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,GAC7C,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAYvG;AAED,wBAAgB,4BAA4B,CAC3C,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,OAAO,GACd,IAAI,CAkCN"}
+{"version":3,"file":"tool-output-compressor.d.ts","sourceRoot":"","sources":["../../src/memory/tool-output-compressor.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,8BAA8B,CAAC;AACjE,OAAO,KAAK,EAEX,gBAAgB,EAIhB,MAAM,8CAA8C,CAAC;AACtD,OAAO,EAGN,KAAK,0BAA0B,EAC/B,MAAM,+CAA+C,CAAC;AACvD,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,cAAc,CAAC;AAO5C,MAAM,MAAM,gBAAgB,GAAG,0BAA0B,CAAC;AAE1D,eAAO,MAAM,yBAAyB,EAAE,gBAEvC,CAAC;AAgsBF,MAAM,WAAW,gBAAgB;IAChC,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,cAAc,EAAE,MAAM,CAAC;IACvB,QAAQ,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,8BAA8B;IAC9C,MAAM,EAAE,MAAM,CAAC;IACf,aAAa,EAAE,MAAM,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE;QAAE,MAAM,EAAE,MAAM,CAAC;QAAC,aAAa,EAAE,MAAM,CAAC;QAAC,eAAe,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC;CAC3F;AA8BD,wBAAgB,iCAAiC,CAAC,OAAO,EAAE,OAAO,GAAG,8BAA8B,CAElG;AAED,wBAAgB,mCAAmC,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAE1E;AAkDD;;;;;GAKG;AACH,wBAAgB,0BAA0B,CACzC,QAAQ,EAAE,MAAM,EAChB,KAAK,EAAE,OAAO,EACd,MAAM,EAAE;IAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC,CAAA;CAAE,EAC7F,GAAG,CAAC,EAAE,IAAI,CAAC,gBAAgB,EAAE,iBAAiB,CAAC,GAC7C,KAAK,CAAC;IAAE,IAAI,EAAE,MAAM,CAAC;IAAC,IAAI,EAAE,MAAM,CAAA;CAAE,GAAG;IAAE,IAAI,EAAE,OAAO,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,CAAC,GAAG,SAAS,CAYvG;AAED,wBAAgB,4BAA4B,CAC3C,GAAG,EAAE,YAAY,EACjB,OAAO,EAAE,OAAO,GACd,IAAI,CAkCN"}

package/dist/memory/tool-output-compressor.js

@@ -5,7 +5,6 @@
  * This is complementary to the conversation-level compaction pipeline:
  * - Compressor: compresses raw tool output (pre-context)
  * - Compaction: summarizes + prunes conversation history (post-context)
- * - Unified compaction: narrative summary + observation extraction (at compaction boundary)
  *
  * Strategies (mirroring RTK's four-pronged approach):
  *

package/dist/memory/tools/compact-context.d.ts

@@ -3,7 +3,38 @@ import { type CompactionPolicy } from "../../sdk/coding-agent/core/compaction/in
 import { type ExtensionAPI } from "../../sdk/coding-agent/index.js";
 import type { Runtime } from "../runtime.js";
 export declare const COMPACT_CONTEXT_TOOL_NAME = "compact_context";
+export interface AutoPruneFrozen {
+    /** Session identity used to invalidate the frozen cut after branch/session switches. */
+    sessionId: string;
+    /** Index into the provider message array for the first kept message. */
+    cutIndex: number;
+    /** Stable AgentMessage reference at `cutIndex`, used as an O(1) identity anchor. */
+    anchor: AgentMessage;
+    /** Deterministic DCP-lite summary generated at the original prune. */
+    summary: string;
+    /** Original tokensBefore for the frozen compaction summary message. */
+    tokensBefore: number;
+    /** Original compaction timestamp for the frozen compaction summary message. */
+    timestamp: string;
+    /** Keep-recent token budget that produced this cut (policy-change invalidation). */
+    keepRecentTokensUsed: number;
+    /** Token estimate of the kept tail at the moment the cut was frozen. */
+    tailTokensAtFreeze: number;
+}
 /** Request-time DCP adapter for isolated loops: it borrows only pure policy helpers. */
 export declare function buildIsolatedRequestTimePrunedMessages(currentMessages: AgentMessage[], policy?: CompactionPolicy, keepRecentTokens?: number): AgentMessage[];
+export interface IsolatedRequestTimePruneResult {
+    messages: AgentMessage[];
+    frozen: AutoPruneFrozen | null;
+}
+/**
+ * Stateful per-run variant of {@link buildIsolatedRequestTimePrunedMessages}.
+ *
+ * The subagent loop owns the returned `frozen` value across provider requests.
+ * On the first prune we freeze the deterministic summary + cut, then reuse that
+ * exact prefix until the kept-tail anchor reference changes or the tail grows
+ * past the window-relative hysteresis budget.
+ */
+export declare function buildIsolatedRequestTimePrunedMessagesResult(currentMessages: AgentMessage[], policy?: CompactionPolicy, keepRecentTokens?: number, frozen?: AutoPruneFrozen | null, contextWindow?: number | null): IsolatedRequestTimePruneResult;
 export declare function registerCompactContextTool(ext: ExtensionAPI, runtime: Runtime): void;
 //# sourceMappingURL=compact-context.d.ts.map

package/dist/memory/tools/compact-context.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"compact-context.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/compact-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAUN,KAAK,gBAAgB,EACrB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAc,KAAK,YAAY,EAAyB,MAAM,iCAAiC,CAAC;AAKvG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AAkX3D,wFAAwF;AACxF,wBAAgB,sCAAsC,CACrD,eAAe,EAAE,YAAY,EAAE,EAC/B,MAAM,GAAE,gBAA4C,EACpD,gBAAgB,CAAC,EAAE,MAAM,GACvB,YAAY,EAAE,CAchB;AAmRD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAgPpF"}
+{"version":3,"file":"compact-context.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/compact-context.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,+BAA+B,CAAC;AAClE,OAAO,EAaN,KAAK,gBAAgB,EACrB,MAAM,iDAAiD,CAAC;AACzD,OAAO,EAAc,KAAK,YAAY,EAAyB,MAAM,iCAAiC,CAAC;AAMvG,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,eAAe,CAAC;AAE7C,eAAO,MAAM,yBAAyB,oBAAoB,CAAC;AA+F3D,MAAM,WAAW,eAAe;IAC/B,wFAAwF;IACxF,SAAS,EAAE,MAAM,CAAC;IAClB,wEAAwE;IACxE,QAAQ,EAAE,MAAM,CAAC;IACjB,oFAAoF;IACpF,MAAM,EAAE,YAAY,CAAC;IACrB,sEAAsE;IACtE,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,YAAY,EAAE,MAAM,CAAC;IACrB,+EAA+E;IAC/E,SAAS,EAAE,MAAM,CAAC;IAClB,oFAAoF;IACpF,oBAAoB,EAAE,MAAM,CAAC;IAC7B,wEAAwE;IACxE,kBAAkB,EAAE,MAAM,CAAC;CAC3B;AAgYD,wFAAwF;AACxF,wBAAgB,sCAAsC,CACrD,eAAe,EAAE,YAAY,EAAE,EAC/B,MAAM,GAAE,gBAA4C,EACpD,gBAAgB,CAAC,EAAE,MAAM,GACvB,YAAY,EAAE,CAMhB;AAED,MAAM,WAAW,8BAA8B;IAC9C,QAAQ,EAAE,YAAY,EAAE,CAAC;IACzB,MAAM,EAAE,eAAe,GAAG,IAAI,CAAC;CAC/B;AAkBD;;;;;;;GAOG;AACH,wBAAgB,4CAA4C,CAC3D,eAAe,EAAE,YAAY,EAAE,EAC/B,MAAM,GAAE,gBAA4C,EACpD,gBAAgB,CAAC,EAAE,MAAM,EACzB,MAAM,CAAC,EAAE,eAAe,GAAG,IAAI,EAC/B,aAAa,CAAC,EAAE,MAAM,GAAG,IAAI,GAC3B,8BAA8B,CA4DhC;AA0SD,wBAAgB,0BAA0B,CAAC,GAAG,EAAE,YAAY,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAgTpF"}

package/dist/memory/tools/compact-context.js

@@ -1,7 +1,8 @@
 import { Type } from "../../sdk/ai/index.js";
-import { compactDcpLite, DEFAULT_COMPACTION_POLICY, estimateTokens, getManualCompactionSettings, normalizeAgentDrivenOlderHistoryKeepRecentTokens, prepareCompaction, decideCompaction, } from "../../sdk/coding-agent/core/compaction/index.js";
+import { compactDcpLite, CONTEXT_LIMIT_RATIO, DEFAULT_COMPACTION_POLICY, estimateTokens, getManualCompactionSettings, normalizeAgentDrivenOlderHistoryKeepRecentTokens, prepareCompaction, decideCompaction, getAutoOlderHistoryHysteresisTokens, getAutoOlderHistoryKeepRecentTokens, } from "../../sdk/coding-agent/core/compaction/index.js";
 import { defineTool } from "../../sdk/coding-agent/index.js";
 import { buildSessionContext } from "../../sdk/coding-agent/core/session-manager.js";
+import { createCompactionSummaryMessage } from "../../sdk/coding-agent/core/messages.js";
 import { rawTokensSinceLastCompaction } from "../branch.js";
 import { debugLog, withDebugLogContext } from "../debug-log.js";
 export const COMPACT_CONTEXT_TOOL_NAME = "compact_context";
@@ -61,6 +62,7 @@ function getState(runtime) {
             request: null,
             turnCount: 0,
             lastAgentDrivenRequestTurn: null,
+            autoPruneFrozen: null,
         };
         stateByRuntime.set(runtime, state);
     }
@@ -176,12 +178,32 @@ function getAutoOlderHistoryRequestSettings(policy) {
         pinLatestUserMessage: true,
     };
 }
+function getContextWindow(ctx) {
+    try {
+        const usage = ctx.getContextUsage();
+        if (usage && typeof usage.contextWindow === "number" && usage.contextWindow > 0) {
+            return usage.contextWindow;
+        }
+    }
+    catch {
+        // getContextUsage is optional in some headless harnesses.
+    }
+    const modelWindow = ctx.model?.contextWindow;
+    return typeof modelWindow === "number" && modelWindow > 0 ? modelWindow : undefined;
+}
+function getAutoRequestTimeRequestSettings(policy, contextWindow) {
+    const keepRecentTokens = getAutoOlderHistoryKeepRecentTokens(policy, contextWindow) ?? policy.agentDriven.olderHistoryKeepRecentTokens;
+    return {
+        phaseBoundary: false,
+        scope: "older_history",
+        keepRecentTokens,
+        minRawTokens: keepRecentTokens + policy.agentDriven.olderHistoryMinCompactableTokens,
+        pinLatestUserMessage: true,
+    };
+}
 function isContextAtOrAboveRatio(percent, ratio) {
     return typeof percent === "number" && Number.isFinite(percent) && percent >= ratio * 100;
 }
-function isContextAtOrAboveTokenLimit(contextTokens, tokenLimit) {
-    return typeof contextTokens === "number" && Number.isFinite(contextTokens) && contextTokens >= tokenLimit;
-}
 function hasPendingModelRequest(ctx) {
     try {
         if (!ctx.isIdle())
@@ -196,8 +218,11 @@ function hasPendingModelRequest(ctx) {
         return false;
     }
 }
-function decideAutoCompaction(ctx, runtime, state, policy, rawTokens, contextTokens, percent, iterationSignal = false, isMidRun = hasPendingModelRequest(ctx)) {
-    const requestSettings = getAutoOlderHistoryRequestSettings(policy);
+function decideAutoCompaction(ctx, runtime, state, policy, rawTokens, percent, iterationSignal = false, isMidRun = hasPendingModelRequest(ctx)) {
+    const contextWindow = getContextWindow(ctx);
+    const requestSettings = isMidRun
+        ? getAutoRequestTimeRequestSettings(policy, contextWindow)
+        : getAutoOlderHistoryRequestSettings(policy);
     return decideCompaction({
         source: "automatic",
         isMidRun,
@@ -206,17 +231,17 @@ function decideAutoCompaction(ctx, runtime, state, policy, rawTokens, contextTok
         pending: state.request !== null,
         cooldownActive: remainingCooldownTurns(state, policy) > 0,
         hasSufficientMaterial: rawTokens >= requestSettings.minRawTokens,
-        contextRatioReached: isContextAtOrAboveRatio(percent, policy.autoOlderHistory.contextLimitRatio),
-        absoluteThresholdReached: isContextAtOrAboveTokenLimit(contextTokens, runtime.config.autoCompactionContextTokens),
-        rawThresholdReached: rawTokens >= runtime.config.compactionThresholdTokens,
+        contextRatioReached: isContextAtOrAboveRatio(percent, CONTEXT_LIMIT_RATIO),
         iterationReached: iterationSignal,
     });
 }
-function maybeScheduleAutoOlderHistoryCompaction(ctx, runtime, state, policy, rawTokens, contextTokens, percent, iterationSignal = false) {
-    const decision = decideAutoCompaction(ctx, runtime, state, policy, rawTokens, contextTokens, percent, iterationSignal);
+function maybeScheduleAutoOlderHistoryCompaction(ctx, runtime, state, policy, rawTokens, percent, iterationSignal = false) {
+    const decision = decideAutoCompaction(ctx, runtime, state, policy, rawTokens, percent, iterationSignal);
     if (decision.mode === "none")
         return false;
-    const requestSettings = getAutoOlderHistoryRequestSettings(policy);
+    const requestSettings = decision.mode === "request_time"
+        ? getAutoRequestTimeRequestSettings(policy, getContextWindow(ctx))
+        : getAutoOlderHistoryRequestSettings(policy);
     state.lastAgentDrivenRequestTurn = state.turnCount;
     state.request = { source: "auto", mode: decision.mode, ...requestSettings };
     if (decision.mode === "request_time")
@@ -241,12 +266,27 @@ function getRequestTimeCompactionSettings(request, policy) {
 function getBranchEntries(ctx) {
     return ctx.sessionManager.getBranch();
 }
-function createVirtualCompactionEntry(pathEntries, result) {
+function getAutoPruneSessionId(ctx) {
+    try {
+        return ctx.sessionManager.getSessionId();
+    }
+    catch {
+        return "unknown-session";
+    }
+}
+function autoPruneFrozenIdentityMatches(frozen, sessionId, currentMessages) {
+    if (frozen.sessionId !== sessionId)
+        return false;
+    return currentMessages.length > frozen.cutIndex &&
+        frozen.cutIndex >= 0 &&
+        currentMessages[frozen.cutIndex] === frozen.anchor;
+}
+function createVirtualCompactionEntry(pathEntries, result, timestamp) {
     return {
         type: "compaction",
         id: REQUEST_TIME_VIRTUAL_COMPACTION_ID,
         parentId: pathEntries[pathEntries.length - 1]?.id ?? null,
-        timestamp: pathEntries[pathEntries.length - 1]?.timestamp ?? new Date().toISOString(),
+        timestamp: timestamp ?? pathEntries[pathEntries.length - 1]?.timestamp ?? new Date().toISOString(),
         summary: result.summary,
         firstKeptEntryId: result.firstKeptEntryId,
         tokensBefore: result.tokensBefore,
@@ -270,12 +310,55 @@ function buildRequestTimePrunedMessages(ctx, request, policy, currentMessages, o
         message,
     }));
     const fromCurrentMessages = buildRequestTimePrunedMessagesFromEntries(currentEntries, request, policy, currentMessages, onFailure);
-    if (fromCurrentMessages)
+    if (fromCurrentMessages) {
+        if (typeof fromCurrentMessages.cutIndex === "number") {
+            fromCurrentMessages.anchorMessage = currentMessages[fromCurrentMessages.cutIndex];
+        }
         return fromCurrentMessages;
+    }
     return buildRequestTimePrunedMessagesFromEntries(getBranchEntries(ctx), request, policy, currentMessages, onFailure);
 }
+function buildFrozenRequestTimePrunedMessages(frozen, currentMessages) {
+    if (frozen.cutIndex < 0 ||
+        currentMessages.length <= frozen.cutIndex ||
+        currentMessages[frozen.cutIndex] !== frozen.anchor) {
+        return undefined;
+    }
+    const messages = [
+        createCompactionSummaryMessage(frozen.summary, frozen.tokensBefore, frozen.timestamp),
+        ...currentMessages.slice(frozen.cutIndex),
+    ];
+    const originalTokens = rawTokensForCurrentMessages(currentMessages);
+    const prunedTokens = rawTokensForCurrentMessages(messages);
+    if (prunedTokens >= originalTokens)
+        return undefined;
+    return {
+        messages,
+        tokensRemoved: Math.max(0, originalTokens - prunedTokens),
+        originalTokens,
+        prunedTokens,
+    };
+}
 /** Request-time DCP adapter for isolated loops: it borrows only pure policy helpers. */
 export function buildIsolatedRequestTimePrunedMessages(currentMessages, policy = DEFAULT_COMPACTION_POLICY, keepRecentTokens) {
+    return buildIsolatedRequestTimePrunedMessagesResult(currentMessages, policy, keepRecentTokens).messages;
+}
+function autoPruneHysteresisExceeded(frozen, currentMessages, policy, contextWindow) {
+    if (frozen.cutIndex < 0 || frozen.cutIndex >= currentMessages.length)
+        return true;
+    const tailTokens = rawTokensForCurrentMessages(currentMessages.slice(frozen.cutIndex));
+    const hysteresisTokens = getAutoOlderHistoryHysteresisTokens(policy, contextWindow, frozen.keepRecentTokensUsed);
+    return tailTokens - frozen.tailTokensAtFreeze > hysteresisTokens;
+}
+/**
+ * Stateful per-run variant of {@link buildIsolatedRequestTimePrunedMessages}.
+ *
+ * The subagent loop owns the returned `frozen` value across provider requests.
+ * On the first prune we freeze the deterministic summary + cut, then reuse that
+ * exact prefix until the kept-tail anchor reference changes or the tail grows
+ * past the window-relative hysteresis budget.
+ */
+export function buildIsolatedRequestTimePrunedMessagesResult(currentMessages, policy = DEFAULT_COMPACTION_POLICY, keepRecentTokens, frozen, contextWindow) {
     const syntheticEntries = currentMessages.map((message, index) => ({
         type: "message",
         id: `isolated-${index}`,
@@ -283,18 +366,69 @@ export function buildIsolatedRequestTimePrunedMessages(currentMessages, policy =
         timestamp: new Date(index).toISOString(),
         message,
     }));
-    return buildRequestTimePrunedMessagesFromEntries(syntheticEntries, { source: "auto", mode: "request_time", scope: "older_history", keepRecentTokens, phaseBoundary: false, minRawTokens: 0, pinLatestUserMessage: true }, policy, currentMessages)?.messages ?? currentMessages;
+    const resolvedKeepRecentTokens = getAutoOlderHistoryKeepRecentTokens(policy, contextWindow, keepRecentTokens);
+    const request = {
+        source: "auto",
+        mode: "request_time",
+        scope: "older_history",
+        keepRecentTokens: resolvedKeepRecentTokens,
+        phaseBoundary: false,
+        minRawTokens: 0,
+        pinLatestUserMessage: true,
+    };
+    const sessionId = "isolated-subagent-run";
+    if (frozen &&
+        frozen.keepRecentTokensUsed === resolvedKeepRecentTokens &&
+        autoPruneFrozenIdentityMatches(frozen, sessionId, currentMessages) &&
+        !autoPruneHysteresisExceeded(frozen, currentMessages, policy, contextWindow)) {
+        const reused = buildFrozenRequestTimePrunedMessages(frozen, currentMessages);
+        if (reused)
+            return { messages: reused.messages, frozen };
+    }
+    const pruned = buildRequestTimePrunedMessagesFromEntries(syntheticEntries, request, policy, currentMessages);
+    const cutIndex = pruned?.cutIndex;
+    const anchorMessage = typeof cutIndex === "number" ? currentMessages[cutIndex] : undefined;
+    if (!pruned ||
+        typeof cutIndex !== "number" ||
+        anchorMessage === undefined ||
+        typeof pruned.summary !== "string") {
+        return { messages: currentMessages, frozen: null };
+    }
+    const nextFrozen = {
+        sessionId,
+        cutIndex,
+        anchor: anchorMessage,
+        summary: pruned.summary,
+        tokensBefore: pruned.tokensBefore ?? 0,
+        timestamp: pruned.timestamp ?? new Date().toISOString(),
+        keepRecentTokensUsed: resolvedKeepRecentTokens ?? 0,
+        tailTokensAtFreeze: rawTokensForCurrentMessages(currentMessages.slice(cutIndex)),
+    };
+    return { messages: pruned.messages, frozen: nextFrozen };
 }
 function buildRequestTimePrunedMessagesFromEntries(pathEntries, request, policy, currentMessages, onFailure) {
     const settings = getRequestTimeCompactionSettings(request, policy);
-    const preparation = prepareCompaction(pathEntries, settings, { phaseBoundary: request.phaseBoundary, pinLatestUserMessage: request.pinLatestUserMessage });
+    const preparation = prepareCompaction(pathEntries, settings, {
+        phaseBoundary: request.phaseBoundary,
+        pinLatestUserMessage: request.pinLatestUserMessage,
+    });
     if (!preparation) {
         onFailure?.("prepare_compaction_returned_undefined");
         return undefined;
     }
     const result = compactDcpLite(preparation);
+    const summary = result.summary;
+    const firstKeptEntryId = result.firstKeptEntryId;
+    const tokensBefore = result.tokensBefore;
+    const details = result.details;
     const tokensRemoved = Math.max(0, result.tokensRemoved ?? 0);
-    const virtualCompaction = createVirtualCompactionEntry(pathEntries, result);
+    const virtualTimestamp = pathEntries[pathEntries.length - 1]?.timestamp ?? new Date().toISOString();
+    const virtualCompaction = createVirtualCompactionEntry(pathEntries, {
+        summary,
+        firstKeptEntryId,
+        tokensBefore,
+        details,
+    }, virtualTimestamp);
     const virtualContext = buildSessionContext([...pathEntries, virtualCompaction]);
     if (virtualContext.messages.length === 0) {
         onFailure?.("virtual_context_has_no_messages");
@@ -311,7 +445,17 @@ function buildRequestTimePrunedMessagesFromEntries(pathEntries, request, policy,
             : `pruned_context_not_smaller:${originalTokens}->${prunedTokens}`);
         return undefined;
     }
-    return { messages: virtualContext.messages, tokensRemoved, originalTokens, prunedTokens };
+    const cutIndex = pathEntries.findIndex((entry) => entry.id === firstKeptEntryId);
+    return {
+        messages: virtualContext.messages,
+        tokensRemoved,
+        originalTokens,
+        prunedTokens,
+        cutIndex: cutIndex >= 0 ? cutIndex : undefined,
+        summary,
+        tokensBefore,
+        timestamp: virtualTimestamp,
+    };
 }
 function notifyDcp(ctx, message, level, telemetry) {
     const notify = ctx.ui?.notify;
@@ -499,9 +643,8 @@ export function registerCompactContextTool(ext, runtime) {
             rawTokens = 0;
         }
         const usage = ctx.getContextUsage();
-        const contextTokens = usage?.tokens;
         const percent = usage?.percent;
-        maybeScheduleAutoOlderHistoryCompaction(ctx, runtime, state, policy, rawTokens, contextTokens, percent);
+        maybeScheduleAutoOlderHistoryCompaction(ctx, runtime, state, policy, rawTokens, percent);
     }));
     ext.on("context", withDebug((_event, ctx) => {
         runtime.ensureConfig(ctx.cwd);
@@ -566,12 +709,53 @@ export function registerCompactContextTool(ext, runtime) {
         // The context hook is the last zero-lag seam before conversion/provider send.
         // Treat an explicit provider-preparation event as in-run even if the session
         // state has not flipped to streaming/pending yet.
-        const autoSettings = getAutoOlderHistoryRequestSettings(policy);
+        const autoContextWindow = getContextWindow(ctx);
+        const autoSettings = getAutoRequestTimeRequestSettings(policy, autoContextWindow);
         const autoRawTokens = Math.max(safeRawTokensForContext(ctx), rawTokensForCurrentMessages(_event.messages));
         const autoUsage = ctx.getContextUsage();
         const autoContextTokens = autoUsage?.tokens;
         const autoPercent = autoUsage?.percent;
-        const autoDecision = decideAutoCompaction(ctx, runtime, state, policy, autoRawTokens, autoContextTokens, autoPercent, false, isMidRun);
+        const autoSessionId = getAutoPruneSessionId(ctx);
+        // 2a. Frozen cut reuse. Once the auto path has pruned, keep reusing the
+        //     exact summary + anchor so the provider prompt prefix stays byte
+        //     stable across requests. Only invalidate on identity mismatch or
+        //     when the kept tail grows past the window-relative hysteresis budget.
+        let frozen = state.autoPruneFrozen ?? null;
+        if (frozen && isMidRun) {
+            const identityMatches = autoPruneFrozenIdentityMatches(frozen, autoSessionId, _event.messages);
+            const keepRecentMatches = frozen.keepRecentTokensUsed === (autoSettings.keepRecentTokens ?? 0);
+            const hysteresisExceeded = autoPruneHysteresisExceeded(frozen, _event.messages, policy, autoContextWindow);
+            if (!identityMatches || !keepRecentMatches || hysteresisExceeded) {
+                state.autoPruneFrozen = null;
+                frozen = null;
+            }
+            else {
+                const frozenPruned = buildFrozenRequestTimePrunedMessages(frozen, _event.messages);
+                if (frozenPruned) {
+                    debugLog("compact_context.request_time.auto_frozen_reuse", {
+                        rawTokens: autoRawTokens,
+                        contextTokens: autoContextTokens ?? null,
+                        percent: autoPercent ?? null,
+                        originalTokens: frozenPruned.originalTokens,
+                        prunedTokens: frozenPruned.prunedTokens,
+                        tokensRemoved: frozenPruned.tokensRemoved,
+                        cutIndex: frozen.cutIndex,
+                    });
+                    notifyRequestTimeApplied(ctx, frozenPruned, { source: "auto", mode: "request_time", ...autoSettings });
+                    return { messages: frozenPruned.messages };
+                }
+                debugLog("compact_context.request_time.auto_frozen_invalid", {
+                    rawTokens: autoRawTokens,
+                    contextTokens: autoContextTokens ?? null,
+                    percent: autoPercent ?? null,
+                    reason: "frozen_identity_or_payload_invalid",
+                    cutIndex: frozen.cutIndex,
+                });
+                state.autoPruneFrozen = null;
+                frozen = null;
+            }
+        }
+        const autoDecision = decideAutoCompaction(ctx, runtime, state, policy, autoRawTokens, autoPercent, false, isMidRun);
         if (autoDecision.mode !== "request_time")
             return;
         const autoRequest = { source: "auto", mode: autoDecision.mode, ...autoSettings };
@@ -597,7 +781,24 @@ export function registerCompactContextTool(ext, runtime) {
             originalTokens: autoPruned.originalTokens,
             prunedTokens: autoPruned.prunedTokens,
             tokensRemoved: autoPruned.tokensRemoved,
+            frozen: false,
         });
+        const autoCutIndex = autoPruned.cutIndex;
+        const autoAnchorMessage = autoPruned.anchorMessage;
+        if (typeof autoCutIndex === "number" &&
+            autoAnchorMessage !== undefined &&
+            typeof autoPruned.summary === "string") {
+            state.autoPruneFrozen = {
+                sessionId: autoSessionId,
+                cutIndex: autoCutIndex,
+                anchor: autoAnchorMessage,
+                summary: autoPruned.summary,
+                tokensBefore: autoPruned.tokensBefore ?? 0,
+                timestamp: autoPruned.timestamp ?? new Date().toISOString(),
+                keepRecentTokensUsed: autoSettings.keepRecentTokens ?? 0,
+                tailTokensAtFreeze: rawTokensForCurrentMessages(_event.messages.slice(autoCutIndex)),
+            };
+        }
         notifyRequestTimeApplied(ctx, autoPruned, autoRequest);
         return { messages: autoPruned.messages };
     }));

package/dist/memory/tools/read-project-observations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"read-project-observations.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/read-project-observations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;iFAqFtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}
+{"version":3,"file":"read-project-observations.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/read-project-observations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAGhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;iFAwFtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}

package/dist/memory/tools/read-project-observations.js

@@ -5,13 +5,16 @@ export const READ_PROJECT_OBSERVATIONS_TOOL_NAME = "read_project_observations";
 export const readProjectObservationsTool = defineTool({
     name: READ_PROJECT_OBSERVATIONS_TOOL_NAME,
     label: "Search project observations",
-    description: "Search all past observations across ALL sessions in this project. " +
+    description: "Search past observations across sessions in this project, stored per-machine " +
+        "and per-working-directory (cwd). " +
         "Use this when you need to recall project conventions, past decisions, " +
         "file locations, or user preferences before editing or creating files. " +
         "Uses simple substring matching — be specific with your query terms. " +
-        "Returns up to 20 most recent matching observations with relevance tags.",
-    promptSnippet: "Use read_project_observations(<query>) to search past observations across ALL sessions in this project.",
+        "Returns up to 20 most recent matching observations with relevance tags. " +
+        "Results are local to this machine and cwd; they are NOT synced across machines or teams.",
+    promptSnippet: "Use read_project_observations(<query>) to search past observations across sessions in this local project working directory.",
     promptGuidelines: [
+        "Results are per-machine + per-cwd and cross-session; they are NOT shared across machines or teams.",
         "Use read_project_observations before creating new files to find conventions for that file kind.",
         "Use read_project_observations before editing a file to find past context about that file or its directory.",
         "Be specific: search for file paths, technology names, or pattern keywords.",

package/dist/memory/tools/recall-observation.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"recall-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/recall-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,EAGN,KAAK,uBAAuB,EAE5B,MAAM,cAAc,CAAC;AAGtB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvE,eAAO,MAAM,4BAA4B,WAAW,CAAC;AAIrD,KAAK,2BAA2B,GAC7B,IAAI,GACJ,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,oBAAoB,GACpB,eAAe,CAAC;AAEnB,KAAK,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;AAChG,KAAK,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,SAAS,GAAG,0BAA0B,GAAG,QAAQ,CAAC,GAAG;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAExI,MAAM,MAAM,wBAAwB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,6BAA6B,GAAG;IACpC,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,kBAAkB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC3C,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,KAAK,6CAA6C,GAAG;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,4CAA4C,GAAG;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,wBAAwB,EAAE,6BAA6B,EAAE,CAAC;IAC1D,YAAY,EAAE,6BAA6B,EAAE,CAAC;IAC9C,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,iCAAiC,EAAE,6CAA6C,EAAE,CAAC;IACnF,+BAA+B,EAAE,4CAA4C,EAAE,CAAC;IAChF,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAuUF,eAAO,MAAM,qBAAqB;;iFAuChC,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE1D"}
+{"version":3,"file":"recall-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/recall-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAE7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAEhF,OAAO,EAGN,KAAK,uBAAuB,EAE5B,MAAM,cAAc,CAAC;AAItB,OAAO,KAAK,EAAE,iBAAiB,EAAE,gBAAgB,EAAE,MAAM,aAAa,CAAC;AAEvE,eAAO,MAAM,4BAA4B,WAAW,CAAC;AAIrD,KAAK,2BAA2B,GAC7B,IAAI,GACJ,SAAS,GACT,YAAY,GACZ,WAAW,GACX,WAAW,GACX,oBAAoB,GACpB,eAAe,CAAC;AAEnB,KAAK,kBAAkB,GAAG,IAAI,CAAC,iBAAiB,EAAE,IAAI,GAAG,SAAS,GAAG,WAAW,GAAG,WAAW,CAAC,CAAC;AAChG,KAAK,iBAAiB,GAAG,IAAI,CAAC,gBAAgB,EAAE,IAAI,GAAG,SAAS,GAAG,0BAA0B,GAAG,QAAQ,CAAC,GAAG;IAAE,eAAe,EAAE,MAAM,CAAA;CAAE,CAAC;AAExI,MAAM,MAAM,wBAAwB,GAAG;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,MAAM,EAAE,MAAM,CAAC;IACf,SAAS,EAAE,MAAM,CAAC;IAClB,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,KAAK,6BAA6B,GAAG;IACpC,MAAM,EAAE,uBAAuB,CAAC,QAAQ,CAAC,CAAC;IAC1C,kBAAkB,EAAE,MAAM,CAAC;IAC3B,sBAAsB,EAAE,MAAM,CAAC;IAC/B,WAAW,EAAE,kBAAkB,CAAC;IAChC,cAAc,CAAC,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,CAAC,EAAE,wBAAwB,EAAE,CAAC;IAC3C,qBAAqB,CAAC,EAAE,MAAM,EAAE,CAAC;IACjC,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oBAAoB,CAAC,EAAE,MAAM,CAAC;CAC9B,CAAC;AAEF,KAAK,6CAA6C,GAAG;IACpD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,aAAa,EAAE,MAAM,CAAC;CACtB,CAAC;AAEF,KAAK,4CAA4C,GAAG;IACnD,YAAY,EAAE,MAAM,CAAC;IACrB,eAAe,EAAE,MAAM,CAAC;IACxB,MAAM,EAAE,QAAQ,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,4BAA4B,GAAG;IAC1C,MAAM,EAAE,2BAA2B,CAAC;IACpC,QAAQ,EAAE,MAAM,CAAC;IACjB,aAAa,EAAE,MAAM,CAAC;IACtB,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;IACjB,WAAW,EAAE,iBAAiB,EAAE,CAAC;IACjC,wBAAwB,EAAE,6BAA6B,EAAE,CAAC;IAC1D,YAAY,EAAE,6BAA6B,EAAE,CAAC;IAC9C,OAAO,EAAE,6BAA6B,EAAE,CAAC;IACzC,aAAa,EAAE,wBAAwB,EAAE,CAAC;IAC1C,iCAAiC,EAAE,6CAA6C,EAAE,CAAC;IACnF,+BAA+B,EAAE,4CAA4C,EAAE,CAAC;IAChF,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,iBAAiB,EAAE,MAAM,EAAE,CAAC;IAC5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,OAAO,CAAC,EAAE,MAAM,CAAC;CACjB,CAAC;AAuUF,eAAO,MAAM,qBAAqB;;iFAqDhC,CAAC;AAEH,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE1D"}

package/dist/memory/tools/recall-observation.js

@@ -1,6 +1,7 @@
 import { Type } from "../../sdk/ai/index.js";
 import { defineTool } from "../../sdk/coding-agent/index.js";
 import { recallMemorySources, } from "../branch.js";
+import { getProjectObsStore } from "../project-observations-store.js";
 import { renderRecallSourceEntries, renderRecallSourceEntry } from "../serialize.js";
 import { estimateEntryTokens } from "../tokens.js";
 export const RECALL_OBSERVATION_TOOL_NAME = "recall";
@@ -315,7 +316,8 @@ function renderFoundResult(result) {
 export const recallObservationTool = defineTool({
     name: RECALL_OBSERVATION_TOOL_NAME,
     label: "Recall memory evidence",
-    description: "Recover exact evidence and source context behind a compacted observational-memory observation or reflection id on the current branch. " +
+    description: "Recover exact evidence and source context behind a compacted observational-memory observation or reflection id " +
+        "from the current branch or an earlier session in the same working directory. " +
         "Use when compressed memory is important and original source context is needed before acting.",
     promptSnippet: "Use recall(<id>) to recover exact source context behind compacted memory observations/reflections when precision matters.",
     promptGuidelines: [
@@ -340,10 +342,22 @@ export const recallObservationTool = defineTool({
             return textResult(message, emptyDetails("invalid_id", memoryId, message));
         }
         const branchEntries = ctx.sessionManager.getBranch();
-        const result = recallMemorySources(branchEntries, memoryId);
+        let result = recallMemorySources(branchEntries, memoryId);
         if (result.status === "not_found") {
-            const message = `No observation or reflection with id ${memoryId} was found on the current branch.`;
-            return textResult(message, emptyDetails("not_found", memoryId, message));
+            const store = getProjectObsStore();
+            const projectId = store?.getProjectByCwd(ctx.cwd);
+            const archiveEntries = projectId ? store?.getProjectRecallSource?.(projectId, memoryId) : null;
+            if (archiveEntries && archiveEntries.length > 0) {
+                const archivedResult = recallMemorySources(archiveEntries, memoryId);
+                if (archivedResult.status === "found") {
+                    result = archivedResult;
+                }
+            }
+            if (result.status === "not_found") {
+                const message = `No observation or reflection with id ${memoryId} was found on the current branch ` +
+                    `or in this project's cross-session memory.`;
+                return textResult(message, emptyDetails("not_found", memoryId, message));
+            }
         }
         return renderFoundResult(result);
     },

package/dist/memory/tools/receive-agent-observations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"receive-agent-observations.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/receive-agent-observations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIhF,eAAO,MAAM,oCAAoC,+BAA+B,CAAC;AAEjF,MAAM,WAAW,uBAAuB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,aAAa,GAAG,YAAY,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,4BAA4B;;;iFAmEvC,CAAC;AAEH,wBAAgB,oCAAoC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE5E"}
+{"version":3,"file":"receive-agent-observations.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/receive-agent-observations.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIhF,eAAO,MAAM,oCAAoC,+BAA+B,CAAC;AAEjF,MAAM,WAAW,uBAAuB;IACvC,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,SAAS,EAAE,KAAK,GAAG,QAAQ,GAAG,MAAM,GAAG,UAAU,CAAC;IAClD,eAAe,EAAE,MAAM,CAAC;IACxB,UAAU,EAAE,aAAa,GAAG,YAAY,CAAC;IACzC,SAAS,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,4BAA4B;;;iFAqEvC,CAAC;AAEH,wBAAgB,oCAAoC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE5E"}

package/dist/memory/tools/receive-agent-observations.js

@@ -6,10 +6,12 @@ export const RECEIVE_AGENT_OBSERVATIONS_TOOL_NAME = "receive_agent_observations"
 export const receiveAgentObservationsTool = defineTool({
     name: RECEIVE_AGENT_OBSERVATIONS_TOOL_NAME,
     label: "Receive observations from other agents",
-    description: "Poll for observations shared by other active sessions on this project. " +
+    description: "Poll for observations shared by other active sessions on this machine working in the " +
+        "same directory (same-machine, same-cwd; no cross-machine or team relay). " +
         "Call this before starting work or when you suspect another agent has shared context.",
-    promptSnippet: "Use receive_agent_observations() to pull shared observations from other active sessions.",
+    promptSnippet: "Use receive_agent_observations() to pull shared observations from other active sessions on this machine.",
     promptGuidelines: [
+        "Messages are same-machine + same-cwd only; there is no cross-machine or team fan-out.",
         "Call at the start of a session or task to pick up context shared by collaborators.",
         "Deduplicate results by memory_id against observations already in your context.",
     ],

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

@@ -1 +1 @@
-{"version":3,"file":"share-project-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/share-project-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAOhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AA6C/E,eAAO,MAAM,2BAA2B;;iFAqEtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}
+{"version":3,"file":"share-project-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/share-project-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAOhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AA6C/E,eAAO,MAAM,2BAA2B;;iFAuEtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}

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

@@ -40,12 +40,14 @@ function findObservationInStore(store, projectId, memoryId) {
 export const shareProjectObservationTool = defineTool({
     name: SHARE_PROJECT_OBSERVATION_TOOL_NAME,
     label: "Share observation with other agents",
-    description: "Broadcast a project observation or reflection to other active sessions working on this project. " +
+    description: "Share a project observation or reflection with other active sessions on this machine " +
+        "working in the same directory (same-machine, same-cwd broadcast — no cross-machine or team relay). " +
         "Use this when you discover a fact another agent should know immediately, " +
         "rather than waiting for them to search project memory.",
-    promptSnippet: "Use share_project_observation(memory_id) to push a known observation to other active sessions.",
+    promptSnippet: "Use share_project_observation(memory_id) to push a known observation to other active sessions on this machine.",
     promptGuidelines: [
-        "Only share observations that are relevant to collaborators on the same project.",
+        "Delivery is same-machine + same-cwd only; there is no cross-machine or team fan-out.",
+        "Only share observations that are relevant to collaborators in the same local project directory.",
         "Prefer sharing high/critical relevance facts — avoid noise.",
         "The memory_id must be a 12-character lowercase hex id from the current branch or project memory.",
     ],

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

@@ -1 +1 @@
-{"version":3,"file":"write-project-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/write-project-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;;iFA6DtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}
+{"version":3,"file":"write-project-observation.d.ts","sourceRoot":"","sources":["../../../src/memory/tools/write-project-observation.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,uBAAuB,CAAC;AAC7C,OAAO,EAAc,KAAK,YAAY,EAAE,MAAM,iCAAiC,CAAC;AAIhF,eAAO,MAAM,mCAAmC,8BAA8B,CAAC;AAE/E,eAAO,MAAM,2BAA2B;;;iFA2EtC,CAAC;AAEH,wBAAgB,mCAAmC,CAAC,GAAG,EAAE,YAAY,GAAG,IAAI,CAE3E"}