agent-screenplay 0.0.0-stage → 0.1.0

package/dist/scenario/config.d.ts

@@ -0,0 +1,43 @@
+import { z } from "zod";
+import { Style } from "./schema.js";
+/**
+ * A project's shared settings: `screenplay.config.json`, found in the scenario's
+ * directory or the nearest parent. Its style applies to every video below it; a
+ * scenario's own `style` wins, setting by setting.
+ */
+export declare const CONFIG_FILE = "screenplay.config.json";
+export declare const ProjectConfig: z.ZodObject<{
+    $schema: z.ZodOptional<z.ZodString>;
+    style: z.ZodOptional<z.ZodObject<{
+        background: z.ZodOptional<z.ZodUnion<readonly [z.ZodString, z.ZodObject<{
+            gradient: z.ZodArray<z.ZodString>;
+            angle: z.ZodOptional<z.ZodNumber>;
+        }, z.core.$strict>]>>;
+        padding: z.ZodOptional<z.ZodNumber>;
+        radius: z.ZodOptional<z.ZodNumber>;
+        shadow: z.ZodOptional<z.ZodBoolean>;
+        cursor: z.ZodOptional<z.ZodEnum<{
+            dot: "dot";
+            macos: "macos";
+            none: "none";
+        }>>;
+        cursorSize: z.ZodOptional<z.ZodNumber>;
+        maxZoom: z.ZodOptional<z.ZodNumber>;
+        autoZoom: z.ZodOptional<z.ZodBoolean>;
+        captions: z.ZodOptional<z.ZodBoolean>;
+        accent: z.ZodOptional<z.ZodString>;
+        frame: z.ZodOptional<z.ZodEnum<{
+            browser: "browser";
+            none: "none";
+        }>>;
+    }, z.core.$strict>>;
+}, z.core.$strict>;
+export type ProjectConfig = z.infer<typeof ProjectConfig>;
+export declare function findProjectConfig(dir: string): string | undefined;
+export declare function readProjectConfig(file: string): ProjectConfig;
+/** True when a background value names an image file rather than a preset or a color. */
+export declare function isImagePath(bg: unknown, presets: readonly string[]): bg is string;
+/** Make an image background absolute, so it still resolves once merged into a scenario elsewhere. */
+export declare function absolutizeStyle(style: Style | undefined, baseDir: string, presets: readonly string[]): Style | undefined;
+/** The project's style under the scenario's, setting by setting. */
+export declare function mergeStyles(project: Style | undefined, scenario: Style | undefined): Style | undefined;

package/dist/scenario/config.js

@@ -0,0 +1,69 @@
+import fs from "node:fs";
+import path from "node:path";
+import { z } from "zod";
+import { Style } from "./schema.js";
+/**
+ * A project's shared settings: `screenplay.config.json`, found in the scenario's
+ * directory or the nearest parent. Its style applies to every video below it; a
+ * scenario's own `style` wins, setting by setting.
+ */
+export const CONFIG_FILE = "screenplay.config.json";
+export const ProjectConfig = z
+    .object({
+    $schema: z.string().optional(),
+    style: Style.optional(),
+})
+    .strict();
+export function findProjectConfig(dir) {
+    let d = path.resolve(dir);
+    while (true) {
+        const f = path.join(d, CONFIG_FILE);
+        if (fs.existsSync(f))
+            return f;
+        const up = path.dirname(d);
+        if (up === d)
+            return undefined;
+        d = up;
+    }
+}
+export function readProjectConfig(file) {
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(file, "utf8"));
+    }
+    catch (e) {
+        throw new Error(`${file} is not valid JSON: ${e.message}`);
+    }
+    const r = ProjectConfig.safeParse(raw);
+    if (!r.success) {
+        const issues = r.error.issues.map((i) => `- ${i.path.map(String).join(".") || "(file)"}: ${i.message}`).join("\n");
+        throw new Error(`${file} is not valid:\n${issues}`);
+    }
+    return r.data;
+}
+/** True when a background value names an image file rather than a preset or a color. */
+export function isImagePath(bg, presets) {
+    return typeof bg === "string" && !presets.includes(bg) && !/^(#|rgb|hsl)/i.test(bg);
+}
+/** Make an image background absolute, so it still resolves once merged into a scenario elsewhere. */
+export function absolutizeStyle(style, baseDir, presets) {
+    if (!style)
+        return style;
+    if (isImagePath(style.background, presets) && !path.isAbsolute(style.background)) {
+        return { ...style, background: path.resolve(baseDir, style.background) };
+    }
+    return style;
+}
+/** The project's style under the scenario's, setting by setting. */
+export function mergeStyles(project, scenario) {
+    if (!project)
+        return scenario;
+    if (!scenario)
+        return project;
+    const out = { ...project };
+    for (const [k, v] of Object.entries(scenario))
+        if (v !== undefined)
+            out[k] = v;
+    return out;
+}
+//# sourceMappingURL=config.js.map

package/dist/scenario/config.js.map

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

package/dist/scenario/fingerprint.d.ts

@@ -0,0 +1,10 @@
+import { type Scenario } from "./schema.js";
+export declare function captureInputs(scenario: Scenario): {
+    setup: string;
+    steps: string[];
+};
+/** Why the scenario cannot be re-rendered from a take, or undefined when it can. */
+export declare function captureMismatch(scenario: Scenario, recorded: {
+    setup: string;
+    steps: string[];
+} | undefined, recordedKinds: string[]): string | undefined;

package/dist/scenario/fingerprint.js

@@ -0,0 +1,58 @@
+import crypto from "node:crypto";
+import { describeStep, stepKind } from "./schema.js";
+/**
+ * What a recording depends on. Editing-only fields (narration, captions,
+ * callout text, card text, zoom, style, voice, output) are left out, so they
+ * can change and be re-rendered without filming again; anything else that
+ * changes (a target, typed text, a wait, a hold) needs a new recording.
+ */
+const EDITORIAL_KEYS = new Set(["say", "zoom", "text"]);
+const CARD_KEYS = new Set(["title", "end", "subtitle", "duration", "say"]);
+export function captureInputs(scenario) {
+    const setup = JSON.stringify([
+        scenario.url ?? null,
+        scenario.app ?? null,
+        scenario.viewport ?? null,
+        scenario.scale ?? null,
+        scenario.colorScheme ?? null,
+        scenario.locale ?? null,
+        scenario.auth ?? null,
+        scenario.hideScrollbars ?? null,
+        scenario.typingSpeed ?? null,
+        // Appended only when set, so takes recorded before these options existed keep their fingerprint.
+        ...(scenario.screen || scenario.hideOthers ? [scenario.screen ?? null, scenario.hideOthers ?? null] : []),
+    ]);
+    const steps = scenario.steps.map((step) => {
+        const kind = stepKind(step);
+        const skip = kind === "title" || kind === "end" ? CARD_KEYS : EDITORIAL_KEYS;
+        const kept = Object.entries(step)
+            .filter(([k]) => !skip.has(k))
+            .sort(([a], [b]) => a.localeCompare(b));
+        return hash(JSON.stringify([kind, kept]));
+    });
+    return { setup: hash(setup), steps };
+}
+function hash(s) {
+    return crypto.createHash("sha1").update(s).digest("hex").slice(0, 12);
+}
+/** Why the scenario cannot be re-rendered from a take, or undefined when it can. */
+export function captureMismatch(scenario, recorded, recordedKinds) {
+    const now = captureInputs(scenario);
+    if (scenario.steps.length !== recordedKinds.length) {
+        return `the scenario has ${scenario.steps.length} steps and the recording ${recordedKinds.length}`;
+    }
+    for (let i = 0; i < scenario.steps.length; i++) {
+        if (stepKind(scenario.steps[i]) !== recordedKinds[i])
+            return `step ${i + 1} (${describeStep(scenario.steps[i])}) changed`;
+    }
+    if (!recorded)
+        return undefined; // takes from before fingerprints: kinds are all we can compare
+    if (recorded.setup !== now.setup)
+        return "the page, app, screen mode, viewport, session or typing speed changed";
+    for (let i = 0; i < now.steps.length; i++) {
+        if (recorded.steps[i] !== now.steps[i])
+            return `step ${i + 1} (${describeStep(scenario.steps[i])}) changed`;
+    }
+    return undefined;
+}
+//# sourceMappingURL=fingerprint.js.map

package/dist/scenario/fingerprint.js.map

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

package/dist/scenario/load.d.ts

@@ -0,0 +1,36 @@
+import { Scenario } from "./schema.js";
+export interface LoadedScenario {
+    scenario: Scenario;
+    /** Absolute path of the scenario file. */
+    file: string;
+    /** Directory of the scenario file. */
+    dir: string;
+    /** Video name: scenario.name or the file name without extension. */
+    name: string;
+    /** Working directory for takes and caches: <dir>/.screenplay */
+    workDir: string;
+    /** Directory of the latest take of this scenario. */
+    takeDir: string;
+    outputs: {
+        mp4: string;
+        gif: string;
+        storyboard: string;
+    };
+    /** The project's screenplay.config.json, when one applies (its style is merged into `scenario.style`). */
+    projectConfig?: string;
+}
+export declare class ScenarioError extends Error {
+}
+/** Replace ${VAR} with environment values in every string of the scenario. */
+export declare function substituteEnv<T>(value: T, env?: NodeJS.ProcessEnv): T;
+export declare function formatZodError(err: {
+    issues: Array<{
+        path: PropertyKey[];
+        message: string;
+    }>;
+}): string;
+export declare function parseScenario(raw: unknown): Scenario;
+export declare function loadScenario(file: string, opts?: {
+    env?: boolean;
+}): LoadedScenario;
+export declare function slugify(s: string): string;

package/dist/scenario/load.js

@@ -0,0 +1,101 @@
+import fs from "node:fs";
+import path from "node:path";
+import { pathToFileURL } from "node:url";
+import { BACKGROUNDS, Scenario } from "./schema.js";
+import { absolutizeStyle, findProjectConfig, mergeStyles, readProjectConfig } from "./config.js";
+export class ScenarioError extends Error {
+}
+const ENV_RE = /\$\{([A-Z0-9_]+)\}/g;
+/** Replace ${VAR} with environment values in every string of the scenario. */
+export function substituteEnv(value, env = process.env) {
+    if (typeof value === "string") {
+        return value.replace(ENV_RE, (_, name) => {
+            const v = env[name];
+            if (v === undefined)
+                throw new ScenarioError(`Environment variable ${name} is not set (used as \${${name}} in the scenario).`);
+            return v;
+        });
+    }
+    if (Array.isArray(value))
+        return value.map((v) => substituteEnv(v, env));
+    if (value && typeof value === "object") {
+        const out = {};
+        for (const [k, v] of Object.entries(value))
+            out[k] = substituteEnv(v, env);
+        return out;
+    }
+    return value;
+}
+export function formatZodError(err) {
+    return err.issues
+        .slice(0, 8)
+        .map((i) => `- ${i.path.length ? i.path.map(String).join(".") : "(scenario)"}: ${i.message}`)
+        .join("\n");
+}
+export function parseScenario(raw) {
+    const result = Scenario.safeParse(raw);
+    if (!result.success) {
+        throw new ScenarioError(`The scenario is not valid:\n${formatZodError(result.error)}\nRun \`screenplay schema\` for the full format.`);
+    }
+    return result.data;
+}
+export function loadScenario(file, opts = {}) {
+    const given = path.resolve(file);
+    if (!fs.existsSync(given))
+        throw new ScenarioError(`Scenario not found: ${given}`);
+    // The real path, so the same scenario reached through a symlink (macOS /tmp is /private/tmp) is the same scenario.
+    const abs = fs.realpathSync(given);
+    let raw;
+    try {
+        raw = JSON.parse(fs.readFileSync(abs, "utf8"));
+    }
+    catch (e) {
+        throw new ScenarioError(`The scenario is not valid JSON: ${e.message}`);
+    }
+    let scenario = parseScenario(raw);
+    if (opts.env !== false)
+        scenario = substituteEnv(scenario);
+    const dir = path.dirname(abs);
+    // A url without a scheme is a local file, relative to the scenario.
+    if (scenario.url && !/^[a-z][a-z0-9+.-]*:/i.test(scenario.url)) {
+        scenario = { ...scenario, url: pathToFileURL(path.resolve(dir, scenario.url)).toString() };
+    }
+    const projectConfig = findProjectConfig(dir);
+    if (projectConfig) {
+        let config;
+        try {
+            config = readProjectConfig(projectConfig);
+        }
+        catch (e) {
+            throw new ScenarioError(e.message);
+        }
+        const projectStyle = absolutizeStyle(config.style, path.dirname(projectConfig), BACKGROUNDS);
+        scenario = { ...scenario, style: mergeStyles(projectStyle, scenario.style) };
+    }
+    const base = path.basename(abs).replace(/\.json$/i, "").replace(/\.screenplay$/i, "");
+    const name = scenario.name ?? base;
+    const slug = slugify(name);
+    const workDir = path.join(dir, ".screenplay");
+    const mp4 = scenario.output?.path ? path.resolve(dir, scenario.output.path) : path.join(dir, `${slug}.mp4`);
+    const stem = mp4.replace(/\.mp4$/i, "");
+    return {
+        scenario,
+        file: abs,
+        dir,
+        name,
+        workDir,
+        takeDir: path.join(workDir, "takes", slug),
+        outputs: { mp4, gif: `${stem}.gif`, storyboard: `${stem}.storyboard.png` },
+        projectConfig,
+    };
+}
+export function slugify(s) {
+    return (s
+        .normalize("NFKD")
+        .replace(/[̀-ͯ]/g, "")
+        .toLowerCase()
+        .replace(/[^a-z0-9]+/g, "-")
+        .replace(/^-+|-+$/g, "")
+        .slice(0, 60) || "screenplay");
+}
+//# sourceMappingURL=load.js.map

package/dist/scenario/load.js.map

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