maistro 1.0.402 → 1.0.410

package/README.md

@@ -1,106 +1,143 @@
-# Maistro
+# mAIstro
 
-AI-powered CLI that breaks down complex projects into tasks and executes them automatically via Claude Code. Describe your goal, review the plan, then let it run autonomously - validating results and committing changes after each task.
+```
+    ▓▓▓▓
+   ██  ██   █▀▀▀█
+   █ ▀▀ █  █▌█ █▐█
+  ▐█    █▌  █▄▄▄█
+   █░░░░█    ▀ ▀
+   ██  ██
+```
 
-## Prerequisites
+A small CLI for orchestrating Claude Code tasks when one-shot prompts and limited context aren't enough.
 
-### 1. Node.js 18+
+mAIstro helps you break large work into explicit, sequential steps, keeping important requirements visible as tasks execute — so Claude Code doesn't lose context or skip constraints.
 
-Download from [nodejs.org](https://nodejs.org/)
+This is a free tool built to scratch a personal itch and shared for feedback.
 
-### 2. Claude Code CLI
+## Why mAIstro exists
 
-Install & authenticate Claude Code
+Claude Code works well for focused tasks.
+It becomes harder when:
 
-```bash
-npm install -g @anthropic-ai/claude-code
-claude
-```
+- tasks grow beyond a single prompt
+- important requirements fall out of context
+- earlier decisions get forgotten mid-execution
+- the model "optimizes away" steps you actually need
+
+mAIstro introduces a thin orchestration layer that:
+
+- controls execution order
+- limits active context per step
+- keeps critical constraints explicit
+
+This makes larger tasks more reliable without increasing prompt complexity.
+
+## What it does
+
+- Breaks large work into bounded tasks
+- Executes tasks sequentially
+- Keeps only relevant context active per step
+- Preserves requirements and constraints across steps
+- Keeps task status visible while execution progresses
+- Allows human intervention between tasks
+
+## What it does not do
+
+- No web UI
+- No SaaS backend
+- No long-term memory system
+- No autonomous "set it and forget it" agents
+
+mAIstro is intentionally small and explicit.
 
 ## Installation
 
+Install globally:
+
 ```bash
 npm install -g maistro
 ```
 
-## Update
-
-```bash
-npm update -g maistro
-```
+## Basic usage
 
-## Usage
+Run mAIstro from your project directory:
 
 ```bash
 maistro
 ```
 
-This launches the interactive mode where you can:
+Typical flow:
 
-1. **Describe your goal** - Enter what you want to build or accomplish
-2. **Answer questions** - Maistro asks clarifying questions to understand your project
-3. **Review the plan** - See the generated task breakdown before execution
-4. **Refine if needed** - Chat to modify tasks, reorder, or add details
-5. **Execute** - Watch as tasks are executed, validated, and committed
+1. Describe your goal or project
+2. mAIstro analyzes and breaks it into bounded tasks
+3. Review and refine the plan
+4. Tasks execute one at a time
+5. Each step sees only the context it needs
+6. Requirements stay visible throughout execution
 
-## Commands
+## Example use cases
 
-During execution, you can type commands in the input bar:
+- Large refactors with strict constraints
+- Multi-step feature implementation
+- Codebase analysis → planning → execution
+- Any workflow where losing context breaks correctness
 
-| Command | Action |
-|---------|--------|
-| `run` | Start or resume execution |
-| `plan` | View and modify the task plan |
-| `retry` | Retry a failed task |
-| `claude` | Open Claude Code in a new terminal |
-| `exit` | Exit maistro |
+## Design principles
 
-## Keyboard Shortcuts
+- Context discipline over giant prompts
+- Explicit sequencing over autonomy
+- CLI-first and inspectable
+- Human-in-the-loop by default
 
-| Key | Action |
-|-----|--------|
-| `Enter` | Submit input |
-| `Shift+Enter` | New line in input |
-| `Up/Down` | Navigate input history |
-| `Escape` (2x) | Clear input |
+## Who this is for
 
-## Project Files
+- Developers already using Claude Code
+- People hitting context limits on larger tasks
+- Anyone tired of repeating requirements in every prompt
 
-Maistro stores project state in `.maistro/` directory:
-- `state.json` - Task list and progress
-- `logs/` - Execution logs per task
-- `images/` - Attached images (if any)
+If you want a fully autonomous agent with hidden state, this is probably not it.
 
-Add `.maistro/` to your `.gitignore` if you don't want to track execution state.
+## Status
 
+- actively used
+- lightly tested
+- evolving through real-world workflows
 
-## How It Works
+Expect rough edges.
 
-Maistro uses Claude Code CLI to execute each task on your plan. Tasks run non-interactively with:
+## Claude Code
 
-```
+### How Integration Works
+
+mAIstro uses Claude Code CLI to execute each task on your plan. Tasks run non-interactively with:
+
+```bash
 claude --dangerously-skip-permissions --chrome
 ```
 
 - `--dangerously-skip-permissions` - Allows autonomous execution without confirmation prompts
 - `--chrome` - Enables browser integration for real-time feedback via Chrome extension
 
-> **Warning:** Once execution starts, Maistro runs autonomously without confirmation prompts. It will attempt to complete all tasks on the plan without asking for permission. Use responsibly and preferably in sandboxed environments (containers, VMs, or isolated directories).
+> **Warning:** Once execution starts, mAIstro runs autonomously without confirmation prompts. It will attempt to complete all tasks on the plan without asking for permission. Use responsibly and preferably in sandboxed environments (containers, VMs, or isolated directories).
 
 ### Claude Code Chrome Extension (Recommended)
 
 For the fastest feedback loop, install the Chrome extension:
 
-**[Claude Code Chrome Extension](https://chromewebstore.google.com/detail/claude-code/ilfhajpgbakchaddgjdkmipfmongogon)**
+[Claude Code Chrome Extension](https://chromewebstore.google.com/detail/claude-code/oadoelpjdnpbmmdfgpmfnncjgihofjgc)
 
 This enables real-time browser automation and visual feedback during task execution.
 
+## Feedback
+
+This tool exists to answer one question:
 
-## Support
+> Does explicit orchestration help manage Claude Code context for larger tasks?
 
-Questions or issues? Contact support@dreamteam-mobile.com
+If you try it and decide the answer is "no", that feedback is just as valuable.
 
-> **Note:** Maistro should work on macOS, Linux, and Windows, but has only been tested on macOS. If you encounter platform-specific issues, please reach out.
+Issues, ideas, and criticism are welcome. Send them my way at contact@dreamteam-mobile.com
 
 ## License
 

package/dist/apiKeyValidator.d.ts

@@ -0,0 +1,58 @@
+/**
+ * API Key Validator - validates user-provided API keys against their respective services
+ *
+ * Design principles:
+ * - Never block the user: network/timeout errors result in skipped validation, not failure
+ * - Lightweight: uses minimal read-only endpoints
+ * - Graceful: unknown key types are skipped with informative messages
+ */
+/**
+ * Result of validating a single API key
+ */
+export interface ValidationResult {
+    /** Whether the key is valid (true if valid or skipped) */
+    valid: boolean;
+    /** Human-readable status message */
+    message: string;
+    /** Error details if validation failed */
+    error?: string;
+    /** Whether validation was skipped (timeout, network error, unknown key type) */
+    skipped?: boolean;
+}
+/**
+ * Aggregated validation results
+ */
+export interface ValidationSummary {
+    /** All validation results keyed by env var name */
+    results: Record<string, ValidationResult>;
+    /** Number of keys that passed validation */
+    passedCount: number;
+    /** Number of keys that failed validation */
+    failedCount: number;
+    /** Number of keys where validation was skipped */
+    skippedCount: number;
+    /** Whether all validated keys passed (excludes skipped) */
+    allPassed: boolean;
+}
+/**
+ * Options for validateApiKeys function
+ */
+export interface ValidateApiKeysOptions {
+    /** Timeout for each validation request in ms (default: 5000) */
+    timeout?: number;
+}
+/**
+ * Validator function type for a specific service
+ */
+type KeyValidator = (value: string, timeout: number) => Promise<ValidationResult>;
+/**
+ * Validate multiple API keys in parallel
+ *
+ * @param values - Record of env var names to their values
+ * @param options - Validation options
+ * @returns Summary of validation results
+ */
+export declare function validateApiKeys(values: Record<string, string>, options?: ValidateApiKeysOptions): Promise<ValidationSummary>;
+export declare const _validators: Record<string, KeyValidator>;
+export {};
+//# sourceMappingURL=apiKeyValidator.d.ts.map

package/dist/apiKeyValidator.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"apiKeyValidator.d.ts","sourceRoot":"","sources":["../src/apiKeyValidator.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,0DAA0D;IAC1D,KAAK,EAAE,OAAO,CAAC;IACf,oCAAoC;IACpC,OAAO,EAAE,MAAM,CAAC;IAChB,yCAAyC;IACzC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,gFAAgF;IAChF,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,mDAAmD;IACnD,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC1C,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,4CAA4C;IAC5C,WAAW,EAAE,MAAM,CAAC;IACpB,kDAAkD;IAClD,YAAY,EAAE,MAAM,CAAC;IACrB,2DAA2D;IAC3D,SAAS,EAAE,OAAO,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,sBAAsB;IACrC,gEAAgE;IAChE,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,KAAK,YAAY,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC,gBAAgB,CAAC,CAAC;AA2LlF;;;;;;GAMG;AACH,wBAAsB,eAAe,CACnC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAC9B,OAAO,CAAC,EAAE,sBAAsB,GAC/B,OAAO,CAAC,iBAAiB,CAAC,CA+C5B;AAGD,eAAO,MAAM,WAAW,8BAAa,CAAC"}

package/dist/apiKeyValidator.js

@@ -0,0 +1,235 @@
+/**
+ * API Key Validator - validates user-provided API keys against their respective services
+ *
+ * Design principles:
+ * - Never block the user: network/timeout errors result in skipped validation, not failure
+ * - Lightweight: uses minimal read-only endpoints
+ * - Graceful: unknown key types are skipped with informative messages
+ */
+// Default timeout for validation requests
+const DEFAULT_TIMEOUT = 5000;
+/**
+ * Validate an Anthropic API key
+ * Endpoint: GET https://api.anthropic.com/v1/models
+ */
+async function validateAnthropicKey(key, timeout) {
+    try {
+        const response = await fetch('https://api.anthropic.com/v1/models', {
+            method: 'GET',
+            headers: {
+                'x-api-key': key,
+                'anthropic-version': '2023-06-01',
+            },
+            signal: AbortSignal.timeout(timeout),
+        });
+        if (response.ok) {
+            return { valid: true, message: 'API key is valid' };
+        }
+        if (response.status === 401) {
+            return { valid: false, message: 'Invalid API key', error: 'Authentication failed' };
+        }
+        return { valid: false, message: 'Validation failed', error: `HTTP ${response.status}` };
+    }
+    catch (error) {
+        return handleFetchError(error);
+    }
+}
+/**
+ * Validate an OpenAI API key
+ * Endpoint: GET https://api.openai.com/v1/models
+ */
+async function validateOpenAIKey(key, timeout) {
+    try {
+        const response = await fetch('https://api.openai.com/v1/models', {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${key}`,
+            },
+            signal: AbortSignal.timeout(timeout),
+        });
+        if (response.ok) {
+            return { valid: true, message: 'API key is valid' };
+        }
+        if (response.status === 401) {
+            return { valid: false, message: 'Invalid API key', error: 'Authentication failed' };
+        }
+        return { valid: false, message: 'Validation failed', error: `HTTP ${response.status}` };
+    }
+    catch (error) {
+        return handleFetchError(error);
+    }
+}
+/**
+ * Validate a GitHub token
+ * Endpoint: GET https://api.github.com/user
+ */
+async function validateGitHubToken(token, timeout) {
+    try {
+        const response = await fetch('https://api.github.com/user', {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${token}`,
+                Accept: 'application/vnd.github+json',
+                'X-GitHub-Api-Version': '2022-11-28',
+            },
+            signal: AbortSignal.timeout(timeout),
+        });
+        if (response.ok) {
+            return { valid: true, message: 'Token is valid' };
+        }
+        if (response.status === 401) {
+            return { valid: false, message: 'Invalid token', error: 'Authentication failed' };
+        }
+        return { valid: false, message: 'Validation failed', error: `HTTP ${response.status}` };
+    }
+    catch (error) {
+        return handleFetchError(error);
+    }
+}
+/**
+ * Validate a Stripe API key
+ * Endpoint: GET https://api.stripe.com/v1/balance
+ */
+async function validateStripeKey(key, timeout) {
+    try {
+        const response = await fetch('https://api.stripe.com/v1/balance', {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${key}`,
+            },
+            signal: AbortSignal.timeout(timeout),
+        });
+        if (response.ok) {
+            return { valid: true, message: 'API key is valid' };
+        }
+        if (response.status === 401) {
+            return { valid: false, message: 'Invalid API key', error: 'Authentication failed' };
+        }
+        return { valid: false, message: 'Validation failed', error: `HTTP ${response.status}` };
+    }
+    catch (error) {
+        return handleFetchError(error);
+    }
+}
+/**
+ * Validate a SendGrid API key
+ * Endpoint: GET https://api.sendgrid.com/v3/scopes
+ */
+async function validateSendGridKey(key, timeout) {
+    try {
+        const response = await fetch('https://api.sendgrid.com/v3/scopes', {
+            method: 'GET',
+            headers: {
+                Authorization: `Bearer ${key}`,
+            },
+            signal: AbortSignal.timeout(timeout),
+        });
+        if (response.ok) {
+            return { valid: true, message: 'API key is valid' };
+        }
+        if (response.status === 401 || response.status === 403) {
+            return { valid: false, message: 'Invalid API key', error: 'Authentication failed' };
+        }
+        return { valid: false, message: 'Validation failed', error: `HTTP ${response.status}` };
+    }
+    catch (error) {
+        return handleFetchError(error);
+    }
+}
+/**
+ * Handle fetch errors gracefully - never block the user
+ */
+function handleFetchError(error) {
+    if (error instanceof Error) {
+        // Timeout errors
+        if (error.name === 'AbortError' || error.name === 'TimeoutError') {
+            return {
+                valid: true,
+                skipped: true,
+                message: 'Validation timed out - key saved without verification',
+            };
+        }
+        // Network errors
+        if (error.message.includes('ENOTFOUND') ||
+            error.message.includes('network') ||
+            error.message.includes('fetch')) {
+            return {
+                valid: true,
+                skipped: true,
+                message: 'Network error - key saved without verification',
+            };
+        }
+    }
+    // Unknown errors - don't block the user
+    return {
+        valid: true,
+        skipped: true,
+        message: 'Validation error - key saved without verification',
+        error: error instanceof Error ? error.message : 'Unknown error',
+    };
+}
+/**
+ * Registry of validators by env var name
+ */
+const validators = {
+    ANTHROPIC_API_KEY: validateAnthropicKey,
+    OPENAI_API_KEY: validateOpenAIKey,
+    GITHUB_TOKEN: validateGitHubToken,
+    GITHUB_ACCESS_TOKEN: validateGitHubToken,
+    GH_TOKEN: validateGitHubToken,
+    STRIPE_SECRET_KEY: validateStripeKey,
+    STRIPE_API_KEY: validateStripeKey,
+    SENDGRID_API_KEY: validateSendGridKey,
+};
+/**
+ * Validate multiple API keys in parallel
+ *
+ * @param values - Record of env var names to their values
+ * @param options - Validation options
+ * @returns Summary of validation results
+ */
+export async function validateApiKeys(values, options) {
+    const timeout = options?.timeout ?? DEFAULT_TIMEOUT;
+    // Run all validations in parallel
+    const entries = Object.entries(values);
+    const results = {};
+    const validationPromises = entries.map(async ([envVar, value]) => {
+        const validator = validators[envVar];
+        if (!validator) {
+            // No validator for this key type - skip
+            results[envVar] = {
+                valid: true,
+                skipped: true,
+                message: 'No validator available for this key type',
+            };
+            return;
+        }
+        results[envVar] = await validator(value, timeout);
+    });
+    await Promise.all(validationPromises);
+    // Calculate summary
+    let passedCount = 0;
+    let failedCount = 0;
+    let skippedCount = 0;
+    for (const result of Object.values(results)) {
+        if (result.skipped) {
+            skippedCount++;
+        }
+        else if (result.valid) {
+            passedCount++;
+        }
+        else {
+            failedCount++;
+        }
+    }
+    return {
+        results,
+        passedCount,
+        failedCount,
+        skippedCount,
+        allPassed: failedCount === 0,
+    };
+}
+// Export validators for testing
+export const _validators = validators;
+//# sourceMappingURL=apiKeyValidator.js.map

package/dist/apiKeyValidator.js.map

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

package/dist/app.d.ts

@@ -23,10 +23,15 @@ export declare class MaistroApp {
      * Prompts user to update if a new version is available
      */
     private handleUpdateCheck;
+    /**
+     * Restart maistro after update by spawning a new process and exiting
+     */
+    private restartAfterUpdate;
     /**
      * Run doctor check - verify Claude Code CLI installation and authentication
+     * @param fullCheck - If true, always run interaction test (step 3). If false, skip if already passed once.
      */
-    handleDoctor(): Promise<boolean>;
+    handleDoctor(fullCheck?: boolean): Promise<boolean>;
     /**
      * Handle attaching an image
      * Supports: /attach <path> [as <name>] or /attach <url> [as <name>]
@@ -79,9 +84,15 @@ export declare class MaistroApp {
     private askDiscoveryQuestion;
     /**
      * Detect and collect missing external dependencies
+     * @param goal - The user's goal text to detect mentioned dependencies
      * Returns the collected values or null if user cancelled
      */
     private handleDependencyDetection;
+    /**
+     * Validate collected API keys against their respective services
+     * Returns the validated values (possibly updated after retries), or 'cancel' if user cancelled
+     */
+    private validateCollectedKeys;
     /**
      * Save collected dependency values to .env file
      */
@@ -187,7 +198,7 @@ export declare class MaistroApp {
     private interactivePlanReview;
     private displayTasks;
     /**
-     * Handle clear plan command - clears goal and all tasks, keeps logs
+     * Handle clear plan command - clears goal, all tasks, and logs
      * Returns true if plan was cleared and should return to init flow
      */
     private handleClearPlan;

package/dist/app.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AA6NA,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAG9B,OAAO,CAAC,cAAc,CAA+B;gBAEzC,WAAW,GAAE,MAAY;IAsBrC,OAAO,CAAC,eAAe;IASvB;;;OAGG;YACW,qBAAqB;IA+CnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA8F5B;;;OAGG;YACW,iBAAiB;IA8D/B;;OAEG;IACG,YAAY,IAAI,OAAO,CAAC,OAAO,CAAC;IAqEtC;;;OAGG;YACW,iBAAiB;IAwD/B;;OAEG;YACW,sBAAsB;IAsCpC;;;OAGG;YACW,iBAAiB;IAoB/B;;;OAGG;YACW,oBAAoB;IAkClC;;OAEG;YACW,qBAAqB;IA4BnC;;OAEG;YACW,gBAAgB;IAoB9B;;;OAGG;YACW,qBAAqB;IAoEnC;;;OAGG;YACW,eAAe;IAwG7B;;;OAGG;YACW,uBAAuB;IAyDrC;;OAEG;YACW,4BAA4B;IAiE1C;;OAEG;YACW,oBAAoB;IA8DlC;;;OAGG;YACW,yBAAyB;IAwHvC;;OAEG;YACW,qBAAqB;IA0CnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,UAAU;IAalB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IA0J7B,OAAO,CAAC,iBAAiB,CAAM;IAC/B,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;;OAGG;YACW,YAAY;IAoS1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA2CxB;;OAEG;YACW,aAAa;IA0lB3B;;;OAGG;YACW,eAAe;IAkN7B;;;OAGG;YACW,iBAAiB;IA4H/B;;OAEG;YACW,cAAc;IAwU5B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,aAAa,CAAS;IAE9B;;OAEG;YACW,gBAAgB;IAkB9B;;OAEG;YACW,gBAAgB;IAe9B;;;OAGG;YACW,WAAW;IAsEzB;;;OAGG;YACW,mBAAmB;IA0BjC;;;OAGG;YACW,cAAc;IAiB5B;;;;OAIG;YACW,6BAA6B;IAwH3C;;;OAGG;YACW,aAAa;IA+B3B;;;;OAIG;YACW,sBAAsB;IA4LpC;;;OAGG;YACW,gBAAgB;IAqF9B;;;;OAIG;YACW,sBAAsB;YAwGtB,UAAU;YAyHV,qBAAqB;IA4fnC,OAAO,CAAC,YAAY;IAiEpB;;;OAGG;YACW,eAAe;IAkD7B;;OAEG;YACW,cAAc;IAsO5B;;OAEG;YACW,oBAAoB;IAwBlC;;OAEG;YACW,eAAe;IAU7B;;OAEG;YACW,wBAAwB;YAsBxB,gBAAgB;IA4B9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsD;IAEpF;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;YAoEhB,SAAS;YAmJT,sBAAsB;CA8brC"}
+{"version":3,"file":"app.d.ts","sourceRoot":"","sources":["../src/app.ts"],"names":[],"mappings":"AAiOA,qBAAa,UAAU;IACrB,OAAO,CAAC,EAAE,CAAgB;IAC1B,OAAO,CAAC,YAAY,CAA6B;IACjD,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,WAAW,CAAS;IAC5B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,aAAa,CAAS;IAG9B,OAAO,CAAC,cAAc,CAA+B;gBAEzC,WAAW,GAAE,MAAY;IAsBrC,OAAO,CAAC,eAAe;IASvB;;;OAGG;YACW,qBAAqB;IA+CnC;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IA+F5B;;;OAGG;YACW,iBAAiB;IA8D/B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAgC1B;;;OAGG;IACG,YAAY,CAAC,SAAS,UAAO,GAAG,OAAO,CAAC,OAAO,CAAC;IAqFtD;;;OAGG;YACW,iBAAiB;IAwD/B;;OAEG;YACW,sBAAsB;IAsCpC;;;OAGG;YACW,iBAAiB;IAoB/B;;;OAGG;YACW,oBAAoB;IAkClC;;OAEG;YACW,qBAAqB;IA4BnC;;OAEG;YACW,gBAAgB;IAoB9B;;;OAGG;YACW,qBAAqB;IAoEnC;;;OAGG;YACW,eAAe;IAwG7B;;;OAGG;YACW,uBAAuB;IAyDrC;;OAEG;YACW,4BAA4B;IAiE1C;;OAEG;YACW,oBAAoB;IA8DlC;;;;OAIG;YACW,yBAAyB;IAgIvC;;;OAGG;YACW,qBAAqB;IAqGnC;;OAEG;YACW,qBAAqB;IAiDnC;;OAEG;IACH,OAAO,CAAC,cAAc;IAatB,OAAO,CAAC,UAAU;IAQlB;;;;;;OAMG;IACH,OAAO,CAAC,qBAAqB;IA0J7B,OAAO,CAAC,iBAAiB,CAAM;IAC/B,OAAO,CAAC,gBAAgB,CAAK;IAE7B;;;OAGG;YACW,YAAY;IAoS1B;;;OAGG;IACH,OAAO,CAAC,gBAAgB;IA2CxB;;OAEG;YACW,aAAa;IA0lB3B;;;OAGG;YACW,eAAe;IAkN7B;;;OAGG;YACW,iBAAiB;IAgI/B;;OAEG;YACW,cAAc;IAwU5B,OAAO,CAAC,YAAY,CAAgB;IACpC,OAAO,CAAC,YAAY,CAAM;IAC1B,OAAO,CAAC,aAAa,CAAS;IAE9B;;OAEG;YACW,gBAAgB;IAkB9B;;OAEG;YACW,gBAAgB;IAe9B;;;OAGG;YACW,WAAW;IAsEzB;;;OAGG;YACW,mBAAmB;IA4BjC;;;OAGG;YACW,cAAc;IAiB5B;;;;OAIG;YACW,6BAA6B;IAwH3C;;;OAGG;YACW,aAAa;IA+B3B;;;;OAIG;YACW,sBAAsB;IA4LpC;;;OAGG;YACW,gBAAgB;IAqF9B;;;;OAIG;YACW,sBAAsB;YAwGtB,UAAU;YAyHV,qBAAqB;IA4fnC,OAAO,CAAC,YAAY;IAiEpB;;;OAGG;YACW,eAAe;IAmD7B;;OAEG;YACW,cAAc;IAsO5B;;OAEG;YACW,oBAAoB;IAwBlC;;OAEG;YACW,eAAe;IAU7B;;OAEG;YACW,wBAAwB;YAsBxB,gBAAgB;IA4B9B,OAAO,CAAC,QAAQ,CAAC,aAAa,CAAsD;IAEpF;;OAEG;IACH,OAAO,CAAC,mBAAmB;IAoB3B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAO1B;;OAEG;IACH,OAAO,CAAC,kBAAkB;IAS1B;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAKzB;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAqB5B;;OAEG;IACH,OAAO,CAAC,uBAAuB;IAQ/B;;OAEG;IACH,OAAO,CAAC,eAAe;IASvB;;OAEG;IACH,OAAO,CAAC,sBAAsB;YAoEhB,SAAS;YAmJT,sBAAsB;CAgbrC"}