@bubblelab/bubble-core 0.1.106 → 0.1.109

package/dist/bubbles/workflow-bubble/pdf-ocr.workflow.d.ts

@@ -195,12 +195,12 @@ declare const PDFOcrWorkflowResultSchema: z.ZodDiscriminatedUnion<"mode", [z.Zod
         fieldName: z.ZodString;
         confidence: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
-        id: number;
         fieldName: string;
+        id: number;
         confidence: number;
     }, {
-        id: number;
         fieldName: string;
+        id: number;
         confidence: number;
     }>, "many">;
     discoveryData: z.ZodObject<{
@@ -258,8 +258,8 @@ declare const PDFOcrWorkflowResultSchema: z.ZodDiscriminatedUnion<"mode", [z.Zod
         convertedPages: number;
     };
     extractedFields: {
-        id: number;
         fieldName: string;
+        id: number;
         confidence: number;
     }[];
     discoveryData: {
@@ -283,8 +283,8 @@ declare const PDFOcrWorkflowResultSchema: z.ZodDiscriminatedUnion<"mode", [z.Zod
         convertedPages: number;
     };
     extractedFields: {
-        id: number;
         fieldName: string;
+        id: number;
         confidence: number;
     }[];
     discoveryData: {
@@ -307,14 +307,14 @@ declare const PDFOcrWorkflowResultSchema: z.ZodDiscriminatedUnion<"mode", [z.Zod
         confidence: z.ZodNumber;
     }, "strip", z.ZodTypeAny, {
         value: string;
-        id: number;
         fieldName: string;
+        id: number;
         confidence: number;
         originalFieldName?: string | undefined;
     }, {
         value: string;
-        id: number;
         fieldName: string;
+        id: number;
         confidence: number;
         originalFieldName?: string | undefined;
     }>, "many">;
@@ -386,8 +386,8 @@ declare const PDFOcrWorkflowResultSchema: z.ZodDiscriminatedUnion<"mode", [z.Zod
     };
     extractedFields: {
         value: string;
-        id: number;
         fieldName: string;
+        id: number;
         confidence: number;
         originalFieldName?: string | undefined;
     }[];
@@ -418,8 +418,8 @@ declare const PDFOcrWorkflowResultSchema: z.ZodDiscriminatedUnion<"mode", [z.Zod
     };
     extractedFields: {
         value: string;
-        id: number;
         fieldName: string;
+        id: number;
         confidence: number;
         originalFieldName?: string | undefined;
     }[];
@@ -628,12 +628,12 @@ export declare class PDFOcrWorkflow<T extends PDFOcrWorkflowParams = PDFOcrWorkf
             fieldName: z.ZodString;
             confidence: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
-            id: number;
             fieldName: string;
+            id: number;
             confidence: number;
         }, {
-            id: number;
             fieldName: string;
+            id: number;
             confidence: number;
         }>, "many">;
         discoveryData: z.ZodObject<{
@@ -691,8 +691,8 @@ export declare class PDFOcrWorkflow<T extends PDFOcrWorkflowParams = PDFOcrWorkf
             convertedPages: number;
         };
         extractedFields: {
-            id: number;
             fieldName: string;
+            id: number;
             confidence: number;
         }[];
         discoveryData: {
@@ -716,8 +716,8 @@ export declare class PDFOcrWorkflow<T extends PDFOcrWorkflowParams = PDFOcrWorkf
             convertedPages: number;
         };
         extractedFields: {
-            id: number;
             fieldName: string;
+            id: number;
             confidence: number;
         }[];
         discoveryData: {
@@ -740,14 +740,14 @@ export declare class PDFOcrWorkflow<T extends PDFOcrWorkflowParams = PDFOcrWorkf
             confidence: z.ZodNumber;
         }, "strip", z.ZodTypeAny, {
             value: string;
-            id: number;
             fieldName: string;
+            id: number;
             confidence: number;
             originalFieldName?: string | undefined;
         }, {
             value: string;
-            id: number;
             fieldName: string;
+            id: number;
             confidence: number;
             originalFieldName?: string | undefined;
         }>, "many">;
@@ -819,8 +819,8 @@ export declare class PDFOcrWorkflow<T extends PDFOcrWorkflowParams = PDFOcrWorkf
         };
         extractedFields: {
             value: string;
-            id: number;
             fieldName: string;
+            id: number;
             confidence: number;
             originalFieldName?: string | undefined;
         }[];
@@ -851,8 +851,8 @@ export declare class PDFOcrWorkflow<T extends PDFOcrWorkflowParams = PDFOcrWorkf
         };
         extractedFields: {
             value: string;
-            id: number;
             fieldName: string;
+            id: number;
             confidence: number;
             originalFieldName?: string | undefined;
         }[];

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

@@ -154,12 +154,13 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         }>, "many">>;
     }, "strip", z.ZodTypeAny, {
-        type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+        type: "image" | "input" | "file" | "section" | "divider" | "header" | "context" | "actions";
         title?: {
             type: "plain_text";
             text: string;
             emoji?: boolean | undefined;
         } | undefined;
+        optional?: boolean | undefined;
         text?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -167,7 +168,6 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         } | undefined;
         image_url?: string | undefined;
-        optional?: boolean | undefined;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -187,12 +187,13 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
         label?: unknown;
         hint?: unknown;
     }, {
-        type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+        type: "image" | "input" | "file" | "section" | "divider" | "header" | "context" | "actions";
         title?: {
             type: "plain_text";
             text: string;
             emoji?: boolean | undefined;
         } | undefined;
+        optional?: boolean | undefined;
         text?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -200,7 +201,6 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         } | undefined;
         image_url?: string | undefined;
-        optional?: boolean | undefined;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -269,12 +269,13 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
         output?: unknown;
     }[] | undefined;
     blocks?: {
-        type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+        type: "image" | "input" | "file" | "section" | "divider" | "header" | "context" | "actions";
         title?: {
             type: "plain_text";
             text: string;
             emoji?: boolean | undefined;
         } | undefined;
+        optional?: boolean | undefined;
         text?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -282,7 +283,6 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         } | undefined;
         image_url?: string | undefined;
-        optional?: boolean | undefined;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -319,12 +319,13 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
         output?: unknown;
     }[] | undefined;
     blocks?: {
-        type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+        type: "image" | "input" | "file" | "section" | "divider" | "header" | "context" | "actions";
         title?: {
             type: "plain_text";
             text: string;
             emoji?: boolean | undefined;
         } | undefined;
+        optional?: boolean | undefined;
         text?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -332,7 +333,6 @@ declare const SlackFormatterAgentResultSchema: z.ZodObject<{
             verbatim?: boolean | undefined;
         } | undefined;
         image_url?: string | undefined;
-        optional?: boolean | undefined;
         fields?: {
             type: "plain_text" | "mrkdwn";
             text: string;
@@ -512,12 +512,13 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             }>, "many">>;
         }, "strip", z.ZodTypeAny, {
-            type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+            type: "image" | "input" | "file" | "section" | "divider" | "header" | "context" | "actions";
             title?: {
                 type: "plain_text";
                 text: string;
                 emoji?: boolean | undefined;
             } | undefined;
+            optional?: boolean | undefined;
             text?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -525,7 +526,6 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             } | undefined;
             image_url?: string | undefined;
-            optional?: boolean | undefined;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -545,12 +545,13 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
             label?: unknown;
             hint?: unknown;
         }, {
-            type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+            type: "image" | "input" | "file" | "section" | "divider" | "header" | "context" | "actions";
             title?: {
                 type: "plain_text";
                 text: string;
                 emoji?: boolean | undefined;
             } | undefined;
+            optional?: boolean | undefined;
             text?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -558,7 +559,6 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             } | undefined;
             image_url?: string | undefined;
-            optional?: boolean | undefined;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -627,12 +627,13 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
             output?: unknown;
         }[] | undefined;
         blocks?: {
-            type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+            type: "image" | "input" | "file" | "section" | "divider" | "header" | "context" | "actions";
             title?: {
                 type: "plain_text";
                 text: string;
                 emoji?: boolean | undefined;
             } | undefined;
+            optional?: boolean | undefined;
             text?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -640,7 +641,6 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             } | undefined;
             image_url?: string | undefined;
-            optional?: boolean | undefined;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -677,12 +677,13 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
             output?: unknown;
         }[] | undefined;
         blocks?: {
-            type: "input" | "image" | "file" | "section" | "header" | "divider" | "context" | "actions";
+            type: "image" | "input" | "file" | "section" | "divider" | "header" | "context" | "actions";
             title?: {
                 type: "plain_text";
                 text: string;
                 emoji?: boolean | undefined;
             } | undefined;
+            optional?: boolean | undefined;
             text?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;
@@ -690,7 +691,6 @@ export declare class SlackFormatterAgentBubble extends WorkflowBubble<SlackForma
                 verbatim?: boolean | undefined;
             } | undefined;
             image_url?: string | undefined;
-            optional?: boolean | undefined;
             fields?: {
                 type: "plain_text" | "mrkdwn";
                 text: string;

package/dist/bubbles.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-02-06T01:34:34.710Z",
+  "generatedAt": "2026-02-06T10:24:31.616Z",
   "totalCount": 60,
   "bubbles": [
     {
@@ -453,6 +453,51 @@
             "default": false,
             "description": "Enable real-time streaming of tokens, tool calls, and iteration progress"
           },
+          "capabilities": {
+            "type": "array",
+            "items": {
+              "type": "object",
+              "properties": {
+                "id": {
+                  "type": "string",
+                  "minLength": 1,
+                  "description": "Capability ID (e.g., \"google-doc-knowledge-base\")"
+                },
+                "inputs": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "anyOf": [
+                      {
+                        "type": "string"
+                      },
+                      {
+                        "type": "number"
+                      },
+                      {
+                        "type": "boolean"
+                      }
+                    ]
+                  },
+                  "default": {},
+                  "description": "Input parameter values for this capability"
+                },
+                "credentials": {
+                  "type": "object",
+                  "additionalProperties": {
+                    "type": "string"
+                  },
+                  "default": {},
+                  "description": "Capability-specific credentials (injected at runtime)"
+                }
+              },
+              "required": [
+                "id"
+              ],
+              "additionalProperties": false
+            },
+            "default": [],
+            "description": "Capabilities that extend the agent with bundled tools, prompts, and credentials. Example: [{ id: \"google-doc-knowledge-base\", inputs: { docId: \"your-doc-id\" } }]"
+          },
           "expectedOutputSchema": {
             "anyOf": [
               {},
@@ -529,7 +574,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/z-ai/glm-4.7\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/anthropic/claude-opus-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/z-ai/glm-4.7\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/anthropic/claude-opus-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);",
+      "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/z-ai/glm-4.7\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/anthropic/claude-opus-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/z-ai/glm-4.7\", \"openrouter/anthropic/claude-sonnet-4.5\", \"openrouter/anthropic/claude-opus-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  capabilities: [{ id: \"example string\" // Capability ID (e.g., \"google-doc-knowledge-base\"), inputs: { \"example_key\": \"example string\" } // structure // Input parameter values for this capability }] // 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});\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",
@@ -39951,15 +39996,15 @@
                   "string"
                 ],
                 "default": "json",
-                "description": "Format for cell values: json (structured) or string (formatted)"
+                "description": "Format for cell values: json (structured) or string (formatted). When using \"string\", timeZone and userLocale are required by the Airtable API (defaults to UTC/en-US if omitted)"
               },
               "timeZone": {
                 "type": "string",
-                "description": "Time zone for date/time fields (e.g., \"America/Los_Angeles\")"
+                "description": "Time zone for date/time fields (e.g., \"America/Los_Angeles\"). Required when cellFormat is \"string\", defaults to \"UTC\""
               },
               "userLocale": {
                 "type": "string",
-                "description": "Locale for formatting (e.g., \"en-US\")"
+                "description": "Locale for formatting (e.g., \"en-US\"). Required when cellFormat is \"string\", defaults to \"en-US\""
               },
               "offset": {
                 "type": "string",
@@ -41477,7 +41522,7 @@
           }
         ]
       },
-      "usageExample": "// List Records example\nconst airtable_list_records = new AirtableBubble({\n  operation: \"list_records\", // List records from an Airtable table with filtering and sorting\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  fields: [\"example string\"], // Array of field names to include in results (returns all fields if not specified)\n  filterByFormula: \"example string\", // Airtable formula to filter records (e.g., \"{Status} = 'Done'\")\n  maxRecords: 42, // Maximum number of records to return (1-100, returns all if not specified)\n  pageSize: 100 // default, // Number of records per page for pagination (1-100)\n  sort: [{ field: \"example string\" // Field name to sort by, direction: \"asc\" // options: \"asc\", \"desc\" // Sort direction (asc or desc) }], // Array of sort specifications to order records\n  view: \"example string\", // View name or ID to use (includes view's filters and sorts)\n  cellFormat: \"json\" // options: \"json\", \"string\", // Format for cell values: json (structured) or string (formatted)\n  timeZone: \"example string\", // Time zone for date/time fields (e.g., \"America/Los_Angeles\")\n  userLocale: \"example string\", // Locale for formatting (e.g., \"en-US\")\n  offset: \"example string\", // Pagination offset from previous response\n});\n\nconst result = await airtable_list_records.action();\n// outputSchema for result.data when operation === 'list_records':\n// {\n//   operation: \"list_records\" // List records from an Airtable table with filtering and sorting,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   records: { id: string // Unique record identifier (starts with rec), createdTime: string // ISO 8601 datetime when record was created, fields: Record<string, unknown> // Record field values as key-value pairs }[] | undefined // Array of record objects,\n//   offset: string | undefined // Pagination offset for retrieving next page of results,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Get Record example\nconst airtable_get_record = new AirtableBubble({\n  operation: \"get_record\", // Retrieve a single record by its ID\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  recordId: \"example string\", // Record ID to retrieve (starts with rec)\n});\n\nconst result = await airtable_get_record.action();\n// outputSchema for result.data when operation === 'get_record':\n// {\n//   operation: \"get_record\" // Retrieve a single record by its ID,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   record: { id: string // Unique record identifier (starts with rec), createdTime: string // ISO 8601 datetime when record was created, fields: Record<string, unknown> // Record field values as key-value pairs } | undefined // Record object,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Create Records example\nconst airtable_create_records = new AirtableBubble({\n  operation: \"create_records\", // Create one or more new records in an Airtable table\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  records: [{ fields: { \"example_key\": [] } // Field values for the new record }], // Array of records to create (max 10 per request)\n  typecast: false // default, // Automatically convert field values to the appropriate type\n});\n\nconst result = await airtable_create_records.action();\n// outputSchema for result.data when operation === 'create_records':\n// {\n//   operation: \"create_records\" // Create one or more new records in an Airtable table,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   records: { id: string // Unique record identifier (starts with rec), createdTime: string // ISO 8601 datetime when record was created, fields: Record<string, unknown> // Record field values as key-value pairs }[] | undefined // Array of created record objects,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Update Records example\nconst airtable_update_records = new AirtableBubble({\n  operation: \"update_records\", // Update existing records in an Airtable table\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  records: [{ id: \"example string\" // Record ID to update (starts with rec), fields: { \"example_key\": [] } // Field values to update (only specified fields will be updated) }], // Array of records to update (max 10 per request)\n  typecast: false // default, // Automatically convert field values to the appropriate type\n});\n\nconst result = await airtable_update_records.action();\n// outputSchema for result.data when operation === 'update_records':\n// {\n//   operation: \"update_records\" // Update existing records in an Airtable table,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   records: { id: string // Unique record identifier (starts with rec), createdTime: string // ISO 8601 datetime when record was created, fields: Record<string, unknown> // Record field values as key-value pairs }[] | undefined // Array of updated record objects,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Delete Records example\nconst airtable_delete_records = new AirtableBubble({\n  operation: \"delete_records\", // Delete one or more records from an Airtable table\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  recordIds: [\"example string\"], // Array of record IDs to delete (max 10 per request)\n});\n\nconst result = await airtable_delete_records.action();\n// outputSchema for result.data when operation === 'delete_records':\n// {\n//   operation: \"delete_records\" // Delete one or more records from an Airtable table,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   records: { id: string // ID of deleted record, deleted: boolean // Whether the record was deleted }[] | undefined // Array of deletion confirmation objects,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// List Bases example\nconst airtable_list_bases = new AirtableBubble({\n  operation: \"list_bases\", // List all bases accessible with the current API key\n});\n\nconst result = await airtable_list_bases.action();\n// outputSchema for result.data when operation === 'list_bases':\n// {\n//   operation: \"list_bases\" // List all bases accessible with the current API key,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   bases: { id: string // Base ID, name: string // Base name, permissionLevel: string // Permission level for this base }[] | undefined // Array of base objects,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Get Base Schema example\nconst airtable_get_base_schema = new AirtableBubble({\n  operation: \"get_base_schema\", // Get the schema for a specific base including all tables and fields\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n});\n\nconst result = await airtable_get_base_schema.action();\n// outputSchema for result.data when operation === 'get_base_schema':\n// {\n//   operation: \"get_base_schema\" // Get the schema for a specific base including all tables and fields,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   tables: { id: string // Table ID, name: string // Table name, description: string | undefined // Table description, primaryFieldId: string // ID of the primary field, fields: { id: string // Field ID, name: string // Field name, type: string // Field type, description: string | undefined // Field description, options: Record<string, unknown> | undefined // Field options }[] // Array of field definitions, views: { id: string // View ID, name: string // View name, type: string // View type }[] | undefined // Array of view definitions }[] | undefined // Array of table schemas,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Create Table example\nconst airtable_create_table = new AirtableBubble({\n  operation: \"create_table\", // Create a new table in an Airtable base\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  name: \"example string\", // Name for the new table\n  description: \"example string\", // Optional description for the table\n  fields: [{ name: \"example string\" // Field name, type: \"singleLineText\" // options: \"singleLineText\", \"multilineText\", \"richText\", \"email\", \"url\", \"phoneNumber\", \"number\", \"percent\", \"currency\", \"rating\", \"duration\", \"singleSelect\", \"multipleSelects\", \"singleCollaborator\", \"multipleCollaborators\", \"date\", \"dateTime\", \"checkbox\", \"multipleRecordLinks\", \"multipleAttachments\", \"barcode\", \"button\", \"formula\", \"createdTime\", \"lastModifiedTime\", \"createdBy\", \"lastModifiedBy\", \"autoNumber\", \"externalSyncSource\", \"count\", \"lookup\", \"rollup\" // Field type, description: \"example string\" // Field description, options: {} // Field options }], // Array of field definitions for the table\n});\n\nconst result = await airtable_create_table.action();\n// outputSchema for result.data when operation === 'create_table':\n// {\n//   operation: \"create_table\" // Create a new table in an Airtable base,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   table: { id: string // Table ID, name: string // Table name, description: string | undefined // Table description, primaryFieldId: string // ID of the primary field, fields: { id: string // Field ID, name: string // Field name, type: \"singleLineText\" | \"multilineText\" | \"richText\" | \"email\" | \"url\" | \"phoneNumber\" | \"number\" | \"percent\" | \"currency\" | \"rating\" | \"duration\" | \"singleSelect\" | \"multipleSelects\" | \"singleCollaborator\" | \"multipleCollaborators\" | \"date\" | \"dateTime\" | \"checkbox\" | \"multipleRecordLinks\" | \"multipleAttachments\" | \"barcode\" | \"button\" | \"formula\" | \"createdTime\" | \"lastModifiedTime\" | \"createdBy\" | \"lastModifiedBy\" | \"autoNumber\" | \"externalSyncSource\" | \"count\" | \"lookup\" | \"rollup\" // Field type }[] // Array of field definitions } | undefined // Created table object,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Update Table example\nconst airtable_update_table = new AirtableBubble({\n  operation: \"update_table\", // Update table properties like name and description\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  name: \"example string\", // New name for the table\n  description: \"example string\", // New description for the table\n});\n\nconst result = await airtable_update_table.action();\n// outputSchema for result.data when operation === 'update_table':\n// {\n//   operation: \"update_table\" // Update table properties like name and description,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   table: { id: string // Table ID, name: string // Table name, description: string | undefined // Table description } | undefined // Updated table object,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Create Field example\nconst airtable_create_field = new AirtableBubble({\n  operation: \"create_field\", // Create a new field in an Airtable table\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  name: \"example string\", // Name for the new field\n  type: \"singleLineText\" // options: \"singleLineText\", \"multilineText\", \"richText\", \"email\", \"url\", \"phoneNumber\", \"number\", \"percent\", \"currency\", \"rating\", \"duration\", \"singleSelect\", \"multipleSelects\", \"singleCollaborator\", \"multipleCollaborators\", \"date\", \"dateTime\", \"checkbox\", \"multipleRecordLinks\", \"multipleAttachments\", \"barcode\", \"button\", \"formula\", \"createdTime\", \"lastModifiedTime\", \"createdBy\", \"lastModifiedBy\", \"autoNumber\", \"externalSyncSource\", \"count\", \"lookup\", \"rollup\", // Field type\n  description: \"example string\", // Field description\n  options: {}, // Field-specific options\n});\n\nconst result = await airtable_create_field.action();\n// outputSchema for result.data when operation === 'create_field':\n// {\n//   operation: \"create_field\" // Create a new field in an Airtable table,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   field: { id: string // Field ID, name: string // Field name, type: string // Field type, description: string | undefined // Field description } | undefined // Created field object,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Update Field example\nconst airtable_update_field = new AirtableBubble({\n  operation: \"update_field\", // Update field properties like name, type, or description\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  fieldIdOrName: \"example string\", // Field ID (e.g., fldXXXXXXXXXXXXXX) or field name\n  name: \"example string\", // New name for the field\n  description: \"example string\", // New description for the field\n});\n\nconst result = await airtable_update_field.action();\n// outputSchema for result.data when operation === 'update_field':\n// {\n//   operation: \"update_field\" // Update field properties like name, type, or description,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   field: { id: string // Field ID, name: string // Field name, type: string // Field type, description: string | undefined // Field description } | undefined // Updated field object,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`airtable failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
+      "usageExample": "// List Records example\nconst airtable_list_records = new AirtableBubble({\n  operation: \"list_records\", // List records from an Airtable table with filtering and sorting\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  fields: [\"example string\"], // Array of field names to include in results (returns all fields if not specified)\n  filterByFormula: \"example string\", // Airtable formula to filter records (e.g., \"{Status} = 'Done'\")\n  maxRecords: 42, // Maximum number of records to return (1-100, returns all if not specified)\n  pageSize: 100 // default, // Number of records per page for pagination (1-100)\n  sort: [{ field: \"example string\" // Field name to sort by, direction: \"asc\" // options: \"asc\", \"desc\" // Sort direction (asc or desc) }], // Array of sort specifications to order records\n  view: \"example string\", // View name or ID to use (includes view's filters and sorts)\n  cellFormat: \"json\" // options: \"json\", \"string\", // Format for cell values: json (structured) or string (formatted). When using \"string\", timeZone and userLocale are required by the Airtable API (defaults to UTC/en-US if omitted)\n  timeZone: \"example string\", // Time zone for date/time fields (e.g., \"America/Los_Angeles\"). Required when cellFormat is \"string\", defaults to \"UTC\"\n  userLocale: \"example string\", // Locale for formatting (e.g., \"en-US\"). Required when cellFormat is \"string\", defaults to \"en-US\"\n  offset: \"example string\", // Pagination offset from previous response\n});\n\nconst result = await airtable_list_records.action();\n// outputSchema for result.data when operation === 'list_records':\n// {\n//   operation: \"list_records\" // List records from an Airtable table with filtering and sorting,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   records: { id: string // Unique record identifier (starts with rec), createdTime: string // ISO 8601 datetime when record was created, fields: Record<string, unknown> // Record field values as key-value pairs }[] | undefined // Array of record objects,\n//   offset: string | undefined // Pagination offset for retrieving next page of results,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Get Record example\nconst airtable_get_record = new AirtableBubble({\n  operation: \"get_record\", // Retrieve a single record by its ID\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  recordId: \"example string\", // Record ID to retrieve (starts with rec)\n});\n\nconst result = await airtable_get_record.action();\n// outputSchema for result.data when operation === 'get_record':\n// {\n//   operation: \"get_record\" // Retrieve a single record by its ID,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   record: { id: string // Unique record identifier (starts with rec), createdTime: string // ISO 8601 datetime when record was created, fields: Record<string, unknown> // Record field values as key-value pairs } | undefined // Record object,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Create Records example\nconst airtable_create_records = new AirtableBubble({\n  operation: \"create_records\", // Create one or more new records in an Airtable table\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  records: [{ fields: { \"example_key\": [] } // Field values for the new record }], // Array of records to create (max 10 per request)\n  typecast: false // default, // Automatically convert field values to the appropriate type\n});\n\nconst result = await airtable_create_records.action();\n// outputSchema for result.data when operation === 'create_records':\n// {\n//   operation: \"create_records\" // Create one or more new records in an Airtable table,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   records: { id: string // Unique record identifier (starts with rec), createdTime: string // ISO 8601 datetime when record was created, fields: Record<string, unknown> // Record field values as key-value pairs }[] | undefined // Array of created record objects,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Update Records example\nconst airtable_update_records = new AirtableBubble({\n  operation: \"update_records\", // Update existing records in an Airtable table\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  records: [{ id: \"example string\" // Record ID to update (starts with rec), fields: { \"example_key\": [] } // Field values to update (only specified fields will be updated) }], // Array of records to update (max 10 per request)\n  typecast: false // default, // Automatically convert field values to the appropriate type\n});\n\nconst result = await airtable_update_records.action();\n// outputSchema for result.data when operation === 'update_records':\n// {\n//   operation: \"update_records\" // Update existing records in an Airtable table,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   records: { id: string // Unique record identifier (starts with rec), createdTime: string // ISO 8601 datetime when record was created, fields: Record<string, unknown> // Record field values as key-value pairs }[] | undefined // Array of updated record objects,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Delete Records example\nconst airtable_delete_records = new AirtableBubble({\n  operation: \"delete_records\", // Delete one or more records from an Airtable table\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  recordIds: [\"example string\"], // Array of record IDs to delete (max 10 per request)\n});\n\nconst result = await airtable_delete_records.action();\n// outputSchema for result.data when operation === 'delete_records':\n// {\n//   operation: \"delete_records\" // Delete one or more records from an Airtable table,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   records: { id: string // ID of deleted record, deleted: boolean // Whether the record was deleted }[] | undefined // Array of deletion confirmation objects,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// List Bases example\nconst airtable_list_bases = new AirtableBubble({\n  operation: \"list_bases\", // List all bases accessible with the current API key\n});\n\nconst result = await airtable_list_bases.action();\n// outputSchema for result.data when operation === 'list_bases':\n// {\n//   operation: \"list_bases\" // List all bases accessible with the current API key,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   bases: { id: string // Base ID, name: string // Base name, permissionLevel: string // Permission level for this base }[] | undefined // Array of base objects,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Get Base Schema example\nconst airtable_get_base_schema = new AirtableBubble({\n  operation: \"get_base_schema\", // Get the schema for a specific base including all tables and fields\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n});\n\nconst result = await airtable_get_base_schema.action();\n// outputSchema for result.data when operation === 'get_base_schema':\n// {\n//   operation: \"get_base_schema\" // Get the schema for a specific base including all tables and fields,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   tables: { id: string // Table ID, name: string // Table name, description: string | undefined // Table description, primaryFieldId: string // ID of the primary field, fields: { id: string // Field ID, name: string // Field name, type: string // Field type, description: string | undefined // Field description, options: Record<string, unknown> | undefined // Field options }[] // Array of field definitions, views: { id: string // View ID, name: string // View name, type: string // View type }[] | undefined // Array of view definitions }[] | undefined // Array of table schemas,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Create Table example\nconst airtable_create_table = new AirtableBubble({\n  operation: \"create_table\", // Create a new table in an Airtable base\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  name: \"example string\", // Name for the new table\n  description: \"example string\", // Optional description for the table\n  fields: [{ name: \"example string\" // Field name, type: \"singleLineText\" // options: \"singleLineText\", \"multilineText\", \"richText\", \"email\", \"url\", \"phoneNumber\", \"number\", \"percent\", \"currency\", \"rating\", \"duration\", \"singleSelect\", \"multipleSelects\", \"singleCollaborator\", \"multipleCollaborators\", \"date\", \"dateTime\", \"checkbox\", \"multipleRecordLinks\", \"multipleAttachments\", \"barcode\", \"button\", \"formula\", \"createdTime\", \"lastModifiedTime\", \"createdBy\", \"lastModifiedBy\", \"autoNumber\", \"externalSyncSource\", \"count\", \"lookup\", \"rollup\" // Field type, description: \"example string\" // Field description, options: {} // Field options }], // Array of field definitions for the table\n});\n\nconst result = await airtable_create_table.action();\n// outputSchema for result.data when operation === 'create_table':\n// {\n//   operation: \"create_table\" // Create a new table in an Airtable base,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   table: { id: string // Table ID, name: string // Table name, description: string | undefined // Table description, primaryFieldId: string // ID of the primary field, fields: { id: string // Field ID, name: string // Field name, type: \"singleLineText\" | \"multilineText\" | \"richText\" | \"email\" | \"url\" | \"phoneNumber\" | \"number\" | \"percent\" | \"currency\" | \"rating\" | \"duration\" | \"singleSelect\" | \"multipleSelects\" | \"singleCollaborator\" | \"multipleCollaborators\" | \"date\" | \"dateTime\" | \"checkbox\" | \"multipleRecordLinks\" | \"multipleAttachments\" | \"barcode\" | \"button\" | \"formula\" | \"createdTime\" | \"lastModifiedTime\" | \"createdBy\" | \"lastModifiedBy\" | \"autoNumber\" | \"externalSyncSource\" | \"count\" | \"lookup\" | \"rollup\" // Field type }[] // Array of field definitions } | undefined // Created table object,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Update Table example\nconst airtable_update_table = new AirtableBubble({\n  operation: \"update_table\", // Update table properties like name and description\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  name: \"example string\", // New name for the table\n  description: \"example string\", // New description for the table\n});\n\nconst result = await airtable_update_table.action();\n// outputSchema for result.data when operation === 'update_table':\n// {\n//   operation: \"update_table\" // Update table properties like name and description,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   table: { id: string // Table ID, name: string // Table name, description: string | undefined // Table description } | undefined // Updated table object,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Create Field example\nconst airtable_create_field = new AirtableBubble({\n  operation: \"create_field\", // Create a new field in an Airtable table\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  name: \"example string\", // Name for the new field\n  type: \"singleLineText\" // options: \"singleLineText\", \"multilineText\", \"richText\", \"email\", \"url\", \"phoneNumber\", \"number\", \"percent\", \"currency\", \"rating\", \"duration\", \"singleSelect\", \"multipleSelects\", \"singleCollaborator\", \"multipleCollaborators\", \"date\", \"dateTime\", \"checkbox\", \"multipleRecordLinks\", \"multipleAttachments\", \"barcode\", \"button\", \"formula\", \"createdTime\", \"lastModifiedTime\", \"createdBy\", \"lastModifiedBy\", \"autoNumber\", \"externalSyncSource\", \"count\", \"lookup\", \"rollup\", // Field type\n  description: \"example string\", // Field description\n  options: {}, // Field-specific options\n});\n\nconst result = await airtable_create_field.action();\n// outputSchema for result.data when operation === 'create_field':\n// {\n//   operation: \"create_field\" // Create a new field in an Airtable table,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   field: { id: string // Field ID, name: string // Field name, type: string // Field type, description: string | undefined // Field description } | undefined // Created field object,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Update Field example\nconst airtable_update_field = new AirtableBubble({\n  operation: \"update_field\", // Update field properties like name, type, or description\n  baseId: \"example string\", // Airtable base ID (e.g., appXXXXXXXXXXXXXX)\n  tableIdOrName: \"example string\", // Table ID (e.g., tblXXXXXXXXXXXXXX) or table name\n  fieldIdOrName: \"example string\", // Field ID (e.g., fldXXXXXXXXXXXXXX) or field name\n  name: \"example string\", // New name for the field\n  description: \"example string\", // New description for the field\n});\n\nconst result = await airtable_update_field.action();\n// outputSchema for result.data when operation === 'update_field':\n// {\n//   operation: \"update_field\" // Update field properties like name, type, or description,\n//   ok: boolean // Whether the Airtable API call was successful,\n//   field: { id: string // Field ID, name: string // Field name, type: string // Field type, description: string | undefined // Field description } | undefined // Updated field object,\n//   error: string // Error message if operation failed,\n//   success: boolean // Whether the operation was successful\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`airtable failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
       "requiredCredentials": [
         "AIRTABLE_CRED",
         "AIRTABLE_OAUTH"

package/dist/capabilities/define-capability.d.ts

@@ -0,0 +1,53 @@
+import type { CapabilityMetadata, CapabilityInput } from '@bubblelab/shared-schemas';
+import type { CredentialType } from '@bubblelab/shared-schemas';
+import type { ToolHookBefore, ToolHookAfter } from '../bubbles/service-bubble/ai-agent.js';
+import type { BubbleContext } from '../types/bubble.js';
+import { z } from 'zod';
+/** Runtime context passed to capability tool factories and system prompt factories. */
+export interface CapabilityRuntimeContext {
+    credentials: Partial<Record<CredentialType, string>>;
+    inputs: Record<string, string | number | boolean>;
+    bubbleContext?: BubbleContext;
+}
+/** A single capability tool function that accepts parsed parameters and returns a result. */
+export type CapabilityToolFunc = (params: Record<string, unknown>) => Promise<unknown>;
+/** Factory that creates tool functions given a runtime context. */
+export type CapabilityToolFactory = (context: CapabilityRuntimeContext) => Record<string, CapabilityToolFunc>;
+/** Factory that creates a system prompt addition given a runtime context. */
+export type CapabilitySystemPromptFactory = (context: CapabilityRuntimeContext) => string;
+/** Full runtime capability definition with metadata + factories. */
+export interface CapabilityDefinition {
+    metadata: CapabilityMetadata;
+    createTools: CapabilityToolFactory;
+    createSystemPrompt?: CapabilitySystemPromptFactory;
+    hooks?: {
+        beforeToolCall?: ToolHookBefore;
+        afterToolCall?: ToolHookAfter;
+    };
+}
+/** Options for the defineCapability() helper — ergonomic API for creating capabilities. */
+export interface DefineCapabilityOptions {
+    id: string;
+    name: string;
+    description: string;
+    icon?: string;
+    category?: string;
+    version?: string;
+    requiredCredentials: CredentialType[];
+    inputs: CapabilityInput[];
+    tools: Array<{
+        name: string;
+        description: string;
+        schema: z.ZodObject<z.ZodRawShape>;
+        func: (ctx: CapabilityRuntimeContext) => CapabilityToolFunc;
+    }>;
+    systemPrompt?: string | CapabilitySystemPromptFactory;
+    hooks?: CapabilityDefinition['hooks'];
+}
+/**
+ * Creates a CapabilityDefinition from a user-friendly options object.
+ * Converts Zod schemas to JSON Schema for serializable metadata,
+ * and wraps tool functions with context currying.
+ */
+export declare function defineCapability(options: DefineCapabilityOptions): CapabilityDefinition;
+//# sourceMappingURL=define-capability.d.ts.map

package/dist/capabilities/define-capability.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"define-capability.d.ts","sourceRoot":"","sources":["../../src/capabilities/define-capability.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,kBAAkB,EAClB,eAAe,EAEhB,MAAM,2BAA2B,CAAC;AACnC,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,2BAA2B,CAAC;AAChE,OAAO,KAAK,EACV,cAAc,EACd,aAAa,EACd,MAAM,uCAAuC,CAAC;AAC/C,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAGxB,uFAAuF;AACvF,MAAM,WAAW,wBAAwB;IACvC,WAAW,EAAE,OAAO,CAAC,MAAM,CAAC,cAAc,EAAE,MAAM,CAAC,CAAC,CAAC;IACrD,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,CAAC;IAClD,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B;AAED,6FAA6F;AAC7F,MAAM,MAAM,kBAAkB,GAAG,CAC/B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,KAC5B,OAAO,CAAC,OAAO,CAAC,CAAC;AAEtB,mEAAmE;AACnE,MAAM,MAAM,qBAAqB,GAAG,CAClC,OAAO,EAAE,wBAAwB,KAC9B,MAAM,CAAC,MAAM,EAAE,kBAAkB,CAAC,CAAC;AAExC,6EAA6E;AAC7E,MAAM,MAAM,6BAA6B,GAAG,CAC1C,OAAO,EAAE,wBAAwB,KAC9B,MAAM,CAAC;AAEZ,oEAAoE;AACpE,MAAM,WAAW,oBAAoB;IACnC,QAAQ,EAAE,kBAAkB,CAAC;IAC7B,WAAW,EAAE,qBAAqB,CAAC;IACnC,kBAAkB,CAAC,EAAE,6BAA6B,CAAC;IACnD,KAAK,CAAC,EAAE;QACN,cAAc,CAAC,EAAE,cAAc,CAAC;QAChC,aAAa,CAAC,EAAE,aAAa,CAAC;KAC/B,CAAC;CACH;AAED,2FAA2F;AAC3F,MAAM,WAAW,uBAAuB;IACtC,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,mBAAmB,EAAE,cAAc,EAAE,CAAC;IACtC,MAAM,EAAE,eAAe,EAAE,CAAC;IAC1B,KAAK,EAAE,KAAK,CAAC;QACX,IAAI,EAAE,MAAM,CAAC;QACb,WAAW,EAAE,MAAM,CAAC;QACpB,MAAM,EAAE,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC;QACnC,IAAI,EAAE,CAAC,GAAG,EAAE,wBAAwB,KAAK,kBAAkB,CAAC;KAC7D,CAAC,CAAC;IACH,YAAY,CAAC,EAAE,MAAM,GAAG,6BAA6B,CAAC;IACtD,KAAK,CAAC,EAAE,oBAAoB,CAAC,OAAO,CAAC,CAAC;CACvC;AAED;;;;GAIG;AACH,wBAAgB,gBAAgB,CAC9B,OAAO,EAAE,uBAAuB,GAC/B,oBAAoB,CAgDtB"}