@bubblelab/bubble-core 0.1.76 → 0.1.78

package/dist/bubbles/workflow-bubble/slack-formatter-agent.d.ts

@@ -41,6 +41,11 @@ declare const SlackFormatterAgentParamsSchema: z.ZodObject<{
     additionalContext: z.ZodOptional<z.ZodString>;
 }, "strip", z.ZodTypeAny, {
     message: string;
+    verbosity: "1" | "2" | "3" | "4" | "5";
+    technicality: "1" | "2" | "3" | "4" | "5";
+    includeBlockKit: boolean;
+    includeQuery: boolean;
+    includeExplanation: boolean;
     model: {
         model: "openai/gpt-5" | "openai/gpt-5-mini" | "openai/gpt-5.1" | "openai/gpt-5.2" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-image-preview" | "google/gemini-3-pro-preview" | "google/gemini-3-pro-image-preview" | "google/gemini-3-flash-preview" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-opus-4-5" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | "openrouter/anthropic/claude-sonnet-4.5" | "openrouter/google/gemini-3-pro-preview" | "openrouter/morph/morph-v3-large" | "openrouter/openai/gpt-oss-120b" | "openrouter/openai/o3-deep-research" | "openrouter/openai/o4-mini-deep-research";
         temperature: number;
@@ -52,32 +57,27 @@ declare const SlackFormatterAgentParamsSchema: z.ZodObject<{
         config?: Record<string, unknown> | undefined;
     }[];
     maxIterations: number;
-    verbosity: "1" | "2" | "3" | "4" | "5";
-    technicality: "1" | "2" | "3" | "4" | "5";
-    includeBlockKit: boolean;
-    includeQuery: boolean;
-    includeExplanation: boolean;
     credentials?: Partial<Record<CredentialType, string>> | undefined;
     additionalContext?: string | undefined;
 }, {
     message: string;
-    credentials?: Partial<Record<CredentialType, string>> | undefined;
+    verbosity?: "1" | "2" | "3" | "4" | "5" | undefined;
+    technicality?: "1" | "2" | "3" | "4" | "5" | undefined;
+    includeBlockKit?: boolean | undefined;
+    includeQuery?: boolean | undefined;
+    includeExplanation?: boolean | undefined;
     model?: {
         model?: "openai/gpt-5" | "openai/gpt-5-mini" | "openai/gpt-5.1" | "openai/gpt-5.2" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-image-preview" | "google/gemini-3-pro-preview" | "google/gemini-3-pro-image-preview" | "google/gemini-3-flash-preview" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-opus-4-5" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | "openrouter/anthropic/claude-sonnet-4.5" | "openrouter/google/gemini-3-pro-preview" | "openrouter/morph/morph-v3-large" | "openrouter/openai/gpt-oss-120b" | "openrouter/openai/o3-deep-research" | "openrouter/openai/o4-mini-deep-research" | undefined;
         temperature?: number | undefined;
         maxTokens?: number | undefined;
     } | undefined;
+    credentials?: Partial<Record<CredentialType, string>> | undefined;
     tools?: {
         name: string;
         credentials?: Partial<Record<CredentialType, string>> | undefined;
         config?: Record<string, unknown> | undefined;
     }[] | undefined;
     maxIterations?: number | undefined;
-    verbosity?: "1" | "2" | "3" | "4" | "5" | undefined;
-    technicality?: "1" | "2" | "3" | "4" | "5" | undefined;
-    includeBlockKit?: boolean | undefined;
-    includeQuery?: boolean | undefined;
-    includeExplanation?: boolean | undefined;
     additionalContext?: string | undefined;
 }>;
 declare const SlackFormatterAgentResultSchema: z.ZodObject<{
@@ -154,7 +154,7 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+        type: "section" | "header" | "divider" | "context" | "actions" | "input" | "file" | "image";
         title?: {
             type: "plain_text";
             text: string;
@@ -166,28 +166,28 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         } | undefined;
-        image_url?: string | undefined;
-        optional?: boolean | undefined;
+        block_id?: string | undefined;
+        accessory?: unknown;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
+        element?: unknown;
+        label?: unknown;
+        hint?: unknown;
+        optional?: boolean | undefined;
         alt_text?: string | undefined;
+        image_url?: string | undefined;
         elements?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
-        block_id?: string | undefined;
-        accessory?: unknown;
-        element?: unknown;
-        label?: unknown;
-        hint?: unknown;
     }, {
-        type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+        type: "section" | "header" | "divider" | "context" | "actions" | "input" | "file" | "image";
         title?: {
             type: "plain_text";
             text: string;
@@ -199,26 +199,26 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         } | undefined;
-        image_url?: string | undefined;
-        optional?: boolean | undefined;
+        block_id?: string | undefined;
+        accessory?: unknown;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
+        element?: unknown;
+        label?: unknown;
+        hint?: unknown;
+        optional?: boolean | undefined;
         alt_text?: string | undefined;
+        image_url?: string | undefined;
         elements?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
-        block_id?: string | undefined;
-        accessory?: unknown;
-        element?: unknown;
-        label?: unknown;
-        hint?: unknown;
     }>, "many">>;
     metadata: z.ZodObject<{
         verbosityLevel: z.ZodString;
@@ -253,23 +253,18 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
     error: z.ZodString;
     success: z.ZodBoolean;
 }, "strip", z.ZodTypeAny, {
-    error: string;
-    success: boolean;
+    response: string;
     metadata: {
         verbosityLevel: string;
         technicalityLevel: string;
         wordCount: number;
         blockCount?: number | undefined;
     };
-    response: string;
     iterations: number;
-    toolCalls?: {
-        tool: string;
-        input?: unknown;
-        output?: unknown;
-    }[] | undefined;
+    error: string;
+    success: boolean;
     blocks?: {
-        type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+        type: "section" | "header" | "divider" | "context" | "actions" | "input" | "file" | "image";
         title?: {
             type: "plain_text";
             text: string;
@@ -281,45 +276,45 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         } | undefined;
-        image_url?: string | undefined;
-        optional?: boolean | undefined;
+        block_id?: string | undefined;
+        accessory?: unknown;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
+        element?: unknown;
+        label?: unknown;
+        hint?: unknown;
+        optional?: boolean | undefined;
         alt_text?: string | undefined;
+        image_url?: string | undefined;
         elements?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
-        block_id?: string | undefined;
-        accessory?: unknown;
-        element?: unknown;
-        label?: unknown;
-        hint?: unknown;
+    }[] | undefined;
+    toolCalls?: {
+        tool: string;
+        input?: unknown;
+        output?: unknown;
     }[] | undefined;
 }, {
-    error: string;
-    success: boolean;
+    response: string;
     metadata: {
         verbosityLevel: string;
         technicalityLevel: string;
         wordCount: number;
         blockCount?: number | undefined;
     };
-    response: string;
     iterations: number;
-    toolCalls?: {
-        tool: string;
-        input?: unknown;
-        output?: unknown;
-    }[] | undefined;
+    error: string;
+    success: boolean;
     blocks?: {
-        type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+        type: "section" | "header" | "divider" | "context" | "actions" | "input" | "file" | "image";
         title?: {
             type: "plain_text";
             text: string;
@@ -331,26 +326,31 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         } | undefined;
-        image_url?: string | undefined;
-        optional?: boolean | undefined;
+        block_id?: string | undefined;
+        accessory?: unknown;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
+        element?: unknown;
+        label?: unknown;
+        hint?: unknown;
+        optional?: boolean | undefined;
         alt_text?: string | undefined;
+        image_url?: string | undefined;
         elements?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
-        block_id?: string | undefined;
-        accessory?: unknown;
-        element?: unknown;
-        label?: unknown;
-        hint?: unknown;
+    }[] | undefined;
+    toolCalls?: {
+        tool: string;
+        input?: unknown;
+        output?: unknown;
     }[] | undefined;
 }>;
 type SlackFormatterAgentParams = z.input<typeof SlackFormatterAgentParamsSchema>;
@@ -399,6 +399,11 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
         additionalContext: z.ZodOptional<z.ZodString>;
     }, "strip", z.ZodTypeAny, {
         message: string;
+        verbosity: "1" | "2" | "3" | "4" | "5";
+        technicality: "1" | "2" | "3" | "4" | "5";
+        includeBlockKit: boolean;
+        includeQuery: boolean;
+        includeExplanation: boolean;
         model: {
             model: "openai/gpt-5" | "openai/gpt-5-mini" | "openai/gpt-5.1" | "openai/gpt-5.2" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-image-preview" | "google/gemini-3-pro-preview" | "google/gemini-3-pro-image-preview" | "google/gemini-3-flash-preview" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-opus-4-5" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | "openrouter/anthropic/claude-sonnet-4.5" | "openrouter/google/gemini-3-pro-preview" | "openrouter/morph/morph-v3-large" | "openrouter/openai/gpt-oss-120b" | "openrouter/openai/o3-deep-research" | "openrouter/openai/o4-mini-deep-research";
             temperature: number;
@@ -410,32 +415,27 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
             config?: Record<string, unknown> | undefined;
         }[];
         maxIterations: number;
-        verbosity: "1" | "2" | "3" | "4" | "5";
-        technicality: "1" | "2" | "3" | "4" | "5";
-        includeBlockKit: boolean;
-        includeQuery: boolean;
-        includeExplanation: boolean;
         credentials?: Partial<Record<CredentialType, string>> | undefined;
         additionalContext?: string | undefined;
     }, {
         message: string;
-        credentials?: Partial<Record<CredentialType, string>> | undefined;
+        verbosity?: "1" | "2" | "3" | "4" | "5" | undefined;
+        technicality?: "1" | "2" | "3" | "4" | "5" | undefined;
+        includeBlockKit?: boolean | undefined;
+        includeQuery?: boolean | undefined;
+        includeExplanation?: boolean | undefined;
         model?: {
             model?: "openai/gpt-5" | "openai/gpt-5-mini" | "openai/gpt-5.1" | "openai/gpt-5.2" | "google/gemini-2.5-pro" | "google/gemini-2.5-flash" | "google/gemini-2.5-flash-lite" | "google/gemini-2.5-flash-image-preview" | "google/gemini-3-pro-preview" | "google/gemini-3-pro-image-preview" | "google/gemini-3-flash-preview" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-opus-4-5" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | "openrouter/anthropic/claude-sonnet-4.5" | "openrouter/google/gemini-3-pro-preview" | "openrouter/morph/morph-v3-large" | "openrouter/openai/gpt-oss-120b" | "openrouter/openai/o3-deep-research" | "openrouter/openai/o4-mini-deep-research" | undefined;
             temperature?: number | undefined;
             maxTokens?: number | undefined;
         } | undefined;
+        credentials?: Partial<Record<CredentialType, string>> | undefined;
         tools?: {
             name: string;
             credentials?: Partial<Record<CredentialType, string>> | undefined;
             config?: Record<string, unknown> | undefined;
         }[] | undefined;
         maxIterations?: number | undefined;
-        verbosity?: "1" | "2" | "3" | "4" | "5" | undefined;
-        technicality?: "1" | "2" | "3" | "4" | "5" | undefined;
-        includeBlockKit?: boolean | undefined;
-        includeQuery?: boolean | undefined;
-        includeExplanation?: boolean | undefined;
         additionalContext?: string | undefined;
     }>;
     static readonly resultSchema: z.ZodObject<{
@@ -512,7 +512,7 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             }>, "many">>;
         }, "strip", z.ZodTypeAny, {
-            type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+            type: "section" | "header" | "divider" | "context" | "actions" | "input" | "file" | "image";
             title?: {
                 type: "plain_text";
                 text: string;
@@ -524,28 +524,28 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             } | undefined;
-            image_url?: string | undefined;
-            optional?: boolean | undefined;
+            block_id?: string | undefined;
+            accessory?: unknown;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
+            element?: unknown;
+            label?: unknown;
+            hint?: unknown;
+            optional?: boolean | undefined;
             alt_text?: string | undefined;
+            image_url?: string | undefined;
             elements?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
-            block_id?: string | undefined;
-            accessory?: unknown;
-            element?: unknown;
-            label?: unknown;
-            hint?: unknown;
         }, {
-            type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+            type: "section" | "header" | "divider" | "context" | "actions" | "input" | "file" | "image";
             title?: {
                 type: "plain_text";
                 text: string;
@@ -557,26 +557,26 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             } | undefined;
-            image_url?: string | undefined;
-            optional?: boolean | undefined;
+            block_id?: string | undefined;
+            accessory?: unknown;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
+            element?: unknown;
+            label?: unknown;
+            hint?: unknown;
+            optional?: boolean | undefined;
             alt_text?: string | undefined;
+            image_url?: string | undefined;
             elements?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
-            block_id?: string | undefined;
-            accessory?: unknown;
-            element?: unknown;
-            label?: unknown;
-            hint?: unknown;
         }>, "many">>;
         metadata: z.ZodObject<{
             verbosityLevel: z.ZodString;
@@ -611,23 +611,18 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
         error: z.ZodString;
         success: z.ZodBoolean;
     }, "strip", z.ZodTypeAny, {
-        error: string;
-        success: boolean;
+        response: string;
         metadata: {
             verbosityLevel: string;
             technicalityLevel: string;
             wordCount: number;
             blockCount?: number | undefined;
         };
-        response: string;
         iterations: number;
-        toolCalls?: {
-            tool: string;
-            input?: unknown;
-            output?: unknown;
-        }[] | undefined;
+        error: string;
+        success: boolean;
         blocks?: {
-            type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+            type: "section" | "header" | "divider" | "context" | "actions" | "input" | "file" | "image";
             title?: {
                 type: "plain_text";
                 text: string;
@@ -639,45 +634,45 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             } | undefined;
-            image_url?: string | undefined;
-            optional?: boolean | undefined;
+            block_id?: string | undefined;
+            accessory?: unknown;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
+            element?: unknown;
+            label?: unknown;
+            hint?: unknown;
+            optional?: boolean | undefined;
             alt_text?: string | undefined;
+            image_url?: string | undefined;
             elements?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
-            block_id?: string | undefined;
-            accessory?: unknown;
-            element?: unknown;
-            label?: unknown;
-            hint?: unknown;
+        }[] | undefined;
+        toolCalls?: {
+            tool: string;
+            input?: unknown;
+            output?: unknown;
         }[] | undefined;
     }, {
-        error: string;
-        success: boolean;
+        response: string;
         metadata: {
             verbosityLevel: string;
             technicalityLevel: string;
             wordCount: number;
             blockCount?: number | undefined;
         };
-        response: string;
         iterations: number;
-        toolCalls?: {
-            tool: string;
-            input?: unknown;
-            output?: unknown;
-        }[] | undefined;
+        error: string;
+        success: boolean;
         blocks?: {
-            type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+            type: "section" | "header" | "divider" | "context" | "actions" | "input" | "file" | "image";
             title?: {
                 type: "plain_text";
                 text: string;
@@ -689,26 +684,31 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             } | undefined;
-            image_url?: string | undefined;
-            optional?: boolean | undefined;
+            block_id?: string | undefined;
+            accessory?: unknown;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
+            element?: unknown;
+            label?: unknown;
+            hint?: unknown;
+            optional?: boolean | undefined;
             alt_text?: string | undefined;
+            image_url?: string | undefined;
             elements?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
-            block_id?: string | undefined;
-            accessory?: unknown;
-            element?: unknown;
-            label?: unknown;
-            hint?: unknown;
+        }[] | undefined;
+        toolCalls?: {
+            tool: string;
+            input?: unknown;
+            output?: unknown;
         }[] | undefined;
     }>;
     static readonly shortDescription = "AI agent for creating well-formatted Slack messages with adjustable verbosity and technicality";

package/dist/bubbles.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-02-02T10:41:40.296Z",
+  "generatedAt": "2026-02-02T12:00:47.429Z",
   "totalCount": 58,
   "bubbles": [
     {
@@ -68,7 +68,7 @@
       "type": "service",
       "shortDescription": "AI agent with LangGraph for tool-enabled conversations, multimodal support, and JSON mode",
       "useCase": "- Add tools to enhance the AI agent's capabilities (web-search-tool, web-scrape-tool)",
-      "outputSchema": "{\n  response: string // The AI agents final response to the user message. For text responses, returns plain text. If JSON mode is enabled, returns a JSON string. For image generation models (like gemini-2.5-flash-image-preview), returns base64-encoded image data with data URI format (data:image/png;base64,...),\n  reasoning: string | undefined // The reasoning/thinking tokens from the model (if available). Present for deep research models and reasoning models.,\n  toolCalls: { tool: string // Name of the tool that was called, input: unknown // Input parameters passed to the tool, output: unknown // Output returned by the tool }[] // Array of tool calls made during the conversation,\n  iterations: number // Number of back-and-forth iterations in the agent workflow,\n  totalCost: number | undefined // Total cost in USD for this request (includes tokens + web search for deep research models),\n  error: string // Error message of the run, undefined if successful,\n  success: boolean // Whether the agent execution completed successfully\n}",
+      "outputSchema": "{\n  response: string // The AI agents final response to the user message. For text responses, returns plain text. If JSON mode is enabled, returns a JSON string. For image generation models (like gemini-2.5-flash-image-preview), returns base64-encoded image data with data URI format (data:image/png;base64,...),\n  reasoning: string | null | undefined // The reasoning/thinking tokens from the model (if available). Present for deep research models and reasoning models.,\n  toolCalls: { tool: string // Name of the tool that was called, input: unknown // Input parameters passed to the tool, output: unknown // Output returned by the tool }[] // Array of tool calls made during the conversation,\n  iterations: number // Number of back-and-forth iterations in the agent workflow,\n  totalCost: number | undefined // Total cost in USD for this request (includes tokens + web search for deep research models),\n  error: string // Error message of the run, undefined if successful,\n  success: boolean // Whether the agent execution completed successfully\n}",
       "inputJsonSchema": {
         "type": "object",
         "properties": {
@@ -473,6 +473,7 @@
           },
           "reasoning": {
             "type": "string",
+            "nullable": true,
             "description": "The reasoning/thinking tokens from the model (if available). Present for deep research models and reasoning models."
           },
           "toolCalls": {
@@ -524,7 +525,7 @@
         ],
         "additionalProperties": false
       },
-      "usageExample": "// Example usage of ai-agent bubble\nconst aiAgent = new AIAgentBubble({\n  message: \"example string\", // The message or question to send to the AI agent,\n  images: [{ type: \"base64\" // default, data: \"example string\", mimeType: \"image/png\" // default, description: \"example string\" }] // example for array, // Array of base64 encoded images to include with the message (for multimodal AI models). Example: [{type: \"base64\", data: \"base64...\", mimeType: \"image/png\", description: \"A beautiful image of a cat\"}] or [{type: \"url\", url: \"https://example.com/image.png\", description: \"A beautiful image of a cat\"}],\n  conversationHistory: [{ role: \"user\" // options: \"user\", \"assistant\", \"tool\" // The role of the message sender, content: \"example string\" // The message content, toolCallId: \"example string\" // Tool call ID for tool messages, name: \"example string\" // Tool name for tool messages }], // Previous conversation messages for multi-turn conversations. When provided, messages are sent as separate turns to enable KV cache optimization. Format: [{role: \"user\", content: \"...\"}, {role: \"assistant\", content: \"...\"}, ...],\n  systemPrompt: \"You are a helpful AI assistant\" // default, // System prompt that defines the AI agents behavior and personality,\n  name: \"AI Agent\" // default, // A friendly name for the AI agent,\n  model: { model: \"openai/gpt-5\" // options: \"openai/gpt-5\", \"openai/gpt-5-mini\", \"openai/gpt-5.1\", \"openai/gpt-5.2\", \"google/gemini-2.5-pro\", \"google/gemini-2.5-flash\", \"google/gemini-2.5-flash-lite\", \"google/gemini-2.5-flash-image-preview\", \"google/gemini-3-pro-preview\", \"google/gemini-3-pro-image-preview\", \"google/gemini-3-flash-preview\", \"anthropic/claude-sonnet-4-5\", \"anthropic/claude-opus-4-5\", \"anthropic/claude-haiku-4-5\", \"openrouter/x-ai/grok-code-fast-1\", \"openrouter/z-ai/glm-4.6\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/google/gemini-3-pro-preview\", \"openrouter/morph/morph-v3-large\", \"openrouter/openai/gpt-oss-120b\", \"openrouter/openai/o3-deep-research\", \"openrouter/openai/o4-mini-deep-research\" // AI model to use (format: provider/model-name)., temperature: 1 // default // Temperature for response randomness (0 = deterministic, 2 = very random), maxTokens: 64000 // default // Maximum number of tokens to generate in response, keep at default of 40000 unless the response is expected to be certain length, reasoningEffort: \"low\" // options: \"low\", \"medium\", \"high\" // Reasoning effort for model. If not specified, uses primary model reasoningEffort., maxRetries: 3 // default // Maximum number of retries for API calls (default: 3). Useful for handling transient errors like 503 Service Unavailable., provider: [\"example string\"] // Providers for ai agent (open router only)., jsonMode: false // default // When true, returns clean JSON response, you must provide the exact JSON schema in the system prompt, backupModel: { model: \"openai/gpt-5\" // options: \"openai/gpt-5\", \"openai/gpt-5-mini\", \"openai/gpt-5.1\", \"openai/gpt-5.2\", \"google/gemini-2.5-pro\", \"google/gemini-2.5-flash\", \"google/gemini-2.5-flash-lite\", \"google/gemini-2.5-flash-image-preview\", \"google/gemini-3-pro-preview\", \"google/gemini-3-pro-image-preview\", \"google/gemini-3-flash-preview\", \"anthropic/claude-sonnet-4-5\", \"anthropic/claude-opus-4-5\", \"anthropic/claude-haiku-4-5\", \"openrouter/x-ai/grok-code-fast-1\", \"openrouter/z-ai/glm-4.6\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/google/gemini-3-pro-preview\", \"openrouter/morph/morph-v3-large\", \"openrouter/openai/gpt-oss-120b\", \"openrouter/openai/o3-deep-research\", \"openrouter/openai/o4-mini-deep-research\" // Backup AI model to use if the primary model fails (format: provider/model-name)., temperature: 42 // Temperature for backup model. If not specified, uses primary model temperature., maxTokens: 42 // Max tokens for backup model. If not specified, uses primary model maxTokens., reasoningEffort: \"low\" // options: \"low\", \"medium\", \"high\" // Reasoning effort for backup model. If not specified, uses primary model reasoningEffort., maxRetries: 42 // Max retries for backup model. If not specified, uses primary model maxRetries. } // structure // Backup model configuration to use if the primary model fails. } // structure, // AI model configuration including provider, temperature, and tokens, retries, and json mode. Always include this.,\n  tools: [{ name: \"web-search-tool\" // options: \"web-search-tool\", \"web-scrape-tool\", \"web-crawl-tool\", \"web-extract-tool\", \"research-agent-tool\", \"reddit-scrape-tool\", \"instagram-tool\", \"list-bubbles-tool\", \"get-bubble-details-tool\", \"get-trigger-detail-tool\", \"bubbleflow-validation-tool\", \"code-edit-tool\", \"chart-js-tool\", \"amazon-shopping-tool\", \"linkedin-tool\", \"tiktok-tool\", \"twitter-tool\", \"google-maps-tool\", \"youtube-tool\", \"people-search-tool\", \"sql-query-tool\" // Name of the tool type or tool bubble to enable for the AI agent, config: {} // Configuration for the tool or tool bubble }] // example for array, // Array of pre-registered tools the AI agent can use. Can be tool types (web-search-tool, web-scrape-tool, web-crawl-tool, web-extract-tool, instagram-tool). If using image models, set the tools to [],\n  customTools: [{ name: \"example string\" // Unique name for your custom tool (e.g., \"calculate-tax\"), description: \"example string\" // Description of what the tool does - helps the AI know when to use it, schema: {} // Zod schema object defining the tool parameters. Can be either a plain object (e.g., { amount: z.number() }) or a Zod object directly (e.g., z.object({ amount: z.number() })). }] // example for array, // Array of custom runtime-defined tools with their own schemas and functions. Use this to add domain-specific tools without pre-registration. Example: [{ name: \"calculate-tax\", description: \"Calculates sales tax\", schema: { amount: z.number() }, func: async (input) => {...} }],\n  maxIterations: 40 // default, // Maximum number of iterations for the agent workflow, 5 iterations per turn of conversation,\n  streaming: false // default, // Enable real-time streaming of tokens, tool calls, and iteration progress,\n  expectedOutputSchema: \"example string\", // Zod schema or JSON schema string that defines the expected structure of the AI response. When provided, automatically enables JSON mode and instructs the AI to output in the exact format. Example: z.object({ summary: z.string(), items: z.array(z.object({ name: z.string(), score: z.number() })) }),\n});\n\nconst result = await aiAgent.action();\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`${metadata.name} failed: ${result.error}`);\n}\n\n// outputSchema for result.data:\n// {\n//   response: string // The AI agents final response to the user message. For text responses, returns plain text. If JSON mode is enabled, returns a JSON string. For image generation models (like gemini-2.5-flash-image-preview), returns base64-encoded image data with data URI format (data:image/png;base64,...),\n//   reasoning: string | undefined // The reasoning/thinking tokens from the model (if available). Present for deep research models and reasoning models.,\n//   toolCalls: { tool: string // Name of the tool that was called, input: unknown // Input parameters passed to the tool, output: unknown // Output returned by the tool }[] // Array of tool calls made during the conversation,\n//   iterations: number // Number of back-and-forth iterations in the agent workflow,\n//   totalCost: number | undefined // Total cost in USD for this request (includes tokens + web search for deep research models),\n//   error: string // Error message of the run, undefined if successful,\n//   success: boolean // Whether the agent execution completed successfully\n// }\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
+      "usageExample": "// Example usage of ai-agent bubble\nconst aiAgent = new AIAgentBubble({\n  message: \"example string\", // The message or question to send to the AI agent,\n  images: [{ type: \"base64\" // default, data: \"example string\", mimeType: \"image/png\" // default, description: \"example string\" }] // example for array, // Array of base64 encoded images to include with the message (for multimodal AI models). Example: [{type: \"base64\", data: \"base64...\", mimeType: \"image/png\", description: \"A beautiful image of a cat\"}] or [{type: \"url\", url: \"https://example.com/image.png\", description: \"A beautiful image of a cat\"}],\n  conversationHistory: [{ role: \"user\" // options: \"user\", \"assistant\", \"tool\" // The role of the message sender, content: \"example string\" // The message content, toolCallId: \"example string\" // Tool call ID for tool messages, name: \"example string\" // Tool name for tool messages }], // Previous conversation messages for multi-turn conversations. When provided, messages are sent as separate turns to enable KV cache optimization. Format: [{role: \"user\", content: \"...\"}, {role: \"assistant\", content: \"...\"}, ...],\n  systemPrompt: \"You are a helpful AI assistant\" // default, // System prompt that defines the AI agents behavior and personality,\n  name: \"AI Agent\" // default, // A friendly name for the AI agent,\n  model: { model: \"openai/gpt-5\" // options: \"openai/gpt-5\", \"openai/gpt-5-mini\", \"openai/gpt-5.1\", \"openai/gpt-5.2\", \"google/gemini-2.5-pro\", \"google/gemini-2.5-flash\", \"google/gemini-2.5-flash-lite\", \"google/gemini-2.5-flash-image-preview\", \"google/gemini-3-pro-preview\", \"google/gemini-3-pro-image-preview\", \"google/gemini-3-flash-preview\", \"anthropic/claude-sonnet-4-5\", \"anthropic/claude-opus-4-5\", \"anthropic/claude-haiku-4-5\", \"openrouter/x-ai/grok-code-fast-1\", \"openrouter/z-ai/glm-4.6\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/google/gemini-3-pro-preview\", \"openrouter/morph/morph-v3-large\", \"openrouter/openai/gpt-oss-120b\", \"openrouter/openai/o3-deep-research\", \"openrouter/openai/o4-mini-deep-research\" // AI model to use (format: provider/model-name)., temperature: 1 // default // Temperature for response randomness (0 = deterministic, 2 = very random), maxTokens: 64000 // default // Maximum number of tokens to generate in response, keep at default of 40000 unless the response is expected to be certain length, reasoningEffort: \"low\" // options: \"low\", \"medium\", \"high\" // Reasoning effort for model. If not specified, uses primary model reasoningEffort., maxRetries: 3 // default // Maximum number of retries for API calls (default: 3). Useful for handling transient errors like 503 Service Unavailable., provider: [\"example string\"] // Providers for ai agent (open router only)., jsonMode: false // default // When true, returns clean JSON response, you must provide the exact JSON schema in the system prompt, backupModel: { model: \"openai/gpt-5\" // options: \"openai/gpt-5\", \"openai/gpt-5-mini\", \"openai/gpt-5.1\", \"openai/gpt-5.2\", \"google/gemini-2.5-pro\", \"google/gemini-2.5-flash\", \"google/gemini-2.5-flash-lite\", \"google/gemini-2.5-flash-image-preview\", \"google/gemini-3-pro-preview\", \"google/gemini-3-pro-image-preview\", \"google/gemini-3-flash-preview\", \"anthropic/claude-sonnet-4-5\", \"anthropic/claude-opus-4-5\", \"anthropic/claude-haiku-4-5\", \"openrouter/x-ai/grok-code-fast-1\", \"openrouter/z-ai/glm-4.6\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/google/gemini-3-pro-preview\", \"openrouter/morph/morph-v3-large\", \"openrouter/openai/gpt-oss-120b\", \"openrouter/openai/o3-deep-research\", \"openrouter/openai/o4-mini-deep-research\" // Backup AI model to use if the primary model fails (format: provider/model-name)., temperature: 42 // Temperature for backup model. If not specified, uses primary model temperature., maxTokens: 42 // Max tokens for backup model. If not specified, uses primary model maxTokens., reasoningEffort: \"low\" // options: \"low\", \"medium\", \"high\" // Reasoning effort for backup model. If not specified, uses primary model reasoningEffort., maxRetries: 42 // Max retries for backup model. If not specified, uses primary model maxRetries. } // structure // Backup model configuration to use if the primary model fails. } // structure, // AI model configuration including provider, temperature, and tokens, retries, and json mode. Always include this.,\n  tools: [{ name: \"web-search-tool\" // options: \"web-search-tool\", \"web-scrape-tool\", \"web-crawl-tool\", \"web-extract-tool\", \"research-agent-tool\", \"reddit-scrape-tool\", \"instagram-tool\", \"list-bubbles-tool\", \"get-bubble-details-tool\", \"get-trigger-detail-tool\", \"bubbleflow-validation-tool\", \"code-edit-tool\", \"chart-js-tool\", \"amazon-shopping-tool\", \"linkedin-tool\", \"tiktok-tool\", \"twitter-tool\", \"google-maps-tool\", \"youtube-tool\", \"people-search-tool\", \"sql-query-tool\" // Name of the tool type or tool bubble to enable for the AI agent, config: {} // Configuration for the tool or tool bubble }] // example for array, // Array of pre-registered tools the AI agent can use. Can be tool types (web-search-tool, web-scrape-tool, web-crawl-tool, web-extract-tool, instagram-tool). If using image models, set the tools to [],\n  customTools: [{ name: \"example string\" // Unique name for your custom tool (e.g., \"calculate-tax\"), description: \"example string\" // Description of what the tool does - helps the AI know when to use it, schema: {} // Zod schema object defining the tool parameters. Can be either a plain object (e.g., { amount: z.number() }) or a Zod object directly (e.g., z.object({ amount: z.number() })). }] // example for array, // Array of custom runtime-defined tools with their own schemas and functions. Use this to add domain-specific tools without pre-registration. Example: [{ name: \"calculate-tax\", description: \"Calculates sales tax\", schema: { amount: z.number() }, func: async (input) => {...} }],\n  maxIterations: 40 // default, // Maximum number of iterations for the agent workflow, 5 iterations per turn of conversation,\n  streaming: false // default, // Enable real-time streaming of tokens, tool calls, and iteration progress,\n  expectedOutputSchema: \"example string\", // Zod schema or JSON schema string that defines the expected structure of the AI response. When provided, automatically enables JSON mode and instructs the AI to output in the exact format. Example: z.object({ summary: z.string(), items: z.array(z.object({ name: z.string(), score: z.number() })) }),\n});\n\nconst result = await aiAgent.action();\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`${metadata.name} failed: ${result.error}`);\n}\n\n// outputSchema for result.data:\n// {\n//   response: string // The AI agents final response to the user message. For text responses, returns plain text. If JSON mode is enabled, returns a JSON string. For image generation models (like gemini-2.5-flash-image-preview), returns base64-encoded image data with data URI format (data:image/png;base64,...),\n//   reasoning: string | null | undefined // The reasoning/thinking tokens from the model (if available). Present for deep research models and reasoning models.,\n//   toolCalls: { tool: string // Name of the tool that was called, input: unknown // Input parameters passed to the tool, output: unknown // Output returned by the tool }[] // Array of tool calls made during the conversation,\n//   iterations: number // Number of back-and-forth iterations in the agent workflow,\n//   totalCost: number | undefined // Total cost in USD for this request (includes tokens + web search for deep research models),\n//   error: string // Error message of the run, undefined if successful,\n//   success: boolean // Whether the agent execution completed successfully\n// }\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
       "requiredCredentials": [
         "OPENAI_CRED",
         "GOOGLE_GEMINI_CRED",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bubblelab/bubble-core",
-  "version": "0.1.76",
+  "version": "0.1.78",
   "type": "module",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
@@ -40,7 +40,7 @@
     "puppeteer-core": "^24.10.0",
     "resend": "^4.8.0",
     "zod": "^3.24.1",
-    "@bubblelab/shared-schemas": "0.1.77"
+    "@bubblelab/shared-schemas": "0.1.79"
   },
   "devDependencies": {
     "zod-to-json-schema": "^3.24.6",