agentfootprint-lens 0.51.0 → 0.52.0

package/README.md

@@ -1018,12 +1018,20 @@ composed them); tools as sent (names, expandable schemas, the forced tool
 marked, `withheld` shown as the library states it). **BASIS** — epoch, call id,
 commit index, model, provider, params (only the dials the receipt carries — an
 absent dial is not rendered as a default), cache (transform, breakpoints
-applied). **FOLD** — `iteration`, `currentSkillId`, `stepPointer`, engagement,
+applied, and since 0.52.0 the **cache strategy** as the receipt names it —
+`*` is the built-in pass-through, printed as itself; the receipt's `null`
+reads *no cache strategy*; a receipt from before agentfootprint 9.93.0 reads
+Not on record). **FOLD** — `iteration`, `currentSkillId`, `stepPointer`, engagement,
 active injections, hidden skill ids, read from the fold at the stop; a row the
 fold could not read is printed there as data (skipped indices, or the fold's
 error), beside a Damaged badge.
-**OMISSIONS** — attention drops from the receipt when present, else the
-library's `UNGAPPED_FIELDS` sentence for the field. **GAPS** — every gap on the
+**OMISSIONS** — the attention drops from the receipt (0.52.0): the count,
+then one line per turn the agent's window evicted for budget — its hash and
+the epoch it was **last served on**, paired by the library's own rule (the
+hash is that earlier receipt's `messages.entries[].hash`), or Not on record
+when no earlier receipt in this recording served it; a receipt that says
+nothing was dropped reads count 0, and a record that cannot say draws the
+badge. **GAPS** — every gap on the
 view: its kind, the fields it covers, its sentence verbatim, and its `cause`
 when the library established one (`receipt-shape-rejected` styled as damage).
 **SINCE PREVIOUS** — messages entered/left, tools added/removed, schemas whose
@@ -1072,7 +1080,8 @@ crossed into the call, one edge per system piece, message, request-only line and
 tool, each carrying its badge and, against the previous epoch, whether it
 *entered*, *left* or is *unchanged* — then **WITHHELD**: held and not sent. The
 withheld band is the reason to build it. The model never learns what it was
-denied; the operator should — the withheld tool list, the attention drops, the
+denied; the operator should — the withheld tool list, each evicted turn as an
+edge into the messages slot with the epoch that last served it (0.52.0), the
 skills a role hid (read from the fold, since a receipt carries no authority
 names), a redacted fold, and every gap the view declares, each with the
 library's own sentence. Same cursor, same row, same badges: a Damaged row draws

package/dist/{Lens-Bw1em67x.d.cts → Lens-CcVUyiCm.d.cts}

@@ -746,8 +746,16 @@ interface LensDetailSlotProps {
      *
      * It holds no position of its own — it is rebuilt every render. Read it;
      * never store it.
+     *
+     * OPTIONAL, and not because it can be missing: `<Lens>` always supplies it.
+     * It is optional because a consumer may CONSTRUCT these props — a test that
+     * renders its own pane, a wrapper type that extends this one — and a new
+     * REQUIRED field would break that consumer's compile on a minor. Measured on
+     * a real app at 0.51.0, whose `BandPaneProps extends LensDetailSlotProps`
+     * stopped compiling. A receiver that wants it without a guard can read it
+     * from `useLensCursor` instead. (0.51.1)
      */
-    readonly cursor: LensCursor;
+    readonly cursor?: LensCursor;
 }
 declare const Lens: React__default.FC<LensProps>;
 

package/dist/{Lens-CDsSUiHJ.d.ts → Lens-CdUkz_qq.d.ts}

@@ -746,8 +746,16 @@ interface LensDetailSlotProps {
      *
      * It holds no position of its own — it is rebuilt every render. Read it;
      * never store it.
+     *
+     * OPTIONAL, and not because it can be missing: `<Lens>` always supplies it.
+     * It is optional because a consumer may CONSTRUCT these props — a test that
+     * renders its own pane, a wrapper type that extends this one — and a new
+     * REQUIRED field would break that consumer's compile on a minor. Measured on
+     * a real app at 0.51.0, whose `BandPaneProps extends LensDetailSlotProps`
+     * stopped compiling. A receiver that wants it without a guard can read it
+     * from `useLensCursor` instead. (0.51.1)
      */
-    readonly cursor: LensCursor;
+    readonly cursor?: LensCursor;
 }
 declare const Lens: React__default.FC<LensProps>;
 

package/dist/{chunk-H63KQNY3.js → chunk-LLKFATWI.js}

@@ -1,7 +1,7 @@
 import {
   formatBytes,
   structureGraphFromRunner
-} from "./chunk-ZZJ2OIQP.js";
+} from "./chunk-VQ2C62UL.js";
 
 // src/core/buildStepGraphFromSnapshot.ts
 function buildStepGraphFromSnapshot(snapshot) {
@@ -1189,4 +1189,4 @@ export {
   decisionSentence,
   isConsentDecision
 };
-//# sourceMappingURL=chunk-H63KQNY3.js.map
+//# sourceMappingURL=chunk-LLKFATWI.js.map

package/dist/{chunk-7QSK7EJW.js → chunk-NPOCJFXS.js}

@@ -29,7 +29,7 @@ import {
   tagStopsStrategy,
   toSidecar,
   verify
-} from "./chunk-ZZJ2OIQP.js";
+} from "./chunk-VQ2C62UL.js";
 import {
   MODE_PALETTES,
   T,
@@ -1780,9 +1780,10 @@ var GRAPH_LABELS = Object.freeze({
   redacted: "redacted",
   gap: "gap",
   toolWithheld: "withheld",
-  count: "count",
-  hashes: "hashes",
-  fold: "fold"
+  fold: "fold",
+  cacheStrategy: "cache strategy",
+  noCacheStrategy: "no cache strategy",
+  lastServedOn: "last served on"
 });
 var WITHHELD_LABELS = Object.freeze({
   "tool-withheld": GRAPH_LABELS.toolWithheld,
@@ -1859,9 +1860,20 @@ function CallCard({ call }) {
           ]
         }
       )
+    ] }),
+    /* @__PURE__ */ jsxs7("div", { style: rowStyle, "data-testid": "graph-call-strategy", children: [
+      /* @__PURE__ */ jsx8("span", { style: mutedStyle, children: GRAPH_LABELS.cacheStrategy }),
+      /* @__PURE__ */ jsx8(CacheStrategy, { value: call.cacheStrategy })
     ] })
   ] });
 }
+function CacheStrategy({ value }) {
+  if (value === void 0) return /* @__PURE__ */ jsx8(Badge, { check: { status: "not-on-record" } });
+  if (value === null) {
+    return /* @__PURE__ */ jsx8("span", { style: mutedStyle, "data-testid": "served-cache-strategy", "data-strategy": "null", children: GRAPH_LABELS.noCacheStrategy });
+  }
+  return /* @__PURE__ */ jsx8("span", { style: monoStyle, "data-testid": "served-cache-strategy", "data-strategy": value, children: value });
+}
 function Band({
   title,
   testId,
@@ -1934,10 +1946,13 @@ function SlotCard({
             "data-kind": node.kind,
             "data-name": node.name,
             "data-slot": slot.slot,
+            "data-hash": node.hash,
+            "data-last-served-on": node.lastServedOn,
             children: [
               /* @__PURE__ */ jsx8(Elbow, {}),
               /* @__PURE__ */ jsx8("span", { style: keyStyle, children: WITHHELD_LABELS[node.kind] }),
-              /* @__PURE__ */ jsx8("span", { style: monoMutedStyle, children: node.name })
+              /* @__PURE__ */ jsx8("span", { style: monoMutedStyle, children: node.name }),
+              node.hash !== void 0 && /* @__PURE__ */ jsx8(EvictedTurnFacts, { node })
             ]
           },
           `${node.kind}:${node.name}:${i}`
@@ -1991,6 +2006,8 @@ function WithheldCard({ node }) {
       "data-name": node.name,
       "data-from": node.from,
       "data-slot": node.slot,
+      "data-hash": node.hash,
+      "data-last-served-on": node.lastServedOn,
       children: [
         /* @__PURE__ */ jsxs7("div", { style: rowStyle, children: [
           /* @__PURE__ */ jsx8("span", { style: keyStyle, children: WITHHELD_LABELS[node.kind] }),
@@ -2002,11 +2019,7 @@ function WithheldCard({ node }) {
           ] }),
           node.status !== void 0 && /* @__PURE__ */ jsx8(Badge, { check: { status: node.status } })
         ] }),
-        node.count !== void 0 && /* @__PURE__ */ jsxs7("div", { style: rowStyle, "data-testid": "graph-withheld-count", children: [
-          /* @__PURE__ */ jsx8("span", { style: keyStyle, children: GRAPH_LABELS.count }),
-          /* @__PURE__ */ jsx8("span", { style: monoStyle, children: node.count }),
-          node.hashes !== void 0 && /* @__PURE__ */ jsx8("span", { style: monoMutedStyle, children: node.hashes.join(" ") })
-        ] }),
+        node.hash !== void 0 && /* @__PURE__ */ jsx8("div", { style: rowStyle, "data-testid": "graph-withheld-turn", children: /* @__PURE__ */ jsx8(EvictedTurnFacts, { node }) }),
         node.cause !== void 0 && /* @__PURE__ */ jsxs7(
           "span",
           {
@@ -2028,6 +2041,17 @@ function WithheldCard({ node }) {
     }
   );
 }
+function EvictedTurnFacts({ node }) {
+  return /* @__PURE__ */ jsxs7(Fragment3, { children: [
+    /* @__PURE__ */ jsx8("span", { style: monoMutedStyle, "data-testid": "graph-evicted-hash", children: node.hash }),
+    /* @__PURE__ */ jsx8("span", { style: mutedStyle, children: GRAPH_LABELS.lastServedOn }),
+    node.lastServedOn !== void 0 ? /* @__PURE__ */ jsxs7("span", { style: chipStyle(T.primary), "data-testid": "graph-evicted-epoch", children: [
+      GRAPH_LABELS.epoch,
+      " ",
+      node.lastServedOn
+    ] }) : /* @__PURE__ */ jsx8(Badge, { check: { status: "not-on-record" } })
+  ] });
+}
 function Elbow() {
   return /* @__PURE__ */ jsx8("span", { "aria-hidden": "true", style: elbowStyle });
 }
@@ -2193,7 +2217,7 @@ function chipStyle(color) {
 
 // src/react/components/ServedTab.tsx
 import React6, { useMemo as useMemo6, useState as useState6 } from "react";
-import { SERVED_GAPS, UNGAPPED_FIELDS } from "agentfootprint";
+import { SERVED_GAPS } from "agentfootprint";
 import { Fragment as Fragment4, jsx as jsx9, jsxs as jsxs8 } from "react/jsx-runtime";
 var LABELS = Object.freeze({
   tab: "Served",
@@ -2246,6 +2270,9 @@ var LABELS = Object.freeze({
   attentionDrops: "attention drops",
   count: "count",
   hashes: "hashes",
+  lastServedOn: GRAPH_LABELS.lastServedOn,
+  cacheStrategy: GRAPH_LABELS.cacheStrategy,
+  noCacheStrategy: GRAPH_LABELS.noCacheStrategy,
   covers: "covers",
   cause: "cause",
   from: "from",
@@ -2278,7 +2305,8 @@ var SECTION_FIELDS = Object.freeze({
   tools: ["tools.names", "tools.schemaHashes", "tools.forced", "tools.withheld"],
   basis: ["basis.model", "basis.provider", "basis.runId", "basis.epoch", "epoch"],
   params: ["params"],
-  cache: ["cache.transform", "cache.transformHash", "cache.markersApplied"]
+  cache: ["cache.transform", "cache.transformHash", "cache.markersApplied", "cache.strategy"],
+  omissions: ["omittedForAttention"]
 });
 function cursorAnchor(props) {
   return {
@@ -2460,7 +2488,9 @@ function ServedTabBody(props) {
               ] }, name);
             }),
             checks.onReceiptOnly.toolNames.length > 0 && /* @__PURE__ */ jsx9(DataLine, { label: `${LABELS.tools} \xB7 ${LABELS.onReceiptOnly}`, children: checks.onReceiptOnly.toolNames.join(", ") }),
-            checks.rebuiltOnly.toolNames.length > 0 && /* @__PURE__ */ jsx9(DataLine, { label: `${LABELS.tools} \xB7 ${LABELS.rebuiltOnly}`, children: checks.rebuiltOnly.toolNames.join(", ") })
+            checks.rebuiltOnly.toolNames.length > 0 && /* @__PURE__ */ jsx9(DataLine, { label: `${LABELS.tools} \xB7 ${LABELS.rebuiltOnly}`, children: checks.rebuiltOnly.toolNames.join(", ") }),
+            checks.onReceiptOnly.schemas.length > 0 && /* @__PURE__ */ jsx9(DataLine, { label: `${LABELS.schema} \xB7 ${LABELS.onReceiptOnly}`, testId: "served-schemas-on-receipt-only", children: /* @__PURE__ */ jsx9("span", { style: monoStyle2, children: checks.onReceiptOnly.schemas.join(", ") }) }),
+            checks.rebuiltOnly.schemas.length > 0 && /* @__PURE__ */ jsx9(DataLine, { label: `${LABELS.schema} \xB7 ${LABELS.rebuiltOnly}`, testId: "served-schemas-rebuilt-only", children: /* @__PURE__ */ jsx9("span", { style: monoStyle2, children: checks.rebuiltOnly.schemas.join(", ") }) })
           ]
         }
       ),
@@ -2485,15 +2515,21 @@ function ServedTabBody(props) {
             " ",
             row.receipt.cache.markersApplied.map((m) => `${m.field}[${m.boundaryIndex}] ${m.ttl}`).join(" \xB7 ")
           ] })
-        ] })
+        ] }),
+        /* @__PURE__ */ jsx9(DataLine, { label: LABELS.cacheStrategy, testId: "served-strategy", children: /* @__PURE__ */ jsx9(CacheStrategy, { value: graph.call.cacheStrategy }) })
       ] }) : /* @__PURE__ */ jsx9(Presence, { label: LABELS.cache }) }),
       /* @__PURE__ */ jsx9(SectionTitle, { children: LABELS.fold }),
       /* @__PURE__ */ jsx9(FoldSection, { fold }),
       /* @__PURE__ */ jsx9(SectionTitle, { children: LABELS.omissions }),
-      /* @__PURE__ */ jsx9(Section, { testId: "served-omissions", title: LABELS.attentionDrops, children: row.receipt?.omittedForAttention !== void 0 ? /* @__PURE__ */ jsxs8(Fragment4, { children: [
-        /* @__PURE__ */ jsx9(DataLine, { label: LABELS.count, children: row.receipt.omittedForAttention.count }),
-        /* @__PURE__ */ jsx9(DataLine, { label: LABELS.hashes, children: /* @__PURE__ */ jsx9("span", { style: monoMutedStyle2, children: row.receipt.omittedForAttention.hashes.join(" ") }) })
-      ] }) : /* @__PURE__ */ jsx9(Library, { "data-testid": "served-omissions-why", children: UNGAPPED_FIELDS.omittedForAttention }) }),
+      /* @__PURE__ */ jsx9(
+        Section,
+        {
+          testId: "served-omissions",
+          title: LABELS.attentionDrops,
+          gaps: gapsCovering(SECTION_FIELDS.omissions),
+          children: /* @__PURE__ */ jsx9(Omissions, { row, status: checks.omittedForAttention })
+        }
+      ),
       /* @__PURE__ */ jsx9(SectionTitle, { children: LABELS.gaps }),
       /* @__PURE__ */ jsx9("div", { "data-testid": "served-gaps", children: view.gaps.map((gap) => /* @__PURE__ */ jsx9(GapCard, { gap }, gap.gap)) }),
       /* @__PURE__ */ jsx9(SectionTitle, { children: LABELS.sincePrevious }),
@@ -2647,6 +2683,35 @@ function GapCard({ gap }) {
     }
   );
 }
+function Omissions({
+  row,
+  status
+}) {
+  if (status === "not-on-record") return /* @__PURE__ */ jsx9(Presence, { label: LABELS.attentionDrops });
+  const drops = row.receipt?.omittedForAttention;
+  return /* @__PURE__ */ jsxs8(Fragment4, { children: [
+    /* @__PURE__ */ jsx9(DataLine, { label: LABELS.count, testId: "served-omissions-count", children: drops?.count ?? 0 }),
+    (row.evictedTurns ?? []).map((turn, i) => /* @__PURE__ */ jsxs8(
+      DataLine,
+      {
+        label: LABELS.hashes,
+        testId: "served-evicted-turn",
+        children: [
+          /* @__PURE__ */ jsx9("span", { style: monoMutedStyle2, "data-testid": "served-evicted-hash", children: turn.hash }),
+          " ",
+          /* @__PURE__ */ jsx9("span", { style: dataLabelStyle, children: LABELS.lastServedOn }),
+          " ",
+          turn.lastServedOn !== void 0 ? /* @__PURE__ */ jsxs8("span", { style: chipStyle2(T.primary), "data-testid": "served-evicted-epoch", children: [
+            LABELS.epoch,
+            " ",
+            turn.lastServedOn
+          ] }) : /* @__PURE__ */ jsx9(Badge, { check: { status: "not-on-record" } })
+        ]
+      },
+      `${turn.hash}:${i}`
+    ))
+  ] });
+}
 function FoldSection({ fold }) {
   return /* @__PURE__ */ jsxs8(Section, { testId: "served-fold", title: LABELS.fold, children: [
     fold.foldError !== void 0 && /* @__PURE__ */ jsxs8(DataLine, { label: LABELS.foldUnavailable, testId: "served-fold-error", children: [
@@ -6108,4 +6173,4 @@ export {
   useBookmarkSidecar,
   Lens
 };
-//# sourceMappingURL=chunk-7QSK7EJW.js.map
+//# sourceMappingURL=chunk-NPOCJFXS.js.map