@blockspool/cli 0.4.1 → 0.4.3

package/dist/lib/spindle.d.ts.map

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

package/dist/lib/spindle.js

@@ -0,0 +1,388 @@
+/**
+ * Spindle Loop Detection
+ *
+ * Monitors agent execution for unproductive patterns:
+ * - Oscillation: Similar diffs being applied and reverted
+ * - Spinning: High tool call rate without progress
+ * - Stalling: Verbose output without meaningful changes
+ * - Repetition: Same errors or phrases repeated
+ *
+ * Named "Spindle" after the spinning wheel component — when the spindle
+ * jams, it spins without producing thread.
+ */
+/**
+ * Default Spindle configuration
+ */
+export const DEFAULT_SPINDLE_CONFIG = {
+    enabled: true,
+    similarityThreshold: 0.8,
+    maxSimilarOutputs: 3,
+    maxStallIterations: 5,
+    verbosityThreshold: 10,
+    tokenBudgetWarning: 100000,
+    tokenBudgetAbort: 140000,
+};
+/**
+ * Create initial Spindle state
+ */
+export function createSpindleState() {
+    return {
+        outputs: [],
+        diffs: [],
+        iterationsSinceChange: 0,
+        estimatedTokens: 0,
+        warnings: [],
+        totalOutputChars: 0,
+        totalChangeChars: 0,
+    };
+}
+/**
+ * Estimate token count from text
+ * Rough approximation: ~4 characters per token for English text
+ */
+export function estimateTokens(text) {
+    if (!text)
+        return 0;
+    return Math.ceil(text.length / 4);
+}
+/**
+ * Compute similarity between two strings using Jaccard index on word tokens
+ *
+ * @returns Similarity score from 0 (completely different) to 1 (identical)
+ */
+export function computeSimilarity(a, b) {
+    if (!a && !b)
+        return 1;
+    if (!a || !b)
+        return 0;
+    // Tokenize on whitespace and punctuation, lowercase
+    const tokenize = (s) => {
+        const tokens = s
+            .toLowerCase()
+            .split(/[\s.,;:!?\-()[\]{}"']+/)
+            .filter(t => t.length > 0);
+        return new Set(tokens);
+    };
+    const tokensA = tokenize(a);
+    const tokensB = tokenize(b);
+    if (tokensA.size === 0 && tokensB.size === 0)
+        return 1;
+    if (tokensA.size === 0 || tokensB.size === 0)
+        return 0;
+    // Jaccard index: |intersection| / |union|
+    let intersectionSize = 0;
+    for (const token of tokensA) {
+        if (tokensB.has(token)) {
+            intersectionSize++;
+        }
+    }
+    const unionSize = tokensA.size + tokensB.size - intersectionSize;
+    return intersectionSize / unionSize;
+}
+/**
+ * Extract added and removed lines from a unified diff
+ */
+function extractDiffLines(diff) {
+    const lines = diff.split('\n');
+    const added = [];
+    const removed = [];
+    for (const line of lines) {
+        // Skip diff headers
+        if (line.startsWith('+++') || line.startsWith('---') || line.startsWith('@@')) {
+            continue;
+        }
+        if (line.startsWith('+')) {
+            added.push(line.slice(1).trim());
+        }
+        else if (line.startsWith('-')) {
+            removed.push(line.slice(1).trim());
+        }
+    }
+    return { added, removed };
+}
+/**
+ * Detect oscillation pattern in diffs
+ *
+ * Looks for add→remove→add or remove→add→remove patterns where similar
+ * content is being repeatedly changed back and forth.
+ *
+ * @returns Object with detected flag and pattern description
+ */
+export function detectOscillation(diffs, similarityThreshold = 0.8) {
+    if (diffs.length < 2) {
+        return { detected: false, confidence: 0 };
+    }
+    // Analyze last 3 diffs (or 2 if only 2 available)
+    const recentDiffs = diffs.slice(-3);
+    const patterns = recentDiffs.map(d => extractDiffLines(d));
+    // With 2 diffs: check if what was added is now removed (or vice versa)
+    if (patterns.length >= 2) {
+        const [prev, curr] = patterns.slice(-2);
+        // Check: lines added in prev are now removed in curr
+        for (const addedLine of prev.added) {
+            if (addedLine.length < 3)
+                continue; // Skip trivial lines
+            for (const removedLine of curr.removed) {
+                const sim = computeSimilarity(addedLine, removedLine);
+                if (sim >= similarityThreshold) {
+                    return {
+                        detected: true,
+                        pattern: `Added then removed: "${addedLine.slice(0, 50)}..."`,
+                        confidence: sim,
+                    };
+                }
+            }
+        }
+        // Check: lines removed in prev are now added in curr
+        for (const removedLine of prev.removed) {
+            if (removedLine.length < 3)
+                continue;
+            for (const addedLine of curr.added) {
+                const sim = computeSimilarity(removedLine, addedLine);
+                if (sim >= similarityThreshold) {
+                    return {
+                        detected: true,
+                        pattern: `Removed then re-added: "${removedLine.slice(0, 50)}..."`,
+                        confidence: sim,
+                    };
+                }
+            }
+        }
+    }
+    // With 3 diffs: check for A→B→A pattern
+    if (patterns.length === 3) {
+        const [first, , third] = patterns;
+        // Check if first additions match third additions (came back to same state)
+        for (const line1 of first.added) {
+            if (line1.length < 3)
+                continue;
+            for (const line3 of third.added) {
+                const sim = computeSimilarity(line1, line3);
+                if (sim >= similarityThreshold) {
+                    return {
+                        detected: true,
+                        pattern: `Oscillating: same content added in iterations 1 and 3`,
+                        confidence: sim,
+                    };
+                }
+            }
+        }
+    }
+    return { detected: false, confidence: 0 };
+}
+/**
+ * Detect repetition in agent outputs
+ *
+ * Looks for consecutive similar outputs that indicate the agent is stuck
+ * in a loop saying the same things.
+ */
+export function detectRepetition(outputs, latestOutput, config) {
+    const patterns = [];
+    let maxSimilarity = 0;
+    // Compare latest output with recent outputs
+    for (const prevOutput of outputs.slice(-config.maxSimilarOutputs)) {
+        const sim = computeSimilarity(latestOutput, prevOutput);
+        if (sim >= config.similarityThreshold) {
+            maxSimilarity = Math.max(maxSimilarity, sim);
+            // Extract repeated phrases
+            const phrases = findRepeatedPhrases(latestOutput, prevOutput);
+            patterns.push(...phrases);
+        }
+    }
+    // Check for common "stuck" phrases
+    const stuckPhrases = [
+        'let me try',
+        'i apologize',
+        "i'll try again",
+        'let me attempt',
+        'trying again',
+        'one more time',
+        'another approach',
+    ];
+    const lowerOutput = latestOutput.toLowerCase();
+    for (const phrase of stuckPhrases) {
+        if (lowerOutput.includes(phrase)) {
+            const occurrences = outputs.filter(o => o.toLowerCase().includes(phrase)).length;
+            if (occurrences >= 2) {
+                patterns.push(`Repeated phrase: "${phrase}" (${occurrences + 1} times)`);
+                // Set high similarity since stuck phrases are a strong signal
+                maxSimilarity = Math.max(maxSimilarity, 0.85);
+            }
+        }
+    }
+    const detected = patterns.length > 0 && maxSimilarity >= config.similarityThreshold;
+    return {
+        detected,
+        patterns: [...new Set(patterns)].slice(0, 5), // Dedupe and limit
+        confidence: maxSimilarity,
+    };
+}
+/**
+ * Find repeated phrases between two texts
+ */
+function findRepeatedPhrases(a, b) {
+    const phrases = [];
+    // Split into sentences/fragments
+    const fragmentsA = a.split(/[.!?\n]+/).filter(f => f.trim().length > 20);
+    const fragmentsB = b.split(/[.!?\n]+/).filter(f => f.trim().length > 20);
+    for (const fragA of fragmentsA) {
+        for (const fragB of fragmentsB) {
+            const sim = computeSimilarity(fragA, fragB);
+            if (sim >= 0.9) {
+                phrases.push(fragA.trim().slice(0, 60) + '...');
+            }
+        }
+    }
+    return phrases;
+}
+/**
+ * Check if agent is in a Spindle loop
+ *
+ * Updates state in-place and returns detection result.
+ *
+ * @param state - Current Spindle state (will be mutated)
+ * @param latestOutput - Agent's latest output text
+ * @param latestDiff - Latest git diff (null if no changes)
+ * @param config - Spindle configuration
+ * @returns Detection result
+ */
+export function checkSpindleLoop(state, latestOutput, latestDiff, config) {
+    // If disabled, always pass
+    if (!config.enabled) {
+        return { shouldAbort: false, confidence: 0, diagnostics: {} };
+    }
+    // Update state with latest data
+    const outputTokens = estimateTokens(latestOutput);
+    const diffTokens = estimateTokens(latestDiff ?? '');
+    state.estimatedTokens += outputTokens + diffTokens;
+    state.totalOutputChars += latestOutput.length;
+    state.totalChangeChars += (latestDiff ?? '').length;
+    // Store for pattern detection (keep last N)
+    state.outputs.push(latestOutput);
+    if (state.outputs.length > config.maxSimilarOutputs + 1) {
+        state.outputs.shift();
+    }
+    if (latestDiff) {
+        state.diffs.push(latestDiff);
+        if (state.diffs.length > 5) {
+            state.diffs.shift();
+        }
+    }
+    // Track iterations without changes
+    if (!latestDiff || latestDiff.trim() === '') {
+        state.iterationsSinceChange++;
+    }
+    else {
+        state.iterationsSinceChange = 0;
+    }
+    // Check 1: Token budget
+    if (state.estimatedTokens >= config.tokenBudgetAbort) {
+        return {
+            shouldAbort: true,
+            reason: 'token_budget',
+            confidence: 1.0,
+            diagnostics: {
+                estimatedTokens: state.estimatedTokens,
+            },
+        };
+    }
+    // Token budget warning (don't abort, just warn)
+    if (state.estimatedTokens >= config.tokenBudgetWarning) {
+        const warning = `Approaching token budget: ~${state.estimatedTokens} tokens`;
+        if (!state.warnings.includes(warning)) {
+            state.warnings.push(warning);
+        }
+    }
+    // Check 2: Stalling (no changes for too many iterations)
+    if (state.iterationsSinceChange >= config.maxStallIterations) {
+        return {
+            shouldAbort: true,
+            reason: 'stalling',
+            confidence: 0.9,
+            diagnostics: {
+                iterationsWithoutChange: state.iterationsSinceChange,
+            },
+        };
+    }
+    // Check 3: Oscillation in diffs
+    if (state.diffs.length >= 2) {
+        const oscillation = detectOscillation(state.diffs, config.similarityThreshold);
+        if (oscillation.detected) {
+            return {
+                shouldAbort: true,
+                reason: 'oscillation',
+                confidence: oscillation.confidence,
+                diagnostics: {
+                    oscillationPattern: oscillation.pattern,
+                },
+            };
+        }
+    }
+    // Check 4: Repetition in outputs
+    if (state.outputs.length >= 2) {
+        const repetition = detectRepetition(state.outputs.slice(0, -1), latestOutput, config);
+        if (repetition.detected) {
+            return {
+                shouldAbort: true,
+                reason: 'repetition',
+                confidence: repetition.confidence,
+                diagnostics: {
+                    repeatedPatterns: repetition.patterns,
+                    similarityScore: repetition.confidence,
+                },
+            };
+        }
+    }
+    // Check 5: Verbosity ratio (lots of output, few changes)
+    if (state.totalOutputChars > 5000 && state.totalChangeChars > 0) {
+        const verbosityRatio = state.totalOutputChars / state.totalChangeChars;
+        if (verbosityRatio >= config.verbosityThreshold) {
+            // Only warn, don't abort on verbosity alone
+            const warning = `High verbosity ratio: ${verbosityRatio.toFixed(1)}x output vs changes`;
+            if (!state.warnings.includes(warning)) {
+                state.warnings.push(warning);
+            }
+        }
+    }
+    // No issues detected
+    return {
+        shouldAbort: false,
+        confidence: 0,
+        diagnostics: {
+            estimatedTokens: state.estimatedTokens,
+            iterationsWithoutChange: state.iterationsSinceChange,
+        },
+    };
+}
+/**
+ * Format Spindle result for display
+ */
+export function formatSpindleResult(result) {
+    if (!result.shouldAbort) {
+        return 'No spindle loop detected';
+    }
+    const parts = [`Spindle loop detected: ${result.reason}`];
+    parts.push(`Confidence: ${(result.confidence * 100).toFixed(0)}%`);
+    if (result.diagnostics.estimatedTokens) {
+        parts.push(`Tokens: ~${result.diagnostics.estimatedTokens}`);
+    }
+    if (result.diagnostics.iterationsWithoutChange) {
+        parts.push(`Iterations without change: ${result.diagnostics.iterationsWithoutChange}`);
+    }
+    if (result.diagnostics.oscillationPattern) {
+        parts.push(`Pattern: ${result.diagnostics.oscillationPattern}`);
+    }
+    if (result.diagnostics.repeatedPatterns?.length) {
+        parts.push(`Repeated: ${result.diagnostics.repeatedPatterns.join(', ')}`);
+    }
+    return parts.join('\n');
+}
+/** @deprecated Use DEFAULT_SPINDLE_CONFIG */
+export const DEFAULT_RALPH_CONFIG = DEFAULT_SPINDLE_CONFIG;
+/** @deprecated Use createSpindleState */
+export const createRalphState = createSpindleState;
+/** @deprecated Use checkSpindleLoop */
+export const checkRalphLoop = checkSpindleLoop;
+/** @deprecated Use formatSpindleResult */
+export const formatRalphResult = formatSpindleResult;
+//# sourceMappingURL=spindle.js.map

package/dist/lib/spindle.js.map

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

package/dist/tui/app.d.ts

@@ -0,0 +1,17 @@
+/**
+ * TUI main application
+ *
+ * Keyboard-first terminal UI for solo mode.
+ * Uses blessed for rendering, repos for state, services for actions.
+ */
+import type { DatabaseAdapter } from '@blockspool/core/db';
+import type { TuiActions } from './types.js';
+export type TuiAppDeps = {
+    db: DatabaseAdapter;
+    repoRoot: string;
+    actions?: TuiActions;
+};
+export declare function startTuiApp(deps: TuiAppDeps): Promise<{
+    stop: () => Promise<void>;
+}>;
+//# sourceMappingURL=app.d.ts.map

package/dist/tui/app.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../../src/tui/app.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,qBAAqB,CAAC;AAI3D,OAAO,KAAK,EAAa,UAAU,EAAE,MAAM,YAAY,CAAC;AAExD,MAAM,MAAM,UAAU,GAAG;IACvB,EAAE,EAAE,eAAe,CAAC;IACpB,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,UAAU,CAAC;CACtB,CAAC;AA4CF,wBAAsB,WAAW,CAAC,IAAI,EAAE,UAAU,GAAG,OAAO,CAAC;IAAE,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAA;CAAE,CAAC,CAsG1F"}

package/dist/tui/app.js

@@ -0,0 +1,139 @@
+/**
+ * TUI main application
+ *
+ * Keyboard-first terminal UI for solo mode.
+ * Uses blessed for rendering, repos for state, services for actions.
+ */
+import blessed from 'neo-blessed';
+import { AdaptivePoller } from './poller.js';
+import { buildSnapshot } from './state.js';
+import { createOverviewScreen } from './screens/overview.js';
+/**
+ * Manages screen lifecycle - mount/destroy/update
+ */
+class ScreenManager {
+    current = null;
+    screen;
+    constructor(screen) {
+        this.screen = screen;
+    }
+    set(next) {
+        if (this.current) {
+            this.current.destroy();
+        }
+        this.current = next;
+        next.mount(this.screen);
+        next.focus?.();
+        this.screen.render();
+    }
+    update(snapshot) {
+        if (!this.current)
+            return;
+        this.current.update(snapshot);
+        this.screen.render();
+    }
+    getCurrentName() {
+        return this.current?.name ?? null;
+    }
+    destroy() {
+        this.current?.destroy();
+        this.current = null;
+    }
+}
+function safeString(err) {
+    if (err instanceof Error)
+        return err.stack || err.message;
+    return String(err);
+}
+export async function startTuiApp(deps) {
+    const { db, repoRoot, actions } = deps;
+    const screen = blessed.screen({
+        smartCSR: true,
+        fullUnicode: true,
+        title: 'BlockSpool',
+    });
+    // Toast bar at bottom for status messages
+    const toast = blessed.box({
+        parent: screen,
+        bottom: 0,
+        height: 1,
+        width: '100%',
+        tags: true,
+        style: { fg: 'white' },
+        content: ' {gray-fg}Starting...{/gray-fg}',
+    });
+    const manager = new ScreenManager(screen);
+    const overview = createOverviewScreen({
+        onHint: (msg) => {
+            toast.setContent(` {gray-fg}${msg}{/gray-fg}`);
+        },
+    });
+    manager.set(overview);
+    let actionInFlight = null;
+    async function runAction(name, fn) {
+        if (!fn) {
+            toast.setContent(` {yellow-fg}${name} not configured{/yellow-fg}`);
+            screen.render();
+            return;
+        }
+        if (actionInFlight) {
+            toast.setContent(` {gray-fg}Action already running...{/gray-fg}`);
+            screen.render();
+            return;
+        }
+        toast.setContent(` {cyan-fg}${name}...{/cyan-fg}`);
+        screen.render();
+        actionInFlight = (async () => {
+            try {
+                await fn();
+                toast.setContent(` {green-fg}${name} complete{/green-fg}`);
+            }
+            catch (e) {
+                toast.setContent(` {red-fg}${name} failed: ${safeString(e).slice(0, 50)}{/red-fg}`);
+            }
+            finally {
+                actionInFlight = null;
+                screen.render();
+                poller.tickNow();
+            }
+        })();
+    }
+    // Global keybindings
+    screen.key(['C-c'], async () => {
+        await stop();
+    });
+    screen.key(['s'], () => void runAction('Scout', actions?.runScout));
+    screen.key(['q'], () => void runAction('QA', actions?.runQa));
+    screen.key(['r'], () => {
+        toast.setContent(' {gray-fg}Refreshing...{/gray-fg}');
+        screen.render();
+        poller.tickNow();
+    });
+    // Poller wiring
+    const poller = new AdaptivePoller({
+        fetch: () => buildSnapshot({ db, repoRoot }),
+        hash: (snap) => snap.etag,
+        isActive: (snap) => snap.runs.activeCount > 0 || snap.runs.runningStep !== null,
+        intervals: {
+            idleMs: 1000,
+            activeMs: 300,
+            errorMs: 2000,
+        },
+        onUpdate: async (snap) => {
+            manager.update(snap);
+            toast.setContent(` {gray-fg}${snap.hintLine}{/gray-fg}`);
+        },
+        onError: (err) => {
+            toast.setContent(` {red-fg}Poll error: ${safeString(err).slice(0, 50)}{/red-fg}`);
+            screen.render();
+        },
+    });
+    poller.start();
+    async function stop() {
+        poller.stop();
+        manager.destroy();
+        screen.destroy();
+    }
+    return { stop };
+}
+//# sourceMappingURL=app.js.map

package/dist/tui/app.js.map

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

package/dist/tui/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * TUI module exports
+ */
+export { startTuiApp, type TuiAppDeps } from './app.js';
+export { buildSnapshot, type TuiSnapshot, type BuildSnapshotDeps } from './state.js';
+export { AdaptivePoller, type AdaptivePollerOptions, type AdaptivePollerIntervals } from './poller.js';
+export type { TuiScreen, TuiActions } from './types.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/tui/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/tui/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAE,KAAK,UAAU,EAAE,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,iBAAiB,EAAE,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,cAAc,EAAE,KAAK,qBAAqB,EAAE,KAAK,uBAAuB,EAAE,MAAM,aAAa,CAAC;AACvG,YAAY,EAAE,SAAS,EAAE,UAAU,EAAE,MAAM,YAAY,CAAC"}

package/dist/tui/index.js

@@ -0,0 +1,7 @@
+/**
+ * TUI module exports
+ */
+export { startTuiApp } from './app.js';
+export { buildSnapshot } from './state.js';
+export { AdaptivePoller } from './poller.js';
+//# sourceMappingURL=index.js.map

package/dist/tui/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/tui/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,EAAE,WAAW,EAAmB,MAAM,UAAU,CAAC;AACxD,OAAO,EAAE,aAAa,EAA4C,MAAM,YAAY,CAAC;AACrF,OAAO,EAAE,cAAc,EAA4D,MAAM,aAAa,CAAC"}

package/dist/tui/poller.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Adaptive poller for TUI
+ *
+ * Polls faster when there's activity (running steps),
+ * slows down when idle. Uses hash-based dedupe to avoid
+ * unnecessary re-renders.
+ */
+export type AdaptivePollerIntervals = {
+    idleMs: number;
+    activeMs: number;
+    errorMs: number;
+};
+export type AdaptivePollerOptions<T> = {
+    fetch: () => Promise<T>;
+    onUpdate: (snapshot: T) => void | Promise<void>;
+    onError?: (err: unknown) => void;
+    /**
+     * Determines whether the app is "active" (e.g. a run is running),
+     * which switches polling to activeMs.
+     */
+    isActive?: (snapshot: T) => boolean;
+    /**
+     * Used to avoid re-rendering when nothing changed.
+     * If omitted, every tick calls onUpdate.
+     */
+    hash?: (snapshot: T) => string;
+    intervals: AdaptivePollerIntervals;
+};
+export declare class AdaptivePoller<T> {
+    private opts;
+    private stopped;
+    private timer;
+    private lastHash;
+    constructor(opts: AdaptivePollerOptions<T>);
+    start(): void;
+    stop(): void;
+    /** Force an immediate poll (e.g., after user action) */
+    tickNow(): void;
+    private schedule;
+    private loop;
+}
+//# sourceMappingURL=poller.d.ts.map

package/dist/tui/poller.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"poller.d.ts","sourceRoot":"","sources":["../../src/tui/poller.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,uBAAuB,GAAG;IACpC,MAAM,EAAE,MAAM,CAAC;IACf,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;CACjB,CAAC;AAEF,MAAM,MAAM,qBAAqB,CAAC,CAAC,IAAI;IACrC,KAAK,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,CAAC;IACxB,QAAQ,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAChD,OAAO,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAEjC;;;OAGG;IACH,QAAQ,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,OAAO,CAAC;IAEpC;;;OAGG;IACH,IAAI,CAAC,EAAE,CAAC,QAAQ,EAAE,CAAC,KAAK,MAAM,CAAC;IAE/B,SAAS,EAAE,uBAAuB,CAAC;CACpC,CAAC;AAEF,qBAAa,cAAc,CAAC,CAAC;IAC3B,OAAO,CAAC,IAAI,CAA2B;IACvC,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,KAAK,CAA8C;IAC3D,OAAO,CAAC,QAAQ,CAAuB;gBAE3B,IAAI,EAAE,qBAAqB,CAAC,CAAC,CAAC;IAI1C,KAAK;IAML,IAAI;IAMJ,wDAAwD;IACxD,OAAO;IAOP,OAAO,CAAC,QAAQ;YAKF,IAAI;CAqBnB"}