@bivy/bivy 0.20.7-staging.2 → 0.20.7-staging.4

package/dist/apps/service.js

@@ -13,6 +13,12 @@ import { captureFrame, encodePng, sendInput } from "./rfb.js";
 import { inputEvents, readAction } from "./input.js";
 import { pressMenu, readMenuPath, readMenus } from "./menu.js";
 import { pngSize } from "./review.js";
+import { Backend } from "./backend/index.js";
+import { SCENARIO_DIR, loadScenarios, planScenario, scenariosFor, summarize } from "./scenarios.js";
+import { startScenarioProxy } from "./scenario-proxy.js";
+const scenarioKind = (entry) => entry.target.kind === "display" ? "desktop" : "web";
+/** A desktop step in words, for the message when one fails. */
+const stepWords = (step) => "click" in step ? `click ${Array.isArray(step.click) ? step.click.join(",") : step.click}` : "type" in step ? `type "${step.type.slice(0, 40)}"` : "press" in step ? `press ${step.press}` : "menu" in step ? `menu ${step.menu}` : "wait" in step ? `wait ${step.wait}` : "step";
 const NO_REVIEWS = { publish: (review) => review, expire: () => { } };
 const NO_PINS = { publish: (pin) => pin };
 /** A pin's region is in the page CSS pixels of the viewport it was marked in.
@@ -62,8 +68,12 @@ export class AppService {
     latest = new Map();
     /** Per view: the newest reviewer note a run-end card has already counted. */
     handedOver = new Map();
+    /** Per desktop app in a scenario with an API: the proxy in front of it and the variable pointing there. */
+    proxies = new Map();
     /** Screenshots in progress, so a card, Compare and a baseline share one browser run. */
     inflight = new Map();
+    /** Requests, data and logs views: what a backend change did. */
+    backend;
     constructor(registry, gateway, terminals, options = {}) {
         this.registry = registry;
         this.gateway = gateway;
@@ -76,6 +86,8 @@ export class AppService {
         this.reviews = options.reviews ?? NO_REVIEWS;
         this.pinSink = options.pins ?? NO_PINS;
         this.settleMs = options.settleMs ?? COMPARE_SETTLE_MS;
+        this.backend = new Backend(registry, terminals);
+        registry.desktopScenario = (viewId, scenario) => this.desktopScenario(viewId, scenario);
     }
     /** A session's apps, or every app on this machine when no session is given. */
     list(sessionId) {
@@ -117,6 +129,11 @@ export class AppService {
             const server = this.servers.get(id);
             if (entry?.target.kind !== "display" || !server?.termId)
                 continue;
+            // In a scenario, the new code starts in it again, steps and all.
+            if (entry.scenario) {
+                void this.desktopScenario(id, entry.scenario.id).catch(() => { });
+                continue;
+            }
             this.terminals.close(server.termId);
             server.termId = undefined;
             void this.ensureServer(entry).catch(() => { });
@@ -187,11 +204,16 @@ export class AppService {
         const views = this.reviewable(sessionId);
         const run = { start: new Map(views.map((entry) => [entry.view.id, entry.revision])), baseline: new Map(), reviews: new Map(), muted: false, ended: false };
         this.runs.set(sessionId, run);
+        if (this.backend.views(sessionId).length)
+            run.backend = this.backend.baseline(sessionId).catch(() => { });
+        // Settles when the backend's "before" is taken (tests wait on it; the server doesn't need to).
+        const ready = run.backend ?? Promise.resolve();
         if (!this.screenshots.enabled())
-            return;
+            return ready;
         for (const entry of views)
             void this.shotOf(entry).then((png) => { if (png && entry.revision === run.start.get(entry.view.id))
                 run.baseline.set(entry.view.id, png); });
+        return ready;
     }
     /** The run ended (done, or waiting for the user). Views whose revision
      * changed are screenshotted and compared with the page before the run; a
@@ -203,6 +225,12 @@ export class AppService {
             return undefined;
         run.ended = true;
         let latest;
+        // Backend views run again; what changed is evidence, on the app's card.
+        let evidence = new Map();
+        if (run.backend) {
+            await run.backend;
+            evidence = await this.backend.evidence(sessionId).catch(() => evidence);
+        }
         const changed = [...run.start].map(([id, revision]) => ({ entry: this.registry.getView(id), revision })).filter(({ entry, revision }) => entry && entry.revision !== revision);
         if (changed.length && this.screenshots.enabled() && !run.muted)
             await new Promise((r) => setTimeout(r, this.settleMs));
@@ -225,7 +253,7 @@ export class AppService {
             const presented = current && run.reviews.get(entry.app.id) === current.id;
             if (!shouldReview({ trigger: "run", mode, muted: run.muted, revisionChanged: true, change }) && !(presented && after))
                 continue;
-            latest = this.review(entry, run, { trigger: presented ? current.trigger : "run", note: presented ? current.note : undefined, path: entry.lastPath ?? "/", shot: after, before });
+            latest = this.review(entry, run, { trigger: presented ? current.trigger : "run", note: presented ? current.note : undefined, try: presented ? current.try : undefined, path: entry.lastPath ?? "/", shot: after, before, evidence: evidence.get(entry.app.id)?.changed ? evidence.get(entry.app.id).rows : undefined });
         }
         // Reviewer notes that arrived since the last hand-over ride on the view's
         // card for this run, or get a card of their own. A count only: the notes
@@ -250,6 +278,14 @@ export class AppService {
                 latest ??= card;
             }
         }
+        // A backend-only change: the evidence is the card.
+        for (const [appId, found] of evidence) {
+            if (!found.changed || run.muted || run.reviews.has(appId) || this.registry.reviewMode(appId) === "off")
+                continue;
+            const entry = this.registry.getView(found.rows[0].viewId);
+            if (entry)
+                latest = this.review(entry, run, { trigger: "run", path: "/", evidence: found.rows });
+        }
         if (!latest) {
             const id = [...run.reviews.values()].at(-1);
             latest = [...this.latest.values()].find((review) => review.id === id);
@@ -264,6 +300,7 @@ export class AppService {
             throw new Error("Path must start with /.");
         const note = typeof input.note === "string" ? input.note.trim().slice(0, 500) : undefined;
         const entry = this.pickView(sessionId, input.target);
+        const tries = input.try?.length ? this.tryScenarios(entry, input.try) : undefined;
         const mode = this.registry.reviewMode(entry.app.id);
         const active = this.runs.get(sessionId);
         const run = active && !active.ended ? active : undefined;
@@ -279,9 +316,90 @@ export class AppService {
         const shot = enabled ? await this.shotOf(entry, path) : undefined;
         const baseline = run?.baseline.get(entry.view.id);
         const before = baseline && shot && !baseline.equals(shot) && path === (entry.lastPath ?? "/") ? baseline : undefined;
-        const review = this.review(entry, run, { trigger, note, path, shot, before, screenshotsOff: !enabled });
+        const review = this.review(entry, run, { trigger, note, path, shot, before, screenshotsOff: !enabled, ...(tries ? { try: tries } : {}) });
         return { review, message: enabled ? (shot ? "The user sees it in the chat." : "The user sees a card in the chat, but the screenshot failed.") : "The user sees a card in the chat. Screenshots are off on this machine, so it has no picture." };
     }
+    /** `bivy app scenarios`: a view's scenarios as the preview shows them, and
+     *  files that can't be opened, with what's wrong (picked like `present`). */
+    scenarios(sessionId, target) {
+        const entry = this.pickView(sessionId, target);
+        const { scenarios, problems } = loadScenarios(entry.workspace);
+        const kind = scenarioKind(entry);
+        return { app: entry.app.name, view: entry.view.name, dir: SCENARIO_DIR, scenarios: summarize(scenariosFor(scenarios, entry.app.name, entry.view.name, kind), problems, entry.app.createdAt, kind) };
+    }
+    /** Scenarios a review card offers to try, by ID, each one that can be opened. */
+    tryScenarios(entry, ids) {
+        const { scenarios, problems } = loadScenarios(entry.workspace);
+        const kind = scenarioKind(entry);
+        const known = summarize(scenariosFor(scenarios, entry.app.name, entry.view.name, kind), problems, entry.app.createdAt, kind);
+        const wanted = [...new Set(ids.map((id) => id.trim().toLowerCase().replace(/\.json$/, "")).filter(Boolean))].slice(0, 6);
+        return wanted.map((id) => {
+            const found = known.find((item) => item.id === id);
+            if (!found)
+                throw new Error(`No scenario "${id}" for ${entry.view.name}. ${known.length ? `Its scenarios: ${known.map((item) => item.id).join(", ")}.` : `Write one in ${SCENARIO_DIR}/${id}.json.`}`);
+            if (found.error)
+                throw new Error(`Scenario "${id}" can't be opened: ${found.error}`);
+            return { id: found.id, name: found.name };
+        });
+    }
+    /** Puts a desktop app in a scenario ("" for none). It is one program for
+     *  everyone watching, so the scenario is the app's: it restarts with the
+     *  scenario's arguments and environment, its API (if the scenario has one)
+     *  behind a proxy that applies the network rules, and then the steps run in
+     *  its window the way an agent's input does. A step that fails leaves the app
+     *  where it got to and says which step, rather than throwing. */
+    async desktopScenario(viewId, id) {
+        const entry = this.registry.getView(viewId);
+        if (entry?.target.kind !== "display")
+            throw new Error("Desktop scenarios are for desktop apps.");
+        const plan = id ? planScenario(scenariosFor(loadScenarios(entry.workspace).scenarios, entry.app.name, entry.view.name, "desktop"), id, "desktop") : null;
+        this.proxies.get(viewId)?.close();
+        this.proxies.delete(viewId);
+        if (plan?.api) {
+            const proxy = await startScenarioProxy(plan.api.target, plan.network);
+            this.proxies.set(viewId, { close: proxy.close, env: { [plan.api.env]: proxy.url } });
+        }
+        entry.scenario = plan ?? undefined;
+        const server = this.servers.get(viewId);
+        if (server?.termId) {
+            this.terminals.close(server.termId);
+            server.termId = undefined;
+        }
+        await this.windowShown(entry);
+        if (!plan)
+            return { plan: null };
+        const steps = plan.stages.flatMap((stage) => stage.steps);
+        for (const [index, step] of steps.entries()) {
+            try {
+                await this.desktopStep(entry, step);
+            }
+            catch (error) {
+                return { plan, error: `Step ${index + 1} (${stepWords(step)}): ${error.message}` };
+            }
+            await new Promise((r) => setTimeout(r, AFTER_INPUT_MS));
+        }
+        return { plan };
+    }
+    async desktopStep(entry, step) {
+        if ("wait" in step) {
+            if (typeof step.wait === "number")
+                await new Promise((r) => setTimeout(r, step.wait));
+            return;
+        }
+        if ("menu" in step) {
+            if (!entry.displayControl)
+                throw new Error("This machine's desktop apps don't expose their menus (macOS only). Use a key combo instead.");
+            await pressMenu(entry.displayControl, readMenuPath(step.menu));
+            return;
+        }
+        if (!entry.display)
+            throw new Error("The app isn't running. Check its Logs in the Apps sheet.");
+        const action = "click" in step && Array.isArray(step.click) ? { kind: "click", x: step.click[0], y: step.click[1] }
+            : "type" in step ? { kind: "type", text: step.type } : "press" in step ? { kind: "key", keys: step.press } : undefined;
+        if (!action)
+            throw new Error("That step is for web pages.");
+        await sendInput(entry.display, inputEvents(readAction(action)));
+    }
     /** No more cards for the rest of the session's current run. */
     mute(sessionId) {
         const run = this.runs.get(sessionId);
@@ -348,7 +466,8 @@ export class AppService {
      * returning to a view's stable address. */
     /** `scale`: the opening device's pixel density, used if this starts a display. */
     /** `page`: start on this page instead of the app's root (a review card's page). */
-    async open(sessionId, appId, viewId, returnTo, direct = false, scale, page) {
+    /** `scenario`: open it in that scenario (the shell enters it once the app has loaded). */
+    async open(sessionId, appId, viewId, returnTo, direct = false, scale, page, scenario) {
         const entry = this.registry.requireView(sessionId, appId, viewId);
         if (entry.target.kind === "display" && !entry.display)
             entry.displayScale = scale === 2 ? 2 : 1;
@@ -358,8 +477,12 @@ export class AppService {
             if (direct && !this.gateway.openDirect)
                 throw new Error("This machine can't open previews directly.");
             let url = direct ? this.gateway.openDirect(viewId) : this.gateway.open(viewId, returnTo);
-            if (page && page.startsWith("/") && !page.startsWith("//") && page.length <= 2048)
-                url += `~${encodeURIComponent(page).replace(/~/g, "%7E")}`;
+            const start = page && page.startsWith("/") && !page.startsWith("//") && page.length <= 2048 ? page : undefined;
+            const inScenario = !direct && scenario && /^[a-z0-9][a-z0-9-]{0,63}$/.test(scenario) ? scenario : undefined;
+            if (start || inScenario)
+                url += `~${start ? encodeURIComponent(start).replace(/~/g, "%7E") : ""}`;
+            if (inScenario)
+                url += `~${inScenario}`;
             // Don't wait for a managed server to boot: the preview shows it starting
             // and reloads itself once it answers.
             if (this.servers.get(viewId))
@@ -646,8 +769,10 @@ export class AppService {
         return this.displays.ensure(entry.view.id, entry.app.name, entry.displayScale).then((display) => {
             entry.display = display.socket;
             entry.displayControl = display.control;
-            const [command, ...args] = [...display.launch ?? [], target.command, ...target.args];
-            return { command: command, args, workspace: target.workspace, env: display.env, name: `${entry.app.name} · ${entry.view.name}` };
+            // A scenario adds its arguments and environment; the display's own variables always win.
+            const [command, ...args] = [...display.launch ?? [], target.command, ...target.args, ...entry.scenario?.args ?? []];
+            const env = { ...entry.scenario?.env, ...this.proxies.get(entry.view.id)?.env, ...display.env };
+            return { command: command, args, workspace: target.workspace, env, name: `${entry.app.name} · ${entry.view.name}` };
         });
     }
     /** Services start synchronously; a desktop app waits for its display. */
@@ -674,6 +799,7 @@ export class AppService {
                 throw new Error("App was removed while starting.");
             }
             server.termId = termId;
+            this.backend.attach(id, termId);
             return termId;
         })
             .finally(() => { server.pending = undefined; });
@@ -699,6 +825,8 @@ export class AppService {
     }
     stopServer(id) {
         this.displays.stop(id);
+        this.proxies.get(id)?.close();
+        this.proxies.delete(id);
         const entry = this.registry.getView(id);
         if (entry) {
             entry.display = undefined;
@@ -714,6 +842,16 @@ export class AppService {
         void server.pending?.then((termId) => this.terminals.close(termId)).catch(() => { });
         this.servers.delete(id);
     }
+    /** A backend view of a session, by exact IDs (the app) or by name (`bivy app requests`). */
+    backendView(sessionId, kind, input) {
+        if (input.appId && input.viewId) {
+            const entry = this.registry.requireView(sessionId, input.appId, input.viewId);
+            if (entry.target.kind !== kind)
+                throw new Error(`That isn't a ${kind} view.`);
+            return entry;
+        }
+        return this.backend.pick(sessionId, kind, input.target);
+    }
     share(sessionId, appId, viewId, options = {}) {
         if (this.registry.requireView(sessionId, appId, viewId).view.kind !== "web")
             throw new Error("Only web views have preview links.");
@@ -778,6 +916,7 @@ export class AppService {
     remove(sessionId, appId) {
         const app = this.registry.require(sessionId, appId);
         this.registry.remove(sessionId, appId);
+        this.backend.forget(app.views.map((view) => view.id), app.id);
         for (const view of app.views) {
             this.gateway?.revoke(view.id);
             this.stopServer(view.id);

package/dist/apps/styles.css

@@ -3243,6 +3243,18 @@ p.setup-note .btn.link { min-height: 44px; margin-block: calc((1lh - 44px) / 2);
 .review-side .seg-btn { min-block-size: 44px; min-inline-size: 72px; }
 .review-banner { margin: 0 var(--space-3); }
 .review-note { margin: var(--space-3) var(--space-3) 0; padding-inline-start: var(--space-3); border-inline-start: 2px solid var(--line-strong); color: var(--ink); font-size: var(--text-sm); white-space: pre-wrap; }
+/* Backend evidence on a review card: one line per thing a run changed. */
+.review-evidence { list-style: none; margin: 0 var(--space-3); padding: 0; border-top: 1px solid var(--line); }
+.review-evidence-row { display: grid; grid-template-columns: 4.5rem minmax(0, 1fr) auto; align-items: baseline; gap: var(--space-2); inline-size: 100%; min-block-size: var(--space-7); padding: var(--space-2) 0; border: 0; border-bottom: 1px solid var(--line); background: none; color: var(--ink); font: inherit; font-size: var(--text-sm); text-align: start; cursor: pointer; }
+.review-evidence li:last-child .review-evidence-row { border-bottom: 0; }
+.review-evidence-row:hover { background: var(--surface-2); }
+.review-evidence-kind { color: var(--muted); font-size: var(--text-xs); font-weight: var(--weight-semibold); }
+.review-evidence-text { display: flex; flex-wrap: wrap; gap: 0 var(--space-2); min-inline-size: 0; overflow-wrap: anywhere; }
+.review-evidence-text code { color: var(--muted); font-family: var(--font-mono); font-size: var(--text-xs); }
+/* "Try it": scenarios the agent offered, each opening the live preview in that state. */
+.review-try { display: flex; flex-wrap: wrap; align-items: center; gap: var(--space-1); margin: var(--space-3) var(--space-3) 0; }
+.review-try-label { margin-inline-end: var(--space-1); color: var(--muted); font-size: var(--text-sm); }
+.review-try .btn { min-block-size: var(--space-7); }
 .review-status { margin: var(--space-2) var(--space-3) 0; color: var(--muted); font-size: var(--text-sm); }
 .review-actions { display: flex; flex-wrap: wrap; gap: var(--space-1); padding: var(--space-3); }
 .review-actions .btn { min-block-size: var(--space-7); }
@@ -3274,6 +3286,64 @@ p.setup-note .btn.link { min-height: 44px; margin-block: calc((1lh - 44px) / 2);
 .apps-note { display: flex; flex-direction: column; gap: 2px; padding-inline-start: var(--space-3); border-inline-start: 2px solid var(--line-strong); }
 .apps-note-text { color: var(--ink); font-size: var(--text-sm); }
 .apps-notes-actions { display: flex; gap: var(--space-2); }
+/* Backend views (BackendView.tsx): Requests, Data and Logs. Rows reuse the
+   Apps sheet's density; answers and rows are the app's own text, in mono. */
+.backend-view { display: flex; flex-direction: column; gap: var(--space-3); padding: var(--space-3) var(--space-4) var(--space-5); }
+.backend-toolbar { display: flex; flex-wrap: wrap; align-items: center; justify-content: space-between; gap: var(--space-2); }
+.backend-source, .backend-meta { color: var(--muted); font-size: var(--text-xs); overflow-wrap: anywhere; }
+.backend-meta code, .backend-foot code, .backend-row-sub { font-family: var(--font-mono); }
+.backend-back { align-self: flex-start; }
+.backend-group { display: flex; flex-direction: column; gap: var(--space-2); }
+.backend-list { list-style: none; margin: 0; padding: 0; display: flex; flex-direction: column; gap: var(--space-2); }
+.backend-row { display: flex; align-items: center; gap: var(--space-2); inline-size: 100%; min-block-size: var(--space-7); box-sizing: border-box; padding: var(--space-2) var(--space-3); border: 1px solid var(--line); border-radius: var(--radius-md); background: var(--surface); color: var(--ink); font: inherit; text-align: start; cursor: pointer; }
+.backend-row:hover { background: var(--surface-2); }
+.backend-method { flex: none; min-inline-size: 3.25rem; font-family: var(--font-mono); font-size: var(--text-xs); font-weight: var(--weight-bold); color: var(--accent); }
+.backend-method[data-method="GET"], .backend-method[data-method="HEAD"] { color: var(--ok); }
+.backend-method[data-method="DELETE"] { color: var(--danger); }
+.backend-row-text { display: flex; flex-direction: column; flex: 1; min-inline-size: 0; gap: 2px; }
+.backend-row-name { font-size: var(--text-sm); font-weight: var(--weight-semibold); overflow-wrap: anywhere; }
+.backend-row-sub { color: var(--muted); font-size: var(--text-xs); overflow-wrap: anywhere; }
+.backend-foot, .backend-empty { margin: 0; color: var(--muted); font-size: var(--text-xs); }
+.backend-empty { font-size: var(--text-sm); }
+.backend-detail-head { display: flex; align-items: flex-start; gap: var(--space-2); }
+.backend-status { display: flex; flex-wrap: wrap; align-items: center; gap: var(--space-2); }
+.backend-switch { align-self: flex-start; }
+.backend-body { margin: 0; max-block-size: 50vh; overflow: auto; padding: var(--space-3); border-radius: var(--radius-md); background: var(--surface-2); color: var(--ink); font-family: var(--font-mono); font-size: var(--text-xs); line-height: 1.6; white-space: pre-wrap; overflow-wrap: anywhere; }
+.backend-request summary { color: var(--muted); font-size: var(--text-sm); cursor: pointer; margin-block-end: var(--space-2); }
+.backend-changes { list-style: none; margin: 0; padding: 0; border-radius: var(--radius-md); background: var(--surface-2); font-family: var(--font-mono); font-size: var(--text-xs); }
+.backend-changes li { display: flex; flex-wrap: wrap; gap: var(--space-1) var(--space-2); padding: var(--space-2) var(--space-3); border-bottom: 1px solid var(--line); overflow-wrap: anywhere; }
+.backend-changes li:last-child { border-bottom: 0; }
+.backend-path { color: var(--muted); }
+.backend-was { color: var(--del); text-decoration: line-through; }
+.backend-now { color: var(--add); }
+.backend-gone { color: var(--del); }
+.backend-actions { display: flex; flex-wrap: wrap; justify-content: flex-end; gap: var(--space-2); }
+.backend-actions .btn { min-block-size: var(--space-7); }
+.backend-query { display: flex; flex-direction: column; gap: var(--space-2); padding-block-start: var(--space-3); border-top: 1px solid var(--line); }
+.backend-query-head { display: flex; align-items: baseline; justify-content: space-between; gap: var(--space-2); }
+.backend-query-head h3 { margin: 0; font-size: var(--text-base); }
+.backend-counts { font-family: var(--font-mono); font-size: var(--text-xs); font-weight: var(--weight-semibold); }
+.backend-counts [data-tone="ok"] { color: var(--ok); } .backend-counts [data-tone="warn"] { color: var(--warn); } .backend-counts [data-tone="danger"] { color: var(--danger); }
+.backend-rowcard { display: flex; flex-direction: column; gap: var(--space-1); padding: var(--space-2) var(--space-3); border: 1px solid var(--line); border-inline-start: 3px solid var(--line-strong); border-radius: var(--radius-md); }
+.backend-rowcard[data-kind="added"] { border-inline-start-color: var(--ok); }
+.backend-rowcard[data-kind="changed"] { border-inline-start-color: var(--warn); }
+.backend-rowcard[data-kind="removed"] { border-inline-start-color: var(--danger); }
+.backend-fields { display: grid; grid-template-columns: minmax(5rem, max-content) minmax(0, 1fr); gap: 2px var(--space-3); margin: 0; font-size: var(--text-xs); }
+.backend-fields div { display: contents; }
+.backend-fields dt { color: var(--muted); }
+.backend-fields dd { margin: 0; font-family: var(--font-mono); overflow-wrap: anywhere; }
+.backend-table-wrap { overflow-x: auto; border: 1px solid var(--line); border-radius: var(--radius-md); }
+.backend-table { border-collapse: collapse; inline-size: 100%; font-size: var(--text-xs); }
+.backend-table th, .backend-table td { padding: var(--space-1) var(--space-2); border-bottom: 1px solid var(--line); text-align: start; white-space: nowrap; }
+.backend-table th { position: sticky; top: 0; background: var(--surface-2); color: var(--muted); font-weight: var(--weight-semibold); }
+.backend-table td { font-family: var(--font-mono); }
+.backend-log { list-style: none; margin: 0; padding: var(--space-2) 0; max-block-size: 60vh; overflow: auto; border-radius: var(--radius-md); background: var(--surface-2); font-family: var(--font-mono); font-size: var(--text-xs); line-height: 1.6; }
+.backend-line { padding: 1px var(--space-3); white-space: pre-wrap; overflow-wrap: anywhere; }
+.backend-line[data-level="error"] { background: var(--danger-soft); }
+.backend-line[data-level="warn"] { color: var(--warn); }
+.backend-line-time { color: var(--muted); }
+.backend-mark { display: flex; align-items: center; gap: var(--space-2); margin: var(--space-2) 0; padding: 0 var(--space-3); color: var(--accent); font-family: var(--font-sans); font-weight: var(--weight-semibold); scroll-margin-block-start: var(--space-2); }
+.backend-mark::before, .backend-mark::after { content: ""; flex: 1; block-size: 1px; background: color-mix(in srgb, var(--accent) 40%, var(--line)); }
 .apps-empty { display: flex; flex-direction: column; align-items: center; gap: var(--space-2); padding: var(--space-6) var(--space-4); color: var(--muted); font-size: var(--text-sm); text-align: center; }
 .apps-empty strong { color: var(--ink); font-size: var(--text-base); }
 .apps-empty p { margin: 0; max-inline-size: 34ch; }

package/dist/apps/types.js

@@ -1,6 +1,12 @@
 // SPDX-License-Identifier: AGPL-3.0-only
 // Copyright (c) 2026 Petter André Sjulstad
 export const REVIEW_CARD_MODES = ["ready", "every", "off"];
+const isEvidence = (row) => {
+    const r = row;
+    return !!r && typeof r.viewId === "string" && typeof r.view === "string" && ["requests", "data", "logs"].includes(r.backend)
+        && typeof r.summary === "string" && r.summary.length <= 300 && (r.detail === undefined || (typeof r.detail === "string" && r.detail.length <= 300))
+        && ["ok", "warn", "danger", "neutral"].includes(r.tone) && (r.item === undefined || typeof r.item === "string");
+};
 export const APP_REVIEW_BLOCK = "bivy_app_review";
 const isShot = (value) => {
     const shot = value;
@@ -15,7 +21,9 @@ export function isAppReview(value) {
         && (review.trigger === "present" || review.trigger === "run" || review.trigger === "asked" || review.trigger === "notes") && typeof review.at === "number"
         && (review.shot === undefined || isShot(review.shot)) && (review.before === undefined || isShot(review.before))
         && (review.note === undefined || typeof review.note === "string")
-        && (review.notes === undefined || (Number.isInteger(review.notes) && review.notes >= 0));
+        && (review.notes === undefined || (Number.isInteger(review.notes) && review.notes >= 0))
+        && (review.evidence === undefined || (Array.isArray(review.evidence) && review.evidence.length <= 12 && review.evidence.every(isEvidence)))
+        && (review.try === undefined || (Array.isArray(review.try) && review.try.length <= 6 && review.try.every((item) => !!item && typeof item.id === "string" && /^[a-z0-9][a-z0-9-]{0,63}$/.test(item.id) && typeof item.name === "string" && item.name.length <= 80)));
 }
 export const APP_PIN_STATES = ["open", "changed", "gone", "done"];
 export const APP_PIN_BLOCK = "bivy_app_pin";

package/dist/controllers/app-commands.js

@@ -9,6 +9,7 @@ export function createAppCommands(service, workspaceFor, published = () => { },
             throw new Error("Open the session on this machine before publishing an app.");
         return workspace;
     };
+    const pick = (msg) => ({ appId: typeof msg.appId === "string" ? msg.appId : undefined, viewId: typeof msg.viewId === "string" ? msg.viewId : undefined, target: typeof msg.target === "string" ? msg.target : undefined });
     const operations = {
         "apps.list": (msg) => service.list(typeof msg.sessionId === "string" ? msg.sessionId : undefined),
         "apps.publish": (msg) => {
@@ -25,11 +26,12 @@ export function createAppCommands(service, workspaceFor, published = () => { },
             published(app);
             return { app };
         },
-        "apps.open": (msg) => service.open(String(msg.sessionId), String(msg.appId), String(msg.viewId), typeof msg.returnTo === "string" ? msg.returnTo : undefined, msg.direct === true, typeof msg.scale === "number" ? msg.scale : undefined, typeof msg.path === "string" ? msg.path : undefined),
+        "apps.open": (msg) => service.open(String(msg.sessionId), String(msg.appId), String(msg.viewId), typeof msg.returnTo === "string" ? msg.returnTo : undefined, msg.direct === true, typeof msg.scale === "number" ? msg.scale : undefined, typeof msg.path === "string" ? msg.path : undefined, typeof msg.scenario === "string" ? msg.scenario : undefined),
         "apps.shot": (msg) => service.shot(String(msg.sessionId), typeof msg.appId === "string" ? msg.appId : undefined, { widths: msg.widths, themes: msg.themes, path: typeof msg.path === "string" ? msg.path : undefined }),
         "apps.input": (msg) => service.act(String(msg.sessionId), typeof msg.target === "string" ? msg.target : undefined, msg.action),
         "apps.menu": (msg) => service.menu(String(msg.sessionId), typeof msg.target === "string" ? msg.target : undefined, msg.path),
-        "apps.present": (msg) => service.present(String(msg.sessionId), { target: typeof msg.target === "string" ? msg.target : undefined, path: typeof msg.path === "string" ? msg.path : undefined, note: typeof msg.note === "string" ? msg.note : undefined }),
+        "apps.present": (msg) => service.present(String(msg.sessionId), { target: typeof msg.target === "string" ? msg.target : undefined, path: typeof msg.path === "string" ? msg.path : undefined, note: typeof msg.note === "string" ? msg.note : undefined, try: Array.isArray(msg.try) ? msg.try.filter((id) => typeof id === "string") : undefined }),
+        "apps.scenarios": (msg) => service.scenarios(String(msg.sessionId), typeof msg.target === "string" ? msg.target : undefined),
         "apps.showMe": (msg) => service.present(String(msg.sessionId), { target: typeof msg.appId === "string" ? msg.appId : undefined, trigger: "asked" }),
         "apps.mute": (msg) => service.mute(String(msg.sessionId)),
         "apps.reviewMode": (msg) => service.setReviewMode(String(msg.sessionId), String(msg.appId), msg.mode),
@@ -42,6 +44,15 @@ export function createAppCommands(service, workspaceFor, published = () => { },
         "apps.agentNotes": (msg) => service.setAgentNotes(String(msg.sessionId), String(msg.appId), msg.enabled === true),
         "apps.notes": (msg) => service.notes(String(msg.sessionId), { app: typeof msg.appId === "string" ? msg.appId : undefined, view: typeof msg.view === "string" ? msg.view : undefined, since: typeof msg.since === "number" ? msg.since : undefined }),
         "apps.logs": (msg) => service.logs(String(msg.sessionId), String(msg.appId), String(msg.viewId)),
+        // Backend views. The app passes exact IDs; `bivy app requests|data|logs` a name, or nothing.
+        "apps.requests": (msg) => service.backend.requests(service.backendView(String(msg.sessionId), "requests", pick(msg))),
+        "apps.request": (msg) => service.backend.detail(service.backendView(String(msg.sessionId), "requests", pick(msg)), String(msg.id)),
+        "apps.runRequest": (msg) => {
+            const entry = service.backendView(String(msg.sessionId), "requests", pick(msg));
+            return typeof msg.id === "string" ? service.backend.run(entry, msg.id) : service.backend.runAuto(entry, "last", "Ran all requests");
+        },
+        "apps.data": (msg) => service.backend.data(service.backendView(String(msg.sessionId), "data", pick(msg)), msg.run === true),
+        "apps.serverLog": (msg) => service.backend.log(service.backendView(String(msg.sessionId), "logs", pick(msg)), typeof msg.since === "number" ? msg.since : 0),
         // The app UI passes exact IDs; `bivy app share` passes an app and/or view by ID or name.
         "apps.share": (msg) => {
             const options = { duration: msg.duration, controls: msg.controls !== false };

package/dist/exec.js

@@ -174,7 +174,10 @@ async function main() {
             const model = created.model;
             if (args.model && model?.id) {
                 const qualified = !model.provider || model.id.startsWith(`${model.provider}/`) ? model.id : `${model.provider}/${model.id}`;
-                if (![model.id, qualified].some((id) => id === args.model || id.endsWith(`/${args.model}`))) {
+                // Compare model names: the same model can sit under another provider
+                // spelling in this agent (openai-codex/gpt-5.6-sol is OpenCode's openai/gpt-5.6-sol).
+                const name = (id) => id.slice(id.lastIndexOf("/") + 1);
+                if (![model.id, qualified].some((id) => id === args.model || name(id) === name(args.model))) {
                     err(`Model "${args.model}" is not available for this agent; using ${qualified}.\n`);
                 }
             }

package/dist/node-env.js

@@ -0,0 +1,6 @@
+// SPDX-License-Identifier: AGPL-3.0-only
+// Copyright (c) 2026 Petter André Sjulstad
+// Imported first by server.ts, so the node's environment is clean before any
+// module reads it or launches an agent (see runtime/inherited-session-env.ts).
+import { scrubInheritedSessionEnv } from "./runtime/inherited-session-env.js";
+scrubInheritedSessionEnv();

package/dist/protocol/client-command-routes.js

@@ -3,7 +3,7 @@
 /** Direct-mode adapters for operations whose canonical implementation is the
  * client command registry. Relay and HTTP now differ only in framing. */
 export const CLIENT_COMMAND_ROUTES = [
-    ...["list", "publish", "offers", "adopt", "open", "logs", "shot", "input", "menu", "present", "showMe", "mute", "reviewMode", "annotate", "clearNotes", "agentNotes", "notes", "share", "unshare", "revoke", "remove"].map((action) => ({ method: "post", path: `/api/apps/${action}`, kind: `apps.${action}` })),
+    ...["list", "publish", "offers", "adopt", "open", "logs", "requests", "request", "runRequest", "data", "serverLog", "shot", "input", "menu", "present", "scenarios", "showMe", "mute", "reviewMode", "annotate", "clearNotes", "agentNotes", "notes", "share", "unshare", "revoke", "remove"].map((action) => ({ method: "post", path: `/api/apps/${action}`, kind: `apps.${action}` })),
     { method: "post", path: "/api/artifacts/list", kind: "artifacts.list" },
     { method: "post", path: "/api/access/get", kind: "access.get" },
     { method: "post", path: "/api/tailnet/machines", kind: "tailnet.machines" },

package/dist/protocol/client-command-schemas.js

@@ -4,6 +4,8 @@ import { Type } from "typebox";
 import { SHARE_DURATIONS } from "../apps/types.js";
 const request = { requestId: Type.Optional(Type.String()) };
 const session = { sessionId: Type.String() };
+/** A backend view by exact IDs (the app), or by app or view name (`bivy app requests`). */
+const backendView = { appId: Type.Optional(Type.String({ maxLength: 200 })), viewId: Type.Optional(Type.String({ maxLength: 200 })), target: Type.Optional(Type.String({ maxLength: 200 })) };
 const optionalSession = { sessionId: Type.Optional(Type.String()) };
 /** Declarative validation at the client-command boundary. A command absent from
  * this table remains migration-compatible; adding validation is one data row. */
@@ -17,11 +19,12 @@ export const CLIENT_COMMAND_SCHEMAS = {
     "apps.publish": Type.Object({ ...request, ...session, manifest: Type.Unknown() }),
     "apps.offers": Type.Object({ ...request, ...optionalSession }),
     "apps.adopt": Type.Object({ ...request, ...session, port: Type.Integer({ minimum: 1024, maximum: 65535 }) }),
-    "apps.open": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String(), returnTo: Type.Optional(Type.String({ maxLength: 2048 })), direct: Type.Optional(Type.Boolean()), scale: Type.Optional(Type.Integer({ minimum: 1, maximum: 2 })), path: Type.Optional(Type.String({ maxLength: 2048 })) }),
+    "apps.open": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String(), returnTo: Type.Optional(Type.String({ maxLength: 2048 })), direct: Type.Optional(Type.Boolean()), scale: Type.Optional(Type.Integer({ minimum: 1, maximum: 2 })), path: Type.Optional(Type.String({ maxLength: 2048 })), scenario: Type.Optional(Type.String({ maxLength: 64 })) }),
     "apps.shot": Type.Object({ ...request, ...session, appId: Type.Optional(Type.String()), widths: Type.Optional(Type.Array(Type.Integer(), { maxItems: 4 })), themes: Type.Optional(Type.Array(Type.Union([Type.Literal("light"), Type.Literal("dark")]), { maxItems: 2 })), path: Type.Optional(Type.String({ maxLength: 2048 })) }),
     "apps.input": Type.Object({ ...request, ...session, target: Type.Optional(Type.String({ maxLength: 200 })), action: Type.Object({ kind: Type.String({ maxLength: 20 }) }) }),
     "apps.menu": Type.Object({ ...request, ...session, target: Type.Optional(Type.String({ maxLength: 200 })), path: Type.Optional(Type.Array(Type.String({ minLength: 1, maxLength: 200 }), { minItems: 1, maxItems: 8 })) }),
-    "apps.present": Type.Object({ ...request, ...session, target: Type.Optional(Type.String({ maxLength: 200 })), path: Type.Optional(Type.String({ maxLength: 2048 })), note: Type.Optional(Type.String({ maxLength: 2000 })) }),
+    "apps.present": Type.Object({ ...request, ...session, target: Type.Optional(Type.String({ maxLength: 200 })), path: Type.Optional(Type.String({ maxLength: 2048 })), note: Type.Optional(Type.String({ maxLength: 2000 })), try: Type.Optional(Type.Array(Type.String({ maxLength: 64 }), { maxItems: 6 })) }),
+    "apps.scenarios": Type.Object({ ...request, ...session, target: Type.Optional(Type.String({ maxLength: 200 })) }),
     "apps.showMe": Type.Object({ ...request, ...session, appId: Type.Optional(Type.String()) }),
     "apps.mute": Type.Object({ ...request, ...session }),
     "apps.reviewMode": Type.Object({ ...request, ...session, appId: Type.String(), mode: Type.Union([Type.Literal("ready"), Type.Literal("every"), Type.Literal("off")]) }),
@@ -35,6 +38,11 @@ export const CLIENT_COMMAND_SCHEMAS = {
     "apps.agentNotes": Type.Object({ ...request, ...session, appId: Type.String(), enabled: Type.Boolean() }),
     "apps.notes": Type.Object({ ...request, ...session, appId: Type.Optional(Type.String({ maxLength: 200 })), view: Type.Optional(Type.String({ maxLength: 200 })), since: Type.Optional(Type.Number()) }),
     "apps.logs": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String() }),
+    "apps.requests": Type.Object({ ...request, ...session, ...backendView }),
+    "apps.request": Type.Object({ ...request, ...session, ...backendView, id: Type.String({ maxLength: 200 }) }),
+    "apps.runRequest": Type.Object({ ...request, ...session, ...backendView, id: Type.Optional(Type.String({ maxLength: 200 })) }),
+    "apps.data": Type.Object({ ...request, ...session, ...backendView, run: Type.Optional(Type.Boolean()) }),
+    "apps.serverLog": Type.Object({ ...request, ...session, ...backendView, since: Type.Optional(Type.Number()) }),
     "apps.share": Type.Object({ ...request, ...session, appId: Type.Optional(Type.String({ maxLength: 200 })), viewId: Type.Optional(Type.String()), view: Type.Optional(Type.String({ maxLength: 200 })),
         duration: Type.Optional(Type.Union(SHARE_DURATIONS.map((row) => Type.Literal(row.id)))), controls: Type.Optional(Type.Boolean()) }),
     "apps.unshare": Type.Object({ ...request, ...session, appId: Type.String(), viewId: Type.String() }),