@descryy/mcp 0.11.5 → 0.11.7

package/dist/tools/browser-navigate.js

@@ -0,0 +1,106 @@
+/** `browser_navigate` moves an open session to another page. Cross-origin navigate refuses —
+ *  never re-prompts — since navigation is the one place a session's consent could otherwise widen
+ *  into a general-purpose browser. `class: "stateful-read"`: it changes what later calls see, but
+ *  the developer's approval was already stated at `browser_start_session`. */
+import { browserAnswer, emptyEvidence, observeAndCorrelate, reachNotes, useSession, withinConsent } from "../browser/tool-support.js";
+import { NO_GRAPH_WRITE } from "../browser/graph-write.js";
+import { CANCELLED_STATE, cancellationHeadline, cancellationNotes } from "../cancellation.js";
+import { requiredString } from "./kit.js";
+import { fitSnapshot, NO_REACH } from "./browser-snapshot.js";
+const SCHEMA = {
+    type: "object",
+    properties: {
+        sessionId: {
+            type: "string",
+            description: "REQUIRED. The id returned by browser_start_session. Sessions belong to this connection and do not survive a reconnect.",
+        },
+        url: {
+            type: "string",
+            description: "REQUIRED. Where to navigate. Must be on the same origin the session was started against — a URL " +
+                "on any other origin is refused rather than confirmed again, because consent was granted for one " +
+                "application, not for the browser generally.",
+        },
+    },
+    required: ["sessionId", "url"],
+    additionalProperties: false,
+};
+function blank(url, evidence) {
+    return { sessionId: "", url, title: "", elements: [], totalElements: 0, reach: NO_REACH, evidence, graph: NO_GRAPH_WRITE };
+}
+/** Exported so `browser-read.ts` can dispatch the "navigate" verb to this exact body — the merge
+ *  reuses this function rather than reimplementing it (mcp-surface-consolidation.md). */
+export async function run(args, ctx) {
+    const sessionId = requiredString(args, "sessionId");
+    const url = requiredString(args, "url");
+    // Checked before the session is touched: the caller said stop, so nothing happens. The session
+    // itself stays open — it belongs to browser_start_session's consent, not to this call.
+    if (ctx.signal.aborted) {
+        return browserAnswer({
+            ctx,
+            state: CANCELLED_STATE,
+            headline: cancellationHeadline("the browser did not move"),
+            notes: cancellationNotes("The page is where it was.", "The browser session is still open and can still be used."),
+            data: blank(url, emptyEvidence()),
+        });
+    }
+    const found = await useSession(ctx.session.browserSessions(), sessionId);
+    if (!found.ok) {
+        return browserAnswer({
+            ctx,
+            state: found.dead.state,
+            headline: found.dead.headline,
+            notes: found.dead.notes,
+            data: blank(url, found.dead.evidence),
+        });
+    }
+    const { entry } = found;
+    if (!withinConsent(entry, url)) {
+        return browserAnswer({
+            ctx,
+            state: "refused",
+            headline: `${url} is outside this session's consented origin.`,
+            notes: [
+                `This session was started against ${entry.consentedOrigin} and consent is bound to that origin. ` +
+                    `Navigating to ${url} would take the browser somewhere the developer did not approve, so it is ` +
+                    "refused rather than confirmed again — asking a second time here is how a gate becomes a habit. " +
+                    "Start a new session if you genuinely mean to drive that origin.",
+            ],
+            data: blank(url, emptyEvidence()),
+        });
+    }
+    ctx.progress(`Navigating to ${url}`);
+    await entry.page.navigate(url);
+    const snapshot = await entry.page.snapshot();
+    const observed = await observeAndCorrelate(ctx, entry);
+    const evidence = observed.evidence;
+    const data = {
+        sessionId: entry.sessionId,
+        url: snapshot.url,
+        title: snapshot.title,
+        elements: snapshot.elements,
+        totalElements: snapshot.totalElements,
+        reach: { frames: snapshot.frames, shadow: snapshot.shadow, hidden: snapshot.hidden, reveal: snapshot.reveal },
+        evidence,
+        graph: observed.graph,
+    };
+    return browserAnswer({
+        ctx,
+        headline: `${snapshot.url} — ${snapshot.title || "untitled"} (${snapshot.totalElements} elements).`,
+        notes: [...observed.notes, ...reachNotes(snapshot)],
+        data,
+        fitToBudget: (budgetBytes) => fitSnapshot(data, budgetBytes),
+    });
+}
+export const browserNavigateTool = {
+    name: "browser_navigate",
+    title: "Navigate an open browser session",
+    description: "Move an open browser session to another page on the same application, and return what is there plus " +
+        "anything the page produced on the way — console errors and failed requests, raw and untriaged. " +
+        "Refuses to leave the origin the session was started against.",
+    class: "stateful-read",
+    tier: "evidence",
+    version: "1.0.0",
+    inputSchema: SCHEMA,
+    run,
+};
+//# sourceMappingURL=browser-navigate.js.map

package/dist/tools/browser-navigate.js.map

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

package/dist/tools/browser-read.d.ts

@@ -0,0 +1,33 @@
+/**
+ * `browser_read` — merges the four browser tools that read a page without needing consent of
+ * their own: `browser_snapshot`, `browser_navigate`, `browser_wait_for`, `browser_close_session`
+ * (documents/plans/mcp-surface-consolidation.md, group 2).
+ *
+ * `class: "stateful-read"` — deliberately not `action`. None of the four mutates the application;
+ * the developer's consent for driving it was already given at `browser_start_session`. What they
+ * DO change is what a *later* call in the same session sees (each takes a fresh snapshot, which
+ * invalidates every ref issued before it) — that is what "stateful" means here, and it is why
+ * `browser_snapshot` was never `read`-class to begin with. Declaring `browser_read` as `action`
+ * would put a plain read behind a confirmation handshake it has never needed; the other eight
+ * `browser_*` verbs (the ones that DO mutate) are a separate merge, owned elsewhere, and are not
+ * touched by this file.
+ *
+ * Dispatches on "verb" to each absorbed tool's exact `run` body — extracted, not reimplemented,
+ * so behaviour is unchanged per verb.
+ */
+import type { ToolDefinition } from "./kit.ts";
+import type { BrowserPageData } from "./browser-snapshot.ts";
+import type { BrowserNavigateData } from "./browser-navigate.ts";
+import type { BrowserWaitForData } from "./browser-wait-for.ts";
+import type { BrowserCloseSessionData } from "./browser-close-session.ts";
+/**
+ * What this tool answers with: one verb's shape, never a merged one.
+ *
+ * The merge cost this its single concrete output type, and `unknown` would have
+ * silently retired `output-shapes.test.ts`'s check that a declared shape is tied
+ * to the code producing it. A union keeps that tie: a verb added without its
+ * shape here stops compiling.
+ */
+export type BrowserReadData = BrowserPageData | BrowserNavigateData | BrowserWaitForData | BrowserCloseSessionData;
+export declare const browserReadTool: ToolDefinition;
+//# sourceMappingURL=browser-read.d.ts.map

package/dist/tools/browser-read.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-read.d.ts","sourceRoot":"","sources":["../../src/tools/browser-read.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAGH,OAAO,KAAK,EAAe,cAAc,EAAE,MAAM,UAAU,CAAC;AAO5D,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAC7D,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,uBAAuB,CAAC;AACjE,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC;AAChE,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,4BAA4B,CAAC;AAE1E;;;;;;;GAOG;AACH,MAAM,MAAM,eAAe,GACvB,eAAe,GACf,mBAAmB,GACnB,kBAAkB,GAClB,uBAAuB,CAAC;AA0E5B,eAAO,MAAM,eAAe,EAAE,cAY7B,CAAC"}

package/dist/tools/browser-read.js

@@ -0,0 +1,105 @@
+/**
+ * `browser_read` — merges the four browser tools that read a page without needing consent of
+ * their own: `browser_snapshot`, `browser_navigate`, `browser_wait_for`, `browser_close_session`
+ * (documents/plans/mcp-surface-consolidation.md, group 2).
+ *
+ * `class: "stateful-read"` — deliberately not `action`. None of the four mutates the application;
+ * the developer's consent for driving it was already given at `browser_start_session`. What they
+ * DO change is what a *later* call in the same session sees (each takes a fresh snapshot, which
+ * invalidates every ref issued before it) — that is what "stateful" means here, and it is why
+ * `browser_snapshot` was never `read`-class to begin with. Declaring `browser_read` as `action`
+ * would put a plain read behind a confirmation handshake it has never needed; the other eight
+ * `browser_*` verbs (the ones that DO mutate) are a separate merge, owned elsewhere, and are not
+ * touched by this file.
+ *
+ * Dispatches on "verb" to each absorbed tool's exact `run` body — extracted, not reimplemented,
+ * so behaviour is unchanged per verb.
+ */
+import { selectVerb } from "./verb.js";
+import { WAIT_TIMEOUT_MAX_MS } from "../browser/wait-target.js";
+import { run as runSnapshot } from "./browser-snapshot.js";
+import { run as runNavigate } from "./browser-navigate.js";
+import { run as runWaitFor } from "./browser-wait-for.js";
+import { run as runClose } from "./browser-close-session.js";
+const VERB_SPECS = [
+    { verb: "snapshot", accepts: ["startAt", "limit", "reveal"] },
+    { verb: "navigate", accepts: ["url"] },
+    { verb: "wait_for", accepts: ["role", "name", "timeoutMs"] },
+    { verb: "close", accepts: [] },
+];
+/** Every verb needs the session it reads — genuinely shared, not one verb's property leaking
+ *  into another's. */
+const SHARED_PROPS = ["sessionId"];
+const SCHEMA = {
+    type: "object",
+    properties: {
+        verb: {
+            type: "string",
+            enum: ["snapshot", "navigate", "wait_for", "close"],
+            description: "Which read to perform: snapshot, navigate, wait_for, or close.",
+        },
+        sessionId: {
+            type: "string",
+            description: "REQUIRED. From browser's start_session.",
+        },
+        // --- snapshot only ---
+        startAt: {
+            type: "integer",
+            minimum: 0,
+            description: "snapshot only. Skip this many elements. Page with totalElements.",
+        },
+        limit: {
+            type: "integer",
+            minimum: 1,
+            description: "snapshot only. Max elements returned.",
+        },
+        reveal: {
+            type: "boolean",
+            description: "snapshot only. Scroll to reveal rows not yet in the DOM. Off by default.",
+        },
+        // --- navigate only ---
+        url: {
+            type: "string",
+            description: "navigate only, REQUIRED. Must be the session's consented origin.",
+        },
+        // --- wait_for only ---
+        role: {
+            type: "string",
+            description: "wait_for only. role, name, or both required.",
+        },
+        name: {
+            type: "string",
+            description: "wait_for only. Matched exactly (case/space-insensitive).",
+        },
+        timeoutMs: {
+            type: "integer",
+            minimum: 0,
+            description: `wait_for only. Default 5000, capped at ${WAIT_TIMEOUT_MAX_MS}. Timing out is a normal outcome.`,
+        },
+    },
+    required: ["verb", "sessionId"],
+    additionalProperties: false,
+};
+async function run(args, ctx) {
+    const verb = selectVerb(args, "verb", VERB_SPECS, SHARED_PROPS);
+    if (verb === "snapshot")
+        return runSnapshot(args, ctx);
+    if (verb === "navigate")
+        return runNavigate(args, ctx);
+    if (verb === "wait_for")
+        return runWaitFor(args, ctx);
+    return runClose(args, ctx);
+}
+export const browserReadTool = {
+    name: "browser_read",
+    class: "stateful-read",
+    tier: "evidence",
+    version: "1.0.0",
+    title: "Read, navigate, wait on, or close a browser session",
+    description: "Read-only browser operations, chosen by verb: snapshot, navigate, wait_for, or close. Never " +
+        "mutates the app, so none needs confirming — but each takes a fresh snapshot, invalidating " +
+        "prior refs.",
+    inputSchema: SCHEMA,
+    run,
+};
+//# sourceMappingURL=browser-read.js.map

package/dist/tools/browser-read.js.map

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

package/dist/tools/browser-run-scenario.d.ts

@@ -0,0 +1,28 @@
+/** `browser_run_scenario` replays a saved scenario in one batch call — one aggregated reply
+ *  instead of N, since a check has one outcome, not fragments to reassemble. `class: "action"`
+ *  like the verbs: mints nothing, consent stays bound to `browser_start_session`'s origin, and a
+ *  stored `navigate` leaving it stops the replay. Per DEC-381, only an asserted expectation that
+ *  fails is blocking — an observed console error the author never asserted against is not. */
+import { type BrowserGraphWrite } from "../browser/graph-write.ts";
+import { type ScenarioAssertionResult, type ScenarioCounts, type ScenarioStepResult } from "../browser/scenario-runner.ts";
+import type { BrowserEvidenceReport } from "../browser/evidence.ts";
+import { type ToolDefinition } from "./kit.ts";
+export interface BrowserRunScenarioData {
+    readonly sessionId: string;
+    readonly scenario: string;
+    /** `passed` · `failed` · `unresolved` · `unverified` — never `passed` for a scenario that asserted nothing. */
+    readonly outcome: "passed" | "failed" | "unresolved" | "unverified" | "notRun";
+    /** Three counts that are never summed, plus how many assertions held. */
+    readonly counts: ScenarioCounts;
+    /** Failed assertions alone. An unresolvable step is not a defect claim, so it does not join this. */
+    readonly blockingTotal: number;
+    /** 0 clean · 1 blocking findings · 2 the check could not run. `descry check`'s existing vocabulary. */
+    readonly exitCode: 0 | 1 | 2;
+    readonly steps: readonly ScenarioStepResult[];
+    readonly assertions: readonly ScenarioAssertionResult[];
+    /** One summary for the whole batch, drained a step at a time. */
+    readonly evidence: BrowserEvidenceReport;
+    readonly graph: BrowserGraphWrite;
+}
+export declare const browserRunScenarioTool: ToolDefinition;
+//# sourceMappingURL=browser-run-scenario.d.ts.map

package/dist/tools/browser-run-scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-run-scenario.d.ts","sourceRoot":"","sources":["../../src/tools/browser-run-scenario.ts"],"names":[],"mappings":"AAAA;;;;8FAI8F;AAI9F,OAAO,EAAkB,KAAK,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AACnF,OAAO,EAA2B,KAAK,uBAAuB,EAAE,KAAK,cAAc,EAAE,KAAK,kBAAkB,EAAE,MAAM,+BAA+B,CAAC;AAEpJ,OAAO,KAAK,EAAE,qBAAqB,EAAE,MAAM,wBAAwB,CAAC;AAIpE,OAAO,EAAoC,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAGjF,MAAM,WAAW,sBAAsB;IACrC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,+GAA+G;IAC/G,QAAQ,CAAC,OAAO,EAAE,QAAQ,GAAG,QAAQ,GAAG,YAAY,GAAG,YAAY,GAAG,QAAQ,CAAC;IAC/E,yEAAyE;IACzE,QAAQ,CAAC,MAAM,EAAE,cAAc,CAAC;IAChC,qGAAqG;IACrG,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,uGAAuG;IACvG,QAAQ,CAAC,QAAQ,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IAC7B,QAAQ,CAAC,KAAK,EAAE,SAAS,kBAAkB,EAAE,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,SAAS,uBAAuB,EAAE,CAAC;IACxD,iEAAiE;IACjE,QAAQ,CAAC,QAAQ,EAAE,qBAAqB,CAAC;IACzC,QAAQ,CAAC,KAAK,EAAE,iBAAiB,CAAC;CACnC;AAkOD,eAAO,MAAM,sBAAsB,EAAE,cAiBpC,CAAC"}

package/dist/tools/browser-run-scenario.js

@@ -0,0 +1,238 @@
+/** `browser_run_scenario` replays a saved scenario in one batch call — one aggregated reply
+ *  instead of N, since a check has one outcome, not fragments to reassemble. `class: "action"`
+ *  like the verbs: mints nothing, consent stays bound to `browser_start_session`'s origin, and a
+ *  stored `navigate` leaving it stops the replay. Per DEC-381, only an asserted expectation that
+ *  fails is blocking — an observed console error the author never asserted against is not. */
+import { readScenario } from "../scenarios/index.js";
+import { browserAnswer, emptyEvidence, mutationRefusal, useSession, withinConsent } from "../browser/tool-support.js";
+import { NO_GRAPH_WRITE } from "../browser/graph-write.js";
+import { mutates, replayScenario } from "../browser/scenario-runner.js";
+import { scenarioPath } from "../scenarios/index.js";
+import { CANCELLED_STATE } from "../cancellation.js";
+import { runPreflight } from "@descryy/runtime-controller";
+import { buildBrowserToolReadyChecks } from "../ready-checks.js";
+import { requiredString } from "./kit.js";
+const SCHEMA = {
+    type: "object",
+    properties: {
+        sessionId: {
+            type: "string",
+            description: "REQUIRED. The id returned by browser_start_session. The replay runs in that session, under the consent it was granted.",
+        },
+        name: {
+            type: "string",
+            description: "REQUIRED. The scenario's name, without the file extension — a scenario saved as " +
+                "descry/scenarios/checkout.scenario.json is named \"checkout\". Saved scenarios are committed files; " +
+                "browser_save_scenario writes them.",
+        },
+        confirmToken: {
+            type: "string",
+            description: "Not normally needed. Consent is granted once, for the whole session, by browser_start_session, so " +
+                "this call replays directly. The field is declared because the handshake reads it for every " +
+                "action-class tool.",
+        },
+    },
+    required: ["sessionId", "name"],
+    additionalProperties: false,
+};
+function empty(sessionId, name) {
+    return {
+        sessionId,
+        scenario: name,
+        outcome: "notRun",
+        counts: { passed: 0, failed: 0, unresolved: 0, unverified: 0 },
+        blockingTotal: 0,
+        // 2 rather than 0: this is "the check could not run", and a refusal that
+        // reported clean would let a scenario nobody could replay keep claiming
+        // coverage.
+        exitCode: 2,
+        steps: [],
+        assertions: [],
+        evidence: emptyEvidence(),
+        graph: NO_GRAPH_WRITE,
+    };
+}
+async function run(args, ctx) {
+    const sessionId = requiredString(args, "sessionId");
+    const name = requiredString(args, "name");
+    const stored = await readScenario(ctx.session.repoPath, name);
+    if (!stored.valid) {
+        return browserAnswer({
+            ctx,
+            state: "refused",
+            headline: `Scenario "${name}" cannot be replayed.`,
+            notes: [
+                ...stored.problems,
+                `Scenarios live in ${scenarioPath(ctx.session.repoPath, name)} and are committed like source. ` +
+                    "browser_save_scenario writes one from a session you have explored.",
+            ],
+            data: empty(sessionId, name),
+        });
+    }
+    const scenario = stored.scenario;
+    const found = await useSession(ctx.session.browserSessions(), sessionId);
+    if (!found.ok) {
+        return browserAnswer({
+            ctx,
+            state: found.dead.state,
+            headline: found.dead.headline,
+            notes: found.dead.notes,
+            data: { ...empty(sessionId, name), evidence: found.dead.evidence },
+        });
+    }
+    const { entry } = found;
+    // Consent is bound to one origin and a stored file cannot widen it. Checked
+    // before anything runs, because a replay that got three steps in and then
+    // refused would have already changed the application.
+    if (!withinConsent(entry, scenario.targetUrl)) {
+        return browserAnswer({
+            ctx,
+            state: "refused",
+            headline: `Scenario "${name}" targets another origin.`,
+            notes: [
+                `It opens ${scenario.targetUrl}, and this session's consent covers ${entry.consentedOrigin} only. ` +
+                    "Consent is granted per session and bound to the origin it was granted for, so a saved file cannot " +
+                    "extend it. Start a session against that origin to replay this scenario.",
+            ],
+            data: empty(sessionId, name),
+        });
+    }
+    const refusedForSafety = mutationRefusal(entry);
+    if (refusedForSafety !== null && mutates(scenario)) {
+        return browserAnswer({
+            ctx,
+            state: "refused",
+            headline: `${entry.profile?.name ?? "This environment"} is read-only.`,
+            notes: [
+                refusedForSafety,
+                `Scenario "${name}" clicks, types or fills, so replaying it would change the application. A ` +
+                    "navigate-only scenario would still run here.",
+            ],
+            data: empty(sessionId, name),
+        });
+    }
+    // RT-263: the session may have opened fine and then the application died before
+    // this replay started -- checked fresh here rather than trusted from
+    // browser_start_session's own preflight, which only proved the target answered at
+    // open time. Read-only, single TCP connect; reports within seconds instead of
+    // letting the replay's own step timeouts discover the same thing one step at a time.
+    // Optional on the port (`entry.page.probeTargetReachable`) for the same reason
+    // `browser-start-session.ts` guards it: the fake driver's page session has no real
+    // network to probe, so `packages/mcp/test`'s scenario suites (made-up target ports)
+    // are unaffected; only the real Chromium driver implements it.
+    const reachability = await entry.page.probeTargetReachable?.(scenario.targetUrl);
+    if (reachability !== undefined && reachability !== null && !reachability.reachable) {
+        return browserAnswer({
+            ctx,
+            state: "refused",
+            headline: `Scenario "${name}" cannot be replayed — its target does not answer.`,
+            notes: [reachability.message],
+            data: empty(sessionId, name),
+        });
+    }
+    const ready = await runPreflight(buildBrowserToolReadyChecks(ctx.session));
+    if (ready.status === "broken") {
+        return browserAnswer({
+            ctx,
+            state: "refused",
+            headline: `Scenario "${name}" cannot be replayed — the environment is not ready.`,
+            notes: ready.checks.filter((check) => check.required && !check.ok).map((check) => `${check.label} — ${check.message}`),
+            data: empty(sessionId, name),
+        });
+    }
+    // Start where the scenario says it starts, rather than wherever the session
+    // happened to be left. A replay that began from an arbitrary page is not a
+    // repeat of the run that was saved.
+    if (entry.page.currentUrl() !== scenario.targetUrl) {
+        await entry.page.navigate(scenario.targetUrl);
+    }
+    // `ctx.session.credentialStore` — RG-1(4) / lane "delivery": undefined for
+    // every session that never set one, so a `${credential:NAME}` step refuses
+    // by name exactly as before. `process.env` is passed through explicitly
+    // rather than omitted, because `credentialStore` is `replayScenario`'s
+    // sixth positional parameter and `env` is its fifth.
+    const replay = await replayScenario(ctx, ctx.session.browserSessions(), sessionId, scenario, process.env, ctx.session.credentialStore);
+    const notes = [
+        ...ready.disclosures,
+        ...(replay.sessionEnded === null ? [] : replay.sessionEnded.notes),
+        ...replay.notes,
+        // A cancelled replay is `unresolved` with zero unresolved steps — skip the outcome note, the
+        // replay's own note already says what stopped it.
+        ...(replay.cancelled ? [] : outcomeNotes(replay.outcome, replay.counts, name)),
+        ...replay.steps.filter((s) => s.resolution !== null).map((s) => s.resolution.message),
+        ...replay.assertions.filter((a) => a.status === "failed" || a.status === "unevaluable").map((a) => a.detail),
+    ];
+    // Cancellation outranks a dead session in the state: both are true, and
+    // "the caller stopped this" is the one that explains the other.
+    const state = replay.cancelled ? CANCELLED_STATE : replay.sessionEnded?.state;
+    return browserAnswer({
+        ctx,
+        ...(state === undefined ? {} : { state }),
+        headline: (replay.cancelled ? `Scenario "${name}" was cancelled: ` : `Scenario "${name}": `) +
+            `${replay.outcome} — ${replay.counts.passed} assertion(s) held, ` +
+            `${replay.counts.failed} failed, ${replay.counts.unresolved} could not run.`,
+        notes,
+        data: {
+            sessionId,
+            scenario: name,
+            outcome: replay.outcome,
+            counts: replay.counts,
+            blockingTotal: replay.blockingTotal,
+            exitCode: replay.exitCode,
+            steps: replay.steps,
+            assertions: replay.assertions,
+            evidence: replay.evidence,
+            graph: replay.graph,
+        },
+    });
+}
+/** The disclosure the three counts exist for. Emitted per outcome, not always — a note on every
+ *  reply is one nobody reads by the third (same reasoning as `evidenceNotes`'s triage disclaimer). */
+function outcomeNotes(outcome, counts, name) {
+    switch (outcome) {
+        case "unverified":
+            return [
+                `Scenario "${name}" stores no assertions, so this replay verified nothing. Its steps still resolved ` +
+                    "and still ran — real information — but that is not the same statement as the application behaving, " +
+                    "and it is deliberately never reported as passed.",
+            ];
+        case "unresolved":
+            return [
+                `${counts.unresolved} step or assertion could not run, so this replay neither passed nor failed. ` +
+                    "Descry cannot tell a deliberate rename from a vanished element — both look identical from here — " +
+                    "so it claims neither. The remedy is in the message below: re-save the step if the change was " +
+                    "intended, or fix the application if it was not.",
+            ];
+        case "failed":
+            return [
+                `${counts.failed} assertion(s) the scenario's author wrote down did not hold. Only those count as ` +
+                    "blocking; console errors and failed requests observed during the replay are reported below and are " +
+                    "not, because they are frequently true of a working page." +
+                    (counts.unresolved > 0
+                        ? ` ${counts.unresolved} check(s) also could not run, counted separately and never added to the ` +
+                            "blocking total."
+                        : ""),
+            ];
+        case "passed":
+        case "notRun":
+            return [];
+    }
+}
+export const browserRunScenarioTool = {
+    name: "browser_run_scenario",
+    title: "Replay a saved scenario",
+    description: "Replay a saved scenario — a named step sequence with the assertions its author wrote down — in one " +
+        "call, and return a single evidence summary rather than one reply per step. Each step re-resolves its " +
+        "element against a fresh page: exactly one match or the replay stops and says which of role, name and " +
+        "selector disagreed and what the page holds now. Reports three counts that are never added together — " +
+        "failed assertions, checks that could not run, and whether the scenario asserted anything at all. A " +
+        "scenario with no assertions replays as unverified, never as passed.",
+    class: "action",
+    tier: "evidence",
+    version: "1.0.0",
+    inputSchema: SCHEMA,
+    run,
+    // Undefined, always, same as the verbs: consent lives at browser_start_session, not here.
+    describeAction: () => undefined,
+};
+//# sourceMappingURL=browser-run-scenario.js.map

package/dist/tools/browser-run-scenario.js.map

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

package/dist/tools/browser-save-scenario.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `browser_save_scenario`: an explored session becomes a durable scenario,
+ * written only through `writeScenario` (validates in and out — no private
+ * disk path here). A step can't carry a `ref`: the schema omits the field entirely and the format module also rejects one by name.
+ */
+import { type ToolDefinition } from "./kit.ts";
+export interface BrowserSaveScenarioData {
+    readonly sessionId: string;
+    readonly name: string;
+    /** Where it was written, or "" when nothing was written. */
+    readonly path: string;
+    readonly targetUrl: string;
+    readonly stepCount: number;
+    readonly assertionCount: number;
+    readonly savedAt: string;
+    readonly savedAtCommit: string;
+}
+export declare const browserSaveScenarioTool: ToolDefinition;
+//# sourceMappingURL=browser-save-scenario.d.ts.map

package/dist/tools/browser-save-scenario.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"browser-save-scenario.d.ts","sourceRoot":"","sources":["../../src/tools/browser-save-scenario.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAWH,OAAO,EAAoE,KAAK,cAAc,EAAE,MAAM,UAAU,CAAC;AAGjH,MAAM,WAAW,uBAAuB;IACtC,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,4DAA4D;IAC5D,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,SAAS,EAAE,MAAM,CAAC;IAC3B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;IACzB,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;CAChC;AAubD,eAAO,MAAM,uBAAuB,EAAE,cA0BrC,CAAC"}