agentfootprint 9.53.0 → 9.55.0

package/dist/recorders/observability/status/statusTemplates.js

@@ -25,6 +25,10 @@
  *  ────┤   tool   ├────────────────────────────► "Working on `weather`…"
  *      └──────────┘                               (or per-tool override)
  *
+ *      ┌──────────┐  tool_progress, still no tool.end
+ *  ────┤   tool   ├────────────────────────────► "Looking at your screen…"
+ *      └──────────┘  (same state, newer line)     (or the generic report)
+ *
  *      ┌──────────┐  pause.request, no resume yet
  *  ────┤  paused  ├────────────────────────────► "Waiting on you: …"
  *      └──────────┘
@@ -38,9 +42,31 @@
  * (e.g. `tool.weather: 'Looking up the weather…'`) which the renderer
  * prefers over the generic `tool` template. Lets each tool have its
  * own first-person status without per-tool plumbing.
+ *
+ * MID-CALL REPORTS (9.54.0). `ctx.progress(payload)` files
+ * `stream.tool_progress` from inside a still-running tool call. Through
+ * 9.53.0 that event reached the record and stopped there: nothing
+ * projected it onto the surface a person watches, so consumers hand-rolled
+ * a side channel for the live middle of a long call. The `tool` state now
+ * consumes it — same state, newer line — and the DISPLAY CONTRACT is
+ * deliberately narrow, because `payload` is author-defined `unknown`:
+ *
+ *   · a top-level string field named `message` is shown VERBATIM
+ *     (trimmed; cut at {@link PROGRESS_MESSAGE_LIMIT} characters, and the
+ *     cut is always stated). `message` is the word MCP's own progress
+ *     notification uses, so a tool already speaking that protocol needs no
+ *     second vocabulary.
+ *   · anything else — no `message`, a non-string one, an empty one — gets
+ *     the generic line: the tool's name, that it reported, and how many
+ *     times. NEVER a pretty-printed dump of the author's payload: a status
+ *     line is prose, and prose that quotes a JSON blob is the field-dump
+ *     law broken in public.
+ *
+ * The structured payload rides on to the record untouched either way. One
+ * `ctx.progress` call, two honest faces.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.renderStatusLine = exports.selectStatus = exports.defaultStatusTemplates = void 0;
+exports.renderStatusLine = exports.selectStatus = exports.progressMessageOf = exports.PROGRESS_MESSAGE_LIMIT = exports.defaultStatusTemplates = void 0;
 // ── Defaults ───────────────────────────────────────────────────────
 /**
  * Bundled English defaults. Override in the agent config via
@@ -52,15 +78,69 @@ exports.defaultStatusTemplates = {
     streaming: '{{partial}}',
     tool: 'Working on `{{toolName}}`…',
     paused: 'Waiting on you: {{question}}',
+    // Mid-call reports (9.54.0). `tool.progress` mirrors `streaming` — the
+    // template is the author's own sentence and nothing else, because a line
+    // this library wrapped around it would be this library talking over a tool
+    // that already said what it is doing.
+    'tool.progress': '{{progressMessage}}',
+    // …and when it said nothing sayable, the honest line is the fact that it
+    // reported, plus how often. No payload, ever.
+    'tool.progress.generic': '`{{toolName}}` reported progress ({{progressCount}} so far)…',
 };
+/**
+ * How much of a tool author's `message` one status line carries before it is
+ * cut. A status line lives in a chat bubble; past ~120 characters it stops
+ * being a status and starts being a paragraph.
+ *
+ * Truncation is always STATED, never silent — the line says how much it cut,
+ * the same rule the analyst-view humanizer keeps. A message that legitimately
+ * ends in an ellipsis must stay distinguishable from one we shortened.
+ */
+exports.PROGRESS_MESSAGE_LIMIT = 120;
+/**
+ * The tool author's `message`, ready to show — or `null` when this report had
+ * nothing sayable and the generic line should stand instead.
+ *
+ * Deliberately strict, and the strictness is the contract:
+ *
+ *   · the payload must be a plain object with a top-level `message` STRING.
+ *     A bare string payload is not a `message` — `ctx.progress('…')` is a
+ *     valid report, but it is the author's data, not a sentence they asked us
+ *     to show a person. Wrapping it (`ctx.progress({ message: '…' })`) is the
+ *     one-word opt-in, and it keeps a single rule to document.
+ *   · an empty or whitespace-only `message` is not a sentence. It falls to the
+ *     generic line rather than blanking the bubble mid-call.
+ *
+ * Nothing here reads any other field. Guessing at `done`/`total`/`percent`
+ * would put words in the tool's mouth: one tool's `total` is hops, the next
+ * one's is bytes, and a status line that says "3 of 12" about the wrong unit
+ * is worse than one that says nothing.
+ */
+function progressMessageOf(payload) {
+    if (payload === null || typeof payload !== 'object' || Array.isArray(payload))
+        return null;
+    const raw = payload.message;
+    if (typeof raw !== 'string')
+        return null;
+    const text = raw.trim();
+    if (text.length === 0)
+        return null;
+    if (text.length <= exports.PROGRESS_MESSAGE_LIMIT)
+        return text;
+    const cut = text.length - exports.PROGRESS_MESSAGE_LIMIT;
+    return `${text.slice(0, exports.PROGRESS_MESSAGE_LIMIT)}… (+${String(cut)} more)`;
+}
+exports.progressMessageOf = progressMessageOf;
 // ── Selector ───────────────────────────────────────────────────────
 /**
  * Derive the current thinking state from the event log.
  *
  * Single forward walk that tracks "active" state for each domain:
  *   • pause       — set on pause.request, cleared on pause.resume
- *   • tool        — set on tool.start, cleared on matching tool.end
- *                   (matched by `toolCallId` for parallel-tool safety)
+ *   • tool calls  — a call joins the in-flight map on tool.start and leaves
+ *                   it on ITS OWN tool.end (matched by `toolCallId`), so two
+ *                   parallel calls cannot close each other. Each in-flight
+ *                   call also carries its own progress tally (9.54.0).
  *   • llm         — set on llm.start, cleared on llm.end
  *
  * Priority order (highest first):
@@ -68,20 +148,29 @@ exports.defaultStatusTemplates = {
  *   1. ACTIVE PAUSE wins. When the agent is waiting on the human,
  *      that's what the chat should show — not the underlying tool
  *      that triggered the pause.
- *   2. ACTIVE TOOL — the LLM said "use a tool" and the tool is
- *      running. Show "Working on `<toolName>`…".
+ *   2. AN IN-FLIGHT TOOL CALL — the LLM said "use a tool" and the tool is
+ *      running. Show "Working on `<toolName>`…", or, once that call has
+ *      reported, what it reported.
  *   3. ACTIVE LLM — call in flight. Show streaming tokens if any
  *      arrived, otherwise "Thinking…".
  *   4. Otherwise null (bubble hidden).
  *
+ * WHICH CALL THE LINE IS ABOUT, when several run in parallel: the one with
+ * the most recent `tool_progress`, and only if none of them has reported, the
+ * most recently STARTED. A report is the newest evidence of what is actually
+ * happening, and a surface that showed a silent call while a reporting one
+ * had something to say would be choosing the less informative truth. Two
+ * chatty parallel calls therefore alternate on the line, each verbatim, in the
+ * order their reports landed — which is what a person watching them wants.
+ *
  * Pure projection. Forward walk is O(n); a closing event correctly
  * cancels its matching opener so a completed tool.start/tool.end
  * pair leaves the state quiescent.
  */
 function selectStatus(events) {
     let activePause = null;
-    let activeTool = null;
     let activeLlmStartIdx = -1; // -1 = no active LLM call
+    const inFlight = new Map();
     for (let i = 0; i < events.length; i++) {
         const e = events[i];
         switch (e.type) {
@@ -98,10 +187,39 @@ function selectStatus(events) {
                 break;
             case 'agentfootprint.stream.tool_start': {
                 const p = e.payload;
-                activeTool = {
+                // A call with no id still gets a slot — an emitter simpler than this
+                // library's own (a hand-built stream, an older recording) must still
+                // move the bubble. The synthetic key just cannot be correlated.
+                inFlight.set(p.toolCallId ?? `__anon#${String(i)}`, {
                     toolName: p.toolName,
                     ...(p.toolCallId ? { toolCallId: p.toolCallId } : {}),
-                };
+                    startSeq: i,
+                    progressCount: 0,
+                    lastProgressSeq: -1,
+                    lastMessage: null,
+                });
+                break;
+            }
+            case 'agentfootprint.stream.tool_progress': {
+                // 9.54.0 — the live middle of a call. Correlate STRICTLY by id: the
+                // framework stamps it, so a real run always has one. Off the wire it
+                // may be missing, and then the only safe attribution is a sole
+                // in-flight call; with two running, a guess would put one call's words
+                // under the other one's name.
+                const p = e.payload;
+                const key = p.toolCallId !== undefined && inFlight.has(p.toolCallId)
+                    ? p.toolCallId
+                    : p.toolCallId === undefined && inFlight.size === 1
+                        ? [...inFlight.keys()][0]
+                        : undefined;
+                if (key === undefined)
+                    break; // a report for a call that already ended
+                const call = inFlight.get(key);
+                if (call === undefined)
+                    break;
+                call.progressCount += 1;
+                call.lastProgressSeq = i;
+                call.lastMessage = progressMessageOf(p.payload);
                 break;
             }
             case 'agentfootprint.stream.tool_end': {
@@ -109,9 +227,10 @@ function selectStatus(events) {
                 // other. If no toolCallId is present (older event), clear
                 // unconditionally — backward-compat with simpler emitters.
                 const p = e.payload;
-                if (!p.toolCallId || activeTool?.toolCallId === p.toolCallId) {
-                    activeTool = null;
-                }
+                if (p.toolCallId === undefined)
+                    inFlight.clear();
+                else
+                    inFlight.delete(p.toolCallId);
                 break;
             }
             case 'agentfootprint.stream.llm_start':
@@ -132,13 +251,23 @@ function selectStatus(events) {
             },
         };
     }
-    if (activeTool) {
+    const calls = [...inFlight.values()];
+    if (calls.length > 0) {
+        const reported = calls.filter((c) => c.lastProgressSeq >= 0);
+        const focus = reported.length > 0
+            ? reported.reduce((a, b) => (b.lastProgressSeq > a.lastProgressSeq ? b : a))
+            : calls.reduce((a, b) => (b.startSeq > a.startSeq ? b : a));
         return {
             state: 'tool',
-            toolName: activeTool.toolName,
+            toolName: focus.toolName,
             vars: {
-                toolName: activeTool.toolName,
-                ...(activeTool.toolCallId ? { toolCallId: activeTool.toolCallId } : {}),
+                toolName: focus.toolName,
+                ...(focus.toolCallId ? { toolCallId: focus.toolCallId } : {}),
+                // Absent field → absent clause: a call that has not reported carries
+                // no progress vars at all, so the renderer resolves exactly the ladder
+                // it resolved before this feature existed.
+                ...(focus.progressCount > 0 ? { progressCount: String(focus.progressCount) } : {}),
+                ...(focus.lastMessage !== null ? { progressMessage: focus.lastMessage } : {}),
             },
         };
     }
@@ -162,10 +291,22 @@ exports.selectStatus = selectStatus;
 /**
  * Resolve the matched template + substitute vars.
  *
- *   • `state === null`           → null (chat bubble renders nothing)
- *   • `state === 'tool'`         → tries `tool.<toolName>` first, then
- *                                   generic `tool`
- *   • Other states               → looks up the state's name as the key
+ * Each state resolves a LADDER of candidate keys, most specific first, and
+ * takes the first one the merged template map defines:
+ *
+ *   | the state                          | ladder                                                              |
+ *   |------------------------------------|---------------------------------------------------------------------|
+ *   | tool, reported with a `message`    | `tool.<name>.progress` → `tool.progress` → `tool.<name>` → `tool`     |
+ *   | tool, reported without one         | `tool.<name>.progress.generic` → `tool.progress.generic` → `tool.<name>` → `tool` |
+ *   | tool, no report yet                | `tool.<name>` → `tool`                                                |
+ *   | anything else                      | the state's own name                                                  |
+ *
+ * The ladder falls THROUGH to the plain tool keys on purpose. A consumer who
+ * shipped a curated `tool.weather` line and does not want it interrupted
+ * deletes `tool.progress.generic` from their map and keeps it; a consumer who
+ * ships a partial map that predates 9.54.0 keeps rendering exactly what it
+ * rendered before, mid-call reports and all. Nothing here can blank a bubble
+ * that used to have a line in it.
  *
  * Missing template keys return null rather than the empty string —
  * keeps the contract honest (consumer can detect "no template" and
@@ -174,17 +315,30 @@ exports.selectStatus = selectStatus;
 function renderStatusLine(state, ctx, templates = exports.defaultStatusTemplates) {
     if (!state)
         return null;
-    let key = state.state;
-    if (state.state === 'tool' && state.toolName) {
-        const specific = `tool.${state.toolName}`;
-        if (templates[specific] !== undefined)
-            key = specific;
+    let template;
+    for (const key of templateLadder(state)) {
+        template = templates[key];
+        if (template !== undefined)
+            break;
     }
-    const template = templates[key];
     if (template === undefined)
         return null;
     const vars = { appName: ctx.appName, ...state.vars };
     return template.replace(/\{\{(\w+)\}\}/g, (_, name) => vars[name] ?? '');
 }
 exports.renderStatusLine = renderStatusLine;
+/** Candidate template keys for a state, most specific first. */
+function templateLadder(state) {
+    if (state.state !== 'tool')
+        return [state.state];
+    const generic = state.toolName !== undefined ? [`tool.${state.toolName}`, 'tool'] : ['tool'];
+    const perTool = (suffix) => state.toolName !== undefined ? [`tool.${state.toolName}.${suffix}`] : [];
+    if (state.vars.progressMessage !== undefined) {
+        return [...perTool('progress'), 'tool.progress', ...generic];
+    }
+    if (state.vars.progressCount !== undefined) {
+        return [...perTool('progress.generic'), 'tool.progress.generic', ...generic];
+    }
+    return generic;
+}
 //# sourceMappingURL=statusTemplates.js.map

package/dist/recorders/observability/status/statusTemplates.js.map

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

package/dist/types/core/agent/stages/window.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/stages/window.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAGxF,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAEtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC7C,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,8BAA8B;AAC9B,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,GACpB,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CAiKlD"}
+{"version":3,"file":"window.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/stages/window.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6CG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAC9C,OAAO,KAAK,EAAc,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC3E,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AAGxF,OAAO,EAAgB,KAAK,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAGtE,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAG5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAE9C,MAAM,WAAW,eAAe;IAC9B,uCAAuC;IACvC,QAAQ,CAAC,QAAQ,EAAE,cAAc,CAAC;IAClC,6EAA6E;IAC7E,QAAQ,CAAC,KAAK,EAAE,qBAAqB,CAAC;IACtC,4DAA4D;IAC5D,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,6DAA6D;IAC7D,QAAQ,CAAC,YAAY,EAAE,MAAM,CAAC;IAC9B;;;;;OAKG;IACH,QAAQ,CAAC,QAAQ,CAAC,EAAE,MAAM,MAAM,GAAG,SAAS,CAAC;IAC7C,+EAA+E;IAC/E,QAAQ,CAAC,YAAY,CAAC,EAAE,YAAY,CAAC;IACrC,2CAA2C;IAC3C,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAC;IACzC,+CAA+C;IAC/C,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CAC7B;AAED,8BAA8B;AAC9B,wBAAgB,gBAAgB,CAC9B,IAAI,EAAE,eAAe,GACpB,CAAC,KAAK,EAAE,UAAU,CAAC,UAAU,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,CA0KlD"}

package/dist/types/core/agent/window/currentRequest.d.ts

@@ -0,0 +1,71 @@
+/**
+ * window/currentRequest — which message in the window is the thing the run
+ * was asked to do.
+ *
+ * Pattern: One pure function over the window (no scope, no I/O, no clock).
+ * Role:    core/ layer. Feeds the refusal engine, which is what actually
+ *          keeps this message in the window (see turns.ts, `'current-request'`).
+ *          Kept in its own module because "what did the person ask for" is a
+ *          different question from "where is a turn boundary", and only this
+ *          one has to know which user-role messages the LIBRARY wrote.
+ * Emits:   N/A.
+ *
+ * ## Why this exists
+ *
+ * Caught in a real recorded run (9.55.0). A ten-iteration tool loop under a
+ * small window dropped the window's HEAD at iteration 4 — and the head was
+ * the user's own request. The model went on working from tool traffic and a
+ * drop notice, with no statement of its objective anywhere in context. It
+ * finished that task by momentum; a longer one forgets what it was doing.
+ *
+ * Every other guard in this family protects the WIRE (do not split a
+ * `tool_use` from its `tool_result`) or the near past (`keepRecentTurns`).
+ * Nothing protected the one message the whole run is about, because it is the
+ * OLDEST message in the window and every strategy here removes the oldest
+ * thing first. So it is named, and it refuses.
+ *
+ * ## Which message, exactly
+ *
+ * The window is a flat message list. Its `Turn` segmentation is a WIRE
+ * boundary (a non-`tool` message plus the `tool` messages answering it), not
+ * a conversational one — there is no "turn 3 of this conversation" object in
+ * this folder to point at. What the run DOES know is the message it was
+ * started with, which the seed stage commits as `scope.userMessage`, and the
+ * stage passes it in as `said`.
+ *
+ * So the answer is, in order:
+ *
+ *   1. the LAST message the person said whose text is exactly `said` — the
+ *      message this run is executing, matched by content rather than by
+ *      position because a restored conversation puts earlier turns in front
+ *      of it;
+ *   2. failing that, the LAST message the person said at all. That is the
+ *      honest approximation for a window seeded from outside this run, and it
+ *      is stated rather than hidden: earlier turns of a multi-turn
+ *      conversation stay droppable exactly as they were.
+ *
+ * "The person said it" is deliberately narrow. Three kinds of `role: 'user'`
+ * message are written by this LIBRARY, not by anybody: a drop notice, a
+ * compaction frame, and a message an {@link Injection} delivered (which
+ * carries `injectedBy`). None of them may become the anchor — otherwise the
+ * window would protect its own bookkeeping and drop the request underneath
+ * it, and a tool able to influence an injection could pin its own text in
+ * context permanently.
+ */
+import type { LLMMessage } from '../../../adapters/types.js';
+/**
+ * Index in `history` of the current request — the message no window strategy
+ * may drop — or `-1` when this window holds none.
+ *
+ * `-1` is a real answer, not a failure: a hand-built window of assistant
+ * turns, or one whose only user-role messages are this library's own frames,
+ * genuinely has no request to protect. Every caller treats it as "the rule
+ * does not apply here", which is how the pre-9.55.0 behaviour is still
+ * reachable byte for byte.
+ *
+ * @param history the window, in order
+ * @param said    the text the run was started with (`scope.userMessage`),
+ *                when the caller knows it
+ */
+export declare function currentRequestIndexOf(history: readonly LLMMessage[], said?: string): number;
+//# sourceMappingURL=currentRequest.d.ts.map

package/dist/types/core/agent/window/currentRequest.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"currentRequest.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/window/currentRequest.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAqDG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAc7D;;;;;;;;;;;;;GAaG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,EAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAS3F"}

package/dist/types/core/agent/window/notice.d.ts

@@ -20,10 +20,14 @@
  * below is written by this library, which is why a drop has no prompt-
  * injection surface to speak of.
  *
- * It appears ONLY when the removal reaches the window's head. A removal in
- * the middle leaves the original opening turn in place, so there is no wire
- * problem to solve — and splicing a lone `user` message between two assistant
- * turns is its own risk. The ledger names that removal either way.
+ * It appears ONLY when the removal reaches the front of what may leave. That
+ * is the window's head in the ordinary case; since 9.55.0 it is the position
+ * just after the CURRENT REQUEST when the request was sitting at the head and
+ * refused to go (see currentRequest.ts) — the notice is still the first thing
+ * after the last un-droppable message, and it says that the request was kept.
+ * A removal further in leaves the original opening turn in place, so there is
+ * no wire problem to solve — and splicing a lone `user` message between two
+ * assistant turns is its own risk. The ledger names that removal either way.
  *
  * It does not accumulate: the notice is an ordinary oldest turn next time
  * round, so the next drop absorbs it and files a fresh one.
@@ -34,13 +38,24 @@ export declare const DROP_NOTICE_PREFIX = "[dropped history";
 /**
  * Build the message that takes the head position after a drop.
  *
- * `role: 'user'` for the same reason the compaction frame is: it is the head
- * of the window, and the head of the window must be a user turn.
+ * `role: 'user'` for the same reason the compaction frame is: it takes the
+ * head of the window, and the head of the window must be a user turn. (When
+ * the CURRENT REQUEST is holding that position it is already a user turn, and
+ * the notice follows it — see below.)
+ *
+ * `currentRequestKept` (9.55.0) is set when the drop stopped short of the
+ * window's head because the message the run is executing was sitting there
+ * and refused to leave — so the notice takes the position AFTER it rather
+ * than the head itself. It says so, because a model reading "3 earlier
+ * messages were dropped" and then finding a request above it should be told
+ * which of the two facts to trust. Omitted, the notice is byte-identical to
+ * the one this library has always written.
  */
 export declare function buildDropNotice(facts: {
     readonly droppedMessageCount: number;
     readonly iteration: number;
     readonly strategy: string;
+    readonly currentRequestKept?: boolean;
 }): LLMMessage;
 /** True when this message is a notice a previous drop wrote. */
 export declare function isDropNotice(msg: LLMMessage | undefined): boolean;

package/dist/types/core/agent/window/notice.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"notice.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/window/notice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA6BG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAErD;;;;;GAKG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B,GAAG,UAAU,CASb;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAEjE"}
+{"version":3,"file":"notice.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/window/notice.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAiCG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAE7D,8EAA8E;AAC9E,eAAO,MAAM,kBAAkB,qBAAqB,CAAC;AAErD;;;;;;;;;;;;;;;GAeG;AACH,wBAAgB,eAAe,CAAC,KAAK,EAAE;IACrC,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,kBAAkB,CAAC,EAAE,OAAO,CAAC;CACvC,GAAG,UAAU,CAcb;AAED,gEAAgE;AAChE,wBAAgB,YAAY,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAEjE"}

package/dist/types/core/agent/window/strategies/drop.d.ts

@@ -11,12 +11,14 @@
  * A drop makes no LLM call and writes no summary. What it must still do is
  * keep the request valid and keep the record honest:
  *
- *   • the span comes from the shared refusal engine, so an unanswered tool
- *     call, the paused tool, a pending check-in and the recent turns never
- *     leave, and each refusal is named;
- *   • when the span reaches the window's HEAD, an authored notice takes that
- *     position — the window must open on a user turn (see notice.ts), and a
- *     message we are forced to author should tell the truth;
+ *   • the span comes from the shared refusal engine, so the CURRENT REQUEST,
+ *     an unanswered tool call, the paused tool, a pending check-in and the
+ *     recent turns never leave, and each refusal is named;
+ *   • when the span reaches the front of what may leave, an authored notice
+ *     takes that position — the window must open on a user turn (see
+ *     notice.ts), and a message we are forced to author should tell the
+ *     truth. That position is the window's HEAD in the ordinary case, and the
+ *     slot just after the kept request when the request was the head;
  *   • when it does not, nothing is inserted: the original opening turn is
  *     still there, so there is no wire problem to solve.
  */

package/dist/types/core/agent/window/strategies/drop.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"drop.d.ts","sourceRoot":"","sources":["../../../../../../src/core/agent/window/strategies/drop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,uDAAuD;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,EAC1B,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,WAAW,CAyEb"}
+{"version":3,"file":"drop.d.ts","sourceRoot":"","sources":["../../../../../../src/core/agent/window/strategies/drop.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,+BAA+B,CAAC;AAGhE,OAAO,KAAK,EAAE,cAAc,EAAE,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAE1E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD,4DAA4D;AAC5D,MAAM,WAAW,WAAW;IAC1B,+CAA+C;IAC/C,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;IAC5C,uDAAuD;IACvD,QAAQ,CAAC,MAAM,CAAC,EAAE,SAAS,UAAU,EAAE,CAAC;IACxC,QAAQ,CAAC,MAAM,CAAC,EAAE;QAChB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;QAC3B,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;QAC/B,QAAQ,CAAC,YAAY,CAAC,EAAE,MAAM,CAAC;KAChC,CAAC;IACF,QAAQ,CAAC,eAAe,EAAE,SAAS,MAAM,EAAE,CAAC;IAC5C,QAAQ,CAAC,mBAAmB,EAAE,MAAM,CAAC;IACrC,QAAQ,CAAC,SAAS,EAAE,SAAS,cAAc,EAAE,CAAC;IAC9C,QAAQ,CAAC,iBAAiB,EAAE,MAAM,CAAC;IACnC,QAAQ,CAAC,gBAAgB,EAAE,MAAM,CAAC;IAClC,yEAAyE;IACzE,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;CAC7B;AAED;;;;;;;GAOG;AACH,wBAAgB,cAAc,CAC5B,KAAK,EAAE,mBAAmB,EAC1B,eAAe,EAAE,MAAM,EACvB,YAAY,EAAE,MAAM,GACnB,WAAW,CAyFb"}

package/dist/types/core/agent/window/strategy.d.ts

@@ -25,9 +25,12 @@
  *
  *   1. **The refusal rules.** `planRemoval` arrives already bound to this
  *      iteration's turns and guards. A strategy cannot forget that an
- *      unanswered tool call must not leave the window, because it never gets
- *      the chance to decide that for itself — it asks, and it is told, with
- *      every refusal named. That is safety by construction, not by docs.
+ *      unanswered tool call must not leave the window — or that the CURRENT
+ *      REQUEST never does (9.55.0) — because it never gets the chance to
+ *      decide that for itself: it asks, and it is told, with every refusal
+ *      named. That is safety by construction, not by docs. It is also why a
+ *      rule added there arrives in every strategy at once, including the ones
+ *      consumers wrote before the rule existed.
  *   2. **Provenance.** `removalFacts` turns "these indices left" into the
  *      stage ids that wrote them and how long each lived. A strategy cannot
  *      file a removal it cannot name.
@@ -98,9 +101,9 @@ export interface WindowStrategyInput {
      * THE shared refusal engine, bound to this iteration.
      *
      * Answers: which contiguous span of turns may leave, and every turn that
-     * refused, named. Never removes the system envelope, the last
-     * `keepRecentTurns` turns, an unanswered tool call, the paused tool, or a
-     * pending check-in.
+     * refused, named. Never removes the system envelope, the CURRENT REQUEST,
+     * the last `keepRecentTurns` turns, an unanswered tool call, the paused
+     * tool, or a pending check-in.
      *
      * @param keepRecentTurns   how many trailing turns are off-limits
      * @param isExistingSummary optional predicate marking a turn that is a

package/dist/types/core/agent/window/strategy.d.ts.map

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

package/dist/types/core/agent/window/summarize.d.ts

@@ -39,8 +39,12 @@ export declare function renderTranscript(messages: readonly LLMMessage[]): strin
 /**
  * Build the message that replaces the folded span IN THE WINDOW.
  *
- * `role: 'user'` because the folded span always contains message 0 — the
+ * `role: 'user'` because the fold can reach the window's head, and the
  * providers that care (Anthropic) require the window to open on a user turn.
+ * Since 9.55.0 it usually does NOT reach it — the CURRENT REQUEST sits there
+ * and refuses to be folded, so the frame lands immediately after it — but the
+ * role is right either way and a fold of a window with no identifiable
+ * request still opens on one.
  *
  * The label is written by this function and always comes first. `summary` is
  * appended to it verbatim: the library never edits model output, and it never

package/dist/types/core/agent/window/summarize.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/window/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAM3D;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAYzB,CAAC;AAcb,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAExE;AAoBD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;IACL,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC,GACA,UAAU,CAOZ;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAEvE;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,eAAe,CAAC,CAQ1B"}
+{"version":3,"file":"summarize.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/window/summarize.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,WAAW,EAAE,WAAW,EAAE,MAAM,4BAA4B,CAAC;AACvF,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAEtD,6EAA6E;AAC7E,eAAO,MAAM,sBAAsB,uBAAuB,CAAC;AAM3D;;;;GAIG;AACH,eAAO,MAAM,wBAAwB,QAYzB,CAAC;AAcb,mEAAmE;AACnE,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAExE;AAoBD;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,mBAAmB,CACjC,OAAO,EAAE,MAAM,EACf,KAAK,EAAE;IACL,QAAQ,CAAC,kBAAkB,EAAE,MAAM,CAAC;IACpC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,mBAAmB,CAAC;CACtC,GACA,UAAU,CAOZ;AAED,+DAA+D;AAC/D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,UAAU,GAAG,SAAS,GAAG,OAAO,CAEvE;AAED,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC;CACtC;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAsB,aAAa,CACjC,QAAQ,EAAE,WAAW,EACrB,KAAK,EAAE,MAAM,EACb,IAAI,EAAE,SAAS,UAAU,EAAE,EAC3B,MAAM,EAAE,WAAW,GAAG,SAAS,GAC9B,OAAO,CAAC,eAAe,CAAC,CAQ1B"}

package/dist/types/core/agent/window/turns.d.ts

@@ -53,6 +53,17 @@ export declare function segmentTurns(history: readonly LLMMessage[]): readonly T
 export interface RemovalGuards {
     /** Every `toolCallId` answered anywhere in the window. */
     readonly answeredCallIds: ReadonlySet<string>;
+    /**
+     * Index in the window of the CURRENT REQUEST — the message this run is
+     * executing (9.55.0). The turn holding it refuses with `'current-request'`.
+     *
+     * Resolved by `currentRequestIndexOf`, which the stage calls with the run's
+     * own `scope.userMessage`. Absent (or `-1`) when the window holds no
+     * identifiable request, and then this rule simply does not apply — which is
+     * how a window that never had one behaves exactly as it did before the rule
+     * existed.
+     */
+    readonly currentRequestIndex?: number;
     /** The tool call this run is paused on, when it is paused. */
     readonly pausedToolCallId?: string;
     /** True when the pause is a check-in (human consent) rather than askHuman. */

package/dist/types/core/agent/window/turns.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"turns.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/window/turns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,IAAI,EAAE,CAqB5E;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C,8DAA8D;IAC9D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAMnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,GAAG,mBAAmB,GAAG,SAAS,CAkB7F;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,EACrB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAC1C,WAAW,CA8Cb;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAIlE"}
+{"version":3,"file":"turns.d.ts","sourceRoot":"","sources":["../../../../../src/core/agent/window/turns.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AAEH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,4BAA4B,CAAC;AAC7D,OAAO,KAAK,EAAE,aAAa,EAAE,mBAAmB,EAAE,MAAM,YAAY,CAAC;AAErE;;;;GAIG;AACH,MAAM,WAAW,IAAI;IACnB,8CAA8C;IAC9C,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,uDAAuD;IACvD,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,sCAAsC;IACtC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,SAAS,UAAU,EAAE,CAAC;CAC1C;AAED;;;;;;GAMG;AACH,wBAAgB,YAAY,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,SAAS,IAAI,EAAE,CAqB5E;AAED;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,0DAA0D;IAC1D,QAAQ,CAAC,eAAe,EAAE,WAAW,CAAC,MAAM,CAAC,CAAC;IAC9C;;;;;;;;;OASG;IACH,QAAQ,CAAC,mBAAmB,CAAC,EAAE,MAAM,CAAC;IACtC,8DAA8D;IAC9D,QAAQ,CAAC,gBAAgB,CAAC,EAAE,MAAM,CAAC;IACnC,8EAA8E;IAC9E,QAAQ,CAAC,aAAa,CAAC,EAAE,OAAO,CAAC;CAClC;AAED,qEAAqE;AACrE,wBAAgB,eAAe,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,WAAW,CAAC,MAAM,CAAC,CAMnF;AAED;;;;;;;;GAQG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,IAAI,EAAE,MAAM,EAAE,aAAa,GAAG,mBAAmB,GAAG,SAAS,CA0B7F;AAED,oFAAoF;AACpF,MAAM,WAAW,WAAW;IAC1B,oEAAoE;IACpE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,+EAA+E;IAC/E,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,QAAQ,EAAE,SAAS,aAAa,EAAE,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,SAAS,IAAI,EAAE,EACtB,UAAU,EAAE,MAAM,EAClB,MAAM,EAAE,aAAa,EACrB,iBAAiB,CAAC,EAAE,CAAC,IAAI,EAAE,IAAI,KAAK,OAAO,GAC1C,WAAW,CA8Cb;AAED,0EAA0E;AAC1E,wBAAgB,WAAW,CAAC,OAAO,EAAE,SAAS,UAAU,EAAE,GAAG,MAAM,CAIlE"}

package/dist/types/core/agent/window/types.d.ts

@@ -37,6 +37,18 @@ import type { LLMMessage, LLMProvider } from '../../../adapters/types.js';
 export type WindowRefusalReason = 
 /** The turn holds a `role: 'system'` message. The envelope never leaves. */
 'system-envelope'
+/**
+ * The turn holds the CURRENT REQUEST — the message this run is executing
+ * (9.55.0). It is the task's anchor: everything else in the window is
+ * evidence gathered in service of it, and a window that keeps the evidence
+ * and drops the request leaves a model working from momentum.
+ *
+ * It is also the oldest message in a fresh window, which is exactly what
+ * every strategy here removes first — so without this reason it went first,
+ * every time. Other history drops ahead of it; if nothing else can go,
+ * nothing goes, and this reason says why.
+ */
+ | 'current-request'
 /**
  * An assistant `tool_use` in this turn has no matching `tool_result` in the
  * window. Removing an unanswered question destroys the answer's referent —