@kheleshikhi/studio-agent 0.6.1

package/README.md

@@ -0,0 +1,225 @@
+# NerdBro Studio Agent
+
+Provider-neutral external authoring for KheleShikhi Interactive Studio. It
+requires Node 20+ and Chrome, Edge, or explicitly installed Playwright Chromium.
+It does not require the NerdBro repository, Flutter, Dart, Python, Docker, an
+OpenAI API key, or an Anthropic API key.
+
+```sh
+npm install -g @kheleshikhi/studio-agent
+nerdbro setup
+nerdbro connect
+
+mkdir my-kheleshikhi-work
+cd my-kheleshikhi-work
+nerdbro agent init --provider codex   # or claude / generic
+nerdbro studio create --title "Ball Lab" --target combined --concept "Projectile range"
+nerdbro studio checkout <asset-id>
+```
+
+The browser pairing page uses the normal NerdBro login. The daemon stores the
+scoped production credential only in memory. It binds to `127.0.0.1` on a
+random port and protects local RPC with a random discovery secret. The
+persistent Playwright profile is dedicated to NerdBro and never reads personal
+browser cookies, extensions, passwords, or history.
+
+The normal headless Agent browser uses the real installed
+Chrome or Edge where available, keeps the browser sandbox enabled, and leaves
+display scaling to the operating system. Desktop and mobile viewport options
+are CSS layout sizes; they do not simulate a low-density display. Headless mode
+uses the same explicit responsive viewports for automated inspection, but its
+screenshot pixels are not promised to be byte-identical across hardware.
+Chrome's device-metrics API applies the CSS size while leaving the host device
+scale native; NerdBro does not force a DPR value. Version 0.6.1 keeps the
+Chrome DevTools viewport session alive for the browser tab, so a requested
+desktop, mobile, or custom CSS size remains in effect through inspection and
+capture.
+`browser.json` records the actual CSS viewport, `window.devicePixelRatio`, safe
+screen dimensions, browser version, headed/headless mode, and PNG pixel size.
+
+## Benchmark Attempt
+
+From a fresh Git workspace, connect once, then run:
+
+```sh
+nerdbro attempt start --label ball-launcher-v3 --mode benchmark
+nerdbro agent init --provider claude   # or codex / generic
+```
+
+The generated provider instructions tell the Agent to write `REPORT.md` and
+`EVALUATION.md` before `nerdbro attempt finish --outcome completed|blocked|incomplete|abandoned`. The workspace pointer
+`.nerdbro-attempt.json` holds only non-secret metadata. Commands automatically
+join the same Attempt after a daemon restart or a new Agent authorization
+session under the same Maker account. The client ZIP is written under
+`~/NerdBroAttempts/<attempt-id>/client/` (override with
+`NERDBRO_ATTEMPT_ROOT`). An operator with backend database access later runs
+`just studio-agent-attempt-export <attempt-id>` from the repository to create
+one outer ZIP. Ordinary Studio authoring remains available without an Attempt.
+
+Use `--json` on every command for stable envelopes. Exit code `0` is success,
+`1` is an operation/server failure, `2` is local input, `3` is a stale draft or
+source conflict, `4` means authentication/daemon state is required, and `5`
+means setup/browser compatibility failed.
+
+The repository's `agent_capability_proof` and `ball_launcher_stress` journeys
+are **scripted platform regressions**: repository code authors `source.json`,
+then this public CLI drives and certifies the real browser runtime. They do not
+show that Claude or another model independently discovered or authored a Scene.
+In particular, the scripted Ball Launcher does not perform a vernier-caliper
+diameter reading and choose a ball from that measurement. The original, harder
+brief is reserved for a fresh external-AI run without repository access.
+
+Read the current live Authoring Playbook with `nerdbro guide` before substantial
+authoring. It is the same canonical page served at
+`/docs/studio-language/agent-authoring-playbook`, not a bundled instruction copy.
+
+Use `nerdbro docs`, `nerdbro docs search <query>`, and
+`nerdbro docs open <slug>` to read the same current Language Reference hosted
+for Makers. Schema, capabilities, Components, Behaviors, and examples are
+always fetched live from NerdBro; none is bundled in this npm package.
+Use `nerdbro schema experience` for the final learner content contract and
+`nerdbro docs open experiences` for one-Scene, narrated, mixed, and multi-Band
+examples. Use `nerdbro schema scene.variables`, `scene.events`, `scene.gestures`, `scene.diagram`,
+`scene.motions`, `scene.captions`, `scene.audio`, `scene.stateMachines`,
+`expressions`, `stateMachine.actions`, `mathGraph.behaviorProjection`,
+`assessment`, or the `runtime.*` topics to request a narrow projection of
+the parser/runtime contract. `nerdbro schema` returns the topic index and
+summary contracts.
+Search Components and Behaviors narrowly. Example search rejects an empty
+query, returns ranked summaries with a small default limit, and leaves full
+source to `example inspect <id>`; normally inspect no more than three relevant
+examples.
+
+The daemon reuses the authenticated context response for at most 30 seconds,
+then revalidates it; connecting or disconnecting clears the cache. This cuts
+repeated compatibility reads without caching mutable drafts.
+
+Check out once, edit only `source.json`, and use `studio status` for later
+synchronization. Validate, compile, preview when useful, save, then inspect the
+real Studio. The daemon reuses its short-lived read-only browser credential in
+memory and clears it on disconnect, stop, reconnect, or origin change. A graph
+requirement without a teaching purpose or axis/synchronization meaning is a
+clarification request, not permission to invent filler.
+
+`studio create` needs the `STUDIO_ASSET_CREATE` pairing scope and returns a
+Maker-owned draft identity and its server starter-source hash. `--scratch`
+only labels the intent to use an ordinary new, unapproved asset as a disposable
+spike. It has no separate lifecycle, automatic expiry, promotion, or garbage
+collection. Save its exact ID for explicit cleanup after success. Use
+`studio brief <asset>` and `studio brief update <asset> --graph-purpose ...`
+to inspect or update authoring intent with a concurrency check.
+
+`studio save` creates a draft. `studio certify` records technical evidence.
+Neither approves or publishes. `studio export --revision ...` accepts only the
+server-built canonical V2 package for an approved immutable revision; the CLI
+does not assemble package formats, and draft export is not a command.
+
+For visual evolution, use `nerdbro studio capture-preview <asset-id> --mode
+semantic --viewport 480x320 --duration 8 --out preview-capture`. It captures
+the real Studio preview into local JPEG checkpoints, a labelled contact sheet,
+and a source/revision-bound runtime timeline. `--mode fixed --fps 2` samples
+motion at regular intervals. The local output path is accessible to a local
+agent only; no frames are uploaded or silently persisted by the backend.
+
+`nerdbro studio inspect <asset-id> --view learner --viewport mobile` opens the
+Studio's production part surface at mobile CSS size. `--view final` is an alias.
+
+Use `nerdbro studio drive <asset-id> --scenario journey.json --viewport mobile`
+to exercise an unsaved local source in that same production preview. This
+does not save a draft or write learner progress. The paired browser opens the
+current server source, transfers the bounded local candidate into Studio's
+explicit authoring/test mode, compiles it through the normal preview API, and
+rejects a source-hash mismatch before the first step. The scenario is versioned
+and has at most 64 steps and a two-minute run budget:
+
+```json
+{
+  "version": 1,
+  "steps": [
+    {"op": "set", "target": "launchSpeed", "value": 8},
+    {"op": "drag", "target": "angleGesture", "value": 42},
+    {"op": "press", "target": "launch"},
+    {"op": "wait", "path": "recent_scene_event", "equals": "projectileLanded", "timeoutMs": 10000},
+    {"op": "assert", "path": "active_states.attempt", "equals": "result"},
+    {"op": "assert", "path": "motion_outputs.projectile.range", "between": [6, 6.5]},
+    {"op": "capture", "name": "result"}
+  ]
+}
+```
+
+`set`, `fire`, `press`, `tap`, `drag`, `play`, `pause`, `seek`, and `reset`
+address only declared variables, events, instances, and gestures. `press`
+honours conditional availability; `drag` derives a Scene point from the
+authored gesture range. `wait` and `assert` read allowlisted observation paths,
+never arbitrary code. `capture` records the actual browser pixels. The result
+directory contains the initial and step captures plus bounded runtime state.
+For a gesture with an interaction handle, assert
+`gestures.<id>.affordance_visible` before `drag`; the driver also refuses a
+handle that the mounted preview has not presented.
+
+## Library authoring
+
+The Studio Library's semantic kinds — `experience`, `audio`, `component`
+(including Characters) and `behavior` — are authored with the same
+draft-first flow. The CLI is a thin client of `/v1/agent/authoring`: templates,
+validation, certification profiles, preview resolution and package building all
+run on the server, and schemas and documentation are fetched live (use
+`nerdbro docs` and `nerdbro schema`); none is bundled here.
+
+```sh
+nerdbro audio upload take.m4a                 # prints sha256 and duration
+nerdbro audio create narration.sunrise.v1 --name "Sunrise narration" --media <sha256> [--category c] [--language bn]
+nerdbro experience create poem.sunrise.v1 --name "Sunrise" --kind poem \
+  --scene-asset <interactive-asset-id>        # or --scene-package scene:<id> --scene <scene-id>
+  [--master-audio narration.sunrise.v1] [--duration-ms 42000]
+nerdbro component create card.star.v1 --name "Star card" [--category c] [--visual v] [--palette p]
+nerdbro behavior create tap.counter.v1 --name "Tap counter" [--declarative]
+
+nerdbro <kind> checkout <stable-id> [--workspace dir] [--force]
+nerdbro <kind> status <stable-id>
+nerdbro <kind> save <stable-id>
+nerdbro <kind> validate <stable-id> [--revision <revision>]
+nerdbro <kind> certify <stable-id> [--revision <revision>]
+nerdbro experience|behavior preview <stable-id>
+nerdbro experience|behavior export <stable-id> --revision <revision> [--out file.kspkg]
+nerdbro experience|audio search <query> [--limit n]
+nerdbro experience|audio inspect <stable-id>
+nerdbro <kind> inspect-browser <stable-id> [--viewport desktop|mobile|WxH]
+```
+
+`component` and `behavior` keep their catalogue `search` and `inspect`
+commands; the authoring verbs above sit beside them.
+
+Checkout writes `<workspace>/<kind>/<stable-id>/source.json` and
+`library-lock.json` (`kheleshikhi.library-lock.v1`: kind, stable id, head
+revision, canonical source hash, schema version, checkout time). The default
+workspace is `./nerdbro-studio`. Checkout refuses to overwrite unsaved local
+edits without `--force`. `status` reports `local_changed`, `remote_changed` and
+`conflict`. `save` sends the whole local document with the lock's base revision;
+saving unchanged content creates no draft but still refreshes the lock, and a
+stale base exits `3` (`VOCABULARY_DRAFT_CONFLICT`) with `source.json` untouched.
+`validate` and `certify` default to the lock's head revision. `preview` sends
+the local, unsaved `source.json` and writes `preview.json` beside it.
+`inspect-browser` captures the Studio Library workspace to `screenshot.png` and
+`browser.json` in the checkout directory; its bounded `browser.capture` activity
+record is reported locally in the command result only.
+
+The flow is create or checkout → edit `source.json` → `status` → `save` (an
+immutable draft) → `validate` → `certify`. Certification is technical evidence;
+approval and publication are human actions in the Studio, and the CLI has no
+approve or publish command. `export` downloads only an approved revision's
+server-built `.kspkg`.
+
+Audio must be AAC in an MP4 container (`.m4a` or `.mp4`) of at most 24 MiB.
+`audio upload` checks the extension and size locally, and the server probes the
+bytes authoritatively. The upload carries only the bytes under the neutral name
+`upload.m4a`/`upload.mp4`; the local path and filename are never sent, printed
+or stored. Uploading requires the `AUDIO_UPLOAD` scope, which new pairings
+receive by default. A session paired by an older CLI gets
+`AGENT_SCOPE_REQUIRED` (exit `4`): run `nerdbro disconnect` and then
+`nerdbro connect`.
+
+Screenshot SHA-256 values identify the exact local artifact inspected in the
+activity stream; screenshot bytes, pixel size, and DPR are audit metadata, not
+semantic certification identity. Certification remains bound to source and
+runtime evidence rather than pixel-identical rendering.

package/dist/attempt.d.ts

@@ -0,0 +1,25 @@
+declare const POINTER_SCHEMA = "kheleshikhi.studio-agent-attempt-pointer.v1";
+export interface AttemptPointer {
+    schema: typeof POINTER_SCHEMA;
+    attempt_id: string;
+    label: string;
+    mode: string;
+    attempt_root: string;
+    server_origin: string;
+    started_at: string;
+}
+export declare function attemptHome(): string;
+export declare function attemptDirectory(attemptId: string): string;
+export declare function readAttemptPointer(start?: string): Promise<{
+    pointer: AttemptPointer;
+    workspace: string;
+} | null>;
+export declare function createAttemptPointer(server: Record<string, unknown>, serverOrigin: string, workspace?: string): Promise<AttemptPointer>;
+export declare function saveCommandEvidence(pointer: AttemptPointer, commandId: string, command: string, result: unknown): Promise<void>;
+export declare function finalizeClient(pointer: AttemptPointer, workspace: string, server: Record<string, unknown>): Promise<{
+    path: string;
+    sha256: string;
+    included: number;
+    excluded: string[];
+}>;
+export {};

package/dist/attempt.js

@@ -0,0 +1,197 @@
+/** Local Attempt pointer and privacy-bounded client evidence finalization. */
+import { randomBytes } from "node:crypto";
+import { spawnSync } from "node:child_process";
+import { lstat, mkdir, readFile, readdir, realpath, stat, writeFile } from "node:fs/promises";
+import os from "node:os";
+import path from "node:path";
+import { CliError } from "./types.js";
+import { makeZip, sha256, verifyZip } from "./zip.js";
+const POINTER_NAME = ".nerdbro-attempt.json";
+const POINTER_SCHEMA = "kheleshikhi.studio-agent-attempt-pointer.v1";
+const MAX_FILE = 32 * 1024 * 1024;
+const MAX_TOTAL = 256 * 1024 * 1024;
+const BLOCKED_DIRS = new Set([".git", "node_modules", ".cache", ".venv", "venv", "__pycache__", ".playwright", "browser-profile", "dist", "build"]);
+const BLOCKED_FILES = /(^\.env(?:\..*)?$|\.pem$|\.key$|^id_rsa|^id_ed25519|cookie|credential|secret|token|\.p12$|\.pfx$|\.sqlite$)/i;
+const SECRET_CONTENT = /nbs_[A-Za-z0-9_-]{12,}|nbp_[A-Za-z0-9_-]{12,}|Bearer\s+[A-Za-z0-9_.-]{20,}|eyJ[A-Za-z0-9_-]{30,}\.[A-Za-z0-9_-]{20,}/i;
+export function attemptHome() {
+    return path.resolve(process.env.NERDBRO_ATTEMPT_ROOT || path.join(os.homedir(), "NerdBroAttempts"));
+}
+export function attemptDirectory(attemptId) {
+    if (!/^att_[A-Za-z0-9_-]{16,36}$/.test(attemptId))
+        throw new CliError("Invalid Attempt ID.", "AGENT_ATTEMPT_ID_INVALID", 2);
+    return path.join(attemptHome(), attemptId);
+}
+export async function readAttemptPointer(start = process.cwd()) {
+    let current = path.resolve(start);
+    while (true) {
+        try {
+            const candidate = JSON.parse(await readFile(path.join(current, POINTER_NAME), "utf8"));
+            if (candidate.schema !== POINTER_SCHEMA || !/^att_[A-Za-z0-9_-]{16,36}$/.test(candidate.attempt_id)) {
+                throw new CliError("Attempt pointer is malformed.", "AGENT_ATTEMPT_POINTER_INVALID", 2);
+            }
+            return { pointer: candidate, workspace: current };
+        }
+        catch (error) {
+            if (error instanceof CliError)
+                throw error;
+            if (error.code !== "ENOENT")
+                throw new CliError("Cannot read Attempt pointer.", "AGENT_ATTEMPT_POINTER_INVALID", 2);
+        }
+        if (current === path.dirname(current) || current === os.homedir())
+            return null;
+        current = path.dirname(current);
+    }
+}
+export async function createAttemptPointer(server, serverOrigin, workspace = process.cwd()) {
+    if (await readAttemptPointer(workspace))
+        throw new CliError("This workspace already has an Attempt pointer.", "AGENT_ATTEMPT_ALREADY_ACTIVE", 3);
+    const attemptId = String(server.attempt_id);
+    const root = attemptDirectory(attemptId);
+    await mkdir(attemptHome(), { recursive: true });
+    await mkdir(root, { recursive: false });
+    const pointer = {
+        schema: POINTER_SCHEMA, attempt_id: attemptId,
+        label: String(server.label), mode: String(server.mode),
+        attempt_root: root, server_origin: serverOrigin,
+        started_at: String(server.started_at),
+    };
+    await writeFile(path.join(workspace, POINTER_NAME), `${JSON.stringify(pointer, null, 2)}\n`, { flag: "wx", mode: 0o600 });
+    await writeFile(path.join(root, "README.md"), `# NerdBro Attempt ${attemptId}\n\nLabel: ${pointer.label}\nMode: ${pointer.mode}\n\nRun \`nerdbro attempt finish --outcome completed|blocked|incomplete|abandoned\` in the original workspace with the accurate outcome, then run \`just studio-agent-attempt-export ${attemptId}\` from the NerdBro repository.\n`);
+    await writeFile(path.join(root, "RUN_MANIFEST.json"), `${JSON.stringify({ schema: "kheleshikhi.studio-agent-attempt-run.v1", ...server }, null, 2)}\n`);
+    return pointer;
+}
+export async function saveCommandEvidence(pointer, commandId, command, result) {
+    const root = attemptDirectory(pointer.attempt_id);
+    const destination = path.join(root, "client", "evidence", command.startsWith("studio.drive") ? "drives" : command.startsWith("studio.inspect") ? "captures" : command.startsWith("studio.certify") ? "certification" : "other");
+    const serialized = JSON.stringify({ command_id: commandId, command, at: new Date().toISOString(), result }, null, 2);
+    if (serialized.length > 1024 * 1024)
+        return;
+    const sanitized = serialized.replace(/nbs_[A-Za-z0-9_-]+|nbp_[A-Za-z0-9_-]+|Bearer\s+[A-Za-z0-9_.-]+|eyJ[A-Za-z0-9_-]{30,}\.[A-Za-z0-9_-]+/g, "[REDACTED]");
+    await mkdir(destination, { recursive: true });
+    await writeFile(path.join(destination, `${commandId}.json`), `${sanitized}\n`, { mode: 0o600 });
+}
+function git(workspace, args, code = "ATTEMPT_GIT_INVALID") {
+    const result = spawnSync("git", args, { cwd: workspace, encoding: "utf8", maxBuffer: 4 * 1024 * 1024 });
+    if (result.status !== 0)
+        throw new CliError(`Cannot read workspace Git state: ${result.stderr?.trim() || result.error?.message || args.join(" ")}`, code, 2);
+    return result.stdout.trim();
+}
+async function snapshot(workspace, relative = "", entries = [], excluded = [], total = { bytes: 0 }) {
+    for (const item of await readdir(path.join(workspace, relative), { withFileTypes: true })) {
+        const name = path.join(relative, item.name);
+        const portable = name.split(path.sep).join("/");
+        if (item.isSymbolicLink() || BLOCKED_FILES.test(item.name) || (item.isDirectory() && BLOCKED_DIRS.has(item.name))) {
+            excluded.push(portable);
+            continue;
+        }
+        if (item.isDirectory()) {
+            await snapshot(workspace, name, entries, excluded, total);
+            continue;
+        }
+        if (!item.isFile()) {
+            excluded.push(portable);
+            continue;
+        }
+        const info = await stat(path.join(workspace, name));
+        if (info.size > MAX_FILE || total.bytes + info.size > MAX_TOTAL) {
+            excluded.push(portable);
+            continue;
+        }
+        const data = await readFile(path.join(workspace, name));
+        if (SECRET_CONTENT.test(data.toString("utf8"))) {
+            excluded.push(portable);
+            continue;
+        }
+        entries.push({ name: `workspace/${portable}`, data });
+        total.bytes += data.length;
+    }
+    return { entries, excluded };
+}
+export async function finalizeClient(pointer, workspace, server) {
+    const root = attemptDirectory(pointer.attempt_id);
+    const client = path.join(root, "client");
+    const reports = path.join(client, "reports");
+    const gitDir = path.join(client, "git");
+    await mkdir(reports, { recursive: true });
+    await mkdir(gitDir, { recursive: true });
+    const reportFiles = [];
+    for (const name of ["REPORT.md", "EVALUATION.md"]) {
+        let data;
+        try {
+            data = await readFile(path.join(workspace, name));
+        }
+        catch {
+            if (pointer.mode === "benchmark")
+                throw new CliError(`${name} is required before finishing this benchmark Attempt.`, name === "REPORT.md" ? "ATTEMPT_REPORT_MISSING" : "ATTEMPT_EVALUATION_MISSING", 2);
+            else
+                continue;
+        }
+        if (!data.length)
+            throw new CliError(`${name} is empty.`, "ATTEMPT_REPORT_EMPTY", 2);
+        if (SECRET_CONTENT.test(data.toString("utf8")))
+            throw new CliError(`${name} contains a credential-like value.`, "ATTEMPT_REPORT_SECRET", 2);
+        await writeFile(path.join(reports, name), data);
+        reportFiles.push({ name: `reports/${name}`, data });
+    }
+    const top = git(workspace, ["rev-parse", "--show-toplevel"]);
+    if (await realpath(top) !== await realpath(workspace))
+        throw new CliError("Finish from the Attempt workspace Git root.", "ATTEMPT_GIT_ROOT_REQUIRED", 2);
+    const statusText = git(workspace, ["status", "--porcelain=v1", "--untracked-files=all"]);
+    const history = `${git(workspace, ["log", "--graph", "--decorate", "--oneline", "--all"])}\n`;
+    const bundlePath = path.join(gitDir, "attempt.gitbundle");
+    git(workspace, ["bundle", "create", bundlePath, "--all"]);
+    const bundle = await readFile(bundlePath);
+    const snap = await snapshot(workspace);
+    const existing = await collectExistingEvidence(path.join(client, "evidence"));
+    const fileEntries = [
+        ...reportFiles, ...snap.entries, ...existing,
+        { name: "git/attempt.gitbundle", data: bundle },
+        { name: "git/history.txt", data: Buffer.from(history) },
+        { name: "git/working-tree-status.txt", data: Buffer.from(`${statusText}\n`) },
+    ];
+    const manifest = {
+        schema: "kheleshikhi.studio-agent-client-manifest.v1",
+        attempt_id: pointer.attempt_id, label: pointer.label, mode: pointer.mode,
+        status: "finished", outcome: server.outcome,
+        started_at: pointer.started_at, finished_at: new Date().toISOString(),
+        cli_version: String(server.initial_cli_version || "unknown"), node_version: process.versions.node,
+        platform: `${process.platform} ${process.arch}`, server_origin: pointer.server_origin,
+        documentation_fingerprint: server.documentation_fingerprint,
+        language_contract_fingerprint: server.language_contract_fingerprint,
+        scene_schema: server.scene_schema, compiler_version: server.compiler_version,
+        runtime_fingerprint: server.runtime_fingerprint,
+        git_head: git(workspace, ["rev-parse", "HEAD"]),
+        git_status: statusText,
+        studio_asset_ids: server.studio_asset_ids || [],
+        command_counts: server.command_counts || {},
+        paths_included: fileEntries.map((entry) => entry.name),
+        paths_excluded: snap.excluded,
+    };
+    const manifestData = Buffer.from(`${JSON.stringify(manifest, null, 2)}\n`);
+    await writeFile(path.join(client, "CLIENT_MANIFEST.json"), manifestData);
+    fileEntries.push({ name: "CLIENT_MANIFEST.json", data: manifestData });
+    const sums = Buffer.from(fileEntries.map((entry) => `${sha256(entry.data)}  ${entry.name}`).join("\n") + "\n");
+    await writeFile(path.join(client, "CLIENT_SHA256SUMS"), sums);
+    fileEntries.push({ name: "CLIENT_SHA256SUMS", data: sums });
+    const bytes = makeZip(fileEntries);
+    if (!verifyZip(bytes))
+        throw new CliError("Client ZIP failed integrity verification.", "ATTEMPT_CLIENT_ZIP_INVALID");
+    const zipPath = path.join(client, "client-attempt.zip");
+    const temporary = `${zipPath}.${randomBytes(4).toString("hex")}.tmp`;
+    await writeFile(temporary, bytes);
+    await (await import("node:fs/promises")).rename(temporary, zipPath);
+    const digest = sha256(bytes);
+    await writeFile(path.join(client, "CLIENT_COMPLETE"), `${JSON.stringify({ attempt_id: pointer.attempt_id, zip_sha256: digest, finished_at: manifest.finished_at })}\n`);
+    return { path: zipPath, sha256: digest, included: fileEntries.length, excluded: snap.excluded };
+}
+async function collectExistingEvidence(directory) {
+    try {
+        await lstat(directory);
+    }
+    catch {
+        return [];
+    }
+    const found = await snapshot(directory);
+    return found.entries.map((entry) => ({ name: `evidence/${entry.name.slice("workspace/".length)}`, data: entry.data }));
+}
+//# sourceMappingURL=attempt.js.map

package/dist/attempt.js.map

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

package/dist/browser.d.ts

@@ -0,0 +1,102 @@
+import { type Page } from "playwright";
+import { AgentApi } from "./protocol.js";
+import { type DriveScenario } from "./scenario.js";
+export declare function studioBrowserLaunchOptions(headless: boolean): {
+    readonly headless: boolean;
+    readonly viewport: null;
+    readonly chromiumSandbox: true;
+};
+export declare function browserProbeLaunchOptions(channel?: "chrome" | "msedge"): {
+    readonly channel: "chrome" | "msedge" | undefined;
+    readonly headless: true;
+    readonly chromiumSandbox: true;
+};
+export declare function cssViewport(value: string): {
+    width: number;
+    height: number;
+};
+export declare function waitForCapturePaint(page: Page): Promise<void>;
+export declare function applyCssViewport(page: Page, dimensions: {
+    width: number;
+    height: number;
+}): Promise<void>;
+export declare function renderingDiagnostics(page: Page, screenshot: Buffer): Promise<Record<string, unknown>>;
+export declare const VIEW_QUERY: Record<string, Record<string, string>>;
+export declare function viewRequiresRuntimeObservation(view: string): boolean;
+interface BrowserCredential {
+    token: string;
+    expiresAt: number;
+    webOrigin: string;
+}
+interface BrowserAuthApi {
+    readonly origin: string;
+    request<T>(method: string, route: string, body?: unknown, authenticated?: boolean): Promise<T>;
+}
+/** Memory-only reuse of the short-lived browser JWT; bootstrap tickets stay one-use. */
+export declare class BrowserCredentialManager {
+    private api;
+    private now;
+    private credential?;
+    private bootstrapCount;
+    private readonly apiOrigin;
+    constructor(api: BrowserAuthApi, now?: () => number);
+    clear(): void;
+    diagnostics(): {
+        browser_credential_cached: boolean;
+        browser_bootstrap_count: number;
+    };
+    tokenForRequest(requestUrl: string): string | undefined;
+    get(forceRefresh?: boolean): Promise<BrowserCredential>;
+}
+export interface BrowserCaptureRequest {
+    asset: string;
+    sourceHash: string;
+    view?: string;
+    viewport?: string;
+    fullPage?: boolean;
+    out: string;
+    timeoutMs?: number;
+    observation?: boolean;
+    drive?: boolean;
+    /** Library workspace route (`?workspace=<name>&selection=<stable id>`) instead of a Scene asset. */
+    library?: {
+        workspace: string;
+        selection: string;
+        revision?: string;
+        definitionHash?: string;
+    };
+}
+export interface PreviewObservationRequest extends BrowserCaptureRequest {
+    mode?: string;
+    duration?: number;
+    fps?: number;
+}
+export declare class StudioBrowser {
+    private api;
+    private context?;
+    private page?;
+    private headless;
+    private browserEngine;
+    private apiOrigin;
+    private credentials;
+    constructor(api: AgentApi);
+    start(headless: boolean): Promise<void>;
+    stop(): Promise<void>;
+    clearAuthentication(): void;
+    authenticationDiagnostics(): {
+        browser_credential_cached: boolean;
+        browser_bootstrap_count: number;
+        browser_engine: string;
+    };
+    private authenticatedPage;
+    open(asset: string, view?: string, allowRefresh?: boolean): Promise<Record<string, unknown>>;
+    capture(request: BrowserCaptureRequest, allowRefresh?: boolean): Promise<Record<string, unknown>>;
+    drive(request: BrowserCaptureRequest & {
+        scenario: DriveScenario;
+        candidate: Record<string, unknown>;
+        candidateHash: string;
+    }): Promise<Record<string, unknown>>;
+    /** Local-agent capture from the same browser page and renderer the Maker sees. */
+    capturePreview(request: PreviewObservationRequest): Promise<Record<string, unknown>>;
+}
+export {};