swipium 1.0.0 → 1.1.0

package/dist/tools/permissions.js

@@ -0,0 +1,149 @@
+// qa_permissions (PHASE3-PLAN §4.2) — list / grant / revoke Android runtime permissions without
+// raw adb. grant is low-risk (commonly used to pre-approve and skip a dialog) and only logged;
+// revoke can break app state, so it is consent-gated. Every mutation is recorded as an
+// environment change for qa_report.
+import { z } from 'zod';
+import { qaOk, qaError } from '../lib/result.js';
+import { requireConsent, consumeConsent } from '../consent/consent.js';
+import { getDriver } from '../session/attach.js';
+import { listRuntimePermissions, grantPermission, revokePermission } from '../lib/device.js';
+export function registerPermissions(server, sessions) {
+    server.registerTool('qa_permissions', {
+        title: 'App permissions',
+        description: 'Inspect or change a package\'s Android runtime permissions. action: list (granted/denied), grant (pre-approve to skip a dialog — logged), revoke (consent-gated, can break app state — logged). `package` defaults to the session\'s appId; `permission` is a full android.permission.* name (e.g. android.permission.ACCESS_FINE_LOCATION).',
+        inputSchema: {
+            sessionId: z.string(),
+            action: z.enum(['list', 'grant', 'revoke']),
+            package: z.string().optional().describe('Target package (default: the session appId).'),
+            permission: z.string().optional().describe('Full permission name, required for grant/revoke.'),
+            consentId: z.string().optional(),
+            approve: z.boolean().optional(),
+        },
+    }, async ({ sessionId, action, package: pkgArg, permission, consentId, approve }) => {
+        const session = sessions.get(sessionId);
+        const { driver } = session ? await getDriver(session) : { driver: undefined };
+        const serial = driver?.currentDevice();
+        if (!session || !driver || !serial) {
+            return qaError({ what: 'No device attached to this session', changedState: false, retrySafe: true, nextSteps: ['Call qa_prepare_target first.'] });
+        }
+        const pkg = pkgArg ?? session.appId;
+        if (!pkg) {
+            return qaError({ what: 'No package given and the session has no appId', changedState: false, retrySafe: true, nextSteps: ['Pass package, or qa_prepare_target to set the appId.'] });
+        }
+        if (action === 'list') {
+            const perms = await listRuntimePermissions(serial, pkg);
+            return qaOk({ package: pkg, ...perms }, `${pkg}: ${perms.granted.length} granted, ${perms.denied.length} denied\n  granted: ${perms.granted.join(', ') || '—'}\n  denied: ${perms.denied.join(', ') || '—'}`);
+        }
+        if (!permission) {
+            return qaError({ what: `${action} requires a permission name`, changedState: false, retrySafe: true, nextSteps: ['Pass permission="android.permission.…" (qa_permissions list to see them).'] });
+        }
+        if (action === 'revoke') {
+            // Revoking can crash/break the app — gate behind consent.
+            const gate = consumeConsent(consentId, approve, { action: 'permission_revoke', affects: { package: pkg, permission } });
+            if (!gate.approved) {
+                sessions.recordMutation(session, {
+                    tool: 'qa_permissions',
+                    action: 'permission_revoke',
+                    risk: 'medium',
+                    target: { package: pkg, permission },
+                    consent: { required: true, approved: false },
+                    status: 'requested',
+                });
+                return requireConsent({
+                    action: 'permission_revoke',
+                    risk: 'medium',
+                    exactCommand: `adb -s ${serial} shell pm revoke ${pkg} ${permission}`,
+                    affects: { package: pkg, permission },
+                    explain: `Revoke ${permission} from ${pkg}? This can change app behavior or crash a poorly-guarded app.`,
+                });
+            }
+            sessions.recordMutation(session, {
+                tool: 'qa_permissions',
+                action: 'permission_revoke',
+                risk: 'medium',
+                target: { package: pkg, permission },
+                consent: { required: true, consentId, approved: true },
+                status: 'approved',
+            });
+            try {
+                await revokePermission(serial, pkg, permission);
+            }
+            catch (e) {
+                sessions.recordMutation(session, {
+                    tool: 'qa_permissions',
+                    action: 'permission_revoke',
+                    risk: 'medium',
+                    target: { package: pkg, permission },
+                    consent: { required: true, consentId, approved: true },
+                    status: 'blocked',
+                    detail: String(e),
+                });
+                return qaError({ what: `revoke failed: ${String(e)}`, changedState: false, retrySafe: true, nextSteps: ['Check the permission name; some are not revocable.'] });
+            }
+            sessions.addEnvChange(session, `permission revoke ${permission} from ${pkg}`);
+            sessions.recordMutation(session, {
+                tool: 'qa_permissions',
+                action: 'permission_revoke',
+                risk: 'medium',
+                target: { package: pkg, permission },
+                consent: { required: true, consentId, approved: true },
+                status: 'executed',
+            });
+            return qaOk({ package: pkg, permission, action }, `revoked ${permission} from ${pkg}`);
+        }
+        // grant — low risk, but still a state mutation (it can hide a permission-dialog bug), so
+        // it is consent-gated (low) and always reported, never silent.
+        const grantGate = consumeConsent(consentId, approve, { action: 'permission_grant', affects: { package: pkg, permission } });
+        if (!grantGate.approved) {
+            sessions.recordMutation(session, {
+                tool: 'qa_permissions',
+                action: 'permission_grant',
+                risk: 'low',
+                target: { package: pkg, permission },
+                consent: { required: true, approved: false },
+                status: 'requested',
+            });
+            return requireConsent({
+                action: 'permission_grant',
+                risk: 'low',
+                exactCommand: `adb -s ${serial} shell pm grant ${pkg} ${permission}`,
+                affects: { package: pkg, permission },
+                explain: `Pre-grant ${permission} to ${pkg}? This skips the runtime permission dialog — convenient, but it can mask a permission-prompt bug.`,
+            });
+        }
+        sessions.recordMutation(session, {
+            tool: 'qa_permissions',
+            action: 'permission_grant',
+            risk: 'low',
+            target: { package: pkg, permission },
+            consent: { required: true, consentId, approved: true },
+            status: 'approved',
+        });
+        try {
+            await grantPermission(serial, pkg, permission);
+        }
+        catch (e) {
+            sessions.recordMutation(session, {
+                tool: 'qa_permissions',
+                action: 'permission_grant',
+                risk: 'low',
+                target: { package: pkg, permission },
+                consent: { required: true, consentId, approved: true },
+                status: 'blocked',
+                detail: String(e),
+            });
+            return qaError({ what: `grant failed: ${String(e)}`, changedState: false, retrySafe: true, nextSteps: ['Check the permission name; only runtime permissions are grantable.'] });
+        }
+        sessions.addEnvChange(session, `permission grant ${permission} to ${pkg}`);
+        sessions.recordMutation(session, {
+            tool: 'qa_permissions',
+            action: 'permission_grant',
+            risk: 'low',
+            target: { package: pkg, permission },
+            consent: { required: true, consentId, approved: true },
+            status: 'executed',
+        });
+        return qaOk({ package: pkg, permission, action }, `granted ${permission} to ${pkg}`);
+    });
+}
+//# sourceMappingURL=permissions.js.map

package/dist/tools/permissions.js.map

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

package/dist/tools/screenInfo.js

@@ -0,0 +1,70 @@
+// qa_screen_info — device + screen metadata for coordinate-driven (visual-fallback) work,
+// so the agent doesn't shell out to `adb shell wm size/density` or measure screenshots.
+import { z } from 'zod';
+import { qaOk, qaError } from '../lib/result.js';
+import { getOrientation } from '../lib/device.js';
+import { getDriver } from '../session/attach.js';
+export function registerScreenInfo(server, sessions) {
+    server.registerTool('qa_screen_info', {
+        title: 'Screen info',
+        description: 'Device + screen metadata for coordinate work: width/height (px), density (dpi), session mode (structured | visual-fallback), the latest screenshot URI, and budget counters. Use this in visual-fallback mode to place coordinate taps instead of shelling out to wm size/density.',
+        inputSchema: { sessionId: z.string() },
+    }, async ({ sessionId }) => {
+        const session = sessions.get(sessionId);
+        const { driver } = session ? await getDriver(session) : { driver: undefined };
+        if (!session || !driver) {
+            return qaError({
+                what: 'No device attached to this session',
+                changedState: false,
+                retrySafe: true,
+                nextSteps: ['Call qa_prepare_target first.'],
+            });
+        }
+        const serial = driver.currentDevice();
+        const [size, density, orient] = await Promise.all([driver.screenSize(), driver.screenDensity(), serial ? getOrientation(serial).catch(() => null) : Promise.resolve(null)]);
+        const orientation = orient ? (orient.rotation === 1 || orient.rotation === 3 ? 'landscape' : 'portrait') : 'unknown';
+        const lastShot = [...session.artifacts].reverse().find((a) => a.kind === 'screenshot');
+        // Coordinate landmarks (P1.7) for visual-fallback taps — so the agent places taps from
+        // named anchors instead of guessing pixels off a screenshot.
+        let landmarks;
+        let bands;
+        if (size) {
+            const w = size.width;
+            const h = size.height;
+            const X = (fx) => Math.round(w * fx);
+            const Y = (fy) => Math.round(h * fy);
+            landmarks = {
+                topNavCenter: [X(0.5), Y(0.06)],
+                bottomNavCenter: [X(0.5), Y(0.96)],
+                center: [X(0.5), Y(0.5)],
+                topLeft: [X(0.08), Y(0.06)],
+                topRight: [X(0.92), Y(0.06)],
+                bottomLeft: [X(0.08), Y(0.96)],
+                bottomRight: [X(0.92), Y(0.96)],
+                primaryCtaArea: [X(0.5), Y(0.88)], // most apps put the main CTA in the bottom band
+            };
+            bands = {
+                topNav: { yFrom: 0, yTo: Y(0.12) },
+                content: { yFrom: Y(0.12), yTo: Y(0.85) },
+                bottomNav: { yFrom: Y(0.9), yTo: h },
+                ctaBand: { yFrom: Y(0.78), yTo: Y(0.95) },
+            };
+        }
+        return qaOk({
+            device: session.device ?? null,
+            screen: size ? { width: size.width, height: size.height, density } : null,
+            orientation,
+            coordinateNote: 'landmarks/bands are DEVICE pixels (origin top-left) — pass directly as qa_act {x,y}. For screenshot-space hits (qa_visual find_image) convert with coordinateSpace.scale.',
+            mode: session.mode,
+            headless: session.headless ?? null,
+            latestScreenshot: lastShot?.uri ?? null,
+            landmarks,
+            bands,
+            counters: session.counters,
+            budget: session.budget,
+        }, `device=${session.device} screen=${size ? `${size.width}x${size.height}@${density ?? '?'}dpi` : 'unknown'} mode=${session.mode}` +
+            (landmarks ? `\nlandmarks: center=${landmarks.center} bottomNav=${landmarks.bottomNavCenter} cta=${landmarks.primaryCtaArea}` : '') +
+            (lastShot ? `\nlatest screenshot: ${lastShot.uri}` : '\n(no screenshot yet — call qa_screenshot)'));
+    });
+}
+//# sourceMappingURL=screenInfo.js.map

package/dist/tools/screenInfo.js.map

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

package/dist/tools/screenRecord.js

@@ -1,18 +1,34 @@
-// Screen-recording lifecycle helpers retained so shutdown/report paths stay idempotent.
+// qa_screen_record (PHASE3-PLAN §4.2 / NEXT-PLAN Fix 5) — capture a screen video on Android
+// (adb screenrecord) or the iOS Simulator (simctl io recordVideo). start spawns the recorder
+// (consent-gated, sensitive-screen warning); status reports whether one is active; stop finalizes
+// it gracefully (SIGINT so the mp4 isn't corrupted), saves an artifact, and cleans up. Active
+// recordings are tracked in a module-level map (the child handle is live-only, like the driver);
+// they are best-effort finalized on server shutdown and surfaced by qa_report.
+import { z } from 'zod';
+import { spawn } from 'node:child_process';
+import { readFileSync, rmSync } from 'node:fs';
+import { tmpdir } from 'node:os';
+import { join } from 'node:path';
+import { qaOk, qaError } from '../lib/result.js';
+import { requireConsent, consumeConsent } from '../consent/consent.js';
+import { sensitiveRefusal } from '../lib/sensitive.js';
 import { run } from '../lib/spawn.js';
+import { getDriver } from '../session/attach.js';
 const active = new Map();
-/** Is a recording active for this session? Used by qa_report. */
+export function shouldSaveRecording(saveMode, failed) {
+    return saveMode === 'always' || failed === true;
+}
+/** Is a recording active for this session? (used by qa_report). */
 export function activeRecording(sessionId) {
     const r = active.get(sessionId);
-    return r ? { backend: r.backend, seconds: Math.round((Date.now() - r.startedAt) / 1000) } : undefined;
+    return r ? { backend: r.backend, seconds: Math.round(((r.endedAt ?? Date.now()) - r.startedAt) / 1000) } : undefined;
 }
-/** Best-effort: stop every active recorder so the server does not leave a device recording. */
+/** Best-effort: stop every active recorder so the server doesn't leave a device recording. */
 export async function stopAllRecordings() {
     for (const [, rec] of active) {
         try {
-            if (rec.backend === 'direct') {
+            if (rec.backend === 'direct')
                 await run('adb', ['-s', rec.serial, 'shell', 'pkill', '-INT', 'screenrecord'], { timeoutMs: 5000 }).catch(() => { });
-            }
             rec.child.kill('SIGINT');
         }
         catch {
@@ -21,4 +37,197 @@ export async function stopAllRecordings() {
     }
     active.clear();
 }
+export function registerScreenRecord(server, sessions) {
+    server.registerTool('qa_screen_record', {
+        title: 'Record the screen',
+        description: 'Record a screen video (Android emulator/device, iOS Simulator, or WDA-backed iOS Simulator). action:"start" begins recording (consent-gated — it captures whatever is on screen, including anything sensitive; avoid password/OTP screens); action:"status" reports whether one is active; action:"stop" finalizes it and saves an mp4 artifact. Use save:"on_failure" on start plus failed:false on stop to discard passing-run videos in CI. Android recordings auto-stop after ~3 minutes. One recording per session at a time.',
+        inputSchema: {
+            sessionId: z.string(),
+            action: z.enum(['start', 'status', 'stop']),
+            save: z.enum(['always', 'on_failure']).optional().describe('Recording retention mode for action:"start". Defaults to always. Use on_failure in CI to discard videos when stop is called with failed:false.'),
+            failed: z.boolean().optional().describe('For action:"stop" with save:"on_failure": true saves the video, false discards it.'),
+            consentId: z.string().optional(),
+            approve: z.boolean().optional(),
+        },
+    }, async ({ sessionId, action, save, failed, consentId, approve }) => {
+        const session = sessions.get(sessionId);
+        const { driver } = session ? await getDriver(session) : { driver: undefined };
+        const serial = driver?.currentDevice();
+        if (!session || !driver || !serial) {
+            return qaError({ what: 'No device attached to this session', changedState: false, retrySafe: true, nextSteps: ['Call qa_prepare_target / qa_ios boot first.'] });
+        }
+        const backend = driver.kind === 'direct' ? 'direct' : driver.kind === 'simulator' ? 'simulator' : driver.kind === 'wda' ? 'wda_simulator' : null;
+        if (!backend) {
+            return qaError({ what: 'Screen recording is not supported on this backend', changedState: false, retrySafe: false, failureCode: 'BACKEND_UNSUPPORTED', nextSteps: ['Use the Android, iOS-simulator, or WDA-backed iOS simulator backend.'] });
+        }
+        // ---- status ----
+        if (action === 'status') {
+            const r = active.get(sessionId);
+            // The recorder process may have ended on its own (the Android `--time-limit 180` cap)
+            // while the entry is still held so `stop` can pull and save the file. Report that
+            // honestly instead of implying it's still capturing.
+            const ended = !!r?.endedAt;
+            const seconds = r ? Math.round(((r.endedAt ?? Date.now()) - r.startedAt) / 1000) : 0;
+            return qaOk({ recording: !!r, capturing: !!r && !ended, autoStopped: ended, backend: r?.backend ?? null, saveMode: r?.saveMode ?? null, seconds }, r
+                ? ended
+                    ? `recording auto-stopped (${r.backend}, ${r.saveMode}, ~${seconds}s; Android time-limit reached) — qa_screen_record { action: "stop", failed:<bool> } to save the mp4.`
+                    : `recording active (${r.backend}, ${r.saveMode}, ~${seconds}s) — qa_screen_record { action: "stop", failed:<bool> } to finalize.`
+                : 'no active recording.');
+        }
+        // ---- start ----
+        if (action === 'start') {
+            if (session.sensitive)
+                return sensitiveRefusal('Screen recording');
+            if (active.has(sessionId)) {
+                return qaError({ what: 'A recording is already in progress for this session', changedState: false, retrySafe: true, nextSteps: ['Call qa_screen_record { action: "stop" } first (or "status").'] });
+            }
+            const saveMode = save ?? 'always';
+            const gate = consumeConsent(consentId, approve, { action: 'screen_record', affects: { device: serial } });
+            if (!gate.approved) {
+                sessions.recordMutation(session, {
+                    tool: 'qa_screen_record',
+                    action: 'screen_record',
+                    risk: 'medium',
+                    target: { device: serial, backend, saveMode },
+                    consent: { required: true, approved: false },
+                    status: 'requested',
+                });
+                const cmd = backend === 'direct' ? `adb -s ${serial} shell screenrecord --time-limit 180 /sdcard/…mp4` : `xcrun simctl io ${serial} recordVideo …mp4`;
+                return requireConsent({ action: 'screen_record', risk: 'medium', exactCommand: cmd, affects: { device: serial }, explain: 'Record the device screen to a video? It captures everything shown — do NOT record password/OTP/payment screens.' });
+            }
+            sessions.recordMutation(session, {
+                tool: 'qa_screen_record',
+                action: 'screen_record',
+                risk: 'medium',
+                target: { device: serial, backend, saveMode },
+                consent: { required: true, consentId, approved: true },
+                status: 'approved',
+            });
+            let rec;
+            if (backend === 'direct') {
+                const remotePath = `/sdcard/swipium-rec-${Date.now()}.mp4`;
+                const child = spawn('adb', ['-s', serial, 'shell', 'screenrecord', '--time-limit', '180', remotePath], { stdio: 'ignore' });
+                child.unref();
+                rec = { child, backend, serial, saveMode, remotePath, startedAt: Date.now() };
+            }
+            else {
+                const hostPath = join(tmpdir(), `swipium-iosrec-${Date.now()}.mp4`);
+                const child = spawn('xcrun', ['simctl', 'io', serial, 'recordVideo', '--codec', 'h264', hostPath], { stdio: 'ignore' });
+                child.unref();
+                rec = { child, backend, serial, saveMode, hostPath, startedAt: Date.now() };
+            }
+            active.set(sessionId, rec);
+            // Mark when the recorder exits on its own (Android `--time-limit 180`) so `status`
+            // stops claiming it's still capturing. The entry stays so `stop` can still save the file.
+            rec.child.once('exit', () => {
+                if (!rec.endedAt)
+                    rec.endedAt = Date.now();
+            });
+            sessions.addEnvChange(session, `screen_record started (${backend}, ${saveMode})`);
+            sessions.recordMutation(session, {
+                tool: 'qa_screen_record',
+                action: 'screen_record',
+                risk: 'medium',
+                target: { device: serial, backend, saveMode },
+                consent: { required: true, consentId, approved: true },
+                status: 'executed',
+                detail: 'recording started',
+            });
+            return qaOk({ recording: true, backend, saveMode }, `recording started (${backend}, ${saveMode})${backend === 'direct' ? ' (auto-stops after ~3 min)' : ''} — call qa_screen_record { action: "stop", failed:<bool> } to finalize${saveMode === 'on_failure' ? ' and keep only on failure' : ' and save the video'}.`);
+        }
+        // ---- stop ----
+        const rec = active.get(sessionId);
+        if (!rec) {
+            return qaError({ what: 'No active recording for this session', changedState: false, retrySafe: true, nextSteps: ['Start one with qa_screen_record { action: "start" } (or check "status").'] });
+        }
+        active.delete(sessionId);
+        const localTmp = join(tmpdir(), `swipium-recpull-${Date.now()}.mp4`);
+        try {
+            const keep = shouldSaveRecording(rec.saveMode, failed);
+            if (!keep) {
+                if (rec.backend === 'direct') {
+                    await run('adb', ['-s', rec.serial, 'shell', 'pkill', '-INT', 'screenrecord'], { timeoutMs: 8000 }).catch(() => { });
+                    await new Promise((r) => setTimeout(r, 1500));
+                    try {
+                        rec.child.kill();
+                    }
+                    catch {
+                        /* already gone */
+                    }
+                    await run('adb', ['-s', rec.serial, 'shell', 'rm', rec.remotePath], { timeoutMs: 8000 }).catch(() => { });
+                }
+                else {
+                    rec.child.kill('SIGINT');
+                    await new Promise((r) => setTimeout(r, 2000));
+                }
+                sessions.addEnvChange(session, 'screen_record discarded (passed, on_failure)');
+                sessions.recordMutation(session, {
+                    tool: 'qa_screen_record',
+                    action: 'screen_record_stop',
+                    risk: 'low',
+                    target: { device: rec.serial, backend: rec.backend, saveMode: rec.saveMode, failed: failed ?? null },
+                    consent: { required: false, approved: true },
+                    status: 'restored',
+                    detail: 'discarded recording',
+                });
+                return qaOk({ recording: false, saved: false, discarded: true, seconds: Math.round((Date.now() - rec.startedAt) / 1000), backend: rec.backend, saveMode: rec.saveMode }, 'discarded recording because save mode is on_failure and failed:false');
+            }
+            let buf;
+            if (rec.backend === 'direct') {
+                await run('adb', ['-s', rec.serial, 'shell', 'pkill', '-INT', 'screenrecord'], { timeoutMs: 8000 }).catch(() => { });
+                await new Promise((r) => setTimeout(r, 1500));
+                try {
+                    rec.child.kill();
+                }
+                catch {
+                    /* already gone */
+                }
+                await run('adb', ['-s', rec.serial, 'pull', rec.remotePath, localTmp], { timeoutMs: 30000, rejectOnNonZero: true });
+                buf = readFileSync(localTmp);
+                await run('adb', ['-s', rec.serial, 'shell', 'rm', rec.remotePath], { timeoutMs: 8000 }).catch(() => { });
+            }
+            else {
+                // iOS: SIGINT the recorder so it finalizes the file it's writing on the host, then read it.
+                rec.child.kill('SIGINT');
+                await new Promise((r) => setTimeout(r, 2000));
+                buf = readFileSync(rec.hostPath);
+            }
+            const uri = sessions.saveArtifact(session, 'recording', `recording-${Date.now()}.mp4`, buf, 'video/mp4', `screen recording (${rec.backend}, ${Math.round((Date.now() - rec.startedAt) / 1000)}s)`);
+            sessions.addEnvChange(session, 'screen_record stopped');
+            sessions.recordMutation(session, {
+                tool: 'qa_screen_record',
+                action: 'screen_record_stop',
+                risk: 'low',
+                target: { device: rec.serial, backend: rec.backend, saveMode: rec.saveMode, failed: failed ?? null },
+                consent: { required: false, approved: true },
+                status: 'restored',
+                ledgerUri: uri,
+                detail: 'saved recording',
+            });
+            return qaOk({ recording: false, saved: true, uri, bytes: buf.length, seconds: Math.round((Date.now() - rec.startedAt) / 1000), backend: rec.backend, saveMode: rec.saveMode }, `saved recording (${buf.length} bytes) → ${uri}`);
+        }
+        catch (e) {
+            sessions.recordMutation(session, {
+                tool: 'qa_screen_record',
+                action: 'screen_record_stop',
+                risk: 'low',
+                target: { device: rec.serial, backend: rec.backend, saveMode: rec.saveMode, failed: failed ?? null },
+                consent: { required: false, approved: true },
+                status: 'blocked',
+                detail: String(e),
+            });
+            return qaError({ what: `Could not finalize the recording: ${String(e)}`, changedState: true, retrySafe: false, nextSteps: ['The backend may not support screen recording, or it stopped early. Try a shorter clip.'] });
+        }
+        finally {
+            try {
+                rmSync(localTmp, { force: true });
+                if (rec.hostPath)
+                    rmSync(rec.hostPath, { force: true });
+            }
+            catch {
+                /* best-effort */
+            }
+        }
+    });
+}
 //# sourceMappingURL=screenRecord.js.map

package/dist/tools/screenRecord.js.map

@@ -1 +1 @@
-{"version":3,"file":"screenRecord.js","sourceRoot":"","sources":["../../src/tools/screenRecord.ts"],"names":[],"mappings":"AAAA,wFAAwF;AAGxF,OAAO,EAAE,GAAG,EAAE,MAAM,iBAAiB,CAAC;AAStC,MAAM,MAAM,GAAG,IAAI,GAAG,EAAqB,CAAC;AAE5C,iEAAiE;AACjE,MAAM,UAAU,eAAe,CAAC,SAAiB;IAC/C,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC,CAAC,IAAI,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,SAAS,CAAC,GAAG,IAAI,CAAC,EAAE,CAAC,CAAC,CAAC,SAAS,CAAC;AACxG,CAAC;AAED,+FAA+F;AAC/F,MAAM,CAAC,KAAK,UAAU,iBAAiB;IACrC,KAAK,MAAM,CAAC,EAAE,GAAG,CAAC,IAAI,MAAM,EAAE,CAAC;QAC7B,IAAI,CAAC;YACH,IAAI,GAAG,CAAC,OAAO,KAAK,QAAQ,EAAE,CAAC;gBAC7B,MAAM,GAAG,CAAC,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,EAAE,cAAc,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,GAAE,CAAC,CAAC,CAAC;YACtH,CAAC;YACD,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC3B,CAAC;QAAC,MAAM,CAAC;YACP,iBAAiB;QACnB,CAAC;IACH,CAAC;IACD,MAAM,CAAC,KAAK,EAAE,CAAC;AACjB,CAAC"}
+{"version":3,"file":"screenRecord.js","sourceRoot":"","sources":["../../src/tools/screenRecord.ts"],"names":[],"mappings":"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"}

package/dist/tools/seed.js

@@ -0,0 +1,101 @@
+// qa_seed (PHASE3-PLAN §4.4 / roadmap §9) — turn a declared precondition into one Swipium can
+// actually create, OPT-IN and consent-gated. A fixture may carry a `seed` spec: a deep link, a
+// project-root script, or an API call. Every seed is a mutation → explicit consent, exact action
+// shown. The raw execution lives in src/flows/seedExec.ts (shared with the flow `seed` step). If
+// seeding fails it is reported as a SETUP failure (environment bucket), never an app bug.
+import { z } from 'zod';
+import { qaOk, qaError } from '../lib/result.js';
+import { qaFail } from '../oracle/failures.js';
+import { requireConsent, consumeConsent } from '../consent/consent.js';
+import { executeSeed, seedExactCommand, seedGitScopeViolation } from '../flows/seedExec.js';
+import { getDriver } from '../session/attach.js';
+export function registerSeed(server, sessions) {
+    server.registerTool('qa_seed', {
+        title: 'Seed a precondition',
+        description: 'Create a declared precondition (opt-in, consent-gated) so a blocked workflow can run. The named fixture must declare a `seed`: deeplink (open a setup deep link), script (argv array run under the project root), or api (HTTP call). Every seed is a mutation and requires consent showing the exact action. If seeding fails it is reported as a SETUP failure, not an app bug.',
+        inputSchema: {
+            sessionId: z.string(),
+            fixture: z.string().describe('Name of a declared fixture that has a `seed` spec.'),
+            consentId: z.string().optional(),
+            approve: z.boolean().optional(),
+        },
+    }, async ({ sessionId, fixture: fixtureName, consentId, approve }) => {
+        const session = sessions.get(sessionId);
+        if (!session) {
+            return qaError({ what: `Unknown sessionId ${sessionId}`, changedState: false, retrySafe: true, nextSteps: ['Call qa_start_session first.'] });
+        }
+        const fixture = session.fixtures.find((f) => f.name === fixtureName);
+        if (!fixture) {
+            return qaError({ what: `No declared fixture "${fixtureName}"`, changedState: false, retrySafe: true, nextSteps: ['Declare it in .swipium/fixtures.json or qa_start_session { fixtures }.'] });
+        }
+        const seed = fixture.seed;
+        if (!seed) {
+            return qaError({ what: `Fixture "${fixtureName}" has no seed spec`, changedState: false, retrySafe: true, nextSteps: ['Add a seed: { type: "deeplink"|"script"|"api", … } to the fixture to make it creatable.'] });
+        }
+        const git = seedGitScopeViolation(seed);
+        if (git) {
+            return qaFail('GIT_SCOPE_FORBIDDEN', {
+                what: `Fixture "${fixtureName}" seed command is refused because Git is outside Swipium's QA scope: ${git}`,
+                changedState: false,
+                extra: { fixture: fixtureName, command: git },
+            });
+        }
+        // Consent — exact action shown, scoped to this fixture + seed type.
+        const affects = { fixture: fixtureName, type: seed.type };
+        const risk = seed.type === 'script' ? 'high' : seed.type === 'api' ? 'medium' : 'low';
+        const gate = consumeConsent(consentId, approve, { action: 'seed_state', affects });
+        if (!gate.approved) {
+            sessions.recordMutation(session, {
+                tool: 'qa_seed',
+                action: 'seed_state',
+                risk,
+                target: affects,
+                consent: { required: true, approved: false },
+                status: 'requested',
+            });
+            return requireConsent({
+                action: 'seed_state',
+                risk,
+                exactCommand: seedExactCommand(seed),
+                affects,
+                explain: `Seed precondition "${fixtureName}" via ${seed.type}? This mutates state${seed.type === 'script' ? ' by running a command under the project root' : seed.type === 'api' ? ' by calling an external API' : ' by opening a deep link'}.`,
+            });
+        }
+        sessions.recordMutation(session, {
+            tool: 'qa_seed',
+            action: 'seed_state',
+            risk,
+            target: affects,
+            consent: { required: true, consentId, approved: true },
+            status: 'approved',
+        });
+        const { driver } = await getDriver(session);
+        const result = await executeSeed(sessions, session, driver, fixtureName, seed);
+        if (!result.ok) {
+            // Record as a SETUP failure (not an app bug) so the report can't mislabel it.
+            sessions.addNote(session, { at: Date.now(), workflow: `seed:${fixtureName}`, outcome: 'blocked', category: 'missing_test_data', reason: `seed failed: ${result.detail}`, requiredState: fixture.requiredState, recommendedSetup: fixture.recommendedSetup });
+            sessions.recordMutation(session, {
+                tool: 'qa_seed',
+                action: 'seed_state',
+                risk,
+                target: affects,
+                consent: { required: true, consentId, approved: true },
+                status: 'blocked',
+                detail: result.detail,
+            });
+            return qaFail('SEED_FAILED', { what: `Seeding "${fixtureName}" failed: ${result.detail}`, changedState: true, extra: { fixture: fixtureName, type: seed.type } });
+        }
+        sessions.addNote(session, { at: Date.now(), workflow: `seed:${fixtureName}`, outcome: 'pass', reason: `precondition created via ${seed.type}` });
+        sessions.recordMutation(session, {
+            tool: 'qa_seed',
+            action: 'seed_state',
+            risk,
+            target: affects,
+            consent: { required: true, consentId, approved: true },
+            status: 'executed',
+            detail: result.warnings.join(' ') || undefined,
+        });
+        return qaOk({ fixture: fixtureName, type: seed.type, seeded: true, warnings: result.warnings }, `✅ seeded "${fixtureName}" via ${seed.type} — the precondition should now be met. Re-run the workflow.${result.warnings.length ? `\n⚠ ${result.warnings.join(' ')}` : ''}`);
+    });
+}
+//# sourceMappingURL=seed.js.map

package/dist/tools/seed.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"seed.js","sourceRoot":"","sources":["../../src/tools/seed.ts"],"names":[],"mappings":"AAAA,8FAA8F;AAC9F,+FAA+F;AAC/F,iGAAiG;AACjG,iGAAiG;AACjG,0FAA0F;AAE1F,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AACvE,OAAO,EAAE,WAAW,EAAE,gBAAgB,EAAE,qBAAqB,EAAE,MAAM,sBAAsB,CAAC;AAC5F,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAGjD,MAAM,UAAU,YAAY,CAAC,MAAiB,EAAE,QAAsB;IACpE,MAAM,CAAC,YAAY,CACjB,SAAS,EACT;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EACT,mXAAmX;QACrX,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,CAAC,oDAAoD,CAAC;YAClF,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;YAChC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;SAChC;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,OAAO,EAAE,WAAW,EAAE,SAAS,EAAE,OAAO,EAAE,EAAE,EAAE;QAChE,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,qBAAqB,SAAS,EAAE,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,8BAA8B,CAAC,EAAE,CAAC,CAAC;QAChJ,CAAC;QACD,MAAM,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;QACrE,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,wBAAwB,WAAW,GAAG,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,wEAAwE,CAAC,EAAE,CAAC,CAAC;QAChM,CAAC;QACD,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC;QAC1B,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,YAAY,WAAW,oBAAoB,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,yFAAyF,CAAC,EAAE,CAAC,CAAC;QACtN,CAAC;QACD,MAAM,GAAG,GAAG,qBAAqB,CAAC,IAAI,CAAC,CAAC;QACxC,IAAI,GAAG,EAAE,CAAC;YACR,OAAO,MAAM,CAAC,qBAAqB,EAAE;gBACnC,IAAI,EAAE,YAAY,WAAW,wEAAwE,GAAG,EAAE;gBAC1G,YAAY,EAAE,KAAK;gBACnB,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,OAAO,EAAE,GAAG,EAAE;aAC9C,CAAC,CAAC;QACL,CAAC;QAED,oEAAoE;QACpE,MAAM,OAAO,GAAG,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,CAAC;QAC1D,MAAM,IAAI,GAAG,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC;QACtF,MAAM,IAAI,GAAG,cAAc,CAAC,SAAS,EAAE,OAAO,EAAE,EAAE,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,CAAC,CAAC;QACnF,IAAI,CAAC,IAAI,CAAC,QAAQ,EAAE,CAAC;YACnB,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE;gBAC/B,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,YAAY;gBACpB,IAAI;gBACJ,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE;gBAC5C,MAAM,EAAE,WAAW;aACpB,CAAC,CAAC;YACH,OAAO,cAAc,CAAC;gBACpB,MAAM,EAAE,YAAY;gBACpB,IAAI;gBACJ,YAAY,EAAE,gBAAgB,CAAC,IAAI,CAAC;gBACpC,OAAO;gBACP,OAAO,EAAE,sBAAsB,WAAW,SAAS,IAAI,CAAC,IAAI,uBAAuB,IAAI,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,8CAA8C,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,6BAA6B,CAAC,CAAC,CAAC,yBAAyB,GAAG;aAChP,CAAC,CAAC;QACL,CAAC;QACD,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE;YAC/B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,YAAY;YACpB,IAAI;YACJ,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;YACtD,MAAM,EAAE,UAAU;SACnB,CAAC,CAAC;QAEH,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC;QAC5C,MAAM,MAAM,GAAG,MAAM,WAAW,CAAC,QAAQ,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,IAAI,CAAC,CAAC;QAC/E,IAAI,CAAC,MAAM,CAAC,EAAE,EAAE,CAAC;YACf,8EAA8E;YAC9E,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,WAAW,EAAE,EAAE,OAAO,EAAE,SAAS,EAAE,QAAQ,EAAE,mBAAmB,EAAE,MAAM,EAAE,gBAAgB,MAAM,CAAC,MAAM,EAAE,EAAE,aAAa,EAAE,OAAO,CAAC,aAAa,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE,CAAC,CAAC;YAC7P,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE;gBAC/B,IAAI,EAAE,SAAS;gBACf,MAAM,EAAE,YAAY;gBACpB,IAAI;gBACJ,MAAM,EAAE,OAAO;gBACf,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;gBACtD,MAAM,EAAE,SAAS;gBACjB,MAAM,EAAE,MAAM,CAAC,MAAM;aACtB,CAAC,CAAC;YACH,OAAO,MAAM,CAAC,aAAa,EAAE,EAAE,IAAI,EAAE,YAAY,WAAW,aAAa,MAAM,CAAC,MAAM,EAAE,EAAE,YAAY,EAAE,IAAI,EAAE,KAAK,EAAE,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACpK,CAAC;QACD,QAAQ,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,EAAE,EAAE,IAAI,CAAC,GAAG,EAAE,EAAE,QAAQ,EAAE,QAAQ,WAAW,EAAE,EAAE,OAAO,EAAE,MAAM,EAAE,MAAM,EAAE,4BAA4B,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QACjJ,QAAQ,CAAC,cAAc,CAAC,OAAO,EAAE;YAC/B,IAAI,EAAE,SAAS;YACf,MAAM,EAAE,YAAY;YACpB,IAAI;YACJ,MAAM,EAAE,OAAO;YACf,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,SAAS,EAAE,QAAQ,EAAE,IAAI,EAAE;YACtD,MAAM,EAAE,UAAU;YAClB,MAAM,EAAE,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,SAAS;SAC/C,CAAC,CAAC;QACH,OAAO,IAAI,CACT,EAAE,OAAO,EAAE,WAAW,EAAE,IAAI,EAAE,IAAI,CAAC,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,QAAQ,EAAE,MAAM,CAAC,QAAQ,EAAE,EAClF,aAAa,WAAW,SAAS,IAAI,CAAC,IAAI,8DAA8D,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,MAAM,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,EAAE,CAC3K,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}