agentfootprint 10.2.0 → 10.3.1

package/dist/esm/lib/semantics/types.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../../src/lib/semantics/types.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AAKH;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,cAAc,CAAC;AA4R/C,mEAAmE;AACnE,MAAM,CAAC,MAAM,cAAc,GAA+B,CAAC,QAAQ,EAAE,WAAW,CAAC,CAAC;AAElF;;;;GAIG;AACH,MAAM,CAAC,MAAM,yBAAyB,GAAsB;IAC1D,KAAK;IACL,OAAO;IACP,OAAO;IACP,YAAY;IACZ,SAAS;IACT,OAAO;CACR,CAAC;AAEF;;;;;GAKG;AACH,MAAM,CAAC,MAAM,cAAc,GACzB,mFAAmF;IACnF,sFAAsF;IACtF,uFAAuF;IACvF,iFAAiF,CAAC"}

package/dist/esm/lib/time-travel/epochs.js

@@ -1,274 +0,0 @@
-/**
- * epochs — where one epoch's committed pieces live, in either chart shape.
- *
- * Role:  Fold. It reads a finished run's recording and answers one question:
- *        "for iteration k, which commit log holds the call, at which index,
- *        and against which fold base?" It executes nothing, records nothing
- *        and stores nothing beside the log.
- * Reads: a recording (`commitLog`, `initialState`, `subflowResults`), through
- *        footprintjs's own id parsers and this folder's `keyedFold.ts`.
- * Emits: N/A.
- *
- * ── WHY THIS FILE EXISTS ───────────────────────────────────────────────────
- * An agent's iteration — an EPOCH — commits to a different place depending on
- * how the chart was built. Under `reactMode: 'dynamic'` the `call-llm` stage is
- * a parent-level stage and its bundle is in the run's own log. Under
- * `'dynamic-grouped'` each turn runs inside an `sf-llm-call` subflow, which has
- * its own isolated runtime and its own log, retained per iteration under
- * `subflowResults['sf-llm-call#k'].treeContext.history`.
- *
- * That fork was written out THREE times — `contextLedger.ts` had a private
- * `llmCallMountKeys`, `trajectory.ts` had a byte-twin of it, and a rebuild of
- * what the model was served would have been the third. Three copies of "which
- * log is this key in?" is three chances to disagree about which iteration a
- * value belonged to, on the one question the whole family exists to answer.
- * So the fork lives here once, and every reader asks it.
- *
- * ── WHAT AN EPOCH NUMBER IS ────────────────────────────────────────────────
- * The committed `iteration` value in effect at the call — the same number
- * `callLLM` put on the receipt's `basis.epoch` and on every `iteration_start`
- * event. It starts at 1. It is READ, not counted: a run that pauses and
- * resumes, or one whose first turn is not its first stage, still names its
- * epochs the way the run itself named them.
- *
- * ── EVERY READ FOLDS FROM THE BASE ─────────────────────────────────────────
- * A location carries the FOLD SOURCE its log was recorded against, not just
- * the log, and every read below goes through `keyedFold.ts`. A resumed run is
- * a fresh executor seeded from `checkpoint.sharedState`, so most of what the
- * call read is base rather than log; a fold that could not see the base
- * answered "absent" for the whole pre-pause world and said nothing about it.
- * `EpochLocation.basis` is that fold's own verdict, carried out to the reader
- * so a recording that travelled without its base declares a gap instead of a
- * confident empty view.
- */
-import { parseRuntimeStageId, splitStageId } from 'foottrace';
-import { STAGE_IDS, SUBFLOW_IDS } from '../../conventions.js';
-import { keyedFold } from './keyedFold.js';
-/**
- * A snapshot from whatever the caller had: a runner (`Agent`, `LLMCall`), or
- * the snapshot itself. Duck-typed on purpose — a recording read back from JSON
- * is a plain object and must work exactly like a live one.
- */
-export function recordingOf(source) {
-    const runner = source;
-    const accessor = runner?.getLastSnapshot ?? runner?.getSnapshot;
-    if (typeof accessor === 'function') {
-        return accessor.call(source);
-    }
-    return source;
-}
-/**
- * The `sf-llm-call` mount keys in `subflowResults`, in loop order.
- *
- * Non-empty ⇒ the run is GROUPED and every turn's pieces are in its own inner
- * log. Empty ⇒ flat, and the run's own log holds everything.
- *
- * @example
- * ```ts
- * llmCallMountKeys(snapshot.subflowResults); // ['sf-llm-call#4', 'sf-llm-call#9']
- * ```
- */
-export function llmCallMountKeys(subflowResults) {
-    if (!subflowResults)
-        return [];
-    return Object.keys(subflowResults)
-        .filter((k) => k.includes('#') && splitStageId(k.split('#')[0]).localStageId === SUBFLOW_IDS.LLM_CALL)
-        .sort((a, b) => parseRuntimeStageId(a).executionIndex - parseRuntimeStageId(b).executionIndex);
-}
-/**
- * One `sf-llm-call` mount's own subtree — its log AND the base that log folds
- * against. The subtree, not the array, because the whole point of a location
- * is that a read lands on the base as well as the diffs.
- */
-function innerSubtreeOf(subflowResults, key) {
-    const entry = subflowResults[key];
-    const tree = entry?.treeContext;
-    return tree !== null && typeof tree === 'object' && Array.isArray(tree.history)
-        ? tree
-        : undefined;
-}
-/**
- * The FIRST commit of the `call-llm` stage in a log, or `-1`.
- *
- * First, not last, for the reason `commitStops` anchors there: one stage
- * execution can flush more than one bundle under one `runtimeStageId`, and the
- * call's own reads happened at the first.
- */
-function callIndexIn(log) {
-    for (let i = 0; i < log.length; i++) {
-        const stageId = log[i]?.stageId;
-        if (stageId && splitStageId(stageId).localStageId === STAGE_IDS.CALL_LLM)
-            return i;
-    }
-    return -1;
-}
-/** Located epochs, memoized on the recording object. */
-const LOCATIONS = new WeakMap();
-/**
- * Every epoch in a recording, in run order — the ONE owner of the flat /
- * grouped fork.
- *
- * Returns `[]` for a recording with no LLM call in it at all (an empty log, a
- * chart with no `call-llm` stage). That is a different fact from "the epoch you
- * asked for is not here", which is what {@link epochAt} says with `undefined`.
- *
- * MEMOIZED on the recording object, because the cost of locating epochs is a
- * pass over the log and a per-epoch reader asks for one epoch at a time: before
- * this, scrubbing a 600-turn run epoch by epoch relocated every epoch on every
- * call and took 20.8 s. Holding the snapshot and asking it repeatedly is the
- * shape a reader's UI actually has, so the memo is keyed on exactly that
- * object; a caller that hands in a runner and gets a fresh snapshot each time
- * pays the pass each time, which is the cost of asking a different question.
- *
- * FROZEN, because it is memoized: the array and each location on it are the
- * very objects the next caller gets, so an edit here would be an edit to
- * everybody's answer. The same law `keyedFold.ts` · `freezeDeep` states for a
- * folded value. What is NOT frozen is what a location POINTS AT — `log`,
- * `source`, `runSource` are the caller's own recording, and this file does not
- * get to lock down an object it was merely handed.
- *
- * @example
- * ```ts
- * import { epochLocations } from 'agentfootprint';
- *
- * epochLocations(agent.getSnapshot()!).map((e) => [e.epoch, e.callRuntimeStageId]);
- * // dynamic:         [[1, 'call-llm#12'], [2, 'call-llm#31']]
- * // dynamic-grouped: [[1, 'sf-llm-call/call-llm#9'], [2, 'sf-llm-call/call-llm#28']]
- * ```
- */
-export function epochLocations(source) {
-    const recording = recordingOf(source);
-    if (recording !== null && typeof recording === 'object') {
-        const memo = LOCATIONS.get(recording);
-        if (memo !== undefined)
-            return memo;
-    }
-    const located = Object.freeze(locate(recording).map((e) => Object.freeze(e)));
-    if (recording !== null && typeof recording === 'object')
-        LOCATIONS.set(recording, located);
-    return located;
-}
-/** The uncached pass — one walk of the log, one keyed fold per source. */
-function locate(recording) {
-    const runLog = (recording?.commitLog ?? []);
-    const runSource = recording ?? {};
-    const runFold = keyedFold(runSource);
-    const hasRunLog = runLog.length > 0;
-    const subflowResults = recording?.subflowResults;
-    const mounts = llmCallMountKeys(subflowResults);
-    if (mounts.length > 0 && subflowResults) {
-        const found = [];
-        for (const [ordinal, key] of mounts.entries()) {
-            const inner = innerSubtreeOf(subflowResults, key);
-            const log = (inner?.history ?? []);
-            const callIdx = callIndexIn(log);
-            if (inner === undefined || callIdx < 0)
-                continue;
-            const fold = keyedFold(inner);
-            const iteration = fold.valueAt('iteration', callIdx);
-            found.push({
-                epoch: typeof iteration === 'number' && Number.isFinite(iteration) ? iteration : ordinal + 1,
-                callRuntimeStageId: log[callIdx].runtimeStageId,
-                log,
-                callIdx,
-                runLog,
-                subflowScope: key,
-                source: inner,
-                runSource,
-                basis: fold.basis,
-                runBasis: runFold.basis,
-                hasRunLog,
-            });
-        }
-        return found;
-    }
-    // FLAT: every `call-llm` bundle in the run's own log, at its first commit.
-    const found = [];
-    const seen = new Set();
-    for (let i = 0; i < runLog.length; i++) {
-        const bundle = runLog[i];
-        if (splitStageId(bundle.stageId).localStageId !== STAGE_IDS.CALL_LLM)
-            continue;
-        if (seen.has(bundle.runtimeStageId))
-            continue;
-        seen.add(bundle.runtimeStageId);
-        const iteration = runFold.valueAt('iteration', i);
-        found.push({
-            epoch: typeof iteration === 'number' && Number.isFinite(iteration) ? iteration : found.length + 1,
-            callRuntimeStageId: bundle.runtimeStageId,
-            log: runLog,
-            callIdx: i,
-            runLog,
-            source: runSource,
-            runSource,
-            basis: runFold.basis,
-            runBasis: runFold.basis,
-            hasRunLog,
-        });
-    }
-    return found;
-}
-/**
- * One epoch by number, or `undefined` when the run has no such iteration.
- *
- * @example
- * ```ts
- * epochAt(agent.getSnapshot()!, 2)?.callRuntimeStageId; // 'call-llm#31'
- * ```
- */
-export function epochAt(source, epoch) {
-    return epochLocations(source).find((e) => e.epoch === epoch);
-}
-/**
- * The value of `key` as the epoch's call READ it — folded to just BEFORE the
- * call's own bundle, so a key the call itself writes back (`history` gains the
- * assistant turn; `receipt` is minted) reads as it was on the way in.
- *
- * Folded from the run's base, not from the log alone: on a resumed run the
- * call read values the log never wrote, and reading those as absent is the
- * fiction `keyedFold.ts` exists to end. A call that is its log's FIRST commit
- * (a grouped turn, or the first stage after a resume) therefore folds to the
- * base rather than to nothing.
- *
- * @example
- * ```ts
- * const epoch = epochAt(snapshot, 1)!;
- * (readAtCall(epoch, 'history') as unknown[]).length; // the turns that went out
- * ```
- */
-export function readAtCall(location, key) {
-    if (location.callIdx < 0)
-        return undefined;
-    return keyedFold(location.source).valueAt(key, location.callIdx - 1);
-}
-/**
- * The value of `key` the epoch's call itself COMMITTED — folded through the
- * call's own bundle. The receipt is read this way, and only the receipt: it is
- * the one value the call writes that describes the call.
- */
-export function readAfterCall(location, key) {
-    if (location.callIdx < 0)
-        return undefined;
-    return keyedFold(location.source).valueAt(key, location.callIdx);
-}
-/**
- * A RUN CONSTANT: a build-time fact `seed` put on the record once, read from
- * the run's own log.
- *
- * It is read from the run log rather than the epoch's log because that is where
- * `seed` runs in both chart shapes. Under `'dynamic-grouped'` the turn's inner
- * log only ever holds what the boundary's `inputMapper` carried in, and a
- * constant nobody inside the turn reads is not carried — so asking the inner
- * log would answer "absent" for a fact the run plainly recorded.
- *
- * `undefined` has TWO causes and a caller must not blur them: the run never
- * recorded this constant, or this recording carries no run log to read
- * (`EpochLocation.hasRunLog` is `false` — a subtree handed in on its own).
- * `servedView.ts` branches on that flag and declares a gap for the second.
- */
-export function readRunConstant(location, key) {
-    if (!location.hasRunLog)
-        return undefined;
-    return keyedFold(location.runSource).valueAt(key, location.runLog.length - 1);
-}
-//# sourceMappingURL=epochs.js.map

package/dist/esm/lib/time-travel/epochs.js.map

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

package/dist/esm/lib/time-travel/index.d.ts

@@ -1,14 +0,0 @@
-/**
- * time-travel/ — the agent's stops on a reader's cursor, and what the model
- * was handed at each of them.
- *
- * Role: Fold. See README.md for what a milestone stop is, what a receipt and a
- * served view are, and how one strategy and one epoch owner serve both chart
- * shapes.
- */
-export { milestoneOf, milestoneStops, milestoneStopsStrategy } from './milestoneStops.js';
-export { epochAt, epochLocations, llmCallMountKeys, readAfterCall, readAtCall, readRunConstant, recordingOf, type EpochLocation, type RecordingLike, } from './epochs.js';
-export { keyedFold, type FoldBasis, type FoldSourceLike, type KeyedFold } from './keyedFold.js';
-export { buildReceipt, messageDigestInput, toolDigestInput, receiptHash, stableJson, transformHashOf, TRANSFORM_HASH_PREFIX, FORCED_OUTPUT_TOOL_KEY, RECEIPT_BOUNDARY, RECEIPT_HASH_CHARS, RECEIPT_KEY, UNSERIALIZABLE, type Receipt, type ReceiptAttentionOmission, type ReceiptCacheMarker, type ReceiptMessage, type ReceiptParams, type ReceiptPiece, type ReceiptRequestOnlyMessage, type RequestMeasurement, type RequestJsonSize, type StoredReceipt, } from './receipt.js';
-export { sha256Hex } from './sha256.js';
-export { receiptAt, servedAt, servedViews, SERVED_GAPS, UNGAPPED_FIELDS, type ServedGap, type ServedGapCause, type ServedGapKind, type ServedPiece, type ServedRequestOnly, type ServedView, } from './servedView.js';

package/dist/esm/lib/time-travel/index.js

@@ -1,15 +0,0 @@
-/**
- * time-travel/ — the agent's stops on a reader's cursor, and what the model
- * was handed at each of them.
- *
- * Role: Fold. See README.md for what a milestone stop is, what a receipt and a
- * served view are, and how one strategy and one epoch owner serve both chart
- * shapes.
- */
-export { milestoneOf, milestoneStops, milestoneStopsStrategy } from './milestoneStops.js';
-export { epochAt, epochLocations, llmCallMountKeys, readAfterCall, readAtCall, readRunConstant, recordingOf, } from './epochs.js';
-export { keyedFold } from './keyedFold.js';
-export { buildReceipt, messageDigestInput, toolDigestInput, receiptHash, stableJson, transformHashOf, TRANSFORM_HASH_PREFIX, FORCED_OUTPUT_TOOL_KEY, RECEIPT_BOUNDARY, RECEIPT_HASH_CHARS, RECEIPT_KEY, UNSERIALIZABLE, } from './receipt.js';
-export { sha256Hex } from './sha256.js';
-export { receiptAt, servedAt, servedViews, SERVED_GAPS, UNGAPPED_FIELDS, } from './servedView.js';
-//# sourceMappingURL=index.js.map

package/dist/esm/lib/time-travel/index.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/lib/time-travel/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,WAAW,EAAE,cAAc,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAC1F,OAAO,EACL,OAAO,EACP,cAAc,EACd,gBAAgB,EAChB,aAAa,EACb,UAAU,EACV,eAAe,EACf,WAAW,GAGZ,MAAM,aAAa,CAAC;AACrB,OAAO,EAAE,SAAS,EAAuD,MAAM,gBAAgB,CAAC;AAChG,OAAO,EACL,YAAY,EACZ,kBAAkB,EAClB,eAAe,EACf,WAAW,EACX,UAAU,EACV,eAAe,EACf,qBAAqB,EACrB,sBAAsB,EACtB,gBAAgB,EAChB,kBAAkB,EAClB,WAAW,EACX,cAAc,GAWf,MAAM,cAAc,CAAC;AACtB,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AACxC,OAAO,EACL,SAAS,EACT,QAAQ,EACR,WAAW,EACX,WAAW,EACX,eAAe,GAOhB,MAAM,iBAAiB,CAAC"}

package/dist/esm/lib/time-travel/keyedFold.js.map

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

package/dist/esm/lib/time-travel/milestoneStops.d.ts

@@ -1,149 +0,0 @@
-/**
- * milestoneStops — the agent's own scrub stops, derived from its commit log.
- *
- * Role:  Fold. It reads a finished run's commit log and answers one question —
- *        "which positions in this run is a reader allowed to stop at?" It
- *        executes nothing, records nothing, and stores nothing beside the log.
- * Reads: a recorded commit log (plus the execution tree when the caller has
- *        it), and `conventions.ts` · `milestoneFor` for the domain vocabulary.
- * Emits: N/A.
- *
- * WHY THIS FILE EXISTS. footprintjs ships the reader's cursor (`timeTravel`)
- * and one stop grammar — `commitStops`, one stop per executed stage — because
- * that is the only grammar the substrate itself knows. It does NOT know what an
- * LLM turn is. agentfootprint does: `milestoneFor` has classified a local stage
- * id into an iteration / slot / llm-turn / tool-call / decision since 9.x, and
- * until 9.87 every consumer that wanted a milestone slider mapped that
- * classifier onto commits by hand. This is that mapping, once, on the strategy
- * seam the port opened — so the agent SUPPLIES the stops for its own runs and
- * every reader gets the same axis.
- *
- * WHAT IT IS (9.89.0). A FILTER over the port's own axis. footprintjs 9.18
- * shipped `filterStops(stops, keep)` — the bookend guard, the re-partition and
- * a `meta` slot on the stop — because two consumers had each re-derived all
- * three by hand against 9.17, this file among them. The hand-rolled copies are
- * gone: the one owner of the `[start, …stages, end]` contract is the library
- * that returns it, and this strategy is one expression over it. The axis is
- * byte-for-byte the 9.88.0 axis (`test/lib/time-travel/milestone-stops-equivalence.test.ts` pins
- * that against a verbatim copy of the 9.88.0 implementation); what is new is that the milestone now RIDES on the
- * stop as `meta`, and that a start which absorbed pre-milestone stages says so
- * with `prologue: true`.
- *
- * WHAT IT IS NOT. Not a second cursor. A strategy only says where the one
- * cursor may rest; `timeTravel` still owns the position, the folds and the
- * marks. And not a re-walk: a milestone that was never committed gets no stop,
- * because a cursor that stops where no evidence exists is telling a story
- * rather than reading one.
- */
-import type { StageSnapshot } from 'footprintjs/advanced';
-import type { CommitBundle, Stop, TimeTravelStrategy } from 'foottrace';
-import { type Milestone } from '../../conventions.js';
-/**
- * The milestone a stop stands for, or `null` when it stands for none (the
- * `'start'` / `'end'` bookends).
- *
- * A stop that {@link milestoneStops} made carries its milestone as
- * `stop.meta`, and that is what is read — the classification the strategy
- * made when it put the stop on the axis, not a second run of the classifier.
- * A stop from ANOTHER strategy — the port's own `commitStops`, or a consumer's
- * filter that kept the stop without a milestone meta — has none, so the answer
- * falls back to where it always came from: `milestoneFor` over the stop's
- * `runtimeStageId`. Same classifier, same answer; a `meta` of some other
- * vocabulary is not mistaken for ours.
- *
- * @example
- * ```ts
- * const stop = cursor.at()!;
- * milestoneOf(stop)?.kind;   // 'llm-turn'
- * ```
- */
-export declare function milestoneOf(stop: Stop<unknown>): Milestone | null;
-/**
- * Derive one stop per committed MILESTONE from a recorded commit log.
- *
- * The rule, in one sentence: take footprintjs's own per-stage axis, keep the
- * stages `milestoneFor` classifies, and give the survivors the log back.
- *
- * **Composed, never re-derived.** The hard parts of the per-stage axis are
- * already solved upstream and are not repeated here: one stop per
- * `runtimeStageId` at its FIRST commit (a subflow mount commits twice, a
- * parallel fork child commits twice and siblings interleave — every repeat is
- * an empty bundle), the authoritative mount set read off the execution tree,
- * the `'start'` / `'end'` bookends, and the id-less leading commit that carries
- * a subflow's `inputMapper` seed. And since 9.89.0 the COMPOSITION itself is
- * the port's too: `filterStops` checks the `[start, …stages, end]` shape,
- * keeps what `keep` keeps, and re-partitions the log. A second implementation
- * of any of that would be a second chance to disagree with the library about
- * what a stage is.
- *
- * **The survivors re-partition the log.** A stage that classifies `null` is not
- * a stop, but its commits still happened, so they are folded into the stop that
- * PRECEDES them: every kept stop's `lastCommitIdx` is extended to just before
- * the next kept stop begins. Nothing is orphaned, and `stateAt(stop)` remains
- * exactly "the state that existed when the next milestone's stage started".
- * Commits before the FIRST milestone belong to `'start'` for the same reason —
- * so on a drilled cursor `'start'` reads as "what this subflow began with,
- * after its plumbing ran".
- *
- * **What that costs `'start'`, and the flag that says so.** On footprintjs's
- * own axis `'start'` is the fold base: the state before ANY stage ran. Here it
- * absorbs every stage that ran before the first milestone, so `stateAt(start)`
- * is the state the first milestone READ, not the run's raw base — a real agent
- * seeds a couple of dozen keys in `seed` before anything a reader would scrub
- * to. That is the right answer for this axis (the stops must still partition
- * the log), and since 9.18 the port marks it: the returned start carries
- * `prologue: true` whenever it absorbed a stage, so a renderer that means
- * "before anything ran" checks `kind === 'start' && !prologue` instead of
- * assuming it from the kind.
- *
- * **The milestone rides on the stop.** Every kept stop carries its
- * classification as `meta` — `Stop<Milestone>` — so a reader asks
- * `stop.meta?.kind` (or {@link milestoneOf}, which reads the same slot) rather
- * than re-running the classifier over the id. The bookends carry none.
- *
- * **A log with no milestones in it at all.** A non-empty log the classifier
- * recognises nothing in — a non-agent chart handed this strategy — yields the
- * two bookends and nothing between them: `'start'` folds the whole log,
- * `'end'` folds the whole log, and `jumpTo` any stage id refuses with
- * `reason: 'miss'`. An axis with nowhere meaningful to stand, which is the
- * truthful shape for a run that has no milestones — not an error, and not the
- * empty `[]` that says the log itself was empty.
- *
- * **It does not know which log it was given.** The classifier reads the LOCAL
- * segment of a stage id, so `sf-llm-call#3` on a run's outer log and
- * `sf-llm-call/call-llm#7` on that mount's drilled inner history are both
- * classified without the strategy being told which one it is holding. That is
- * what lets one strategy serve `reactMode: 'dynamic'` (the `call-llm` bundle is
- * in the outer log → an llm-turn stop on the outer cursor) and
- * `'dynamic-grouped'` (the outer log holds `sf-llm-call` mounts → iteration
- * stops; `drill()` gives the inner cursor, where the same strategy finds the
- * llm-turn, tool-call and decision stops).
- *
- * @param commitLog     the run's `commitLog`, or a subflow's own `history`.
- * @param executionTree the run's `executionTree`, when the caller has it — it
- *   is what makes a mount stop say `kind: 'mount'` rather than being guessed
- *   from bundle shape.
- *
- * @example
- * ```ts
- * import { timeTravel } from 'foottrace';
- * import { milestoneStopsStrategy } from 'agentfootprint';
- *
- * const cursor = timeTravel(agent.getSnapshot()!, { strategy: milestoneStopsStrategy });
- * cursor.stops.map((s) => [s.label, s.meta?.kind]);
- * // measured on a two-turn `dynamic` run — 42 commits, 15 stops:
- * // [['Run start', undefined], ['Iteration', 'iteration'],
- * //  ['System prompt', 'slot'], ['Messages', 'slot'], ['Tools', 'slot'],
- * //  ['LLM turn', 'llm-turn'], ['Route', 'decision'], ['Tool call', 'tool-call'],
- * //  … the second turn …, ['Run end', undefined]]
- * cursor.stops[0].prologue; // true — `seed` and the plumbing ran before the first Iteration
- * ```
- */
-export declare function milestoneStops(commitLog: readonly CommitBundle[], executionTree?: StageSnapshot): Stop<Milestone>[];
-/**
- * `milestoneStops` as a footprintjs `TimeTravelStrategy` — what you hand
- * `timeTravel(snapshot, { strategy })`. Typed over {@link Milestone}, so the
- * cursor's stops are `Stop<Milestone>` and `cursor.at()?.meta?.kind` is typed;
- * it is still assignable wherever a bare `TimeTravelStrategy` is expected.
- */
-export declare const milestoneStopsStrategy: TimeTravelStrategy<Milestone>;