agent-screenplay 0.0.0-stage → 0.1.0

package/dist/init.js

@@ -0,0 +1,147 @@
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+import { createRequire } from "node:module";
+import { spawnSync } from "node:child_process";
+import { isChromiumInstalled } from "./drivers/browser.js";
+import { ffmpegPath } from "./ffmpeg.js";
+import { packageRoot, skillFile } from "./guide.js";
+const require = createRequire(import.meta.url);
+function onPath(cmd) {
+    const probe = spawnSync(process.platform === "win32" ? "where" : "which", [cmd], { stdio: "ignore" });
+    return probe.status === 0;
+}
+/** How agents should start the MCP server: from npm, or from this checkout when not installed from npm. */
+export function mcpCommand() {
+    const root = packageRoot();
+    if (fs.existsSync(path.join(root, ".git"))) {
+        return { command: process.execPath, args: [path.join(root, "dist", "cli.js"), "mcp"] };
+    }
+    // The npm package is agent-screenplay ("screenplay" belongs to someone else on npm).
+    return { command: "npx", args: ["-y", "agent-screenplay", "mcp"] };
+}
+export async function init(opts = {}) {
+    const log = opts.log ?? (() => { });
+    const home = opts.home ?? os.homedir();
+    const report = { done: [], skipped: [], warnings: [] };
+    const act = (what, fn) => {
+        if (opts.dryRun) {
+            report.done.push(`(dry run) ${what}`);
+            return;
+        }
+        try {
+            fn();
+            report.done.push(what);
+        }
+        catch (e) {
+            report.warnings.push(`${what}: ${e.message}`);
+        }
+    };
+    // 1. Chromium for web recordings.
+    if (opts.browser !== false) {
+        if (isChromiumInstalled())
+            report.skipped.push("Chromium already installed");
+        else {
+            log("Downloading Chromium (once)…");
+            act("Installed Chromium for web recordings", () => {
+                const cli = path.join(path.dirname(require.resolve("playwright-core/package.json")), "cli.js");
+                const r = spawnSync(process.execPath, [cli, "install", "chromium"], { stdio: "inherit" });
+                if (r.status !== 0)
+                    throw new Error("the download failed; run `npx playwright install chromium`, or set SCREENPLAY_CHROME to an installed Chrome");
+            });
+        }
+    }
+    // 2. ffmpeg.
+    try {
+        ffmpegPath();
+    }
+    catch (e) {
+        report.warnings.push(e.message);
+    }
+    // 3. MCP server in the agents found on this machine.
+    if (opts.mcp !== false) {
+        const { command, args } = mcpCommand();
+        const found = [];
+        if (onPath("claude")) {
+            found.push("Claude Code");
+            const exists = spawnSync("claude", ["mcp", "get", "screenplay"], { stdio: "ignore" }).status === 0;
+            if (exists)
+                report.skipped.push("Claude Code already has the screenplay MCP server");
+            else
+                act("Added the MCP server to Claude Code (user scope)", () => {
+                    const r = spawnSync("claude", ["mcp", "add", "--scope", "user", "screenplay", "--", command, ...args], { encoding: "utf8" });
+                    if (r.status !== 0)
+                        throw new Error(r.stderr || "claude mcp add failed");
+                });
+        }
+        const codexDir = path.join(home, ".codex");
+        if (onPath("codex") || fs.existsSync(codexDir)) {
+            found.push("Codex");
+            const file = path.join(codexDir, "config.toml");
+            const current = fs.existsSync(file) ? fs.readFileSync(file, "utf8") : "";
+            if (/^\[mcp_servers\.screenplay\]/m.test(current))
+                report.skipped.push("Codex already has the screenplay MCP server");
+            else
+                act(`Added the MCP server to Codex (${file})`, () => {
+                    fs.mkdirSync(codexDir, { recursive: true });
+                    const block = [
+                        "",
+                        "[mcp_servers.screenplay]",
+                        `command = ${JSON.stringify(command)}`,
+                        `args = [${args.map((a) => JSON.stringify(a)).join(", ")}]`,
+                        "# Filming and editing a video takes longer than the default tool timeout.",
+                        "tool_timeout_sec = 900",
+                        "",
+                    ].join("\n");
+                    fs.writeFileSync(file, current.replace(/\s*$/, "\n") + block);
+                });
+        }
+        const cursorDir = path.join(home, ".cursor");
+        if (fs.existsSync(cursorDir)) {
+            found.push("Cursor");
+            const file = path.join(cursorDir, "mcp.json");
+            let json = {};
+            if (fs.existsSync(file)) {
+                try {
+                    json = JSON.parse(fs.readFileSync(file, "utf8"));
+                }
+                catch {
+                    report.warnings.push(`${file} is not valid JSON: add the screenplay server by hand`);
+                    json = { mcpServers: { screenplay: true } };
+                }
+            }
+            if (json.mcpServers?.screenplay)
+                report.skipped.push("Cursor already has the screenplay MCP server");
+            else
+                act(`Added the MCP server to Cursor (${file})`, () => {
+                    json.mcpServers = { ...(json.mcpServers ?? {}), screenplay: { command, args } };
+                    fs.writeFileSync(file, JSON.stringify(json, null, 2) + "\n");
+                });
+        }
+        if (found.length === 0) {
+            report.warnings.push(`No agent found (Claude Code, Codex, Cursor). Add the MCP server by hand: command "${command}", args ${JSON.stringify(args)}.`);
+        }
+    }
+    // 4. The guide as a skill, for agents that load skills from disk.
+    if (opts.skill !== false) {
+        const targets = [
+            { dir: path.join(home, ".claude"), name: "Claude Code" },
+            { dir: path.join(home, ".codex"), name: "Codex" },
+        ];
+        for (const t of targets) {
+            if (!fs.existsSync(t.dir))
+                continue;
+            const dest = path.join(t.dir, "skills", "screenplay", "SKILL.md");
+            act(`Installed the screenplay skill for ${t.name} (${dest})`, () => {
+                fs.mkdirSync(path.dirname(dest), { recursive: true });
+                fs.copyFileSync(skillFile(), dest);
+            });
+        }
+    }
+    // 5. Desktop recordings need OS permissions on macOS.
+    if (process.platform === "darwin") {
+        report.warnings.push("For desktop apps on macOS, allow your terminal (or agent app) in System Settings → Privacy & Security → Screen Recording and → Accessibility. Web recordings need nothing.");
+    }
+    return report;
+}
+//# sourceMappingURL=init.js.map

package/dist/init.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"init.js","sourceRoot":"","sources":["../src/init.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAC/C,OAAO,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAC3D,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,YAAY,CAAC;AAEpD,MAAM,OAAO,GAAG,aAAa,CAAC,OAAO,IAAI,CAAC,GAAG,CAAC,CAAC;AAiB/C,SAAS,MAAM,CAAC,GAAW;IACzB,MAAM,KAAK,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,KAAK,OAAO,CAAC,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,GAAG,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;IACtG,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC;AAC5B,CAAC;AAED,2GAA2G;AAC3G,MAAM,UAAU,UAAU;IACxB,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,EAAE,CAAC;QAC3C,OAAO,EAAE,OAAO,EAAE,OAAO,CAAC,QAAQ,EAAE,IAAI,EAAE,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,KAAK,CAAC,EAAE,CAAC;IACzF,CAAC;IACD,qFAAqF;IACrF,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,IAAI,EAAE,CAAC,IAAI,EAAE,kBAAkB,EAAE,KAAK,CAAC,EAAE,CAAC;AACrE,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,IAAI,CAAC,IAAI,GAAgB,EAAE;IAC/C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,IAAI,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACnC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,IAAI,EAAE,CAAC,OAAO,EAAE,CAAC;IACvC,MAAM,MAAM,GAAe,EAAE,IAAI,EAAE,EAAE,EAAE,OAAO,EAAE,EAAE,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC;IACnE,MAAM,GAAG,GAAG,CAAC,IAAY,EAAE,EAAc,EAAE,EAAE;QAC3C,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;YAChB,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,aAAa,IAAI,EAAE,CAAC,CAAC;YACtC,OAAO;QACT,CAAC;QACD,IAAI,CAAC;YACH,EAAE,EAAE,CAAC;YACL,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;QACzB,CAAC;QAAC,OAAO,CAAC,EAAE,CAAC;YACX,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,KAAM,CAAW,CAAC,OAAO,EAAE,CAAC,CAAC;QAC3D,CAAC;IACH,CAAC,CAAC;IAEF,kCAAkC;IAClC,IAAI,IAAI,CAAC,OAAO,KAAK,KAAK,EAAE,CAAC;QAC3B,IAAI,mBAAmB,EAAE;YAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,4BAA4B,CAAC,CAAC;aACxE,CAAC;YACJ,GAAG,CAAC,8BAA8B,CAAC,CAAC;YACpC,GAAG,CAAC,uCAAuC,EAAE,GAAG,EAAE;gBAChD,MAAM,GAAG,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,OAAO,CAAC,OAAO,CAAC,8BAA8B,CAAC,CAAC,EAAE,QAAQ,CAAC,CAAC;gBAC/F,MAAM,CAAC,GAAG,SAAS,CAAC,OAAO,CAAC,QAAQ,EAAE,CAAC,GAAG,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,EAAE,KAAK,EAAE,SAAS,EAAE,CAAC,CAAC;gBAC1F,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;oBAAE,MAAM,IAAI,KAAK,CAAC,6GAA6G,CAAC,CAAC;YACrJ,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,aAAa;IACb,IAAI,CAAC;QACH,UAAU,EAAE,CAAC;IACf,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACX,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAE,CAAW,CAAC,OAAO,CAAC,CAAC;IAC7C,CAAC;IAED,qDAAqD;IACrD,IAAI,IAAI,CAAC,GAAG,KAAK,KAAK,EAAE,CAAC;QACvB,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE,GAAG,UAAU,EAAE,CAAC;QACvC,MAAM,KAAK,GAAa,EAAE,CAAC;QAE3B,IAAI,MAAM,CAAC,QAAQ,CAAC,EAAE,CAAC;YACrB,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;YAC1B,MAAM,MAAM,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,YAAY,CAAC,EAAE,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,MAAM,KAAK,CAAC,CAAC;YACnG,IAAI,MAAM;gBAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,mDAAmD,CAAC,CAAC;;gBAEnF,GAAG,CAAC,kDAAkD,EAAE,GAAG,EAAE;oBAC3D,MAAM,CAAC,GAAG,SAAS,CAAC,QAAQ,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,EAAE,YAAY,EAAE,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,CAAC,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC,CAAC;oBAC7H,IAAI,CAAC,CAAC,MAAM,KAAK,CAAC;wBAAE,MAAM,IAAI,KAAK,CAAC,CAAC,CAAC,MAAM,IAAI,uBAAuB,CAAC,CAAC;gBAC3E,CAAC,CAAC,CAAC;QACP,CAAC;QAED,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC;QAC3C,IAAI,MAAM,CAAC,OAAO,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,CAAC;YAC/C,KAAK,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;YACpB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,aAAa,CAAC,CAAC;YAChD,MAAM,OAAO,GAAG,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;YACzE,IAAI,+BAA+B,CAAC,IAAI,CAAC,OAAO,CAAC;gBAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,6CAA6C,CAAC,CAAC;;gBAEpH,GAAG,CAAC,kCAAkC,IAAI,GAAG,EAAE,GAAG,EAAE;oBAClD,EAAE,CAAC,SAAS,CAAC,QAAQ,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;oBAC5C,MAAM,KAAK,GAAG;wBACZ,EAAE;wBACF,0BAA0B;wBAC1B,aAAa,IAAI,CAAC,SAAS,CAAC,OAAO,CAAC,EAAE;wBACtC,WAAW,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG;wBAC3D,2EAA2E;wBAC3E,wBAAwB;wBACxB,EAAE;qBACH,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;oBACb,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,OAAO,CAAC,OAAO,CAAC,MAAM,EAAE,IAAI,CAAC,GAAG,KAAK,CAAC,CAAC;gBAChE,CAAC,CAAC,CAAC;QACP,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;QAC7C,IAAI,EAAE,CAAC,UAAU,CAAC,SAAS,CAAC,EAAE,CAAC;YAC7B,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;YACrB,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,SAAS,EAAE,UAAU,CAAC,CAAC;YAC9C,IAAI,IAAI,GAA6C,EAAE,CAAC;YACxD,IAAI,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,EAAE,CAAC;gBACxB,IAAI,CAAC;oBACH,IAAI,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC,CAAC;gBACnD,CAAC;gBAAC,MAAM,CAAC;oBACP,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,IAAI,uDAAuD,CAAC,CAAC;oBACrF,IAAI,GAAG,EAAE,UAAU,EAAE,EAAE,UAAU,EAAE,IAAI,EAAE,EAAE,CAAC;gBAC9C,CAAC;YACH,CAAC;YACD,IAAI,IAAI,CAAC,UAAU,EAAE,UAAU;gBAAE,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,8CAA8C,CAAC,CAAC;;gBAEnG,GAAG,CAAC,mCAAmC,IAAI,GAAG,EAAE,GAAG,EAAE;oBACnD,IAAI,CAAC,UAAU,GAAG,EAAE,GAAG,CAAC,IAAI,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAAC;oBAChF,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC;gBAC/D,CAAC,CAAC,CAAC;QACP,CAAC;QAED,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,MAAM,CAAC,QAAQ,CAAC,IAAI,CAClB,qFAAqF,OAAO,WAAW,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,GAAG,CAC/H,CAAC;QACJ,CAAC;IACH,CAAC;IAED,kEAAkE;IAClE,IAAI,IAAI,CAAC,KAAK,KAAK,KAAK,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG;YACd,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,SAAS,CAAC,EAAE,IAAI,EAAE,aAAa,EAAE;YACxD,EAAE,GAAG,EAAE,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,QAAQ,CAAC,EAAE,IAAI,EAAE,OAAO,EAAE;SAClD,CAAC;QACF,KAAK,MAAM,CAAC,IAAI,OAAO,EAAE,CAAC;YACxB,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,CAAC,CAAC,GAAG,CAAC;gBAAE,SAAS;YACpC,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,EAAE,QAAQ,EAAE,YAAY,EAAE,UAAU,CAAC,CAAC;YAClE,GAAG,CAAC,sCAAsC,CAAC,CAAC,IAAI,KAAK,IAAI,GAAG,EAAE,GAAG,EAAE;gBACjE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;gBACtD,EAAE,CAAC,YAAY,CAAC,SAAS,EAAE,EAAE,IAAI,CAAC,CAAC;YACrC,CAAC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,sDAAsD;IACtD,IAAI,OAAO,CAAC,QAAQ,KAAK,QAAQ,EAAE,CAAC;QAClC,MAAM,CAAC,QAAQ,CAAC,IAAI,CAClB,4KAA4K,CAC7K,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/login.d.ts

@@ -0,0 +1,2 @@
+/** Open a visible browser on `url`, let a person sign in, and save the session for scenarios (`auth.storageState`). */
+export declare function login(url: string, out: string, log?: (msg: string) => void): Promise<string>;

package/dist/login.js

@@ -0,0 +1,50 @@
+import fs from "node:fs";
+import path from "node:path";
+import readline from "node:readline";
+import { launchBrowser } from "./drivers/browser.js";
+/** Open a visible browser on `url`, let a person sign in, and save the session for scenarios (`auth.storageState`). */
+export async function login(url, out, log = () => { }) {
+    if (process.platform === "linux" && !process.env.DISPLAY && !process.env.WAYLAND_DISPLAY) {
+        throw new Error("`screenplay login` opens a visible browser, and this machine has no screen. Log in with steps in the scenario instead (type ${EMAIL} / ${PASSWORD} with secret: true), or run login on a computer with a screen and copy the session file.");
+    }
+    const file = path.resolve(out);
+    const browser = await launchBrowser({ headless: false });
+    const context = await browser.newContext({ viewport: null });
+    const page = await context.newPage();
+    await page.goto(url);
+    log(`Sign in in the browser window, then press Enter here (or close the window).`);
+    let last;
+    const poll = setInterval(async () => {
+        try {
+            last = await context.storageState();
+        }
+        catch {
+            /* closing */
+        }
+    }, 1500);
+    await new Promise((resolve) => {
+        const rl = readline.createInterface({ input: process.stdin });
+        rl.once("line", () => {
+            rl.close();
+            resolve();
+        });
+        browser.once("disconnected", () => {
+            rl.close();
+            resolve();
+        });
+    });
+    clearInterval(poll);
+    try {
+        last = await context.storageState();
+    }
+    catch {
+        /* the window was closed: keep the last saved state */
+    }
+    await browser.close().catch(() => { });
+    if (!last)
+        throw new Error("No session was captured.");
+    fs.mkdirSync(path.dirname(file), { recursive: true });
+    fs.writeFileSync(file, JSON.stringify(last, null, 2), { mode: 0o600 });
+    return file;
+}
+//# sourceMappingURL=login.js.map

package/dist/login.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"login.js","sourceRoot":"","sources":["../src/login.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAC7B,OAAO,QAAQ,MAAM,eAAe,CAAC;AACrC,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAErD,uHAAuH;AACvH,MAAM,CAAC,KAAK,UAAU,KAAK,CAAC,GAAW,EAAE,GAAW,EAAE,GAAG,GAA0B,GAAG,EAAE,GAAE,CAAC;IACzF,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,eAAe,EAAE,CAAC;QACzF,MAAM,IAAI,KAAK,CACb,4OAA4O,CAC7O,CAAC;IACJ,CAAC;IACD,MAAM,IAAI,GAAG,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;IAC/B,MAAM,OAAO,GAAG,MAAM,aAAa,CAAC,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;IACzD,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CAAC,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IAC7D,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,OAAO,EAAE,CAAC;IACrC,MAAM,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACrB,GAAG,CAAC,6EAA6E,CAAC,CAAC;IACnF,IAAI,IAAkE,CAAC;IACvE,MAAM,IAAI,GAAG,WAAW,CAAC,KAAK,IAAI,EAAE;QAClC,IAAI,CAAC;YACH,IAAI,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;QACtC,CAAC;QAAC,MAAM,CAAC;YACP,aAAa;QACf,CAAC;IACH,CAAC,EAAE,IAAI,CAAC,CAAC;IACT,MAAM,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QAClC,MAAM,EAAE,GAAG,QAAQ,CAAC,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,CAAC,CAAC;QAC9D,EAAE,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE;YACnB,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;QACH,OAAO,CAAC,IAAI,CAAC,cAAc,EAAE,GAAG,EAAE;YAChC,EAAE,CAAC,KAAK,EAAE,CAAC;YACX,OAAO,EAAE,CAAC;QACZ,CAAC,CAAC,CAAC;IACL,CAAC,CAAC,CAAC;IACH,aAAa,CAAC,IAAI,CAAC,CAAC;IACpB,IAAI,CAAC;QACH,IAAI,GAAG,MAAM,OAAO,CAAC,YAAY,EAAE,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,sDAAsD;IACxD,CAAC;IACD,MAAM,OAAO,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;IACtC,IAAI,CAAC,IAAI;QAAE,MAAM,IAAI,KAAK,CAAC,0BAA0B,CAAC,CAAC;IACvD,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;IACtD,EAAE,CAAC,aAAa,CAAC,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,EAAE,EAAE,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC;IACvE,OAAO,IAAI,CAAC;AACd,CAAC"}

package/dist/mcp/server.d.ts

@@ -0,0 +1 @@
+export declare function startMcpServer(): Promise<void>;

package/dist/mcp/server.js

@@ -0,0 +1,132 @@
+import fs from "node:fs";
+import path from "node:path";
+import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
+import { loadImage, createCanvas } from "@napi-rs/canvas";
+import { z } from "zod";
+import { check, record, render } from "../core.js";
+import { guideText } from "../guide.js";
+import { parseScenario } from "../scenario/load.js";
+import { VERSION } from "../version.js";
+const INSTRUCTIONS = `Screenplay makes Screen Studio-quality screen recordings (smooth cursor, auto-zoom, callouts, captions, optional voice-over) from a JSON scenario you write.
+Before your first recording, call screenplay_guide and follow it: explore the app, write the scenario, screenplay_check until it plays to the end, screenplay_record, look at the returned storyboard, fix, and re-run (screenplay_render when only text/style/zoom changed).`;
+const PathArg = z
+    .string()
+    .describe("Path of the scenario JSON file. Prefer an absolute path; a relative one is resolved from the server's working directory.");
+const ScenarioArg = z
+    .record(z.string(), z.unknown())
+    .optional()
+    .describe("Optional scenario object: validated, then written to `path` (overwriting that file), then used.");
+const SIDE_EFFECTS = " It really performs the steps in the app (a click on Send sends, a click on Delete deletes): use a demo account or a staging environment.";
+// One recording at a time: each one runs a browser and a video encoder.
+let queue = Promise.resolve();
+function serialize(job) {
+    const run = queue.then(job, job);
+    queue = run.catch(() => { });
+    return run;
+}
+function resolvePath(p, scenario) {
+    const abs = path.resolve(process.cwd(), p);
+    if (scenario) {
+        parseScenario(scenario); // never overwrite a file with an invalid scenario
+        fs.mkdirSync(path.dirname(abs), { recursive: true });
+        fs.writeFileSync(abs, JSON.stringify(scenario, null, 2) + "\n");
+    }
+    return abs;
+}
+async function imageContent(file, maxWidth = 1600) {
+    const img = await loadImage(fs.readFileSync(file));
+    const k = Math.min(1, maxWidth / img.width);
+    const c = createCanvas(Math.round(img.width * k), Math.round(img.height * k));
+    c.getContext("2d").drawImage(img, 0, 0, c.width, c.height);
+    const data = (await c.encode("jpeg", 82)).toString("base64");
+    return { type: "image", data, mimeType: "image/jpeg" };
+}
+function errorResult(e) {
+    return { isError: true, content: [{ type: "text", text: e instanceof Error ? e.message : String(e) }] };
+}
+function progressLogger(extra) {
+    const token = extra._meta?.progressToken;
+    let n = 0;
+    return (msg) => {
+        if (token === undefined)
+            return;
+        extra.sendNotification({ method: "notifications/progress", params: { progressToken: token, progress: ++n, message: msg } }).catch(() => { });
+    };
+}
+export async function startMcpServer() {
+    const server = new McpServer({ name: "screenplay", version: VERSION }, { instructions: INSTRUCTIONS });
+    server.registerTool("screenplay_guide", {
+        title: "How to make a good screen recording",
+        description: "The guide to writing Screenplay scenarios: the loop, targets, steps, style, voice-over and direction tips. Read it before the first recording.",
+        annotations: { readOnlyHint: true },
+    }, async () => ({ content: [{ type: "text", text: guideText() }] }));
+    server.registerTool("screenplay_check", {
+        title: "Check a scenario",
+        description: "Play the scenario quickly without filming. Reports each step; for a missing element, lists the visible targets you can use instead, with a screenshot of where it stopped." +
+            SIDE_EFFECTS,
+        inputSchema: { path: PathArg, scenario: ScenarioArg },
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+    }, async ({ path: p, scenario }, extra) => serialize(async () => {
+        try {
+            const file = resolvePath(p, scenario);
+            const report = await check(file, { log: progressLogger(extra) });
+            const content = [{ type: "text", text: JSON.stringify(report, null, 2) }];
+            if (report.screenshot && fs.existsSync(report.screenshot))
+                content.push(await imageContent(report.screenshot, 1280));
+            return { content, isError: !report.ok };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    }));
+    const recordArgs = {
+        path: PathArg,
+        scenario: ScenarioArg,
+        gif: z.boolean().optional().describe("Also write a GIF."),
+        noVoice: z.boolean().optional().describe("Skip the voice-over even if the scenario enables it."),
+    };
+    server.registerTool("screenplay_record", {
+        title: "Film and edit a scenario",
+        description: "Film the scenario and edit the video. Returns the MP4 path and the storyboard (one image per step): look at it and fix framing, bubbles or data before handing the video over. Takes about the length of the video plus a few seconds per 10 seconds of video." +
+            SIDE_EFFECTS,
+        inputSchema: recordArgs,
+        annotations: { readOnlyHint: false, destructiveHint: true, openWorldHint: true },
+    }, async ({ path: p, scenario, gif, noVoice }, extra) => serialize(async () => {
+        try {
+            const file = resolvePath(p, scenario);
+            const r = await record(file, { gif, noVoice, log: progressLogger(extra) });
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify({ mp4: r.mp4, gif: r.gif, storyboard: r.storyboard, duration: Number(r.duration.toFixed(1)), steps: r.steps }, null, 2) },
+                    await imageContent(r.storyboard),
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    }));
+    server.registerTool("screenplay_render", {
+        title: "Edit the last recording again",
+        description: "Re-edit the last recording of this scenario without filming: use it after changing text, narration (say), callouts, style, zoom or output. Changing actions needs screenplay_record. Does not touch the app; writes the video files, and sends new narration text to Cartesia when the scenario enables voice-over.",
+        inputSchema: recordArgs,
+        annotations: { readOnlyHint: false, destructiveHint: false, openWorldHint: true },
+    }, async ({ path: p, scenario, gif, noVoice }, extra) => serialize(async () => {
+        try {
+            const file = resolvePath(p, scenario);
+            const r = await render(file, { gif, noVoice, log: progressLogger(extra) });
+            return {
+                content: [
+                    { type: "text", text: JSON.stringify({ mp4: r.mp4, gif: r.gif, storyboard: r.storyboard, duration: Number(r.duration.toFixed(1)) }, null, 2) },
+                    await imageContent(r.storyboard),
+                ],
+            };
+        }
+        catch (e) {
+            return errorResult(e);
+        }
+    }));
+    await server.connect(new StdioServerTransport());
+}
+//# sourceMappingURL=server.js.map

package/dist/mcp/server.js.map

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

package/dist/render/compose.d.ts

@@ -0,0 +1,68 @@
+import { type Canvas, type Image, type SKRSContext2D } from "@napi-rs/canvas";
+import type { Annotation, Camera, Caption } from "../direct/plan.js";
+import type { Point } from "../take.js";
+import { type ResolvedStyle } from "./style.js";
+export interface Layout {
+    OW: number;
+    OH: number;
+    /** Unit for sizes: 1 at 1080p. */
+    k: number;
+    window: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    content: {
+        x: number;
+        y: number;
+        w: number;
+        h: number;
+    };
+    barH: number;
+}
+export declare function computeLayout(OW: number, OH: number, W: number, H: number, style: ResolvedStyle): Layout;
+/** Background, shadow and window chrome: drawn once, reused for every frame. */
+export declare function buildStaticLayer(layout: Layout, style: ResolvedStyle, url?: string): Canvas;
+export interface CaptureFrame {
+    image: Image | Canvas;
+    sx: number;
+    sy: number;
+    sw: number;
+    sh: number;
+}
+export interface FrameState {
+    o: number;
+    camera: Camera;
+    cursor?: {
+        p: Point;
+        alpha: number;
+        press: number;
+    };
+    ripples: Array<{
+        p: Point;
+        u: number;
+    }>;
+    annotations: Array<{
+        a: Annotation;
+        inU: number;
+        outU: number;
+    }>;
+    caption?: {
+        c: Caption;
+        alpha: number;
+    };
+}
+/** Draw one recorded frame with the camera, overlays and cursor. */
+export declare function drawCapture(ctx: SKRSContext2D, layout: Layout, style: ResolvedStyle, staticLayer: Canvas, frame: CaptureFrame, W: number, H: number, st: FrameState): void;
+/** Full-screen title or end card. `u` is the time since it appeared (seconds). */
+export declare function drawCard(ctx: SKRSContext2D, layout: Layout, style: ResolvedStyle, bgLayer: Canvas, card: {
+    kind: "title" | "end";
+    title: string;
+    subtitle?: string;
+}, u: number, alpha?: number): void;
+/** macOS-style arrow, or a soft dot. `size` is 1 at 1080p. */
+export declare function drawCursor(ctx: SKRSContext2D, kind: "macos" | "dot", p: Point, size: number, alpha: number): void;
+export declare function wrap(ctx: SKRSContext2D, text: string, maxW: number): string[];
+export declare function easeOut(t: number): number;
+export declare function clamp01(t: number): number;