footprintjs 9.48.2 → 10.0.0

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

@@ -1,72 +0,0 @@
-/**
- * tagStops — the stops a chart DECLARED, read back off its commit log.
- *
- * WHY THIS FILE EXISTS. `commitStops` is the only stop grammar the substrate
- * knows: one stop per executed stage. Every richer axis — milestones, turns,
- * tool calls — was a consumer's classifier over `runtimeStageId`: a switch
- * that parses `#` and `/`, lives outside the recording, and goes stale when
- * a stage is renamed. Since 9.21.0 the author can put NAMES on a stage at
- * build time (`FlowChartBuilder.tag` / `options.tags`) and the engine stamps
- * them on the stage's commit bundle (`CommitBundle.tags`). This strategy
- * reads them back: a stored recording from ANY chart scrubs by its own
- * milestones, with no id conventions in the reader.
- *
- * WHAT IT IS. One expression over `filterStops(commitStops(...))`: keep the
- * stops whose FIRST bundle carries a tag (any of the asked-for ones, or any
- * tag at all when none are asked for), give the survivors the log back, and
- * carry the bundle's whole tag array as `Stop.meta`. Everything a filtering
- * axis owes — the bookend guard, the re-partition so a dropped stage's
- * commits fold into the tagged stop BEFORE them, `prologue` on a start that
- * absorbed stages — comes from `filterStops`, stated once, in `axis.ts`.
- *
- * WHAT IT IS NOT. Not a second vocabulary: the strings are the consumer's,
- * carried verbatim. Not a derivation: a stage with no declared tag gets no
- * stop here, however recognisable its id — a reader that wants ids classified
- * writes that keep rule itself (`filterStops`), or reads the fold
- * (`stateAt`) and keeps by what changed. And not a re-walk: only a tag the
- * engine actually stamped can put a stop on this axis.
- */
-import type { TimeTravelStrategy } from './types.js';
-/**
- * A {@link TimeTravelStrategy} whose stops are the stages that carry a
- * declared tag.
- *
- * **Keep rule: any-of.** A stop survives when its bundle's `tags` shares at
- * least one name with `tags`; with `tags` omitted (or empty), every tagged
- * stop survives. All-of, or a rule over more than the tags, is a
- * `filterStops` call away — the library owns no vocabulary, so it owns no
- * richer rule either.
- *
- * **Attribution by precedence.** An untagged stage's commits fold into the
- * tagged stop BEFORE it (what `filterStops` does); the commits before the
- * first tagged stage are absorbed by `'start'`, which then says
- * `prologue: true`. A run with no tagged stage yields the two bookends only.
- *
- * **`meta` is the array.** Each kept stop carries its bundle's full `tags`
- * (not just the ones asked for), so a reader that filtered on
- * `'milestone:llm-turn'` can still see the stage was also `'audit'`.
- *
- * **The equivalence law.** `stateAt(stop)` at every kept stop equals
- * `commitStops`'s fold at the same commit index — a filtering axis moves the
- * stops, never the log.
- *
- * @example
- * ```typescript
- * import { flowChart } from 'footprintjs';
- * import { tagStops, timeTravel } from 'footprintjs/trace';
- *
- * const chart = flowChart<State>('Seed', seedFn, 'seed')
- *   .addFunction('Call model', callFn, 'call-llm')
- *   .tag('milestone:llm-turn')
- *   .addFunction('Route', routeFn, 'route')
- *   .tag('milestone:decision')
- *   .build();
- *
- * // …run it, keep the snapshot…
- * const cursor = timeTravel(snapshot, { strategy: tagStops(['milestone:llm-turn']) });
- * cursor.stops.map((s) => s.label);   // ['Run start', 'Call model', 'Run end']
- * cursor.stops[1].meta;               // ['milestone:llm-turn']
- * cursor.stops[0].prologue;           // true — 'seed' ran before the first turn
- * ```
- */
-export declare function tagStops(tags?: readonly string[]): TimeTravelStrategy<readonly string[]>;

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

@@ -1,102 +0,0 @@
-/**
- * tagStops — the stops a chart DECLARED, read back off its commit log.
- *
- * WHY THIS FILE EXISTS. `commitStops` is the only stop grammar the substrate
- * knows: one stop per executed stage. Every richer axis — milestones, turns,
- * tool calls — was a consumer's classifier over `runtimeStageId`: a switch
- * that parses `#` and `/`, lives outside the recording, and goes stale when
- * a stage is renamed. Since 9.21.0 the author can put NAMES on a stage at
- * build time (`FlowChartBuilder.tag` / `options.tags`) and the engine stamps
- * them on the stage's commit bundle (`CommitBundle.tags`). This strategy
- * reads them back: a stored recording from ANY chart scrubs by its own
- * milestones, with no id conventions in the reader.
- *
- * WHAT IT IS. One expression over `filterStops(commitStops(...))`: keep the
- * stops whose FIRST bundle carries a tag (any of the asked-for ones, or any
- * tag at all when none are asked for), give the survivors the log back, and
- * carry the bundle's whole tag array as `Stop.meta`. Everything a filtering
- * axis owes — the bookend guard, the re-partition so a dropped stage's
- * commits fold into the tagged stop BEFORE them, `prologue` on a start that
- * absorbed stages — comes from `filterStops`, stated once, in `axis.ts`.
- *
- * WHAT IT IS NOT. Not a second vocabulary: the strings are the consumer's,
- * carried verbatim. Not a derivation: a stage with no declared tag gets no
- * stop here, however recognisable its id — a reader that wants ids classified
- * writes that keep rule itself (`filterStops`), or reads the fold
- * (`stateAt`) and keeps by what changed. And not a re-walk: only a tag the
- * engine actually stamped can put a stop on this axis.
- */
-import { filterStops } from './axis.js';
-import { commitStops } from './commitStops.js';
-/**
- * The tags a stop's first bundle carries, or `undefined` when it carries
- * none. Reads the bundle at `stop.commitIdx` — the FIRST commit of the
- * stage, which is where `StageContext.commit` records the stamp (a fork
- * child's repeat and a mount's exit — the bundles with a `phase` — carry
- * none).
- */
-function tagsAt(log, stop) {
-    const raw = log[stop.commitIdx]?.tags;
-    // A stored row is `unknown[]`-shaped until narrowed: keep only the strings,
-    // so a damaged row can never put a non-name into `Stop.meta`.
-    const tags = Array.isArray(raw) ? raw.filter((t) => typeof t === 'string') : [];
-    return tags.length > 0 ? tags : undefined;
-}
-/**
- * A {@link TimeTravelStrategy} whose stops are the stages that carry a
- * declared tag.
- *
- * **Keep rule: any-of.** A stop survives when its bundle's `tags` shares at
- * least one name with `tags`; with `tags` omitted (or empty), every tagged
- * stop survives. All-of, or a rule over more than the tags, is a
- * `filterStops` call away — the library owns no vocabulary, so it owns no
- * richer rule either.
- *
- * **Attribution by precedence.** An untagged stage's commits fold into the
- * tagged stop BEFORE it (what `filterStops` does); the commits before the
- * first tagged stage are absorbed by `'start'`, which then says
- * `prologue: true`. A run with no tagged stage yields the two bookends only.
- *
- * **`meta` is the array.** Each kept stop carries its bundle's full `tags`
- * (not just the ones asked for), so a reader that filtered on
- * `'milestone:llm-turn'` can still see the stage was also `'audit'`.
- *
- * **The equivalence law.** `stateAt(stop)` at every kept stop equals
- * `commitStops`'s fold at the same commit index — a filtering axis moves the
- * stops, never the log.
- *
- * @example
- * ```typescript
- * import { flowChart } from 'footprintjs';
- * import { tagStops, timeTravel } from 'footprintjs/trace';
- *
- * const chart = flowChart<State>('Seed', seedFn, 'seed')
- *   .addFunction('Call model', callFn, 'call-llm')
- *   .tag('milestone:llm-turn')
- *   .addFunction('Route', routeFn, 'route')
- *   .tag('milestone:decision')
- *   .build();
- *
- * // …run it, keep the snapshot…
- * const cursor = timeTravel(snapshot, { strategy: tagStops(['milestone:llm-turn']) });
- * cursor.stops.map((s) => s.label);   // ['Run start', 'Call model', 'Run end']
- * cursor.stops[1].meta;               // ['milestone:llm-turn']
- * cursor.stops[0].prologue;           // true — 'seed' ran before the first turn
- * ```
- */
-export function tagStops(tags) {
-    const wanted = tags && tags.length > 0 ? new Set(tags) : undefined;
-    return {
-        stopsFor(commitLog, executionTree, subflowResults) {
-            return filterStops(commitStops(commitLog, executionTree, subflowResults), (stop) => {
-                const stamped = tagsAt(commitLog, stop);
-                if (!stamped)
-                    return null;
-                if (wanted && !stamped.some((tag) => wanted.has(tag)))
-                    return null;
-                return { meta: stamped };
-            });
-        },
-    };
-}
-//# sourceMappingURL=data:application/json;base64,eyJ2ZXJzaW9uIjozLCJmaWxlIjoidGFnU3RvcHMuanMiLCJzb3VyY2VSb290IjoiIiwic291cmNlcyI6WyIuLi8uLi8uLi8uLi9zcmMvbGliL3RpbWUtdHJhdmVsL3RhZ1N0b3BzLnRzIl0sIm5hbWVzIjpbXSwibWFwcGluZ3MiOiJBQUFBOzs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7R0EyQkc7QUFHSCxPQUFPLEVBQUUsV0FBVyxFQUFFLE1BQU0sV0FBVyxDQUFDO0FBQ3hDLE9BQU8sRUFBRSxXQUFXLEVBQUUsTUFBTSxrQkFBa0IsQ0FBQztBQUcvQzs7Ozs7O0dBTUc7QUFDSCxTQUFTLE1BQU0sQ0FBQyxHQUE0QixFQUFFLElBQW1CO0lBQy9ELE1BQU0sR0FBRyxHQUFHLEdBQUcsQ0FBQyxJQUFJLENBQUMsU0FBUyxDQUFDLEVBQUUsSUFBSSxDQUFDO0lBQ3RDLDRFQUE0RTtJQUM1RSw4REFBOEQ7SUFDOUQsTUFBTSxJQUFJLEdBQUcsS0FBSyxDQUFDLE9BQU8sQ0FBQyxHQUFHLENBQUMsQ0FBQyxDQUFDLENBQUMsR0FBRyxDQUFDLE1BQU0sQ0FBQyxDQUFDLENBQUMsRUFBZSxFQUFFLENBQUMsT0FBTyxDQUFDLEtBQUssUUFBUSxDQUFDLENBQUMsQ0FBQyxDQUFDLEVBQUUsQ0FBQztJQUM3RixPQUFPLElBQUksQ0FBQyxNQUFNLEdBQUcsQ0FBQyxDQUFDLENBQUMsQ0FBQyxJQUFJLENBQUMsQ0FBQyxDQUFDLFNBQVMsQ0FBQztBQUM1QyxDQUFDO0FBRUQ7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7Ozs7O0dBeUNHO0FBQ0gsTUFBTSxVQUFVLFFBQVEsQ0FBQyxJQUF3QjtJQUMvQyxNQUFNLE1BQU0sR0FBRyxJQUFJLElBQUksSUFBSSxDQUFDLE1BQU0sR0FBRyxDQUFDLENBQUMsQ0FBQyxDQUFDLElBQUksR0FBRyxDQUFDLElBQUksQ0FBQyxDQUFDLENBQUMsQ0FBQyxTQUFTLENBQUM7SUFDbkUsT0FBTztRQUNMLFFBQVEsQ0FDTixTQUFrQyxFQUNsQyxhQUE2QixFQUM3QixjQUF3QjtZQUV4QixPQUFPLFdBQVcsQ0FBb0IsV0FBVyxDQUFDLFNBQVMsRUFBRSxhQUFhLEVBQUUsY0FBYyxDQUFDLEVBQUUsQ0FBQyxJQUFJLEVBQUUsRUFBRTtnQkFDcEcsTUFBTSxPQUFPLEdBQUcsTUFBTSxDQUFDLFNBQVMsRUFBRSxJQUFJLENBQUMsQ0FBQztnQkFDeEMsSUFBSSxDQUFDLE9BQU87b0JBQUUsT0FBTyxJQUFJLENBQUM7Z0JBQzFCLElBQUksTUFBTSxJQUFJLENBQUMsT0FBTyxDQUFDLElBQUksQ0FBQyxDQUFDLEdBQUcsRUFBRSxFQUFFLENBQUMsTUFBTSxDQUFDLEdBQUcsQ0FBQyxHQUFHLENBQUMsQ0FBQztvQkFBRSxPQUFPLElBQUksQ0FBQztnQkFDbkUsT0FBTyxFQUFFLElBQUksRUFBRSxPQUFPLEVBQUUsQ0FBQztZQUMzQixDQUFDLENBQUMsQ0FBQztRQUNMLENBQUM7S0FDRixDQUFDO0FBQ0osQ0FBQyIsInNvdXJjZXNDb250ZW50IjpbIi8qKlxuICogdGFnU3RvcHMg4oCUIHRoZSBzdG9wcyBhIGNoYXJ0IERFQ0xBUkVELCByZWFkIGJhY2sgb2ZmIGl0cyBjb21taXQgbG9nLlxuICpcbiAqIFdIWSBUSElTIEZJTEUgRVhJU1RTLiBgY29tbWl0U3RvcHNgIGlzIHRoZSBvbmx5IHN0b3AgZ3JhbW1hciB0aGUgc3Vic3RyYXRlXG4gKiBrbm93czogb25lIHN0b3AgcGVyIGV4ZWN1dGVkIHN0YWdlLiBFdmVyeSByaWNoZXIgYXhpcyDigJQgbWlsZXN0b25lcywgdHVybnMsXG4gKiB0b29sIGNhbGxzIOKAlCB3YXMgYSBjb25zdW1lcidzIGNsYXNzaWZpZXIgb3ZlciBgcnVudGltZVN0YWdlSWRgOiBhIHN3aXRjaFxuICogdGhhdCBwYXJzZXMgYCNgIGFuZCBgL2AsIGxpdmVzIG91dHNpZGUgdGhlIHJlY29yZGluZywgYW5kIGdvZXMgc3RhbGUgd2hlblxuICogYSBzdGFnZSBpcyByZW5hbWVkLiBTaW5jZSA5LjIxLjAgdGhlIGF1dGhvciBjYW4gcHV0IE5BTUVTIG9uIGEgc3RhZ2UgYXRcbiAqIGJ1aWxkIHRpbWUgKGBGbG93Q2hhcnRCdWlsZGVyLnRhZ2AgLyBgb3B0aW9ucy50YWdzYCkgYW5kIHRoZSBlbmdpbmUgc3RhbXBzXG4gKiB0aGVtIG9uIHRoZSBzdGFnZSdzIGNvbW1pdCBidW5kbGUgKGBDb21taXRCdW5kbGUudGFnc2ApLiBUaGlzIHN0cmF0ZWd5XG4gKiByZWFkcyB0aGVtIGJhY2s6IGEgc3RvcmVkIHJlY29yZGluZyBmcm9tIEFOWSBjaGFydCBzY3J1YnMgYnkgaXRzIG93blxuICogbWlsZXN0b25lcywgd2l0aCBubyBpZCBjb252ZW50aW9ucyBpbiB0aGUgcmVhZGVyLlxuICpcbiAqIFdIQVQgSVQgSVMuIE9uZSBleHByZXNzaW9uIG92ZXIgYGZpbHRlclN0b3BzKGNvbW1pdFN0b3BzKC4uLikpYDoga2VlcCB0aGVcbiAqIHN0b3BzIHdob3NlIEZJUlNUIGJ1bmRsZSBjYXJyaWVzIGEgdGFnIChhbnkgb2YgdGhlIGFza2VkLWZvciBvbmVzLCBvciBhbnlcbiAqIHRhZyBhdCBhbGwgd2hlbiBub25lIGFyZSBhc2tlZCBmb3IpLCBnaXZlIHRoZSBzdXJ2aXZvcnMgdGhlIGxvZyBiYWNrLCBhbmRcbiAqIGNhcnJ5IHRoZSBidW5kbGUncyB3aG9sZSB0YWcgYXJyYXkgYXMgYFN0b3AubWV0YWAuIEV2ZXJ5dGhpbmcgYSBmaWx0ZXJpbmdcbiAqIGF4aXMgb3dlcyDigJQgdGhlIGJvb2tlbmQgZ3VhcmQsIHRoZSByZS1wYXJ0aXRpb24gc28gYSBkcm9wcGVkIHN0YWdlJ3NcbiAqIGNvbW1pdHMgZm9sZCBpbnRvIHRoZSB0YWdnZWQgc3RvcCBCRUZPUkUgdGhlbSwgYHByb2xvZ3VlYCBvbiBhIHN0YXJ0IHRoYXRcbiAqIGFic29yYmVkIHN0YWdlcyDigJQgY29tZXMgZnJvbSBgZmlsdGVyU3RvcHNgLCBzdGF0ZWQgb25jZSwgaW4gYGF4aXMudHNgLlxuICpcbiAqIFdIQVQgSVQgSVMgTk9ULiBOb3QgYSBzZWNvbmQgdm9jYWJ1bGFyeTogdGhlIHN0cmluZ3MgYXJlIHRoZSBjb25zdW1lcidzLFxuICogY2FycmllZCB2ZXJiYXRpbS4gTm90IGEgZGVyaXZhdGlvbjogYSBzdGFnZSB3aXRoIG5vIGRlY2xhcmVkIHRhZyBnZXRzIG5vXG4gKiBzdG9wIGhlcmUsIGhvd2V2ZXIgcmVjb2duaXNhYmxlIGl0cyBpZCDigJQgYSByZWFkZXIgdGhhdCB3YW50cyBpZHMgY2xhc3NpZmllZFxuICogd3JpdGVzIHRoYXQga2VlcCBydWxlIGl0c2VsZiAoYGZpbHRlclN0b3BzYCksIG9yIHJlYWRzIHRoZSBmb2xkXG4gKiAoYHN0YXRlQXRgKSBhbmQga2VlcHMgYnkgd2hhdCBjaGFuZ2VkLiBBbmQgbm90IGEgcmUtd2Fsazogb25seSBhIHRhZyB0aGVcbiAqIGVuZ2luZSBhY3R1YWxseSBzdGFtcGVkIGNhbiBwdXQgYSBzdG9wIG9uIHRoaXMgYXhpcy5cbiAqL1xuXG5pbXBvcnQgdHlwZSB7IENvbW1pdEJ1bmRsZSwgRXhlY3V0aW9uVHJlZSB9IGZyb20gJy4uL21lbW9yeS90eXBlcy5qcyc7XG5pbXBvcnQgeyBmaWx0ZXJTdG9wcyB9IGZyb20gJy4vYXhpcy5qcyc7XG5pbXBvcnQgeyBjb21taXRTdG9wcyB9IGZyb20gJy4vY29tbWl0U3RvcHMuanMnO1xuaW1wb3J0IHR5cGUgeyBTdG9wLCBUaW1lVHJhdmVsU3RyYXRlZ3kgfSBmcm9tICcuL3R5cGVzLmpzJztcblxuLyoqXG4gKiBUaGUgdGFncyBhIHN0b3AncyBmaXJzdCBidW5kbGUgY2Fycmllcywgb3IgYHVuZGVmaW5lZGAgd2hlbiBpdCBjYXJyaWVzXG4gKiBub25lLiBSZWFkcyB0aGUgYnVuZGxlIGF0IGBzdG9wLmNvbW1pdElkeGAg4oCUIHRoZSBGSVJTVCBjb21taXQgb2YgdGhlXG4gKiBzdGFnZSwgd2hpY2ggaXMgd2hlcmUgYFN0YWdlQ29udGV4dC5jb21taXRgIHJlY29yZHMgdGhlIHN0YW1wIChhIGZvcmtcbiAqIGNoaWxkJ3MgcmVwZWF0IGFuZCBhIG1vdW50J3MgZXhpdCDigJQgdGhlIGJ1bmRsZXMgd2l0aCBhIGBwaGFzZWAg4oCUIGNhcnJ5XG4gKiBub25lKS5cbiAqL1xuZnVuY3Rpb24gdGFnc0F0KGxvZzogcmVhZG9ubHkgQ29tbWl0QnVuZGxlW10sIHN0b3A6IFN0b3A8dW5rbm93bj4pOiByZWFkb25seSBzdHJpbmdbXSB8IHVuZGVmaW5lZCB7XG4gIGNvbnN0IHJhdyA9IGxvZ1tzdG9wLmNvbW1pdElkeF0/LnRhZ3M7XG4gIC8vIEEgc3RvcmVkIHJvdyBpcyBgdW5rbm93bltdYC1zaGFwZWQgdW50aWwgbmFycm93ZWQ6IGtlZXAgb25seSB0aGUgc3RyaW5ncyxcbiAgLy8gc28gYSBkYW1hZ2VkIHJvdyBjYW4gbmV2ZXIgcHV0IGEgbm9uLW5hbWUgaW50byBgU3RvcC5tZXRhYC5cbiAgY29uc3QgdGFncyA9IEFycmF5LmlzQXJyYXkocmF3KSA/IHJhdy5maWx0ZXIoKHQpOiB0IGlzIHN0cmluZyA9PiB0eXBlb2YgdCA9PT0gJ3N0cmluZycpIDogW107XG4gIHJldHVybiB0YWdzLmxlbmd0aCA+IDAgPyB0YWdzIDogdW5kZWZpbmVkO1xufVxuXG4vKipcbiAqIEEge0BsaW5rIFRpbWVUcmF2ZWxTdHJhdGVneX0gd2hvc2Ugc3RvcHMgYXJlIHRoZSBzdGFnZXMgdGhhdCBjYXJyeSBhXG4gKiBkZWNsYXJlZCB0YWcuXG4gKlxuICogKipLZWVwIHJ1bGU6IGFueS1vZi4qKiBBIHN0b3Agc3Vydml2ZXMgd2hlbiBpdHMgYnVuZGxlJ3MgYHRhZ3NgIHNoYXJlcyBhdFxuICogbGVhc3Qgb25lIG5hbWUgd2l0aCBgdGFnc2A7IHdpdGggYHRhZ3NgIG9taXR0ZWQgKG9yIGVtcHR5KSwgZXZlcnkgdGFnZ2VkXG4gKiBzdG9wIHN1cnZpdmVzLiBBbGwtb2YsIG9yIGEgcnVsZSBvdmVyIG1vcmUgdGhhbiB0aGUgdGFncywgaXMgYVxuICogYGZpbHRlclN0b3BzYCBjYWxsIGF3YXkg4oCUIHRoZSBsaWJyYXJ5IG93bnMgbm8gdm9jYWJ1bGFyeSwgc28gaXQgb3ducyBub1xuICogcmljaGVyIHJ1bGUgZWl0aGVyLlxuICpcbiAqICoqQXR0cmlidXRpb24gYnkgcHJlY2VkZW5jZS4qKiBBbiB1bnRhZ2dlZCBzdGFnZSdzIGNvbW1pdHMgZm9sZCBpbnRvIHRoZVxuICogdGFnZ2VkIHN0b3AgQkVGT1JFIGl0ICh3aGF0IGBmaWx0ZXJTdG9wc2AgZG9lcyk7IHRoZSBjb21taXRzIGJlZm9yZSB0aGVcbiAqIGZpcnN0IHRhZ2dlZCBzdGFnZSBhcmUgYWJzb3JiZWQgYnkgYCdzdGFydCdgLCB3aGljaCB0aGVuIHNheXNcbiAqIGBwcm9sb2d1ZTogdHJ1ZWAuIEEgcnVuIHdpdGggbm8gdGFnZ2VkIHN0YWdlIHlpZWxkcyB0aGUgdHdvIGJvb2tlbmRzIG9ubHkuXG4gKlxuICogKipgbWV0YWAgaXMgdGhlIGFycmF5LioqIEVhY2gga2VwdCBzdG9wIGNhcnJpZXMgaXRzIGJ1bmRsZSdzIGZ1bGwgYHRhZ3NgXG4gKiAobm90IGp1c3QgdGhlIG9uZXMgYXNrZWQgZm9yKSwgc28gYSByZWFkZXIgdGhhdCBmaWx0ZXJlZCBvblxuICogYCdtaWxlc3RvbmU6bGxtLXR1cm4nYCBjYW4gc3RpbGwgc2VlIHRoZSBzdGFnZSB3YXMgYWxzbyBgJ2F1ZGl0J2AuXG4gKlxuICogKipUaGUgZXF1aXZhbGVuY2UgbGF3LioqIGBzdGF0ZUF0KHN0b3ApYCBhdCBldmVyeSBrZXB0IHN0b3AgZXF1YWxzXG4gKiBgY29tbWl0U3RvcHNgJ3MgZm9sZCBhdCB0aGUgc2FtZSBjb21taXQgaW5kZXgg4oCUIGEgZmlsdGVyaW5nIGF4aXMgbW92ZXMgdGhlXG4gKiBzdG9wcywgbmV2ZXIgdGhlIGxvZy5cbiAqXG4gKiBAZXhhbXBsZVxuICogYGBgdHlwZXNjcmlwdFxuICogaW1wb3J0IHsgZmxvd0NoYXJ0IH0gZnJvbSAnZm9vdHByaW50anMnO1xuICogaW1wb3J0IHsgdGFnU3RvcHMsIHRpbWVUcmF2ZWwgfSBmcm9tICdmb290cHJpbnRqcy90cmFjZSc7XG4gKlxuICogY29uc3QgY2hhcnQgPSBmbG93Q2hhcnQ8U3RhdGU+KCdTZWVkJywgc2VlZEZuLCAnc2VlZCcpXG4gKiAgIC5hZGRGdW5jdGlvbignQ2FsbCBtb2RlbCcsIGNhbGxGbiwgJ2NhbGwtbGxtJylcbiAqICAgLnRhZygnbWlsZXN0b25lOmxsbS10dXJuJylcbiAqICAgLmFkZEZ1bmN0aW9uKCdSb3V0ZScsIHJvdXRlRm4sICdyb3V0ZScpXG4gKiAgIC50YWcoJ21pbGVzdG9uZTpkZWNpc2lvbicpXG4gKiAgIC5idWlsZCgpO1xuICpcbiAqIC8vIOKApnJ1biBpdCwga2VlcCB0aGUgc25hcHNob3TigKZcbiAqIGNvbnN0IGN1cnNvciA9IHRpbWVUcmF2ZWwoc25hcHNob3QsIHsgc3RyYXRlZ3k6IHRhZ1N0b3BzKFsnbWlsZXN0b25lOmxsbS10dXJuJ10pIH0pO1xuICogY3Vyc29yLnN0b3BzLm1hcCgocykgPT4gcy5sYWJlbCk7ICAgLy8gWydSdW4gc3RhcnQnLCAnQ2FsbCBtb2RlbCcsICdSdW4gZW5kJ11cbiAqIGN1cnNvci5zdG9wc1sxXS5tZXRhOyAgICAgICAgICAgICAgIC8vIFsnbWlsZXN0b25lOmxsbS10dXJuJ11cbiAqIGN1cnNvci5zdG9wc1swXS5wcm9sb2d1ZTsgICAgICAgICAgIC8vIHRydWUg4oCUICdzZWVkJyByYW4gYmVmb3JlIHRoZSBmaXJzdCB0dXJuXG4gKiBgYGBcbiAqL1xuZXhwb3J0IGZ1bmN0aW9uIHRhZ1N0b3BzKHRhZ3M/OiByZWFkb25seSBzdHJpbmdbXSk6IFRpbWVUcmF2ZWxTdHJhdGVneTxyZWFkb25seSBzdHJpbmdbXT4ge1xuICBjb25zdCB3YW50ZWQgPSB0YWdzICYmIHRhZ3MubGVuZ3RoID4gMCA/IG5ldyBTZXQodGFncykgOiB1bmRlZmluZWQ7XG4gIHJldHVybiB7XG4gICAgc3RvcHNGb3IoXG4gICAgICBjb21taXRMb2c6IHJlYWRvbmx5IENvbW1pdEJ1bmRsZVtdLFxuICAgICAgZXhlY3V0aW9uVHJlZT86IEV4ZWN1dGlvblRyZWUsXG4gICAgICBzdWJmbG93UmVzdWx0cz86IHVua25vd24sXG4gICAgKTogU3RvcDxyZWFkb25seSBzdHJpbmdbXT5bXSB7XG4gICAgICByZXR1cm4gZmlsdGVyU3RvcHM8cmVhZG9ubHkgc3RyaW5nW10+KGNvbW1pdFN0b3BzKGNvbW1pdExvZywgZXhlY3V0aW9uVHJlZSwgc3ViZmxvd1Jlc3VsdHMpLCAoc3RvcCkgPT4ge1xuICAgICAgICBjb25zdCBzdGFtcGVkID0gdGFnc0F0KGNvbW1pdExvZywgc3RvcCk7XG4gICAgICAgIGlmICghc3RhbXBlZCkgcmV0dXJuIG51bGw7XG4gICAgICAgIGlmICh3YW50ZWQgJiYgIXN0YW1wZWQuc29tZSgodGFnKSA9PiB3YW50ZWQuaGFzKHRhZykpKSByZXR1cm4gbnVsbDtcbiAgICAgICAgcmV0dXJuIHsgbWV0YTogc3RhbXBlZCB9O1xuICAgICAgfSk7XG4gICAgfSxcbiAgfTtcbn1cbiJdfQ==

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

@@ -1,70 +0,0 @@
-/**
- * timeTravel — a reader's cursor over a finished trace.
- *
- * The five laws this file implements (and the folder README states with an
- * example each):
- *
- *   1. ONE cursor. This object holds the only position. `drill()` returns a
- *      separate cursor over a separate log, never a second position here.
- *   2. A miss never moves. Every refusal returns the reason and leaves the
- *      cursor exactly where it was.
- *   3. A fold result is detached. `stateAt` returns frozen, cloned state that
- *      shares nothing with the engine.
- *   4. Marks live beside the log. They are the reader's notes, never written
- *      into the run's record.
- *   5. Stops are DERIVED from the recorded log — read-time queries over
- *      collected data, never a re-walk that invents what was not recorded.
- *
- * A CHAIN (9.18.0) does not add a sixth law and does not bend these five: it
- * is still one cursor, over sources that are still only read. What it adds is
- * that the STEPS run across a pause/resume — see `chain.ts` for the ordering
- * and lineage checks, and for why commit indices stay run-local.
- */
-import type { TimeTravel, TimeTravelOptions, TimeTravelSource } from './types.js';
-/**
- * Open a reader's cursor over a finished run.
- *
- * Nothing here executes anything: `snapshot` is a record of a run that already
- * happened, and every question is answered by reading it. A stored JSON
- * snapshot works exactly like a live one — since 9.18.0 its `commitLog` may be
- * an unvalidated `unknown[]`, narrowed per bundle where the fold reads it, so
- * a replayed recording needs no cast.
- *
- * @param snapshot `executor.getSnapshot()`, or any object with the same
- *   shape — including one round-tripped through JSON, or a subflow subtree
- *   (`getSubtreeSnapshot()`, whose log is spelled `history`). An ARRAY of them
- *   is a CHAIN: a pause and its resume read as one axis (see below).
- * @param options `strategy` chooses how stops are derived (default:
- *   `commitStops`, one stop per executed stage); `marks` seeds the cursor with
- *   bookmarks, e.g. restored from a saved reading session.
- *
- * @throws when a chain is not in run order, or its legs are not from one
- *   lineage — three checks, each with its own reason (see `chain.ts`):
- *   no `runtimeStageId` may appear in two legs; each leg's first execution
- *   index must be past the previous leg's last (the engine never resets the
- *   counter across a resume); and each leg's `initialState` must deep-equal
- *   the state the legs before it fold to — on a resume that base IS the state
- *   at the pause, so a foreign leg whose indices merely happen to be higher
- *   is refused too. The third check runs only where the record allows it: the
- *   later leg must carry an `initialState` and the earlier legs must fold from
- *   a real base with no unreadable rows; otherwise (an older recording with
- *   no base) the chain rests on the two index checks alone, and the fold's
- *   `basis` says what it stood on.
- *
- * @example
- * ```typescript
- * const tt = timeTravel(executor.getSnapshot());
- * tt.jumpTo('score-risk#4');
- * console.log(tt.changedSince());        // ['riskScore', 'tier']
- * console.log(tt.stateAt().state);       // state as that stage left it
- * tt.mark('the bad one');
- * const inner = tt.drill('sf-payment#7'); // a separate cursor, its own log
- *
- * // A pause and its resume, read as ONE axis:
- * const chained = timeTravel([pausedSnapshot, resumedSnapshot]);
- * chained.last();                         // the run's real end
- * chained.at()!.sourceIdx;                // 1 — which leg the indices are in
- * chained.jumpTo('approve#3');            // finds it in either leg
- * ```
- */
-export declare function timeTravel<TMeta = unknown>(snapshot: TimeTravelSource | readonly TimeTravelSource[], options?: TimeTravelOptions<TMeta>): TimeTravel<TMeta>;