@joeytheman/gemini-mcp-tool 1.3.0 → 2.2.0

package/dist/tools/live-pass.tool.js

@@ -0,0 +1,548 @@
+import { z } from 'zod';
+import * as fs from 'fs';
+import * as path from 'path';
+import { execFile } from 'child_process';
+import { promisify } from 'util';
+import { formatZodIssues } from './registry.js';
+import { deniedActionsSummary, executeAgyJson, formatAgyUsageLine, formatConversationLine, toAgyJsonSchema, } from '../utils/agyExecutor.js';
+import { bulletList, section, renderUnparsableEnvelope, formatWorkingTreeSection, failWithWorkingTree } from '../utils/agyReport.js';
+import { isWithin, resolveWorkingDirectory, realpathOfExistingPrefix } from '../utils/fileReferences.js';
+import { snapshotWorkingTree, diffWorkingTree } from '../utils/gitStatusGuard.js';
+import { ERROR_MESSAGES, LIVE_PASS, MODELS, MODEL_CHOICE_DESCRIPTION } from '../constants.js';
+const execFileAsync = promisify(execFile);
+const PUBLISH_MAX_BUFFER = 10 * 1024 * 1024;
+const PUBLISH_TIMEOUT_MS = 5 * 60 * 1000;
+const FILES_PLACEHOLDER = '{files}';
+// ---------------------------------------------------------------- arguments
+export const livePassTargetSchema = z.object({
+    screen: z.string().min(1).describe("Screen or route name, e.g. 'orders' or 'settings/profile'."),
+    state: z.string().min(1).describe("State to capture, e.g. 'default', 'empty', 'offline', 'error', 'sheet-open'."),
+    viewport: z.string().min(1).describe("Viewport as WxH, e.g. '390x844' or '1280x800'. For the maestro driver, the device form factor."),
+    expected: z.string().min(1).describe("What this frame must show for a PASS. For an intentional error/empty/offline state, name the reason text and the recovery affordance."),
+});
+export const livePassArgsSchema = z.object({
+    targets: z.array(livePassTargetSchema).min(1).describe("Every frame the pass must produce. The verdict is derived from this list: a target that produced no frame fails the pass, whether Gemini skipped it with a reason or never reported it at all — a skip explains missing evidence, it does not excuse it."),
+    brief: z.string().refine(value => value.trim().length > 0, ERROR_MESSAGES.LIVE_PASS_NO_BRIEF)
+        .describe("Narrative context: base URL or app id, the served-branch marker, the seed case, navigation hints, and anything Gemini cannot infer from the targets."),
+    workingDirectory: z.string().min(1).describe("Absolute path to the worktree under test. Used as the agy cwd and workspace root; must exist and must not be a filesystem root."),
+    artifactDir: z.string().optional().describe("Absolute directory for the captured PNGs and manifest.json. Must be strictly inside workingDirectory. Defaults to <workingDirectory>/.live-pass/<timestamp>."),
+    driver: z.enum(['playwright', 'maestro']).describe("Which MCP server Gemini drives: 'playwright' for web, 'maestro' for a booted simulator."),
+    model: z.string().default(MODELS.MEDIUM).describe(`${MODEL_CHOICE_DESCRIPTION} Defaults to '${MODELS.MEDIUM}'.`),
+    printTimeout: z.string().default(LIVE_PASS.DEFAULT_PRINT_TIMEOUT).describe("agy --print-timeout for the whole walk. A full pass takes minutes."),
+    yolo: z.boolean().default(true).describe("Pass --dangerously-skip-permissions so Gemini may drive its MCP servers unattended. Without it agy denies the tool calls and the pass is BLOCKED. Refused when workingDirectory is a filesystem root."),
+    publishCommand: z.string().optional().describe("Optional shell command run in code after validation, with {files} replaced by the shell-quoted paths of the frames that validated OK. Its stdout is returned as PR markdown. Never run on a BLOCKED pass."),
+    conversationId: z.string().min(1).optional().describe("Resume a previous pass so Gemini can report deltas (resolved / regressions / changes) against what it saw then. The browser or simulator still starts fresh."),
+}).superRefine((value, ctx) => {
+    const seen = new Set();
+    value.targets.forEach((target, index) => {
+        const key = targetKey(target);
+        if (seen.has(key)) {
+            ctx.addIssue({
+                code: 'custom',
+                message: `duplicate target: ${target.screen} / ${target.state} / ${target.viewport}`,
+                path: ['targets', index],
+            });
+        }
+        seen.add(key);
+    });
+});
+// ------------------------------------------------------------ result schema
+const frameSchema = z.object({
+    file: z.string().describe("Absolute path of the PNG you saved for this frame."),
+    screen: z.string().describe("The requested target's screen string, copied exactly."),
+    state: z.string().describe("The requested target's state string, copied exactly."),
+    expected: z.string().describe("What the brief said this state must show."),
+    viewport: z.string().describe("The requested target's viewport string, copied exactly."),
+    verdict: z.enum(['PASS', 'FAIL']),
+    observed: z.string().describe("What the image actually shows, in your own words, after opening it."),
+});
+const findingSchema = z.object({
+    severity: z.enum(['BLOCKER', 'MAJOR', 'MINOR']),
+    screen: z.string(),
+    description: z.string(),
+    evidence_file: z.string().optional(),
+});
+const noteSchema = z.object({
+    screen: z.string(),
+    description: z.string(),
+    evidence_file: z.string().optional(),
+});
+export const livePassResultSchema = z.object({
+    verdict: z.enum(['PASS', 'FAIL', 'BLOCKED']),
+    summary: z.string(),
+    served_branch_check: z.string().describe("How you confirmed the running app is the branch under test, or why you could not."),
+    frames: z.array(frameSchema),
+    findings: z.array(findingSchema),
+    regressions: z.array(findingSchema).describe("Behaviour that worked in the earlier pass of this conversation and is broken now. Empty on a fresh pass."),
+    resolved: z.array(noteSchema).describe("Defects reported earlier in this conversation that are now fixed. Never affects the verdict. Empty on a fresh pass."),
+    changes: z.array(noteSchema).describe("Neutral differences from the earlier pass that are neither broken nor a fix. Empty on a fresh pass."),
+    skipped: z.array(z.object({ target: z.string(), reason: z.string() })),
+});
+export const LIVE_PASS_RESULT_JSON_SCHEMA = toAgyJsonSchema(livePassResultSchema);
+const LIVE_PASS_RESULT_SCHEMA_TEXT = JSON.stringify(LIVE_PASS_RESULT_JSON_SCHEMA);
+// ------------------------------------------------------------------- prompt
+function normalize(value) {
+    return value.trim().toLowerCase().replace(/\s+/g, '');
+}
+function targetKey(target) {
+    return [normalize(target.screen), normalize(target.state), normalize(target.viewport)].join('|');
+}
+function slugify(value) {
+    return value.toLowerCase().replace(/[^a-z0-9]+/g, '-').replace(/^-+|-+$/g, '') || 'x';
+}
+/**
+ * The one filename a target's evidence may use. Derived in code from the whole
+ * screen/state/viewport triple so two targets can never share a file — letting
+ * Gemini name frames allowed one overwritten screenshot to satisfy several
+ * targets at once.
+ */
+export function frameFileName(target) {
+    return `${slugify(target.screen)}-${slugify(target.state)}-${slugify(target.viewport)}.png`;
+}
+/**
+ * One filename per target, keyed by target. Slugifying can map two distinct
+ * targets (`a/b` and `a-b`) onto one name, so a collision is suffixed rather
+ * than left to collapse two targets into one file.
+ */
+export function prescribedFrameNames(targets) {
+    const used = new Set();
+    const byTarget = new Map();
+    for (const target of targets) {
+        const base = frameFileName(target);
+        let name = base;
+        for (let suffix = 2; used.has(name); suffix++) {
+            name = base.replace(/\.png$/, `-${suffix}.png`);
+        }
+        used.add(name);
+        byTarget.set(targetKey(target), name);
+    }
+    return byTarget;
+}
+function renderTargets(targets, artifactDir) {
+    const names = prescribedFrameNames(targets);
+    return targets
+        .map((target, index) => `${index + 1}. screen: ${target.screen} | state: ${target.state} | viewport: ${target.viewport}\n` +
+        `   expected: ${target.expected}\n` +
+        `   file: ${path.join(artifactDir, names.get(targetKey(target)))}`)
+        .join('\n');
+}
+const PLAYWRIGHT_PROCEDURE = `Driver: the "${LIVE_PASS.PLAYWRIGHT_MCP_NAME}" MCP server.
+For each target, in order:
+- browser_navigate to the target's route.
+- Wait until the marker named in the brief is present. Never screenshot a page that still shows a spinner or skeleton when a content state was requested.
+- browser_resize to the target's viewport.
+- browser_take_screenshot with filename set to the exact absolute path printed as "file:" for that target below. Never invent a filename, never reuse another target's file, and never use fullPage.
+- For a scrolling screen: browser_resize to (width, 4000), then browser_evaluate this snippet to measure the real content height, then browser_resize to (width, measured) and shoot:
+  () => { const skip = (el) => el.closest('[aria-hidden="true"]') || el.closest('[role="tab"]'); let bottom = 0; for (const el of document.querySelectorAll('body *')) { if (skip(el)) continue; const hasText = Array.from(el.childNodes).some(n => n.nodeType === 3 && n.textContent.trim()); if (!hasText) continue; bottom = Math.max(bottom, el.getBoundingClientRect().bottom + window.scrollY); } return Math.ceil(bottom + 24); }
+- Capture centred/terminal states and sheets at 390x844 and again at 320x568 when the targets ask for both.
+- browser_snapshot only to locate an element. Never copy a snapshot or accessibility tree into your answer.
+- Scroll a virtualized list to its end before asserting that something is absent.`;
+const MAESTRO_PROCEDURE = `Driver: the "${LIVE_PASS.MAESTRO_MCP_NAME}" MCP server.
+For each target, in order:
+- list_devices first and use the returned udid for every later call. Never guess a device.
+- run an inline YAML flow to reach the state, then inspect_screen to confirm it settled.
+- Never use take_screenshot for evidence: it returns an image inline and saves nothing.
+- After each settled state, shell out: xcrun simctl io <udid> screenshot <the exact absolute path printed as "file:" for that target below>. Never invent a filename and never reuse another target's file.
+- Only one driver may own a simulator at a time. If the device is busy, record the target as skipped with that reason rather than fighting for it — the pass then FAILS for missing evidence, which is the honest outcome. Never fabricate or reuse a frame.`;
+const RESUMED_DELTA_SECTION = `## Delta reporting (this conversation has an earlier pass)
+Compare against the frames and findings you reported earlier in this conversation.
+- A defect you reported before that is now fixed goes in "resolved".
+- Behaviour that worked before and is broken now goes in "regressions".
+- A difference that is neither (a moved control, changed copy that reads correctly) goes in "changes".
+- A new defect goes in "findings".
+Never put an improvement in "findings" or "regressions". The browser or simulator starts fresh: walk every target again, do not answer from memory.`;
+export function buildLivePassPrompt(config) {
+    const { brief, driver, targets, workingDirectory, artifactDir, resumed } = config;
+    const procedure = driver === 'maestro' ? MAESTRO_PROCEDURE : PLAYWRIGHT_PROCEDURE;
+    return `# Live UI pass
+
+You are walking a running application, capturing screenshots, looking at them yourself, and reporting what you saw as text. The caller never opens an image, so everything you see in a screenshot must become a sentence in your answer.
+Your answer is ONLY the schema JSON. No prose before or after it, no markdown fences, no image data, no base64, no accessibility trees.
+
+## Environment
+- Artifact directory (write here, and only here): ${artifactDir}
+- Working directory (read-only): ${workingDirectory}
+- Never read, list or glob outside those two directories.
+- Never edit product code, never create or modify files outside the artifact directory, and never run a git command that changes state (no add, commit, checkout, stash, restore, clean).
+
+## Procedure
+${procedure}
+
+## Targets
+Capture exactly these, use these exact screen / state / viewport strings in your frames, and save each one to its own "file:" path — copied verbatim into that frame's "file". One file per target: a file that answers two targets is treated as no evidence at all.
+${renderTargets(targets, artifactDir)}
+
+## Served-branch check first
+Before any capture, confirm the running app is the build under test using the marker in the brief. If you cannot confirm it, stop, set verdict BLOCKED, and explain in served_branch_check. Never report on an app you cannot identify.
+
+## Evidence discipline
+- Open every PNG you saved and describe it in "observed". "observed" is what the image shows, not what you expected it to show.
+- Judge each frame against the state the brief requested for it, using that target's "expected" as the checklist:
+  - Where a content state was requested, a spinner, blank page, skeleton, error, or the wrong screen is a FAIL.
+  - Where the brief intentionally exercises an error, empty, offline, permission-denied or other terminal state, the frame PASSES when it shows that state with everything "expected" names (for instance the reason text and the recovery affordance, when "expected" names them) and FAILS when any of that is missing. An intentional state that renders as "expected" describes it is never a finding by itself.
+  - Something "expected" does not ask for is at most a MINOR finding. It never makes the frame FAIL.
+- Report position separately from presence: "the control exists but sits below the fold" is not "the control is missing".
+- If a target is unreachable, delete any stale PNG already sitting at that frame's filename, add the target to "skipped" with the reason, and do not invent a frame for it.
+- If you cannot open a PNG you saved, say so in "observed" and mark that frame FAIL.
+
+## Manifest
+Write ${artifactDir}/${LIVE_PASS.MANIFEST_FILE} containing {"run_started": <ISO timestamp>, "driver": "${driver}", "frames": [...], "skipped": [...]} mirroring your answer.
+
+## Verdict rules
+- PASS only when every requested target was captured and each frame matches the state the brief requested.
+- FAIL when any frame is FAIL, any finding is BLOCKER or MAJOR, or anything regressed.
+- BLOCKED when the environment stopped you: the app is not the branch under test, the driver would not start, or a tool call was denied.
+${resumed ? `\n${RESUMED_DELTA_SECTION}\n` : '\nThis is a fresh pass: return empty arrays for "resolved", "regressions" and "changes".\n'}
+## Brief
+${brief}`;
+}
+/**
+ * Realpath'd like the artifact dir, so a frame reported through a symlinked
+ * spelling of the same directory is not mistaken for an escape.
+ */
+function frameAbsolutePath(file, artifactDir) {
+    return realpathOfExistingPrefix(path.isAbsolute(file) ? file : path.resolve(artifactDir, file));
+}
+function checkFrameFile(absFile, artifactDir, runStartMs) {
+    if (!isWithin(artifactDir, absFile))
+        return 'OUTSIDE';
+    try {
+        const stat = fs.statSync(absFile);
+        if (!stat.isFile())
+            return 'MISSING';
+        if (stat.size === 0)
+            return 'EMPTY';
+        if (stat.mtimeMs < runStartMs - LIVE_PASS.FRESHNESS_TOLERANCE_MS)
+            return 'STALE';
+        return 'OK';
+    }
+    catch {
+        return 'MISSING';
+    }
+}
+function readManifestProblems(artifactDir, frameCount, runStartMs) {
+    const manifestPath = path.join(artifactDir, LIVE_PASS.MANIFEST_FILE);
+    let raw;
+    let writtenMs;
+    try {
+        raw = fs.readFileSync(manifestPath, 'utf-8');
+        writtenMs = fs.statSync(manifestPath).mtimeMs;
+    }
+    catch {
+        return [`${LIVE_PASS.MANIFEST_FILE} was not written`];
+    }
+    // A reused artifact directory can still hold an earlier run's manifest, which
+    // would pass a shape-and-count check while describing frames nobody captured.
+    if (writtenMs < runStartMs - LIVE_PASS.FRESHNESS_TOLERANCE_MS) {
+        return [`${LIVE_PASS.MANIFEST_FILE} predates this run: it is left over from an earlier pass`];
+    }
+    let parsed;
+    try {
+        parsed = JSON.parse(raw);
+    }
+    catch {
+        return [`${LIVE_PASS.MANIFEST_FILE} is not valid JSON`];
+    }
+    const manifestFrames = parsed?.frames;
+    if (!Array.isArray(manifestFrames)) {
+        return [`${LIVE_PASS.MANIFEST_FILE} has no frames array`];
+    }
+    if (manifestFrames.length !== frameCount) {
+        return [`${LIVE_PASS.MANIFEST_FILE} lists ${manifestFrames.length} frames but the answer reports ${frameCount}`];
+    }
+    return [];
+}
+function listCaptures(artifactDir) {
+    try {
+        return fs.readdirSync(artifactDir)
+            .filter(name => /\.(png|jpe?g)$/i.test(name))
+            .map(name => path.join(artifactDir, name));
+    }
+    catch {
+        return [];
+    }
+}
+/** Check every reported frame against the disk. Never throws. */
+export function validateFrames(result, artifactDir, runStartMs, targets = []) {
+    const prescribed = prescribedFrameNames(targets);
+    const claimedBy = new Set();
+    const notes = [];
+    const checks = result.frames.map(frame => {
+        const absFile = frameAbsolutePath(frame.file, artifactDir);
+        const expectedName = prescribed.get(targetKey(frame));
+        // A second frame pointing at the same file is one screenshot answering two
+        // targets — no evidence for either, however good the picture is.
+        const status = claimedBy.has(absFile)
+            ? 'DUPLICATE'
+            : checkFrameFile(absFile, artifactDir, runStartMs);
+        claimedBy.add(absFile);
+        const misnamed = Boolean(expectedName) && path.basename(absFile) !== expectedName;
+        if (misnamed) {
+            notes.push(`MISNAMED: ${absFile} (${frame.screen} / ${frame.state}) — expected ${expectedName}`);
+        }
+        return { file: absFile, screen: frame.screen, state: frame.state, status, misnamed };
+    });
+    const problems = [
+        ...checks.filter(check => check.status !== 'OK').map(check => check.status === 'DUPLICATE'
+            ? `DUPLICATE: reused evidence file ${check.file} (${check.screen} / ${check.state})`
+            : `${check.status}: ${check.file} (${check.screen} / ${check.state})`),
+        ...readManifestProblems(artifactDir, result.frames.length, runStartMs),
+    ];
+    return {
+        checks,
+        okFiles: checks.filter(check => check.status === 'OK').map(check => check.file),
+        problems,
+        notes,
+        unreportedCaptures: listCaptures(artifactDir).filter(file => !claimedBy.has(file)),
+    };
+}
+/** Match each requested target to a reported frame, case- and whitespace-insensitively. */
+export function checkCoverage(targets, result) {
+    const frameKeys = new Map();
+    for (const frame of result.frames) {
+        frameKeys.set(targetKey(frame), frame.file);
+    }
+    const uncovered = [];
+    const skipped = [];
+    const matchedKeys = new Set();
+    for (const target of targets) {
+        const key = targetKey(target);
+        if (frameKeys.has(key)) {
+            matchedKeys.add(key);
+            continue;
+        }
+        const skip = result.skipped.find(entry => {
+            const haystack = normalize(entry.target);
+            return haystack.includes(normalize(target.screen)) && haystack.includes(normalize(target.state));
+        });
+        if (skip) {
+            skipped.push({ target, reason: skip.reason });
+        }
+        else {
+            uncovered.push(target);
+        }
+    }
+    const extraFrames = result.frames
+        .filter(frame => !matchedKeys.has(targetKey(frame)))
+        .map(frame => frame.file);
+    return { uncovered, skipped, extraFrames };
+}
+/** Gemini's own verdict is advisory; this is the one the caller acts on. */
+export function deriveVerdict(input) {
+    const { result, validation, coverage, deniedActions } = input;
+    const reasons = [];
+    if (deniedActions)
+        reasons.push(`agy denied required actions: ${deniedActions}`);
+    if (result.verdict === 'BLOCKED')
+        reasons.push('Gemini reported BLOCKED');
+    if (reasons.length > 0)
+        return { verdict: 'BLOCKED', reported: result.verdict, reasons };
+    for (const frame of result.frames.filter(frame => frame.verdict === 'FAIL')) {
+        reasons.push(`frame FAIL: ${frame.screen} / ${frame.state}`);
+    }
+    reasons.push(...validation.problems);
+    for (const target of coverage.uncovered) {
+        reasons.push(`uncovered target: ${target.screen} / ${target.state} / ${target.viewport}`);
+    }
+    for (const entry of coverage.skipped) {
+        reasons.push(`skipped target: ${entry.target.screen} / ${entry.target.state} (${entry.reason})`);
+    }
+    for (const regression of result.regressions) {
+        reasons.push(`regression: ${regression.screen} — ${regression.description}`);
+    }
+    for (const finding of result.findings.filter(f => f.severity === 'BLOCKER' || f.severity === 'MAJOR')) {
+        reasons.push(`${finding.severity} finding: ${finding.screen} — ${finding.description}`);
+    }
+    return {
+        verdict: reasons.length > 0 ? 'FAIL' : 'PASS',
+        reported: result.verdict,
+        reasons,
+    };
+}
+function shellQuote(value) {
+    return `'${value.replace(/'/g, `'\\''`)}'`;
+}
+export async function runPublishCommand(command, okFiles, cwd) {
+    if (!command?.trim()) {
+        return { ran: false, stdout: '', stderr: '', exitCode: null };
+    }
+    if (okFiles.length === 0) {
+        return { ran: false, stdout: '', stderr: '', exitCode: null, skippedReason: 'no frames validated OK' };
+    }
+    const resolved = command.split(FILES_PLACEHOLDER).join(okFiles.map(shellQuote).join(' '));
+    try {
+        const running = execFileAsync('/bin/sh', ['-c', resolved], {
+            cwd,
+            maxBuffer: PUBLISH_MAX_BUFFER,
+            timeout: PUBLISH_TIMEOUT_MS,
+        });
+        // Close stdin so a command that reads it (an upload prompting for input)
+        // fails fast instead of hanging the MCP call after a finished pass.
+        running.child.stdin?.end();
+        const { stdout, stderr } = await running;
+        return { ran: true, command: resolved, stdout: stdout.trim(), stderr: stderr.trim(), exitCode: 0 };
+    }
+    catch (error) {
+        const failure = error;
+        return {
+            ran: true,
+            command: resolved,
+            stdout: (failure.stdout ?? '').trim(),
+            stderr: (failure.stderr ?? failure.message ?? '').trim(),
+            exitCode: typeof failure.code === 'number' ? failure.code : null,
+        };
+    }
+}
+// ------------------------------------------------------------------ report
+export function formatLivePassReport(input) {
+    const { envelope, result, decision, validation, coverage, driver, model, artifactDir } = input;
+    const statusById = new Map(validation.checks.map(check => [check.file, check.status]));
+    const headline = decision.verdict === decision.reported
+        ? `# Live pass: ${decision.verdict}`
+        : `# Live pass: ${decision.verdict} (Gemini reported ${decision.reported})`;
+    const parts = [];
+    if (envelope.conversation_id)
+        parts.push(formatConversationLine(envelope.conversation_id));
+    parts.push(headline);
+    parts.push(`driver: ${driver} · model: ${model} · artifacts: ${artifactDir}`);
+    parts.push(formatAgyUsageLine(envelope));
+    parts.push(section('Why', bulletList(decision.reasons)));
+    parts.push(section('Served-branch check', result.served_branch_check || '- not reported'));
+    parts.push(section('Summary', result.summary || '- not reported'));
+    parts.push(section('Frames', bulletList(result.frames.map(frame => {
+        const abs = frameAbsolutePath(frame.file, artifactDir);
+        return `${frame.verdict} [${statusById.get(abs) ?? 'UNKNOWN'}] ${frame.screen} / ${frame.state} / ${frame.viewport}\n` +
+            `  file: ${abs}\n  expected: ${frame.expected}\n  observed: ${frame.observed}`;
+    }))));
+    const renderFindings = (items) => bulletList(items.map(item => `${item.severity} ${item.screen}: ${item.description}${item.evidence_file ? ` (${item.evidence_file})` : ''}`));
+    const renderNotes = (items) => bulletList(items.map(item => `${item.screen}: ${item.description}${item.evidence_file ? ` (${item.evidence_file})` : ''}`));
+    parts.push(section('Findings', renderFindings(result.findings)));
+    parts.push(section('Regressions', renderFindings(result.regressions)));
+    parts.push(section('Resolved', renderNotes(result.resolved)));
+    parts.push(section('Changes', renderNotes(result.changes)));
+    parts.push(section('Skipped', bulletList([
+        ...result.skipped.map(entry => `${entry.target}: ${entry.reason}`),
+        ...coverage.uncovered.map(target => `${target.screen} / ${target.state} / ${target.viewport}: no frame and no skip reason`),
+    ])));
+    const validationLines = [...validation.problems, ...validation.notes];
+    if (validation.unreportedCaptures.length > 0) {
+        validationLines.push(`captures not reported as frames: ${validation.unreportedCaptures.join(', ')}`);
+    }
+    if (coverage.extraFrames.length > 0) {
+        validationLines.push(`frames matching no requested target: ${coverage.extraFrames.join(', ')}`);
+    }
+    parts.push(section('Validation', bulletList(validationLines)));
+    if (input.deniedActions) {
+        parts.push(section('Denied actions', `- ${input.deniedActions}`));
+    }
+    const workingTreeSection = formatWorkingTreeSection(input.workingTree);
+    if (workingTreeSection)
+        parts.push(workingTreeSection);
+    const { publish } = input;
+    if (publish.ran) {
+        parts.push(section('PR markdown', publish.exitCode === 0
+            ? publish.stdout || '- publish command produced no output'
+            : `- publish command exited ${publish.exitCode ?? 'unknown'}\n- ${publish.stderr || 'no stderr'}`));
+    }
+    else if (publish.skippedReason) {
+        parts.push(section('PR markdown', `- publish command not run: ${publish.skippedReason}`));
+    }
+    return parts.join('\n\n');
+}
+// ------------------------------------------------------------------ execute
+function resolveArtifactDir(workingDirectory, requested) {
+    // The default candidate goes through the same resolve-and-contain check as an
+    // explicit one: a `.live-pass` symlink pointing outside the worktree would
+    // otherwise let the default escape the boundary the tool advertises.
+    const stamp = new Date().toISOString().replace(/[:.]/g, '-');
+    const candidate = requested ?? path.join(workingDirectory, LIVE_PASS.DEFAULT_ARTIFACT_SEGMENT, stamp);
+    const resolved = realpathOfExistingPrefix(candidate);
+    const strictlyInside = path.isAbsolute(candidate) &&
+        isWithin(workingDirectory, resolved) &&
+        resolved !== workingDirectory;
+    if (!strictlyInside) {
+        throw new Error(`${ERROR_MESSAGES.LIVE_PASS_ARTIFACT_DIR}. Received '${candidate}'.`);
+    }
+    return resolved;
+}
+export const livePassTool = {
+    name: "live-pass",
+    description: "Delegate a live UI pass to Gemini: it drives its own Playwright or Maestro MCP server, captures screenshots into a worktree-local artifact directory, looks at them itself, and returns a text verdict with per-frame observations. No image ever reaches the caller's context.",
+    zodSchema: livePassArgsSchema,
+    prompt: {
+        description: "Walk a running app with Gemini driving Playwright or Maestro, capture the requested screen/state/viewport frames, and return a PASS/FAIL/BLOCKED verdict with per-frame observations, findings, and optional PR markdown.",
+    },
+    category: 'gemini',
+    annotations: {
+        title: "Live UI Pass",
+        readOnlyHint: false,
+        openWorldHint: true,
+    },
+    execute: async (args, onProgress) => {
+        const input = livePassArgsSchema.parse(args);
+        const workingDirectory = resolveWorkingDirectory(input.workingDirectory);
+        const artifactDir = resolveArtifactDir(workingDirectory, input.artifactDir);
+        fs.mkdirSync(artifactDir, { recursive: true });
+        const runStartMs = Date.now();
+        const before = await snapshotWorkingTree(workingDirectory);
+        const afterWorkingTree = async () => diffWorkingTree(before, await snapshotWorkingTree(workingDirectory), { ignoreDirectory: artifactDir });
+        let envelope;
+        try {
+            envelope = await executeAgyJson(buildLivePassPrompt({
+                brief: input.brief,
+                driver: input.driver,
+                targets: input.targets,
+                workingDirectory,
+                artifactDir,
+                resumed: Boolean(input.conversationId),
+            }), {
+                model: input.model,
+                yolo: input.yolo,
+                printTimeout: input.printTimeout,
+                conversationId: input.conversationId,
+                includeDirectories: [workingDirectory, artifactDir],
+                cwd: workingDirectory,
+                jsonSchema: LIVE_PASS_RESULT_SCHEMA_TEXT,
+                noCache: true,
+            }, onProgress);
+        }
+        catch (error) {
+            // A timeout, a non-zero exit or an ERROR envelope can all land after
+            // Gemini has already used its shell: the warning must survive the failure.
+            failWithWorkingTree(error, await afterWorkingTree());
+        }
+        // Snapshot before branching: an off-schema answer must still report edits
+        // Gemini made with the shell this pass handed it.
+        const workingTree = await afterWorkingTree();
+        const parsed = livePassResultSchema.safeParse(envelope.structured_output);
+        if (!parsed.success) {
+            return [
+                renderUnparsableEnvelope(envelope, '# Live pass: BLOCKED', formatZodIssues(parsed.error), `artifacts: ${artifactDir}`),
+                formatWorkingTreeSection(workingTree),
+            ].filter(Boolean).join('\n\n');
+        }
+        const result = parsed.data;
+        const validation = validateFrames(result, artifactDir, runStartMs, input.targets);
+        const coverage = checkCoverage(input.targets, result);
+        const deniedActions = deniedActionsSummary(envelope);
+        const decision = deriveVerdict({ result, validation, coverage, deniedActions });
+        // A BLOCKED pass proves nothing, so its frames are never published.
+        const publish = decision.verdict === 'BLOCKED'
+            ? { ran: false, stdout: '', stderr: '', exitCode: null, skippedReason: 'pass was BLOCKED' }
+            : await runPublishCommand(input.publishCommand, validation.okFiles, workingDirectory);
+        return formatLivePassReport({
+            envelope,
+            result,
+            decision,
+            validation,
+            coverage,
+            driver: input.driver,
+            model: input.model,
+            artifactDir,
+            deniedActions,
+            workingTree,
+            publish,
+        });
+    },
+};
+//# sourceMappingURL=live-pass.tool.js.map

package/dist/tools/live-pass.tool.js.map

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

package/dist/tools/registry.d.ts

@@ -1,6 +1,6 @@
 import { Tool, Prompt } from "@modelcontextprotocol/sdk/types.js";
 import { ToolArguments } from "../constants.js";
-import { ZodTypeAny } from "zod";
+import { type ZodType, ZodError } from "zod";
 /**
  * MCP Tool annotations per specification.
  * @see https://spec.modelcontextprotocol.io/specification/2025-03-26/server/tools/#annotations
@@ -20,7 +20,7 @@ export interface ToolAnnotations {
 export interface UnifiedTool {
     name: string;
     description: string;
-    zodSchema: ZodTypeAny;
+    zodSchema: ZodType;
     prompt?: {
         description: string;
         arguments?: Array<{
@@ -38,6 +38,8 @@ export declare const toolRegistry: UnifiedTool[];
 export declare function toolExists(toolName: string): boolean;
 export declare function getToolDefinitions(): Tool[];
 export declare function getPromptDefinitions(): Prompt[];
+/** Zod issues as `path: message` lines, for error text and schema-mismatch reports. */
+export declare function formatZodIssues(error: ZodError): string[];
 export declare function executeTool(toolName: string, args: ToolArguments, onProgress?: (newOutput: string) => void): Promise<string>;
 export declare function getPromptMessage(toolName: string, args: Record<string, any>): string;
 //# sourceMappingURL=registry.d.ts.map

package/dist/tools/registry.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,UAAU,EAAY,MAAM,KAAK,CAAC;AAG3C;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,UAAU,CAAC;IAEtB,MAAM,CAAC,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,OAAO,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC;IAEF,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,6CAA6C;IAC7C,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,eAAO,MAAM,YAAY,EAAE,WAAW,EAAO,CAAC;AAC9C,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AACD,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CAiB3C;AAcD,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAQ/C;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CAUlI;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAsBpF"}
+{"version":3,"file":"registry.d.ts","sourceRoot":"","sources":["../../src/tools/registry.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,MAAM,oCAAoC,CAAC;AAElE,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAK,KAAK,OAAO,EAAE,QAAQ,EAAE,MAAM,KAAK,CAAC;AAEhD;;;GAGG;AACH,MAAM,WAAW,eAAe;IAC9B,wCAAwC;IACxC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,wDAAwD;IACxD,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,wDAAwD;IACxD,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,uEAAuE;IACvE,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,yDAAyD;IACzD,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,SAAS,EAAE,OAAO,CAAC;IAEnB,MAAM,CAAC,EAAE;QACP,WAAW,EAAE,MAAM,CAAC;QACpB,SAAS,CAAC,EAAE,KAAK,CAAC;YAChB,IAAI,EAAE,MAAM,CAAC;YACb,WAAW,EAAE,MAAM,CAAC;YACpB,QAAQ,EAAE,OAAO,CAAC;SACnB,CAAC,CAAC;KACJ,CAAC;IAEF,OAAO,EAAE,CAAC,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;IAC5F,QAAQ,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,CAAC;IAC3C,6CAA6C;IAC7C,WAAW,CAAC,EAAE,eAAe,CAAC;CAC/B;AAED,eAAO,MAAM,YAAY,EAAE,WAAW,EAAO,CAAC;AAC9C,wBAAgB,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAEpD;AACD,wBAAgB,kBAAkB,IAAI,IAAI,EAAE,CAkB3C;AAcD,wBAAgB,oBAAoB,IAAI,MAAM,EAAE,CAQ/C;AAED,uFAAuF;AACvF,wBAAgB,eAAe,CAAC,KAAK,EAAE,QAAQ,GAAG,MAAM,EAAE,CAEzD;AAED,wBAAsB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,CAAC,EAAE,CAAC,SAAS,EAAE,MAAM,KAAK,IAAI,GAAG,OAAO,CAAC,MAAM,CAAC,CASlI;AAED,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,GAAG,MAAM,CAsBpF"}