swipium 1.5.0 → 2.0.0

package/dist/tools/state.js

@@ -1,217 +0,0 @@
-import { createHash } from 'node:crypto';
-import { z } from 'zod';
-import { qaError, qaOk } from '../lib/result.js';
-import { requireConsent, consumeConsent } from '../consent/consent.js';
-import { getDriver } from '../session/attach.js';
-import { normalizeCommand } from '../flows/seedExec.js';
-import { loadStateProfile, prepareStateProfile, teardownStateProfile, verifyStateProfile, } from '../state/profile.js';
-const schema = {
-    sessionId: z.string(),
-    profile: z.string().describe('State profile name under .swipium/state/<name>.yaml, or inline YAML.'),
-};
-const mutatingSchema = {
-    ...schema,
-    consentId: z.string().optional(),
-    approve: z.boolean().optional(),
-};
-function stable(value) {
-    if (Array.isArray(value))
-        return value.map(stable);
-    if (value && typeof value === 'object') {
-        return Object.fromEntries(Object.entries(value)
-            .sort(([a], [b]) => a.localeCompare(b))
-            .map(([k, v]) => [k, stable(v)]));
-    }
-    return value;
-}
-function hash(value) {
-    return createHash('sha256')
-        .update(JSON.stringify(stable(value)))
-        .digest('hex');
-}
-function seedActionPreview(seed) {
-    if (!seed)
-        return null;
-    if (seed.type === 'script') {
-        const normalized = normalizeCommand(seed.command);
-        return {
-            type: 'script',
-            command: normalized.argv,
-            deprecatedStringCommand: normalized.deprecated || undefined,
-            parseError: normalized.parseError,
-        };
-    }
-    if (seed.type === 'api')
-        return {
-            type: 'api',
-            method: seed.method ?? 'POST',
-            url: seed.url ?? null,
-            bodyHash: seed.body ? hash(seed.body).slice(0, 16) : null,
-            headerKeys: Object.keys(seed.headers ?? {}).sort(),
-        };
-    return { type: 'deeplink', url: seed.url ?? null };
-}
-function seedPreview(seed) {
-    const preview = seedActionPreview(seed);
-    if (!preview)
-        return null;
-    return { ...preview, idempotent: seed?.idempotent ?? false, cleanup: seedActionPreview(seed?.cleanup) };
-}
-function cleanupFixtures(session, profile) {
-    if (!session)
-        return [];
-    return (profile.seed ?? []).map((s) => s.fixture).filter((name) => !!session.fixtures.find((f) => f.name === name)?.seed?.cleanup);
-}
-export function teardownMutations(profile, session) {
-    const explicit = (profile.teardown ?? [])
-        .filter((t) => t === 'networkOnline' || (typeof t === 'object' && t.networkOnline))
-        .map(() => 'networkOnline');
-    return [...explicit, ...cleanupFixtures(session, profile).map((name) => `seedCleanup:${name}`)];
-}
-export function stateProfileAffects(session, action, profile, path) {
-    const appId = profile.appId ?? session.appId ?? null;
-    const seedFixtures = (profile.seed ?? []).map((s) => s.fixture);
-    return {
-        action,
-        sessionId: session.id,
-        profileName: profile.name,
-        profilePath: path ?? null,
-        profileHash: hash(profile),
-        appId,
-        reset: profile.reset ?? null,
-        launch: profile.launch ?? null,
-        seedFixtures,
-        seedDetails: seedFixtures.map((name) => ({ fixture: name, seed: seedPreview(session.fixtures.find((f) => f.name === name)?.seed) })),
-        teardownMutations: teardownMutations(profile, session),
-    };
-}
-export function hasStateProfileMutation(action, profile, session) {
-    if (action === 'verify')
-        return false;
-    if (action === 'teardown')
-        return teardownMutations(profile, session).length > 0;
-    return !!((profile.reset?.android && profile.reset.android !== 'none') ||
-        (profile.reset?.ios && profile.reset.ios !== 'none') ||
-        profile.launch ||
-        (profile.seed?.length ?? 0) > 0);
-}
-export function stateRisk(action, profile, session) {
-    if (profile.reset?.android === 'clearData' || profile.reset?.ios === 'reinstallApp' || profile.launch?.clearState)
-        return 'high';
-    const seedTypes = (profile.seed ?? []).map((s) => session.fixtures.find((f) => f.name === s.fixture)?.seed?.type);
-    const cleanupTypes = action === 'teardown' ? (profile.seed ?? []).map((s) => session.fixtures.find((f) => f.name === s.fixture)?.seed?.cleanup?.type) : [];
-    if (seedTypes.includes('script') || cleanupTypes.includes('script'))
-        return 'high';
-    if (seedTypes.includes('api') || cleanupTypes.includes('api') || profile.launch?.permissions || action === 'teardown')
-        return 'medium';
-    return 'low';
-}
-function stateFailureCode(status) {
-    return status === 'state_refused' ? 'UNSAFE_ACTION_REFUSED' : 'SEED_FAILED';
-}
-export function registerState(server, sessions) {
-    const handler = (action) => async ({ sessionId, profile, 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 { driver } = await getDriver(session);
-        if (!driver)
-            return qaError({
-                what: 'No device attached to this session',
-                changedState: false,
-                retrySafe: true,
-                nextSteps: ['Prepare a target first.'],
-            });
-        const loaded = loadStateProfile(session.root, profile);
-        if (!loaded.profile)
-            return qaError({
-                what: loaded.error ?? 'Could not load state profile',
-                changedState: false,
-                retrySafe: true,
-                failureCode: 'INVALID_FLOW',
-                nextSteps: ['Create .swipium/state/<name>.yaml or pass inline YAML.'],
-            });
-        const affects = stateProfileAffects(session, action, loaded.profile, loaded.path);
-        const mutationPayloadHash = hash(affects);
-        const mutating = hasStateProfileMutation(action, loaded.profile, session);
-        const risk = stateRisk(action, loaded.profile, session);
-        if (mutating) {
-            const gate = consumeConsent(consentId, approve, { action: 'state_profile_mutation', affects });
-            if (!gate.approved) {
-                sessions.recordMutation(session, {
-                    tool: `qa_state_${action}`,
-                    action: 'state_profile_mutation',
-                    risk,
-                    target: affects,
-                    consent: { required: true, approved: false, payloadHash: mutationPayloadHash },
-                    status: 'requested',
-                });
-                return requireConsent({
-                    action: 'state_profile_mutation',
-                    risk,
-                    exactCommand: `swipium state ${action} ${loaded.profile.name}`,
-                    affects,
-                    explain: `Apply state profile "${loaded.profile.name}" (${action})? This can mutate app/device state through reset, launch, permissions, seed, or teardown operations.`,
-                });
-            }
-            sessions.recordMutation(session, {
-                tool: `qa_state_${action}`,
-                action: 'state_profile_mutation',
-                risk,
-                target: affects,
-                consent: { required: true, consentId, approved: true, payloadHash: mutationPayloadHash },
-                status: 'approved',
-            });
-        }
-        const ledger = action === 'prepare'
-            ? await prepareStateProfile(sessions, session, driver, loaded.profile)
-            : action === 'verify'
-                ? await verifyStateProfile(driver, loaded.profile)
-                : await teardownStateProfile(sessions, session, driver, loaded.profile);
-        ledger.mutationPayloadHash = mutationPayloadHash;
-        const uri = sessions.saveArtifact(session, 'state', `state-${action}-${loaded.profile.name}-${Date.now()}.json`, JSON.stringify(ledger, null, 2), 'application/json', `state ${action} ledger`);
-        const ok = ledger.status !== 'state_refused' && ledger.status !== 'state_blocked';
-        if (mutating)
-            sessions.recordMutation(session, {
-                tool: `qa_state_${action}`,
-                action: 'state_profile_mutation',
-                risk,
-                target: affects,
-                consent: { required: true, consentId, approved: true, payloadHash: mutationPayloadHash },
-                status: ok ? 'executed' : ledger.status === 'state_refused' ? 'refused' : 'blocked',
-                ledgerUri: uri,
-                detail: ledger.status,
-            });
-        if (!ok) {
-            return qaError({
-                what: `state ${action} ${loaded.profile.name}: ${ledger.status}`,
-                changedState: mutating,
-                retrySafe: ledger.status !== 'state_refused',
-                failureCode: stateFailureCode(ledger.status),
-                nextSteps: ['Open the state ledger artifact, fix the profile/reset/seed/device blocker, then retry.'],
-            }, { action, profile: loaded.profile.name, path: loaded.path ?? null, ledger, ledgerUri: uri, ok });
-        }
-        return qaOk({ action, profile: loaded.profile.name, path: loaded.path ?? null, ledger, ledgerUri: uri, ok }, `state ${action} ${loaded.profile.name}: ${ledger.status}\nledger: ${uri}`);
-    };
-    server.registerTool('qa_state_prepare', {
-        title: 'Prepare a reproducible state profile',
-        description: 'Apply a .swipium/state/*.yaml profile as one transaction: reset policy, launch, seed fixtures, and ledger artifact. Refuses debug-bundle-loss resets unless explicitly acknowledged.',
-        inputSchema: mutatingSchema,
-    }, handler('prepare'));
-    server.registerTool('qa_state_verify', {
-        title: 'Verify a state profile',
-        description: "Check that a state profile's declared checks (e.g. assertVisible) hold on the CURRENT screen — USE WHEN you must confirm a precondition before testing, or re-confirm it after a run, without re-applying the profile. A failed check is a setup/state blocker (failureCode STATE_*), NOT an app test failure — do not report it as an app bug. Preconditions: a session with an attached device, and a .swipium/state/*.yaml profile (by name, path, or inline YAML). Read-only, no consent needed. Returns { action, profile, ledger, ledgerUri, ok } — the ledger lists each check's outcome.",
-        inputSchema: schema,
-    }, handler('verify'));
-    server.registerTool('qa_state_teardown', {
-        title: 'Teardown a state profile',
-        description: "Run a state profile's declared teardown steps (e.g. restore networkOnline, fixture cleanup) and write a transaction ledger artifact. USE WHEN a run that used qa_state_prepare (or otherwise mutated declared state) is finished and the device/app must be left clean. Preconditions: a session with an attached device and the same profile that was prepared. Mutating → consent-gated (returns a consent request first; re-call with consentId + approve:true). Returns { action, profile, ledger, ledgerUri, ok }; ok:false carries a failureCode when a step was refused or blocked.",
-        inputSchema: mutatingSchema,
-    }, handler('teardown'));
-}
-//# sourceMappingURL=state.js.map

package/dist/tools/state.js.map

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

package/dist/tools/visualText.js

@@ -1,106 +0,0 @@
-import { z } from 'zod';
-import { qaError, qaOk } from '../lib/result.js';
-import { requireConsent, consumeConsent } from '../consent/consent.js';
-import { sensitiveRefusal } from '../lib/sensitive.js';
-import { makeRedactor } from '../lib/redact.js';
-import { displayArgv } from '../lib/commandTemplate.js';
-import { GitScopeForbiddenError } from '../lib/spawn.js';
-import { boundedText, resolveMaskProvider, resolveVisualProvider } from '../visual/provider.js';
-import { getDriver } from '../session/attach.js';
-import { configuredOcrCommand, findOcrRegion, runOcr } from '../visual/ocr.js';
-export function registerVisualText(server, sessions) {
-    server.registerTool('qa_visual_find_text', {
-        title: 'Find visible text with OCR',
-        description: 'Find visible text in a screenshot using a configured OCR provider that returns structured regions. Returns screenshot-pixel bbox, coordinate-space metadata, and tappable device coordinates. Consent-gated because the screenshot is passed to the local OCR command.',
-        inputSchema: {
-            sessionId: z.string(),
-            query: z.string(),
-            minConfidence: z.number().optional(),
-            consentId: z.string().optional(),
-            approve: z.boolean().optional(),
-        },
-    }, async ({ sessionId, query, minConfidence, consentId, approve }) => {
-        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: ['Prepare a target first.'],
-            });
-        if (session.sensitive)
-            return sensitiveRefusal('OCR visual text search');
-        const command = configuredOcrCommand(session.root);
-        if (!command)
-            return qaError({
-                what: 'OCR is not configured',
-                changedState: false,
-                retrySafe: false,
-                failureCode: 'VISUAL_ONLY_SCREEN',
-                nextSteps: [
-                    'Set ocrCommand in .swipium/config.json as an argv array or SWIPIUM_OCR_CMD. The command should emit JSON regions with text/confidence/bbox.',
-                ],
-            });
-        let preview;
-        let maskPreview;
-        try {
-            preview = resolveVisualProvider(command, { image: '<screenshot>' }, 30000);
-            maskPreview = resolveMaskProvider(session.root);
-        }
-        catch (e) {
-            return qaError({
-                what: e instanceof GitScopeForbiddenError ? e.message : `Invalid OCR command template: ${String(e)}`,
-                changedState: false,
-                retrySafe: !(e instanceof GitScopeForbiddenError),
-                failureCode: e instanceof GitScopeForbiddenError ? 'GIT_SCOPE_FORBIDDEN' : 'INVALID_FLOW',
-                nextSteps: e instanceof GitScopeForbiddenError
-                    ? ['Run Git yourself outside Swipium; configure ocrCommand to use a non-Git executable.']
-                    : ['Use an argv array in .swipium/config.json, e.g. ["node","ocr.js","{image}"].'],
-            });
-        }
-        const maskConfigured = !!maskPreview;
-        const gate = consumeConsent(consentId, approve, {
-            action: 'ocr_run',
-            affects: { argv: preview.argv, io: preview.io, query, maskConfigured },
-        });
-        if (!gate.approved) {
-            return requireConsent({
-                action: 'ocr_run',
-                risk: 'medium',
-                exactCommand: displayArgv(preview.argv),
-                affects: { argv: preview.argv, io: preview.io, query, maskConfigured },
-                explain: `Run the configured OCR command on the current screenshot to find "${query}"? If visualMaskCommand is configured, Swipium runs it first and sends the masked image.`,
-            });
-        }
-        const ocr = await runOcr(driver, session.root, command);
-        const hit = findOcrRegion(ocr, query, minConfidence ?? 0.8);
-        if (!hit) {
-            const bounded = boundedText(ocr.text, makeRedactor(session.secrets), 8000);
-            return qaOk({
-                found: false,
-                query,
-                text: bounded.text,
-                truncated: bounded.truncated,
-                regions: ocr.regions,
-                coordinateSpace: ocr.coordinateSpace,
-                provider: ocr.provider,
-                masking: ocr.masking,
-                evidenceKind: 'ocr_text',
-            }, `OCR did not find "${query}" at confidence >= ${minConfidence ?? 0.8}.`);
-        }
-        return qaOk({
-            found: true,
-            query,
-            region: hit.region,
-            devicePoint: hit.devicePoint,
-            coordinateSpace: ocr.coordinateSpace,
-            method: 'ocr',
-            locatorStrategy: 'ocr_text',
-            evidenceKind: 'ocr_text',
-            provider: ocr.provider,
-            masking: ocr.masking,
-        }, `found "${hit.region.text}" (${hit.region.confidence}) → tap device (${hit.devicePoint.x}, ${hit.devicePoint.y})`);
-    });
-}
-//# sourceMappingURL=visualText.js.map

package/dist/tools/visualText.js.map

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