@bubblelab/bubble-core 0.1.0

package/dist/bubbles/tool-bubble/web-scrape-tool.d.ts

@@ -0,0 +1,228 @@
+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 WebScrapeToolParamsSchema: z.ZodObject<{
+    url: z.ZodString;
+    format: z.ZodDefault<z.ZodEnum<["markdown"]>>;
+    onlyMainContent: z.ZodDefault<z.ZodBoolean>;
+    actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+        type: z.ZodEnum<["wait", "click", "write", "press", "scroll", "executeJavascript"]>;
+        milliseconds: z.ZodOptional<z.ZodNumber>;
+        selector: z.ZodOptional<z.ZodString>;
+        text: z.ZodOptional<z.ZodString>;
+        key: z.ZodOptional<z.ZodString>;
+        direction: z.ZodOptional<z.ZodEnum<["up", "down"]>>;
+        script: z.ZodOptional<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        type: "wait" | "click" | "write" | "press" | "scroll" | "executeJavascript";
+        script?: string | undefined;
+        text?: string | undefined;
+        key?: string | undefined;
+        milliseconds?: number | undefined;
+        selector?: string | undefined;
+        direction?: "up" | "down" | undefined;
+    }, {
+        type: "wait" | "click" | "write" | "press" | "scroll" | "executeJavascript";
+        script?: string | undefined;
+        text?: string | undefined;
+        key?: string | undefined;
+        milliseconds?: number | undefined;
+        selector?: string | undefined;
+        direction?: "up" | "down" | undefined;
+    }>, "many">>;
+    headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    waitFor: z.ZodDefault<z.ZodNumber>;
+    credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    format: "markdown";
+    url: string;
+    onlyMainContent: boolean;
+    waitFor: number;
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    headers?: Record<string, string> | undefined;
+    actions?: {
+        type: "wait" | "click" | "write" | "press" | "scroll" | "executeJavascript";
+        script?: string | undefined;
+        text?: string | undefined;
+        key?: string | undefined;
+        milliseconds?: number | undefined;
+        selector?: string | undefined;
+        direction?: "up" | "down" | undefined;
+    }[] | undefined;
+}, {
+    url: string;
+    format?: "markdown" | undefined;
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    onlyMainContent?: boolean | undefined;
+    waitFor?: number | undefined;
+    headers?: Record<string, string> | undefined;
+    actions?: {
+        type: "wait" | "click" | "write" | "press" | "scroll" | "executeJavascript";
+        script?: string | undefined;
+        text?: string | undefined;
+        key?: string | undefined;
+        milliseconds?: number | undefined;
+        selector?: string | undefined;
+        direction?: "up" | "down" | undefined;
+    }[] | undefined;
+}>;
+declare const WebScrapeToolResultSchema: z.ZodObject<{
+    content: z.ZodString;
+    title: z.ZodString;
+    url: z.ZodString;
+    format: z.ZodString;
+    success: z.ZodBoolean;
+    error: z.ZodString;
+    metadata: z.ZodOptional<z.ZodObject<{
+        statusCode: z.ZodOptional<z.ZodNumber>;
+        loadTime: z.ZodOptional<z.ZodNumber>;
+    }, "strip", z.ZodTypeAny, {
+        loadTime?: number | undefined;
+        statusCode?: number | undefined;
+    }, {
+        loadTime?: number | undefined;
+        statusCode?: number | undefined;
+    }>>;
+}, "strip", z.ZodTypeAny, {
+    format: string;
+    title: string;
+    success: boolean;
+    error: string;
+    content: string;
+    url: string;
+    metadata?: {
+        loadTime?: number | undefined;
+        statusCode?: number | undefined;
+    } | undefined;
+}, {
+    format: string;
+    title: string;
+    success: boolean;
+    error: string;
+    content: string;
+    url: string;
+    metadata?: {
+        loadTime?: number | undefined;
+        statusCode?: number | undefined;
+    } | undefined;
+}>;
+type WebScrapeToolParams = z.output<typeof WebScrapeToolParamsSchema>;
+type WebScrapeToolResult = z.output<typeof WebScrapeToolResultSchema>;
+type WebScrapeToolParamsInput = z.input<typeof WebScrapeToolParamsSchema>;
+export declare class WebScrapeTool extends ToolBubble<WebScrapeToolParams, WebScrapeToolResult> {
+    static readonly bubbleName: BubbleName;
+    static readonly schema: z.ZodObject<{
+        url: z.ZodString;
+        format: z.ZodDefault<z.ZodEnum<["markdown"]>>;
+        onlyMainContent: z.ZodDefault<z.ZodBoolean>;
+        actions: z.ZodOptional<z.ZodArray<z.ZodObject<{
+            type: z.ZodEnum<["wait", "click", "write", "press", "scroll", "executeJavascript"]>;
+            milliseconds: z.ZodOptional<z.ZodNumber>;
+            selector: z.ZodOptional<z.ZodString>;
+            text: z.ZodOptional<z.ZodString>;
+            key: z.ZodOptional<z.ZodString>;
+            direction: z.ZodOptional<z.ZodEnum<["up", "down"]>>;
+            script: z.ZodOptional<z.ZodString>;
+        }, "strip", z.ZodTypeAny, {
+            type: "wait" | "click" | "write" | "press" | "scroll" | "executeJavascript";
+            script?: string | undefined;
+            text?: string | undefined;
+            key?: string | undefined;
+            milliseconds?: number | undefined;
+            selector?: string | undefined;
+            direction?: "up" | "down" | undefined;
+        }, {
+            type: "wait" | "click" | "write" | "press" | "scroll" | "executeJavascript";
+            script?: string | undefined;
+            text?: string | undefined;
+            key?: string | undefined;
+            milliseconds?: number | undefined;
+            selector?: string | undefined;
+            direction?: "up" | "down" | undefined;
+        }>, "many">>;
+        headers: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        waitFor: z.ZodDefault<z.ZodNumber>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        format: "markdown";
+        url: string;
+        onlyMainContent: boolean;
+        waitFor: number;
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        headers?: Record<string, string> | undefined;
+        actions?: {
+            type: "wait" | "click" | "write" | "press" | "scroll" | "executeJavascript";
+            script?: string | undefined;
+            text?: string | undefined;
+            key?: string | undefined;
+            milliseconds?: number | undefined;
+            selector?: string | undefined;
+            direction?: "up" | "down" | undefined;
+        }[] | undefined;
+    }, {
+        url: string;
+        format?: "markdown" | undefined;
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        onlyMainContent?: boolean | undefined;
+        waitFor?: number | undefined;
+        headers?: Record<string, string> | undefined;
+        actions?: {
+            type: "wait" | "click" | "write" | "press" | "scroll" | "executeJavascript";
+            script?: string | undefined;
+            text?: string | undefined;
+            key?: string | undefined;
+            milliseconds?: number | undefined;
+            selector?: string | undefined;
+            direction?: "up" | "down" | undefined;
+        }[] | undefined;
+    }>;
+    static readonly resultSchema: z.ZodObject<{
+        content: z.ZodString;
+        title: z.ZodString;
+        url: z.ZodString;
+        format: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodString;
+        metadata: z.ZodOptional<z.ZodObject<{
+            statusCode: z.ZodOptional<z.ZodNumber>;
+            loadTime: z.ZodOptional<z.ZodNumber>;
+        }, "strip", z.ZodTypeAny, {
+            loadTime?: number | undefined;
+            statusCode?: number | undefined;
+        }, {
+            loadTime?: number | undefined;
+            statusCode?: number | undefined;
+        }>>;
+    }, "strip", z.ZodTypeAny, {
+        format: string;
+        title: string;
+        success: boolean;
+        error: string;
+        content: string;
+        url: string;
+        metadata?: {
+            loadTime?: number | undefined;
+            statusCode?: number | undefined;
+        } | undefined;
+    }, {
+        format: string;
+        title: string;
+        success: boolean;
+        error: string;
+        content: string;
+        url: string;
+        metadata?: {
+            loadTime?: number | undefined;
+            statusCode?: number | undefined;
+        } | undefined;
+    }>;
+    static readonly shortDescription = "Scrapes content from a single web page using Firecrawl, good to use after web-search-tool to get the full content of a page";
+    static readonly longDescription = "\n    A simple and powerful web scraping tool that extracts content from any web page.\n    \n    Features:\n    - Clean content extraction with main content focus\n    - Multiple format support (markdown, html, rawHtml)\n    - Fast and reliable using Firecrawl\n    - Handles JavaScript-rendered pages\n    - Optional browser automation for authentication flows\n    - Custom headers support for session-based scraping\n    - Requires FIRECRAWL_API_KEY credential\n    \n    Basic use cases:\n    - Extract article content for analysis\n    - Scrape product information from e-commerce sites\n    - Get clean text from documentation pages\n    - Extract data from any public web page\n    \n    Advanced use cases (with actions):\n    - Login and scrape protected content\n    - Navigate multi-step authentication flows\n    - Interact with dynamic content requiring clicks/scrolls\n    - Execute custom JavaScript for complex scenarios\n  ";
+    static readonly alias = "scrape";
+    static readonly type = "tool";
+    constructor(params?: WebScrapeToolParamsInput, context?: BubbleContext);
+    performAction(): Promise<WebScrapeToolResult>;
+}
+export {};
+//# sourceMappingURL=web-scrape-tool.d.ts.map

package/dist/bubbles/tool-bubble/web-scrape-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-scrape-tool.d.ts","sourceRoot":"","sources":["../../../src/bubbles/tool-bubble/web-scrape-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;AAE3D,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAgC5E,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAmC7B,CAAC;AAGH,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAc7B,CAAC;AAGH,KAAK,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACtE,KAAK,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACtE,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE1E,qBAAa,aAAc,SAAQ,UAAU,CAC3C,mBAAmB,EACnB,mBAAmB,CACpB;IAEC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAqB;IAC3D,MAAM,CAAC,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA6B;IACnD,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA6B;IACzD,MAAM,CAAC,QAAQ,CAAC,gBAAgB,iIACgG;IAChI,MAAM,CAAC,QAAQ,CAAC,eAAe,m7BAuB7B;IACF,MAAM,CAAC,QAAQ,CAAC,KAAK,YAAY;IACjC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;gBAG5B,MAAM,GAAE,wBAAsC,EAC9C,OAAO,CAAC,EAAE,aAAa;IAKnB,aAAa,IAAI,OAAO,CAAC,mBAAmB,CAAC;CAgIpD"}

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

@@ -0,0 +1,214 @@
+import { z } from 'zod';
+import { ToolBubble } from '../../types/tool-bubble-class.js';
+import FirecrawlApp from '@mendable/firecrawl-js';
+import { CredentialType } from '@bubblelab/shared-schemas';
+import { AIAgentBubble } from '../service-bubble/ai-agent.js';
+// Action types for browser automation (Gemini-compatible: avoid const/anyOf)
+const ActionSchema = z.object({
+    type: z
+        .enum(['wait', 'click', 'write', 'press', 'scroll', 'executeJavascript'])
+        .describe('Action type to perform'),
+    milliseconds: z
+        .number()
+        .optional()
+        .describe('Time to wait in milliseconds (for wait)'),
+    selector: z
+        .string()
+        .optional()
+        .describe('CSS selector to interact with (wait/click/write/scroll)'),
+    text: z.string().optional().describe('Text to write (for write)'),
+    key: z
+        .string()
+        .optional()
+        .describe('Key to press (e.g., "Enter") (for press)'),
+    direction: z
+        .enum(['up', 'down'])
+        .optional()
+        .describe('Scroll direction (for scroll)'),
+    script: z
+        .string()
+        .optional()
+        .describe('JavaScript code (for executeJavascript)'),
+});
+// Simple, focused parameters with optional advanced features
+const WebScrapeToolParamsSchema = z.object({
+    url: z
+        .string()
+        .url('Must be a valid URL')
+        .describe('The URL to scrape content from'),
+    format: z
+        .enum(['markdown'])
+        .default('markdown')
+        .describe('Content format to extract (default: markdown)'),
+    onlyMainContent: z
+        .boolean()
+        .default(true)
+        .describe('Extract only main content, filtering out navigation/footers'),
+    actions: z
+        .array(ActionSchema)
+        .optional()
+        .describe('Optional browser actions for authentication/navigation (e.g., login flows)'),
+    headers: z
+        .record(z.string())
+        .optional()
+        .describe('Optional HTTP headers (e.g., for session cookies)'),
+    waitFor: z
+        .number()
+        .min(0)
+        .max(30000)
+        .default(3000)
+        .describe('Time to wait for dynamic content in milliseconds (default: 3000)'),
+    credentials: z
+        .record(z.nativeEnum(CredentialType), z.string())
+        .optional()
+        .describe('Required credentials including FIRECRAWL_API_KEY'),
+});
+// Result schema
+const WebScrapeToolResultSchema = z.object({
+    content: z.string().describe('Scraped content in requested format'),
+    title: z.string().describe('Page title if available'),
+    url: z.string().url().describe('The original URL that was scraped'),
+    format: z.string().describe('Format of the returned content'),
+    success: z.boolean().describe('Whether the scraping was successful'),
+    error: z.string().describe('Error message if scraping failed'),
+    metadata: z
+        .object({
+        statusCode: z.number().optional(),
+        loadTime: z.number().optional(),
+    })
+        .optional()
+        .describe('Additional metadata about the scrape'),
+});
+export class WebScrapeTool extends ToolBubble {
+    // Required static metadata
+    static bubbleName = 'web-scrape-tool';
+    static schema = WebScrapeToolParamsSchema;
+    static resultSchema = WebScrapeToolResultSchema;
+    static shortDescription = 'Scrapes content from a single web page using Firecrawl, good to use after web-search-tool to get the full content of a page';
+    static longDescription = `
+    A simple and powerful web scraping tool that extracts content from any web page.
+    
+    Features:
+    - Clean content extraction with main content focus
+    - Multiple format support (markdown, html, rawHtml)
+    - Fast and reliable using Firecrawl
+    - Handles JavaScript-rendered pages
+    - Optional browser automation for authentication flows
+    - Custom headers support for session-based scraping
+    - Requires FIRECRAWL_API_KEY credential
+    
+    Basic use cases:
+    - Extract article content for analysis
+    - Scrape product information from e-commerce sites
+    - Get clean text from documentation pages
+    - Extract data from any public web page
+    
+    Advanced use cases (with actions):
+    - Login and scrape protected content
+    - Navigate multi-step authentication flows
+    - Interact with dynamic content requiring clicks/scrolls
+    - Execute custom JavaScript for complex scenarios
+  `;
+    static alias = 'scrape';
+    static type = 'tool';
+    constructor(params = { url: '' }, context) {
+        super(params, context);
+    }
+    async performAction() {
+        const { url, format, onlyMainContent, actions, headers, waitFor } = this.params;
+        const startTime = Date.now();
+        try {
+            // 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 });
+            console.log('[WebScrapeTool] Scraping URL:', url, 'with format:', format);
+            // Configure scraping options
+            const scrapeOptions = {
+                formats: [format],
+                onlyMainContent,
+                // Sensible defaults for most use cases
+                removeBase64Images: true,
+                waitFor,
+            };
+            // Add optional parameters if provided
+            if (actions && actions.length > 0) {
+                console.log('[WebScrapeTool] Using browser actions:', actions.length, 'steps');
+                scrapeOptions.actions = actions;
+            }
+            if (headers) {
+                console.log('[WebScrapeTool] Using custom headers');
+                scrapeOptions.headers = headers;
+            }
+            // Execute scrape
+            const response = await firecrawl.scrape(url, scrapeOptions);
+            // Extract content based on format
+            let content;
+            let title = '';
+            if (format === 'markdown' && response.markdown) {
+                content = response.markdown;
+            }
+            else {
+                throw new Error(`No content available in ${format} format`);
+            }
+            // Summarize the scraped content for better consumption
+            if (content && content.length > 500) {
+                try {
+                    const summarizeAgent = new AIAgentBubble({
+                        message: `Summarize the scraped content to condense all information and remove any non-essential information, include all links, contact information, companies, don't omit any information. Content: ${content}`,
+                        model: {
+                            model: 'google/gemini-2.5-flash-lite',
+                        },
+                        name: 'Scrape Content Summarizer Agent',
+                        credentials: this.params.credentials,
+                    }, this.context);
+                    const result = await summarizeAgent.action();
+                    if (result.data?.response) {
+                        console.log('[WebScrapeTool] Summarized scraped content for:', url, result.data.response);
+                        content = result.data.response;
+                    }
+                }
+                catch (error) {
+                    console.error('[WebScrapeTool] Error summarizing content:', url, error);
+                    // Keep original content if summarization fails
+                }
+            }
+            // Extract title from metadata
+            if (response.metadata?.title) {
+                title = response.metadata.title;
+            }
+            const loadTime = Date.now() - startTime;
+            return {
+                content: content.trim(),
+                title,
+                url,
+                format,
+                success: true,
+                error: '',
+                metadata: {
+                    statusCode: response.metadata?.statusCode,
+                    loadTime,
+                },
+            };
+        }
+        catch (error) {
+            console.error('[WebScrapeTool] Scrape error:', error);
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                content: '',
+                title: '',
+                url,
+                format,
+                success: false,
+                error: errorMessage,
+                metadata: {
+                    loadTime: Date.now() - startTime,
+                },
+            };
+        }
+    }
+}
+//# sourceMappingURL=web-scrape-tool.js.map

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

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

package/dist/bubbles/tool-bubble/web-search-tool.d.ts

@@ -0,0 +1,134 @@
+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 WebSearchToolParamsSchema: z.ZodObject<{
+    query: z.ZodString;
+    limit: z.ZodDefault<z.ZodNumber>;
+    location: z.ZodOptional<z.ZodString>;
+    credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    query: string;
+    limit: number;
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    location?: string | undefined;
+}, {
+    query: string;
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    limit?: number | undefined;
+    location?: string | undefined;
+}>;
+declare const WebSearchToolResultSchema: z.ZodObject<{
+    results: z.ZodArray<z.ZodObject<{
+        title: z.ZodString;
+        url: z.ZodString;
+        content: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        title: string;
+        content: string;
+        url: string;
+    }, {
+        title: string;
+        content: string;
+        url: string;
+    }>, "many">;
+    query: z.ZodString;
+    totalResults: z.ZodNumber;
+    searchEngine: z.ZodString;
+    success: z.ZodBoolean;
+    error: z.ZodString;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    error: string;
+    query: string;
+    results: {
+        title: string;
+        content: string;
+        url: string;
+    }[];
+    totalResults: number;
+    searchEngine: string;
+}, {
+    success: boolean;
+    error: string;
+    query: string;
+    results: {
+        title: string;
+        content: string;
+        url: string;
+    }[];
+    totalResults: number;
+    searchEngine: string;
+}>;
+type WebSearchToolParams = z.output<typeof WebSearchToolParamsSchema>;
+type WebSearchToolResult = z.output<typeof WebSearchToolResultSchema>;
+type WebSearchToolParamsInput = z.input<typeof WebSearchToolParamsSchema>;
+export declare class WebSearchTool extends ToolBubble<WebSearchToolParams, WebSearchToolResult> {
+    static readonly bubbleName: BubbleName;
+    static readonly schema: z.ZodObject<{
+        query: z.ZodString;
+        limit: z.ZodDefault<z.ZodNumber>;
+        location: z.ZodOptional<z.ZodString>;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        query: string;
+        limit: number;
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        location?: string | undefined;
+    }, {
+        query: string;
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        limit?: number | undefined;
+        location?: string | undefined;
+    }>;
+    static readonly resultSchema: z.ZodObject<{
+        results: z.ZodArray<z.ZodObject<{
+            title: z.ZodString;
+            url: z.ZodString;
+            content: z.ZodString;
+        }, "strip", z.ZodTypeAny, {
+            title: string;
+            content: string;
+            url: string;
+        }, {
+            title: string;
+            content: string;
+            url: string;
+        }>, "many">;
+        query: z.ZodString;
+        totalResults: z.ZodNumber;
+        searchEngine: z.ZodString;
+        success: z.ZodBoolean;
+        error: z.ZodString;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        error: string;
+        query: string;
+        results: {
+            title: string;
+            content: string;
+            url: string;
+        }[];
+        totalResults: number;
+        searchEngine: string;
+    }, {
+        success: boolean;
+        error: string;
+        query: string;
+        results: {
+            title: string;
+            content: string;
+            url: string;
+        }[];
+        totalResults: number;
+        searchEngine: string;
+    }>;
+    static readonly shortDescription = "Performs web searches using Firecrawl to find current information from the web";
+    static readonly longDescription = "\n    A comprehensive web search tool that uses Firecrawl to find current information from the web.\n    \n    Features:\n    - High-quality web search results with content extraction\n    - Configurable result limits (1-20 results)\n    - Location-based search for regional results\n    - Clean, structured content extraction from search results\n    - Requires FIRECRAWL_API_KEY credential\n    \n    Use cases:\n    - Finding current events and news\n    - Researching topics with web content\n    - Getting up-to-date information for decision making\n    - Answering questions that require web knowledge\n    - Market research and competitive analysis\n    - Real-time data gathering from the web\n  ";
+    static readonly alias = "websearch";
+    static readonly type = "tool";
+    constructor(params?: WebSearchToolParamsInput, context?: BubbleContext);
+    performAction(context?: BubbleContext): Promise<WebSearchToolResult>;
+}
+export {};
+//# sourceMappingURL=web-search-tool.d.ts.map

package/dist/bubbles/tool-bubble/web-search-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web-search-tool.d.ts","sourceRoot":"","sources":["../../../src/bubbles/tool-bubble/web-search-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;AAE3D,OAAO,EAAE,cAAc,EAAE,KAAK,UAAU,EAAE,MAAM,2BAA2B,CAAC;AAoB5E,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;EAmB7B,CAAC;AAGH,QAAA,MAAM,yBAAyB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;EAe7B,CAAC;AAGH,KAAK,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACtE,KAAK,mBAAmB,GAAG,CAAC,CAAC,MAAM,CAAC,OAAO,yBAAyB,CAAC,CAAC;AACtE,KAAK,wBAAwB,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,yBAAyB,CAAC,CAAC;AAE1E,qBAAa,aAAc,SAAQ,UAAU,CAC3C,mBAAmB,EACnB,mBAAmB,CACpB;IAEC,MAAM,CAAC,QAAQ,CAAC,UAAU,EAAE,UAAU,CAAqB;IAC3D,MAAM,CAAC,QAAQ,CAAC,MAAM;;;;;;;;;;;;;;;OAA6B;IACnD,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAA6B;IACzD,MAAM,CAAC,QAAQ,CAAC,gBAAgB,oFACmD;IACnF,MAAM,CAAC,QAAQ,CAAC,eAAe,ssBAiB7B;IACF,MAAM,CAAC,QAAQ,CAAC,KAAK,eAAe;IACpC,MAAM,CAAC,QAAQ,CAAC,IAAI,UAAU;gBAG5B,MAAM,GAAE,wBAAwC,EAChD,OAAO,CAAC,EAAE,aAAa;IAKnB,aAAa,CAAC,OAAO,CAAC,EAAE,aAAa,GAAG,OAAO,CAAC,mBAAmB,CAAC;CAoG3E"}