@promptwheel/core 0.6.0

package/dist/trace/shared.d.ts

@@ -0,0 +1,147 @@
+/**
+ * Execution Trace Analysis — pure functions, no I/O.
+ *
+ * Parses Claude Code `--output-format stream-json` JSONL output and extracts:
+ * 1. Compaction events (context limit hits)
+ * 2. Per-tool-call token profiles
+ * 3. Liveness / stall detection
+ * 4. Semantic step decomposition
+ * 5. Configurable trigger/alert evaluation
+ *
+ * Shared by @promptwheel/cli and @promptwheel/mcp.
+ */
+export interface StreamJsonEvent {
+    type: 'assistant' | 'system' | 'result';
+    subtype?: string;
+    message?: {
+        role: string;
+        content: ContentBlock[];
+        usage?: {
+            input_tokens: number;
+            output_tokens: number;
+        };
+        model?: string;
+    };
+    result?: {
+        cost_usd?: number;
+        duration_ms?: number;
+        is_error?: boolean;
+        num_turns?: number;
+    };
+}
+export type ContentBlock = {
+    type: 'thinking';
+    thinking: string;
+} | {
+    type: 'tool_use';
+    id: string;
+    name: string;
+    input: Record<string, unknown>;
+} | {
+    type: 'tool_result';
+    tool_use_id: string;
+    content: string;
+    is_error?: boolean;
+} | {
+    type: 'text';
+    text: string;
+};
+export interface CompactionEvent {
+    timestamp_ms: number;
+    event_index: number;
+    tokens_before?: number;
+    tokens_after?: number;
+}
+export interface ToolTokenProfile {
+    tool_name: string;
+    call_count: number;
+    total_input_tokens: number;
+    total_output_tokens: number;
+    avg_input_tokens: number;
+    avg_output_tokens: number;
+    error_count: number;
+}
+export interface LivenessSnapshot {
+    total_duration_ms: number;
+    event_count: number;
+    avg_gap_ms: number;
+    max_gap_ms: number;
+    stall_periods: {
+        start_ms: number;
+        end_ms: number;
+        duration_ms: number;
+    }[];
+    /** Fraction of total time with gaps > 10s (0-1) */
+    idle_ratio: number;
+}
+export interface SemanticStep {
+    label: string;
+    tool_calls: string[];
+    start_index: number;
+    end_index: number;
+    duration_ms?: number;
+}
+export interface TriggerRule {
+    id: string;
+    name: string;
+    condition: TriggerCondition;
+    action: 'warn' | 'abort' | 'log';
+    message?: string;
+}
+export type TriggerCondition = {
+    type: 'token_threshold';
+    threshold: number;
+} | {
+    type: 'compaction_count';
+    threshold: number;
+} | {
+    type: 'error_pattern';
+    pattern: string;
+} | {
+    type: 'stall_duration_ms';
+    threshold: number;
+} | {
+    type: 'tool_error_rate';
+    tool: string;
+    threshold: number;
+};
+export interface TriggerAlert {
+    rule_id: string;
+    rule_name: string;
+    action: 'warn' | 'abort' | 'log';
+    message: string;
+    timestamp_ms: number;
+}
+export interface TraceAnalysis {
+    compactions: CompactionEvent[];
+    tool_profiles: ToolTokenProfile[];
+    liveness: LivenessSnapshot;
+    steps: SemanticStep[];
+    alerts: TriggerAlert[];
+    total_input_tokens: number;
+    total_output_tokens: number;
+    total_cost_usd?: number;
+    model?: string;
+    is_stream_json: boolean;
+}
+/** Parse a single JSONL line into a StreamJsonEvent, or null if invalid. */
+export declare function parseStreamJsonLine(line: string): StreamJsonEvent | null;
+/** Parse raw multi-line output into an array of StreamJsonEvents. */
+export declare function parseStreamJson(rawOutput: string): StreamJsonEvent[];
+/** Check if the first line of output looks like stream-json. */
+export declare function isStreamJsonOutput(firstLine: string): boolean;
+/** Reconstruct plain text from JSONL events for backward compat with spindle/detectPhase. */
+export declare function reconstructText(events: StreamJsonEvent[]): string;
+/** Extract compaction events from stream-json output. */
+export declare function detectCompactions(events: StreamJsonEvent[]): CompactionEvent[];
+/** Build per-tool token usage profiles from stream-json events. */
+export declare function buildToolProfiles(events: StreamJsonEvent[]): ToolTokenProfile[];
+/** Compute liveness metrics from event timestamps. */
+export declare function computeLiveness(events: StreamJsonEvent[], timestamps: number[]): LivenessSnapshot;
+/** Group raw tool calls into semantic steps. */
+export declare function decomposeSteps(events: StreamJsonEvent[]): SemanticStep[];
+/** Evaluate trigger rules against a trace analysis. */
+export declare function evaluateTriggers(analysis: Omit<TraceAnalysis, 'alerts'>, rules: TriggerRule[]): TriggerAlert[];
+/** Run full trace analysis on raw output. Falls back gracefully for plain text. */
+export declare function analyzeTrace(rawOutput: string, triggerRules?: TriggerRule[]): TraceAnalysis;
+//# sourceMappingURL=shared.d.ts.map

package/dist/trace/shared.d.ts.map

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

package/dist/trace/shared.js

@@ -0,0 +1,414 @@
+/**
+ * Execution Trace Analysis — pure functions, no I/O.
+ *
+ * Parses Claude Code `--output-format stream-json` JSONL output and extracts:
+ * 1. Compaction events (context limit hits)
+ * 2. Per-tool-call token profiles
+ * 3. Liveness / stall detection
+ * 4. Semantic step decomposition
+ * 5. Configurable trigger/alert evaluation
+ *
+ * Shared by @promptwheel/cli and @promptwheel/mcp.
+ */
+// ---------------------------------------------------------------------------
+// Parsing
+// ---------------------------------------------------------------------------
+/** Parse a single JSONL line into a StreamJsonEvent, or null if invalid. */
+export function parseStreamJsonLine(line) {
+    const trimmed = line.trim();
+    if (!trimmed || trimmed[0] !== '{')
+        return null;
+    try {
+        const obj = JSON.parse(trimmed);
+        if (typeof obj.type === 'string' && (obj.type === 'assistant' || obj.type === 'system' || obj.type === 'result')) {
+            return obj;
+        }
+        return null;
+    }
+    catch {
+        return null;
+    }
+}
+/** Parse raw multi-line output into an array of StreamJsonEvents. */
+export function parseStreamJson(rawOutput) {
+    if (!rawOutput)
+        return [];
+    const lines = rawOutput.split('\n');
+    const events = [];
+    for (const line of lines) {
+        const evt = parseStreamJsonLine(line);
+        if (evt)
+            events.push(evt);
+    }
+    return events;
+}
+/** Check if the first line of output looks like stream-json. */
+export function isStreamJsonOutput(firstLine) {
+    const trimmed = firstLine.trim();
+    if (!trimmed || trimmed[0] !== '{')
+        return false;
+    try {
+        const obj = JSON.parse(trimmed);
+        return typeof obj.type === 'string' && (obj.type === 'assistant' || obj.type === 'system' || obj.type === 'result');
+    }
+    catch {
+        return false;
+    }
+}
+/** Reconstruct plain text from JSONL events for backward compat with spindle/detectPhase. */
+export function reconstructText(events) {
+    const parts = [];
+    for (const evt of events) {
+        if (evt.message?.content) {
+            for (const block of evt.message.content) {
+                if (block.type === 'text') {
+                    parts.push(block.text);
+                }
+                else if (block.type === 'tool_result') {
+                    parts.push(block.content);
+                }
+            }
+        }
+    }
+    return parts.join('\n');
+}
+// ---------------------------------------------------------------------------
+// Feature 1: Compaction Detection
+// ---------------------------------------------------------------------------
+/** Extract compaction events from stream-json output. */
+export function detectCompactions(events) {
+    const compactions = [];
+    for (let i = 0; i < events.length; i++) {
+        const evt = events[i];
+        if (evt.type === 'system' && evt.subtype === 'compaction') {
+            const ce = {
+                timestamp_ms: Date.now(),
+                event_index: i,
+            };
+            // Extract token counts from the message if available
+            if (evt.message?.usage) {
+                ce.tokens_after = evt.message.usage.input_tokens;
+            }
+            // Look at previous assistant message for tokens_before
+            if (i > 0 && events[i - 1].message?.usage) {
+                ce.tokens_before = events[i - 1].message.usage.input_tokens + events[i - 1].message.usage.output_tokens;
+            }
+            compactions.push(ce);
+        }
+    }
+    return compactions;
+}
+// ---------------------------------------------------------------------------
+// Feature 2: Per-Tool-Call Token Profiles
+// ---------------------------------------------------------------------------
+/** Build per-tool token usage profiles from stream-json events. */
+export function buildToolProfiles(events) {
+    const profileMap = new Map();
+    // Track tool_use IDs to their tool names for matching with tool_results
+    const toolUseMap = new Map();
+    // Track cumulative token usage so we can compute deltas
+    let prevCumulativeInput = 0;
+    let prevCumulativeOutput = 0;
+    for (const evt of events) {
+        if (!evt.message?.content)
+            continue;
+        // Update cumulative tokens from this message's usage
+        const msgInputTokens = evt.message.usage?.input_tokens ?? 0;
+        const msgOutputTokens = evt.message.usage?.output_tokens ?? 0;
+        // Compute delta for this message
+        const inputDelta = msgInputTokens > prevCumulativeInput
+            ? msgInputTokens - prevCumulativeInput : 0;
+        const outputDelta = msgOutputTokens > prevCumulativeOutput
+            ? msgOutputTokens - prevCumulativeOutput : 0;
+        if (msgInputTokens > 0)
+            prevCumulativeInput = msgInputTokens;
+        if (msgOutputTokens > 0)
+            prevCumulativeOutput = msgOutputTokens;
+        // Count tool_use blocks and map their IDs
+        const toolUseBlocks = [];
+        for (const block of evt.message.content) {
+            if (block.type === 'tool_use') {
+                toolUseMap.set(block.id, block.name);
+                toolUseBlocks.push(block.name);
+                const p = profileMap.get(block.name) ?? { call_count: 0, total_input: 0, total_output: 0, error_count: 0 };
+                p.call_count++;
+                profileMap.set(block.name, p);
+            }
+            else if (block.type === 'tool_result') {
+                const toolName = toolUseMap.get(block.tool_use_id);
+                if (toolName && block.is_error) {
+                    const p = profileMap.get(toolName);
+                    if (p)
+                        p.error_count++;
+                }
+            }
+        }
+        // Distribute token delta across tool_use blocks in this message
+        if (toolUseBlocks.length > 0 && (inputDelta > 0 || outputDelta > 0)) {
+            const perToolInput = Math.floor(inputDelta / toolUseBlocks.length);
+            const perToolOutput = Math.floor(outputDelta / toolUseBlocks.length);
+            for (const name of toolUseBlocks) {
+                const p = profileMap.get(name);
+                p.total_input += perToolInput;
+                p.total_output += perToolOutput;
+            }
+        }
+    }
+    // Build sorted result
+    const profiles = [];
+    for (const [name, p] of profileMap) {
+        profiles.push({
+            tool_name: name,
+            call_count: p.call_count,
+            total_input_tokens: p.total_input,
+            total_output_tokens: p.total_output,
+            avg_input_tokens: p.call_count > 0 ? Math.round(p.total_input / p.call_count) : 0,
+            avg_output_tokens: p.call_count > 0 ? Math.round(p.total_output / p.call_count) : 0,
+            error_count: p.error_count,
+        });
+    }
+    // Sort by total tokens descending
+    profiles.sort((a, b) => (b.total_input_tokens + b.total_output_tokens) - (a.total_input_tokens + a.total_output_tokens));
+    return profiles;
+}
+// ---------------------------------------------------------------------------
+// Feature 3: Liveness Detection
+// ---------------------------------------------------------------------------
+const STALL_THRESHOLD_MS = 30_000;
+const IDLE_THRESHOLD_MS = 10_000;
+/** Compute liveness metrics from event timestamps. */
+export function computeLiveness(events, timestamps) {
+    if (timestamps.length <= 1) {
+        return {
+            total_duration_ms: 0,
+            event_count: timestamps.length,
+            avg_gap_ms: 0,
+            max_gap_ms: 0,
+            stall_periods: [],
+            idle_ratio: 0,
+        };
+    }
+    const totalDuration = timestamps[timestamps.length - 1] - timestamps[0];
+    const gaps = [];
+    for (let i = 1; i < timestamps.length; i++) {
+        gaps.push(timestamps[i] - timestamps[i - 1]);
+    }
+    const maxGap = Math.max(...gaps);
+    const avgGap = gaps.reduce((sum, g) => sum + g, 0) / gaps.length;
+    const stallPeriods = [];
+    let idleTime = 0;
+    for (let i = 1; i < timestamps.length; i++) {
+        const gap = timestamps[i] - timestamps[i - 1];
+        if (gap >= STALL_THRESHOLD_MS) {
+            stallPeriods.push({
+                start_ms: timestamps[i - 1],
+                end_ms: timestamps[i],
+                duration_ms: gap,
+            });
+        }
+        if (gap >= IDLE_THRESHOLD_MS) {
+            idleTime += gap;
+        }
+    }
+    return {
+        total_duration_ms: totalDuration,
+        event_count: timestamps.length,
+        avg_gap_ms: Math.round(avgGap),
+        max_gap_ms: maxGap,
+        stall_periods: stallPeriods,
+        idle_ratio: totalDuration > 0 ? Math.min(1, idleTime / totalDuration) : 0,
+    };
+}
+function classifyBlock(block) {
+    if (block.type === 'thinking')
+        return 'Planning';
+    if (block.type === 'text')
+        return 'Responding';
+    if (block.type === 'tool_use') {
+        const name = block.name;
+        if (name === 'Read' || name === 'Glob' || name === 'Grep')
+            return 'Reading files';
+        if (name === 'Edit' || name === 'Write' || name === 'NotebookEdit')
+            return 'Editing code';
+        if (name === 'Bash') {
+            const cmd = typeof block.input?.command === 'string' ? block.input.command : '';
+            const lower = cmd.toLowerCase();
+            if (lower.includes('test') || lower.includes('vitest') || lower.includes('jest') || lower.includes('pytest'))
+                return 'Running tests';
+            if (lower.includes('git '))
+                return 'Git operations';
+            return 'Running command';
+        }
+        if (name === 'WebSearch' || name === 'WebFetch')
+            return 'Searching';
+        return 'Running command';
+    }
+    return null;
+}
+/** Group raw tool calls into semantic steps. */
+export function decomposeSteps(events) {
+    const steps = [];
+    let currentCategory = null;
+    let currentTools = [];
+    let startIndex = 0;
+    for (let i = 0; i < events.length; i++) {
+        const evt = events[i];
+        if (!evt.message?.content)
+            continue;
+        for (const block of evt.message.content) {
+            const cat = classifyBlock(block);
+            if (!cat)
+                continue;
+            if (cat !== currentCategory) {
+                // Close previous step
+                if (currentCategory !== null) {
+                    steps.push({
+                        label: currentCategory,
+                        tool_calls: currentTools,
+                        start_index: startIndex,
+                        end_index: i,
+                    });
+                }
+                currentCategory = cat;
+                currentTools = [];
+                startIndex = i;
+            }
+            if (block.type === 'tool_use') {
+                currentTools.push(block.name);
+            }
+        }
+    }
+    // Close final step
+    if (currentCategory !== null) {
+        steps.push({
+            label: currentCategory,
+            tool_calls: currentTools,
+            start_index: startIndex,
+            end_index: events.length - 1,
+        });
+    }
+    return steps;
+}
+// ---------------------------------------------------------------------------
+// Feature 5: Trigger Evaluation
+// ---------------------------------------------------------------------------
+/** Evaluate trigger rules against a trace analysis. */
+export function evaluateTriggers(analysis, rules) {
+    const alerts = [];
+    const now = Date.now();
+    for (const rule of rules) {
+        let fired = false;
+        const cond = rule.condition;
+        switch (cond.type) {
+            case 'token_threshold':
+                fired = (analysis.total_input_tokens + analysis.total_output_tokens) > cond.threshold;
+                break;
+            case 'compaction_count':
+                fired = analysis.compactions.length >= cond.threshold;
+                break;
+            case 'error_pattern': {
+                const re = new RegExp(cond.pattern);
+                // Match pattern against tool names that have errors
+                for (const p of analysis.tool_profiles) {
+                    if (p.error_count > 0 && re.test(p.tool_name)) {
+                        fired = true;
+                        break;
+                    }
+                }
+                break;
+            }
+            case 'stall_duration_ms':
+                fired = analysis.liveness.max_gap_ms > cond.threshold;
+                break;
+            case 'tool_error_rate': {
+                const profile = analysis.tool_profiles.find(p => p.tool_name === cond.tool);
+                if (profile && profile.call_count > 0) {
+                    fired = (profile.error_count / profile.call_count) > cond.threshold;
+                }
+                break;
+            }
+        }
+        if (fired) {
+            alerts.push({
+                rule_id: rule.id,
+                rule_name: rule.name,
+                action: rule.action,
+                message: rule.message ?? `Trigger ${rule.name} fired`,
+                timestamp_ms: now,
+            });
+        }
+    }
+    return alerts;
+}
+// ---------------------------------------------------------------------------
+// Combined Analysis Pipeline
+// ---------------------------------------------------------------------------
+/** Run full trace analysis on raw output. Falls back gracefully for plain text. */
+export function analyzeTrace(rawOutput, triggerRules) {
+    const firstLine = rawOutput.split('\n')[0] ?? '';
+    const isJson = isStreamJsonOutput(firstLine);
+    if (!isJson) {
+        // Fallback: no structured data available
+        return {
+            compactions: [],
+            tool_profiles: [],
+            liveness: {
+                total_duration_ms: 0,
+                event_count: 0,
+                avg_gap_ms: 0,
+                max_gap_ms: 0,
+                stall_periods: [],
+                idle_ratio: 0,
+            },
+            steps: [],
+            alerts: [],
+            total_input_tokens: 0,
+            total_output_tokens: 0,
+            is_stream_json: false,
+        };
+    }
+    const events = parseStreamJson(rawOutput);
+    // Collect totals from result event or last assistant message
+    let totalInput = 0;
+    let totalOutput = 0;
+    let totalCost;
+    let model;
+    for (const evt of events) {
+        if (evt.message?.usage) {
+            // Usage fields are cumulative in stream-json — take the max
+            if (evt.message.usage.input_tokens > totalInput) {
+                totalInput = evt.message.usage.input_tokens;
+            }
+            if (evt.message.usage.output_tokens > totalOutput) {
+                totalOutput = evt.message.usage.output_tokens;
+            }
+        }
+        if (evt.message?.model) {
+            model = evt.message.model;
+        }
+        if (evt.result?.cost_usd !== undefined) {
+            totalCost = evt.result.cost_usd;
+        }
+    }
+    const compactions = detectCompactions(events);
+    const toolProfiles = buildToolProfiles(events);
+    // Generate synthetic timestamps for liveness (equally spaced as fallback)
+    const now = Date.now();
+    const timestamps = events.map((_, i) => now + i * 1000);
+    const liveness = computeLiveness(events, timestamps);
+    const steps = decomposeSteps(events);
+    const partial = {
+        compactions,
+        tool_profiles: toolProfiles,
+        liveness,
+        steps,
+        total_input_tokens: totalInput,
+        total_output_tokens: totalOutput,
+        total_cost_usd: totalCost,
+        model,
+        is_stream_json: true,
+    };
+    const alerts = evaluateTriggers(partial, triggerRules ?? []);
+    return { ...partial, alerts };
+}
+//# sourceMappingURL=shared.js.map

package/dist/trace/shared.js.map

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

package/dist/trajectory/shared.d.ts

@@ -0,0 +1,69 @@
+/**
+ * Pure trajectory algorithms — no filesystem.
+ *
+ * Shared by both @promptwheel/cli and @promptwheel/mcp.
+ * Callers handle file I/O (reading YAML files from .promptwheel/trajectories/).
+ *
+ * A trajectory is a DAG of ordered steps that the wheel follows across cycles.
+ * Each step constrains the scout's scope, categories, and acceptance criteria.
+ */
+export interface TrajectoryStep {
+    id: string;
+    title: string;
+    description: string;
+    scope?: string;
+    categories?: string[];
+    acceptance_criteria: string[];
+    verification_commands: string[];
+    depends_on: string[];
+    measure?: {
+        cmd: string;
+        target: number;
+        direction: 'up' | 'down';
+    };
+}
+export interface Trajectory {
+    name: string;
+    description: string;
+    steps: TrajectoryStep[];
+}
+export type StepStatus = 'pending' | 'active' | 'completed' | 'failed' | 'skipped';
+export interface StepState {
+    stepId: string;
+    status: StepStatus;
+    cyclesAttempted: number;
+    lastAttemptedCycle: number;
+    completedAt?: number;
+    failureReason?: string;
+    measurement?: {
+        value: number | null;
+        timestamp: number;
+    };
+}
+export interface TrajectoryState {
+    trajectoryName: string;
+    startedAt: number;
+    stepStates: Record<string, StepState>;
+    currentStepId: string | null;
+    paused: boolean;
+}
+/** Can this step start? All dependencies must be completed. */
+export declare function stepReady(step: TrajectoryStep, states: Record<string, StepState>): boolean;
+/** Pick next step: first ready step in declaration order that is pending or active. */
+export declare function getNextStep(trajectory: Trajectory, states: Record<string, StepState>): TrajectoryStep | null;
+/** All steps completed or skipped? */
+export declare function trajectoryComplete(trajectory: Trajectory, states: Record<string, StepState>): boolean;
+/** Stuck: current step has failed 3+ cycles with no progress. Returns stuck step ID or null. */
+export declare function trajectoryStuck(states: Record<string, StepState>, maxRetries?: number): string | null;
+/** Format trajectory context for scout prompt injection. */
+export declare function formatTrajectoryForPrompt(trajectory: Trajectory, states: Record<string, StepState>, currentStep: TrajectoryStep): string;
+/**
+ * Parse a trajectory YAML document into a Trajectory object.
+ * Handles the nested steps array with all fields.
+ */
+export declare function parseTrajectoryYaml(content: string): Trajectory;
+/** Create initial step states for a trajectory. */
+export declare function createInitialStepStates(trajectory: Trajectory): Record<string, StepState>;
+/** Serialize a Trajectory to YAML that parseTrajectoryYaml can round-trip. */
+export declare function serializeTrajectoryToYaml(trajectory: Trajectory): string;
+//# sourceMappingURL=shared.d.ts.map

package/dist/trajectory/shared.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"shared.d.ts","sourceRoot":"","sources":["../../src/trajectory/shared.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAMH,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,mBAAmB,EAAE,MAAM,EAAE,CAAC;IAC9B,qBAAqB,EAAE,MAAM,EAAE,CAAC;IAChC,UAAU,EAAE,MAAM,EAAE,CAAC;IACrB,OAAO,CAAC,EAAE;QACR,GAAG,EAAE,MAAM,CAAC;QACZ,MAAM,EAAE,MAAM,CAAC;QACf,SAAS,EAAE,IAAI,GAAG,MAAM,CAAC;KAC1B,CAAC;CACH;AAED,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,cAAc,EAAE,CAAC;CACzB;AAED,MAAM,MAAM,UAAU,GAAG,SAAS,GAAG,QAAQ,GAAG,WAAW,GAAG,QAAQ,GAAG,SAAS,CAAC;AAEnF,MAAM,WAAW,SAAS;IACxB,MAAM,EAAE,MAAM,CAAC;IACf,MAAM,EAAE,UAAU,CAAC;IACnB,eAAe,EAAE,MAAM,CAAC;IACxB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE;QAAE,KAAK,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,SAAS,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3D;AAED,MAAM,WAAW,eAAe;IAC9B,cAAc,EAAE,MAAM,CAAC;IACvB,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAAC;IACtC,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,MAAM,EAAE,OAAO,CAAC;CACjB;AAQD,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,IAAI,EAAE,cAAc,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,OAAO,CAM1F;AAED,uFAAuF;AACvF,wBAAgB,WAAW,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,cAAc,GAAG,IAAI,CAQ5G;AAED,sCAAsC;AACtC,wBAAgB,kBAAkB,CAAC,UAAU,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,GAAG,OAAO,CAOrG;AAED,gGAAgG;AAChG,wBAAgB,eAAe,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EAAE,UAAU,GAAE,MAA4B,GAAG,MAAM,GAAG,IAAI,CAO1H;AAED,4DAA4D;AAC5D,wBAAgB,yBAAyB,CACvC,UAAU,EAAE,UAAU,EACtB,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,EACjC,WAAW,EAAE,cAAc,GAC1B,MAAM,CAkER;AAMD;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,OAAO,EAAE,MAAM,GAAG,UAAU,CA8J/D;AAYD,mDAAmD;AACnD,wBAAgB,uBAAuB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAAC,MAAM,EAAE,SAAS,CAAC,CAWzF;AAMD,8EAA8E;AAC9E,wBAAgB,yBAAyB,CAAC,UAAU,EAAE,UAAU,GAAG,MAAM,CAmCxE"}