agenticreplay 0.1.0 → 0.1.2

package/node_modules/@agenticreplay/core/dist/blobs.js

@@ -0,0 +1,102 @@
+import { createHash, randomBytes } from 'node:crypto';
+import { createReadStream } from 'node:fs';
+import { mkdir, readFile, readdir, rename, rm, stat, writeFile } from 'node:fs/promises';
+import { join } from 'node:path';
+/** Traces are sensitive material (design §7), so nothing is group- or world-readable. */
+const FILE_MODE = 0o600;
+const DIR_MODE = 0o700;
+const HEX64 = /^[0-9a-f]{64}$/;
+const PREFIX = 'sha256:';
+/** Accepts `sha256:<hex>` or a bare hex digest and returns the bare hex. */
+function bareDigest(ref) {
+    const raw = typeof ref === 'string' ? ref : ref.$blob;
+    const hex = raw.startsWith(PREFIX) ? raw.slice(PREFIX.length) : raw;
+    if (!HEX64.test(hex))
+        throw new Error(`invalid blob digest: ${JSON.stringify(raw)}`);
+    return hex;
+}
+function toBytes(data) {
+    return typeof data === 'string' ? new Uint8Array(Buffer.from(data, 'utf8')) : data;
+}
+/**
+ * Content-addressed blob store, laid out as `<dir>/<first two hex>/<full hex>` (spec §2.2).
+ *
+ * Every model turn resends the whole conversation, so identical content arrives over and over.
+ * Addressing by digest is what keeps a trace O(n) in new content instead of O(n²) in turns —
+ * hence `put` of existing content must not touch the file at all.
+ */
+export class BlobStore {
+    #dir;
+    /** @param dir The blob root, conventionally `<runDir>/blobs`. */
+    constructor(dir) {
+        this.#dir = dir;
+    }
+    get dir() {
+        return this.#dir;
+    }
+    async put(data, mediaType) {
+        const bytes = toBytes(data);
+        const hex = createHash('sha256').update(bytes).digest('hex');
+        const ref = { $blob: `${PREFIX}${hex}`, bytes: bytes.byteLength };
+        if (mediaType !== undefined)
+            ref.media_type = mediaType;
+        const shard = join(this.#dir, hex.slice(0, 2));
+        const path = join(shard, hex);
+        if (await exists(path))
+            return ref;
+        await mkdir(shard, { recursive: true, mode: DIR_MODE });
+        // Write then rename so a reader never sees a half-written blob under its final digest.
+        const tmp = `${path}.${randomBytes(6).toString('hex')}.tmp`;
+        try {
+            await writeFile(tmp, bytes, { mode: FILE_MODE, flag: 'wx' });
+            await rename(tmp, path);
+        }
+        finally {
+            await rm(tmp, { force: true });
+        }
+        return ref;
+    }
+    async get(ref) {
+        const hex = bareDigest(ref);
+        const path = join(this.#dir, hex.slice(0, 2), hex);
+        let buf;
+        try {
+            buf = await readFile(path);
+        }
+        catch {
+            throw new Error(`blob not found: ${PREFIX}${hex} (looked in ${path})`);
+        }
+        return new Uint8Array(buf.buffer, buf.byteOffset, buf.byteLength);
+    }
+    async has(digest) {
+        const hex = bareDigest(digest);
+        return exists(join(this.#dir, hex.slice(0, 2), hex));
+    }
+    async count() {
+        let n = 0;
+        for (const shard of await readdir(this.#dir, { withFileTypes: true }).catch(() => [])) {
+            if (!shard.isDirectory())
+                continue;
+            const files = await readdir(join(this.#dir, shard.name)).catch(() => []);
+            n += files.filter((f) => HEX64.test(f)).length;
+        }
+        return n;
+    }
+}
+/** SHA-256 of a whole file, streamed — this is the integrity root of a run (spec §6). */
+export async function sha256File(path) {
+    const hash = createHash('sha256');
+    for await (const chunk of createReadStream(path))
+        hash.update(chunk);
+    return hash.digest('hex');
+}
+async function exists(path) {
+    try {
+        await stat(path);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+//# sourceMappingURL=blobs.js.map

package/node_modules/@agenticreplay/core/dist/blobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"blobs.js","sourceRoot":"","sources":["../src/blobs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACtD,OAAO,EAAE,gBAAgB,EAAE,MAAM,SAAS,CAAC;AAC3C,OAAO,EAAE,KAAK,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,MAAM,kBAAkB,CAAC;AACzF,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAGjC,yFAAyF;AACzF,MAAM,SAAS,GAAG,KAAK,CAAC;AACxB,MAAM,QAAQ,GAAG,KAAK,CAAC;AAEvB,MAAM,KAAK,GAAG,gBAAgB,CAAC;AAC/B,MAAM,MAAM,GAAG,SAAS,CAAC;AAEzB,4EAA4E;AAC5E,SAAS,UAAU,CAAC,GAAqB;IACvC,MAAM,GAAG,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IACtD,MAAM,GAAG,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC;IACpE,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,GAAG,CAAC;QAAE,MAAM,IAAI,KAAK,CAAC,wBAAwB,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC;IACrF,OAAO,GAAG,CAAC;AACb,CAAC;AAED,SAAS,OAAO,CAAC,IAAyB;IACxC,OAAO,OAAO,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,UAAU,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;AACrF,CAAC;AAED;;;;;;GAMG;AACH,MAAM,OAAO,SAAS;IACX,IAAI,CAAS;IAEtB,iEAAiE;IACjE,YAAY,GAAW;QACrB,IAAI,CAAC,IAAI,GAAG,GAAG,CAAC;IAClB,CAAC;IAED,IAAI,GAAG;QACL,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,IAAyB,EAAE,SAAkB;QACrD,MAAM,KAAK,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;QAC5B,MAAM,GAAG,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QAC7D,MAAM,GAAG,GAAY,EAAE,KAAK,EAAE,GAAG,MAAM,GAAG,GAAG,EAAE,EAAE,KAAK,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC;QAC3E,IAAI,SAAS,KAAK,SAAS;YAAE,GAAG,CAAC,UAAU,GAAG,SAAS,CAAC;QAExD,MAAM,KAAK,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;QAC/C,MAAM,IAAI,GAAG,IAAI,CAAC,KAAK,EAAE,GAAG,CAAC,CAAC;QAC9B,IAAI,MAAM,MAAM,CAAC,IAAI,CAAC;YAAE,OAAO,GAAG,CAAC;QAEnC,MAAM,KAAK,CAAC,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;QACxD,uFAAuF;QACvF,MAAM,GAAG,GAAG,GAAG,IAAI,IAAI,WAAW,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,MAAM,CAAC;QAC5D,IAAI,CAAC;YACH,MAAM,SAAS,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC;YAC7D,MAAM,MAAM,CAAC,GAAG,EAAE,IAAI,CAAC,CAAC;QAC1B,CAAC;gBAAS,CAAC;YACT,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,CAAC;QACjC,CAAC;QACD,OAAO,GAAG,CAAC;IACb,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,GAAqB;QAC7B,MAAM,GAAG,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC;QAC5B,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC;QACnD,IAAI,GAAW,CAAC;QAChB,IAAI,CAAC;YACH,GAAG,GAAG,MAAM,QAAQ,CAAC,IAAI,CAAC,CAAC;QAC7B,CAAC;QAAC,MAAM,CAAC;YACP,MAAM,IAAI,KAAK,CAAC,mBAAmB,MAAM,GAAG,GAAG,eAAe,IAAI,GAAG,CAAC,CAAC;QACzE,CAAC;QACD,OAAO,IAAI,UAAU,CAAC,GAAG,CAAC,MAAM,EAAE,GAAG,CAAC,UAAU,EAAE,GAAG,CAAC,UAAU,CAAC,CAAC;IACpE,CAAC;IAED,KAAK,CAAC,GAAG,CAAC,MAAwB;QAChC,MAAM,GAAG,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC;QAC/B,OAAO,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,GAAG,CAAC,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,CAAC,KAAK;QACT,IAAI,CAAC,GAAG,CAAC,CAAC;QACV,KAAK,MAAM,KAAK,IAAI,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,EAAE,CAAC;YACtF,IAAI,CAAC,KAAK,CAAC,WAAW,EAAE;gBAAE,SAAS;YACnC,MAAM,KAAK,GAAG,MAAM,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,EAAE,CAAC,CAAC;YACzE,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACjD,CAAC;QACD,OAAO,CAAC,CAAC;IACX,CAAC;CACF;AAED,yFAAyF;AACzF,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,IAAY;IAC3C,MAAM,IAAI,GAAG,UAAU,CAAC,QAAQ,CAAC,CAAC;IAClC,IAAI,KAAK,EAAE,MAAM,KAAK,IAAI,gBAAgB,CAAC,IAAI,CAAC;QAAE,IAAI,CAAC,MAAM,CAAC,KAAe,CAAC,CAAC;IAC/E,OAAO,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,KAAK,UAAU,MAAM,CAAC,IAAY;IAChC,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,IAAI,CAAC,CAAC;QACjB,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC"}

package/node_modules/@agenticreplay/core/dist/fetch.d.ts

@@ -0,0 +1,38 @@
+/**
+ * fetch with the DESTINATION PINNED — a redirect is a hard failure, never a hand-off.
+ *
+ * THE ORIGIN CHECK VALIDATES THE URL WE PASS, NOT THE URL THE REQUEST REACHES (orcacode-review).
+ * `resolveGateway` decides whether the key may go to this host, and then `fetch` was free to follow
+ * a `Location` anywhere. undici strips `authorization` across origins but NOT `x-api-key`, and
+ * gatewayHeaders sets both to the same key — so one header from whoever answers for the gateway
+ * carried the replay-scoped credential to a host it was never issued for, defeating the promise the
+ * README makes in writing: "Never a key to a host it was not set up for."
+ *
+ * Push had a second failure on top: a 301/302/303 is re-issued as a GET with no body, so the
+ * target's 200 satisfied `res.ok` and the CLI printed `push.done` for a run that went nowhere. A
+ * 307/308 instead failed with an opaque "fetch failed", because undici cannot replay a detached
+ * body — so a legitimately redirecting gateway could not be talked to either.
+ *
+ * `manual` rather than `error`: Node resolves it with the real status and Location, so the refusal
+ * can NAME the destination. `error` rejects with a bare TypeError whose only distinguishing mark is
+ * an undici-internal cause string ("unexpected redirect"), which a genuine connection failure
+ * ("bad port") is indistinguishable from without matching on that string.
+ *
+ * Following a same-origin redirect would be safe and is deliberately not implemented: no gateway
+ * this CLI talks to issues one, and an unused branch that forwards credentials is the wrong thing
+ * to carry.
+ *
+ * IT LIVES IN core, NOT IN THE PACKAGE THAT FIRST NEEDED IT (orcacode-review, twice).
+ *
+ * The first version was local to the CLI's sync.ts, so push and pull were pinned and `probeModels`
+ * — the third request carrying the same header pair — was not. The second lived beside
+ * gatewayHeaders in the CLI's config.ts, which fixed that and left the RECORDING PROXY out: it is
+ * handed the very same credential as `upstreamHeaders` and attaches it to both of its live call
+ * sites, on the path every `agenticreplay record` / `replay --loose` / `compare` / fork takes.
+ *
+ * Both times the pin sat in the package that noticed the problem rather than in the one every
+ * carrier of the credential depends on. core is that package, so this is the last place it can
+ * move to.
+ */
+export declare function fetchPinned(target: string, init: RequestInit): Promise<Response>;
+//# sourceMappingURL=fetch.d.ts.map

package/node_modules/@agenticreplay/core/dist/fetch.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.d.ts","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,wBAAsB,WAAW,CAAC,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,QAAQ,CAAC,CAWtF"}

package/node_modules/@agenticreplay/core/dist/fetch.js

@@ -0,0 +1,47 @@
+/**
+ * fetch with the DESTINATION PINNED — a redirect is a hard failure, never a hand-off.
+ *
+ * THE ORIGIN CHECK VALIDATES THE URL WE PASS, NOT THE URL THE REQUEST REACHES (orcacode-review).
+ * `resolveGateway` decides whether the key may go to this host, and then `fetch` was free to follow
+ * a `Location` anywhere. undici strips `authorization` across origins but NOT `x-api-key`, and
+ * gatewayHeaders sets both to the same key — so one header from whoever answers for the gateway
+ * carried the replay-scoped credential to a host it was never issued for, defeating the promise the
+ * README makes in writing: "Never a key to a host it was not set up for."
+ *
+ * Push had a second failure on top: a 301/302/303 is re-issued as a GET with no body, so the
+ * target's 200 satisfied `res.ok` and the CLI printed `push.done` for a run that went nowhere. A
+ * 307/308 instead failed with an opaque "fetch failed", because undici cannot replay a detached
+ * body — so a legitimately redirecting gateway could not be talked to either.
+ *
+ * `manual` rather than `error`: Node resolves it with the real status and Location, so the refusal
+ * can NAME the destination. `error` rejects with a bare TypeError whose only distinguishing mark is
+ * an undici-internal cause string ("unexpected redirect"), which a genuine connection failure
+ * ("bad port") is indistinguishable from without matching on that string.
+ *
+ * Following a same-origin redirect would be safe and is deliberately not implemented: no gateway
+ * this CLI talks to issues one, and an unused branch that forwards credentials is the wrong thing
+ * to carry.
+ *
+ * IT LIVES IN core, NOT IN THE PACKAGE THAT FIRST NEEDED IT (orcacode-review, twice).
+ *
+ * The first version was local to the CLI's sync.ts, so push and pull were pinned and `probeModels`
+ * — the third request carrying the same header pair — was not. The second lived beside
+ * gatewayHeaders in the CLI's config.ts, which fixed that and left the RECORDING PROXY out: it is
+ * handed the very same credential as `upstreamHeaders` and attaches it to both of its live call
+ * sites, on the path every `agenticreplay record` / `replay --loose` / `compare` / fork takes.
+ *
+ * Both times the pin sat in the package that noticed the problem rather than in the one every
+ * carrier of the credential depends on. core is that package, so this is the last place it can
+ * move to.
+ */
+export async function fetchPinned(target, init) {
+    const res = await fetch(target, { ...init, redirect: 'manual' });
+    if (res.status >= 300 && res.status < 400) {
+        const to = res.headers.get('location') ?? '(no Location header)';
+        throw new Error(`${target} answered ${res.status} redirecting to ${to}. agenticreplay does not follow it: your key is ` +
+            `attached to the host you named, and following would hand it to whatever answers there. ` +
+            `Point --gateway (or AGENTICREPLAY_GATEWAY_URL) at the final address instead.`);
+    }
+    return res;
+}
+//# sourceMappingURL=fetch.js.map

package/node_modules/@agenticreplay/core/dist/fetch.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fetch.js","sourceRoot":"","sources":["../src/fetch.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAmCG;AACH,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,MAAc,EAAE,IAAiB;IACjE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,MAAM,EAAE,EAAE,GAAG,IAAI,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;IACjE,IAAI,GAAG,CAAC,MAAM,IAAI,GAAG,IAAI,GAAG,CAAC,MAAM,GAAG,GAAG,EAAE,CAAC;QAC1C,MAAM,EAAE,GAAG,GAAG,CAAC,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,IAAI,sBAAsB,CAAC;QACjE,MAAM,IAAI,KAAK,CACb,GAAG,MAAM,aAAa,GAAG,CAAC,MAAM,mBAAmB,EAAE,kDAAkD;YACrG,yFAAyF;YACzF,8EAA8E,CACjF,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,CAAC;AACb,CAAC"}

package/node_modules/@agenticreplay/core/dist/graph.d.ts

@@ -0,0 +1,106 @@
+import type { TraceEvent } from '@agenticreplay/schema';
+/** A forkable point in a run. Derived from the log, never recorded (spec §3). */
+export interface Checkpoint {
+    seq: number;
+    turn: number;
+    /** Tree id from the governing `fs.snapshot`, when it recorded one. */
+    fsTree?: string;
+}
+export interface Turn {
+    turn: number;
+    startSeq: number;
+    endSeq: number;
+    events: TraceEvent[];
+}
+export interface SnapResult {
+    checkpoint: Checkpoint;
+    /** True when the target was not itself a checkpoint and had to move back. */
+    snapped: boolean;
+}
+/**
+ * Every seq that satisfies both checkpoint conditions of spec §3: an `fs.snapshot` at or before it
+ * in the same turn, and a complete conversation prefix.
+ */
+export declare function deriveCheckpoints(events: TraceEvent[]): Checkpoint[];
+/**
+ * The checkpoint a fork of `target` must actually start from — the nearest preceding one.
+ *
+ * Never rounds forward. Forking from state the run had not reached yet would produce a child run
+ * that silently disagrees with its parent, which is worse than refusing outright.
+ */
+export declare function snapToCheckpoint(cps: Checkpoint[], target: number): SnapResult;
+/** The events of a run grouped into model turns, in turn order. */
+export declare function turnsOf(events: TraceEvent[]): Turn[];
+/** The event at `seq` and everything transitively named by `causes`, oldest first. */
+export declare function causalChain(events: TraceEvent[], seq: number): TraceEvent[];
+/** Where an edge came from. The distinction is the whole honesty mechanism — see `runGraph`. */
+export type EdgeKind = 'recorded' | 'inferred';
+export interface GraphNode {
+    seq: number;
+    turn: number;
+    type: TraceEvent['type'];
+    attrs?: Record<string, unknown>;
+}
+export interface GraphEdge {
+    /** The cause. Always less than `to`, as spec §2.1 requires of `causes`. */
+    from: number;
+    to: number;
+    kind: EdgeKind;
+    /** Why this edge exists. For an inferred edge, the rule that produced it. */
+    rule: string;
+}
+export interface RunGraph {
+    nodes: GraphNode[];
+    edges: GraphEdge[];
+}
+/**
+ * A run as nodes and edges, with every edge saying whether the trace vouches for it.
+ *
+ * Two kinds, and they are not interchangeable. A `recorded` edge came out of `causes`, which the
+ * recorder wrote because it watched the relationship happen. An `inferred` edge was derived here,
+ * just now, by the named rule — a filesystem snapshot is taken once per turn rather than once per
+ * tool call, and shell frames are bucketed into turns by wall clock, so attributing an effect to a
+ * *particular* call is a guess however good the heuristic is.
+ *
+ * Inferred edges are therefore never written back to the trace. That is the same discipline spec
+ * §3 applies to checkpoints, which are derived and never recorded, and it exists so that a field
+ * a third-party reader trusts never contains something agenticreplay made up.
+ */
+export declare function runGraph(events: TraceEvent[]): RunGraph;
+/**
+ * The sub-graph that produced `seq`: that event and everything transitively behind it.
+ *
+ * `causalChain` walks `causes` alone and so stops at the first inferred hop, which in a real run
+ * is the hop from a tool call to the shell command it ran — exactly the one a person following a
+ * failure backwards needs. This walks the derived graph instead, so it crosses both kinds.
+ */
+export declare function chainTo(graph: RunGraph, seq: number): RunGraph;
+/**
+ * The event a card about this run should be about, or undefined when nothing stands out.
+ *
+ * Which chain to draw *is* the feature. A card gets screenshotted whether or not it happens to be
+ * the interesting one, so an arbitrary pick travels further than no card at all — hence a run with
+ * nothing notable returns undefined and the caller refuses rather than drawing something.
+ *
+ * The order is failure first, then the largest visible effect: a command that exited non-zero, a
+ * tool that reported an error, an error agenticreplay itself recorded, a replay divergence, and only then
+ * the last file the run changed. Within a kind the last one wins, since that is where the run
+ * ended up.
+ */
+export declare function pickChainTarget(events: TraceEvent[]): number | undefined;
+/** Tool calls that hand work to another agent, by the argument every harness gives them. */
+export declare function isDelegation(event: TraceEvent): boolean;
+/**
+ * The delegation whose span encloses `seq`, if any.
+ *
+ * A replay that halts inside one is the hardest kind of miss to read: the distance is small, the
+ * trace is intact, and nothing on the line says why the same run asked a different question. The
+ * answer is that the harness wrote the delegate's prompt itself and writes a fresh one every time,
+ * so that request genuinely was not the recorded one. Naming the delegation turns a number into
+ * that sentence.
+ */
+export declare function enclosingDelegation(events: TraceEvent[], seq: number): {
+    seq: number;
+    subagent: string;
+} | undefined;
+//# sourceMappingURL=graph.d.ts.map

package/node_modules/@agenticreplay/core/dist/graph.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"graph.d.ts","sourceRoot":"","sources":["../src/graph.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uBAAuB,CAAC;AAExD,iFAAiF;AACjF,MAAM,WAAW,UAAU;IACzB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,sEAAsE;IACtE,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAED,MAAM,WAAW,IAAI;IACnB,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,EAAE,CAAC;CACtB;AAED,MAAM,WAAW,UAAU;IACzB,UAAU,EAAE,UAAU,CAAC;IACvB,6EAA6E;IAC7E,OAAO,EAAE,OAAO,CAAC;CAClB;AAyBD;;;GAGG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,UAAU,EAAE,CAmBpE;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,UAAU,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,UAAU,CAkB9E;AAED,mEAAmE;AACnE,wBAAgB,OAAO,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,IAAI,EAAE,CAepD;AAED,sFAAsF;AACtF,wBAAgB,WAAW,CAAC,MAAM,EAAE,UAAU,EAAE,EAAE,GAAG,EAAE,MAAM,GAAG,UAAU,EAAE,CAsB3E;AAED,gGAAgG;AAChG,MAAM,MAAM,QAAQ,GAAG,UAAU,GAAG,UAAU,CAAC;AAE/C,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,UAAU,CAAC,MAAM,CAAC,CAAC;IACzB,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;CACjC;AAED,MAAM,WAAW,SAAS;IACxB,2EAA2E;IAC3E,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,QAAQ,CAAC;IACf,6EAA6E;IAC7E,IAAI,EAAE,MAAM,CAAC;CACd;AAED,MAAM,WAAW,QAAQ;IACvB,KAAK,EAAE,SAAS,EAAE,CAAC;IACnB,KAAK,EAAE,SAAS,EAAE,CAAC;CACpB;AA8GD;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,QAAQ,CAgDvD;AAED;;;;;;GAMG;AACH,wBAAgB,OAAO,CAAC,KAAK,EAAE,QAAQ,EAAE,GAAG,EAAE,MAAM,GAAG,QAAQ,CA8B9D;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,eAAe,CAAC,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,GAAG,SAAS,CAiBxE;AAOD,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,KAAK,EAAE,UAAU,GAAG,OAAO,CAMvD;AAED;;;;;;;;GAQG;AACH,wBAAgB,mBAAmB,CACjC,MAAM,EAAE,UAAU,EAAE,EACpB,GAAG,EAAE,MAAM,GACV;IAAE,GAAG,EAAE,MAAM,CAAC;IAAC,QAAQ,EAAE,MAAM,CAAA;CAAE,GAAG,SAAS,CAkB/C"}