@bubblelab/bubble-core 0.1.263 → 0.1.266

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

@@ -61,12 +61,12 @@ declare const SlackFormatterAgentParamsSchema: z.ZodObject<{
     additionalContext?: string | undefined;
 }, {
     message: string;
-    credentials?: Partial<Record<CredentialType, string>> | 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" | "google/gemini-3.1-pro-preview" | "google/gemini-3.1-flash-lite-preview" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-sonnet-4-6" | "anthropic/claude-opus-4-5" | "anthropic/claude-opus-4-6" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | "openrouter/z-ai/glm-4.7" | "openrouter/anthropic/claude-sonnet-4.5" | "openrouter/anthropic/claude-sonnet-4.6" | "openrouter/anthropic/claude-opus-4.5" | "openrouter/anthropic/claude-opus-4.6" | "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;
@@ -154,13 +154,14 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        type: "table" | "image" | "context" | "input" | "file" | "section" | "divider" | "header" | "actions";
+        type: "context" | "input" | "image" | "file" | "divider" | "section" | "header" | "actions" | "table";
         title?: {
             type: "plain_text";
             text: string;
             emoji?: boolean | undefined;
         } | undefined;
         optional?: boolean | undefined;
+        element?: unknown;
         text?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -168,32 +169,32 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         } | undefined;
         image_url?: string | undefined;
-        element?: unknown;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
+        alt_text?: string | undefined;
         elements?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
-        alt_text?: string | undefined;
         block_id?: string | undefined;
         accessory?: unknown;
         label?: unknown;
         hint?: unknown;
     }, {
-        type: "table" | "image" | "context" | "input" | "file" | "section" | "divider" | "header" | "actions";
+        type: "context" | "input" | "image" | "file" | "divider" | "section" | "header" | "actions" | "table";
         title?: {
             type: "plain_text";
             text: string;
             emoji?: boolean | undefined;
         } | undefined;
         optional?: boolean | undefined;
+        element?: unknown;
         text?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -201,20 +202,19 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         } | undefined;
         image_url?: string | undefined;
-        element?: unknown;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
+        alt_text?: string | undefined;
         elements?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
-        alt_text?: string | undefined;
         block_id?: string | undefined;
         accessory?: unknown;
         label?: unknown;
@@ -255,27 +255,28 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
 }, "strip", z.ZodTypeAny, {
     error: string;
     success: boolean;
+    response: string;
+    iterations: number;
     metadata: {
         verbosityLevel: string;
         technicalityLevel: string;
         wordCount: number;
         blockCount?: number | undefined;
     };
-    response: string;
-    iterations: number;
     toolCalls?: {
         tool: string;
         input?: unknown;
         output?: unknown;
     }[] | undefined;
     blocks?: {
-        type: "table" | "image" | "context" | "input" | "file" | "section" | "divider" | "header" | "actions";
+        type: "context" | "input" | "image" | "file" | "divider" | "section" | "header" | "actions" | "table";
         title?: {
             type: "plain_text";
             text: string;
             emoji?: boolean | undefined;
         } | undefined;
         optional?: boolean | undefined;
+        element?: unknown;
         text?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -283,20 +284,19 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         } | undefined;
         image_url?: string | undefined;
-        element?: unknown;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
+        alt_text?: string | undefined;
         elements?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
-        alt_text?: string | undefined;
         block_id?: string | undefined;
         accessory?: unknown;
         label?: unknown;
@@ -305,27 +305,28 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
 }, {
     error: string;
     success: boolean;
+    response: string;
+    iterations: number;
     metadata: {
         verbosityLevel: string;
         technicalityLevel: string;
         wordCount: number;
         blockCount?: number | undefined;
     };
-    response: string;
-    iterations: number;
     toolCalls?: {
         tool: string;
         input?: unknown;
         output?: unknown;
     }[] | undefined;
     blocks?: {
-        type: "table" | "image" | "context" | "input" | "file" | "section" | "divider" | "header" | "actions";
+        type: "context" | "input" | "image" | "file" | "divider" | "section" | "header" | "actions" | "table";
         title?: {
             type: "plain_text";
             text: string;
             emoji?: boolean | undefined;
         } | undefined;
         optional?: boolean | undefined;
+        element?: unknown;
         text?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -333,20 +334,19 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         } | undefined;
         image_url?: string | undefined;
-        element?: unknown;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
+        alt_text?: string | undefined;
         elements?: {
             type: "plain_text" | "mrkdwn";
             text: string;
             emoji?: boolean | undefined;
             verbatim?: boolean | undefined;
         }[] | undefined;
-        alt_text?: string | undefined;
         block_id?: string | undefined;
         accessory?: unknown;
         label?: unknown;
@@ -419,12 +419,12 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
         additionalContext?: string | undefined;
     }, {
         message: string;
-        credentials?: Partial<Record<CredentialType, string>> | 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" | "google/gemini-3.1-pro-preview" | "google/gemini-3.1-flash-lite-preview" | "anthropic/claude-sonnet-4-5" | "anthropic/claude-sonnet-4-6" | "anthropic/claude-opus-4-5" | "anthropic/claude-opus-4-6" | "anthropic/claude-haiku-4-5" | "openrouter/x-ai/grok-code-fast-1" | "openrouter/z-ai/glm-4.6" | "openrouter/z-ai/glm-4.7" | "openrouter/anthropic/claude-sonnet-4.5" | "openrouter/anthropic/claude-sonnet-4.6" | "openrouter/anthropic/claude-opus-4.5" | "openrouter/anthropic/claude-opus-4.6" | "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;
@@ -512,13 +512,14 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             }>, "many">>;
         }, "strip", z.ZodTypeAny, {
-            type: "table" | "image" | "context" | "input" | "file" | "section" | "divider" | "header" | "actions";
+            type: "context" | "input" | "image" | "file" | "divider" | "section" | "header" | "actions" | "table";
             title?: {
                 type: "plain_text";
                 text: string;
                 emoji?: boolean | undefined;
             } | undefined;
             optional?: boolean | undefined;
+            element?: unknown;
             text?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -526,32 +527,32 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             } | undefined;
             image_url?: string | undefined;
-            element?: unknown;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
+            alt_text?: string | undefined;
             elements?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
-            alt_text?: string | undefined;
             block_id?: string | undefined;
             accessory?: unknown;
             label?: unknown;
             hint?: unknown;
         }, {
-            type: "table" | "image" | "context" | "input" | "file" | "section" | "divider" | "header" | "actions";
+            type: "context" | "input" | "image" | "file" | "divider" | "section" | "header" | "actions" | "table";
             title?: {
                 type: "plain_text";
                 text: string;
                 emoji?: boolean | undefined;
             } | undefined;
             optional?: boolean | undefined;
+            element?: unknown;
             text?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -559,20 +560,19 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             } | undefined;
             image_url?: string | undefined;
-            element?: unknown;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
+            alt_text?: string | undefined;
             elements?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
-            alt_text?: string | undefined;
             block_id?: string | undefined;
             accessory?: unknown;
             label?: unknown;
@@ -613,27 +613,28 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
     }, "strip", z.ZodTypeAny, {
         error: string;
         success: boolean;
+        response: string;
+        iterations: number;
         metadata: {
             verbosityLevel: string;
             technicalityLevel: string;
             wordCount: number;
             blockCount?: number | undefined;
         };
-        response: string;
-        iterations: number;
         toolCalls?: {
             tool: string;
             input?: unknown;
             output?: unknown;
         }[] | undefined;
         blocks?: {
-            type: "table" | "image" | "context" | "input" | "file" | "section" | "divider" | "header" | "actions";
+            type: "context" | "input" | "image" | "file" | "divider" | "section" | "header" | "actions" | "table";
             title?: {
                 type: "plain_text";
                 text: string;
                 emoji?: boolean | undefined;
             } | undefined;
             optional?: boolean | undefined;
+            element?: unknown;
             text?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -641,20 +642,19 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             } | undefined;
             image_url?: string | undefined;
-            element?: unknown;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
+            alt_text?: string | undefined;
             elements?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
-            alt_text?: string | undefined;
             block_id?: string | undefined;
             accessory?: unknown;
             label?: unknown;
@@ -663,27 +663,28 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
     }, {
         error: string;
         success: boolean;
+        response: string;
+        iterations: number;
         metadata: {
             verbosityLevel: string;
             technicalityLevel: string;
             wordCount: number;
             blockCount?: number | undefined;
         };
-        response: string;
-        iterations: number;
         toolCalls?: {
             tool: string;
             input?: unknown;
             output?: unknown;
         }[] | undefined;
         blocks?: {
-            type: "table" | "image" | "context" | "input" | "file" | "section" | "divider" | "header" | "actions";
+            type: "context" | "input" | "image" | "file" | "divider" | "section" | "header" | "actions" | "table";
             title?: {
                 type: "plain_text";
                 text: string;
                 emoji?: boolean | undefined;
             } | undefined;
             optional?: boolean | undefined;
+            element?: unknown;
             text?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -691,20 +692,19 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             } | undefined;
             image_url?: string | undefined;
-            element?: unknown;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
+            alt_text?: string | undefined;
             elements?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
                 emoji?: boolean | undefined;
                 verbatim?: boolean | undefined;
             }[] | undefined;
-            alt_text?: string | undefined;
             block_id?: string | undefined;
             accessory?: unknown;
             label?: unknown;

package/dist/bubbles.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-03-31T05:11:27.765Z",
+  "generatedAt": "2026-04-01T22:46:39.357Z",
   "totalCount": 80,
   "bubbles": [
     {
@@ -340,7 +340,7 @@
                 "default": {
                   "model": "google/gemini-3-flash-preview"
                 },
-                "description": "Backup model configuration to use if the primary model fails."
+                "description": "Backup model if the primary fails. Defaults to GOOGLE_FLAGSHIP (Gemini 3 Flash) when omitted."
               }
             },
             "required": [
@@ -635,7 +635,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\", \"google/gemini-3.1-pro-preview\", \"google/gemini-3.1-flash-lite-preview\", \"anthropic/claude-sonnet-4-5\", \"anthropic/claude-sonnet-4-6\", \"anthropic/claude-opus-4-5\", \"anthropic/claude-opus-4-6\", \"anthropic/claude-haiku-4-5\", \"openrouter/x-ai/grok-code-fast-1\", \"openrouter/z-ai/glm-4.6\", \"openrouter/z-ai/glm-4.7\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/anthropic/claude-sonnet-4.6\", \"openrouter/anthropic/claude-opus-4.5\", \"openrouter/anthropic/claude-opus-4.6\", \"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\", \"google/gemini-3.1-pro-preview\", \"google/gemini-3.1-flash-lite-preview\", \"anthropic/claude-sonnet-4-5\", \"anthropic/claude-sonnet-4-6\", \"anthropic/claude-opus-4-5\", \"anthropic/claude-opus-4-6\", \"anthropic/claude-haiku-4-5\", \"openrouter/x-ai/grok-code-fast-1\", \"openrouter/z-ai/glm-4.6\", \"openrouter/z-ai/glm-4.7\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/anthropic/claude-sonnet-4.6\", \"openrouter/anthropic/claude-opus-4.5\", \"openrouter/anthropic/claude-opus-4.6\", \"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\", \"list-capabilities-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\", \"app-rankings-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 tool config objects: [{ name: \"web-search-tool\" }, { name: \"web-scrape-tool\" }]. Each object requires a \"name\" field. Available tool names: web-search-tool, web-scrape-tool, web-crawl-tool, web-extract-tool, instagram-tool. If using image models, set 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: 80 // default, // Maximum number of iterations for the agent workflow, 5 iterations per turn of conversation,\n  credentialPool: { \"example_key\": [{ id: 42, name: \"example string\", value: \"example string\" }] }, // All available credentials per type with metadata. Used by master agent for delegation credential selection.,\n  streaming: false // default, // Enable real-time streaming of tokens, tool calls, and iteration progress,\n  capabilities: [{ id: \"example string\" // Capability ID (e.g., \"google-doc-knowledge-base\"), inputs: { \"example_key\": [\"example string\"] } // structure // Input parameter values for this capability, context: \"example string\" // Free-text context injected into this capability subagent system prompt (e.g., workspace-specific details, naming conventions, project prefixes) }] // example for array, // Capabilities that extend the agent with bundled tools, prompts, and credentials. Example: [{ id: \"google-doc-knowledge-base\", inputs: { docId: \"your-doc-id\" } }],\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  memoryEnabled: true // default, // Enable persistent memory across conversations. When true, the agent can recall and save information about people, topics, and events between conversations.,\n  enableSlackHistory: false // default, // Enable Slack thread history injection. When true, the agent receives full conversation history from Slack threads including user names, timezones, and images.,\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);",
+      "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\", \"google/gemini-3.1-pro-preview\", \"google/gemini-3.1-flash-lite-preview\", \"anthropic/claude-sonnet-4-5\", \"anthropic/claude-sonnet-4-6\", \"anthropic/claude-opus-4-5\", \"anthropic/claude-opus-4-6\", \"anthropic/claude-haiku-4-5\", \"openrouter/x-ai/grok-code-fast-1\", \"openrouter/z-ai/glm-4.6\", \"openrouter/z-ai/glm-4.7\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/anthropic/claude-sonnet-4.6\", \"openrouter/anthropic/claude-opus-4.5\", \"openrouter/anthropic/claude-opus-4.6\", \"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\", \"google/gemini-3.1-pro-preview\", \"google/gemini-3.1-flash-lite-preview\", \"anthropic/claude-sonnet-4-5\", \"anthropic/claude-sonnet-4-6\", \"anthropic/claude-opus-4-5\", \"anthropic/claude-opus-4-6\", \"anthropic/claude-haiku-4-5\", \"openrouter/x-ai/grok-code-fast-1\", \"openrouter/z-ai/glm-4.6\", \"openrouter/z-ai/glm-4.7\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/anthropic/claude-sonnet-4.6\", \"openrouter/anthropic/claude-opus-4.5\", \"openrouter/anthropic/claude-opus-4.6\", \"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 if the primary fails. Defaults to GOOGLE_FLAGSHIP (Gemini 3 Flash) when omitted. } // 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\", \"list-capabilities-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\", \"app-rankings-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 tool config objects: [{ name: \"web-search-tool\" }, { name: \"web-scrape-tool\" }]. Each object requires a \"name\" field. Available tool names: web-search-tool, web-scrape-tool, web-crawl-tool, web-extract-tool, instagram-tool. If using image models, set 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: 80 // default, // Maximum number of iterations for the agent workflow, 5 iterations per turn of conversation,\n  credentialPool: { \"example_key\": [{ id: 42, name: \"example string\", value: \"example string\" }] }, // All available credentials per type with metadata. Used by master agent for delegation credential selection.,\n  streaming: false // default, // Enable real-time streaming of tokens, tool calls, and iteration progress,\n  capabilities: [{ id: \"example string\" // Capability ID (e.g., \"google-doc-knowledge-base\"), inputs: { \"example_key\": [\"example string\"] } // structure // Input parameter values for this capability, context: \"example string\" // Free-text context injected into this capability subagent system prompt (e.g., workspace-specific details, naming conventions, project prefixes) }] // example for array, // Capabilities that extend the agent with bundled tools, prompts, and credentials. Example: [{ id: \"google-doc-knowledge-base\", inputs: { docId: \"your-doc-id\" } }],\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  memoryEnabled: true // default, // Enable persistent memory across conversations. When true, the agent can recall and save information about people, topics, and events between conversations.,\n  enableSlackHistory: false // default, // Enable Slack thread history injection. When true, the agent receives full conversation history from Slack threads including user names, timezones, and images.,\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/dist/types/ai-models.d.ts

@@ -0,0 +1,4 @@
+import { z } from 'zod';
+export declare const AvailableModels: z.ZodEnum<["openai/gpt-5", "openai/gpt-5-mini", "openai/gpt-o4-mini", "openai/gpt-4o", "google/gemini-2.5-pro", "google/gemini-2.5-flash", "google/gemini-2.5-flash-lite", "google/gemini-2.5-flash-image-preview", "anthropic/claude-sonnet-4-5-20250929"]>;
+export type AvailableModel = z.infer<typeof AvailableModels>;
+//# sourceMappingURL=ai-models.d.ts.map

package/dist/types/ai-models.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-models.d.ts","sourceRoot":"","sources":["../../src/types/ai-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,eAAO,MAAM,eAAe,8PAa1B,CAAC;AAEH,MAAM,MAAM,cAAc,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,eAAe,CAAC,CAAC"}

package/dist/types/ai-models.js

@@ -0,0 +1,16 @@
+import { z } from 'zod';
+// Define available models with provider/name combinations
+export const AvailableModels = z.enum([
+    // OpenAI models
+    'openai/gpt-5',
+    'openai/gpt-5-mini',
+    'openai/gpt-o4-mini',
+    'openai/gpt-4o',
+    // Google Gemini models
+    'google/gemini-2.5-pro',
+    'google/gemini-2.5-flash',
+    'google/gemini-2.5-flash-lite',
+    'google/gemini-2.5-flash-image-preview',
+    'anthropic/claude-sonnet-4-5-20250929',
+]);
+//# sourceMappingURL=ai-models.js.map

package/dist/types/ai-models.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ai-models.js","sourceRoot":"","sources":["../../src/types/ai-models.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0DAA0D;AAC1D,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,CAAC,IAAI,CAAC;IACpC,gBAAgB;IAChB,cAAc;IACd,mBAAmB;IACnB,oBAAoB;IACpB,eAAe;IACf,uBAAuB;IACvB,uBAAuB;IACvB,yBAAyB;IACzB,8BAA8B;IAC9B,uCAAuC;IAEvC,sCAAsC;CACvC,CAAC,CAAC"}

package/dist/utils/param-helper.d.ts

@@ -0,0 +1,2 @@
+export declare function sanitizeParams(params: Record<string, unknown>): Record<string, unknown>;
+//# sourceMappingURL=param-helper.d.ts.map

package/dist/utils/param-helper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-helper.d.ts","sourceRoot":"","sources":["../../src/utils/param-helper.ts"],"names":[],"mappings":"AAAA,wBAAgB,cAAc,CAC5B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAC9B,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAKzB"}

package/dist/utils/param-helper.js

@@ -0,0 +1,5 @@
+export function sanitizeParams(params) {
+    // Remove credentials from params
+    return Object.fromEntries(Object.entries(params).filter(([key]) => !key.startsWith('credentials')));
+}
+//# sourceMappingURL=param-helper.js.map

package/dist/utils/param-helper.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"param-helper.js","sourceRoot":"","sources":["../../src/utils/param-helper.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,cAAc,CAC5B,MAA+B;IAE/B,iCAAiC;IACjC,OAAO,MAAM,CAAC,WAAW,CACvB,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE,EAAE,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,aAAa,CAAC,CAAC,CACzE,CAAC;AACJ,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bubblelab/bubble-core",
-  "version": "0.1.263",
+  "version": "0.1.266",
   "type": "module",
   "license": "Apache-2.0",
   "main": "./dist/index.js",
@@ -41,7 +41,7 @@
     "puppeteer-core": "^24.10.0",
     "resend": "^4.8.0",
     "zod": "^3.24.1",
-    "@bubblelab/shared-schemas": "0.1.263"
+    "@bubblelab/shared-schemas": "0.1.266"
   },
   "devDependencies": {
     "@types/node": "^20.12.12",