@bubblelab/bubble-core 0.1.9 → 0.1.11

package/dist/bubbles/tool-bubble/web-search-tool.js

@@ -1,7 +1,9 @@
 import { z } from 'zod';
 import { ToolBubble } from '../../types/tool-bubble-class.js';
-import FirecrawlApp, {} from '@mendable/firecrawl-js';
+import { FirecrawlBubble } from '../service-bubble/firecrawl.js';
 import { CredentialType } from '@bubblelab/shared-schemas';
+// Firecrawl charges 2 credits per 10 search results
+const CREDITS_PER_10_RESULTS = 2;
 // Define the parameters schema - simplified like the MCP server
 const WebSearchToolParamsSchema = z.object({
     query: z
@@ -10,10 +12,13 @@ const WebSearchToolParamsSchema = z.object({
         .describe('The search query to execute'),
     limit: z
         .number()
-        .min(1, 'Minimum number of search results to return is 1')
-        .max(5, 'Maximum number of search results to return is 5')
-        .default(3)
+        .max(50, 'Maximum number of search results to return is 20')
+        .default(10)
         .describe('Maximum number of search results to return'),
+    categories: z
+        .array(z.enum(['research', 'pdf', 'github']))
+        .default([])
+        .describe('Categories to find most relevant search results (research, pdf, github)'),
     location: z
         .string()
         .optional()
@@ -35,10 +40,12 @@ const WebSearchToolResultSchema = z.object({
     query: z.string().describe('The original search query'),
     totalResults: z.number().describe('Number of results returned'),
     searchEngine: z.string().describe('Search engine used (Firecrawl)'),
+    creditsUsed: z.number().describe('Number of credits used'),
     success: z.boolean().describe('Whether the search was successful'),
     error: z.string().describe('Error message if search failed'),
 });
 export class WebSearchTool extends ToolBubble {
+    // Delay between searches in milliseconds
     // Required static metadata
     static bubbleName = 'web-search-tool';
     static schema = WebSearchToolParamsSchema;
@@ -69,27 +76,16 @@ export class WebSearchTool extends ToolBubble {
     }
     async performAction(context) {
         void context; // Context available but not currently used
-        const { query, limit, location } = this.params;
+        const { query, limit, location, credentials } = this.params;
         try {
-            // Validate limit range
-            const limitedResults = Math.min(Math.max(limit, 1), 20);
-            // Get Firecrawl API key from credentials
-            const apiKey = this.params.credentials?.FIRECRAWL_API_KEY;
-            if (!apiKey) {
-                throw new Error('FIRECRAWL_API_KEY is required but not provided in credentials');
-            }
-            // Initialize Firecrawl client
-            const firecrawl = new FirecrawlApp({ apiKey });
+            // Limit should be multiple of 10
+            const limitedResults = Math.ceil(limit / 10) * 10;
             // Build search parameters according to Firecrawl API with defaults
             const searchOptions = {
                 limit: limitedResults,
                 // Default sources to web search
                 sources: ['web'],
-                // Default scrape options for better content extraction
-                scrapeOptions: {
-                    formats: ['markdown'],
-                    onlyMainContent: true,
-                },
+                timeout: 30000,
             };
             // Add optional parameters if provided
             if (location) {
@@ -99,25 +95,38 @@ export class WebSearchTool extends ToolBubble {
                 query,
                 ...searchOptions,
             });
+            // Initialize Firecrawl bubble
+            const firecrawlParams = {
+                operation: 'search',
+                credentials,
+                query,
+                ...searchOptions,
+            };
+            const firecrawl = new FirecrawlBubble(firecrawlParams, this.context, 'web_search_tool_firecrawl');
             // Execute search using Firecrawl
-            const searchResult = await firecrawl.search(query, searchOptions);
+            const response = await firecrawl.action();
             // Handle the response based on Firecrawl's actual API structure
             // The search API might return different structures, so handle both cases
             let resultsArray = [];
-            if (Array.isArray(searchResult)) {
-                resultsArray = searchResult;
+            if (!response.success) {
+                return {
+                    results: [],
+                    query,
+                    creditsUsed: 0,
+                    totalResults: 0,
+                    searchEngine: 'Firecrawl',
+                    success: false,
+                    error: response.error || 'Search failed',
+                };
+            }
+            else if (response.data.web) {
+                resultsArray = response.data.web;
+            }
+            else if (response.data.other) {
+                resultsArray = response.data.other;
             }
             else {
-                const response = searchResult;
-                if (response?.data && Array.isArray(response.data)) {
-                    resultsArray = response.data;
-                }
-                else if (response?.web && Array.isArray(response.web)) {
-                    resultsArray = response.web;
-                }
-                else {
-                    throw new Error('No search results returned or unexpected response format');
-                }
+                throw new Error('No search results returned or unexpected response format');
             }
             // Transform Firecrawl results to our format
             const results = resultsArray.map((item) => ({
@@ -129,11 +138,15 @@ export class WebSearchTool extends ToolBubble {
                     item.markdown ||
                     'No content available',
             }));
+            // Calculate credits: Firecrawl charges 2 credits per 10 results (rounded up)
+            // Token usage tracking is now centralized in FirecrawlBubble
+            const creditsUsed = Math.ceil(results.length / 10) * CREDITS_PER_10_RESULTS;
             return {
                 results,
                 query,
                 totalResults: results.length,
                 searchEngine: 'Firecrawl',
+                creditsUsed,
                 success: true,
                 error: '',
             };
@@ -144,6 +157,7 @@ export class WebSearchTool extends ToolBubble {
             return {
                 results: [],
                 query,
+                creditsUsed: 0,
                 totalResults: 0,
                 searchEngine: 'Firecrawl',
                 success: false,

package/dist/bubbles/tool-bubble/web-search-tool.js.map

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

package/dist/bubbles/tool-bubble/youtube-tool.d.ts

@@ -0,0 +1,394 @@
+import { z } from 'zod';
+import { ToolBubble } from '../../types/tool-bubble-class.js';
+import type { BubbleContext } from '../../types/bubble.js';
+import { CredentialType, type BubbleName } from '@bubblelab/shared-schemas';
+declare const YouTubeVideoSchema: z.ZodObject<{
+    title: z.ZodNullable<z.ZodString>;
+    id: z.ZodNullable<z.ZodString>;
+    url: z.ZodNullable<z.ZodString>;
+    viewCount: z.ZodNullable<z.ZodNumber>;
+    likes: z.ZodNullable<z.ZodNumber>;
+    date: z.ZodNullable<z.ZodString>;
+    channelName: z.ZodNullable<z.ZodString>;
+    channelUrl: z.ZodNullable<z.ZodString>;
+    subscribers: z.ZodNullable<z.ZodNumber>;
+    duration: z.ZodNullable<z.ZodString>;
+    description: z.ZodNullable<z.ZodString>;
+    comments: z.ZodNullable<z.ZodNumber>;
+    thumbnail: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    duration: string | null;
+    description: string | null;
+    title: string | null;
+    date: string | null;
+    url: string | null;
+    id: string | null;
+    thumbnail: string | null;
+    comments: number | null;
+    viewCount: number | null;
+    likes: number | null;
+    channelName: string | null;
+    channelUrl: string | null;
+    subscribers: number | null;
+}, {
+    duration: string | null;
+    description: string | null;
+    title: string | null;
+    date: string | null;
+    url: string | null;
+    id: string | null;
+    thumbnail: string | null;
+    comments: number | null;
+    viewCount: number | null;
+    likes: number | null;
+    channelName: string | null;
+    channelUrl: string | null;
+    subscribers: number | null;
+}>;
+declare const YouTubeTranscriptSegmentSchema: z.ZodObject<{
+    start: z.ZodNullable<z.ZodString>;
+    duration: z.ZodNullable<z.ZodString>;
+    text: z.ZodNullable<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    duration: string | null;
+    text: string | null;
+    start: string | null;
+}, {
+    duration: string | null;
+    text: string | null;
+    start: string | null;
+}>;
+declare const YouTubeToolParamsSchema: z.ZodObject<{
+    operation: z.ZodEnum<["searchVideos", "getTranscript", "scrapeChannel"]>;
+    searchQueries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    videoUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+    channelUrl: z.ZodOptional<z.ZodString>;
+    videoUrl: z.ZodOptional<z.ZodString>;
+    maxResults: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+    includeShorts: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+    credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    operation: "searchVideos" | "getTranscript" | "scrapeChannel";
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    maxResults?: number | undefined;
+    videoUrl?: string | undefined;
+    searchQueries?: string[] | undefined;
+    channelUrl?: string | undefined;
+    videoUrls?: string[] | undefined;
+    includeShorts?: boolean | undefined;
+}, {
+    operation: "searchVideos" | "getTranscript" | "scrapeChannel";
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    maxResults?: number | undefined;
+    videoUrl?: string | undefined;
+    searchQueries?: string[] | undefined;
+    channelUrl?: string | undefined;
+    videoUrls?: string[] | undefined;
+    includeShorts?: boolean | undefined;
+}>;
+declare const YouTubeToolResultSchema: z.ZodObject<{
+    operation: z.ZodEnum<["searchVideos", "getTranscript", "scrapeChannel"]>;
+    videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        title: z.ZodNullable<z.ZodString>;
+        id: z.ZodNullable<z.ZodString>;
+        url: z.ZodNullable<z.ZodString>;
+        viewCount: z.ZodNullable<z.ZodNumber>;
+        likes: z.ZodNullable<z.ZodNumber>;
+        date: z.ZodNullable<z.ZodString>;
+        channelName: z.ZodNullable<z.ZodString>;
+        channelUrl: z.ZodNullable<z.ZodString>;
+        subscribers: z.ZodNullable<z.ZodNumber>;
+        duration: z.ZodNullable<z.ZodString>;
+        description: z.ZodNullable<z.ZodString>;
+        comments: z.ZodNullable<z.ZodNumber>;
+        thumbnail: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        duration: string | null;
+        description: string | null;
+        title: string | null;
+        date: string | null;
+        url: string | null;
+        id: string | null;
+        thumbnail: string | null;
+        comments: number | null;
+        viewCount: number | null;
+        likes: number | null;
+        channelName: string | null;
+        channelUrl: string | null;
+        subscribers: number | null;
+    }, {
+        duration: string | null;
+        description: string | null;
+        title: string | null;
+        date: string | null;
+        url: string | null;
+        id: string | null;
+        thumbnail: string | null;
+        comments: number | null;
+        viewCount: number | null;
+        likes: number | null;
+        channelName: string | null;
+        channelUrl: string | null;
+        subscribers: number | null;
+    }>, "many">>;
+    transcript: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        start: z.ZodNullable<z.ZodString>;
+        duration: z.ZodNullable<z.ZodString>;
+        text: z.ZodNullable<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        duration: string | null;
+        text: string | null;
+        start: string | null;
+    }, {
+        duration: string | null;
+        text: string | null;
+        start: string | null;
+    }>, "many">>;
+    fullTranscriptText: z.ZodOptional<z.ZodString>;
+    totalResults: z.ZodNumber;
+    success: z.ZodBoolean;
+    error: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    error: string;
+    success: boolean;
+    operation: "searchVideos" | "getTranscript" | "scrapeChannel";
+    totalResults: number;
+    videos?: {
+        duration: string | null;
+        description: string | null;
+        title: string | null;
+        date: string | null;
+        url: string | null;
+        id: string | null;
+        thumbnail: string | null;
+        comments: number | null;
+        viewCount: number | null;
+        likes: number | null;
+        channelName: string | null;
+        channelUrl: string | null;
+        subscribers: number | null;
+    }[] | undefined;
+    transcript?: {
+        duration: string | null;
+        text: string | null;
+        start: string | null;
+    }[] | undefined;
+    fullTranscriptText?: string | undefined;
+}, {
+    error: string;
+    success: boolean;
+    operation: "searchVideos" | "getTranscript" | "scrapeChannel";
+    totalResults: number;
+    videos?: {
+        duration: string | null;
+        description: string | null;
+        title: string | null;
+        date: string | null;
+        url: string | null;
+        id: string | null;
+        thumbnail: string | null;
+        comments: number | null;
+        viewCount: number | null;
+        likes: number | null;
+        channelName: string | null;
+        channelUrl: string | null;
+        subscribers: number | null;
+    }[] | undefined;
+    transcript?: {
+        duration: string | null;
+        text: string | null;
+        start: string | null;
+    }[] | undefined;
+    fullTranscriptText?: string | undefined;
+}>;
+type YouTubeToolParams = z.output<typeof YouTubeToolParamsSchema>;
+type YouTubeToolResult = z.output<typeof YouTubeToolResultSchema>;
+type YouTubeToolParamsInput = z.input<typeof YouTubeToolParamsSchema>;
+export type YouTubeVideo = z.output<typeof YouTubeVideoSchema>;
+export type YouTubeTranscriptSegment = z.output<typeof YouTubeTranscriptSegmentSchema>;
+/**
+ * Simple, dev-friendly YouTube tool
+ *
+ * Provides easy access to YouTube data through three operations:
+ * - searchVideos: Search YouTube or scrape video/channel/playlist URLs
+ * - getTranscript: Extract video transcripts with timestamps
+ * - scrapeChannel: Get all videos from a channel
+ */
+export declare class YouTubeTool extends ToolBubble<YouTubeToolParams, YouTubeToolResult> {
+    static readonly bubbleName: BubbleName;
+    static readonly schema: z.ZodObject<{
+        operation: z.ZodEnum<["searchVideos", "getTranscript", "scrapeChannel"]>;
+        searchQueries: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        videoUrls: z.ZodOptional<z.ZodArray<z.ZodString, "many">>;
+        channelUrl: z.ZodOptional<z.ZodString>;
+        videoUrl: z.ZodOptional<z.ZodString>;
+        maxResults: z.ZodOptional<z.ZodDefault<z.ZodNumber>>;
+        includeShorts: z.ZodOptional<z.ZodDefault<z.ZodBoolean>>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        operation: "searchVideos" | "getTranscript" | "scrapeChannel";
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        maxResults?: number | undefined;
+        videoUrl?: string | undefined;
+        searchQueries?: string[] | undefined;
+        channelUrl?: string | undefined;
+        videoUrls?: string[] | undefined;
+        includeShorts?: boolean | undefined;
+    }, {
+        operation: "searchVideos" | "getTranscript" | "scrapeChannel";
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        maxResults?: number | undefined;
+        videoUrl?: string | undefined;
+        searchQueries?: string[] | undefined;
+        channelUrl?: string | undefined;
+        videoUrls?: string[] | undefined;
+        includeShorts?: boolean | undefined;
+    }>;
+    static readonly resultSchema: z.ZodObject<{
+        operation: z.ZodEnum<["searchVideos", "getTranscript", "scrapeChannel"]>;
+        videos: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            title: z.ZodNullable<z.ZodString>;
+            id: z.ZodNullable<z.ZodString>;
+            url: z.ZodNullable<z.ZodString>;
+            viewCount: z.ZodNullable<z.ZodNumber>;
+            likes: z.ZodNullable<z.ZodNumber>;
+            date: z.ZodNullable<z.ZodString>;
+            channelName: z.ZodNullable<z.ZodString>;
+            channelUrl: z.ZodNullable<z.ZodString>;
+            subscribers: z.ZodNullable<z.ZodNumber>;
+            duration: z.ZodNullable<z.ZodString>;
+            description: z.ZodNullable<z.ZodString>;
+            comments: z.ZodNullable<z.ZodNumber>;
+            thumbnail: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            duration: string | null;
+            description: string | null;
+            title: string | null;
+            date: string | null;
+            url: string | null;
+            id: string | null;
+            thumbnail: string | null;
+            comments: number | null;
+            viewCount: number | null;
+            likes: number | null;
+            channelName: string | null;
+            channelUrl: string | null;
+            subscribers: number | null;
+        }, {
+            duration: string | null;
+            description: string | null;
+            title: string | null;
+            date: string | null;
+            url: string | null;
+            id: string | null;
+            thumbnail: string | null;
+            comments: number | null;
+            viewCount: number | null;
+            likes: number | null;
+            channelName: string | null;
+            channelUrl: string | null;
+            subscribers: number | null;
+        }>, "many">>;
+        transcript: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            start: z.ZodNullable<z.ZodString>;
+            duration: z.ZodNullable<z.ZodString>;
+            text: z.ZodNullable<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            duration: string | null;
+            text: string | null;
+            start: string | null;
+        }, {
+            duration: string | null;
+            text: string | null;
+            start: string | null;
+        }>, "many">>;
+        fullTranscriptText: z.ZodOptional<z.ZodString>;
+        totalResults: z.ZodNumber;
+        success: z.ZodBoolean;
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        error: string;
+        success: boolean;
+        operation: "searchVideos" | "getTranscript" | "scrapeChannel";
+        totalResults: number;
+        videos?: {
+            duration: string | null;
+            description: string | null;
+            title: string | null;
+            date: string | null;
+            url: string | null;
+            id: string | null;
+            thumbnail: string | null;
+            comments: number | null;
+            viewCount: number | null;
+            likes: number | null;
+            channelName: string | null;
+            channelUrl: string | null;
+            subscribers: number | null;
+        }[] | undefined;
+        transcript?: {
+            duration: string | null;
+            text: string | null;
+            start: string | null;
+        }[] | undefined;
+        fullTranscriptText?: string | undefined;
+    }, {
+        error: string;
+        success: boolean;
+        operation: "searchVideos" | "getTranscript" | "scrapeChannel";
+        totalResults: number;
+        videos?: {
+            duration: string | null;
+            description: string | null;
+            title: string | null;
+            date: string | null;
+            url: string | null;
+            id: string | null;
+            thumbnail: string | null;
+            comments: number | null;
+            viewCount: number | null;
+            likes: number | null;
+            channelName: string | null;
+            channelUrl: string | null;
+            subscribers: number | null;
+        }[] | undefined;
+        transcript?: {
+            duration: string | null;
+            text: string | null;
+            start: string | null;
+        }[] | undefined;
+        fullTranscriptText?: string | undefined;
+    }>;
+    static readonly shortDescription = "Search YouTube videos, extract transcripts, and scrape channel content with a simple interface";
+    static readonly longDescription = "\n    Universal YouTube tool for video search, transcript extraction, and channel scraping.\n\n    **OPERATIONS:**\n    1. **searchVideos**: Search YouTube or scrape specific URLs\n       - Search by keywords\n       - Scrape videos, channels, playlists, or hashtags\n       - Get video metadata, views, likes, channel info\n\n    2. **getTranscript**: Extract video transcripts\n       - Get timestamped transcript segments\n       - Full transcript text available\n       - Perfect for content analysis or subtitles\n\n    3. **scrapeChannel**: Get all videos from a channel\n       - Fetch recent videos from any channel\n       - Sort by newest, popular, or oldest\n       - Get comprehensive video data\n\n    **WHEN TO USE THIS TOOL:**\n    - YouTube video search and discovery\n    - Content analysis and research\n    - Transcript extraction for AI/ML\n    - Channel monitoring and tracking\n    - Video metadata collection\n\n    **Simple Interface:**\n    Just specify the operation and provide search terms or URLs.\n    The tool handles service selection, data transformation, and error handling.\n\n    **What you get:**\n    - Clean, structured video data\n    - Timestamped transcripts\n    - Channel and engagement metrics\n    - Ready for analysis or processing\n  ";
+    static readonly alias = "yt";
+    static readonly type = "tool";
+    constructor(params?: YouTubeToolParamsInput, context?: BubbleContext, instanceId?: string);
+    performAction(): Promise<YouTubeToolResult>;
+    /**
+     * Create error result
+     */
+    private createErrorResult;
+    /**
+     * Handle searchVideos operation
+     */
+    private handleSearchVideos;
+    /**
+     * Handle getTranscript operation
+     */
+    private handleGetTranscript;
+    /**
+     * Handle scrapeChannel operation
+     */
+    private handleScrapeChannel;
+    /**
+     * Transform Apify video data to unified format
+     */
+    private transformVideos;
+    /**
+     * Create empty video object
+     */
+    private createEmptyVideo;
+}
+export {};
+//# sourceMappingURL=youtube-tool.d.ts.map

package/dist/bubbles/tool-bubble/youtube-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"youtube-tool.d.ts","sourceRoot":"","sources":["../../../src/bubbles/tool-bubble/youtube-tool.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,UAAU,EAAE,MAAM,kCAAkC,CAAC;AAC9D,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAK5E,QAAA,MAAM,kBAAkB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EActB,CAAC;AAEH,QAAA,MAAM,8BAA8B;;;;;;;;;;;;EAIlC,CAAC;AAGH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;EAsD3B,CAAC;AAGH,QAAA,MAAM,uBAAuB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EA0B3B,CAAC;AAGH,KAAK,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAClE,KAAK,iBAAiB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,uBAAuB,CAAC,CAAC;AAClE,KAAK,sBAAsB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,uBAAuB,CAAC,CAAC;AACtE,MAAM,MAAM,YAAY,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,kBAAkB,CAAC,CAAC;AAC/D,MAAM,MAAM,wBAAwB,GAAG,CAAC,CAAC,MAAM,CAC7C,OAAO,8BAA8B,CACtC,CAAC;AAEF;;;;;;;GAOG;AACH,qBAAa,WAAY,SAAQ,UAAU,CACzC,iBAAiB,EACjB,iBAAiB,CAClB;IACC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAkB;IACxD,MAAM,CAAC,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA2B;IACjD,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA2B;IACvD,MAAM,CAAC,QAAQ,CAAC,gBAAgB,oGACmE;IACnG,MAAM,CAAC,QAAQ,CAAC,eAAe,wwCAmC7B;IACF,MAAM,CAAC,QAAQ,CAAC,KAAK,QAAQ;IAC7B,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;gBAG5B,MAAM,GAAE,sBAIP,EACD,OAAO,CAAC,EAAE,aAAa,EACvB,UAAU,CAAC,EAAE,MAAM;IAKf,aAAa,IAAI,OAAO,CAAC,iBAAiB,CAAC;IAsDjD;;OAEG;IACH,OAAO,CAAC,iBAAiB;IAiBzB;;OAEG;YACW,kBAAkB;IAwChC;;OAEG;YACW,mBAAmB;IAsDjC;;OAEG;YACW,mBAAmB;IAqCjC;;OAEG;IACH,OAAO,CAAC,eAAe;IA4BvB;;OAEG;IACH,OAAO,CAAC,gBAAgB;CAiBzB"}