@slope-dev/slope 1.35.0 → 1.37.0

package/dist/core/workflow-engine.js

@@ -0,0 +1,223 @@
+// SLOPE — Workflow Execution Engine
+// Controls step ordering, validates state transitions, and persists execution state.
+// --- State Machine ---
+/** Valid status transitions for workflow executions */
+const VALID_TRANSITIONS = {
+    running: ['paused', 'completed', 'failed'],
+    paused: ['running', 'failed'],
+    completed: [],
+    failed: [],
+};
+function isValidTransition(from, to) {
+    return VALID_TRANSITIONS[from]?.includes(to) ?? false;
+}
+// --- Engine ---
+export class WorkflowEngine {
+    /**
+     * Start a new workflow execution.
+     * Creates a store record and positions at the first step of the first phase.
+     */
+    async start(def, store, opts = {}) {
+        if (def.phases.length === 0) {
+            throw new Error('Workflow has no phases');
+        }
+        const firstPhase = def.phases[0];
+        if (firstPhase.steps.length === 0) {
+            throw new Error(`Phase "${firstPhase.id}" has no steps`);
+        }
+        const execution = await store.startExecution({
+            workflow_name: def.name,
+            sprint_id: opts.sprint_id,
+            variables: opts.variables,
+            session_id: opts.session_id,
+        });
+        // Position at first step
+        await store.updateExecutionState(execution.id, firstPhase.id, firstPhase.steps[0].id);
+        return {
+            ...execution,
+            current_phase: firstPhase.id,
+            current_step: firstPhase.steps[0].id,
+        };
+    }
+    /**
+     * Determine what should happen next for an execution.
+     * Returns the current step to execute, or is_complete if done.
+     */
+    async next(executionId, def, store) {
+        const execution = await this.requireExecution(executionId, store);
+        if (execution.status === 'completed') {
+            return { is_complete: true };
+        }
+        if (execution.status === 'failed') {
+            throw new Error(`Workflow execution "${executionId}" has failed`);
+        }
+        if (execution.status === 'paused') {
+            throw new Error(`Workflow execution "${executionId}" is paused — resume before calling next()`);
+        }
+        // Find the next incomplete step
+        return this.findNextStep(execution, def);
+    }
+    /**
+     * Complete a step and advance the execution.
+     * Records the step result and moves to the next step/phase.
+     */
+    async complete(executionId, stepId, result, def, store) {
+        const execution = await this.requireExecution(executionId, store);
+        this.validateCurrentStep(execution, stepId);
+        // Determine current item for repeat_for phases
+        const currentInfo = this.findNextStep(execution, def);
+        await store.recordStepResult({
+            execution_id: executionId,
+            step_id: stepId,
+            phase: execution.current_phase,
+            status: 'completed',
+            output: result.output,
+            exit_code: result.exit_code,
+            item: currentInfo.current_item,
+            started_at: result.started_at,
+        });
+        return this.advanceToNext(executionId, execution, def, store);
+    }
+    /**
+     * Skip a step and advance. Skipped steps count as "done" for phase advancement.
+     */
+    async skip(executionId, stepId, reason, def, store) {
+        const execution = await this.requireExecution(executionId, store);
+        this.validateCurrentStep(execution, stepId);
+        // Determine current item for repeat_for phases
+        const currentInfo = this.findNextStep(execution, def);
+        await store.recordStepResult({
+            execution_id: executionId,
+            step_id: stepId,
+            phase: execution.current_phase,
+            status: 'skipped',
+            output: { reason },
+            item: currentInfo.current_item,
+        });
+        return this.advanceToNext(executionId, execution, def, store);
+    }
+    /**
+     * Transition execution status (e.g., fail).
+     * Validates the transition against the state machine.
+     * Note: pause/resume will be added in S4 when the loop bridge needs signal handling.
+     */
+    async fail(executionId, store) {
+        const execution = await this.requireExecution(executionId, store);
+        if (!isValidTransition(execution.status, 'failed')) {
+            throw new Error(`Invalid workflow transition: "${execution.status}" → "failed". ` +
+                `Valid transitions from "${execution.status}": ${VALID_TRANSITIONS[execution.status]?.join(', ') || 'none'}`);
+        }
+        await store.completeExecution(executionId, 'failed');
+    }
+    // --- Private helpers ---
+    async requireExecution(id, store) {
+        const execution = await store.getExecution(id);
+        if (!execution) {
+            throw new Error(`Workflow execution "${id}" not found`);
+        }
+        return execution;
+    }
+    validateCurrentStep(execution, stepId) {
+        if (execution.status !== 'running') {
+            throw new Error(`Cannot complete step on execution with status "${execution.status}" — must be "running"`);
+        }
+        if (execution.current_step !== stepId) {
+            throw new Error(`Step mismatch: execution is at "${execution.current_step}" but "${stepId}" was provided`);
+        }
+    }
+    /**
+     * Find the next incomplete step in the workflow.
+     * Handles repeat_for phases by expanding the iteration.
+     */
+    findNextStep(execution, def) {
+        const completedSet = new Set(execution.completed_steps.map((s) => `${s.phase}:${s.step_id}${s.item ? ':' + s.item : ''}`));
+        for (const phase of def.phases) {
+            if (phase.repeat_for) {
+                // Expand the repeat_for phase
+                const items = this.getRepeatItems(phase.repeat_for, execution.variables);
+                for (let itemIdx = 0; itemIdx < items.length; itemIdx++) {
+                    const item = items[itemIdx];
+                    for (const step of phase.steps) {
+                        const key = `${phase.id}:${step.id}:${item}`;
+                        if (!completedSet.has(key)) {
+                            return {
+                                is_complete: false,
+                                phase: phase.id,
+                                step,
+                                current_item: item,
+                                total_items: items.length,
+                                item_index: itemIdx,
+                            };
+                        }
+                    }
+                }
+            }
+            else {
+                for (const step of phase.steps) {
+                    const key = `${phase.id}:${step.id}`;
+                    if (!completedSet.has(key)) {
+                        return {
+                            is_complete: false,
+                            phase: phase.id,
+                            step,
+                        };
+                    }
+                }
+            }
+        }
+        return { is_complete: true };
+    }
+    /**
+     * After completing/skipping a step, advance to the next step or complete the workflow.
+     */
+    async advanceToNext(executionId, _execution, def, store) {
+        // Re-fetch execution to get updated completed_steps
+        const updated = await this.requireExecution(executionId, store);
+        const nextInfo = this.findNextStep(updated, def);
+        if (nextInfo.is_complete) {
+            await store.completeExecution(executionId, 'completed');
+            return { is_complete: true };
+        }
+        await store.updateExecutionState(executionId, nextInfo.phase, nextInfo.step.id);
+        return {
+            advanced_to: { phase: nextInfo.phase, step: nextInfo.step.id },
+            is_complete: false,
+            next_action: this.describeStep(nextInfo.step),
+        };
+    }
+    /**
+     * Get the items to iterate over for a repeat_for phase.
+     * Looks up the variable name and splits comma-separated values or parses JSON array.
+     */
+    getRepeatItems(variableName, variables) {
+        const value = variables[variableName];
+        if (!value)
+            return [];
+        // Try JSON array first
+        try {
+            const parsed = JSON.parse(value);
+            if (Array.isArray(parsed))
+                return parsed.map(String);
+        }
+        catch {
+            // Not JSON — treat as comma-separated
+        }
+        return value.split(',').map(s => s.trim()).filter(Boolean);
+    }
+    /** Human-readable description of what a step expects */
+    describeStep(step) {
+        switch (step.type) {
+            case 'command':
+                return `Run command: ${step.command}`;
+            case 'validation':
+                return `Validate: ${step.conditions?.join(', ') ?? step.prompt ?? step.id}`;
+            case 'agent_input':
+                return `Provide input: ${step.required_fields?.join(', ') ?? step.prompt ?? step.id}`;
+            case 'agent_work':
+                return `${step.prompt ?? `Execute: ${step.id}`}`;
+            default:
+                return step.id;
+        }
+    }
+}
+//# sourceMappingURL=workflow-engine.js.map

package/dist/core/workflow-engine.js.map

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

package/dist/core/workflow-loader.d.ts

@@ -0,0 +1,21 @@
+import type { WorkflowDefinition } from './workflow.js';
+/** Summary of an available workflow */
+export interface WorkflowSummary {
+    name: string;
+    description?: string;
+    version: string;
+    source: 'project' | 'built-in';
+    path: string;
+}
+/**
+ * Load a workflow by name.
+ * Search order: project `.slope/workflows/<name>.yaml` → built-in defaults.
+ * Throws if not found.
+ */
+export declare function loadWorkflow(name: string, cwd: string): WorkflowDefinition;
+/**
+ * List all available workflows (project + built-in).
+ * Project workflows override built-in ones with the same name.
+ */
+export declare function listWorkflows(cwd: string): WorkflowSummary[];
+//# sourceMappingURL=workflow-loader.d.ts.map

package/dist/core/workflow-loader.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-loader.d.ts","sourceRoot":"","sources":["../../src/core/workflow-loader.ts"],"names":[],"mappings":"AAOA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,eAAe,CAAC;AAIxD,uCAAuC;AACvC,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,EAAE,SAAS,GAAG,UAAU,CAAC;IAC/B,IAAI,EAAE,MAAM,CAAC;CACd;AAqBD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,GAAG,kBAAkB,CAuB1E;AAED;;;GAGG;AACH,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,eAAe,EAAE,CA4C5D"}

package/dist/core/workflow-loader.js

@@ -0,0 +1,110 @@
+// SLOPE — Workflow Loader
+// Loads workflow definitions from project and built-in locations.
+import { readFileSync, existsSync, readdirSync } from 'node:fs';
+import { join, basename, dirname } from 'node:path';
+import { fileURLToPath } from 'node:url';
+import { parseWorkflow } from './workflow.js';
+const __dirname = dirname(fileURLToPath(import.meta.url));
+/** Resolve the built-in workflows directory (handles both src/ and dist/) */
+function builtinDir() {
+    // In src/core/ → ../core/workflows
+    // In dist/core/ → ../../src/core/workflows
+    const srcPath = join(__dirname, 'workflows');
+    if (existsSync(srcPath))
+        return srcPath;
+    // If running from dist/, walk up to find src/
+    const fromDist = join(__dirname, '..', '..', 'src', 'core', 'workflows');
+    if (existsSync(fromDist))
+        return fromDist;
+    return srcPath; // fallback
+}
+/** Resolve the project workflows directory */
+function projectDir(cwd) {
+    return join(cwd, '.slope', 'workflows');
+}
+/**
+ * Load a workflow by name.
+ * Search order: project `.slope/workflows/<name>.yaml` → built-in defaults.
+ * Throws if not found.
+ */
+export function loadWorkflow(name, cwd) {
+    // Normalize: strip .yaml if provided
+    const baseName = name.replace(/\.yaml$/, '');
+    const fileName = `${baseName}.yaml`;
+    // 1. Project directory
+    const projectPath = join(projectDir(cwd), fileName);
+    if (existsSync(projectPath)) {
+        return parseYamlFile(projectPath);
+    }
+    // 2. Built-in defaults
+    const builtinPath = join(builtinDir(), fileName);
+    if (existsSync(builtinPath)) {
+        return parseYamlFile(builtinPath);
+    }
+    throw new Error(`Workflow "${baseName}" not found. Searched:\n` +
+        `  - ${projectPath}\n` +
+        `  - ${builtinPath}\n` +
+        `Use "slope workflow list" to see available workflows.`);
+}
+/**
+ * List all available workflows (project + built-in).
+ * Project workflows override built-in ones with the same name.
+ */
+export function listWorkflows(cwd) {
+    const summaries = new Map();
+    // Built-in workflows (loaded first, can be overridden)
+    const builtIn = builtinDir();
+    if (existsSync(builtIn)) {
+        for (const file of listYamlFiles(builtIn)) {
+            const name = basename(file, '.yaml');
+            try {
+                const def = parseYamlFile(join(builtIn, file));
+                summaries.set(name, {
+                    name: def.name,
+                    description: def.description,
+                    version: def.version,
+                    source: 'built-in',
+                    path: join(builtIn, file),
+                });
+            }
+            catch {
+                // Skip invalid built-in files
+            }
+        }
+    }
+    // Project workflows (override built-in)
+    const project = projectDir(cwd);
+    if (existsSync(project)) {
+        for (const file of listYamlFiles(project)) {
+            const name = basename(file, '.yaml');
+            try {
+                const def = parseYamlFile(join(project, file));
+                summaries.set(name, {
+                    name: def.name,
+                    description: def.description,
+                    version: def.version,
+                    source: 'project',
+                    path: join(project, file),
+                });
+            }
+            catch {
+                // Skip invalid project files
+            }
+        }
+    }
+    return [...summaries.values()].sort((a, b) => a.name.localeCompare(b.name));
+}
+// --- Helpers ---
+function parseYamlFile(filePath) {
+    const content = readFileSync(filePath, 'utf8');
+    return parseWorkflow(content);
+}
+function listYamlFiles(dir) {
+    try {
+        return readdirSync(dir).filter(f => f.endsWith('.yaml'));
+    }
+    catch {
+        return [];
+    }
+}
+//# sourceMappingURL=workflow-loader.js.map

package/dist/core/workflow-loader.js.map

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

package/dist/core/workflow-validator.d.ts

@@ -0,0 +1,19 @@
+import type { WorkflowDefinition } from './workflow.js';
+/** A single validation error or warning */
+export interface ValidationIssue {
+    message: string;
+    /** Dot-path to the problematic element (e.g., "phases[0].steps[1]") */
+    path?: string;
+}
+/** Result of validating a workflow definition */
+export interface WorkflowValidationResult {
+    valid: boolean;
+    errors: ValidationIssue[];
+    warnings: ValidationIssue[];
+}
+/**
+ * Validate a parsed WorkflowDefinition for structural issues.
+ * Does NOT re-validate YAML parsing — assumes parseWorkflow() already succeeded.
+ */
+export declare function validateWorkflow(def: WorkflowDefinition): WorkflowValidationResult;
+//# sourceMappingURL=workflow-validator.d.ts.map

package/dist/core/workflow-validator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow-validator.d.ts","sourceRoot":"","sources":["../../src/core/workflow-validator.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,kBAAkB,EAAgB,MAAM,eAAe,CAAC;AAGtE,2CAA2C;AAC3C,MAAM,WAAW,eAAe;IAC9B,OAAO,EAAE,MAAM,CAAC;IAChB,uEAAuE;IACvE,IAAI,CAAC,EAAE,MAAM,CAAC;CACf;AAED,iDAAiD;AACjD,MAAM,WAAW,wBAAwB;IACvC,KAAK,EAAE,OAAO,CAAC;IACf,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,QAAQ,EAAE,eAAe,EAAE,CAAC;CAC7B;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,kBAAkB,GAAG,wBAAwB,CA6HlF"}

package/dist/core/workflow-validator.js

@@ -0,0 +1,166 @@
+// SLOPE — Workflow Validator
+// Validates WorkflowDefinitions for structural correctness before execution.
+import { VALID_STEP_TYPES } from './workflow.js';
+/**
+ * Validate a parsed WorkflowDefinition for structural issues.
+ * Does NOT re-validate YAML parsing — assumes parseWorkflow() already succeeded.
+ */
+export function validateWorkflow(def) {
+    const errors = [];
+    const warnings = [];
+    // Version check
+    if (def.version !== '1') {
+        errors.push({ message: `Unsupported workflow version: "${def.version}" (expected "1")` });
+    }
+    // Name check
+    if (!def.name || def.name.trim().length === 0) {
+        errors.push({ message: 'Workflow name must be a non-empty string' });
+    }
+    // Collect all step IDs for uniqueness check
+    const allStepIds = new Map(); // step_id → phase_id
+    // Collect all variable references found in steps
+    const referencedVars = new Set();
+    const definedVars = new Set(Object.keys(def.variables ?? {}));
+    if (def.phases.length === 0) {
+        warnings.push({ message: 'Workflow has no phases' });
+    }
+    // Phase-level checks
+    const phaseIds = new Set();
+    for (let pi = 0; pi < def.phases.length; pi++) {
+        const phase = def.phases[pi];
+        const pPath = `phases[${pi}]`;
+        // Duplicate phase ID
+        if (phaseIds.has(phase.id)) {
+            errors.push({ message: `Duplicate phase ID: "${phase.id}"`, path: pPath });
+        }
+        phaseIds.add(phase.id);
+        // Empty steps
+        if (phase.steps.length === 0) {
+            warnings.push({ message: `Phase "${phase.id}" has no steps`, path: pPath });
+        }
+        // repeat_for variable reference
+        if (phase.repeat_for) {
+            referencedVars.add(phase.repeat_for);
+            if (definedVars.size > 0 && !definedVars.has(phase.repeat_for)) {
+                warnings.push({
+                    message: `Phase "${phase.id}" references variable "${phase.repeat_for}" in repeat_for, but it is not defined in variables`,
+                    path: `${pPath}.repeat_for`,
+                });
+            }
+            // on_timeout only makes sense with repeat_for
+            if (phase.timeout_per_item && !phase.on_timeout) {
+                warnings.push({
+                    message: `Phase "${phase.id}" has timeout_per_item but no on_timeout behavior`,
+                    path: `${pPath}.on_timeout`,
+                });
+            }
+        }
+        else {
+            // on_timeout without repeat_for
+            if (phase.on_timeout) {
+                warnings.push({
+                    message: `Phase "${phase.id}" has on_timeout but no repeat_for — on_timeout is ignored`,
+                    path: `${pPath}.on_timeout`,
+                });
+            }
+        }
+        // Step-level checks
+        for (let si = 0; si < phase.steps.length; si++) {
+            const step = phase.steps[si];
+            const sPath = `${pPath}.steps[${si}]`;
+            // Duplicate step ID across all phases
+            if (allStepIds.has(step.id)) {
+                errors.push({
+                    message: `Duplicate step ID: "${step.id}" (also in phase "${allStepIds.get(step.id)}")`,
+                    path: sPath,
+                });
+            }
+            allStepIds.set(step.id, phase.id);
+            // Valid step type
+            if (!VALID_STEP_TYPES.has(step.type)) {
+                errors.push({
+                    message: `Invalid step type: "${step.type}"`,
+                    path: `${sPath}.type`,
+                });
+            }
+            // Type-specific validation
+            validateStepByType(step, sPath, errors, warnings);
+            // blocks_next on terminal step is redundant
+            if (step.blocks_next && si === phase.steps.length - 1) {
+                warnings.push({
+                    message: `Step "${step.id}" has blocks_next but is the last step in its phase — this is redundant`,
+                    path: `${sPath}.blocks_next`,
+                });
+            }
+            // Collect variable references from string fields
+            collectVarRefs(step.command, referencedVars);
+            collectVarRefs(step.prompt, referencedVars);
+            if (step.rules)
+                step.rules.forEach(r => collectVarRefs(r, referencedVars));
+            if (step.conditions)
+                step.conditions.forEach(c => collectVarRefs(c, referencedVars));
+        }
+    }
+    // Warn about unreferenced variables
+    for (const varName of definedVars) {
+        if (!referencedVars.has(varName)) {
+            warnings.push({
+                message: `Variable "${varName}" is defined but never referenced`,
+                path: `variables.${varName}`,
+            });
+        }
+    }
+    return {
+        valid: errors.length === 0,
+        errors,
+        warnings,
+    };
+}
+/** Validate type-specific step requirements */
+function validateStepByType(step, path, errors, warnings) {
+    switch (step.type) {
+        case 'command':
+            if (!step.command) {
+                errors.push({
+                    message: `Command step "${step.id}" must have a "command" field`,
+                    path: `${path}.command`,
+                });
+            }
+            break;
+        case 'validation':
+            if (!step.conditions?.length && !step.command) {
+                warnings.push({
+                    message: `Validation step "${step.id}" has no conditions or command — it will always pass`,
+                    path,
+                });
+            }
+            break;
+        case 'agent_input':
+            if (!step.required_fields?.length && !step.prompt) {
+                warnings.push({
+                    message: `Agent input step "${step.id}" has no required_fields or prompt`,
+                    path,
+                });
+            }
+            break;
+        case 'agent_work':
+            if (!step.prompt && !step.rules?.length) {
+                warnings.push({
+                    message: `Agent work step "${step.id}" has no prompt or rules — agent has no guidance`,
+                    path,
+                });
+            }
+            break;
+    }
+}
+/** Extract ${varName} references from a string */
+function collectVarRefs(str, refs) {
+    if (!str)
+        return;
+    const pattern = /\$\{([a-zA-Z_][a-zA-Z0-9_]*)\}/g;
+    let match;
+    while ((match = pattern.exec(str)) !== null) {
+        refs.add(match[1]);
+    }
+}
+//# sourceMappingURL=workflow-validator.js.map

package/dist/core/workflow-validator.js.map

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

package/dist/core/workflow.d.ts

@@ -0,0 +1,51 @@
+/** Variable definition for workflow parameterization */
+export interface WorkflowVariable {
+    required?: boolean;
+    type?: 'string' | 'integer' | 'array';
+    pattern?: string;
+    default?: string;
+}
+/** A single step within a workflow phase */
+export interface WorkflowStep {
+    id: string;
+    type: 'command' | 'validation' | 'agent_input' | 'agent_work';
+    prompt?: string;
+    command?: string;
+    checkpoint?: string;
+    blocks_next?: boolean;
+    rules?: string[];
+    required_fields?: string[];
+    /** Validation conditions (for type=validation) */
+    conditions?: string[];
+}
+/** A phase containing ordered steps */
+export interface WorkflowPhase {
+    id: string;
+    steps: WorkflowStep[];
+    /** Variable name containing array to iterate over */
+    repeat_for?: string;
+    /** Timeout in seconds for each repeated item */
+    timeout_per_item?: number;
+    /** Behavior when a repeated item times out */
+    on_timeout?: 'fail' | 'log_blocker_and_skip';
+}
+/** Top-level workflow definition */
+export interface WorkflowDefinition {
+    name: string;
+    version: string;
+    description?: string;
+    variables?: Record<string, WorkflowVariable>;
+    phases: WorkflowPhase[];
+}
+/** Parse a YAML string into a WorkflowDefinition. Throws on invalid structure. */
+export declare function parseWorkflow(yaml: string): WorkflowDefinition;
+/** Valid step types for workflow definitions. Shared with the validator. */
+export declare const VALID_STEP_TYPES: Set<string>;
+/**
+ * Resolve `${varName}` references in all string values of a workflow definition.
+ * - Top-level string keys only (no nesting like `${x.y}`)
+ * - Missing variable at resolve time → error
+ * - Escaped `\${literal}` → `${literal}`
+ */
+export declare function resolveVariables(def: WorkflowDefinition, vars: Record<string, string>): WorkflowDefinition;
+//# sourceMappingURL=workflow.d.ts.map

package/dist/core/workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"workflow.d.ts","sourceRoot":"","sources":["../../src/core/workflow.ts"],"names":[],"mappings":"AAOA,wDAAwD;AACxD,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,EAAE,OAAO,CAAC;IACnB,IAAI,CAAC,EAAE,QAAQ,GAAG,SAAS,GAAG,OAAO,CAAC;IACtC,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,4CAA4C;AAC5C,MAAM,WAAW,YAAY;IAC3B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,SAAS,GAAG,YAAY,GAAG,aAAa,GAAG,YAAY,CAAC;IAC9D,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;IACjB,eAAe,CAAC,EAAE,MAAM,EAAE,CAAC;IAC3B,kDAAkD;IAClD,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;CACvB;AAED,uCAAuC;AACvC,MAAM,WAAW,aAAa;IAC5B,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,gDAAgD;IAChD,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,8CAA8C;IAC9C,UAAU,CAAC,EAAE,MAAM,GAAG,sBAAsB,CAAC;CAC9C;AAED,oCAAoC;AACpC,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC7C,MAAM,EAAE,aAAa,EAAE,CAAC;CACzB;AAID,kFAAkF;AAClF,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,CA0C9D;AAuBD,4EAA4E;AAC5E,eAAO,MAAM,gBAAgB,aAAkE,CAAC;AAoEhG;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAC9B,GAAG,EAAE,kBAAkB,EACvB,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAC3B,kBAAkB,CA0CpB"}