swipium 1.0.0

package/dist/session/store.js

@@ -0,0 +1,329 @@
+// Session + job + artifact store with DISK PERSISTENCE (DESIGN §3, M6).
+// Live, non-serializable bits (driver, lastSnapshot, abort controllers) stay in memory;
+// a serializable subset is written to <sessionDir>/state.json on every mutation, and a
+// small registry under ~/.swipium/registry.json lets a fresh server instance reload
+// prior sessions so artifacts/reports/job-status survive a server restart. (A restart does
+// NOT resurrect a running child process — such jobs are marked failed on reload.)
+import { createHash, randomUUID } from 'node:crypto';
+import { mkdirSync, writeFileSync, readFileSync, existsSync } from 'node:fs';
+import { join, resolve } from 'node:path';
+import { homedir } from 'node:os';
+import { DEFAULT_RESPONSE_MODE } from '../lib/result.js';
+import { makeRedactor } from '../lib/redact.js';
+// Phase 2.2 P1.6: budget classes (minutes) keyed by workflow ambition.
+export const BUDGET_PROFILES = {
+    guardrail: 8, // guardrail/setup validation
+    login_smoke: 10, // login + one workflow
+    full_smoke: 15, // full authenticated smoke
+    install_smoke: 20, // install/boot/rebuild involved
+};
+// Security model (REQ-02): raw secret values (generated passwords/OTPs/tokens) must never touch
+// disk. In memory we keep the raw value (for same-session reuse via inputValues), but the
+// serialized form sent to state.json redacts secret values while preserving all reproducibility
+// metadata (varName/field/generator/secret/artifactUri/timestamps). Non-secret generated values
+// (e.g. a yopmail email) stay intact for evidence.
+export function serializeGeneratedValues(records) {
+    return records.map((r) => (r.secret ? { ...r, value: '<redacted>' } : r));
+}
+export const DEFAULT_BUDGET = {
+    maxMinutes: 8,
+    maxActions: 20,
+    maxScreenshots: 8,
+    maxSnapshotFailures: 3,
+    maxNoChangeActions: 3,
+};
+const REGISTRY_DIR = join(homedir(), '.swipium');
+const REGISTRY = join(REGISTRY_DIR, 'registry.json');
+const TEXT_MIME_RE = /^(text\/[^;]+|application\/(json|xml|yaml|x-yaml|javascript|x-ndjson)|[^;]+\+(json|xml|yaml))(?:$|;)/i;
+export function isTextArtifactMime(mime) {
+    return TEXT_MIME_RE.test(mime);
+}
+export function artifactDirectoryName(kind) {
+    switch (kind) {
+        case 'screenshot': return 'screenshots';
+        case 'recording': return 'videos';
+        case 'logs':
+        case 'logcat':
+        case 'metro':
+        case 'wda':
+            return 'logs';
+        default:
+            return kind;
+    }
+}
+function defaultSessionDir(root, id) {
+    const projectHash = createHash('sha256').update(resolve(root)).digest('hex').slice(0, 16);
+    return join(REGISTRY_DIR, 'runs', projectHash, id);
+}
+export class SessionStore {
+    sessions = new Map();
+    constructor() {
+        this.loadRegistry();
+    }
+    create(root, budget, opts) {
+        const id = randomUUID().slice(0, 8);
+        const dir = opts?.sessionDir ?? defaultSessionDir(root, id);
+        mkdirSync(dir, { recursive: true });
+        const now = Date.now();
+        const s = {
+            id, root, dir, createdAt: now, screenshotCount: 0,
+            mode: 'structured',
+            responseMode: opts?.responseMode ?? DEFAULT_RESPONSE_MODE,
+            sensitive: opts?.sensitive ?? false,
+            budget: { ...DEFAULT_BUDGET, ...(budget ?? {}) },
+            counters: { actions: 0, screenshots: 0, snapshotFailures: 0, noChangeActions: 0 },
+            envChanges: [], workarounds: [],
+            jobs: new Map(), artifacts: [], findings: [], notes: [], mutations: [], recordedActions: [],
+            fixtures: opts?.fixtures ?? [], auth: {}, milestones: { session_start: now }, budgetProfile: opts?.budgetProfile,
+            secrets: new Set(), inputs: [], generatedValues: [], inputValues: new Map(), aborts: new Map(),
+        };
+        this.sessions.set(id, s);
+        this.appendRegistry(id, dir);
+        this.persist(s);
+        return s;
+    }
+    get(id) {
+        return this.sessions.get(id);
+    }
+    list() {
+        return [...this.sessions.values()];
+    }
+    persist(s) {
+        try {
+            const state = {
+                id: s.id, root: s.root, dir: s.dir, createdAt: s.createdAt,
+                device: s.device, appId: s.appId, headless: s.headless, metroPid: s.metroPid, screenshotCount: s.screenshotCount,
+                network: s.network, envChanges: s.envChanges, workarounds: s.workarounds,
+                mode: s.mode, responseMode: s.responseMode, sensitive: s.sensitive, budget: s.budget, counters: s.counters,
+                jobs: [...s.jobs.values()], artifacts: s.artifacts, findings: s.findings, notes: s.notes, mutations: s.mutations, recordedActions: s.recordedActions,
+                fixtures: s.fixtures, auth: s.auth, milestones: s.milestones, budgetProfile: s.budgetProfile,
+                inputs: s.inputs, // METADATA only — never the values
+                generatedValues: serializeGeneratedValues(s.generatedValues), // secret raw values redacted before disk
+                exploration: s.exploration,
+            };
+            writeFileSync(join(s.dir, 'state.json'), JSON.stringify(state, null, 2));
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+    // ---- jobs ----
+    createJob(s, kind) {
+        const job = { jobId: randomUUID().slice(0, 8), kind, status: 'running', startedAt: Date.now(), artifactUris: [] };
+        s.jobs.set(job.jobId, job);
+        s.aborts.set(job.jobId, new AbortController());
+        this.persist(s);
+        return job;
+    }
+    abortSignal(s, jobId) {
+        return s.aborts.get(jobId)?.signal;
+    }
+    // ---- mode + budget + counters (Phase 1) ----
+    setMode(s, mode) {
+        s.mode = mode;
+        this.persist(s);
+    }
+    bump(s, key, by = 1) {
+        s.counters[key] += by;
+        this.persist(s);
+    }
+    /** Returns a stop reason if any budget is exhausted, else null. */
+    budgetStop(s) {
+        const c = s.counters;
+        const b = s.budget;
+        const mins = (Date.now() - s.createdAt) / 60000;
+        if (mins >= b.maxMinutes)
+            return `time budget reached (${mins.toFixed(1)}/${b.maxMinutes} min)`;
+        if (c.actions >= b.maxActions)
+            return `action budget reached (${c.actions}/${b.maxActions})`;
+        if (c.screenshots >= b.maxScreenshots)
+            return `screenshot budget reached (${c.screenshots}/${b.maxScreenshots})`;
+        if (c.noChangeActions >= b.maxNoChangeActions)
+            return `repeated no-change actions (${c.noChangeActions}/${b.maxNoChangeActions}) — likely wrong coords / disabled element / auth wall`;
+        return null;
+    }
+    updateJob(s, job, patch) {
+        Object.assign(job, patch);
+        this.persist(s);
+    }
+    /** Apply a patch ONLY while the job is still running — so a cancelled (or otherwise
+     *  terminal) job is never overwritten back to done/failed by a racing worker. */
+    updateJobIfRunning(s, job, patch) {
+        const cur = s.jobs.get(job.jobId);
+        if (!cur || cur.status !== 'running')
+            return false;
+        Object.assign(cur, patch);
+        this.persist(s);
+        return true;
+    }
+    cancelJob(s, jobId) {
+        const j = s.jobs.get(jobId);
+        if (!j || j.status !== 'running')
+            return false;
+        s.aborts.get(jobId)?.abort();
+        j.status = 'cancelled';
+        j.endedAt = Date.now();
+        this.persist(s);
+        return true;
+    }
+    // ---- findings + artifacts ----
+    addFinding(s, f) {
+        s.findings.push(f);
+        this.persist(s);
+    }
+    addEnvChange(s, note) {
+        s.envChanges.push(`${new Date().toISOString()} ${note}`);
+        this.persist(s);
+    }
+    /** Record a safe fallback Swipium chose (roadmap §11 "workarounds attempted"). De-duped. */
+    addWorkaround(s, note) {
+        if (!s.workarounds.includes(note)) {
+            s.workarounds.push(note);
+            this.persist(s);
+        }
+    }
+    addNote(s, note) {
+        s.notes.push(note);
+        this.persist(s);
+    }
+    recordMutation(s, mutation) {
+        const rec = { id: randomUUID().slice(0, 8), at: Date.now(), ...mutation };
+        s.mutations.push(rec);
+        if (s.mutations.length > 500)
+            s.mutations.splice(0, s.mutations.length - 500);
+        this.persist(s);
+        return rec;
+    }
+    /** Append an action-IR step (bounded) for qa_flow_generate. */
+    addRecordedAction(s, ra) {
+        s.recordedActions.push(ra);
+        if (s.recordedActions.length > 300)
+            s.recordedActions.splice(0, s.recordedActions.length - 300);
+        this.persist(s);
+    }
+    /** Record a phase-timing marker the first time it happens (Phase 2.2 P1.6). */
+    milestone(s, key) {
+        if (s.milestones[key] == null) {
+            s.milestones[key] = Date.now();
+            this.persist(s);
+        }
+    }
+    /** Add an accumulated duration marker in milliseconds for report timing diagnostics. */
+    addMilestoneDuration(s, key, ms) {
+        if (!Number.isFinite(ms) || ms < 0)
+            return;
+        s.milestones[key] = (s.milestones[key] ?? 0) + ms;
+        this.persist(s);
+    }
+    /** Merge an auth-state observation (Phase 2.2 P1.5). */
+    markAuth(s, patch) {
+        s.auth = { ...s.auth, ...patch };
+        this.persist(s);
+    }
+    /** Store a user-provided input (hardening P0.5). The VALUE stays in-memory only; secrets are
+     *  added to the redaction set. Persists metadata so reports can say it was provided. */
+    setInput(s, varName, value, secret, source) {
+        s.inputValues.set(varName, value);
+        if (secret)
+            s.secrets.add(value);
+        const existing = s.inputs.find((i) => i.varName === varName);
+        if (existing) {
+            existing.secret = secret;
+            existing.source = source;
+            existing.at = Date.now();
+        }
+        else {
+            s.inputs.push({ varName, secret, source, at: Date.now() });
+        }
+        this.persist(s);
+    }
+    /** Variable map (varName → value) for the flow runner. In-memory values only. */
+    inputVariables(s) {
+        return Object.fromEntries(s.inputValues);
+    }
+    /** Clear all stored input values (e.g. session close). Metadata is left for the report. */
+    clearInputValues(s) {
+        s.inputValues.clear();
+    }
+    /** Record the latest guided-exploration result (Phase 3.3) for qa_report. */
+    setExploration(s, rec) {
+        s.exploration = rec;
+        this.persist(s);
+    }
+    saveArtifact(s, kind, name, data, mime, label) {
+        const sub = join(s.dir, artifactDirectoryName(kind));
+        mkdirSync(sub, { recursive: true });
+        const path = join(sub, name);
+        const redact = makeRedactor(s.secrets);
+        const storedData = typeof data === 'string' && isTextArtifactMime(mime) ? (redact(data) ?? '') : data;
+        const storedLabel = label ? redact(label) : label;
+        writeFileSync(path, storedData);
+        const uri = `swipium://session/${s.id}/${kind}/${name}`;
+        s.artifacts.push({ uri, path, mime, kind, createdAt: Date.now(), label: storedLabel });
+        this.persist(s);
+        return uri;
+    }
+    findArtifact(uri) {
+        for (const s of this.sessions.values()) {
+            const rec = s.artifacts.find((a) => a.uri === uri);
+            if (rec)
+                return { session: s, rec };
+        }
+        return undefined;
+    }
+    // ---- persistence reload ----
+    loadRegistry() {
+        try {
+            if (!existsSync(REGISTRY))
+                return;
+            const reg = JSON.parse(readFileSync(REGISTRY, 'utf8'));
+            for (const { dir } of reg) {
+                const sp = join(dir, 'state.json');
+                if (!existsSync(sp))
+                    continue;
+                try {
+                    const st = JSON.parse(readFileSync(sp, 'utf8'));
+                    const jobs = new Map((st.jobs ?? []).map((j) => [j.jobId, j]));
+                    for (const j of jobs.values()) {
+                        if (j.status === 'running') {
+                            j.status = 'failed';
+                            j.error = 'server restarted while job was running (child process gone)';
+                        }
+                    }
+                    const s = {
+                        id: st.id, root: st.root, dir: st.dir, createdAt: st.createdAt,
+                        device: st.device, appId: st.appId, headless: st.headless, metroPid: st.metroPid, screenshotCount: st.screenshotCount ?? 0,
+                        network: st.network, envChanges: st.envChanges ?? [], workarounds: st.workarounds ?? [],
+                        mode: st.mode ?? 'structured',
+                        responseMode: st.responseMode ?? DEFAULT_RESPONSE_MODE,
+                        sensitive: st.sensitive ?? false,
+                        budget: { ...DEFAULT_BUDGET, ...(st.budget ?? {}) },
+                        counters: { actions: 0, screenshots: 0, snapshotFailures: 0, noChangeActions: 0, ...(st.counters ?? {}) },
+                        jobs, artifacts: st.artifacts ?? [], findings: st.findings ?? [], notes: st.notes ?? [], mutations: st.mutations ?? [], recordedActions: st.recordedActions ?? [],
+                        fixtures: st.fixtures ?? [], auth: st.auth ?? {}, milestones: st.milestones ?? { session_start: st.createdAt }, budgetProfile: st.budgetProfile,
+                        secrets: new Set(), inputs: st.inputs ?? [], generatedValues: st.generatedValues ?? [], inputValues: new Map(), exploration: st.exploration, aborts: new Map(),
+                    };
+                    this.sessions.set(s.id, s);
+                }
+                catch {
+                    /* skip a corrupt session */
+                }
+            }
+        }
+        catch {
+            /* no registry */
+        }
+    }
+    appendRegistry(id, dir) {
+        try {
+            mkdirSync(REGISTRY_DIR, { recursive: true });
+            const reg = existsSync(REGISTRY) ? JSON.parse(readFileSync(REGISTRY, 'utf8')) : [];
+            reg.push({ id, dir });
+            writeFileSync(REGISTRY, JSON.stringify(reg.slice(-200), null, 2));
+        }
+        catch {
+            /* best-effort */
+        }
+    }
+}
+//# sourceMappingURL=store.js.map

package/dist/session/store.js.map

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

package/dist/snapshot/overlays.js

@@ -0,0 +1,132 @@
+// Overlay detection + tap-obstruction analysis (Phase 2 CR4). Works from a single-window
+// uiautomator dump (allNodes, DFS-ordered). Toasts are NOT in the dump (separate windows);
+// keyboard + foreground-owner are detected by the caller via the driver and merged in.
+import { boundsContain } from './parse.js';
+const LOGBOX_RE = /open debugger|view warnings|LogBox|\b\d+ (warning|error)s?\b/i;
+const REDBOX_RE = /unhandled (js|javascript) exception|render error|reload\b.*\bdismiss/i;
+/** Overlays visible in the current window's UI tree (not toasts/IME/foreign — see callers). */
+const DISMISS_RE = /close|dismiss|got it|ok\b|minimize|×|✕|✖/i;
+/**
+ * Heuristic detector for persistent in-app debug banners / snackbars / toast-like RN views
+ * (RevenueCat debug banner, custom error toasts, etc.) that the id/class detectors miss.
+ * A banner is a wide, short, edge-pinned content block that is NOT the full screen.
+ */
+function detectBanners(allNodes, screen) {
+    if (!screen)
+        return [];
+    const [sw, sh] = screen;
+    if (!sw || !sh)
+        return [];
+    const out = [];
+    for (const n of allNodes) {
+        const [x1, y1, x2, y2] = n.bounds;
+        const w = x2 - x1;
+        const h = y2 - y1;
+        if (!(n.text || n.desc) || w <= 0 || h <= 0)
+            continue;
+        const wideEnough = w >= sw * 0.6;
+        const shortEnough = h <= sh * 0.22 && h >= sh * 0.02;
+        const atTop = y1 <= sh * 0.16;
+        const atBottom = y2 >= sh * 0.82;
+        const fullScreen = h >= sh * 0.85;
+        if (!wideEnough || !shortEnough || fullScreen || (!atTop && !atBottom))
+            continue;
+        const sub = allNodes.filter((m) => m.dfs >= n.dfs && m.dfs <= n.subtreeEnd);
+        const dismissible = sub.some((m) => (m.clickable || m.cls.includes('Button')) && DISMISS_RE.test(`${m.text} ${m.desc}`));
+        const label = (n.text || n.desc).trim().slice(0, 60);
+        out.push({ type: atBottom ? 'snackbar' : 'banner', detail: `${atBottom ? 'bottom snackbar/banner' : 'top banner'}: "${label}"`, bounds: n.bounds, dismissible });
+    }
+    const dedupe = (band) => {
+        const inBand = out.filter((o) => o.type === band);
+        return inBand.length ? [inBand[inBand.length - 1]] : [];
+    };
+    return [...dedupe('banner'), ...dedupe('snackbar')];
+}
+export function detectTreeOverlays(allNodes, screen) {
+    const out = [];
+    const text = (n) => `${n.text} ${n.desc}`;
+    const joined = allNodes.map(text).join(' 
 ');
+    if (REDBOX_RE.test(joined)) {
+        out.push({ type: 'rn_redbox', detail: 'React Native redbox (fatal JS error) overlay' });
+    }
+    else if (LOGBOX_RE.test(joined)) {
+        const node = allNodes.find((n) => LOGBOX_RE.test(text(n)));
+        out.push({ type: 'rn_logbox', detail: 'React Native LogBox warning/error overlay', bounds: node?.bounds });
+    }
+    // Native AlertDialog (incl. the standard button ids).
+    const dlg = allNodes.find((n) => /AlertDialog|android:id\/(button1|alertTitle)/.test(`${n.cls} ${n.id}`));
+    if (dlg)
+        out.push({ type: 'native_dialog', detail: `native dialog (${dlg.cls.split('.').pop()})`, bounds: dlg.bounds });
+    // Material Snackbar (in-tree, by id).
+    const snack = allNodes.find((n) => /snackbar_text|snackbar_action/.test(n.id));
+    if (snack)
+        out.push({ type: 'snackbar', detail: 'Material snackbar', bounds: snack.bounds });
+    // Heuristic banners/snackbars the id/class checks miss (RN debug banners etc.), de-duped
+    // against the explicit detections above.
+    const haveSnack = out.some((o) => o.type === 'snackbar');
+    const haveRn = out.some((o) => o.type === 'rn_logbox' || o.type === 'rn_redbox');
+    for (const b of detectBanners(allNodes, screen)) {
+        if (b.type === 'snackbar' && haveSnack)
+            continue;
+        if (b.type === 'banner' && haveRn)
+            continue; // likely the LogBox banner already reported
+        out.push(b);
+    }
+    return out;
+}
+const UNABLE_TO_LOAD_RE = /unable to load script|loadJSBundleFromAssets|index\.android\.bundle|could not connect to development server/i;
+/** Detect the RN red-box and whether it's the fatal "unable to load JS bundle" variant. */
+export function detectRedBox(allNodes) {
+    const joined = allNodes.map((n) => `${n.text} ${n.desc}`).join('  ');
+    const present = REDBOX_RE.test(joined) || UNABLE_TO_LOAD_RE.test(joined);
+    return { present, unableToLoadScript: UNABLE_TO_LOAD_RE.test(joined) };
+}
+/** Classify the foreground owner string into an overlay class (system/foreign surfaces). */
+export function classifyForeground(appId, foreground) {
+    if (appId && foreground.startsWith(appId))
+        return null;
+    if (/permissioncontroller/i.test(foreground))
+        return { type: 'permission_dialog', detail: foreground };
+    if (/accountpicker|account\.|gms/i.test(foreground))
+        return { type: 'account_picker', detail: foreground };
+    if (/launcher/i.test(foreground))
+        return null; // not an overlay — handled by health
+    if (/inputmethod/i.test(foreground))
+        return { type: 'keyboard', detail: foreground };
+    if (foreground && foreground !== 'unknown')
+        return { type: 'foreign_app', detail: foreground };
+    return null;
+}
+/**
+ * Is the point (x,y) — typically the center of the intended target — covered by content
+ * drawn ON TOP of the target's subtree? Topmost = greatest DFS index among nodes containing
+ * the point; an obstruction is a topmost node OUTSIDE the target's subtree that carries
+ * visible content (text/desc/clickable or a known overlay class).
+ */
+export function obstructionAt(allNodes, target, x, y) {
+    const containing = allNodes.filter((n) => boundsContain(n.bounds, x, y));
+    if (containing.length === 0)
+        return { obstructed: false };
+    // Topmost = greatest DFS (pre-order) index among containing nodes. `drawing-order` is only
+    // meaningful among SIBLINGS (per-parent); comparing it globally across unrelated branches
+    // misclassifies, so we use DFS order as the safe global signal (later DFS = drawn later).
+    const topmost = containing.reduce((a, b) => (b.dfs > a.dfs ? b : a));
+    if (!target) {
+        // no known target → only flag if the topmost is clearly an overlay-ish content node
+        const looksOverlay = !!(topmost.text || topmost.desc) && topmost.isLeaf;
+        return looksOverlay ? { obstructed: false } : { obstructed: false };
+    }
+    const withinTarget = topmost.dfs >= target.dfs && topmost.dfs <= target.subtreeEnd;
+    const isAncestor = topmost.dfs <= target.dfs && topmost.subtreeEnd >= target.subtreeEnd;
+    if (withinTarget || isAncestor)
+        return { obstructed: false };
+    // topmost is outside the target subtree and on top → only an obstruction if it's real content
+    const realContent = !!(topmost.text || topmost.desc) || topmost.clickable;
+    if (!realContent)
+        return { obstructed: false };
+    return {
+        obstructed: true,
+        by: { cls: topmost.cls, id: topmost.id || undefined, text: (topmost.text || topmost.desc) || undefined, bounds: topmost.bounds },
+    };
+}
+//# sourceMappingURL=overlays.js.map

package/dist/snapshot/overlays.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"overlays.js","sourceRoot":"","sources":["../../src/snapshot/overlays.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,2FAA2F;AAC3F,uFAAuF;AAEvF,OAAO,EAAE,aAAa,EAAgB,MAAM,YAAY,CAAC;AAsBzD,MAAM,SAAS,GAAG,+DAA+D,CAAC;AAClF,MAAM,SAAS,GAAG,uEAAuE,CAAC;AAE1F,+FAA+F;AAC/F,MAAM,UAAU,GAAG,2CAA2C,CAAC;AAE/D;;;;GAIG;AACH,SAAS,aAAa,CAAC,QAAmB,EAAE,MAAyB;IACnE,IAAI,CAAC,MAAM;QAAE,OAAO,EAAE,CAAC;IACvB,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,GAAG,MAAM,CAAC;IACxB,IAAI,CAAC,EAAE,IAAI,CAAC,EAAE;QAAE,OAAO,EAAE,CAAC;IAC1B,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,KAAK,MAAM,CAAC,IAAI,QAAQ,EAAE,CAAC;QACzB,MAAM,CAAC,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,MAAM,CAAC;QAClC,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QAClB,MAAM,CAAC,GAAG,EAAE,GAAG,EAAE,CAAC;QAClB,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;YAAE,SAAS;QACtD,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,GAAG,GAAG,CAAC;QACjC,MAAM,WAAW,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;QACrD,MAAM,KAAK,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QAC9B,MAAM,QAAQ,GAAG,EAAE,IAAI,EAAE,GAAG,IAAI,CAAC;QACjC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,GAAG,IAAI,CAAC;QAClC,IAAI,CAAC,UAAU,IAAI,CAAC,WAAW,IAAI,UAAU,IAAI,CAAC,CAAC,KAAK,IAAI,CAAC,QAAQ,CAAC;YAAE,SAAS;QACjF,MAAM,GAAG,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,UAAU,CAAC,CAAC;QAC5E,MAAM,WAAW,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,IAAI,UAAU,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC;QACzH,MAAM,KAAK,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC;QACrD,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE,MAAM,EAAE,GAAG,QAAQ,CAAC,CAAC,CAAC,wBAAwB,CAAC,CAAC,CAAC,YAAY,MAAM,KAAK,GAAG,EAAE,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,CAAC,CAAC;IACnK,CAAC;IACD,MAAM,MAAM,GAAG,CAAC,IAAiB,EAAE,EAAE;QACnC,MAAM,MAAM,GAAG,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC;QAClD,OAAO,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;IAC1D,CAAC,CAAC;IACF,OAAO,CAAC,GAAG,MAAM,CAAC,QAAQ,CAAC,EAAE,GAAG,MAAM,CAAC,UAAU,CAAC,CAAC,CAAC;AACtD,CAAC;AAED,MAAM,UAAU,kBAAkB,CAAC,QAAmB,EAAE,MAAyB;IAC/E,MAAM,GAAG,GAAc,EAAE,CAAC;IAC1B,MAAM,IAAI,GAAG,CAAC,CAAU,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC;IACnD,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE9C,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAC3B,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,8CAA8C,EAAE,CAAC,CAAC;IAC1F,CAAC;SAAM,IAAI,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QAClC,MAAM,IAAI,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;QAC3D,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,WAAW,EAAE,MAAM,EAAE,2CAA2C,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC,CAAC;IAC7G,CAAC;IAED,sDAAsD;IACtD,MAAM,GAAG,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,8CAA8C,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,GAAG,IAAI,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC;IAC1G,IAAI,GAAG;QAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,eAAe,EAAE,MAAM,EAAE,kBAAkB,GAAG,CAAC,GAAG,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,GAAG,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,EAAE,CAAC,CAAC;IAExH,sCAAsC;IACtC,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,+BAA+B,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC;IAC/E,IAAI,KAAK;QAAE,GAAG,CAAC,IAAI,CAAC,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,mBAAmB,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC;IAE7F,yFAAyF;IACzF,yCAAyC;IACzC,MAAM,SAAS,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC;IACzD,MAAM,MAAM,GAAG,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,WAAW,IAAI,CAAC,CAAC,IAAI,KAAK,WAAW,CAAC,CAAC;IACjF,KAAK,MAAM,CAAC,IAAI,aAAa,CAAC,QAAQ,EAAE,MAAM,CAAC,EAAE,CAAC;QAChD,IAAI,CAAC,CAAC,IAAI,KAAK,UAAU,IAAI,SAAS;YAAE,SAAS;QACjD,IAAI,CAAC,CAAC,IAAI,KAAK,QAAQ,IAAI,MAAM;YAAE,SAAS,CAAC,4CAA4C;QACzF,GAAG,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACd,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC;AAED,MAAM,iBAAiB,GAAG,8GAA8G,CAAC;AAEzI,2FAA2F;AAC3F,MAAM,UAAU,YAAY,CAAC,QAAmB;IAC9C,MAAM,MAAM,GAAG,QAAQ,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACrE,MAAM,OAAO,GAAG,SAAS,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IACzE,OAAO,EAAE,OAAO,EAAE,kBAAkB,EAAE,iBAAiB,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;AACzE,CAAC;AAED,4FAA4F;AAC5F,MAAM,UAAU,kBAAkB,CAAC,KAAyB,EAAE,UAAkB;IAC9E,IAAI,KAAK,IAAI,UAAU,CAAC,UAAU,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACvD,IAAI,uBAAuB,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,mBAAmB,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACvG,IAAI,8BAA8B,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,gBAAgB,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC3G,IAAI,WAAW,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,IAAI,CAAC,CAAC,qCAAqC;IACpF,IAAI,cAAc,CAAC,IAAI,CAAC,UAAU,CAAC;QAAE,OAAO,EAAE,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IACrF,IAAI,UAAU,IAAI,UAAU,KAAK,SAAS;QAAE,OAAO,EAAE,IAAI,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC;IAC/F,OAAO,IAAI,CAAC;AACd,CAAC;AAOD;;;;;GAKG;AACH,MAAM,UAAU,aAAa,CAAC,QAAmB,EAAE,MAA2B,EAAE,CAAS,EAAE,CAAS;IAClG,MAAM,UAAU,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC;IACzE,IAAI,UAAU,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC1D,2FAA2F;IAC3F,0FAA0F;IAC1F,0FAA0F;IAC1F,MAAM,OAAO,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;IACrE,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,oFAAoF;QACpF,MAAM,YAAY,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,MAAM,CAAC;QACxE,OAAO,YAAY,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IACtE,CAAC;IACD,MAAM,YAAY,GAAG,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC;IACnF,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,IAAI,MAAM,CAAC,GAAG,IAAI,OAAO,CAAC,UAAU,IAAI,MAAM,CAAC,UAAU,CAAC;IACxF,IAAI,YAAY,IAAI,UAAU;QAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC7D,8FAA8F;IAC9F,MAAM,WAAW,GAAG,CAAC,CAAC,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,OAAO,CAAC,SAAS,CAAC;IAC1E,IAAI,CAAC,WAAW;QAAE,OAAO,EAAE,UAAU,EAAE,KAAK,EAAE,CAAC;IAC/C,OAAO;QACL,UAAU,EAAE,IAAI;QAChB,EAAE,EAAE,EAAE,GAAG,EAAE,OAAO,CAAC,GAAG,EAAE,EAAE,EAAE,OAAO,CAAC,EAAE,IAAI,SAAS,EAAE,IAAI,EAAE,CAAC,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,IAAI,SAAS,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE;KACjI,CAAC;AACJ,CAAC"}