swipium 1.4.0 → 2.0.0

package/dist/tools/capabilities.js

@@ -1,209 +0,0 @@
-import { z } from 'zod';
-import { qaOk } from '../lib/result.js';
-import { SWIPIUM_VERSION, TOOL_COUNT } from '../version.js';
-export const CAPABILITY_GROUPS = [
-    {
-        group: 'start',
-        purpose: 'Start a simulator QA run and recover from blockers.',
-        tools: [
-            { name: 'qa_agent_brief', summary: 'Brief for agent orchestration: first call, polling, report fetch, and blocker rules.' },
-            { name: 'qa_capabilities', summary: 'Grouped overview of the public tool surface.' },
-            { name: 'qa_test_this', summary: 'Autopilot for "test it": resolve, prepare, smoke, explore, report, and optional suite output.' },
-            { name: 'qa_job_status', summary: 'Poll long-running jobs started by macro tools.' },
-            { name: 'qa_job_cancel', summary: 'Cancel a running job; aborts spawned children.' },
-            { name: 'qa_status', summary: 'Compact session status and current next action.' },
-            { name: 'qa_explain_blocker', summary: 'Explain a typed blocker and the owner of the fix.' },
-            { name: 'qa_continue_from_blocker', summary: 'Resume after user input, with secret redaction.' },
-            { name: 'qa_next_best_action', summary: 'Deterministic recommendation of the single best next tool to call, and why.' },
-            { name: 'qa_get_artifact', summary: 'Fetch Swipium artifact metadata or contents by URI.' },
-        ],
-    },
-    {
-        group: 'setup',
-        purpose: 'Resolve the project, create a session, and prepare Android Emulator or iOS Simulator targets.',
-        tools: [
-            { name: 'qa_doctor', summary: 'Check local toolchain readiness.' },
-            { name: 'qa_start_session', summary: 'Open a project session with budget and response mode.' },
-            { name: 'qa_detect_context', summary: 'Detect project framework, artifacts, devices, and blockers.' },
-            { name: 'qa_plan', summary: 'Propose safe workflows before acting.' },
-            { name: 'qa_prepare_target', summary: 'Prepare Android Emulator target and launch an APK.' },
-            { name: 'qa_prepare_ios_target', summary: 'Prepare iOS Simulator target and launch a simulator .app.' },
-            { name: 'qa_ios', summary: 'iOS Simulator operations: boot, install, launch, screenshot, logs, and reset.' },
-            { name: 'qa_wda', summary: 'WebDriverAgent attach/build/start for structured iOS Simulator automation.' },
-        ],
-    },
-    {
-        group: 'build',
-        purpose: 'Resolve a device and an installable artifact, or build one from source locally.',
-        tools: [
-            { name: 'qa_resolve_target', summary: 'Pick the best device/simulator (online > boot; honors platform/device).' },
-            { name: 'qa_resolve_artifact', summary: 'Find the best installable .apk/.aab/.ipa/.app and explain where it looked.' },
-            { name: 'qa_build_plan', summary: 'Propose exact build commands per framework/platform (side-effect free).' },
-            { name: 'qa_build', summary: 'Build from source (consent-gated job); captures a log and re-resolves the artifact.' },
-            { name: 'qa_bundletool', summary: 'Convert an .aab to an installable APK (universal or device-specific set).' },
-        ],
-    },
-    {
-        group: 'device',
-        purpose: 'Inspect and control the device/app environment without raw adb or simctl.',
-        tools: [
-            { name: 'qa_device_info', summary: 'Model/SDK/ABIs/locale/screen/orientation + installed apps (read-only).' },
-            { name: 'qa_permissions', summary: 'list / grant / revoke runtime permissions (revoke consent-gated).' },
-            { name: 'qa_orientation', summary: 'Set portrait / landscape / auto (logged).' },
-            { name: 'qa_geolocation', summary: 'Spoof GPS location (emulator; consent-gated) for map/location apps.' },
-            { name: 'qa_network', summary: 'airplane-mode status/offline/online/restore (consent-gated; auto-restored).' },
-            { name: 'qa_metro', summary: 'RN/Expo Metro status/start/stop/diagnose (RedBox detection + logcat).' },
-            { name: 'qa_app_control', summary: 'launch/foreground/background/force_stop/restart/clear_data/fresh_start.' },
-            { name: 'qa_screen_info', summary: 'Screen w/h/density, orientation, mode, counters, coordinate landmarks.' },
-            { name: 'qa_screen_record', summary: 'Record a screen video to an mp4 artifact (start/stop; consent-gated).' },
-        ],
-    },
-    {
-        group: 'drive',
-        purpose: 'Observe, act, and make deterministic health assertions.',
-        tools: [
-            { name: 'qa_snapshot', summary: 'Capture compact structured UI elements.' },
-            { name: 'qa_inspect', summary: 'Return the full attributes of a single @eN element from the latest snapshot.' },
-            { name: 'qa_act', summary: 'Tap, type, clear, swipe, scroll, press, open URL, or wait, then observe.' },
-            { name: 'qa_clear_overlay', summary: 'Dismiss common overlays blocking a target.' },
-            { name: 'qa_check_health', summary: 'Detect crash, ANR, error boundaries, and foreground health.' },
-            { name: 'qa_screenshot', summary: 'Capture a screenshot artifact.' },
-            { name: 'qa_note', summary: 'Record a structured QA outcome.' },
-            { name: 'qa_assert_visual', summary: 'Capture a visual assertion with evidence.' },
-            { name: 'qa_visual', summary: 'Local visual ops: baseline / diff (regression) / find_image (tappable coords) / ocr (optional).' },
-            { name: 'qa_visual_find_text', summary: 'OCR text locator with structured regions + coordinate-space conversion.' },
-            { name: 'qa_locator_suggest', summary: "Score each element's locator durability and grade automation readiness (which controls need testIDs)." },
-            { name: 'qa_input_capabilities', summary: 'Backend text-entry limits: ASCII, Unicode, clipboard, WDA typing frequency.' },
-            { name: 'qa_wait', summary: 'Non-shell wait for device_online / metro_ready / job_done.' },
-            { name: 'qa_idling_status', summary: 'Read app-declared idling hooks or label-heuristic settling before automation.' },
-        ],
-    },
-    {
-        group: 'state',
-        purpose: 'Create and verify reproducible preconditions instead of reporting them as missing.',
-        tools: [
-            { name: 'qa_seed', summary: 'Create a declared precondition via a fixture seed (deeplink/script/api; consent-gated).' },
-            { name: 'qa_state_prepare', summary: 'Prepare a reproducible state profile: reset, launch, seed, verify ledger.' },
-            { name: 'qa_state_verify', summary: 'Verify a state profile without treating setup drift as an app bug.' },
-            { name: 'qa_state_teardown', summary: 'Run state-profile teardown and restore declared environment state.' },
-        ],
-    },
-    {
-        group: 'run',
-        purpose: 'Run smoke checks, exploration, and reports.',
-        tools: [
-            { name: 'qa_smoke', summary: 'Run launch smoke and saved flows.' },
-            { name: 'qa_explore', summary: 'Guided simulator exploration with evidence and graph output.' },
-            { name: 'qa_report', summary: 'Summarize findings, blockers, evidence, and next actions.' },
-            { name: 'qa_report_compare', summary: 'Compare current report.json against a baseline report.json.' },
-            { name: 'qa_run_history', summary: 'Summarize local run history, pass rate, failures, flaky flows, and confidence calibration.' },
-        ],
-    },
-    {
-        group: 'app-map',
-        purpose: 'Maintain the app knowledge map used as Swipium project memory.',
-        tools: [
-            { name: 'qa_app_map_build', summary: 'Build or update the app map from static analysis and exploration.' },
-            { name: 'qa_app_map_read', summary: 'Read compact app map sections.' },
-            { name: 'qa_app_map_query', summary: 'Search screens, features, tests, and code links.' },
-            { name: 'qa_app_map_feature_scope', summary: 'Resolve a feature query to a focused test scope.' },
-            { name: 'qa_app_map_update', summary: 'Targeted provenance-tracked map updates: note, test cases, automation suite, environment, coverage.' },
-            { name: 'qa_app_map_diff', summary: 'Diff two app-map snapshots: screen/coverage/locator/test changes and new untested code.' },
-            { name: 'qa_app_map_validate', summary: 'Validate schema, provenance, and map links.' },
-        ],
-    },
-    {
-        group: 'feature',
-        purpose: 'Test a specific feature by name, backed by the app knowledge map.',
-        tools: [
-            { name: 'qa_feature_scope', summary: 'Map a natural-language feature to code/screens/routes/runtime/tests + objective + strategy (read-only).' },
-            { name: 'qa_feature_test_plan', summary: 'Feature test plan: scope + objective + generated cases + fixtures + automation readiness (read-only).' },
-            { name: 'qa_test_feature', summary: 'Focused feature test: scope, targeted exploration toward the feature, record cases, update the map and report.' },
-        ],
-    },
-    {
-        group: 'flows',
-        purpose: 'Create, plan, run, and repair durable simulator flows and POM suites.',
-        tools: [
-            { name: 'qa_flow_check', summary: 'Parse and statically validate a Swipium flow.' },
-            { name: 'qa_flow_plan', summary: 'Plan a flow against backend capabilities without executing it.' },
-            { name: 'qa_flow_run', summary: 'Execute a flow against a prepared simulator session.' },
-            { name: 'qa_flow_generate', summary: 'Generate a flow from recorded actions.' },
-            { name: 'qa_flow_repair', summary: 'Suggest or patch a stronger locator for a failed flow step from the current screen.' },
-            { name: 'qa_suite_generate', summary: 'Generate a POM-style suite from recorded actions.' },
-            { name: 'qa_suite_compile', summary: 'Compile a generated suite into runnable flows.' },
-            { name: 'qa_suite_lint', summary: 'Lint generated page objects for brittle/coordinate-only/dynamic locators.' },
-            { name: 'qa_pom_generate', summary: 'Generate page objects and a locator audit from recorded actions.' },
-            { name: 'qa_testcase_generate', summary: 'Generate test case documentation from recorded behavior.' },
-        ],
-    },
-    {
-        group: 'test-suite',
-        purpose: 'Grow and maintain a canonical, persistent test suite across runs (.swipium/test-suite.json).',
-        tools: [
-            { name: 'qa_test_suite_read', summary: 'Read the canonical suite: filter by functionality/status; summary/json/markdown.' },
-            { name: 'qa_test_suite_update', summary: 'Merge cases into the persistent suite (dedupe by feature+objective+steps).' },
-            { name: 'qa_test_suite_generate', summary: 'Generate or refresh canonical cases from a recorded run and exploration.' },
-            { name: 'qa_test_suite_export', summary: 'Export the persistent suite to markdown, yaml dir, json, or junit.' },
-            { name: 'qa_test_suite_lint', summary: 'Validate the suite: missing expected/actual, stale map links, duplicate ids.' },
-        ],
-    },
-    {
-        group: 'interop',
-        purpose: 'Exchange flows with the Maestro ecosystem.',
-        tools: [
-            { name: 'qa_maestro_import', summary: 'Import supported Maestro YAML commands into Swipium Flow V2.' },
-            { name: 'qa_maestro_export', summary: 'Export Swipium Flow V2 to Maestro YAML with portability grades.' },
-        ],
-    },
-    {
-        group: 'issues',
-        purpose: 'Durable issue memory and executable mobile-QA audit profiles.',
-        tools: [
-            { name: 'qa_issue_log', summary: 'List the durable project issue ledger: records, counts, recurrence, linked evidence.' },
-            { name: 'qa_issue_history', summary: 'Append-only event trail for one issue.' },
-            { name: 'qa_issue_mark_fixed', summary: 'Record a fix so future runs detect regressions via the same fingerprint.' },
-            { name: 'qa_issue_triage', summary: "Change an issue's category/severity/owner or add a note (append-only)." },
-            { name: 'qa_issue_suppress', summary: 'Suppress known noise with a reason/expiration; stays visible under known-noise.' },
-            { name: 'qa_issue_verify_fixed', summary: 'Link passing evidence to a FIXED issue so reports can claim it was verified.' },
-            { name: 'qa_issue_metrics', summary: 'Issue quality trends: opened/fixed/reopened/verified, aging, reopen rate.' },
-            { name: 'qa_mobile_audit', summary: 'Plan or execute a named mobile-QA profile (smoke / account_cycle / store_compliance / resilience / release_gate).' },
-        ],
-    },
-    {
-        group: 'first-run',
-        purpose: 'Handle login, account creation, onboarding, and paywall first-run screens safely.',
-        tools: [
-            { name: 'qa_first_run_plan', summary: 'Classify the current first-run screen and produce a safe plan.' },
-            { name: 'qa_first_run_continue', summary: 'Execute bounded first-run steps with safe generated test data when allowed.' },
-        ],
-    },
-    {
-        group: 'automation',
-        purpose: 'Generate Appium automation code from Swipium evidence on request.',
-        tools: [
-            { name: 'qa_automation_plan', summary: 'Plan generated JS/TS or Python Appium automation.' },
-            { name: 'qa_automation_generate', summary: 'Generate an Appium POM suite from recorded actions.' },
-            { name: 'qa_automation_validate', summary: 'Validate generated automation code without a device.' },
-        ],
-    },
-];
-const groupNames = CAPABILITY_GROUPS.map((g) => g.group);
-export function registerCapabilities(server, _sessions) {
-    server.registerTool('qa_capabilities', {
-        title: 'List Swipium capabilities',
-        description: 'Return the public Swipium tools grouped by purpose with short summaries.',
-        inputSchema: {
-            group: z.enum(groupNames).optional().describe('Return only this group.'),
-        },
-    }, async ({ group }) => {
-        const groups = group ? CAPABILITY_GROUPS.filter((g) => g.group === group) : CAPABILITY_GROUPS;
-        const summary = `Swipium v${SWIPIUM_VERSION}: ${TOOL_COUNT} public tools in ${CAPABILITY_GROUPS.length} groups.\n` +
-            groups
-                .map((g) => `\n[${g.group}] ${g.purpose}\n` + g.tools.map((t) => `  - ${t.name}: ${t.summary}`).join('\n'))
-                .join('\n') +
-            '\n\nStart with qa_test_this for low-context "test it" requests.';
-        return qaOk({ swipiumVersion: SWIPIUM_VERSION, totalTools: TOOL_COUNT, groups }, summary);
-    });
-}
-//# sourceMappingURL=capabilities.js.map

package/dist/tools/capabilities.js.map

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

package/dist/tools/detectContext.js

@@ -1,41 +0,0 @@
-// qa_detect_context — scan the resolved projectRoot and report what we're looking at.
-import { z } from 'zod';
-import { qaOk, qaError } from '../lib/result.js';
-import { resolveProjectRoot } from '../context/projectRoot.js';
-import { detectContext } from '../context/detect.js';
-export function registerDetectContext(server, sessions) {
-    server.registerTool('qa_detect_context', {
-        title: 'Detect project context',
-        description: 'Scan the resolved project root (a session root, an explicit projectRoot, or MCP workspace roots — never the server cwd) and report: framework (expo/bare-rn/native-android/native-ios/flutter), monorepo, prebuilt artifacts (apk/ipa/.app), online devices + AVDs, toolchain, and blockers. Use this to decide what qa_prepare_target needs.',
-        inputSchema: {
-            sessionId: z.string().optional().describe('Use this session\'s projectRoot if given.'),
-            projectRoot: z.string().optional().describe('Absolute path; else resolved via MCP roots.'),
-        },
-    }, async ({ sessionId, projectRoot }) => {
-        let root;
-        if (sessionId)
-            root = sessions.get(sessionId)?.root;
-        if (!root) {
-            const resolved = await resolveProjectRoot(server, projectRoot);
-            if (!resolved.root) {
-                return qaError({
-                    what: 'Could not resolve a project root to scan',
-                    changedState: false,
-                    retrySafe: true,
-                    nextSteps: ['Pass projectRoot="/abs/path", or call qa_start_session first.'],
-                    clientHint: resolved.hint,
-                });
-            }
-            root = resolved.root;
-        }
-        const ctx = await detectContext(root);
-        const summary = `root=${ctx.projectRoot}\n` +
-            `framework=${ctx.framework} location=${ctx.location} monorepo=${ctx.monorepo}\n` +
-            `artifacts: ${ctx.artifacts.apks.length} apk, ${ctx.artifacts.ipas.length} ipa, ${ctx.artifacts.appBundles.length} .app\n` +
-            `devices: online=[${ctx.devices.androidOnline.join(', ')}] avds=[${ctx.devices.avds.join(', ')}]\n` +
-            `toolchain: adb=${ctx.toolchain.adb} emulator=${ctx.toolchain.emulator} java=${ctx.toolchain.java} aapt2=${ctx.toolchain.aapt2} xcodebuild=${ctx.toolchain.xcodebuild}\n` +
-            (ctx.blockers.length ? `blockers:\n - ${ctx.blockers.join('\n - ')}` : 'no blockers');
-        return qaOk(ctx, summary);
-    });
-}
-//# sourceMappingURL=detectContext.js.map

package/dist/tools/detectContext.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"detectContext.js","sourceRoot":"","sources":["../../src/tools/detectContext.ts"],"names":[],"mappings":"AAAA,sFAAsF;AAEtF,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAGrD,MAAM,UAAU,qBAAqB,CAAC,MAAiB,EAAE,QAAsB;IAC7E,MAAM,CAAC,YAAY,CACjB,mBAAmB,EACnB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EACT,+UAA+U;QACjV,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,2CAA2C,CAAC;YACtF,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6CAA6C,CAAC;SAC3F;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,WAAW,EAAE,EAAE,EAAE;QACnC,IAAI,IAAwB,CAAC;QAC7B,IAAI,SAAS;YAAE,IAAI,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,EAAE,IAAI,CAAC;QACpD,IAAI,CAAC,IAAI,EAAE,CAAC;YACV,MAAM,QAAQ,GAAG,MAAM,kBAAkB,CAAC,MAAM,EAAE,WAAW,CAAC,CAAC;YAC/D,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,CAAC;gBACnB,OAAO,OAAO,CAAC;oBACb,IAAI,EAAE,0CAA0C;oBAChD,YAAY,EAAE,KAAK;oBACnB,SAAS,EAAE,IAAI;oBACf,SAAS,EAAE,CAAC,+DAA+D,CAAC;oBAC5E,UAAU,EAAE,QAAQ,CAAC,IAAI;iBAC1B,CAAC,CAAC;YACL,CAAC;YACD,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC;QACvB,CAAC;QAED,MAAM,GAAG,GAAG,MAAM,aAAa,CAAC,IAAI,CAAC,CAAC;QACtC,MAAM,OAAO,GACX,QAAQ,GAAG,CAAC,WAAW,IAAI;YAC3B,aAAa,GAAG,CAAC,SAAS,aAAa,GAAG,CAAC,QAAQ,aAAa,GAAG,CAAC,QAAQ,IAAI;YAChF,cAAc,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,SAAS,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,MAAM,SAAS,GAAG,CAAC,SAAS,CAAC,UAAU,CAAC,MAAM,SAAS;YAC1H,oBAAoB,GAAG,CAAC,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,WAAW,GAAG,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,KAAK;YACnG,kBAAkB,GAAG,CAAC,SAAS,CAAC,GAAG,aAAa,GAAG,CAAC,SAAS,CAAC,QAAQ,SAAS,GAAG,CAAC,SAAS,CAAC,IAAI,UAAU,GAAG,CAAC,SAAS,CAAC,KAAK,eAAe,GAAG,CAAC,SAAS,CAAC,UAAU,IAAI;YACzK,CAAC,GAAG,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,iBAAiB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,aAAa,CAAC,CAAC;QACxF,OAAO,IAAI,CAAC,GAAyC,EAAE,OAAO,CAAC,CAAC;IAClE,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/flowGenerate.js

@@ -1,55 +0,0 @@
-// qa_flow_generate (PHASE3-PLAN §4.1 / DESIGN §8) — turn the actions recorded during this
-// session (via qa_act) into a durable flow YAML, with a durability grade and the brittle
-// steps that need testIDs. Optionally saves it to .swipium/flows/<name>.yaml so it shows up
-// in qa_plan and can be replayed with qa_flow_run.
-import { z } from 'zod';
-import { mkdirSync, writeFileSync } from 'node:fs';
-import { join } from 'node:path';
-import { qaOk, qaError } from '../lib/result.js';
-import { generateFlow } from '../flows/generate.js';
-import { loadProjectConfig } from '../cli/scan.js';
-export function registerFlowGenerate(server, sessions) {
-    server.registerTool('qa_flow_generate', {
-        title: 'Generate a flow from this run',
-        description: 'Draft a repeatable flow YAML from the actions recorded during this session (every qa_act is recorded). Translates @ref taps into durable text selectors where possible, turns typed credentials into ${VARS}, and reports a durability grade (A/B/C) + the steps that need a testID/accessibilityLabel. Pass save:true to write it to .swipium/flows/<name>.yaml (so qa_plan lists it and qa_flow_run can replay it).',
-        inputSchema: {
-            sessionId: z.string(),
-            name: z.string().optional().describe('Flow name (default derived from the app/session).'),
-            budgetProfile: z.enum(['guardrail', 'login_smoke', 'full_smoke', 'install_smoke']).optional(),
-            save: z.boolean().optional().describe('Write to .swipium/flows/<name>.yaml (default false → returned + saved as an artifact only).'),
-        },
-    }, async ({ sessionId, name, budgetProfile, save }) => {
-        const session = sessions.get(sessionId);
-        if (!session) {
-            return qaError({ what: `Unknown sessionId ${sessionId}`, changedState: false, retrySafe: true, nextSteps: ['Call qa_start_session first.'] });
-        }
-        if (!session.recordedActions.length) {
-            return qaError({
-                what: 'No actions recorded in this session yet',
-                changedState: false,
-                retrySafe: true,
-                nextSteps: ['Drive the app with qa_act first (each action is recorded), then qa_flow_generate.'],
-            });
-        }
-        const appId = session.appId ?? (loadProjectConfig(session.root)?.appId ?? undefined);
-        const flowName = (name ?? `${(appId ?? 'app').split('.').pop()}-smoke`).replace(/[^\w.-]+/g, '-');
-        const gen = generateFlow(session.recordedActions, { name: flowName, appId, budgetProfile });
-        // Always keep a copy as an artifact; optionally write into the project's flows dir.
-        const artifactUri = sessions.saveArtifact(session, 'flow', `${flowName}.yaml`, gen.yaml, 'text/yaml', `generated flow (durability ${gen.durability.grade})`);
-        let savedTo;
-        if (save) {
-            const dir = join(session.root, '.swipium', 'flows');
-            mkdirSync(dir, { recursive: true });
-            savedTo = join(dir, `${flowName}.yaml`);
-            writeFileSync(savedTo, gen.yaml);
-        }
-        const summary = `Generated flow "${flowName}" — durability ${gen.durability.grade} (${gen.durability.semanticPct}% semantic; ` +
-            `${gen.durability.coordinate} coordinate, ${gen.durability.needsHumanData} needs-human-data), ${gen.stepCount} steps.` +
-            (gen.variables.length ? `\nvariables: ${gen.variables.join(', ')} (provide via qa_flow_run { variables }).` : '') +
-            (gen.brittleSteps.length ? `\n⚠ brittle steps:\n - ${gen.brittleSteps.map((b) => `step ${b.index}: ${b.reason}`).join('\n - ')}` : '') +
-            (savedTo ? `\nsaved: ${savedTo}` : `\n(not saved to disk — pass save:true to write it under .swipium/flows)`) +
-            `\n\n${gen.yaml}`;
-        return qaOk({ name: flowName, appId: appId ?? null, durability: gen.durability, brittleSteps: gen.brittleSteps, variables: gen.variables, stepCount: gen.stepCount, artifactUri, savedTo: savedTo ?? null, yaml: gen.yaml }, summary);
-    });
-}
-//# sourceMappingURL=flowGenerate.js.map

package/dist/tools/flowGenerate.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"flowGenerate.js","sourceRoot":"","sources":["../../src/tools/flowGenerate.ts"],"names":[],"mappings":"AAAA,0FAA0F;AAC1F,yFAAyF;AACzF,4FAA4F;AAC5F,mDAAmD;AAEnD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,SAAS,CAAC;AACnD,OAAO,EAAE,IAAI,EAAE,MAAM,WAAW,CAAC;AAEjC,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,sBAAsB,CAAC;AACpD,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AAGnD,MAAM,UAAU,oBAAoB,CAAC,MAAiB,EAAE,QAAsB;IAC5E,MAAM,CAAC,YAAY,CACjB,kBAAkB,EAClB;QACE,KAAK,EAAE,+BAA+B;QACtC,WAAW,EACT,uZAAuZ;QACzZ,WAAW,EAAE;YACX,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE;YACrB,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,mDAAmD,CAAC;YACzF,aAAa,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,WAAW,EAAE,aAAa,EAAE,YAAY,EAAE,eAAe,CAAC,CAAC,CAAC,QAAQ,EAAE;YAC7F,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,CAAC,6FAA6F,CAAC;SACrI;KACF,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,aAAa,EAAE,IAAI,EAAE,EAAE,EAAE;QACjD,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,IAAI,CAAC,OAAO,CAAC,eAAe,CAAC,MAAM,EAAE,CAAC;YACpC,OAAO,OAAO,CAAC;gBACb,IAAI,EAAE,yCAAyC;gBAC/C,YAAY,EAAE,KAAK;gBACnB,SAAS,EAAE,IAAI;gBACf,SAAS,EAAE,CAAC,mFAAmF,CAAC;aACjG,CAAC,CAAC;QACL,CAAC;QAED,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,CAAE,iBAAiB,CAAC,OAAO,CAAC,IAAI,CAAC,EAAE,KAA4B,IAAI,SAAS,CAAC,CAAC;QAC7G,MAAM,QAAQ,GAAG,CAAC,IAAI,IAAI,GAAG,CAAC,KAAK,IAAI,KAAK,CAAC,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC,OAAO,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC;QAClG,MAAM,GAAG,GAAG,YAAY,CAAC,OAAO,CAAC,eAAe,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,aAAa,EAAE,CAAC,CAAC;QAE5F,oFAAoF;QACpF,MAAM,WAAW,GAAG,QAAQ,CAAC,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG,QAAQ,OAAO,EAAE,GAAG,CAAC,IAAI,EAAE,WAAW,EAAE,8BAA8B,GAAG,CAAC,UAAU,CAAC,KAAK,GAAG,CAAC,CAAC;QAC7J,IAAI,OAA2B,CAAC;QAChC,IAAI,IAAI,EAAE,CAAC;YACT,MAAM,GAAG,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,CAAC;YACpD,SAAS,CAAC,GAAG,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;YACpC,OAAO,GAAG,IAAI,CAAC,GAAG,EAAE,GAAG,QAAQ,OAAO,CAAC,CAAC;YACxC,aAAa,CAAC,OAAO,EAAE,GAAG,CAAC,IAAI,CAAC,CAAC;QACnC,CAAC;QAED,MAAM,OAAO,GACX,mBAAmB,QAAQ,kBAAkB,GAAG,CAAC,UAAU,CAAC,KAAK,KAAK,GAAG,CAAC,UAAU,CAAC,WAAW,cAAc;YAC9G,GAAG,GAAG,CAAC,UAAU,CAAC,UAAU,gBAAgB,GAAG,CAAC,UAAU,CAAC,cAAc,uBAAuB,GAAG,CAAC,SAAS,SAAS;YACtH,CAAC,GAAG,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,CAAC,gBAAgB,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,2CAA2C,CAAC,CAAC,CAAC,EAAE,CAAC;YACjH,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,CAAC,CAAC,CAAC,0BAA0B,GAAG,CAAC,YAAY,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,QAAQ,CAAC,CAAC,KAAK,KAAK,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,IAAI,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtI,CAAC,OAAO,CAAC,CAAC,CAAC,YAAY,OAAO,EAAE,CAAC,CAAC,CAAC,yEAAyE,CAAC;YAC7G,OAAO,GAAG,CAAC,IAAI,EAAE,CAAC;QAEpB,OAAO,IAAI,CACT,EAAE,IAAI,EAAE,QAAQ,EAAE,KAAK,EAAE,KAAK,IAAI,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,UAAU,EAAE,YAAY,EAAE,GAAG,CAAC,YAAY,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,SAAS,EAAE,GAAG,CAAC,SAAS,EAAE,WAAW,EAAE,OAAO,EAAE,OAAO,IAAI,IAAI,EAAE,IAAI,EAAE,GAAG,CAAC,IAAI,EAAE,EAC/M,OAAO,CACR,CAAC;IACJ,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/tools/history.js

@@ -1,56 +0,0 @@
-import { z } from 'zod';
-import { qaError, qaOk } from '../lib/result.js';
-import { compareReports, trendForRoot } from '../report/history.js';
-export function registerHistory(server, sessions) {
-    server.registerTool('qa_report_compare', {
-        title: 'Compare Swipium reports',
-        description: 'Compare a current Swipium report.json against a baseline report.json. Reports new failures, fixed failures, changed screenshots, outcome changes, runtime regression, and optional flake status from local trend history.',
-        inputSchema: {
-            current: z.string().describe('Path to current report.json.'),
-            baseline: z.string().describe('Path to baseline report.json.'),
-            trendRoot: z.string().optional().describe('Optional project root containing .swipium/runs or legacy .swipium/ci history for known-flaky classification.'),
-        },
-    }, async ({ current, baseline, trendRoot }) => {
-        try {
-            const cmp = compareReports(current, baseline, { trendRoot });
-            return qaOk(cmp, cmp.summary);
-        }
-        catch (e) {
-            return qaError({ what: `Could not compare reports: ${String(e.message ?? e)}`, changedState: false, retrySafe: true, nextSteps: ['Pass readable Swipium report.json files for current and baseline.'] });
-        }
-    });
-    server.registerTool('qa_run_history', {
-        title: 'Summarize Swipium run history',
-        description: 'Read local .swipium/runs/**/report.json files (and legacy .swipium/ci/**) and summarize pass rate, median runtime, top failures, environment failures, flaky flows, confidence calibration, and slowest runs.',
-        inputSchema: {
-            sessionId: z.string().optional(),
-            projectRoot: z.string().optional().describe('Project root. Defaults to the session root when sessionId is provided.'),
-        },
-    }, async ({ sessionId, projectRoot }) => {
-        const session = sessionId ? sessions.get(sessionId) : undefined;
-        if (sessionId && !session)
-            return qaError({ what: `Unknown sessionId ${sessionId}`, changedState: false, retrySafe: true, nextSteps: ['Call qa_start_session first, or pass projectRoot.'] });
-        const root = projectRoot ?? session?.root;
-        if (!root)
-            return qaError({ what: 'qa_run_history needs projectRoot or sessionId', changedState: false, retrySafe: true, nextSteps: ['Pass projectRoot, or call qa_start_session first.'] });
-        try {
-            const trend = trendForRoot(root);
-            const calibration = trend.confidenceCalibration;
-            const blockers = trend.releaseGateSignals.filter((s) => s.level === 'block').reduce((sum, s) => sum + s.count, 0);
-            const warnings = trend.releaseGateSignals.filter((s) => s.level === 'warn').reduce((sum, s) => sum + s.count, 0);
-            const locatorTrend = trend.locatorReadinessTrend;
-            const summary = `history: ${trend.reports} report(s), median ${trend.medianRuntimeSec ?? 'n/a'}s\n` +
-                `timing: avg setup ${trend.averageSetupSec ?? 'n/a'}s, avg active ${trend.averageActiveSec ?? 'n/a'}s\n` +
-                (locatorTrend.runsWithReadiness ? `locator readiness: latest durable ${locatorTrend.latestDurablePct ?? 'n/a'}%, average ${locatorTrend.averageDurablePct ?? 'n/a'}%\n` : '') +
-                Object.entries(trend.passRate).map(([flow, rate]) => `  ${flow}: ${(rate * 100).toFixed(1)}% pass`).join('\n') +
-                `\nrelease gate signals: ${blockers} block, ${warnings} warn` +
-                `\ncalibration: ${calibration.status} (${calibration.confidenceSamples}/${calibration.probabilisticEvidence} confidence sample(s), ${calibration.outcomeSamples} outcome sample(s))` +
-                (trend.slowestSteps.length ? `\nslowest step: ${trend.slowestSteps[0].workflow}#${trend.slowestSteps[0].index} ${trend.slowestSteps[0].kind} ${trend.slowestSteps[0].durationSec}s` : '');
-            return qaOk({ root, ...trend }, summary);
-        }
-        catch (e) {
-            return qaError({ what: `Could not read run history: ${String(e.message ?? e)}`, changedState: false, retrySafe: true, nextSteps: ['Confirm .swipium/runs or .swipium/ci contains report.json files.'] });
-        }
-    });
-}
-//# sourceMappingURL=history.js.map

package/dist/tools/history.js.map

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

package/dist/tools/idling.js

@@ -1,104 +0,0 @@
-import { request as httpRequest } from 'node:http';
-import { request as httpsRequest } from 'node:https';
-import { URL } from 'node:url';
-import { z } from 'zod';
-import { qaError, qaOk } from '../lib/result.js';
-import { getDriver } from '../session/attach.js';
-import { settle } from '../snapshot/settle.js';
-export function isLoopbackUrl(raw) {
-    try {
-        const u = new URL(raw);
-        return (u.protocol === 'http:' || u.protocol === 'https:') && ['localhost', '127.0.0.1', '::1', '[::1]'].includes(u.hostname);
-    }
-    catch {
-        return false;
-    }
-}
-export function parseIdlingPayload(text) {
-    const trimmed = text.trim();
-    if (!trimmed)
-        return { idle: false, detail: 'empty idling response' };
-    try {
-        const parsed = JSON.parse(trimmed);
-        if (typeof parsed === 'boolean')
-            return { idle: parsed, detail: parsed ? 'idle:true' : 'idle:false', raw: parsed };
-        if (parsed && typeof parsed === 'object') {
-            const o = parsed;
-            const value = o.idle ?? o.isIdleNow ?? (typeof o.busy === 'boolean' ? !o.busy : undefined);
-            if (typeof value === 'boolean') {
-                return { idle: value, detail: String(o.reason ?? o.status ?? (value ? 'app declared idle' : 'app declared busy')), raw: parsed };
-            }
-            if (typeof o.status === 'string') {
-                const idle = /idle|ready|settled/i.test(o.status);
-                return { idle, detail: o.status, raw: parsed };
-            }
-        }
-    }
-    catch {
-        /* fall through to text parser */
-    }
-    return { idle: /^(idle|ready|settled|true|ok)$/i.test(trimmed), detail: trimmed };
-}
-function fetchLoopback(raw, timeoutMs) {
-    return new Promise((resolve, reject) => {
-        const url = new URL(raw);
-        const req = (url.protocol === 'https:' ? httpsRequest : httpRequest)(url, { method: 'GET', timeout: timeoutMs }, (res) => {
-            const chunks = [];
-            res.on('data', (c) => chunks.push(c));
-            res.on('end', () => resolve(Buffer.concat(chunks).toString('utf8')));
-        });
-        req.on('timeout', () => {
-            req.destroy(new Error(`idling hook timed out after ${timeoutMs}ms`));
-        });
-        req.on('error', reject);
-        req.end();
-    });
-}
-export function registerIdling(server, sessions) {
-    server.registerTool('qa_idling_status', {
-        title: 'Read app idling status',
-        description: 'Report whether the app is idle before automation. With hookUrl, reads an app-declared loopback idling endpoint (Gradle/RN/Flutter test hook). Without hookUrl, uses Swipium heuristic settling and labels it as heuristic evidence.',
-        inputSchema: {
-            sessionId: z.string(),
-            hookUrl: z.string().optional().describe('Optional loopback-only URL returning { idle: boolean } / { isIdleNow: boolean } / text "idle".'),
-            timeoutMs: z.number().optional().describe('Default 3000 for hookUrl, 8000 for heuristic settling.'),
-        },
-    }, async ({ sessionId, hookUrl, timeoutMs }) => {
-        const session = sessions.get(sessionId);
-        if (!session)
-            return qaError({ what: `Unknown sessionId ${sessionId}`, changedState: false, retrySafe: true, nextSteps: ['Call qa_start_session first.'] });
-        if (hookUrl) {
-            if (!isLoopbackUrl(hookUrl)) {
-                return qaError({
-                    what: 'idling hook URLs must be loopback-only',
-                    changedState: false,
-                    retrySafe: false,
-                    failureCode: 'UNSAFE_ACTION_REFUSED',
-                    nextSteps: ['Expose the app test hook on localhost/127.0.0.1 and retry.'],
-                });
-            }
-            try {
-                const body = await fetchLoopback(hookUrl, timeoutMs ?? 3000);
-                const parsed = parseIdlingPayload(body);
-                sessions.addWorkaround(session, `idling: app-declared hook ${hookUrl}`);
-                return qaOk({ source: 'app_declared', hookUrl, idle: parsed.idle, detail: parsed.detail, raw: parsed.raw ?? body }, `idling app_declared: ${parsed.idle ? 'idle' : 'busy'} (${parsed.detail})`);
-            }
-            catch (e) {
-                return qaError({
-                    what: `Could not read idling hook: ${String(e)}`,
-                    changedState: false,
-                    retrySafe: true,
-                    failureCode: 'UI_IDLE_TIMEOUT',
-                    nextSteps: ['Confirm the local idling hook is running and returns JSON/text within the timeout.'],
-                });
-            }
-        }
-        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 or pass hookUrl for an app-declared hook.'] });
-        const result = await settle(driver, { timeoutMs: timeoutMs ?? 8000 });
-        sessions.addWorkaround(session, 'idling: heuristic settle used (no app-declared hook)');
-        return qaOk({ source: 'heuristic', idle: result.settled, timeoutMs: timeoutMs ?? 8000 }, `idling heuristic: ${result.settled ? 'idle' : 'not idle before timeout'}`);
-    });
-}
-//# sourceMappingURL=idling.js.map

package/dist/tools/idling.js.map

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

package/dist/tools/inputCapabilities.js

@@ -1,30 +0,0 @@
-import { z } from 'zod';
-import { qaError, qaOk } from '../lib/result.js';
-import { getDriver } from '../session/attach.js';
-import { loadWdaConfig } from '../lib/wdaConfig.js';
-export function registerInputCapabilities(server, sessions) {
-    server.registerTool('qa_input_capabilities', {
-        title: 'Text input capabilities',
-        description: 'Report backend text-entry constraints: ASCII safety, Unicode support, clipboard/paste availability, and WDA typing-frequency tuning. Use before generating fixture-backed form flows.',
-        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: ['Prepare a target first.'] });
-        const wda = driver.kind === 'wda' ? loadWdaConfig(session.root) : null;
-        const caps = {
-            backend: driver.kind,
-            asciiSafe: true,
-            unicodeSupport: driver.kind === 'direct' ? 'limited_android_adb_text' : driver.kind === 'wda' ? 'wda_type_text' : driver.kind === 'remote' ? 'appium_driver_dependent' : 'limited',
-            pasteClipboardAvailable: false,
-            maxTypingFrequency: typeof wda?.settings.maxTypingFrequency === 'number' ? wda.settings.maxTypingFrequency : null,
-            unsupportedFailureCode: 'TEXT_INPUT_UNSUPPORTED',
-            policy: driver.kind === 'direct'
-                ? 'Prefer ASCII fixture values on Android DirectDriver; use declared generators that emit ASCII or a backend with Unicode-safe text entry.'
-                : 'Fixture text entry is supported, but keep secrets in variables and tune WDA/Appium settings if typing flakes.',
-        };
-        return qaOk(caps, `input capabilities: ${driver.kind}; unicode=${caps.unicodeSupport}; clipboard=${caps.pasteClipboardAvailable}`);
-    });
-}
-//# sourceMappingURL=inputCapabilities.js.map

package/dist/tools/inputCapabilities.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"inputCapabilities.js","sourceRoot":"","sources":["../../src/tools/inputCapabilities.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAGpD,MAAM,UAAU,yBAAyB,CAAC,MAAiB,EAAE,QAAsB;IACjF,MAAM,CAAC,YAAY,CACjB,uBAAuB,EACvB;QACE,KAAK,EAAE,yBAAyB;QAChC,WAAW,EAAE,uLAAuL;QACpM,WAAW,EAAE,EAAE,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE;KACvC,EACD,KAAK,EAAE,EAAE,SAAS,EAAE,EAAE,EAAE;QACtB,MAAM,OAAO,GAAG,QAAQ,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QACxC,MAAM,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,CAAC,CAAC,MAAM,SAAS,CAAC,OAAO,CAAC,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,CAAC;QAC9E,IAAI,CAAC,OAAO,IAAI,CAAC,MAAM;YAAE,OAAO,OAAO,CAAC,EAAE,IAAI,EAAE,oCAAoC,EAAE,YAAY,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,SAAS,EAAE,CAAC,yBAAyB,CAAC,EAAE,CAAC,CAAC;QACtK,MAAM,GAAG,GAAG,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,aAAa,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;QACvE,MAAM,IAAI,GAAG;YACX,OAAO,EAAE,MAAM,CAAC,IAAI;YACpB,SAAS,EAAE,IAAI;YACf,cAAc,EAAE,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,0BAA0B,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,KAAK,CAAC,CAAC,CAAC,eAAe,CAAC,CAAC,CAAC,MAAM,CAAC,IAAI,KAAK,QAAQ,CAAC,CAAC,CAAC,yBAAyB,CAAC,CAAC,CAAC,SAAS;YAClL,uBAAuB,EAAE,KAAK;YAC9B,kBAAkB,EAAE,OAAO,GAAG,EAAE,QAAQ,CAAC,kBAAkB,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,kBAAkB,CAAC,CAAC,CAAC,IAAI;YACjH,sBAAsB,EAAE,wBAAwB;YAChD,MAAM,EAAE,MAAM,CAAC,IAAI,KAAK,QAAQ;gBAC9B,CAAC,CAAC,yIAAyI;gBAC3I,CAAC,CAAC,+GAA+G;SACpH,CAAC;QACF,OAAO,IAAI,CAAC,IAAI,EAAE,uBAAuB,MAAM,CAAC,IAAI,aAAa,IAAI,CAAC,cAAc,eAAe,IAAI,CAAC,uBAAuB,EAAE,CAAC,CAAC;IACrI,CAAC,CACF,CAAC;AACJ,CAAC"}