agenticreplay 0.1.0 → 0.1.2

package/packages/cli/dist/flags.js.map

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

package/packages/cli/dist/fs-events.d.ts

@@ -0,0 +1,19 @@
+import type { TraceWriter } from '@agenticreplay/core';
+import type { FsCapture } from '@agenticreplay/fs-capture';
+import type { Output } from './out.js';
+/**
+ * Snapshot the workspace and write what changed.
+ *
+ * Shared by `agenticreplay record` and by a fork, which had none of this: a fork ran a live agent in a
+ * worktree and recorded only the conversation, so its trace carried no `fs.snapshot` at all — and a
+ * checkpoint is *derived* from a snapshot (spec §3). A run with no checkpoints cannot be forked, so
+ * you could not fork a fork, and `agenticreplay compare last` straight after a fork failed with "this run
+ * has no checkpoints" because `last` had resolved to the fork.
+ *
+ * Degrade, never abort: losing a snapshot costs one checkpoint, whereas throwing here would cost
+ * the user the run they were in the middle of.
+ */
+export declare function appendSnapshot(fs: FsCapture, writer: TraceWriter, out: Output, turn: number, options?: {
+    initial?: boolean;
+}): Promise<void>;
+//# sourceMappingURL=fs-events.d.ts.map

package/packages/cli/dist/fs-events.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-events.d.ts","sourceRoot":"","sources":["../src/fs-events.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,UAAU,CAAC;AAGvC;;;;;;;;;;;GAWG;AACH,wBAAsB,cAAc,CAClC,EAAE,EAAE,SAAS,EACb,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,MAAM,EACZ,OAAO,GAAE;IAAE,OAAO,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,IAAI,CAAC,CA+Ef"}

package/packages/cli/dist/fs-events.js

@@ -0,0 +1,89 @@
+import { snapshotWithRetry } from './snapshot.js';
+/**
+ * Snapshot the workspace and write what changed.
+ *
+ * Shared by `agenticreplay record` and by a fork, which had none of this: a fork ran a live agent in a
+ * worktree and recorded only the conversation, so its trace carried no `fs.snapshot` at all — and a
+ * checkpoint is *derived* from a snapshot (spec §3). A run with no checkpoints cannot be forked, so
+ * you could not fork a fork, and `agenticreplay compare last` straight after a fork failed with "this run
+ * has no checkpoints" because `last` had resolved to the fork.
+ *
+ * Degrade, never abort: losing a snapshot costs one checkpoint, whereas throwing here would cost
+ * the user the run they were in the middle of.
+ */
+export async function appendSnapshot(fs, writer, out, turn, options = {}) {
+    const outcome = await snapshotWithRetry(fs, turn);
+    if (!outcome.ok || !outcome.snapshot) {
+        out.warn('fs.snapshot_failed', { turn, attempts: outcome.attempts, error: outcome.error });
+        await writer.append({
+            type: 'note',
+            actor: 'agenticreplay',
+            turn,
+            attrs: { rule: 'fs_snapshot_skipped', attempts: outcome.attempts, error: outcome.error },
+        });
+        return;
+    }
+    const snap = outcome.snapshot;
+    // A declared artifact path that is a git checkout of its own — a cloned corpus under `dataset/`
+    // — cannot be stored here, and is dropped so the rest of the tree stays restorable. Said once
+    // per path: the whole reason `artifacts.capture` exists is that a recording missing its inputs
+    // looks exactly like a recording that has them until someone replays it somewhere else.
+    if (snap.skippedGitlinks !== undefined && snap.skippedGitlinks.length > 0) {
+        out.warn('fs.artifact_not_captured', {
+            paths: snap.skippedGitlinks.join(','),
+            why: 'these are git repositories of their own, and git stores them as a reference rather ' +
+                'than as their contents',
+            next: 'a replay elsewhere will not find them; remove the nested .git, or keep them outside ' +
+                'the declared artifact paths',
+        });
+    }
+    // A nested repository with no commit of its own is not in this snapshot and cannot be: git
+    // records an embedded repository by the id of its HEAD commit, and it has none. Said here for
+    // the reason the line above is said — a recording that quietly omits part of the workspace looks
+    // exactly like one that has all of it, right up until someone replays it. Once per path.
+    if (snap.uncommittedNested !== undefined && snap.uncommittedNested.length > 0) {
+        out.warn('fs.nested_not_captured', {
+            paths: snap.uncommittedNested.join(','),
+            why: 'these are git repositories of their own with no commit yet, so git has no id to record them by and this snapshot holds nothing of what is inside them',
+            next: 'commit inside them, or move them outside the workspace, if a replay needs their contents',
+        });
+    }
+    // A declared artifact path inside a nested repository is not in this snapshot and cannot be: git
+    // stages nothing inside another repository. Before this was said, the forced add either killed
+    // the snapshot — every turn, so the run held none — or quietly staged nothing, and the recording
+    // looked like it held the artifacts right up until a replay needed them. Once per path.
+    if (snap.forcedInsideNested !== undefined && snap.forcedInsideNested.length > 0) {
+        out.warn('fs.artifact_inside_repository', {
+            paths: snap.forcedInsideNested.map((entry) => entry.path).join(','),
+            inside: [...new Set(snap.forcedInsideNested.map((entry) => entry.repository))].join(','),
+            why: 'these declared artifact paths sit inside a git repository of their own, and git stages nothing inside another repository, so this snapshot holds none of them',
+            next: 'a replay cannot put them back and will refuse to reset them; keep the artifacts outside that repository',
+        });
+    }
+    await writer.append({
+        type: 'fs.snapshot',
+        actor: 'agenticreplay',
+        turn,
+        attrs: {
+            tree: snap.tree,
+            changes: snap.changes.length,
+            ...(options.initial === true ? { initial: true } : {}),
+        },
+    });
+    for (const change of snap.changes) {
+        await writer.append({
+            type: 'fs.change',
+            actor: 'agenticreplay',
+            turn,
+            attrs: {
+                path: change.path,
+                status: change.status,
+                insertions: change.insertions,
+                deletions: change.deletions,
+                // Only when true, so a trace is not littered with a false on every unremarkable change.
+                ...(change.eolOnly === true ? { eol_only: true } : {}),
+            },
+        });
+    }
+}
+//# sourceMappingURL=fs-events.js.map

package/packages/cli/dist/fs-events.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fs-events.js","sourceRoot":"","sources":["../src/fs-events.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,cAAc,CAClC,EAAa,EACb,MAAmB,EACnB,GAAW,EACX,IAAY,EACZ,UAAiC,EAAE;IAEnC,MAAM,OAAO,GAAG,MAAM,iBAAiB,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC;IAClD,IAAI,CAAC,OAAO,CAAC,EAAE,IAAI,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC;QACrC,GAAG,CAAC,IAAI,CAAC,oBAAoB,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC3F,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,MAAM;YACZ,KAAK,EAAE,eAAe;YACtB,IAAI;YACJ,KAAK,EAAE,EAAE,IAAI,EAAE,qBAAqB,EAAE,QAAQ,EAAE,OAAO,CAAC,QAAQ,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE;SACzF,CAAC,CAAC;QACH,OAAO;IACT,CAAC;IAED,MAAM,IAAI,GAAG,OAAO,CAAC,QAAQ,CAAC;IAC9B,gGAAgG;IAChG,8FAA8F;IAC9F,+FAA+F;IAC/F,wFAAwF;IACxF,IAAI,IAAI,CAAC,eAAe,KAAK,SAAS,IAAI,IAAI,CAAC,eAAe,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1E,GAAG,CAAC,IAAI,CAAC,0BAA0B,EAAE;YACnC,KAAK,EAAE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC;YACrC,GAAG,EACD,qFAAqF;gBACrF,wBAAwB;YAC1B,IAAI,EACF,sFAAsF;gBACtF,6BAA6B;SAChC,CAAC,CAAC;IACL,CAAC;IACD,2FAA2F;IAC3F,8FAA8F;IAC9F,iGAAiG;IACjG,yFAAyF;IACzF,IAAI,IAAI,CAAC,iBAAiB,KAAK,SAAS,IAAI,IAAI,CAAC,iBAAiB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9E,GAAG,CAAC,IAAI,CAAC,wBAAwB,EAAE;YACjC,KAAK,EAAE,IAAI,CAAC,iBAAiB,CAAC,IAAI,CAAC,GAAG,CAAC;YACvC,GAAG,EAAE,uJAAuJ;YAC5J,IAAI,EAAE,0FAA0F;SACjG,CAAC,CAAC;IACL,CAAC;IAED,iGAAiG;IACjG,+FAA+F;IAC/F,iGAAiG;IACjG,wFAAwF;IACxF,IAAI,IAAI,CAAC,kBAAkB,KAAK,SAAS,IAAI,IAAI,CAAC,kBAAkB,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAChF,GAAG,CAAC,IAAI,CAAC,+BAA+B,EAAE;YACxC,KAAK,EAAE,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACnE,MAAM,EAAE,CAAC,GAAG,IAAI,GAAG,CAAC,IAAI,CAAC,kBAAkB,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YACxF,GAAG,EAAE,+JAA+J;YACpK,IAAI,EAAE,yGAAyG;SAChH,CAAC,CAAC;IACL,CAAC;IAED,MAAM,MAAM,CAAC,MAAM,CAAC;QAClB,IAAI,EAAE,aAAa;QACnB,KAAK,EAAE,eAAe;QACtB,IAAI;QACJ,KAAK,EAAE;YACL,IAAI,EAAE,IAAI,CAAC,IAAI;YACf,OAAO,EAAE,IAAI,CAAC,OAAO,CAAC,MAAM;YAC5B,GAAG,CAAC,OAAO,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;SACvD;KACF,CAAC,CAAC;IACH,KAAK,MAAM,MAAM,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;QAClC,MAAM,MAAM,CAAC,MAAM,CAAC;YAClB,IAAI,EAAE,WAAW;YACjB,KAAK,EAAE,eAAe;YACtB,IAAI;YACJ,KAAK,EAAE;gBACL,IAAI,EAAE,MAAM,CAAC,IAAI;gBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;gBACrB,UAAU,EAAE,MAAM,CAAC,UAAU;gBAC7B,SAAS,EAAE,MAAM,CAAC,SAAS;gBAC3B,wFAAwF;gBACxF,GAAG,CAAC,MAAM,CAAC,OAAO,KAAK,IAAI,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aACvD;SACF,CAAC,CAAC;IACL,CAAC;AACH,CAAC"}

package/packages/cli/dist/index.d.ts

@@ -0,0 +1,18 @@
+export * from './api.js';
+export * from './args.js';
+export * from './out.js';
+export * from './main.js';
+export * from './exchange-events.js';
+export * from './mcp.js';
+export * from './serial.js';
+export * from './snapshot.js';
+export * from './share-card.js';
+export * from './commands/record.js';
+export * from './commands/replay.js';
+export * from './commands/compare.js';
+export * from './commands/inspect.js';
+export * from './commands/scrub.js';
+export * from './commands/gc.js';
+export * from './commands/doctor.js';
+export * from './version.js';
+//# sourceMappingURL=index.d.ts.map

package/packages/cli/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/packages/cli/dist/index.js

@@ -0,0 +1,18 @@
+export * from './api.js';
+export * from './args.js';
+export * from './out.js';
+export * from './main.js';
+export * from './exchange-events.js';
+export * from './mcp.js';
+export * from './serial.js';
+export * from './snapshot.js';
+export * from './share-card.js';
+export * from './commands/record.js';
+export * from './commands/replay.js';
+export * from './commands/compare.js';
+export * from './commands/inspect.js';
+export * from './commands/scrub.js';
+export * from './commands/gc.js';
+export * from './commands/doctor.js';
+export * from './version.js';
+//# sourceMappingURL=index.js.map

package/packages/cli/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,UAAU,CAAC;AACzB,cAAc,WAAW,CAAC;AAC1B,cAAc,sBAAsB,CAAC;AACrC,cAAc,UAAU,CAAC;AACzB,cAAc,aAAa,CAAC;AAC5B,cAAc,eAAe,CAAC;AAC9B,cAAc,iBAAiB,CAAC;AAChC,cAAc,sBAAsB,CAAC;AACrC,cAAc,sBAAsB,CAAC;AACrC,cAAc,uBAAuB,CAAC;AACtC,cAAc,uBAAuB,CAAC;AACtC,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,cAAc,CAAC"}

package/packages/cli/dist/main.d.ts

@@ -0,0 +1,2 @@
+export declare function main(argv: string[], cwd?: string): Promise<number>;
+//# sourceMappingURL=main.d.ts.map

package/packages/cli/dist/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../src/main.ts"],"names":[],"mappings":"AAgKA,wBAAsB,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,GAAG,SAAgB,GAAG,OAAO,CAAC,MAAM,CAAC,CAkJ/E"}

package/packages/cli/dist/main.js

@@ -0,0 +1,404 @@
+import { assertKnownFlags, assertNoStrayPositionals } from './flags.js';
+import { parseArgs } from './args.js';
+import { AgenticReplay } from './api.js';
+import { serveMcp } from './mcp-server.js';
+import { Output } from './out.js';
+import { attachCommand } from './commands/attach.js';
+import { quickstartCommand } from './commands/quickstart.js';
+import { recordCommand } from './commands/record.js';
+import { replayCommand } from './commands/replay.js';
+import { checkpointsCommand, graphCommand, exportCommand, gatewayRunsFor, listCommand, showCommand, uiCommand, } from './commands/inspect.js';
+import { pullCommand, pushCommand } from './commands/sync.js';
+import { compareCommand } from './commands/compare.js';
+import { scrubCommand } from './commands/scrub.js';
+import { gcCommand } from './commands/gc.js';
+import { doctorCommand } from './commands/doctor.js';
+import { modelsCommand, setupCommand } from './commands/setup.js';
+import { withoutCredentials } from '@agenticreplay/proxy';
+import { AGENTICREPLAY_VERSION } from './version.js';
+const HELP = `agenticreplay ${AGENTICREPLAY_VERSION} — record, replay and fork debugger for AI agents
+
+  agenticreplay quickstart                a project, a recorded run and an offline replay of it —
+                                 no key, no agent installed, no network
+        --dir <path>             where to put it (default: ./agenticreplay-quickstart)
+        --full                   the whole timeline and the replay as it happened
+  agenticreplay record <agent>            run an agent and capture supported API traffic
+  agenticreplay attach                    record an agent agenticreplay does not launch — one in a sandbox,
+                                 a container, or on another machine
+        --for <agent>            print the variables that agent reads (default: exec)
+        --bind <addr>            address to listen on (default: 127.0.0.1)
+        --advertise <host>       how the sandbox reaches this machine, when they differ
+        --remote-ca-path <p>     where the CA will live over there (default: /tmp/agenticreplay-ca.crt)
+        --replay <run>           serve a recording back to that agent instead of recording,
+                                 for a run whose agent is not on this machine
+  agenticreplay replay [run]              reproduce a run exactly, network off
+        --quiet                  discard the replayed agent's own output, keep the verdict
+        --ui                     open the timeline when it finishes
+  agenticreplay replay [run] --from N     fork from a checkpoint and continue live
+        --model <id>             continue on a different model
+        --no-fs                  fork the conversation only — do not restore the workspace,
+                                 which a pulled run lacks unless it was pushed with --fs
+  agenticreplay compare [run] --models a,b,c
+                                 fork the same checkpoint onto several models
+        --from N                 checkpoint to fork every model from
+        --verify <cmd>           run this in each fork; its exit code is the verdict
+        --no-fs                  as for replay: fork without the workspace
+        --share [f.svg|png]      write the verdict table as a shareable card
+  agenticreplay show [run]                the timeline, in the terminal
+  agenticreplay checkpoints [run]         where you can fork from
+  agenticreplay graph [run]               what caused what — recorded edges and derived ones
+        --to N                   just the chain that produced event N
+  agenticreplay export [run] -o file.html a single self-contained file you can attach
+        --card [f.svg|png|gif]   one causal chain as a picture, ready to paste
+        --graph-card [f.svg|png] the whole run as a graph, with the chain lit
+        --to N                   which event the card is about (default: the failure)
+  agenticreplay scrub [run] --match X     remove something from a recorded trace
+        --dry-run                say what would go, and write nothing
+        --drop-fs                delete the filesystem snapshots, which cannot be scrubbed
+  agenticreplay ui [run]                  serve the viewer locally
+  agenticreplay push [run]                send a run to the gateway, for the rest of the team
+        --gateway <url>          where to send it (a gateway you named; no default)
+        --fs                     include the workspace snapshots (scrub cannot clean them)
+        --force                  push even though the gateway's scan found a secret
+  agenticreplay pull <run>                fetch a gateway run into this machine's store
+        --gateway <url>          where to fetch from (a gateway you named; no default)
+        --force                  replace a run of the same id already recorded here
+  agenticreplay list                      runs recorded here
+        --remote                 runs held on the gateway instead (a gateway you named)
+        --gateway <url>          with --remote: where to look (a gateway you named)
+        --source gateway|upload  with --remote: what it recorded, or what was pushed
+        --limit N                with --remote: how many (default 20)
+  agenticreplay gc --older-than 7d        reclaim space, forks' scratch worktrees included
+                                 --keep N, --dry-run
+  agenticreplay doctor                    check this machine can record at all
+  agenticreplay setup                     point agenticreplay at a gateway once, to compare many models
+                                 requires an explicit --gateway URL
+        --gateway <url>          origin that serves the model APIs
+        --key <k> | --key-env V  store the key, or read it from an environment variable
+        --models a,b,c           default model list, so compare needs no flags
+  agenticreplay models                    what the configured gateway serves, and what it costs
+
+  [run] is a run id, or "last" (the default).
+
+Flags
+  --loose        on replay, continue live past an unmatched request
+  --in-place     replay against this directory as it stands, restoring nothing
+  --worktree     replay in a scratch copy; never touches your files
+  --no-trace     do not record the exact replay itself as a run of its own
+  --no-fs        skip filesystem capture
+  --no-shell     skip shell capture (PATH shim in front of sh/bash)
+  --no-agent-spans  skip the agent-structure layer (OpenAI Agents SDK)
+  --mcp-config <path>  instrument MCP servers from this config
+  --ci           machine-readable output, no progress
+  --verbose      more detail
+  --no-color     also honours NO_COLOR
+  --port <n>     port for --ui and agenticreplay ui (default: any free port)
+
+A harness that reads no base-URL variable cannot be captured that way at all — a Codex CLI signed
+in with a ChatGPT subscription, a bot with its origin hardcoded, an agent in a language the fetch
+hook cannot reach. Capture those below the agent instead, at the socket:
+
+  agenticreplay record exec --tls-intercept -- <command> [args...]
+
+exec (or "any") launches your command and redirects nothing: no origin and no credential are
+invented, so an agent recorded this way still talks to whoever it was already talking to. It also
+reaches an agent agenticreplay did not launch — record the editor, and the agent it spawns inherits the
+capture.
+
+  --max-body-bytes <n>         capture ceiling per body (default 67108864); overflow fails capture
+  --max-buffered-bytes <n>     aggregate retained-body budget (default 268435456)
+  --tls-intercept              decrypt HTTPS for the hosts below, for this run only
+                               replay and fork turn this back on by themselves, using the
+                               hosts the recording names; --no-tls-intercept refuses
+  --tls-hosts a,b,c            decrypt exactly these, replacing the default list
+  --tls-hosts +a,+b            decrypt these *as well as* the default model API hosts
+                               everything else is tunnelled unread; "*" is refused
+
+  It mints a certificate authority in the run directory, trusts it to the agent through that
+  child's environment alone, and deletes it when the run ends. It installs nothing, anywhere.
+  If a machine is already behind a TLS-inspecting proxy, name its root in AGENTICREPLAY_TLS_UPSTREAM_CA.
+
+Sending traffic somewhere other than the vendor — a gateway, a proxy, a local model — is what
+these two are for. They apply to record, replay, fork and compare alike:
+
+  --upstream-anthropic <url>   origin for /v1/messages       (env AGENTICREPLAY_UPSTREAM_ANTHROPIC)
+  --upstream-openai <url>      origin for /chat/completions  (env AGENTICREPLAY_UPSTREAM_OPENAI)
+
+Everything after -- goes to the agent:
+  agenticreplay record claude -- -p "fix the failing test"
+
+For a script, an agent, or CI — every command below also answers as data:
+
+  --json         one JSON document on stdout, diagnostics on stderr
+                 list · show · events · checkpoints · graph · record · replay · compare
+                 · doctor
+
+  agenticreplay mcp       serve agenticreplay to an agent over MCP on stdio, so it can read its own runs:
+                 {"command": "agenticreplay", "args": ["mcp"]}
+
+Docs: https://github.com/askdkc/AgenticReplay
+`;
+/**
+ * The commands `--json` answers and the terminal does not.
+ *
+ * A set rather than a special case. It holds one name today, and the point of the shape is that
+ * adding a second `--json`-only view does not quietly bring back `agenticreplay events` telling a reader
+ * that a command `--help` had just listed does not exist. `json-only.test.ts` derives the same set
+ * from the two switches in this file and fails when this disagrees with them.
+ */
+const JSON_ONLY = new Set(['events']);
+export async function main(argv, cwd = process.cwd()) {
+    const args = parseArgs(argv);
+    if (args.bool('json'))
+        return jsonMain(args, cwd);
+    // Under `agenticreplay mcp`, stdout is the JSON-RPC transport. A single info line on it corrupts the
+    // stream and the client drops the session with no useful error.
+    const toStderr = args.command === 'mcp';
+    const out = new Output({
+        write: (s) => void (toStderr ? process.stderr : process.stdout).write(s),
+        isTTY: Boolean(process.stdout.isTTY),
+        env: process.env,
+        verbose: args.bool('verbose'),
+        ci: args.bool('ci') || process.env.CI === 'true',
+        // `--no-color` parses to `color: false`. The `true` fallback is what separates that from an
+        // unset flag — `bool('color')` alone returns false for both, which would disable colour for
+        // everyone.
+        ...(args.bool('color', true) ? {} : { color: false }),
+    });
+    if (args.bool('version') || args.command === 'version') {
+        out.plain(AGENTICREPLAY_VERSION);
+        return 0;
+    }
+    if (args.command === 'help' || args.bool('help') || args.bool('h')) {
+        out.plain(HELP);
+        return 0;
+    }
+    try {
+        // Before anything runs: a flag the command does not have is an instruction that would be
+        // silently ignored, and a run that quietly did something else is the failure agenticreplay exists to
+        // surface. Inside the try so it is reported the same way every other failure is.
+        assertKnownFlags(args);
+        // Same reasoning, other half of the command line: an argument nothing reads is an
+        // instruction that went nowhere, and for `record` it is the agent's own arguments.
+        assertNoStrayPositionals(args);
+        switch (args.command) {
+            case 'quickstart':
+                // Non-zero when the demo did not actually happen, so a broken environment is a failure a
+                // script can see rather than a wall of green text that says the opposite.
+                return (await quickstartCommand(args, out, cwd)).ok ? 0 : 1;
+            case 'record':
+                return (await recordCommand(args, out, cwd)).exitCode;
+            case 'attach':
+                return (await attachCommand(args, out, cwd)).exitCode;
+            case 'replay':
+                return (await replayCommand(args, out, cwd)).exitCode;
+            case 'compare':
+                await compareCommand(args, out, cwd);
+                return 0;
+            case 'show':
+                await showCommand(args, out, cwd);
+                return 0;
+            case 'checkpoints':
+                await checkpointsCommand(args, out, cwd);
+                return 0;
+            case 'graph':
+                await graphCommand(args, out, cwd);
+                return 0;
+            case 'export':
+                await exportCommand(args, out, cwd);
+                return 0;
+            case 'push':
+                await pushCommand(args, out, cwd);
+                return 0;
+            case 'pull':
+                await pullCommand(args, out, cwd);
+                return 0;
+            case 'ui':
+                await uiCommand(args, out, cwd);
+                return 0;
+            case 'scrub':
+                await scrubCommand(args, out, cwd);
+                return 0;
+            case 'list':
+                await listCommand(args, out, cwd);
+                return 0;
+            case 'gc':
+                await gcCommand(args, out, cwd);
+                return 0;
+            case 'doctor':
+                // A failed check is the whole point of running this in CI, so it has to be visible in $?.
+                return (await doctorCommand(args, out, cwd)).ok ? 0 : 1;
+            case 'setup':
+                await setupCommand(args, out);
+                return 0;
+            case 'models':
+                await modelsCommand(args, out);
+                return 0;
+            case 'mcp':
+                // stdout is the transport here, so nothing else may touch it: `out` already writes to
+                // stderr under this command, and the server owns the stream until stdin closes.
+                await serveMcp({
+                    agenticreplay: new AgenticReplay({ cwd }),
+                    input: process.stdin,
+                    output: process.stdout,
+                });
+                return 0;
+            default:
+                // `--json` answers one view that the terminal does not, and `--help` lists it beside seven
+                // that it does. A reader scanning that line reasonably types `agenticreplay events`, and being told
+                // there is no such command — by the same tool that had just named it — reads as the CLI
+                // contradicting itself. Name the route instead.
+                if (JSON_ONLY.has(args.command)) {
+                    out.failure({
+                        event: 'json_only_command',
+                        what: `${args.command} answers as data, not as a table`,
+                        why: 'these are the raw trace records; `agenticreplay show` is the same events, rendered',
+                        next: `agenticreplay ${args.command} --json`,
+                    });
+                    return 2;
+                }
+                out.failure({
+                    event: 'unknown_command',
+                    what: `there is no "${args.command}" command`,
+                    next: 'agenticreplay help',
+                });
+                return 2;
+        }
+    }
+    catch (err) {
+        // THE ONE PLACE EVERY COMMAND'S ERROR BECOMES OUTPUT, so it is the one place the credential
+        // has to come out (orcacode-review found push/pull leaking it; setup already wrapped its own
+        // two call sites by hand).
+        //
+        // Per-command wrapping is what let this through: `push`/`pull` were new sinks for a gateway
+        // URL and simply did not do it. A failed fetch reports the URL it was given, so an origin
+        // configured as `https://user:pw@gw` or `https://gw?key=…` — both ordinary, both storable by
+        // `agenticreplay setup` — arrives inside undici's exception text ("Request cannot be constructed from
+        // a URL that includes credentials: …") and lands in the terminal and in the CI log.
+        //
+        // out.ts's own guard cannot catch it: that guard is shape-based and applies to `#line` field
+        // names, and an arbitrary password matches no pattern. Sanitising here covers every existing
+        // command and every future one, and is idempotent with setup.ts's hand-wrapping.
+        //
+        // The stack goes through it too: err.stack embeds the same message.
+        const message = withoutCredentials(err instanceof Error ? err.message : String(err));
+        const [first, ...rest] = message.split('\n');
+        out.failure({
+            event: `${args.command}.failed`,
+            what: first ?? message,
+            why: rest.join('\n').trim() || undefined,
+        });
+        if (out.isVerbose && err instanceof Error && err.stack)
+            out.plain(withoutCredentials(err.stack));
+        return 1;
+    }
+}
+/**
+ * `--json`: one JSON document on stdout, diagnostics on stderr.
+ *
+ * The split is the whole design. A caller wants the answer, so stdout is one document rather than
+ * a stream of log objects — `agenticreplay show last --json | jq .events` works with nothing in front of
+ * it. And a run that warns must not corrupt that document, so every `info`/`warn` line goes to
+ * stderr, where a human still reads it and a parser never sees it.
+ *
+ * Failures come back as JSON too. An agent that only handles the happy path is an agent that
+ * hangs on the first bad run, so an error is a document with an `error` key and a non-zero exit,
+ * never prose.
+ */
+async function jsonMain(args, cwd) {
+    const out = new Output({
+        // Diagnostics only. Nothing here may reach stdout.
+        write: (s) => void process.stderr.write(s),
+        env: process.env,
+        verbose: args.bool('verbose'),
+        ci: true,
+        color: false,
+    });
+    const emit = (doc) => void process.stdout.write(`${JSON.stringify(doc)}\n`);
+    try {
+        // THE SAME TWO CHECKS THE PLAIN PATH MAKES, for the reason stated there: a flag the command
+        // does not have is an instruction that would be silently ignored. `--json` is a second sink
+        // for the same command, not a different command — and it returned above before either check
+        // ran, so `agenticreplay show --worktre --json` did the opposite of what was typed and said nothing
+        // about it, which is the failure the plain path exists to surface.
+        assertKnownFlags(args);
+        assertNoStrayPositionals(args);
+        const agenticreplay = new AgenticReplay({ cwd });
+        const selector = args.positionals[0] ?? 'last';
+        switch (args.command) {
+            case 'list':
+                // `--remote` asks the gateway, here as much as on the terminal. It used to be dropped:
+                // `agenticreplay list --remote --json` ran the LOCAL listing and emitted `[]` from a directory
+                // with no runs — telling a script the gateway holds nothing while the same command
+                // without `--json` printed what it holds. A silent wrong answer, to the reader least
+                // able to notice.
+                emit(args.bool('remote') ? await gatewayRunsFor(args, out) : await agenticreplay.list());
+                return 0;
+            case 'show':
+                emit(await agenticreplay.show(selector));
+                return 0;
+            case 'events':
+                emit(await agenticreplay.events(selector));
+                return 0;
+            case 'checkpoints':
+                emit(await agenticreplay.checkpoints(selector));
+                return 0;
+            case 'graph':
+                emit(await agenticreplay.graph(selector, {
+                    ...(args.num('to') === undefined ? {} : { to: args.num('to') }),
+                }));
+                return 0;
+            case 'attach': {
+                const result = await attachCommand(args, out, cwd);
+                emit(result);
+                return result.exitCode;
+            }
+            case 'record': {
+                const result = await recordCommand(args, out, cwd);
+                emit(result);
+                return result.exitCode;
+            }
+            case 'replay': {
+                const result = await replayCommand(args, out, cwd);
+                emit(result);
+                return result.exitCode;
+            }
+            case 'compare':
+                emit(await compareCommand(args, out, cwd));
+                return 0;
+            case 'doctor': {
+                const result = await doctorCommand(args, out, cwd);
+                emit(result);
+                return result.ok ? 0 : 1;
+            }
+            default:
+                emit({
+                    error: {
+                        message: `--json does not cover '${args.command}'`,
+                        // Naming what it does cover beats making someone try them one at a time.
+                        supported: [
+                            'list',
+                            'show',
+                            'events',
+                            'checkpoints',
+                            'graph',
+                            'record',
+                            'replay',
+                            'compare',
+                            'doctor',
+                        ],
+                    },
+                });
+                return 2;
+        }
+    }
+    catch (err) {
+        // Same reasoning as the plain-output catch above: --json is a second sink for the same text,
+        // and a CI job is exactly where it gets captured and kept.
+        emit({
+            error: { message: withoutCredentials(err instanceof Error ? err.message : String(err)) },
+        });
+        return 1;
+    }
+}
+//# sourceMappingURL=main.js.map

package/packages/cli/dist/main.js.map

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