screencast-axi 0.1.0

package/dist/src/commands/guide.js

@@ -0,0 +1,257 @@
+import { ScreencastError } from "../errors.js";
+import { parseFlags } from "../flags.js";
+const TOPICS = {
+    overview: {
+        summary: "What this tool does, and what is built so far",
+        body: [
+            "screencast-axi records a scripted browser workflow as a watchable clip:",
+            "a scenario is a TypeScript file that drives Playwright through a flow,",
+            "and the recorder overlays a synthetic cursor and captions, then encodes",
+            "the capture to mp4, webm and a poster image.",
+            "",
+            "The loop is: `init` sets up a project, `scaffold` writes a skeleton, you",
+            "fill in the run() body, `rehearse` proves the selectors without",
+            "encoding, and `record` shoots the real take and writes the manifest.",
+            "",
+            "`list` and `show` say what exists, `check` cross-references the manifest",
+            "against the scenarios and the files, and `doctor` checks everything a",
+            "recording needs in one pass - run it first if a take fails before its",
+            "own steps.",
+            "",
+            "For a page behind a login, see `guide auth`: a person signs in by hand",
+            "once and every take afterwards reuses the session.",
+        ],
+    },
+    encoding: {
+        summary: "Output formats, why not GIF, and what has to be installed",
+        body: [
+            "Every take produces an mp4 (h264, faststart), a webm (VP9) and a poster",
+            "image. GIF is opt-in and is an export, not a storage format.",
+            "",
+            "Measured on a real 16.7s app screencast, all at 800px wide and 15fps:",
+            "  mp4 (h264)              182 KB",
+            "  animated WebP (q55)     944 KB   5.2x",
+            "  animated WebP (q70)   1,875 KB  10.3x",
+            "  GIF (192 colours)     2,034 KB  11.2x",
+            "The source mp4 at full 1280px and 30fps is 471 KB - still 4.3x smaller",
+            "than the GIF at half the resolution and half the frame rate.",
+            "",
+            "Quality is not the deciding factor for flat app UI: 192 colours plus",
+            "dithering keeps small text legible. Size and capability are. A GIF has",
+            "no controls, no seeking, no poster frame, cannot be paused, and ignores",
+            "prefers-reduced-motion. Reach for it only where video does not render -",
+            "an npm README, an email - and prefer <video autoplay muted loop",
+            "playsinline> everywhere else.",
+            "",
+            "ffmpeg is required and is not bundled: it is 80MB+ per platform, and",
+            "which build you have matters. Many builds - Homebrew's among them - ship",
+            "without libwebp, so the poster falls back from ffmpeg to cwebp to PNG.",
+            "A missing WebP encoder costs you file size, never a recording.",
+            "",
+            "ffmpeg is looked up in this order: $SCREENCAST_FFMPEG, then an installed",
+            "`ffmpeg-static` (add it as a dev dependency if you would rather not",
+            "install ffmpeg system-wide), then PATH.",
+        ],
+    },
+    mobile: {
+        summary: "Recording a phone or tablet viewport",
+        body: [
+            "Use a Playwright device preset rather than a bare size:",
+            '  screencast-axi record tour --device "iPhone 13" --orientation portrait',
+            "",
+            "A preset does more than set a width. Its isMobile and hasTouch flags",
+            "decide whether the site's own @media (hover: none) and touch rules apply",
+            "at all, and it carries the right user agent - so this is the mobile",
+            "layout the site actually serves, not a desktop squeezed narrow.",
+            "",
+            "The video is captured at the CSS viewport, so a phone clip is 390x664",
+            "rather than the 1170x1992 the device would render at. That is a",
+            "Playwright limit, not a setting: it composites the page into the video",
+            "canvas without scaling up, so asking for more just leaves empty space",
+            "around the page. deviceScaleFactor still affects how the page renders",
+            "and which images it picks, but not the resolution of the recording.",
+            "",
+            "Playwright ships 140+ presets; the names are its own and are",
+            "case-sensitive. `--viewport 390x844` works when no preset fits.",
+        ],
+    },
+    duration: {
+        summary: "Aiming a clip at a length",
+        body: [
+            "  screencast-axi record tour --duration 30s",
+            "",
+            "The recorder runs one measuring pass without encoding, then solves for",
+            "the pace that lands near the target and shoots the real take. Accepts",
+            "30s, 1m30s, or a bare number of seconds.",
+            "",
+            "A take is `fixed + pace x scalable`: every pause the recorder controls",
+            "scales, and the site's own waits - navigation, network, animation - do",
+            "not, because slowing the recorder down does not slow the site down. The",
+            "measuring pass reports both halves, so the solve is exact rather than an",
+            "assumption that everything scales.",
+            "",
+            "After navigating, the recorder waits up to 2.5s for the network to go",
+            "quiet, then carries on. That ceiling matters: plenty of real sites never",
+            "go quiet at all - analytics, websockets, polling - and every second",
+            "spent waiting is recorded into the clip. Raise it with",
+            "`timeouts.settleMs` if a site genuinely needs longer.",
+            "",
+            "Pace is clamped to 0.4-2.5. Outside that a clip stops being watchable,",
+            "so a target that needs more is reported rather than obeyed: the honest",
+            "answer is that the scenario has too much or too little in it for the",
+            "length you asked for.",
+        ],
+    },
+    tour: {
+        summary: "Multi-page walkthroughs",
+        body: [
+            "`d.tour(stops)` is the shape most walkthrough requests have. Each stop",
+            "navigates, narrates, dwells, and optionally scrolls:",
+            "",
+            "  await d.tour([",
+            '    { path: "/",        step: 0, scroll: 0.6 },',
+            '    { path: "/pricing", step: 1, scroll: 0.5 },',
+            '    { path: "/docs",    step: 2 },',
+            "  ]);",
+            "",
+            "`step` indexes the scenario's `steps`. `scroll` of 1 or less is a share",
+            "of the viewport, so it reads the same on a phone and a desktop; larger",
+            "values are pixels. `waitFor` holds the narration until something is on",
+            "screen, so a slow page does not get a jump cut.",
+            "",
+            "Paths resolve the way URLs do, not the way you might hope: with a",
+            'baseUrl of `https://site.com/app/`, `goto("/")` goes to the origin and',
+            "drops the `/app/`. Keep baseUrl to the origin and put the path in the",
+            "goto. (The failure output names the URL it actually reached, so this is",
+            "a fast one to spot.)",
+            "",
+            "`screencast-axi scaffold <id> --tour 5` writes the whole skeleton.",
+            "Every pause is pace-scaled, so --duration re-cuts a tour untouched.",
+        ],
+    },
+    auth: {
+        summary: "Recording a page that is behind a login",
+        body: [
+            "The default is signed out. For anything behind a login, the strategy",
+            "that needs no code for the site you are recording is `profileAuth()`:",
+            "",
+            "  // screencast.config.ts",
+            '  browser: { profileDir: ".screencast/profile" },',
+            '  auth: profileAuth({ signedInSelector: "[data-testid=user-menu]" }),',
+            "",
+            "Then a person runs, once, in their own terminal:",
+            "  npx -y screencast-axi auth login --interactive",
+            "A browser opens, they sign in however that site wants - OAuth, SSO, a",
+            "magic link, two-factor - and close the window. The session lives in the",
+            "profile and every take reuses it. No credential is handled by this tool.",
+            "",
+            "`auth login` never reads stdin, so an agent can open the window on the",
+            "user's screen rather than making them retype a command. It cannot hang:",
+            "the wait is bounded (--wait, default 5m) and it refuses up front where",
+            "no window could appear, such as a headless box with no display.",
+            "Without --interactive it refuses with NEEDS_HUMAN, so an agent that",
+            "reaches for it without meaning to involve a person is told to.",
+            "",
+            "Also shipped: `storageStateAuth({ path })` for a portable session file",
+            "(CI-friendly, but needs an isolated context so it cannot be combined",
+            "with profileDir), and `basicAuth({ username, password })` for staging",
+            "environments. Anything else is an `AuthStrategy` object written in the",
+            "config, which is typed and debuggable.",
+            "",
+            "Set `signedInSelector` or `signedInCookie`. Without one nothing is",
+            'verified, and "the URL is not /login" is a false pass - a build-error',
+            "page satisfies it too.",
+            "",
+            "Recording a live production site: a scenario that creates or drags",
+            "something writes to production. Prefer read-only scenarios there, or",
+            "point at staging. The profile holds a real session, so gitignore it.",
+        ],
+    },
+    watching: {
+        summary: "Seeing what a scenario does before trusting it",
+        body: [
+            "A scenario is arbitrary code driving a real browser, often one signed",
+            "into your own account. Two ways to see what it does:",
+            "",
+            "  screencast-axi rehearse <id>            prints every action it took",
+            "  screencast-axi rehearse <id> --headed   and shows you it happening",
+            "",
+            "`--headed` opens a real Chrome window instead of running hidden. It",
+            "works on `record` too and does not change the output - the clip is",
+            "identical either way - so it costs nothing but the window.",
+            "",
+            "A rehearsal always prints `performed`: every goto, click, typed value,",
+            "drag and scroll, in order, with timings. It also prints `hosts`, which",
+            "is the short answer to where the script went - a list of one host reads",
+            "very differently from a list of nine. `record` prints the same with",
+            "`--full`.",
+            "",
+            "Reading the log beats watching for anything you plan to run more than",
+            "once: it can be diffed after an edit, and it does not need you sitting",
+            "there. Watching is the better first look at a script someone else wrote.",
+            "",
+            "Nothing is recorded before `run()` starts, so a sign-in and any setup",
+            "are outside the clip.",
+        ],
+    },
+    overlay: {
+        summary: "The synthetic cursor, captions and drag ghost, and how to theme them",
+        body: [
+            "Playwright's video contains no mouse pointer, which makes any clip of a",
+            "click or a drag unreadable. The recorder injects an overlay that draws a",
+            "pointer following the real one, a click ripple, a drag ghost and a",
+            "caption bar - all inside a shadow root, so no page CSS can reach them.",
+            "",
+            "Everything is themeable: accent colour, pointer shape, caption position,",
+            "typography and fade. `hideSelectors` removes page chrome that should not",
+            "appear in footage - a framework error badge, a cookie banner, a staging",
+            "ribbon.",
+            "",
+            "The overlay re-mounts itself if the page replaces its document, because",
+            "that detaches the overlay while leaving its API in place. Without the",
+            "recovery, captions would stop appearing and the take would keep",
+            "recording as though nothing were wrong.",
+        ],
+    },
+};
+/** No flags: it takes a topic and nothing else. */
+export const GUIDE_FLAGS = {};
+export function guideCommand(args) {
+    // No flags of its own, but it still goes through the parser so an unknown
+    // flag is rejected here exactly as it is everywhere else.
+    const { positionals } = parseFlags(args, GUIDE_FLAGS);
+    const [topic, ...rest] = positionals;
+    if (rest.length > 0) {
+        throw new ScreencastError(`Unexpected argument: ${rest[0]}`, "VALIDATION_ERROR", [
+            "Run `screencast-axi guide <topic>` with a single topic",
+            "Run `screencast-axi guide` to list the topics",
+        ]);
+    }
+    if (!topic) {
+        return {
+            topics: Object.entries(TOPICS).map(([name, t]) => ({ topic: name, summary: t.summary })),
+            help: ["Run `screencast-axi guide overview` to start"],
+        };
+    }
+    const found = TOPICS[topic];
+    if (!found) {
+        throw new ScreencastError(`Unknown guide topic: ${topic}`, "VALIDATION_ERROR", [
+            `Available topics: ${Object.keys(TOPICS).join(", ")}`,
+            "Run `screencast-axi guide` to list them with summaries",
+        ]);
+    }
+    return { topic, summary: found.summary, guidance: found.body.join("\n") };
+}
+export function guideHelp() {
+    return `${[
+        `command: guide`,
+        `description: Topic-sized guidance, pulled one topic at a time`,
+        ``,
+        `usage:`,
+        `  screencast-axi guide           List the available topics`,
+        `  screencast-axi guide <topic>   Print one topic`,
+        ``,
+        `topics: ${Object.keys(TOPICS).join(", ")}`,
+    ].join("\n")}\n`;
+}
+//# sourceMappingURL=guide.js.map

package/dist/src/commands/guide.js.map

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

package/dist/src/commands/home.d.ts

@@ -0,0 +1,12 @@
+import type { AxiStructuredOutput } from "../output.js";
+/**
+ * The no-argument view: live data, never help text (AXI principle 8).
+ *
+ * `status` is the aggregate worth pre-computing. Deriving it otherwise means
+ * reading the manifest, listing the output directory and diffing both against
+ * the scenario list - three round trips to answer the question anyone actually
+ * has, which is "what do I need to re-shoot".
+ *
+ * The SDK prepends `{ bin, description }`, so this returns only the state.
+ */
+export declare function homeView(): Promise<AxiStructuredOutput>;

package/dist/src/commands/home.js

@@ -0,0 +1,78 @@
+import { readManifest } from "../manifest.js";
+import { loadConfig, loadScenarios } from "../config.js";
+/**
+ * The no-argument view: live data, never help text (AXI principle 8).
+ *
+ * `status` is the aggregate worth pre-computing. Deriving it otherwise means
+ * reading the manifest, listing the output directory and diffing both against
+ * the scenario list - three round trips to answer the question anyone actually
+ * has, which is "what do I need to re-shoot".
+ *
+ * The SDK prepends `{ bin, description }`, so this returns only the state.
+ */
+export async function homeView() {
+    const config = await loadConfig().catch(() => null);
+    if (!config) {
+        return {
+            config: "none",
+            scenarios: [],
+            totals: "0 scenarios",
+            help: [
+                "Create one: `screencast-axi scaffold <id> --url <url>`",
+                "Run `screencast-axi guide` for topic-sized guidance",
+            ],
+        };
+    }
+    const loaded = await loadScenarios(config).catch(() => []);
+    const { entries } = readManifest(config.outDir);
+    const byId = new Map(entries.map((e) => [e.id, e]));
+    const rows = loaded.map(({ scenario }) => {
+        const entry = byId.get(scenario.id);
+        const status = !entry
+            ? "never-recorded"
+            : entry.stepsHash && entry.steps?.join("\u0000") !== scenario.steps?.join("\u0000")
+                ? "stale"
+                : "recorded";
+        return {
+            id: scenario.id,
+            status,
+            steps: scenario.steps?.length ?? 0,
+            duration_s: entry ? Number((entry.durationMs / 1000).toFixed(1)) : 0,
+        };
+    });
+    const counts = rows.reduce((acc, r) => ({ ...acc, [r.status]: acc[r.status] + 1 }), { recorded: 0, stale: 0, "never-recorded": 0 });
+    const orphans = entries.filter((e) => !loaded.some((l) => l.scenario.id === e.id));
+    return {
+        config: config.configPath ?? "none",
+        out: config.outDir,
+        scenarios: rows,
+        totals: rows.length === 0
+            ? "0 scenarios"
+            : `${rows.length} scenarios, ${counts.recorded} recorded, ${counts.stale} stale, ${counts["never-recorded"]} never-recorded`,
+        ...(orphans.length > 0 ? { orphaned: orphans.map((o) => o.id) } : {}),
+        help: buildHelp(rows, orphans.length),
+    };
+}
+function buildHelp(rows, orphans) {
+    if (rows.length === 0) {
+        return [
+            "No scenarios found. Create one: `screencast-axi scaffold <id> --url <url>`",
+            "A scenario can also be recorded straight from a path, with no config",
+        ];
+    }
+    const help = [];
+    const stale = rows.find((r) => r.status === "stale");
+    const never = rows.find((r) => r.status === "never-recorded");
+    if (stale) {
+        help.push(`\`screencast-axi record ${stale.id}\` - its narration changed since the clip was shot`);
+    }
+    if (never) {
+        help.push(`\`screencast-axi record ${never.id}\` - never recorded`);
+    }
+    if (orphans > 0) {
+        help.push(`${orphans} clip(s) in the output directory have no scenario any more`);
+    }
+    help.push("Iterate with `rehearse` rather than `record`: it skips the encode");
+    return help;
+}
+//# sourceMappingURL=home.js.map

package/dist/src/commands/home.js.map

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

package/dist/src/commands/list.d.ts

@@ -0,0 +1,6 @@
+import { type FlagSpecs } from "../flags.js";
+import type { AxiStructuredOutput } from "../output.js";
+export declare const LIST_FLAGS: FlagSpecs;
+export declare const SHOW_FLAGS: FlagSpecs;
+export declare function listCommand(args: string[]): Promise<AxiStructuredOutput>;
+export declare function showCommand(args: string[]): Promise<AxiStructuredOutput>;

package/dist/src/commands/list.js

@@ -0,0 +1,128 @@
+import { statSync } from "node:fs";
+import { relative } from "node:path";
+import { loadConfig } from "../config.js";
+import { buildInventory, filesOf, summarise } from "../inventory.js";
+import { parseFlags } from "../flags.js";
+import { ScreencastError } from "../errors.js";
+export const LIST_FLAGS = {
+    config: { kind: "string", description: "Path to a config file", placeholder: "path" },
+    full: { kind: "boolean", description: "Every field, not the four-column summary" },
+    stale: { kind: "boolean", description: "Only what needs re-shooting" },
+    tag: { kind: "string", description: "Filter by scenario tag", placeholder: "name", repeat: true },
+};
+export const SHOW_FLAGS = {
+    config: { kind: "string", description: "Path to a config file", placeholder: "path" },
+    full: { kind: "boolean", description: "Include untruncated step text" },
+};
+function needsWork(row) {
+    return row.status !== "recorded";
+}
+export async function listCommand(args) {
+    const { flags } = parseFlags(args, LIST_FLAGS);
+    const config = await loadConfig(flags["config"]);
+    const inventory = await buildInventory(config);
+    const full = flags["full"] === true;
+    const rows = flags["stale"] === true ? inventory.rows.filter(needsWork) : inventory.rows;
+    if (rows.length === 0) {
+        // Principle 5: an explicit nothing, never a blank list.
+        return {
+            scenarios: [],
+            totals: flags["stale"] === true ? "0 scenarios need re-shooting" : "0 scenarios",
+            help: inventory.rows.length === 0
+                ? ["Create one: `screencast-axi scaffold <id> --url <url>`"]
+                : ["Everything is up to date. `screencast-axi list` shows them all"],
+        };
+    }
+    return {
+        out: config.outDir,
+        scenarios: rows.map((r) => ({
+            id: r.id,
+            status: r.status,
+            steps: r.steps,
+            duration_s: Number((r.durationMs / 1000).toFixed(1)),
+            ...(full
+                ? {
+                    title: r.title,
+                    file: relative(process.cwd(), r.file),
+                    ...(r.staleReason ? { why: r.staleReason } : {}),
+                    ...(r.missing.length > 0 ? { missing: r.missing } : {}),
+                    ...(r.entry?.recordedAt ? { recorded: r.entry.recordedAt } : {}),
+                }
+                : {}),
+        })),
+        totals: summarise(inventory),
+        ...(inventory.orphans.length > 0 ? { orphaned: inventory.orphans.map((o) => o.id) } : {}),
+        help: buildHelp(inventory, full),
+    };
+}
+function buildHelp(inventory, full) {
+    const help = [];
+    const first = inventory.rows.find(needsWork);
+    if (first) {
+        const why = first.status === "incomplete"
+            ? `is missing ${first.missing.join(", ")}`
+            : first.status === "stale"
+                ? `is stale - its ${first.staleReason}`
+                : "has never been recorded";
+        help.push(`\`screencast-axi record ${first.id}\` - it ${why}`);
+    }
+    if (inventory.orphans.length > 0) {
+        help.push("`screencast-axi check` explains the orphaned entries");
+    }
+    if (!full)
+        help.push("Add `--full` for titles, file paths and recording dates");
+    if (help.length === 0)
+        help.push("Everything is recorded and current");
+    return help;
+}
+export async function showCommand(args) {
+    const { positionals, flags } = parseFlags(args, SHOW_FLAGS);
+    const id = positionals[0];
+    const config = await loadConfig(flags["config"]);
+    const inventory = await buildInventory(config);
+    if (!id) {
+        throw new ScreencastError("Name a scenario", "VALIDATION_ERROR", [
+            "Run `screencast-axi show <id>`",
+            inventory.rows.length > 0
+                ? `This config has: ${inventory.rows.map((r) => r.id).join(", ")}`
+                : "No scenarios are configured yet",
+        ]);
+    }
+    const row = inventory.rows.find((r) => r.id === id);
+    if (!row) {
+        const orphan = inventory.orphans.find((o) => o.id === id);
+        throw new ScreencastError(`Unknown scenario: ${id}`, "UNKNOWN_SCENARIO", [
+            orphan
+                ? `\`${id}\` is in the manifest but has no scenario any more - see \`screencast-axi check\``
+                : `This config has: ${inventory.rows.map((r) => r.id).join(", ") || "nothing"}`,
+        ]);
+    }
+    const files = filesOf(row, config.outDir).map((f) => ({
+        file: f,
+        kb: Math.round(statSync(f).size / 1024),
+    }));
+    return {
+        id: row.id,
+        title: row.title,
+        status: row.status,
+        ...(row.staleReason ? { why: row.staleReason } : {}),
+        scenario: relative(process.cwd(), row.file),
+        ...(row.entry
+            ? {
+                description: row.entry.description,
+                duration_s: Number((row.entry.durationMs / 1000).toFixed(1)),
+                size: `${row.entry.width}x${row.entry.height}`,
+                recorded: row.entry.recordedAt,
+                ...(row.entry.device ? { device: row.entry.device } : {}),
+                ...(row.entry.pace !== undefined ? { pace: row.entry.pace } : {}),
+            }
+            : {}),
+        ...(row.entry?.steps ? { steps: row.entry.steps } : {}),
+        ...(files.length > 0 ? { files } : {}),
+        ...(row.missing.length > 0 ? { missing: row.missing } : {}),
+        help: row.status === "recorded"
+            ? [`\`screencast-axi record ${row.id}\` re-shoots it`]
+            : [`\`screencast-axi rehearse ${row.id}\` first, then \`record ${row.id}\``],
+    };
+}
+//# sourceMappingURL=list.js.map

package/dist/src/commands/list.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"list.js","sourceRoot":"","sources":["../../../src/commands/list.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,SAAS,CAAC;AACnC,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAC;AACrC,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAC;AAC1C,OAAO,EAAE,cAAc,EAAE,OAAO,EAAE,SAAS,EAAqB,MAAM,iBAAiB,CAAC;AACxF,OAAO,EAAE,UAAU,EAAkB,MAAM,aAAa,CAAC;AAEzD,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAE/C,MAAM,CAAC,MAAM,UAAU,GAAc;IACnC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,EAAE;IACrF,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,0CAA0C,EAAE;IAClF,KAAK,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,6BAA6B,EAAE;IACtE,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,wBAAwB,EAAE,WAAW,EAAE,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE;CAClG,CAAC;AAEF,MAAM,CAAC,MAAM,UAAU,GAAc;IACnC,MAAM,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,WAAW,EAAE,uBAAuB,EAAE,WAAW,EAAE,MAAM,EAAE;IACrF,IAAI,EAAE,EAAE,IAAI,EAAE,SAAS,EAAE,WAAW,EAAE,+BAA+B,EAAE;CACxE,CAAC;AAEF,SAAS,SAAS,CAAC,GAAiB;IAClC,OAAO,GAAG,CAAC,MAAM,KAAK,UAAU,CAAC;AACnC,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAuB,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,IAAI,GAAG,KAAK,CAAC,MAAM,CAAC,KAAK,IAAI,CAAC;IAEpC,MAAM,IAAI,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,IAAI,CAAC;IAEzF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACtB,wDAAwD;QACxD,OAAO;YACL,SAAS,EAAE,EAAE;YACb,MAAM,EAAE,KAAK,CAAC,OAAO,CAAC,KAAK,IAAI,CAAC,CAAC,CAAC,8BAA8B,CAAC,CAAC,CAAC,aAAa;YAChF,IAAI,EACF,SAAS,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC;gBACzB,CAAC,CAAC,CAAC,wDAAwD,CAAC;gBAC5D,CAAC,CAAC,CAAC,gEAAgE,CAAC;SACzE,CAAC;IACJ,CAAC;IAED,OAAO;QACL,GAAG,EAAE,MAAM,CAAC,MAAM;QAClB,SAAS,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;YAC1B,EAAE,EAAE,CAAC,CAAC,EAAE;YACR,MAAM,EAAE,CAAC,CAAC,MAAM;YAChB,KAAK,EAAE,CAAC,CAAC,KAAK;YACd,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;YACpD,GAAG,CAAC,IAAI;gBACN,CAAC,CAAC;oBACE,KAAK,EAAE,CAAC,CAAC,KAAK;oBACd,IAAI,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC;oBACrC,GAAG,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBAChD,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;oBACvD,GAAG,CAAC,CAAC,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;iBACjE;gBACH,CAAC,CAAC,EAAE,CAAC;SACR,CAAC,CAAC;QACH,MAAM,EAAE,SAAS,CAAC,SAAS,CAAC;QAC5B,GAAG,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,SAAS,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzF,IAAI,EAAE,SAAS,CAAC,SAAS,EAAE,IAAI,CAAC;KACjC,CAAC;AACJ,CAAC;AAED,SAAS,SAAS,CAAC,SAAqD,EAAE,IAAa;IACrF,MAAM,IAAI,GAAa,EAAE,CAAC;IAC1B,MAAM,KAAK,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;IAC7C,IAAI,KAAK,EAAE,CAAC;QACV,MAAM,GAAG,GACP,KAAK,CAAC,MAAM,KAAK,YAAY;YAC3B,CAAC,CAAC,cAAc,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;YAC1C,CAAC,CAAC,KAAK,CAAC,MAAM,KAAK,OAAO;gBACxB,CAAC,CAAC,kBAAkB,KAAK,CAAC,WAAW,EAAE;gBACvC,CAAC,CAAC,yBAAyB,CAAC;QAClC,IAAI,CAAC,IAAI,CAAC,2BAA2B,KAAK,CAAC,EAAE,WAAW,GAAG,EAAE,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,SAAS,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,IAAI,CAAC,IAAI,CAAC,sDAAsD,CAAC,CAAC;IACpE,CAAC;IACD,IAAI,CAAC,IAAI;QAAE,IAAI,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAChF,IAAI,IAAI,CAAC,MAAM,KAAK,CAAC;QAAE,IAAI,CAAC,IAAI,CAAC,oCAAoC,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,IAAc;IAC9C,MAAM,EAAE,WAAW,EAAE,KAAK,EAAE,GAAG,UAAU,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;IAC5D,MAAM,EAAE,GAAG,WAAW,CAAC,CAAC,CAAC,CAAC;IAE1B,MAAM,MAAM,GAAG,MAAM,UAAU,CAAC,KAAK,CAAC,QAAQ,CAAuB,CAAC,CAAC;IACvE,MAAM,SAAS,GAAG,MAAM,cAAc,CAAC,MAAM,CAAC,CAAC;IAE/C,IAAI,CAAC,EAAE,EAAE,CAAC;QACR,MAAM,IAAI,eAAe,CAAC,iBAAiB,EAAE,kBAAkB,EAAE;YAC/D,gCAAgC;YAChC,SAAS,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC;gBACvB,CAAC,CAAC,oBAAoB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE;gBAClE,CAAC,CAAC,iCAAiC;SACtC,CAAC,CAAC;IACL,CAAC;IAED,MAAM,GAAG,GAAG,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;IACpD,IAAI,CAAC,GAAG,EAAE,CAAC;QACT,MAAM,MAAM,GAAG,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;QAC1D,MAAM,IAAI,eAAe,CAAC,qBAAqB,EAAE,EAAE,EAAE,kBAAkB,EAAE;YACvE,MAAM;gBACJ,CAAC,CAAC,KAAK,EAAE,mFAAmF;gBAC5F,CAAC,CAAC,oBAAoB,SAAS,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE;SAClF,CAAC,CAAC;IACL,CAAC;IAED,MAAM,KAAK,GAAG,OAAO,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACpD,IAAI,EAAE,CAAC;QACP,EAAE,EAAE,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,IAAI,GAAG,IAAI,CAAC;KACxC,CAAC,CAAC,CAAC;IAEJ,OAAO;QACL,EAAE,EAAE,GAAG,CAAC,EAAE;QACV,KAAK,EAAE,GAAG,CAAC,KAAK;QAChB,MAAM,EAAE,GAAG,CAAC,MAAM;QAClB,GAAG,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,GAAG,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpD,QAAQ,EAAE,QAAQ,CAAC,OAAO,CAAC,GAAG,EAAE,EAAE,GAAG,CAAC,IAAI,CAAC;QAC3C,GAAG,CAAC,GAAG,CAAC,KAAK;YACX,CAAC,CAAC;gBACE,WAAW,EAAE,GAAG,CAAC,KAAK,CAAC,WAAW;gBAClC,UAAU,EAAE,MAAM,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC,UAAU,GAAG,IAAI,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC;gBAC5D,IAAI,EAAE,GAAG,GAAG,CAAC,KAAK,CAAC,KAAK,IAAI,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE;gBAC9C,QAAQ,EAAE,GAAG,CAAC,KAAK,CAAC,UAAU;gBAC9B,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,GAAG,CAAC,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;gBACzD,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,IAAI,EAAE,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;aAClE;YACH,CAAC,CAAC,EAAE,CAAC;QACP,GAAG,CAAC,GAAG,CAAC,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACvD,GAAG,CAAC,KAAK,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtC,GAAG,CAAC,GAAG,CAAC,OAAO,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,GAAG,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC3D,IAAI,EACF,GAAG,CAAC,MAAM,KAAK,UAAU;YACvB,CAAC,CAAC,CAAC,2BAA2B,GAAG,CAAC,EAAE,iBAAiB,CAAC;YACtD,CAAC,CAAC,CAAC,6BAA6B,GAAG,CAAC,EAAE,2BAA2B,GAAG,CAAC,EAAE,IAAI,CAAC;KACjF,CAAC;AACJ,CAAC"}

package/dist/src/commands/record.d.ts

@@ -0,0 +1,7 @@
+import { type FlagSpecs } from "../flags.js";
+import type { AxiStructuredOutput } from "../output.js";
+import { ScenarioFailure, type RunMode } from "../run.js";
+export declare const RECORD_FLAGS: FlagSpecs;
+export declare const REHEARSE_FLAGS: FlagSpecs;
+export declare function recordCommand(args: string[], mode: RunMode): Promise<AxiStructuredOutput>;
+export { ScenarioFailure };