opencode-swarm-plugin 0.22.0 → 0.23.0

package/dist/rate-limiter.d.ts

@@ -0,0 +1,218 @@
+/**
+ * Rate Limiter Module - Distributed rate limiting for Agent Mail
+ *
+ * Provides sliding window rate limiting with dual backends:
+ * - Redis (primary) - Distributed, uses sorted sets for sliding window
+ * - SQLite (fallback) - Local, file-based persistence
+ *
+ * Features:
+ * - Dual window enforcement: per-minute AND per-hour limits
+ * - Automatic backend fallback (Redis → SQLite)
+ * - Configurable limits per endpoint via env vars
+ * - Auto-cleanup of expired entries
+ *
+ * @example
+ * ```typescript
+ * // Create rate limiter (auto-selects backend)
+ * const limiter = await createRateLimiter();
+ *
+ * // Check if request is allowed
+ * const result = await limiter.checkLimit("BlueLake", "send");
+ * if (!result.allowed) {
+ *   console.log(`Rate limited. Reset at ${result.resetAt}`);
+ * }
+ *
+ * // Record a request after it completes
+ * await limiter.recordRequest("BlueLake", "send");
+ * ```
+ */
+import Redis from "ioredis";
+/**
+ * Result of checking a rate limit
+ */
+export interface RateLimitResult {
+    /** Whether the request is allowed */
+    allowed: boolean;
+    /** Remaining requests in the most restrictive window */
+    remaining: number;
+    /** Unix timestamp (ms) when the limit resets */
+    resetAt: number;
+}
+/**
+ * Rate limiter interface
+ */
+export interface RateLimiter {
+    /**
+     * Check if a request is allowed under rate limits
+     * Checks BOTH minute and hour windows - both must pass
+     *
+     * @param agentName - The agent making the request
+     * @param endpoint - The endpoint being accessed
+     * @returns Rate limit check result
+     */
+    checkLimit(agentName: string, endpoint: string): Promise<RateLimitResult>;
+    /**
+     * Record a request against the rate limit
+     * Should be called AFTER the request succeeds
+     *
+     * @param agentName - The agent making the request
+     * @param endpoint - The endpoint being accessed
+     */
+    recordRequest(agentName: string, endpoint: string): Promise<void>;
+    /**
+     * Close the rate limiter and release resources
+     */
+    close(): Promise<void>;
+}
+/**
+ * Rate limit configuration for an endpoint
+ */
+export interface EndpointLimits {
+    /** Requests allowed per minute */
+    perMinute: number;
+    /** Requests allowed per hour */
+    perHour: number;
+}
+/**
+ * Default rate limits per endpoint
+ * Can be overridden via OPENCODE_RATE_LIMIT_{ENDPOINT}_PER_MIN and _PER_HOUR
+ */
+export declare const DEFAULT_LIMITS: Record<string, EndpointLimits>;
+/**
+ * Get rate limits for an endpoint, with env var overrides
+ *
+ * @param endpoint - The endpoint name
+ * @returns Rate limits for the endpoint
+ */
+export declare function getLimitsForEndpoint(endpoint: string): EndpointLimits;
+/**
+ * Redis-backed rate limiter using sorted sets
+ *
+ * Uses sliding window algorithm:
+ * 1. Store each request as a member with timestamp as score
+ * 2. Remove expired entries (outside window)
+ * 3. Count remaining entries
+ *
+ * Key format: ratelimit:{agent}:{endpoint}:{window}
+ * Window values: "minute" or "hour"
+ */
+export declare class RedisRateLimiter implements RateLimiter {
+    private redis;
+    private connected;
+    constructor(redis: Redis);
+    /**
+     * Build Redis key for rate limiting
+     */
+    private buildKey;
+    /**
+     * Get window duration in milliseconds
+     */
+    private getWindowDuration;
+    checkLimit(agentName: string, endpoint: string): Promise<RateLimitResult>;
+    /**
+     * Check a single window's rate limit
+     */
+    private checkWindow;
+    recordRequest(agentName: string, endpoint: string): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * SQLite-backed rate limiter for local/fallback use
+ *
+ * Table schema:
+ * - agent_name: TEXT
+ * - endpoint: TEXT
+ * - window: TEXT ('minute' or 'hour')
+ * - timestamp: INTEGER (Unix ms)
+ *
+ * Uses sliding window via COUNT query with timestamp filter.
+ */
+export declare class SqliteRateLimiter implements RateLimiter {
+    private db;
+    constructor(dbPath: string);
+    /**
+     * Initialize the database schema and cleanup old entries
+     */
+    private initialize;
+    checkLimit(agentName: string, endpoint: string): Promise<RateLimitResult>;
+    /**
+     * Check a single window's rate limit
+     */
+    private checkWindow;
+    /**
+     * Clean up old rate limit entries in bounded batches
+     *
+     * Limits cleanup to prevent blocking recordRequest on large datasets:
+     * - BATCH_SIZE: 1000 rows per iteration
+     * - MAX_BATCHES: 10 (max 10k rows per cleanup invocation)
+     *
+     * Stops early if fewer than BATCH_SIZE rows deleted (no more to clean).
+     */
+    private cleanup;
+    recordRequest(agentName: string, endpoint: string): Promise<void>;
+    close(): Promise<void>;
+}
+/**
+ * In-memory rate limiter for testing
+ *
+ * Uses Map storage with timestamp arrays per key.
+ * No persistence - resets on process restart.
+ */
+export declare class InMemoryRateLimiter implements RateLimiter {
+    private storage;
+    private buildKey;
+    checkLimit(agentName: string, endpoint: string): Promise<RateLimitResult>;
+    private checkWindow;
+    recordRequest(agentName: string, endpoint: string): Promise<void>;
+    close(): Promise<void>;
+    /**
+     * Reset all rate limits (for testing)
+     */
+    reset(): void;
+}
+/**
+ * Create a rate limiter with automatic backend selection
+ *
+ * Tries Redis first, falls back to SQLite on connection failure.
+ * Warns once when falling back to SQLite.
+ *
+ * @returns Configured rate limiter instance
+ *
+ * @example
+ * ```typescript
+ * // Auto-select backend
+ * const limiter = await createRateLimiter();
+ *
+ * // Force SQLite
+ * const limiter = await createRateLimiter({ backend: "sqlite" });
+ *
+ * // Force in-memory (testing)
+ * const limiter = await createRateLimiter({ backend: "memory" });
+ * ```
+ */
+export declare function createRateLimiter(options?: {
+    backend?: "redis" | "sqlite" | "memory";
+    redisUrl?: string;
+    sqlitePath?: string;
+}): Promise<RateLimiter>;
+/**
+ * Reset the fallback warning flag (for testing)
+ */
+export declare function resetFallbackWarning(): void;
+/**
+ * Get or create the global rate limiter instance
+ *
+ * Uses auto-selection (Redis → SQLite) by default.
+ */
+export declare function getRateLimiter(): Promise<RateLimiter>;
+/**
+ * Set the global rate limiter instance
+ *
+ * Useful for testing or custom configurations.
+ */
+export declare function setRateLimiter(limiter: RateLimiter): void;
+/**
+ * Reset the global rate limiter instance
+ */
+export declare function resetRateLimiter(): Promise<void>;
+//# sourceMappingURL=rate-limiter.d.ts.map

package/dist/rate-limiter.d.ts.map

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

package/dist/repo-crawl.d.ts

@@ -0,0 +1,146 @@
+import { z } from "zod";
+export declare class RepoCrawlError extends Error {
+    readonly statusCode?: number | undefined;
+    readonly endpoint?: string | undefined;
+    constructor(message: string, statusCode?: number | undefined, endpoint?: string | undefined);
+}
+/**
+ * Get README.md content from a repository
+ */
+export declare const repo_readme: {
+    description: string;
+    args: {
+        repo: z.ZodString;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+    };
+    execute(args: {
+        repo: string;
+        maxLength?: number | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Get repository structure and detect tech stack
+ */
+export declare const repo_structure: {
+    description: string;
+    args: {
+        repo: z.ZodString;
+        depth: z.ZodOptional<z.ZodNumber>;
+    };
+    execute(args: {
+        repo: string;
+        depth?: number | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Get directory tree for a specific path
+ */
+export declare const repo_tree: {
+    description: string;
+    args: {
+        repo: z.ZodString;
+        path: z.ZodOptional<z.ZodString>;
+        maxDepth: z.ZodOptional<z.ZodNumber>;
+    };
+    execute(args: {
+        repo: string;
+        path?: string | undefined;
+        maxDepth?: number | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Get file content from repository
+ */
+export declare const repo_file: {
+    description: string;
+    args: {
+        repo: z.ZodString;
+        path: z.ZodString;
+        maxLength: z.ZodOptional<z.ZodNumber>;
+    };
+    execute(args: {
+        repo: string;
+        path: string;
+        maxLength?: number | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+/**
+ * Search code in a repository
+ */
+export declare const repo_search: {
+    description: string;
+    args: {
+        repo: z.ZodString;
+        query: z.ZodString;
+        maxResults: z.ZodOptional<z.ZodNumber>;
+    };
+    execute(args: {
+        repo: string;
+        query: string;
+        maxResults?: number | undefined;
+    }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+};
+export declare const repoCrawlTools: {
+    repo_readme: {
+        description: string;
+        args: {
+            repo: z.ZodString;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+        };
+        execute(args: {
+            repo: string;
+            maxLength?: number | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    repo_structure: {
+        description: string;
+        args: {
+            repo: z.ZodString;
+            depth: z.ZodOptional<z.ZodNumber>;
+        };
+        execute(args: {
+            repo: string;
+            depth?: number | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    repo_tree: {
+        description: string;
+        args: {
+            repo: z.ZodString;
+            path: z.ZodOptional<z.ZodString>;
+            maxDepth: z.ZodOptional<z.ZodNumber>;
+        };
+        execute(args: {
+            repo: string;
+            path?: string | undefined;
+            maxDepth?: number | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    repo_file: {
+        description: string;
+        args: {
+            repo: z.ZodString;
+            path: z.ZodString;
+            maxLength: z.ZodOptional<z.ZodNumber>;
+        };
+        execute(args: {
+            repo: string;
+            path: string;
+            maxLength?: number | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+    repo_search: {
+        description: string;
+        args: {
+            repo: z.ZodString;
+            query: z.ZodString;
+            maxResults: z.ZodOptional<z.ZodNumber>;
+        };
+        execute(args: {
+            repo: string;
+            query: string;
+            maxResults?: number | undefined;
+        }, context: import("@opencode-ai/plugin").ToolContext): Promise<string>;
+    };
+};
+//# sourceMappingURL=repo-crawl.d.ts.map

package/dist/repo-crawl.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"repo-crawl.d.ts","sourceRoot":"","sources":["../src/repo-crawl.ts"],"names":[],"mappings":"AA6BA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqExB,qBAAa,cAAe,SAAQ,KAAK;aAGrB,UAAU,CAAC,EAAE,MAAM;aACnB,QAAQ,CAAC,EAAE,MAAM;gBAFjC,OAAO,EAAE,MAAM,EACC,UAAU,CAAC,EAAE,MAAM,YAAA,EACnB,QAAQ,CAAC,EAAE,MAAM,YAAA;CAKpC;AA4KD;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;CA8CtB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;CAqEzB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;CAiFpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,SAAS;;;;;;;;;;;;CAmDpB,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,WAAW;;;;;;;;;;;;CAgDtB,CAAC;AAMH,eAAO,MAAM,cAAc;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAM1B,CAAC"}

package/dist/schemas/bead.d.ts

@@ -0,0 +1,255 @@
+/**
+ * Bead schemas for type-safe beads operations
+ *
+ * These schemas validate all data from the `bd` CLI to ensure
+ * type safety and catch malformed responses early.
+ */
+import { z } from "zod";
+/** Valid bead statuses */
+export declare const BeadStatusSchema: z.ZodEnum<{
+    open: "open";
+    in_progress: "in_progress";
+    blocked: "blocked";
+    closed: "closed";
+}>;
+export type BeadStatus = z.infer<typeof BeadStatusSchema>;
+/** Valid bead types */
+export declare const BeadTypeSchema: z.ZodEnum<{
+    bug: "bug";
+    feature: "feature";
+    task: "task";
+    epic: "epic";
+    chore: "chore";
+}>;
+export type BeadType = z.infer<typeof BeadTypeSchema>;
+/** Dependency relationship between beads */
+export declare const BeadDependencySchema: z.ZodObject<{
+    id: z.ZodString;
+    type: z.ZodEnum<{
+        blocks: "blocks";
+        "blocked-by": "blocked-by";
+        related: "related";
+        "discovered-from": "discovered-from";
+    }>;
+}, z.core.$strip>;
+export type BeadDependency = z.infer<typeof BeadDependencySchema>;
+/**
+ * Core bead schema - validates bd CLI JSON output
+ *
+ * ID format:
+ * - Standard: `{project}-{hash}` (e.g., `opencode-swarm-plugin-1i8`)
+ * - Subtask: `{project}-{hash}.{index}` (e.g., `opencode-swarm-plugin-1i8.1`)
+ * - Custom: `{project}-{custom-id}` (e.g., `migrate-egghead-phase-0`)
+ * - Custom subtask: `{project}-{custom-id}.{suffix}` (e.g., `migrate-egghead-phase-0.e2e-test`)
+ */
+export declare const BeadSchema: z.ZodObject<{
+    id: z.ZodString;
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    status: z.ZodDefault<z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        blocked: "blocked";
+        closed: "closed";
+    }>>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    issue_type: z.ZodDefault<z.ZodEnum<{
+        bug: "bug";
+        feature: "feature";
+        task: "task";
+        epic: "epic";
+        chore: "chore";
+    }>>;
+    created_at: z.ZodString;
+    updated_at: z.ZodOptional<z.ZodString>;
+    closed_at: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodOptional<z.ZodString>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        type: z.ZodEnum<{
+            blocks: "blocks";
+            "blocked-by": "blocked-by";
+            related: "related";
+            "discovered-from": "discovered-from";
+        }>;
+    }, z.core.$strip>>>;
+    metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+}, z.core.$strip>;
+export type Bead = z.infer<typeof BeadSchema>;
+/** Arguments for creating a bead */
+export declare const BeadCreateArgsSchema: z.ZodObject<{
+    title: z.ZodString;
+    type: z.ZodDefault<z.ZodEnum<{
+        bug: "bug";
+        feature: "feature";
+        task: "task";
+        epic: "epic";
+        chore: "chore";
+    }>>;
+    priority: z.ZodDefault<z.ZodNumber>;
+    description: z.ZodOptional<z.ZodString>;
+    parent_id: z.ZodOptional<z.ZodString>;
+    id: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type BeadCreateArgs = z.infer<typeof BeadCreateArgsSchema>;
+/** Arguments for updating a bead */
+export declare const BeadUpdateArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    status: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        blocked: "blocked";
+        closed: "closed";
+    }>>;
+    description: z.ZodOptional<z.ZodString>;
+    priority: z.ZodOptional<z.ZodNumber>;
+}, z.core.$strip>;
+export type BeadUpdateArgs = z.infer<typeof BeadUpdateArgsSchema>;
+/** Arguments for closing a bead */
+export declare const BeadCloseArgsSchema: z.ZodObject<{
+    id: z.ZodString;
+    reason: z.ZodString;
+}, z.core.$strip>;
+export type BeadCloseArgs = z.infer<typeof BeadCloseArgsSchema>;
+/** Arguments for querying beads */
+export declare const BeadQueryArgsSchema: z.ZodObject<{
+    status: z.ZodOptional<z.ZodEnum<{
+        open: "open";
+        in_progress: "in_progress";
+        blocked: "blocked";
+        closed: "closed";
+    }>>;
+    type: z.ZodOptional<z.ZodEnum<{
+        bug: "bug";
+        feature: "feature";
+        task: "task";
+        epic: "epic";
+        chore: "chore";
+    }>>;
+    ready: z.ZodOptional<z.ZodBoolean>;
+    limit: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type BeadQueryArgs = z.infer<typeof BeadQueryArgsSchema>;
+/**
+ * Subtask specification for epic decomposition
+ *
+ * Used when creating an epic with subtasks in one operation.
+ * The `files` array is used for Agent Mail file reservations.
+ */
+export declare const SubtaskSpecSchema: z.ZodObject<{
+    title: z.ZodString;
+    description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    files: z.ZodDefault<z.ZodArray<z.ZodString>>;
+    dependencies: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+    estimated_complexity: z.ZodDefault<z.ZodNumber>;
+}, z.core.$strip>;
+export type SubtaskSpec = z.infer<typeof SubtaskSpecSchema>;
+/**
+ * Bead tree for swarm decomposition
+ *
+ * Represents an epic with its subtasks, ready for spawning agents.
+ */
+export declare const BeadTreeSchema: z.ZodObject<{
+    epic: z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+    }, z.core.$strip>;
+    subtasks: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        files: z.ZodDefault<z.ZodArray<z.ZodString>>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodNumber>>;
+        estimated_complexity: z.ZodDefault<z.ZodNumber>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type BeadTree = z.infer<typeof BeadTreeSchema>;
+/** Arguments for creating an epic with subtasks */
+export declare const EpicCreateArgsSchema: z.ZodObject<{
+    epic_title: z.ZodString;
+    epic_description: z.ZodOptional<z.ZodString>;
+    epic_id: z.ZodOptional<z.ZodString>;
+    subtasks: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        priority: z.ZodDefault<z.ZodNumber>;
+        files: z.ZodDefault<z.ZodOptional<z.ZodArray<z.ZodString>>>;
+        id_suffix: z.ZodOptional<z.ZodString>;
+    }, z.core.$strip>>;
+}, z.core.$strip>;
+export type EpicCreateArgs = z.infer<typeof EpicCreateArgsSchema>;
+/**
+ * Result of epic creation
+ *
+ * Contains the created epic and all subtasks with their IDs.
+ */
+export declare const EpicCreateResultSchema: z.ZodObject<{
+    success: z.ZodBoolean;
+    epic: z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        status: z.ZodDefault<z.ZodEnum<{
+            open: "open";
+            in_progress: "in_progress";
+            blocked: "blocked";
+            closed: "closed";
+        }>>;
+        priority: z.ZodDefault<z.ZodNumber>;
+        issue_type: z.ZodDefault<z.ZodEnum<{
+            bug: "bug";
+            feature: "feature";
+            task: "task";
+            epic: "epic";
+            chore: "chore";
+        }>>;
+        created_at: z.ZodString;
+        updated_at: z.ZodOptional<z.ZodString>;
+        closed_at: z.ZodOptional<z.ZodString>;
+        parent_id: z.ZodOptional<z.ZodString>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<{
+                blocks: "blocks";
+                "blocked-by": "blocked-by";
+                related: "related";
+                "discovered-from": "discovered-from";
+            }>;
+        }, z.core.$strip>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>;
+    subtasks: z.ZodArray<z.ZodObject<{
+        id: z.ZodString;
+        title: z.ZodString;
+        description: z.ZodDefault<z.ZodOptional<z.ZodString>>;
+        status: z.ZodDefault<z.ZodEnum<{
+            open: "open";
+            in_progress: "in_progress";
+            blocked: "blocked";
+            closed: "closed";
+        }>>;
+        priority: z.ZodDefault<z.ZodNumber>;
+        issue_type: z.ZodDefault<z.ZodEnum<{
+            bug: "bug";
+            feature: "feature";
+            task: "task";
+            epic: "epic";
+            chore: "chore";
+        }>>;
+        created_at: z.ZodString;
+        updated_at: z.ZodOptional<z.ZodString>;
+        closed_at: z.ZodOptional<z.ZodString>;
+        parent_id: z.ZodOptional<z.ZodString>;
+        dependencies: z.ZodDefault<z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            type: z.ZodEnum<{
+                blocks: "blocks";
+                "blocked-by": "blocked-by";
+                related: "related";
+                "discovered-from": "discovered-from";
+            }>;
+        }, z.core.$strip>>>;
+        metadata: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodUnknown>>;
+    }, z.core.$strip>>;
+    rollback_hint: z.ZodOptional<z.ZodString>;
+}, z.core.$strip>;
+export type EpicCreateResult = z.infer<typeof EpicCreateResultSchema>;
+//# sourceMappingURL=bead.d.ts.map

package/dist/schemas/bead.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bead.d.ts","sourceRoot":"","sources":["../../src/schemas/bead.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AACH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0BAA0B;AAC1B,eAAO,MAAM,gBAAgB;;;;;EAK3B,CAAC;AACH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,uBAAuB;AACvB,eAAO,MAAM,cAAc;;;;;;EAMzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,4CAA4C;AAC5C,eAAO,MAAM,oBAAoB;;;;;;;;iBAG/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;;;;;GAQG;AACH,eAAO,MAAM,UAAU;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAsCrB,CAAC;AACH,MAAM,MAAM,IAAI,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,UAAU,CAAC,CAAC;AAE9C,oCAAoC;AACpC,eAAO,MAAM,oBAAoB;;;;;;;;;;;;;iBAY/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,oCAAoC;AACpC,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAK/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE,mCAAmC;AACnC,eAAO,MAAM,mBAAmB;;;iBAG9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE,mCAAmC;AACnC,eAAO,MAAM,mBAAmB;;;;;;;;;;;;;;;;iBAK9B,CAAC;AACH,MAAM,MAAM,aAAa,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,mBAAmB,CAAC,CAAC;AAEhE;;;;;GAKG;AACH,eAAO,MAAM,iBAAiB;;;;;;iBAc5B,CAAC;AACH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,iBAAiB,CAAC,CAAC;AAE5D;;;;GAIG;AACH,eAAO,MAAM,cAAc;;;;;;;;;;;;iBAMzB,CAAC;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,cAAc,CAAC,CAAC;AAEtD,mDAAmD;AACnD,eAAO,MAAM,oBAAoB;;;;;;;;;;iBAwB/B,CAAC;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,oBAAoB,CAAC,CAAC;AAElE;;;;GAIG;AACH,eAAO,MAAM,sBAAsB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAKjC,CAAC;AACH,MAAM,MAAM,gBAAgB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,sBAAsB,CAAC,CAAC"}