@graview/guest 0.1.9 → 0.1.12

package/dist/headless/index.js

@@ -0,0 +1,143 @@
+import { checkManifest, manifestActs, workerViewProps } from "../host/manifest.js";
+import { checkViewSource } from "../host/view-source.js";
+import { judgeTranscript } from "./judge.js";
+import { HEADLESS_ENTRY, HEADLESS_VIEW } from "./protocol.js";
+import { HEADLESS_RUNTIME } from "./runtime.generated.js";
+export { describeDrawing } from "./describe.js";
+export { drawTranscript } from "./draw.js";
+export { judgeTranscript, sayRefusal } from "./judge.js";
+export { HEADLESS_ENTRY, HEADLESS_VIEW } from "./protocol.js";
+export { createTree, TreeDocument, TreeElement, TreeText } from "./tree.js";
+/** The script a host's isolate runs for a view's source: the headless runtime, then the view, as a function handed to it at once. */
+export function headlessScript(source) {
+    return `${HEADLESS_RUNTIME}\n;${HEADLESS_VIEW}(function (graview) {\n"use strict";\n${source}\n});\n`;
+}
+/** The framework's own look, light, for a run that is handed none. */
+export const HEADLESS_THEME = {
+    scheme: "light",
+    accent: "#2f7d8c",
+    ground: "#f6f8f9",
+    panel: "#ffffff",
+    ink: "#14212b",
+    inkMuted: "#4f6470",
+    edge: "rgba(20, 33, 43, 0.14)",
+    fontBody: "system-ui, sans-serif",
+    fontMono: "ui-monospace, monospace",
+};
+const failed = (reason, detail, transcript) => ({ ok: false, reason, detail, ...(transcript ? { transcript } : {}) });
+const isRecord = (value) => typeof value === "object" && value !== null && !Array.isArray(value);
+const REASONS = ["manifest", "source", "refused", "error", "silent", "nodes", "flood", "slow", "act", "isolate"];
+/** A transcript as an isolate said it, held to its shape: anything else is no transcript. */
+function transcriptOf(value) {
+    if (!isRecord(value))
+        return undefined;
+    const { renders, css, asked, went, ms, logs, messages } = value;
+    if (!Array.isArray(renders) || !renders.every(Array.isArray) || !Array.isArray(asked) || !Array.isArray(went) || !Array.isArray(logs))
+        return undefined;
+    if (typeof ms !== "number" || typeof messages !== "number" || (css !== undefined && typeof css !== "string"))
+        return undefined;
+    return {
+        renders: renders,
+        ...(typeof css === "string" ? { css } : {}),
+        asked: asked.filter(isRecord).map((one) => ({ name: String(one["name"]), args: one["args"] })),
+        went: went.filter(isRecord).flatMap((one) => (typeof one["record"] === "string" ? [{ record: one["record"] }] : typeof one["place"] === "string" ? [{ place: one["place"] }] : [])),
+        ms,
+        logs: logs.map(String).slice(0, 50),
+        messages,
+    };
+}
+/** The seat a description is for, said as `describePlace` says it. */
+const seatOf = (principal) => (principal.kind === "system" ? "the system" : (principal.roles ?? []).length > 0 ? (principal.roles ?? []).join(", ") : principal.kind);
+const slugOf = (title) => title.toLowerCase().replace(/[^a-z0-9]+/g, "-").replace(/^-|-$/g, "");
+/**
+ * RUN A WORKER VIEW ONCE, HEADLESS, IN THE HOST'S ISOLATE, AND SAY WHAT IT
+ * DREW FOR ONE SEAT. The manifest is checked against the app and the
+ * source against what a view may say before anything runs; the view is
+ * handed the seat's sight cut to its manifest; what comes back is judged
+ * here, in the host's context, from the transcript alone.
+ */
+export async function runWorkerViewHeadless(options) {
+    if (typeof options.run !== "function") {
+        throw new TypeError("runWorkerViewHeadless runs a view only in an isolate the host supplies (`run`); it never runs one in the host's own context.");
+    }
+    const { manifest, source, store, principal } = options;
+    const limits = {
+        maxSourceBytes: options.limits?.maxSourceBytes ?? 256_000,
+        maxNodes: options.limits?.maxNodes ?? 5_000,
+        messages: options.limits?.messages ?? 120,
+        pushMs: options.limits?.pushMs ?? 1_000,
+        runMs: options.limits?.runMs ?? 5_000,
+    };
+    const findings = checkManifest(manifest, store);
+    if (findings.length > 0)
+        return failed("manifest", findings.join(" "));
+    if (typeof source !== "string")
+        return failed("source", "A view's source is text.");
+    if (new TextEncoder().encode(source).length > limits.maxSourceBytes)
+        return failed("source", `Its code is longer than the ${limits.maxSourceBytes.toLocaleString("en-US")} bytes a view may be.`);
+    const unloadable = checkViewSource(source);
+    if (unloadable.length > 0)
+        return failed("source", unloadable.join(" "));
+    const places = options.places ?? [];
+    const props = workerViewProps(store, principal, { manifest, ...(options.input ? { input: options.input } : {}), theme: options.theme ?? HEADLESS_THEME, places });
+    const input = {
+        props,
+        acts: manifestActs(manifest).map((one) => one.as ?? one.act),
+        places: places.map((place) => place.as),
+        limits: { maxNodes: limits.maxNodes, messages: limits.messages, pushMs: limits.pushMs },
+    };
+    /* The isolate, the host's: past `runMs` it is stopped, whatever its runner does. */
+    let text;
+    let stop;
+    try {
+        const ran = options.run({ script: headlessScript(source), entry: HEADLESS_ENTRY, input: JSON.stringify(input), timeoutMs: limits.runMs });
+        const late = new Promise((_, reject) => {
+            stop = setTimeout(() => reject(Object.assign(new Error("past runMs"), { reason: "slow" })), limits.runMs + 1_000);
+        });
+        text = await Promise.race([ran, late]);
+    }
+    catch (error) {
+        if (isRecord(error) && error["reason"] === "slow")
+            return failed("slow", `It ran longer than the ${limits.runMs.toLocaleString("en-US")} ms a headless run may take.`);
+        return failed("isolate", `The isolate could not run it: ${error instanceof Error ? error.message : String(error)}`);
+    }
+    finally {
+        if (stop !== undefined)
+            clearTimeout(stop);
+    }
+    let outcome;
+    try {
+        outcome = JSON.parse(String(text));
+    }
+    catch {
+        return failed("isolate", "The isolate answered with something that is not an outcome.");
+    }
+    if (!isRecord(outcome))
+        return failed("isolate", "The isolate answered with something that is not an outcome.");
+    const transcript = transcriptOf(outcome["transcript"]);
+    if (outcome["ok"] !== true) {
+        const reason = REASONS.includes(outcome["reason"]) ? outcome["reason"] : "isolate";
+        return failed(reason, typeof outcome["detail"] === "string" ? outcome["detail"].slice(0, 2_000) : "It failed, and the isolate did not say why.", transcript);
+    }
+    if (!transcript)
+        return failed("isolate", "The isolate answered without what the view sent.");
+    /* Judged again here, from the transcript alone. */
+    const judged = judgeTranscript(transcript, input);
+    if (!judged.ok)
+        return failed(judged.reason, judged.detail, transcript);
+    const title = manifest.title ?? manifest.name;
+    const slug = manifest.title ? slugOf(manifest.title) : manifest.name;
+    const kind = manifest.attach === "home" ? null : manifest.attach;
+    const description = {
+        place: { slug: manifest.attach === "home" ? "home" : slug, title, kind, address: manifest.attach === "home" ? "/" : `/places/${encodeURIComponent(slug)}` },
+        seat: seatOf(principal),
+        width: options.width ?? 1440,
+        variant: (options.width ?? 1440) < 640 ? "phone" : "wide",
+        drawnBy: `view:${manifest.name}`,
+        parts: judged.parts,
+        problems: judged.problems,
+    };
+    const { placeText } = await import("@graview/core/describe");
+    return { ok: true, description: { ...description, text: placeText(description) }, props, transcript };
+}
+//# sourceMappingURL=index.js.map

package/dist/headless/index.js.map

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

package/dist/headless/judge.d.ts

@@ -0,0 +1,16 @@
+import type { DescribedPart, DescribedProblem } from "@graview/core/describe";
+import type { ViewRefusal } from "../host/open-draw.js";
+import type { HeadlessFailureReason, HeadlessInput, HeadlessTranscript } from "./protocol.js";
+export type Judged = {
+    readonly ok: true;
+    readonly parts: readonly DescribedPart[];
+    readonly problems: readonly DescribedProblem[];
+} | {
+    readonly ok: false;
+    readonly reason: HeadlessFailureReason;
+    readonly detail: string;
+};
+/** One refusal of the open kit's, said to the author of the view. */
+export declare function sayRefusal(refusal: ViewRefusal): DescribedProblem;
+export declare function judgeTranscript(transcript: HeadlessTranscript, input: HeadlessInput): Judged;
+//# sourceMappingURL=judge.d.ts.map

package/dist/headless/judge.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"judge.d.ts","sourceRoot":"","sources":["../../src/headless/judge.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,sBAAsB,CAAC;AAGxD,OAAO,KAAK,EAAE,qBAAqB,EAAE,aAAa,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAW9F,MAAM,MAAM,MAAM,GACd;IAAE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAAC,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;IAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAA;CAAE,GAC/G;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAE5F,qEAAqE;AACrE,wBAAgB,UAAU,CAAC,OAAO,EAAE,WAAW,GAAG,gBAAgB,CAqBjE;AAED,wBAAgB,eAAe,CAAC,UAAU,EAAE,kBAAkB,EAAE,KAAK,EAAE,aAAa,GAAG,MAAM,CAmB5F"}

package/dist/headless/judge.js

@@ -0,0 +1,52 @@
+import { describeDrawing } from "./describe.js";
+import { drawTranscript } from "./draw.js";
+/** One refusal of the open kit's, said to the author of the view. */
+export function sayRefusal(refusal) {
+    const element = "element" in refusal && refusal.element ? `<${refusal.element}>` : "";
+    const name = refusal.name ? ` ${refusal.name}` : "";
+    switch (refusal.reason) {
+        case "element":
+            return { at: `drawing ${element}`, says: `Not drawn: ${element} is not in the open kit.` };
+        case "attribute":
+            return { at: `drawing ${element}${name}`, says: `Not drawn: ${element || "an element"} does not take${name}.` };
+        case "value":
+            return { at: `drawing ${element}${name}`, says: `Not drawn: the value of${name} is not one the open kit takes.` };
+        case "url":
+            return { at: `drawing ${element}${name}`, says: `Not drawn: an address. A view loads nothing; an image is a data: image.` };
+        case "child":
+            return { at: `drawing ${element}`, says: `Not drawn: ${element} holds nothing.` };
+        case "record":
+            return { at: "drawing", says: "Not drawn: a record the drawing's format does not know." };
+        case "budget":
+            return { at: "drawing", says: "Not drawn: more nodes than a view may draw." };
+        case "css":
+            return { at: `stylesheet${name === " stylesheet" ? "" : name}`, says: `Not drawn: CSS the open kit leaves out${refusal.css ? ` (${refusal.css.reason}${refusal.css.name ? ` ${refusal.css.name}` : ""})` : ""}.` };
+    }
+}
+export function judgeTranscript(transcript, input) {
+    const { limits } = input;
+    if (transcript.messages > limits.messages)
+        return { ok: false, reason: "flood", detail: `It sent ${transcript.messages} messages, more than the ${limits.messages} a view may send in a second.` };
+    const acts = new Set(input.acts);
+    for (const asked of transcript.asked) {
+        if (!acts.has(asked.name))
+            return { ok: false, reason: "act", detail: `It asks for the act "${asked.name}", which its manifest does not name.` };
+    }
+    const drawn = drawTranscript(transcript.renders, transcript.css, { maxNodes: limits.maxNodes });
+    if (drawn.over)
+        return { ok: false, reason: "nodes", detail: `It drew more than the ${limits.maxNodes.toLocaleString("en-US")} things a view may draw.` };
+    const said = describeDrawing(drawn.root, { props: input.props, places: input.places });
+    for (const act of said.acts) {
+        if (!acts.has(act))
+            return { ok: false, reason: "act", detail: `It binds a press to the act "${act}" (data-act), which its manifest does not name.` };
+    }
+    const problems = [...drawn.refused.map(sayRefusal), ...said.problems];
+    for (const went of transcript.went) {
+        if ("record" in went && !(input.props.node?.id === went.record || (input.props.nodes ?? []).some((node) => node.id === went.record)))
+            problems.push({ at: "navigate", says: `It goes to "${went.record}", which this seat was not shown: the host will not follow it.` });
+        if ("place" in went && !input.places.includes(went.place))
+            problems.push({ at: "navigate", says: `It goes to the place "${went.place}", which this app does not have.` });
+    }
+    return { ok: true, parts: said.parts, problems };
+}
+//# sourceMappingURL=judge.js.map

package/dist/headless/judge.js.map

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

package/dist/headless/node.d.ts

@@ -0,0 +1,8 @@
+import type { HeadlessRun } from "./index.js";
+export interface NodeIsolateOptions {
+    /** The thread's heap ceiling, in megabytes. 128 by default. */
+    readonly maxHeapMb?: number;
+}
+/** A `run` that gives each headless run a worker thread and a fresh, empty context of its own. */
+export declare function nodeIsolate(options?: NodeIsolateOptions): HeadlessRun;
+//# sourceMappingURL=node.d.ts.map

package/dist/headless/node.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.d.ts","sourceRoot":"","sources":["../../src/headless/node.ts"],"names":[],"mappings":"AAoBA,OAAO,KAAK,EAAmB,WAAW,EAAE,MAAM,YAAY,CAAC;AAE/D,MAAM,WAAW,kBAAkB;IACjC,+DAA+D;IAC/D,QAAQ,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC;CAC7B;AA6BD,kGAAkG;AAClG,wBAAgB,WAAW,CAAC,OAAO,GAAE,kBAAuB,GAAG,WAAW,CA6BzE"}

package/dist/headless/node.js

@@ -0,0 +1,80 @@
+/*
+ * AN ISOLATE FOR A HEADLESS RUN, IN NODE (FR-95): `@graview/guest/headless/node`.
+ *
+ * The reference `run` for `runWorkerViewHeadless`, for tests, for
+ * `graview view check`, and for a Node host that has nothing better. Each
+ * run gets a worker thread of its own, with a memory ceiling, and in it a
+ * fresh V8 context made from nothing: the language's own globals and no
+ * others — no `process`, no `require`, no `fetch`, no sockets, no timers —
+ * with code from strings and WebAssembly refused. The script is run there
+ * with a deadline that covers the microtasks it queues, and only text comes
+ * back. Past the deadline the context is abandoned and the thread ended.
+ *
+ * A context is not a security boundary in Node's own words, and this does
+ * not lean on it alone: nothing of the thread's is put into the context to
+ * be climbed back out of, the view is hardened inside it as a worker's
+ * would be, and the thread is ended when the run is done. A host that runs
+ * views it did not write, at scale, should run them in an isolate built
+ * for it — workerd with no outbound network is what Graview Cloud uses.
+ */
+import { Worker } from "node:worker_threads";
+/** What runs in the thread: the context, the script, the entry called once, and text back. */
+const THREAD = `
+const { parentPort, workerData } = require("node:worker_threads");
+const vm = require("node:vm");
+const { script, entry, input, timeoutMs } = workerData;
+const deadline = Date.now() + timeoutMs;
+const left = () => Math.max(1, deadline - Date.now());
+const context = vm.createContext(Object.create(null), {
+  name: "graview headless view",
+  codeGeneration: { strings: false, wasm: false },
+  microtaskMode: "afterEvaluate",
+});
+try {
+  vm.runInContext(script, context, { timeout: left(), filename: "graview-headless-view.js" });
+  const read = vm.runInContext(
+    "(function () { var out; var run = globalThis[" + JSON.stringify(entry) + "]; if (typeof run === 'function') run(" + JSON.stringify(input) + ").then(function (text) { out = text; }); return function () { return out; }; })()",
+    context,
+    { timeout: left() },
+  );
+  const text = read();
+  parentPort.postMessage(typeof text === "string" ? { ok: true, text } : { ok: false, reason: "isolate", error: "The view's run did not finish: it waits on something a headless run never gives it." });
+} catch (error) {
+  const late = error !== null && typeof error === "object" && error.code === "ERR_SCRIPT_EXECUTION_TIMEOUT";
+  parentPort.postMessage({ ok: false, reason: late ? "slow" : "isolate", error: late ? "It ran past its deadline." : String(error && typeof error === "object" && "message" in error ? error.message : error).slice(0, 500) });
+}
+`;
+/** A `run` that gives each headless run a worker thread and a fresh, empty context of its own. */
+export function nodeIsolate(options = {}) {
+    return (payload) => new Promise((resolve, reject) => {
+        const worker = new Worker(THREAD, {
+            eval: true,
+            workerData: { script: payload.script, entry: payload.entry, input: payload.input, timeoutMs: payload.timeoutMs },
+            resourceLimits: { maxOldGenerationSizeMb: options.maxHeapMb ?? 128 },
+            env: {},
+            stdout: true,
+            stderr: true,
+        });
+        let done = false;
+        const end = (settle) => {
+            if (done)
+                return;
+            done = true;
+            clearTimeout(timer);
+            void worker.terminate();
+            settle();
+        };
+        const refuse = (reason, message) => end(() => reject(Object.assign(new Error(message), { reason })));
+        /* The thread's own deadline covers the script and its microtasks; this one covers a thread that never answers. */
+        const timer = setTimeout(() => refuse("slow", "It ran past its deadline."), payload.timeoutMs + 500);
+        worker.once("message", (message) => {
+            if (message.ok && typeof message.text === "string")
+                end(() => resolve(message.text));
+            else
+                refuse(message.reason === "slow" ? "slow" : "isolate", message.error ?? "The isolate could not run it.");
+        });
+        worker.once("error", (error) => refuse("isolate", error.code === "ERR_WORKER_OUT_OF_MEMORY" ? "It used more memory than a headless run may." : error.message));
+        worker.once("exit", () => refuse("isolate", "The isolate stopped before it answered."));
+    });
+}
+//# sourceMappingURL=node.js.map

package/dist/headless/node.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"node.js","sourceRoot":"","sources":["../../src/headless/node.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;GAkBG;AACH,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAQ7C,8FAA8F;AAC9F,MAAM,MAAM,GAAG;;;;;;;;;;;;;;;;;;;;;;;;CAwBd,CAAC;AAEF,kGAAkG;AAClG,MAAM,UAAU,WAAW,CAAC,UAA8B,EAAE;IAC1D,OAAO,CAAC,OAAwB,EAAE,EAAE,CAClC,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,MAAM,EAAE,EAAE;QACtC,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,MAAM,EAAE;YAChC,IAAI,EAAE,IAAI;YACV,UAAU,EAAE,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,SAAS,EAAE,OAAO,CAAC,SAAS,EAAE;YAChH,cAAc,EAAE,EAAE,sBAAsB,EAAE,OAAO,CAAC,SAAS,IAAI,GAAG,EAAE;YACpE,GAAG,EAAE,EAAE;YACP,MAAM,EAAE,IAAI;YACZ,MAAM,EAAE,IAAI;SACb,CAAC,CAAC;QACH,IAAI,IAAI,GAAG,KAAK,CAAC;QACjB,MAAM,GAAG,GAAG,CAAC,MAAkB,EAAE,EAAE;YACjC,IAAI,IAAI;gBAAE,OAAO;YACjB,IAAI,GAAG,IAAI,CAAC;YACZ,YAAY,CAAC,KAAK,CAAC,CAAC;YACpB,KAAK,MAAM,CAAC,SAAS,EAAE,CAAC;YACxB,MAAM,EAAE,CAAC;QACX,CAAC,CAAC;QACF,MAAM,MAAM,GAAG,CAAC,MAA0B,EAAE,OAAe,EAAE,EAAE,CAAC,GAAG,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,KAAK,CAAC,OAAO,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,CAAC;QACjI,kHAAkH;QAClH,MAAM,KAAK,GAAG,UAAU,CAAC,GAAG,EAAE,CAAC,MAAM,CAAC,MAAM,EAAE,2BAA2B,CAAC,EAAE,OAAO,CAAC,SAAS,GAAG,GAAG,CAAC,CAAC;QACrG,MAAM,CAAC,IAAI,CAAC,SAAS,EAAE,CAAC,OAAoF,EAAE,EAAE;YAC9G,IAAI,OAAO,CAAC,EAAE,IAAI,OAAO,OAAO,CAAC,IAAI,KAAK,QAAQ;gBAAE,GAAG,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,OAAO,CAAC,IAAK,CAAC,CAAC,CAAC;;gBACjF,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,EAAE,OAAO,CAAC,KAAK,IAAI,+BAA+B,CAAC,CAAC;QAChH,CAAC,CAAC,CAAC;QACH,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,EAAE,CAAC,MAAM,CAAC,SAAS,EAAG,KAA2B,CAAC,IAAI,KAAK,0BAA0B,CAAC,CAAC,CAAC,8CAA8C,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC;QACtL,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,SAAS,EAAE,yCAAyC,CAAC,CAAC,CAAC;IAC1F,CAAC,CAAC,CAAC;AACP,CAAC"}

package/dist/headless/protocol.d.ts

@@ -0,0 +1,75 @@
+import type { DescribedPart, DescribedProblem } from "@graview/core/describe";
+import type { GuestProps } from "../protocol.js";
+/** The global function a headless script leaves for its isolate to call, once. */
+export declare const HEADLESS_ENTRY = "graviewHeadless";
+/** The global a headless script hands the view to, as a function, on its own last line: run at once. */
+export declare const HEADLESS_VIEW = "graviewHeadlessView";
+/** What a run is told, as the JSON text of `HeadlessPayload.input`. */
+export interface HeadlessInput {
+    /** What the view is shown: the seat's sight cut to its manifest (FR-91). */
+    readonly props: GuestProps;
+    /** What the view may ask for or bind a press to, by the name it uses: the manifest's acts. */
+    readonly acts: readonly string[];
+    /** The app's places, by slug. */
+    readonly places: readonly string[];
+    readonly limits: {
+        readonly maxNodes: number;
+        readonly messages: number;
+        readonly pushMs: number;
+    };
+}
+/** What the view said, in order: every message the host would have heard. */
+export interface HeadlessTranscript {
+    /** Each batch of Remote DOM mutation records it sent. */
+    readonly renders: readonly unknown[][];
+    /** Its stylesheet, as it gave it. */
+    readonly css?: string;
+    /** The acts it asked for from its code. Nothing is applied in a headless run. */
+    readonly asked: readonly {
+        readonly name: string;
+        readonly args: unknown;
+    }[];
+    /** Where it asked to go. */
+    readonly went: readonly ({
+        readonly record: string;
+    } | {
+        readonly place: string;
+    })[];
+    /** The view's own time, at the top of its script and over the push, as the isolate's clock says it. */
+    readonly ms: number;
+    /** What it wrote to the console, the first 50 lines. */
+    readonly logs: readonly string[];
+    /** How many messages it sent. */
+    readonly messages: number;
+}
+/**
+ * Why a headless run says a view will not do: the live host's reasons
+ * (`WorkerViewFailure`) but `start`, which a run with no worker to start
+ * cannot meet; `refused`, the isolate's own refusal to run it; and two more.
+ */
+export type HeadlessFailureReason = "manifest" | "source" | "refused" | "error" | "silent" | "nodes" | "flood" | "slow"
+/** It names an act its manifest does not: asked from its code, or bound to a press (`data-act`). */
+ | "act"
+/** The host's isolate could not run it, or answered with something that is not an outcome. */
+ | "isolate";
+/** What an isolate answers, as the JSON text its entry resolves with. */
+export type HeadlessOutcome = {
+    readonly ok: true;
+    readonly transcript: HeadlessTranscript;
+    /** What it drew, as the isolate read it. A host that has the transcript reads it again itself. */
+    readonly drawn: {
+        readonly parts: readonly DescribedPart[];
+        readonly problems: readonly DescribedProblem[];
+    };
+    /** How many names hardening took from the isolate's global, and whether it takes no new ones. */
+    readonly hardening: {
+        readonly removed: number;
+        readonly sealed: boolean;
+    };
+} | {
+    readonly ok: false;
+    readonly reason: HeadlessFailureReason;
+    readonly detail: string;
+    readonly transcript?: HeadlessTranscript;
+};
+//# sourceMappingURL=protocol.d.ts.map

package/dist/headless/protocol.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.d.ts","sourceRoot":"","sources":["../../src/headless/protocol.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC9E,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAYjD,kFAAkF;AAClF,eAAO,MAAM,cAAc,oBAAoB,CAAC;AAEhD,wGAAwG;AACxG,eAAO,MAAM,aAAa,wBAAwB,CAAC;AAEnD,uEAAuE;AACvE,MAAM,WAAW,aAAa;IAC5B,4EAA4E;IAC5E,QAAQ,CAAC,KAAK,EAAE,UAAU,CAAC;IAC3B,8FAA8F;IAC9F,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,iCAAiC;IACjC,QAAQ,CAAC,MAAM,EAAE,SAAS,MAAM,EAAE,CAAC;IACnC,QAAQ,CAAC,MAAM,EAAE;QAAE,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,CAAC;CACpG;AAED,6EAA6E;AAC7E,MAAM,WAAW,kBAAkB;IACjC,yDAAyD;IACzD,QAAQ,CAAC,OAAO,EAAE,SAAS,OAAO,EAAE,EAAE,CAAC;IACvC,qCAAqC;IACrC,QAAQ,CAAC,GAAG,CAAC,EAAE,MAAM,CAAC;IACtB,iFAAiF;IACjF,QAAQ,CAAC,KAAK,EAAE,SAAS;QAAE,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAA;KAAE,EAAE,CAAC;IAC7E,4BAA4B;IAC5B,QAAQ,CAAC,IAAI,EAAE,SAAS,CAAC;QAAE,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAA;KAAE,GAAG;QAAE,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAA;KAAE,CAAC,EAAE,CAAC;IACrF,uGAAuG;IACvG,QAAQ,CAAC,EAAE,EAAE,MAAM,CAAC;IACpB,wDAAwD;IACxD,QAAQ,CAAC,IAAI,EAAE,SAAS,MAAM,EAAE,CAAC;IACjC,iCAAiC;IACjC,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;CAC3B;AAED;;;;GAIG;AACH,MAAM,MAAM,qBAAqB,GAC7B,UAAU,GACV,QAAQ,GACR,SAAS,GACT,OAAO,GACP,QAAQ,GACR,OAAO,GACP,OAAO,GACP,MAAM;AACR,oGAAoG;GAClG,KAAK;AACP,8FAA8F;GAC5F,SAAS,CAAC;AAEd,yEAAyE;AACzE,MAAM,MAAM,eAAe,GACvB;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,UAAU,EAAE,kBAAkB,CAAC;IACxC,kGAAkG;IAClG,QAAQ,CAAC,KAAK,EAAE;QAAE,QAAQ,CAAC,KAAK,EAAE,SAAS,aAAa,EAAE,CAAC;QAAC,QAAQ,CAAC,QAAQ,EAAE,SAAS,gBAAgB,EAAE,CAAA;KAAE,CAAC;IAC7G,iGAAiG;IACjG,QAAQ,CAAC,SAAS,EAAE;QAAE,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,CAAC,MAAM,EAAE,OAAO,CAAA;KAAE,CAAC;CAC5E,GACD;IAAE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,qBAAqB,CAAC;IAAC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IAAC,QAAQ,CAAC,UAAU,CAAC,EAAE,kBAAkB,CAAA;CAAE,CAAC"}

package/dist/headless/protocol.js

@@ -0,0 +1,14 @@
+/*
+ * WHAT A HOST AND A HEADLESS RUN SAY TO EACH OTHER (FR-95): text in, text
+ * out. The host hands its isolate one script and one JSON string; the
+ * isolate calls the script's entry with the string and hands back the
+ * string it resolves with. Nothing else crosses — no object, no function —
+ * so an isolate the host picked (workerd, a worker thread, a browser
+ * worker) is all a run needs, and the host's own context never runs a line
+ * of the view.
+ */
+/** The global function a headless script leaves for its isolate to call, once. */
+export const HEADLESS_ENTRY = "graviewHeadless";
+/** The global a headless script hands the view to, as a function, on its own last line: run at once. */
+export const HEADLESS_VIEW = "graviewHeadlessView";
+//# sourceMappingURL=protocol.js.map

package/dist/headless/protocol.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"protocol.js","sourceRoot":"","sources":["../../src/headless/protocol.ts"],"names":[],"mappings":"AAGA;;;;;;;;GAQG;AAEH,kFAAkF;AAClF,MAAM,CAAC,MAAM,cAAc,GAAG,iBAAiB,CAAC;AAEhD,wGAAwG;AACxG,MAAM,CAAC,MAAM,aAAa,GAAG,qBAAqB,CAAC"}

package/dist/headless/runtime.d.ts

@@ -0,0 +1,2 @@
+import "@remote-dom/core/polyfill";
+//# sourceMappingURL=runtime.d.ts.map

package/dist/headless/runtime.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.d.ts","sourceRoot":"","sources":["../../src/headless/runtime.ts"],"names":[],"mappings":"AA4BA,OAAO,2BAA2B,CAAC"}

package/dist/headless/runtime.generated.d.ts

@@ -0,0 +1,2 @@
+export declare const HEADLESS_RUNTIME: string;
+//# sourceMappingURL=runtime.generated.d.ts.map

package/dist/headless/runtime.generated.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.generated.d.ts","sourceRoot":"","sources":["../../src/headless/runtime.generated.ts"],"names":[],"mappings":"AAMA,eAAO,MAAM,gBAAgB,EAAE,MAAihpG,CAAC"}