@mnemonik/shared 7.177.0 → 7.178.0

package/dist/ambientPointer.d.ts

@@ -1,16 +1,57 @@
 export declare const AMBIENT_ID_PREFIX_LENGTH = 8;
 /**
  * What a recalled memory's line carries when memories learned later relate to
- * it (RETRIEVAL_LAYER §2.0.3): how many, and the closest one's id. It follows
- * the line's own `memory_get <id>` pointer and carries no text from the
- * later memory. The one place the wording lives: the renderer and the pattern
- * that finds (and sheds) it are both built from it. Agent-facing wording; it
- * changes only with the owner's approval.
+ * it (RETRIEVAL_LAYER §2.0.3): how many, and a glimpse of the closest one,
+ * the same kind every recall line gives of its own memory: how long after the
+ * recalled memory it was learned, its opening, and its id. It follows the
+ * line's own `memory_get <id>` pointer.
+ *
+ * The glimpse is what lets an agent decide whether the later memory is worth
+ * recalling whole; a bare id gave it nothing to decide by (11 Nov 2026: 6 of
+ * 1,771 were opened). `{which}` is "closest", or "next closest" when the
+ * closest is already in the same reply. `{gap}` and `{glimpse}` are left out
+ * when they are not known, which leaves the marker as it was before the
+ * glimpse existed.
+ *
+ * The one place the wording lives: the renderer and the pattern that finds
+ * (and sheds) the marker are both built from these. A hook runtime built
+ * before a form existed cannot parse it, so the server writes the glimpse
+ * only to a runtime that says it reads it (hookTimeouts.ts HOOK_READS_HEADER).
+ * Agent-facing wording; it changes only with the owner's approval.
+ */
+export declare const RECALL_LATER_MARKER = " \u00B7 you learned {count} related {memories} later; {which}{gap}: {glimpse}memory_get {laterId}";
+/** `{which}`: the later memory named is the closest one. */
+export declare const RECALL_LATER_CLOSEST = "closest";
+/** `{which}`: the closest one is in the same reply, so the next closest is named. */
+export declare const RECALL_LATER_NEXT_CLOSEST = "next closest";
+/** `{gap}`: how long after the recalled memory the later one was learned. */
+export declare const RECALL_LATER_GAP = ", {elapsed} later";
+/** `{glimpse}`: the later memory's opening. */
+export declare const RECALL_LATER_GLIMPSE = "\u201C{what}\u201D ";
+/**
+ * How long after, in words: a plain duration, so no zone and no calendar
+ * words. Null when the later memory was not memorized after the recalled one.
+ */
+export declare function renderLaterElapsed(learnedAfterMs: number | null | undefined): string | null;
+/** What a marker says of the later memory beyond its id. */
+export interface RecallLaterGlimpse {
+    /** The later memory's opening, on one line. */
+    what?: string | null;
+    /** How long after the recalled memory it was memorized, in milliseconds. */
+    learnedAfterMs?: number | null;
+    /** The closest later memory is in the same reply; this is the next closest. */
+    passedOver?: boolean;
+}
+/**
+ * The marker for one recalled memory: `laterCount` later related memories,
+ * `laterId` the one named, with what is known of it.
+ */
+export declare function renderRecallLaterMarker(laterCount: number, laterId: string, glimpse?: RecallLaterGlimpse): string;
+/**
+ * Pattern source of one marker, derived from {@link RECALL_LATER_MARKER} and
+ * its parts; no capture groups. It finds every form the renderer writes,
+ * the one without a gap or a glimpse included.
  */
-export declare const RECALL_LATER_MARKER = " \u00B7 you learned {count} related {memories} later; closest: memory_get {laterId}";
-/** The marker for one recalled memory: `laterCount` later related memories, `laterId` the closest. */
-export declare function renderRecallLaterMarker(laterCount: number, laterId: string): string;
-/** Pattern source of one marker, derived from {@link RECALL_LATER_MARKER}; no capture groups. */
 export declare const RECALL_LATER_MARKER_SOURCE: string;
 /** The text without any later-memory marker: what the line was before one was added. */
 export declare function stripRecallLaterMarkers(text: string): string;
@@ -21,4 +62,14 @@ export declare function stripRecallLaterMarkers(text: string): string;
  */
 export declare const AMBIENT_ITEM_POINTER_SOURCE: string;
 export declare function ambientItemPointerRegex(flags?: string): RegExp;
+/**
+ * The same texts without any later-memory marker that names a memory one of
+ * them carries. A hook assembles one block from several server replies
+ * (ambient recall beside the other recall lines), and only the hook sees the
+ * whole block: a marker pointing at a memory a few lines away tells the agent
+ * nothing, so it goes. A memory is carried by the line whose own pointer names
+ * it, by a JIT line headed with its id, or by being named in `alsoCarried`.
+ * A text with no such marker is returned as the same string.
+ */
+export declare function withoutMarkersNamingCarried(texts: readonly string[], alsoCarried?: readonly string[]): string[];
 //# sourceMappingURL=ambientPointer.d.ts.map

package/dist/ambientPointer.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"ambientPointer.d.ts","sourceRoot":"","sources":["../src/ambientPointer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAY1C;;;;;;;GAOG;AACH,eAAO,MAAM,mBAAmB,wFACuD,CAAC;AAExF,sGAAsG;AACtG,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAInF;AAMD,iGAAiG;AACjG,eAAO,MAAM,0BAA0B,QAGwC,CAAC;AAEhF,wFAAwF;AACxF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,QAEe,CAAC;AAExD,wBAAgB,uBAAuB,CAAC,KAAK,SAAM,GAAG,MAAM,CAE3D"}
+{"version":3,"file":"ambientPointer.d.ts","sourceRoot":"","sources":["../src/ambientPointer.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,IAAI,CAAC;AAY1C;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,mBAAmB,sGACqE,CAAC;AAEtG,4DAA4D;AAC5D,eAAO,MAAM,oBAAoB,YAAY,CAAC;AAE9C,qFAAqF;AACrF,eAAO,MAAM,yBAAyB,iBAAiB,CAAC;AAExD,6EAA6E;AAC7E,eAAO,MAAM,gBAAgB,sBAAsB,CAAC;AAEpD,+CAA+C;AAC/C,eAAO,MAAM,oBAAoB,wBAAwB,CAAC;AAa1D;;;GAGG;AACH,wBAAgB,kBAAkB,CAAC,cAAc,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,GAAG,IAAI,CAgB3F;AAED,4DAA4D;AAC5D,MAAM,WAAW,kBAAkB;IACjC,+CAA+C;IAC/C,IAAI,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACrB,4EAA4E;IAC5E,cAAc,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,+EAA+E;IAC/E,UAAU,CAAC,EAAE,OAAO,CAAC;CACtB;AAQD;;;GAGG;AACH,wBAAgB,uBAAuB,CACrC,UAAU,EAAE,MAAM,EAClB,OAAO,EAAE,MAAM,EACf,OAAO,GAAE,kBAAuB,GAC/B,MAAM,CAYR;AAMD;;;;GAIG;AACH,eAAO,MAAM,0BAA0B,QAewC,CAAC;AAEhF,wFAAwF;AACxF,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAE5D;AAED;;;;GAIG;AACH,eAAO,MAAM,2BAA2B,QAEe,CAAC;AAExD,wBAAgB,uBAAuB,CAAC,KAAK,SAAM,GAAG,MAAM,CAE3D;AAMD;;;;;;;;GAQG;AACH,wBAAgB,2BAA2B,CACzC,KAAK,EAAE,SAAS,MAAM,EAAE,EACxB,WAAW,GAAE,SAAS,MAAM,EAAO,GAClC,MAAM,EAAE,CA4BV"}

package/dist/ambientPointer.js

@@ -9,26 +9,101 @@ const LEGACY_MEMORY_ID_SOURCE = `[0-9A-Za-z_-]{${AMBIENT_ID_PREFIX_LENGTH}}`;
 const FIRST_PERSON_POINTER_LEAD_SOURCE = '(?:to recall it in full:\\s*)?';
 /**
  * What a recalled memory's line carries when memories learned later relate to
- * it (RETRIEVAL_LAYER §2.0.3): how many, and the closest one's id. It follows
- * the line's own `memory_get <id>` pointer and carries no text from the
- * later memory. The one place the wording lives: the renderer and the pattern
- * that finds (and sheds) it are both built from it. Agent-facing wording; it
- * changes only with the owner's approval.
+ * it (RETRIEVAL_LAYER §2.0.3): how many, and a glimpse of the closest one,
+ * the same kind every recall line gives of its own memory: how long after the
+ * recalled memory it was learned, its opening, and its id. It follows the
+ * line's own `memory_get <id>` pointer.
+ *
+ * The glimpse is what lets an agent decide whether the later memory is worth
+ * recalling whole; a bare id gave it nothing to decide by (11 Nov 2026: 6 of
+ * 1,771 were opened). `{which}` is "closest", or "next closest" when the
+ * closest is already in the same reply. `{gap}` and `{glimpse}` are left out
+ * when they are not known, which leaves the marker as it was before the
+ * glimpse existed.
+ *
+ * The one place the wording lives: the renderer and the pattern that finds
+ * (and sheds) the marker are both built from these. A hook runtime built
+ * before a form existed cannot parse it, so the server writes the glimpse
+ * only to a runtime that says it reads it (hookTimeouts.ts HOOK_READS_HEADER).
+ * Agent-facing wording; it changes only with the owner's approval.
  */
-export const RECALL_LATER_MARKER = ' \u00b7 you learned {count} related {memories} later; closest: memory_get {laterId}';
-/** The marker for one recalled memory: `laterCount` later related memories, `laterId` the closest. */
-export function renderRecallLaterMarker(laterCount, laterId) {
-    return RECALL_LATER_MARKER.replace('{count}', String(laterCount))
+export const RECALL_LATER_MARKER = ' \u00b7 you learned {count} related {memories} later; {which}{gap}: {glimpse}memory_get {laterId}';
+/** `{which}`: the later memory named is the closest one. */
+export const RECALL_LATER_CLOSEST = 'closest';
+/** `{which}`: the closest one is in the same reply, so the next closest is named. */
+export const RECALL_LATER_NEXT_CLOSEST = 'next closest';
+/** `{gap}`: how long after the recalled memory the later one was learned. */
+export const RECALL_LATER_GAP = ', {elapsed} later';
+/** `{glimpse}`: the later memory's opening. */
+export const RECALL_LATER_GLIMPSE = '\u201c{what}\u201d ';
+const GLIMPSE_CLOSE = '\u201d';
+const SECOND_MS = 1_000;
+const MINUTE_MS = 60 * SECOND_MS;
+const HOUR_MS = 60 * MINUTE_MS;
+const DAY_MS = 24 * HOUR_MS;
+function elapsedUnits(count, unit) {
+    return `${count} ${unit}${count === 1 ? '' : 's'}`;
+}
+/**
+ * How long after, in words: a plain duration, so no zone and no calendar
+ * words. Null when the later memory was not memorized after the recalled one.
+ */
+export function renderLaterElapsed(learnedAfterMs) {
+    if (typeof learnedAfterMs !== 'number' || !Number.isFinite(learnedAfterMs))
+        return null;
+    if (learnedAfterMs <= 0)
+        return null;
+    if (learnedAfterMs < 90 * SECOND_MS)
+        return 'moments';
+    if (learnedAfterMs < HOUR_MS)
+        return elapsedUnits(Math.round(learnedAfterMs / MINUTE_MS), 'minute');
+    if (learnedAfterMs < 2 * DAY_MS)
+        return elapsedUnits(Math.round(learnedAfterMs / HOUR_MS), 'hour');
+    if (learnedAfterMs < 14 * DAY_MS)
+        return elapsedUnits(Math.round(learnedAfterMs / DAY_MS), 'day');
+    if (learnedAfterMs < 56 * DAY_MS) {
+        return elapsedUnits(Math.round(learnedAfterMs / (7 * DAY_MS)), 'week');
+    }
+    if (learnedAfterMs < 730 * DAY_MS) {
+        return elapsedUnits(Math.round(learnedAfterMs / (30.44 * DAY_MS)), 'month');
+    }
+    return elapsedUnits(Math.round(learnedAfterMs / (365.25 * DAY_MS)), 'year');
+}
+/** The opening as the marker can carry it: one line, and never its own closing quote. */
+function glimpseText(what) {
+    if (typeof what !== 'string')
+        return '';
+    return what.replace(/\s+/gu, ' ').replaceAll(GLIMPSE_CLOSE, '"').trim();
+}
+/**
+ * The marker for one recalled memory: `laterCount` later related memories,
+ * `laterId` the one named, with what is known of it.
+ */
+export function renderRecallLaterMarker(laterCount, laterId, glimpse = {}) {
+    const elapsed = renderLaterElapsed(glimpse.learnedAfterMs);
+    const what = glimpseText(glimpse.what);
+    return (RECALL_LATER_MARKER.replace('{count}', String(laterCount))
         .replace('{memories}', laterCount === 1 ? 'memory' : 'memories')
-        .replace('{laterId}', laterId);
+        .replace('{which}', glimpse.passedOver ? RECALL_LATER_NEXT_CLOSEST : RECALL_LATER_CLOSEST)
+        .replace('{laterId}', laterId)
+        .replace('{gap}', () => (elapsed ? RECALL_LATER_GAP.replace('{elapsed}', elapsed) : ''))
+        // Last, so nothing in the opening is read as a placeholder.
+        .replace('{glimpse}', () => (what ? RECALL_LATER_GLIMPSE.replace('{what}', () => what) : '')));
 }
 function escapeRegExp(text) {
     return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
-/** Pattern source of one marker, derived from {@link RECALL_LATER_MARKER}; no capture groups. */
+/**
+ * Pattern source of one marker, derived from {@link RECALL_LATER_MARKER} and
+ * its parts; no capture groups. It finds every form the renderer writes,
+ * the one without a gap or a glimpse included.
+ */
 export const RECALL_LATER_MARKER_SOURCE = escapeRegExp(RECALL_LATER_MARKER)
     .replace(escapeRegExp('{count}'), '\\d+')
     .replace(escapeRegExp('{memories}'), 'memor(?:y|ies)')
+    .replace(escapeRegExp('{which}'), `(?:${escapeRegExp(RECALL_LATER_NEXT_CLOSEST)}|${escapeRegExp(RECALL_LATER_CLOSEST)})`)
+    .replace(escapeRegExp('{gap}'), `(?:${escapeRegExp(RECALL_LATER_GAP).replace(escapeRegExp('{elapsed}'), '[a-z0-9 ]{1,24}')})?`)
+    .replace(escapeRegExp('{glimpse}'), `(?:${escapeRegExp(RECALL_LATER_GLIMPSE).replace(escapeRegExp('{what}'), `[^${GLIMPSE_CLOSE}\\n]*`)})?`)
     .replace(escapeRegExp('{laterId}'), `${MEMORY_UUID_SOURCE}(?![0-9A-Za-z_-])`);
 /** The text without any later-memory marker: what the line was before one was added. */
 export function stripRecallLaterMarkers(text) {
@@ -44,4 +119,49 @@ export const AMBIENT_ITEM_POINTER_SOURCE = `\\u2014\\s*${FIRST_PERSON_POINTER_LE
 export function ambientItemPointerRegex(flags = 'g') {
     return new RegExp(AMBIENT_ITEM_POINTER_SOURCE, flags);
 }
+const LATER_ID_AT_END = new RegExp(`(${MEMORY_UUID_SOURCE})$`);
+/** A JIT line without a pointer names its memory by the first eight characters of its id. */
+const ID_HEAD_LINE = new RegExp(`^\\[([0-9A-Fa-f]{${AMBIENT_ID_PREFIX_LENGTH}})\\] `, 'gm');
+/**
+ * The same texts without any later-memory marker that names a memory one of
+ * them carries. A hook assembles one block from several server replies
+ * (ambient recall beside the other recall lines), and only the hook sees the
+ * whole block: a marker pointing at a memory a few lines away tells the agent
+ * nothing, so it goes. A memory is carried by the line whose own pointer names
+ * it, by a JIT line headed with its id, or by being named in `alsoCarried`.
+ * A text with no such marker is returned as the same string.
+ */
+export function withoutMarkersNamingCarried(texts, alsoCarried = []) {
+    const marker = new RegExp(RECALL_LATER_MARKER_SOURCE, 'g');
+    if (!texts.some((text) => new RegExp(RECALL_LATER_MARKER_SOURCE).test(text)))
+        return [...texts];
+    const carried = new Set();
+    const heads = new Set();
+    const note = (id) => {
+        const lower = id.toLowerCase();
+        if (lower.length <= AMBIENT_ID_PREFIX_LENGTH)
+            heads.add(lower);
+        else
+            carried.add(lower);
+    };
+    alsoCarried.forEach(note);
+    for (const text of texts) {
+        // Without its markers, so a later memory's own id is not taken for a line's pointer.
+        const plain = stripRecallLaterMarkers(text);
+        for (const match of plain.matchAll(ambientItemPointerRegex('g'))) {
+            if (match[1])
+                note(match[1]);
+        }
+        for (const match of plain.matchAll(ID_HEAD_LINE)) {
+            if (match[1])
+                heads.add(match[1].toLowerCase());
+        }
+    }
+    return texts.map((text) => text.replace(marker, (found) => {
+        const later = LATER_ID_AT_END.exec(found)?.[1]?.toLowerCase();
+        if (!later)
+            return found;
+        return carried.has(later) || heads.has(later.slice(0, AMBIENT_ID_PREFIX_LENGTH)) ? '' : found;
+    }));
+}
 //# sourceMappingURL=ambientPointer.js.map

package/dist/ambientPointer.js.map

@@ -1 +1 @@
-{"version":3,"file":"ambientPointer.js","sourceRoot":"","sources":["../src/ambientPointer.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,CAAC;AAE1C,MAAM,kBAAkB,GAAG,sDAAsD,CAAC;AAClF,MAAM,uBAAuB,GAAG,iBAAiB,wBAAwB,GAAG,CAAC;AAE7E;;;;GAIG;AACH,MAAM,gCAAgC,GAAG,gCAAgC,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAC9B,qFAAqF,CAAC;AAExF,sGAAsG;AACtG,MAAM,UAAU,uBAAuB,CAAC,UAAkB,EAAE,OAAe;IACzE,OAAO,mBAAmB,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,UAAU,CAAC,CAAC;SAC9D,OAAO,CAAC,YAAY,EAAE,UAAU,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC;SAC/D,OAAO,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;AACnC,CAAC;AAED,SAAS,YAAY,CAAC,IAAY;IAChC,OAAO,IAAI,CAAC,OAAO,CAAC,qBAAqB,EAAE,MAAM,CAAC,CAAC;AACrD,CAAC;AAED,iGAAiG;AACjG,MAAM,CAAC,MAAM,0BAA0B,GAAG,YAAY,CAAC,mBAAmB,CAAC;KACxE,OAAO,CAAC,YAAY,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;KACxC,OAAO,CAAC,YAAY,CAAC,YAAY,CAAC,EAAE,gBAAgB,CAAC;KACrD,OAAO,CAAC,YAAY,CAAC,WAAW,CAAC,EAAE,GAAG,kBAAkB,mBAAmB,CAAC,CAAC;AAEhF,wFAAwF;AACxF,MAAM,UAAU,uBAAuB,CAAC,IAAY;IAClD,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,MAAM,CAAC,0BAA0B,EAAE,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC;AACvE,CAAC;AAED;;;;GAIG;AACH,MAAM,CAAC,MAAM,2BAA2B,GACtC,cAAc,gCAAgC,kBAAkB,kBAAkB,IAAI,uBAAuB,GAAG;IAChH,uBAAuB,0BAA0B,IAAI,CAAC;AAExD,MAAM,UAAU,uBAAuB,CAAC,KAAK,GAAG,GAAG;IACjD,OAAO,IAAI,MAAM,CAAC,2BAA2B,EAAE,KAAK,CAAC,CAAC;AACxD,CAAC"}
+{"version":3,"file":"ambientPointer.js","sourceRoot":"","sources":["../src/ambientPointer.ts"],"names":[],"mappings":"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"}

package/dist/contextBudget.d.ts

@@ -30,6 +30,12 @@ export interface BudgetedContextFit {
 }
 /** Measure rendered context in the host's native budget unit. */
 export declare function measureContext(text: string, units?: ContextBudgetUnits): number;
+/**
+ * The items as one block reads them: no later-memory marker names a memory
+ * another item of the same block carries (ambientPointer.ts
+ * withoutMarkersNamingCarried). Items it leaves alone are the same objects.
+ */
+export declare function withoutCarriedMarkers(items: readonly ContextBudgetItem[], alongside?: readonly ContextBudgetItem[]): ContextBudgetItem[];
 /**
  * Compose ordered items within a fixed budget. Full items are emitted exactly;
  * the first item that does not fit and every later item are shed. The first
@@ -37,6 +43,9 @@ export declare function measureContext(text: string, units?: ContextBudgetUnits)
  * share one trailing marker containing only their explicit retrieval routes.
  * Items without a route leave no agent-visible stub.
  *
+ * First, a later-memory marker that names a memory another item carries is
+ * dropped ({@link withoutCarriedMarkers}): the block is where that can be seen.
+ *
  * Before anything is shed, the later-memory markers go (ambientPointer.ts
  * RECALL_LATER_MARKER), the last item's first: a marker never costs a memory
  * its place or any of its text.

package/dist/contextBudget.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"contextBudget.d.ts","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,YAAY,CAAC;AAE7D,eAAO,MAAM,wBAAwB;aACnC,WAAW,EAAE,IAAK;aAClB,KAAK,EAAE,IAAK;aACZ,MAAM,EAAE,IAAK;aACb,IAAI,EAAE,IAAK;aACX,MAAM,EAAE,IAAK;CACL,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0EAA0E;IAC1E,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AA8CD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAiC,GAAG,MAAM,CAE7F;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C,GACA,kBAAkB,CAsGpB;AA4BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,iBAAiB,EAAE,CAMrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClF,MAAM,CAIR;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}
+{"version":3,"file":"contextBudget.d.ts","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAElE,MAAM,MAAM,kBAAkB,GAAG,YAAY,GAAG,YAAY,CAAC;AAE7D,eAAO,MAAM,wBAAwB;aACnC,WAAW,EAAE,IAAK;aAClB,KAAK,EAAE,IAAK;aACZ,MAAM,EAAE,IAAK;aACb,IAAI,EAAE,IAAK;aACX,MAAM,EAAE,IAAK;CACL,CAAC;AAEX,MAAM,WAAW,iBAAiB;IAChC,qDAAqD;IACrD,IAAI,EAAE,MAAM,CAAC;IACb,yFAAyF;IACzF,IAAI,EAAE,MAAM,CAAC;IACb,8EAA8E;IAC9E,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,gFAAgF;IAChF,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IAC9B,+EAA+E;IAC/E,cAAc,CAAC,EAAE,MAAM,CAAC;CACzB;AAED,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,iBAAiB,CAAC;AAE5D,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAC;IACd,mBAAmB,EAAE,MAAM,CAAC;IAC5B,2EAA2E;IAC3E,gBAAgB,EAAE,MAAM,GAAG,IAAI,CAAC;IAChC,0EAA0E;IAC1E,qBAAqB,EAAE,MAAM,CAAC;CAC/B;AA8CD,iEAAiE;AACjE,wBAAgB,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,GAAE,kBAAiC,GAAG,MAAM,CAE7F;AAED;;;;GAIG;AACH,wBAAgB,qBAAqB,CACnC,KAAK,EAAE,SAAS,iBAAiB,EAAE,EACnC,SAAS,GAAE,SAAS,iBAAiB,EAAO,GAC3C,iBAAiB,EAAE,CASrB;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,eAAe,CAC7B,UAAU,EAAE,SAAS,iBAAiB,EAAE,EACxC,IAAI,EAAE;IACJ,MAAM,EAAE,MAAM,CAAC;IACf,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAC3B,cAAc,CAAC,EAAE,SAAS,iBAAiB,EAAE,CAAC;CAC/C,GACA,kBAAkB,CAsGpB;AA4BD;;;;;GAKG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,SAAS,GAAE,SAAS,MAAM,EAAO,GAChC,iBAAiB,EAAE,CAMrB;AAED;;;;;;;;GAQG;AACH,wBAAgB,wBAAwB,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAE9D;AAED;;;;;;GAMG;AACH,wBAAgB,4BAA4B,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAG7E;AAED,+EAA+E;AAC/E,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,EACZ,YAAY,EAAE,MAAM,EACpB,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,KAAK,CAAC,EAAE,kBAAkB,CAAC;IAAC,SAAS,CAAC,EAAE,SAAS,MAAM,EAAE,CAAA;CAAE,GAClF,MAAM,CAIR;AAED,iEAAiE;AACjE,wBAAgB,iBAAiB,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,EAAE,CAExD"}

package/dist/contextBudget.js

@@ -1,4 +1,4 @@
-import { AMBIENT_ITEM_POINTER_SOURCE, stripRecallLaterMarkers } from './ambientPointer.js';
+import { AMBIENT_ITEM_POINTER_SOURCE, stripRecallLaterMarkers, withoutMarkersNamingCarried, } from './ambientPointer.js';
 export { AMBIENT_ITEM_POINTER_SOURCE } from './ambientPointer.js';
 export const REFLEX_NOTE_BUDGET_BYTES = {
     claude_code: 6_000,
@@ -53,6 +53,18 @@ function contextHead(text, budget, units) {
 export function measureContext(text, units = 'characters') {
     return units === 'utf8-bytes' ? Buffer.byteLength(text, 'utf8') : text.length;
 }
+/**
+ * The items as one block reads them: no later-memory marker names a memory
+ * another item of the same block carries (ambientPointer.ts
+ * withoutMarkersNamingCarried). Items it leaves alone are the same objects.
+ */
+export function withoutCarriedMarkers(items, alongside = []) {
+    const texts = withoutMarkersNamingCarried(items.map((item) => item.text), [...items, ...alongside].flatMap((item) => [...itemMemoryIds(item)]));
+    return items.map((item, index) => {
+        const text = texts[index] ?? item.text;
+        return text === item.text ? item : { ...item, text };
+    });
+}
 /**
  * Compose ordered items within a fixed budget. Full items are emitted exactly;
  * the first item that does not fit and every later item are shed. The first
@@ -60,6 +72,9 @@ export function measureContext(text, units = 'characters') {
  * share one trailing marker containing only their explicit retrieval routes.
  * Items without a route leave no agent-visible stub.
  *
+ * First, a later-memory marker that names a memory another item carries is
+ * dropped ({@link withoutCarriedMarkers}): the block is where that can be seen.
+ *
  * Before anything is shed, the later-memory markers go (ambientPointer.ts
  * RECALL_LATER_MARKER), the last item's first: a marker never costs a memory
  * its place or any of its text.
@@ -68,7 +83,7 @@ export function fitContextItems(givenItems, opts) {
     const units = opts.units ?? 'characters';
     const suffix = opts.reservedSuffix ?? [];
     const valueOf = (entries) => [...entries, ...suffix].map((item) => item.text).join(JOINER);
-    const items = [...givenItems];
+    const items = withoutCarriedMarkers(givenItems, suffix);
     for (let index = items.length;; index -= 1) {
         const value = valueOf(items);
         if (measureContext(value, units) <= opts.budget) {

package/dist/contextBudget.js.map

@@ -1 +1 @@
-{"version":3,"file":"contextBudget.js","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,2BAA2B,EAAE,uBAAuB,EAAE,MAAM,qBAAqB,CAAC;AAE3F,OAAO,EAAE,2BAA2B,EAAE,MAAM,qBAAqB,CAAC;AAIlE,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,WAAW,EAAE,KAAK;IAClB,KAAK,EAAE,KAAK;IACZ,MAAM,EAAE,KAAK;IACb,IAAI,EAAE,KAAK;IACX,MAAM,EAAE,KAAK;CACL,CAAC;AA0BX,MAAM,MAAM,GAAG,MAAM,CAAC;AACtB,MAAM,kBAAkB,GAAG,sBAAsB,CAAC;AAElD,SAAS,qBAAqB,CAAC,QAAgB;IAC7C,OAAO,8BAA8B,QAAQ,oBAAoB,CAAC;AACpE,CAAC;AAED,SAAS,aAAa,CAAC,IAAuB;IAC5C,IAAI,IAAI,CAAC,SAAS,IAAI,IAAI,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC,SAAS,CAAC;IACvE,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9C,CAAC;AAED,SAAS,eAAe,CAAC,IAAuB;IAC9C,MAAM,SAAS,GAAG,aAAa,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,SAAS,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,EAAE,EAAE,EAAE,CAAC,cAAc,EAAE,EAAE,CAAC,CAAC;IAC3E,MAAM,KAAK,GAAG,IAAI,CAAC,cAAc,EAAE,OAAO,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;IAC/D,OAAO,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AAC9B,CAAC;AAED,SAAS,iBAAiB,CAAC,KAAmC;IAC5D,MAAM,MAAM,GAAG,CAAC,GAAG,IAAI,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,eAAe,CAAC,CAAC,CAAC,CAAC;IAC5D,IAAI,MAAM,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACrC,OAAO,GAAG,kBAAkB,GAAG,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;AACrD,CAAC;AAED,SAAS,YAAY,CAAC,QAAoC;IACxD,OAAO,QAAQ;SACZ,MAAM,CAAC,CAAC,OAAO,EAAqB,EAAE,CAAC,OAAO,KAAK,IAAI,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC;SAC9E,IAAI,CAAC,MAAM,CAAC,CAAC;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,IAAY,EAAE,MAAc,EAAE,KAAyB;IAC1E,IAAI,MAAM,IAAI,CAAC;QAAE,OAAO,EAAE,CAAC;IAC3B,MAAM,UAAU,GAAa,EAAE,CAAC;IAChC,IAAI,IAAI,GAAG,CAAC,CAAC;IACb,KAAK,MAAM,SAAS,IAAI,IAAI,EAAE,CAAC;QAC7B,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;QAC9C,IAAI,IAAI,GAAG,IAAI,GAAG,MAAM;YAAE,MAAM;QAChC,UAAU,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;QAC3B,IAAI,IAAI,IAAI,CAAC;IACf,CAAC;IACD,OAAO,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAC7B,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,cAAc,CAAC,IAAY,EAAE,KAAK,GAAuB,YAAY;IACnF,OAAO,KAAK,KAAK,YAAY,CAAC,CAAC,CAAC,MAAM,CAAC,UAAU,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;AAChF,CAAC;AAED;;;;;;;;;;GAUG;AACH,MAAM,UAAU,eAAe,CAC7B,UAAwC,EACxC,IAIC;IAED,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,YAAY,CAAC;IACzC,MAAM,MAAM,GAAG,IAAI,CAAC,cAAc,IAAI,EAAE,CAAC;IACzC,MAAM,OAAO,GAAG,CAAC,OAAqC,EAAU,EAAE,CAChE,CAAC,GAAG,OAAO,EAAE,GAAG,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAChE,MAAM,KAAK,GAAG,CAAC,GAAG,UAAU,CAAC,CAAC;IAC9B,KAAK,IAAI,KAAK,GAAG,KAAK,CAAC,MAAM,GAAI,KAAK,IAAI,CAAC,EAAE,CAAC;QAC5C,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,CAAC,CAAC;QAC7B,IAAI,cAAc,CAAC,KAAK,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChD,OAAO;gBACL,KAAK;gBACL,mBAAmB,EAAE,KAAK,CAAC,MAAM;gBACjC,gBAAgB,EAAE,IAAI;gBACtB,qBAAqB,EAAE,CAAC;aACzB,CAAC;QACJ,CAAC;QACD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QAC9B,IAAI,IAAI,KAAK,SAAS;YAAE,MAAM;QAC9B,MAAM,IAAI,GAAG,uBAAuB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QAChD,IAAI,IAAI,KAAK,IAAI,CAAC,IAAI;YAAE,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,IAAI,EAAE,IAAI,EAAE,CAAC;IAC/D,CAAC;IAED,MAAM,QAAQ,GAAa,EAAE,CAAC;IAC9B,KAAK,IAAI,KAAK,GAAG,CAAC,EAAE,KAAK,GAAG,KAAK,CAAC,MAAM,EAAE,KAAK,IAAI,CAAC,EAAE,CAAC;QACrD,MAAM,IAAI,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;QAC1B,IAAI,IAAI,KAAK,SAAS;YAAE,SAAS;QACjC,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;QACrC,MAAM,YAAY,GAAG,YAAY,CAAC;YAChC,GAAG,QAAQ;YACX,IAAI,CAAC,IAAI;YACT,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;YACpC,iBAAiB,CAAC,KAAK,CAAC;SACzB,CAAC,CAAC;QACH,IAAI,cAAc,CAAC,YAAY,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YACvD,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACzB,SAAS;QACX,CAAC;QAED,IAAI,IAAI,CAAC,QAAQ,EAAE,CAAC;YAClB,MAAM,MAAM,GAAG,qBAAqB,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACpD,MAAM,YAAY,GAAG,iBAAiB,CAAC,KAAK,CAAC,CAAC;YAC9C,MAAM,UAAU,GAAG,YAAY,CAAC;gBAC9B,GAAG,QAAQ;gBACX,MAAM;gBACN,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;gBACpC,YAAY;aACb,CAAC,CAAC;YACH,IAAI,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACrD,MAAM,UAAU,GACd,IAAI,CAAC,MAAM,GAAG,cAAc,CAAC,UAAU,EAAE,KAAK,CAAC,GAAG,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;gBAChF,MAAM,IAAI,GAAG,WAAW,CAAC,IAAI,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,CAAC;gBACvD,OAAO;oBACL,KAAK,EACH,IAAI,CAAC,MAAM,GAAG,CAAC;wBACb,CAAC,CAAC,YAAY,CAAC;4BACX,GAAG,QAAQ;4BACX,GAAG,IAAI,KAAK,MAAM,EAAE;4BACpB,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;4BACpC,YAAY;yBACb,CAAC;wBACJ,CAAC,CAAC,UAAU;oBAChB,mBAAmB,EAAE,KAAK;oBAC1B,gBAAgB,EAAE,KAAK;oBACvB,qBAAqB,EAAE,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC;iBACnD,CAAC;YACJ,CAAC;YAED,MAAM,sBAAsB,GAAG,YAAY,CAAC;gBAC1C,GAAG,QAAQ;gBACX,IAAI,CAAC,IAAI;gBACT,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;aACrC,CAAC,CAAC;YACH,IAAI,cAAc,CAAC,sBAAsB,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;gBACjE,OAAO;oBACL,KAAK,EAAE,sBAAsB;oBAC7B,mBAAmB,EAAE,KAAK,GAAG,CAAC;oBAC9B,gBAAgB,EAAE,IAAI;oBACtB,qBAAqB,EAAE,CAAC;iBACzB,CAAC;YACJ,CAAC;QACH,CAAC;QAED,MAAM,cAAc,GAAG,YAAY,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QACzF,MAAM,WAAW,GAAG,YAAY,CAAC;YAC/B,GAAG,QAAQ;YACX,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC;YACpC,iBAAiB,CAAC,KAAK,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC;SACtC,CAAC,CAAC;QACH,OAAO;YACL,KAAK,EAAE,cAAc,CAAC,WAAW,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,cAAc;YACvF,mBAAmB,EAAE,KAAK;YAC1B,gBAAgB,EAAE,IAAI;YACtB,qBAAqB,EAAE,CAAC;SACzB,CAAC;IACJ,CAAC;IAED,OAAO;QACL,KAAK,EAAE,YAAY,CAAC,CAAC,GAAG,QAAQ,EAAE,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC;QACxE,mBAAmB,EAAE,KAAK,CAAC,MAAM;QACjC,gBAAgB,EAAE,IAAI;QACtB,qBAAqB,EAAE,CAAC;KACzB,CAAC;AACJ,CAAC;AAOD,SAAS,iBAAiB,CAAC,IAAY,EAAE,YAAoB;IAC3D,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,2BAA2B,EAAE,GAAG,CAAC,CAAC;IAC3D,MAAM,QAAQ,GAAwB,EAAE,CAAC;IACzC,IAAI,MAAM,GAAG,CAAC,CAAC;IACf,IAAI,KAA6B,CAAC;IAClC,OAAO,CAAC,KAAK,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;QAC3C,MAAM,GAAG,GAAG,KAAK,CAAC,KAAK,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QAC1C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,IAAI,EAAE,CAAC;QAC5C,MAAM,QAAQ,GAAG,KAAK,CAAC,CAAC,CAAC,CAAC;QAC1B,IAAI,IAAI,CAAC,MAAM,GAAG,CAAC,IAAI,QAAQ,KAAK,SAAS,EAAE,CAAC;YAC9C,QAAQ,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxD,CAAC;QACD,MAAM,GAAG,GAAG,CAAC;IACf,CAAC;IACD,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,CAAC;IAC9C,OAAO;QACL,QAAQ;QACR,OAAO,EAAE,WAAW,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,IAAI,EAAE,GAAG,YAAY,UAAU,EAAE,CAAC,CAAC,CAAC,IAAI;KACrF,CAAC;AACJ,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,oBAAoB,CAClC,IAAY,EACZ,YAAoB,EACpB,SAAS,GAAsB,EAAE;IAEjC,MAAM,MAAM,GAAG,iBAAiB,CAAC,IAAI,EAAE,YAAY,CAAC,CAAC;IACrD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACjC,OAAO,CAAC,EAAE,IAAI,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,CAAC,SAAS,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC;IACxF,CAAC;IACD,OAAO,CAAC,GAAG,MAAM,CAAC,QAAQ,EAAE,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;AAC3E,CAAC;AAED;;;;;;;;GAQG;AACH,MAAM,UAAU,wBAAwB,CAAC,IAAY;IACnD,OAAO,+DAA+D,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACpF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,4BAA4B,CAAC,IAAY;IACvD,IAAI,CAAC,wBAAwB,CAAC,IAAI,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,OAAO,uBAAuB,CAAC;AACjC,CAAC;AAED,+EAA+E;AAC/E,MAAM,UAAU,cAAc,CAC5B,IAAY,EACZ,YAAoB,EACpB,IAAmF;IAEnF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,IAAI,YAAY,CAAC;IACzC,IAAI,cAAc,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,IAAI,CAAC,MAAM;QAAE,OAAO,IAAI,CAAC;IAC5D,OAAO,eAAe,CAAC,oBAAoB,CAAC,IAAI,EAAE,YAAY,EAAE,IAAI,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC,CAAC,KAAK,CAAC;AAC/F,CAAC;AAED,iEAAiE;AACjE,MAAM,UAAU,iBAAiB,CAAC,IAAY;IAC5C,OAAO,iBAAiB,CAAC,IAAI,EAAE,gBAAgB,CAAC,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AACrF,CAAC"}
+{"version":3,"file":"contextBudget.js","sourceRoot":"","sources":["../src/contextBudget.ts"],"names":[],"mappings":"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"}

package/dist/hookTimeouts.d.ts

@@ -157,7 +157,26 @@ export declare const HOOK_BUDGET_HEADER = "x-mnemonik-hook-budget-ms";
  * old runtime failing open and recall stopping silently.
  */
 export declare const HOOK_VERSION_HEADER = "x-mnemonik-hook-version";
-/** `init` with the hook-version header added; the caller's headers are kept. */
+/**
+ * What this hook runtime can read of the server's replies, beyond what every
+ * runtime could when the header was introduced. The server writes a newer
+ * form only to a runtime that names it here; a runtime that does not send the
+ * header, or does not name the form, is sent what it was always sent. So a
+ * server may deploy ahead of the hooks that read its newest wording, which is
+ * the order every release ships in.
+ *
+ * - `later-glimpse`: the later-memory marker with the time between and the
+ *   later memory's opening (ambientPointer.ts RECALL_LATER_MARKER).
+ */
+export declare const HOOK_READS_HEADER = "x-mnemonik-hook-reads";
+export declare const HOOK_READS_LATER_GLIMPSE = "later-glimpse";
+export declare const HOOK_READS: readonly string[];
+/** Whether a request's headers say its hook runtime reads `form`. */
+export declare function hookReads(headers: Record<string, unknown> | undefined, form: string): boolean;
+/**
+ * `init` with the hook-version header added, and what the runtime reads
+ * ({@link HOOK_READS_HEADER}); the caller's headers are kept.
+ */
 export declare function withHookVersion<T extends {
     headers?: unknown;
 }>(init: T, runtime: string, version: string): T;

package/dist/hookTimeouts.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"hookTimeouts.d.ts","sourceRoot":"","sources":["../src/hookTimeouts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hookTimeouts.d.ts","sourceRoot":"","sources":["../src/hookTimeouts.ts"],"names":[],"mappings":"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"}

package/dist/hookTimeouts.js

@@ -160,7 +160,35 @@ export const HOOK_BUDGET_HEADER = 'x-mnemonik-hook-budget-ms';
  * old runtime failing open and recall stopping silently.
  */
 export const HOOK_VERSION_HEADER = 'x-mnemonik-hook-version';
-/** `init` with the hook-version header added; the caller's headers are kept. */
+/**
+ * What this hook runtime can read of the server's replies, beyond what every
+ * runtime could when the header was introduced. The server writes a newer
+ * form only to a runtime that names it here; a runtime that does not send the
+ * header, or does not name the form, is sent what it was always sent. So a
+ * server may deploy ahead of the hooks that read its newest wording, which is
+ * the order every release ships in.
+ *
+ * - `later-glimpse`: the later-memory marker with the time between and the
+ *   later memory's opening (ambientPointer.ts RECALL_LATER_MARKER).
+ */
+export const HOOK_READS_HEADER = 'x-mnemonik-hook-reads';
+export const HOOK_READS_LATER_GLIMPSE = 'later-glimpse';
+export const HOOK_READS = [HOOK_READS_LATER_GLIMPSE];
+/** Whether a request's headers say its hook runtime reads `form`. */
+export function hookReads(headers, form) {
+    const raw = headers?.[HOOK_READS_HEADER];
+    const value = Array.isArray(raw) ? raw.join(',') : raw;
+    if (typeof value !== 'string')
+        return false;
+    return value
+        .split(',')
+        .map((part) => part.trim().toLowerCase())
+        .includes(form);
+}
+/**
+ * `init` with the hook-version header added, and what the runtime reads
+ * ({@link HOOK_READS_HEADER}); the caller's headers are kept.
+ */
 export function withHookVersion(init, runtime, version) {
     const raw = init.headers;
     if (raw && typeof raw === 'object' && !(raw instanceof Headers) && !Array.isArray(raw)) {
@@ -172,11 +200,17 @@ export function withHookVersion(init, runtime, version) {
             if (name.toLowerCase() === HOOK_VERSION_HEADER)
                 delete headers[name];
         }
+        for (const name of Object.keys(headers)) {
+            if (name.toLowerCase() === HOOK_READS_HEADER)
+                delete headers[name];
+        }
         headers[HOOK_VERSION_HEADER] = `${runtime}/${version}`;
+        headers[HOOK_READS_HEADER] = HOOK_READS.join(',');
         return { ...init, headers };
     }
     const headers = new Headers(raw);
     headers.set(HOOK_VERSION_HEADER, `${runtime}/${version}`);
+    headers.set(HOOK_READS_HEADER, HOOK_READS.join(','));
     return { ...init, headers: Object.fromEntries(headers.entries()) };
 }
 /**

package/dist/hookTimeouts.js.map

@@ -1 +1 @@
-{"version":3,"file":"hookTimeouts.js","sourceRoot":"","sources":["../src/hookTimeouts.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"hookTimeouts.js","sourceRoot":"","sources":["../src/hookTimeouts.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@mnemonik/shared",
-  "version": "7.177.0",
+  "version": "7.178.0",
   "description": "Shared constants and utilities for Mnemonik packages",
   "repository": {
     "type": "git",

package/src/ambientPointer.ts

@@ -12,30 +12,134 @@ const FIRST_PERSON_POINTER_LEAD_SOURCE = '(?:to recall it in full:\\s*)?';
 
 /**
  * What a recalled memory's line carries when memories learned later relate to
- * it (RETRIEVAL_LAYER §2.0.3): how many, and the closest one's id. It follows
- * the line's own `memory_get <id>` pointer and carries no text from the
- * later memory. The one place the wording lives: the renderer and the pattern
- * that finds (and sheds) it are both built from it. Agent-facing wording; it
- * changes only with the owner's approval.
+ * it (RETRIEVAL_LAYER §2.0.3): how many, and a glimpse of the closest one,
+ * the same kind every recall line gives of its own memory: how long after the
+ * recalled memory it was learned, its opening, and its id. It follows the
+ * line's own `memory_get <id>` pointer.
+ *
+ * The glimpse is what lets an agent decide whether the later memory is worth
+ * recalling whole; a bare id gave it nothing to decide by (11 Nov 2026: 6 of
+ * 1,771 were opened). `{which}` is "closest", or "next closest" when the
+ * closest is already in the same reply. `{gap}` and `{glimpse}` are left out
+ * when they are not known, which leaves the marker as it was before the
+ * glimpse existed.
+ *
+ * The one place the wording lives: the renderer and the pattern that finds
+ * (and sheds) the marker are both built from these. A hook runtime built
+ * before a form existed cannot parse it, so the server writes the glimpse
+ * only to a runtime that says it reads it (hookTimeouts.ts HOOK_READS_HEADER).
+ * Agent-facing wording; it changes only with the owner's approval.
  */
 export const RECALL_LATER_MARKER =
-  ' \u00b7 you learned {count} related {memories} later; closest: memory_get {laterId}';
+  ' \u00b7 you learned {count} related {memories} later; {which}{gap}: {glimpse}memory_get {laterId}';
 
-/** The marker for one recalled memory: `laterCount` later related memories, `laterId` the closest. */
-export function renderRecallLaterMarker(laterCount: number, laterId: string): string {
-  return RECALL_LATER_MARKER.replace('{count}', String(laterCount))
-    .replace('{memories}', laterCount === 1 ? 'memory' : 'memories')
-    .replace('{laterId}', laterId);
+/** `{which}`: the later memory named is the closest one. */
+export const RECALL_LATER_CLOSEST = 'closest';
+
+/** `{which}`: the closest one is in the same reply, so the next closest is named. */
+export const RECALL_LATER_NEXT_CLOSEST = 'next closest';
+
+/** `{gap}`: how long after the recalled memory the later one was learned. */
+export const RECALL_LATER_GAP = ', {elapsed} later';
+
+/** `{glimpse}`: the later memory's opening. */
+export const RECALL_LATER_GLIMPSE = '\u201c{what}\u201d ';
+
+const GLIMPSE_CLOSE = '\u201d';
+
+const SECOND_MS = 1_000;
+const MINUTE_MS = 60 * SECOND_MS;
+const HOUR_MS = 60 * MINUTE_MS;
+const DAY_MS = 24 * HOUR_MS;
+
+function elapsedUnits(count: number, unit: string): string {
+  return `${count} ${unit}${count === 1 ? '' : 's'}`;
+}
+
+/**
+ * How long after, in words: a plain duration, so no zone and no calendar
+ * words. Null when the later memory was not memorized after the recalled one.
+ */
+export function renderLaterElapsed(learnedAfterMs: number | null | undefined): string | null {
+  if (typeof learnedAfterMs !== 'number' || !Number.isFinite(learnedAfterMs)) return null;
+  if (learnedAfterMs <= 0) return null;
+  if (learnedAfterMs < 90 * SECOND_MS) return 'moments';
+  if (learnedAfterMs < HOUR_MS)
+    return elapsedUnits(Math.round(learnedAfterMs / MINUTE_MS), 'minute');
+  if (learnedAfterMs < 2 * DAY_MS)
+    return elapsedUnits(Math.round(learnedAfterMs / HOUR_MS), 'hour');
+  if (learnedAfterMs < 14 * DAY_MS) return elapsedUnits(Math.round(learnedAfterMs / DAY_MS), 'day');
+  if (learnedAfterMs < 56 * DAY_MS) {
+    return elapsedUnits(Math.round(learnedAfterMs / (7 * DAY_MS)), 'week');
+  }
+  if (learnedAfterMs < 730 * DAY_MS) {
+    return elapsedUnits(Math.round(learnedAfterMs / (30.44 * DAY_MS)), 'month');
+  }
+  return elapsedUnits(Math.round(learnedAfterMs / (365.25 * DAY_MS)), 'year');
+}
+
+/** What a marker says of the later memory beyond its id. */
+export interface RecallLaterGlimpse {
+  /** The later memory's opening, on one line. */
+  what?: string | null;
+  /** How long after the recalled memory it was memorized, in milliseconds. */
+  learnedAfterMs?: number | null;
+  /** The closest later memory is in the same reply; this is the next closest. */
+  passedOver?: boolean;
+}
+
+/** The opening as the marker can carry it: one line, and never its own closing quote. */
+function glimpseText(what: string | null | undefined): string {
+  if (typeof what !== 'string') return '';
+  return what.replace(/\s+/gu, ' ').replaceAll(GLIMPSE_CLOSE, '"').trim();
+}
+
+/**
+ * The marker for one recalled memory: `laterCount` later related memories,
+ * `laterId` the one named, with what is known of it.
+ */
+export function renderRecallLaterMarker(
+  laterCount: number,
+  laterId: string,
+  glimpse: RecallLaterGlimpse = {}
+): string {
+  const elapsed = renderLaterElapsed(glimpse.learnedAfterMs);
+  const what = glimpseText(glimpse.what);
+  return (
+    RECALL_LATER_MARKER.replace('{count}', String(laterCount))
+      .replace('{memories}', laterCount === 1 ? 'memory' : 'memories')
+      .replace('{which}', glimpse.passedOver ? RECALL_LATER_NEXT_CLOSEST : RECALL_LATER_CLOSEST)
+      .replace('{laterId}', laterId)
+      .replace('{gap}', () => (elapsed ? RECALL_LATER_GAP.replace('{elapsed}', elapsed) : ''))
+      // Last, so nothing in the opening is read as a placeholder.
+      .replace('{glimpse}', () => (what ? RECALL_LATER_GLIMPSE.replace('{what}', () => what) : ''))
+  );
 }
 
 function escapeRegExp(text: string): string {
   return text.replace(/[.*+?^${}()|[\]\\]/g, '\\$&');
 }
 
-/** Pattern source of one marker, derived from {@link RECALL_LATER_MARKER}; no capture groups. */
+/**
+ * Pattern source of one marker, derived from {@link RECALL_LATER_MARKER} and
+ * its parts; no capture groups. It finds every form the renderer writes,
+ * the one without a gap or a glimpse included.
+ */
 export const RECALL_LATER_MARKER_SOURCE = escapeRegExp(RECALL_LATER_MARKER)
   .replace(escapeRegExp('{count}'), '\\d+')
   .replace(escapeRegExp('{memories}'), 'memor(?:y|ies)')
+  .replace(
+    escapeRegExp('{which}'),
+    `(?:${escapeRegExp(RECALL_LATER_NEXT_CLOSEST)}|${escapeRegExp(RECALL_LATER_CLOSEST)})`
+  )
+  .replace(
+    escapeRegExp('{gap}'),
+    `(?:${escapeRegExp(RECALL_LATER_GAP).replace(escapeRegExp('{elapsed}'), '[a-z0-9 ]{1,24}')})?`
+  )
+  .replace(
+    escapeRegExp('{glimpse}'),
+    `(?:${escapeRegExp(RECALL_LATER_GLIMPSE).replace(escapeRegExp('{what}'), `[^${GLIMPSE_CLOSE}\\n]*`)})?`
+  )
   .replace(escapeRegExp('{laterId}'), `${MEMORY_UUID_SOURCE}(?![0-9A-Za-z_-])`);
 
 /** The text without any later-memory marker: what the line was before one was added. */
@@ -55,3 +159,49 @@ export const AMBIENT_ITEM_POINTER_SOURCE =
 export function ambientItemPointerRegex(flags = 'g'): RegExp {
   return new RegExp(AMBIENT_ITEM_POINTER_SOURCE, flags);
 }
+
+const LATER_ID_AT_END = new RegExp(`(${MEMORY_UUID_SOURCE})$`);
+/** A JIT line without a pointer names its memory by the first eight characters of its id. */
+const ID_HEAD_LINE = new RegExp(`^\\[([0-9A-Fa-f]{${AMBIENT_ID_PREFIX_LENGTH}})\\] `, 'gm');
+
+/**
+ * The same texts without any later-memory marker that names a memory one of
+ * them carries. A hook assembles one block from several server replies
+ * (ambient recall beside the other recall lines), and only the hook sees the
+ * whole block: a marker pointing at a memory a few lines away tells the agent
+ * nothing, so it goes. A memory is carried by the line whose own pointer names
+ * it, by a JIT line headed with its id, or by being named in `alsoCarried`.
+ * A text with no such marker is returned as the same string.
+ */
+export function withoutMarkersNamingCarried(
+  texts: readonly string[],
+  alsoCarried: readonly string[] = []
+): string[] {
+  const marker = new RegExp(RECALL_LATER_MARKER_SOURCE, 'g');
+  if (!texts.some((text) => new RegExp(RECALL_LATER_MARKER_SOURCE).test(text))) return [...texts];
+  const carried = new Set<string>();
+  const heads = new Set<string>();
+  const note = (id: string): void => {
+    const lower = id.toLowerCase();
+    if (lower.length <= AMBIENT_ID_PREFIX_LENGTH) heads.add(lower);
+    else carried.add(lower);
+  };
+  alsoCarried.forEach(note);
+  for (const text of texts) {
+    // Without its markers, so a later memory's own id is not taken for a line's pointer.
+    const plain = stripRecallLaterMarkers(text);
+    for (const match of plain.matchAll(ambientItemPointerRegex('g'))) {
+      if (match[1]) note(match[1]);
+    }
+    for (const match of plain.matchAll(ID_HEAD_LINE)) {
+      if (match[1]) heads.add(match[1].toLowerCase());
+    }
+  }
+  return texts.map((text) =>
+    text.replace(marker, (found: string) => {
+      const later = LATER_ID_AT_END.exec(found)?.[1]?.toLowerCase();
+      if (!later) return found;
+      return carried.has(later) || heads.has(later.slice(0, AMBIENT_ID_PREFIX_LENGTH)) ? '' : found;
+    })
+  );
+}

package/src/contextBudget.ts

@@ -1,4 +1,8 @@
-import { AMBIENT_ITEM_POINTER_SOURCE, stripRecallLaterMarkers } from './ambientPointer.js';
+import {
+  AMBIENT_ITEM_POINTER_SOURCE,
+  stripRecallLaterMarkers,
+  withoutMarkersNamingCarried,
+} from './ambientPointer.js';
 
 export { AMBIENT_ITEM_POINTER_SOURCE } from './ambientPointer.js';
 
@@ -85,6 +89,25 @@ export function measureContext(text: string, units: ContextBudgetUnits = 'charac
   return units === 'utf8-bytes' ? Buffer.byteLength(text, 'utf8') : text.length;
 }
 
+/**
+ * The items as one block reads them: no later-memory marker names a memory
+ * another item of the same block carries (ambientPointer.ts
+ * withoutMarkersNamingCarried). Items it leaves alone are the same objects.
+ */
+export function withoutCarriedMarkers(
+  items: readonly ContextBudgetItem[],
+  alongside: readonly ContextBudgetItem[] = []
+): ContextBudgetItem[] {
+  const texts = withoutMarkersNamingCarried(
+    items.map((item) => item.text),
+    [...items, ...alongside].flatMap((item) => [...itemMemoryIds(item)])
+  );
+  return items.map((item, index) => {
+    const text = texts[index] ?? item.text;
+    return text === item.text ? item : { ...item, text };
+  });
+}
+
 /**
  * Compose ordered items within a fixed budget. Full items are emitted exactly;
  * the first item that does not fit and every later item are shed. The first
@@ -92,6 +115,9 @@ export function measureContext(text: string, units: ContextBudgetUnits = 'charac
  * share one trailing marker containing only their explicit retrieval routes.
  * Items without a route leave no agent-visible stub.
  *
+ * First, a later-memory marker that names a memory another item carries is
+ * dropped ({@link withoutCarriedMarkers}): the block is where that can be seen.
+ *
  * Before anything is shed, the later-memory markers go (ambientPointer.ts
  * RECALL_LATER_MARKER), the last item's first: a marker never costs a memory
  * its place or any of its text.
@@ -108,7 +134,7 @@ export function fitContextItems(
   const suffix = opts.reservedSuffix ?? [];
   const valueOf = (entries: readonly ContextBudgetItem[]): string =>
     [...entries, ...suffix].map((item) => item.text).join(JOINER);
-  const items = [...givenItems];
+  const items = withoutCarriedMarkers(givenItems, suffix);
   for (let index = items.length; ; index -= 1) {
     const value = valueOf(items);
     if (measureContext(value, units) <= opts.budget) {

package/src/hookTimeouts.ts

@@ -179,7 +179,36 @@ export const HOOK_BUDGET_HEADER = 'x-mnemonik-hook-budget-ms';
  */
 export const HOOK_VERSION_HEADER = 'x-mnemonik-hook-version';
 
-/** `init` with the hook-version header added; the caller's headers are kept. */
+/**
+ * What this hook runtime can read of the server's replies, beyond what every
+ * runtime could when the header was introduced. The server writes a newer
+ * form only to a runtime that names it here; a runtime that does not send the
+ * header, or does not name the form, is sent what it was always sent. So a
+ * server may deploy ahead of the hooks that read its newest wording, which is
+ * the order every release ships in.
+ *
+ * - `later-glimpse`: the later-memory marker with the time between and the
+ *   later memory's opening (ambientPointer.ts RECALL_LATER_MARKER).
+ */
+export const HOOK_READS_HEADER = 'x-mnemonik-hook-reads';
+export const HOOK_READS_LATER_GLIMPSE = 'later-glimpse';
+export const HOOK_READS: readonly string[] = [HOOK_READS_LATER_GLIMPSE];
+
+/** Whether a request's headers say its hook runtime reads `form`. */
+export function hookReads(headers: Record<string, unknown> | undefined, form: string): boolean {
+  const raw = headers?.[HOOK_READS_HEADER];
+  const value = Array.isArray(raw) ? raw.join(',') : raw;
+  if (typeof value !== 'string') return false;
+  return value
+    .split(',')
+    .map((part) => part.trim().toLowerCase())
+    .includes(form);
+}
+
+/**
+ * `init` with the hook-version header added, and what the runtime reads
+ * ({@link HOOK_READS_HEADER}); the caller's headers are kept.
+ */
 export function withHookVersion<T extends { headers?: unknown }>(
   init: T,
   runtime: string,
@@ -197,11 +226,16 @@ export function withHookVersion<T extends { headers?: unknown }>(
     for (const name of Object.keys(headers)) {
       if (name.toLowerCase() === HOOK_VERSION_HEADER) delete headers[name];
     }
+    for (const name of Object.keys(headers)) {
+      if (name.toLowerCase() === HOOK_READS_HEADER) delete headers[name];
+    }
     headers[HOOK_VERSION_HEADER] = `${runtime}/${version}`;
+    headers[HOOK_READS_HEADER] = HOOK_READS.join(',');
     return { ...init, headers };
   }
   const headers = new Headers(raw as ConstructorParameters<typeof Headers>[0]);
   headers.set(HOOK_VERSION_HEADER, `${runtime}/${version}`);
+  headers.set(HOOK_READS_HEADER, HOOK_READS.join(','));
   return { ...init, headers: Object.fromEntries(headers.entries()) };
 }