@bubblelab/bubble-core 0.1.0

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

@@ -0,0 +1,155 @@
+import { z } from 'zod';
+import { ToolBubble } from '../../types/tool-bubble-class.js';
+import FirecrawlApp, {} from '@mendable/firecrawl-js';
+import { CredentialType } from '@bubblelab/shared-schemas';
+// Define the parameters schema - simplified like the MCP server
+const WebSearchToolParamsSchema = z.object({
+    query: z
+        .string()
+        .min(1, 'Search query is required')
+        .describe('The search query to execute'),
+    limit: z
+        .number()
+        .min(1, 'Minimum number of search results to return is 1')
+        .max(4, 'Maximum number of search results to return is 4')
+        .default(3)
+        .describe('Maximum number of search results to return'),
+    location: z
+        .string()
+        .optional()
+        .describe('Location parameter for search results (e.g., "us", "uk")'),
+    credentials: z
+        .record(z.nativeEnum(CredentialType), z.string())
+        .optional()
+        .describe('Required credentials including FIRECRAWL_API_KEY'),
+});
+// Result schema for validation
+const WebSearchToolResultSchema = z.object({
+    results: z
+        .array(z.object({
+        title: z.string().describe('Title of the search result'),
+        url: z.string().url().describe('URL of the search result'),
+        content: z.string().describe('Content snippet from the search result'),
+    }))
+        .describe('Array of search results with title, URL, and content'),
+    query: z.string().describe('The original search query'),
+    totalResults: z.number().describe('Number of results returned'),
+    searchEngine: z.string().describe('Search engine used (Firecrawl)'),
+    success: z.boolean().describe('Whether the search was successful'),
+    error: z.string().describe('Error message if search failed'),
+});
+export class WebSearchTool extends ToolBubble {
+    // Required static metadata
+    static bubbleName = 'web-search-tool';
+    static schema = WebSearchToolParamsSchema;
+    static resultSchema = WebSearchToolResultSchema;
+    static shortDescription = 'Performs web searches using Firecrawl to find current information from the web';
+    static longDescription = `
+    A comprehensive web search tool that uses Firecrawl to find current information from the web.
+    
+    Features:
+    - High-quality web search results with content extraction
+    - Configurable result limits (1-20 results)
+    - Location-based search for regional results
+    - Clean, structured content extraction from search results
+    - Requires FIRECRAWL_API_KEY credential
+    
+    Use cases:
+    - Finding current events and news
+    - Researching topics with web content
+    - Getting up-to-date information for decision making
+    - Answering questions that require web knowledge
+    - Market research and competitive analysis
+    - Real-time data gathering from the web
+  `;
+    static alias = 'websearch';
+    static type = 'tool';
+    constructor(params = { query: '' }, context) {
+        super(params, context);
+    }
+    async performAction(context) {
+        void context; // Context available but not currently used
+        const { query, limit, location } = 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 });
+            // 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,
+                },
+            };
+            // Add optional parameters if provided
+            if (location) {
+                searchOptions.location = location;
+            }
+            console.log('[WebSearchTool] Searching with params:', {
+                query,
+                ...searchOptions,
+            });
+            // Execute search using Firecrawl
+            const searchResult = await firecrawl.search(query, searchOptions);
+            // 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;
+            }
+            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');
+                }
+            }
+            // Transform Firecrawl results to our format
+            const results = resultsArray.map((item) => ({
+                title: item.title || item.name || 'No title',
+                url: item.url || item.link || '',
+                content: item.content ||
+                    item.description ||
+                    item.text ||
+                    item.markdown ||
+                    'No content available',
+            }));
+            return {
+                results,
+                query,
+                totalResults: results.length,
+                searchEngine: 'Firecrawl',
+                success: true,
+                error: '',
+            };
+        }
+        catch (error) {
+            console.error('[WebSearchTool] Search error:', error);
+            const errorMessage = error instanceof Error ? error.message : 'Unknown error';
+            return {
+                results: [],
+                query,
+                totalResults: 0,
+                searchEngine: 'Firecrawl',
+                success: false,
+                error: errorMessage,
+            };
+        }
+    }
+}
+//# sourceMappingURL=web-search-tool.js.map

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

@@ -0,0 +1 @@
+{"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/workflow-bubble/bubbleflow-generator.workflow.d.ts

@@ -0,0 +1,114 @@
+/**
+ * SIMPLE BUBBLEFLOW GENERATOR WORKFLOW
+ *
+ * A simplified BubbleFlow generator that uses AI agent with tools to generate
+ * and validate BubbleFlow code from natural language prompts.
+ *
+ * Much simpler than the complex workflow - just AI + validation tool!
+ */
+import { z } from 'zod';
+import { WorkflowBubble } from '../../types/workflow-bubble-class.js';
+import type { BubbleContext } from '../../types/bubble.js';
+import { CredentialType } from '@bubblelab/shared-schemas';
+import { type StreamingCallback } from '../service-bubble/ai-agent.js';
+/**
+ * Parameters schema for the simple BubbleFlow generator
+ */
+declare const BubbleFlowGeneratorParamsSchema: z.ZodObject<{
+    prompt: z.ZodString;
+    credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+}, "strip", z.ZodTypeAny, {
+    prompt: string;
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+}, {
+    prompt: string;
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
+}>;
+/**
+ * Result schema
+ */
+declare const BubbleFlowGeneratorResultSchema: z.ZodObject<{
+    generatedCode: z.ZodString;
+    isValid: z.ZodBoolean;
+    success: z.ZodBoolean;
+    error: z.ZodString;
+    toolCalls: z.ZodArray<z.ZodAny, "many">;
+    summary: z.ZodDefault<z.ZodString>;
+    inputsSchema: z.ZodDefault<z.ZodString>;
+}, "strip", z.ZodTypeAny, {
+    success: boolean;
+    error: string;
+    toolCalls: any[];
+    summary: string;
+    generatedCode: string;
+    isValid: boolean;
+    inputsSchema: string;
+}, {
+    success: boolean;
+    error: string;
+    toolCalls: any[];
+    generatedCode: string;
+    isValid: boolean;
+    summary?: string | undefined;
+    inputsSchema?: string | undefined;
+}>;
+type BubbleFlowGeneratorParams = z.output<typeof BubbleFlowGeneratorParamsSchema>;
+type BubbleFlowGeneratorResult = z.output<typeof BubbleFlowGeneratorResultSchema>;
+/**
+ * Simple BubbleFlow Generator using AI agent with tools
+ */
+export declare class BubbleFlowGeneratorWorkflow extends WorkflowBubble<BubbleFlowGeneratorParams, BubbleFlowGeneratorResult> {
+    static readonly type: "workflow";
+    static readonly bubbleName = "bubbleflow-generator";
+    static readonly schema: z.ZodObject<{
+        prompt: z.ZodString;
+        credentials: z.ZodOptional<z.ZodRecord<z.ZodNativeEnum<typeof CredentialType>, z.ZodString>>;
+    }, "strip", z.ZodTypeAny, {
+        prompt: string;
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+    }, {
+        prompt: string;
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
+    }>;
+    static readonly resultSchema: z.ZodObject<{
+        generatedCode: z.ZodString;
+        isValid: z.ZodBoolean;
+        success: z.ZodBoolean;
+        error: z.ZodString;
+        toolCalls: z.ZodArray<z.ZodAny, "many">;
+        summary: z.ZodDefault<z.ZodString>;
+        inputsSchema: z.ZodDefault<z.ZodString>;
+    }, "strip", z.ZodTypeAny, {
+        success: boolean;
+        error: string;
+        toolCalls: any[];
+        summary: string;
+        generatedCode: string;
+        isValid: boolean;
+        inputsSchema: string;
+    }, {
+        success: boolean;
+        error: string;
+        toolCalls: any[];
+        generatedCode: string;
+        isValid: boolean;
+        summary?: string | undefined;
+        inputsSchema?: string | undefined;
+    }>;
+    static readonly shortDescription = "Generate BubbleFlow code from natural language";
+    static readonly longDescription = "\n    Simple BubbleFlow generator that uses AI with validation tools.\n    \n    Just provide a natural language prompt describing what you want your BubbleFlow to do,\n    and it will generate complete TypeScript code with proper validation.\n    \n    Example prompts:\n    - \"Create a flow that queries my database and sends results to Slack\"\n    - \"Build a workflow that processes user data with AI and stores it\"\n    - \"Make a flow that analyzes text and generates a summary\"\n  ";
+    static readonly alias = "generate-flow";
+    private bubbleFactory;
+    constructor(params: z.input<typeof BubbleFlowGeneratorParamsSchema>, context?: BubbleContext);
+    private runValidationAgent;
+    private runSummarizeAgent;
+    private createSystemPrompt;
+    private createStreamingSystemPrompt;
+    protected performAction(context?: BubbleContext): Promise<BubbleFlowGeneratorResult>;
+    /**
+     * Execute the workflow with streaming support for real-time code generation feedback
+     */
+    actionWithStreaming(streamingCallback: StreamingCallback, context?: BubbleContext): Promise<BubbleFlowGeneratorResult>;
+}
+export {};
+//# sourceMappingURL=bubbleflow-generator.workflow.d.ts.map

package/dist/bubbles/workflow-bubble/bubbleflow-generator.workflow.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"bubbleflow-generator.workflow.d.ts","sourceRoot":"","sources":["../../../src/bubbles/workflow-bubble/bubbleflow-generator.workflow.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,cAAc,EAAE,MAAM,sCAAsC,CAAC;AACtE,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,uBAAuB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAC3D,OAAO,EAEL,KAAK,iBAAiB,EACvB,MAAM,+BAA+B,CAAC;AAiCvC;;GAEG;AACH,QAAA,MAAM,+BAA+B;;;;;;;;;EAUnC,CAAC;AAEH;;GAEG;AACH,QAAA,MAAM,+BAA+B;;;;;;;;;;;;;;;;;;;;;;;;EAgBnC,CAAC;AAEH,KAAK,yBAAyB,GAAG,CAAC,CAAC,MAAM,CACvC,OAAO,+BAA+B,CACvC,CAAC;AACF,KAAK,yBAAyB,GAAG,CAAC,CAAC,MAAM,CACvC,OAAO,+BAA+B,CACvC,CAAC;AA0DF;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,cAAc,CAC7D,yBAAyB,EACzB,yBAAyB,CAC1B;IACC,MAAM,CAAC,QAAQ,CAAC,IAAI,EAAG,UAAU,CAAU;IAC3C,MAAM,CAAC,QAAQ,CAAC,UAAU,0BAA0B;IACpD,MAAM,CAAC,QAAQ,CAAC,MAAM;;;;;;;;;OAAmC;IACzD,MAAM,CAAC,QAAQ,CAAC,YAAY;;;;;;;;;;;;;;;;;;;;;;;;OAAmC;IAC/D,MAAM,CAAC,QAAQ,CAAC,gBAAgB,oDACmB;IACnD,MAAM,CAAC,QAAQ,CAAC,eAAe,kfAU7B;IACF,MAAM,CAAC,QAAQ,CAAC,KAAK,mBAAmB;IAExC,OAAO,CAAC,aAAa,CAAgB;gBAGnC,MAAM,EAAE,CAAC,CAAC,KAAK,CAAC,OAAO,+BAA+B,CAAC,EACvD,OAAO,CAAC,EAAE,aAAa;YAMX,kBAAkB;YAmHlB,iBAAiB;IAkF/B,OAAO,CAAC,kBAAkB;IAmB1B,OAAO,CAAC,2BAA2B;cAmBnB,aAAa,CAC3B,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,yBAAyB,CAAC;IAiPrC;;OAEG;IACU,mBAAmB,CAC9B,iBAAiB,EAAE,iBAAiB,EACpC,OAAO,CAAC,EAAE,aAAa,GACtB,OAAO,CAAC,yBAAyB,CAAC;CAiXtC"}