@bubblelab/bubble-core 0.1.26 → 0.1.28

package/dist/bubbles.json

@@ -1,6 +1,6 @@
 {
   "version": "2.0.0",
-  "generatedAt": "2026-01-21T22:20:43.648Z",
+  "generatedAt": "2026-01-22T11:04:49.739Z",
   "totalCount": 53,
   "bubbles": [
     {
@@ -11439,7 +11439,7 @@
               "range": {
                 "type": "string",
                 "minLength": 1,
-                "description": "A1 notation range (e.g., \"Sheet1!A1:B10\" or \"Sheet Name!A:G\" - sheet names with spaces are automatically quoted)"
+                "description": "A1 notation range (e.g., \"Sheet1!A1:B10\" or \"Tab Name!A:G\" - tab names with spaces are automatically quoted)"
               },
               "major_dimension": {
                 "type": "string",
@@ -11502,7 +11502,7 @@
               "range": {
                 "type": "string",
                 "minLength": 1,
-                "description": "A1 notation range (e.g., \"Sheet1!A1:B10\" or \"Sheet Name!A:G\" - sheet names with spaces are automatically quoted)"
+                "description": "A1 notation range (e.g., \"Sheet1!A1:B10\" or \"Tab Name!A:G\" - tab names with spaces are automatically quoted)"
               },
               "values": {
                 "type": "array",
@@ -11570,7 +11570,7 @@
               "range": {
                 "type": "string",
                 "minLength": 1,
-                "description": "A1 notation range (e.g., \"Sheet1!A1:B10\" or \"Sheet Name!A:G\" - sheet names with spaces are automatically quoted)"
+                "description": "A1 notation range (e.g., \"Sheet1!A1:B10\" or \"Tab Name!A:G\" - tab names with spaces are automatically quoted)"
               },
               "values": {
                 "type": "array",
@@ -11638,7 +11638,7 @@
               "range": {
                 "type": "string",
                 "minLength": 1,
-                "description": "A1 notation range to search for table (e.g., \"Sheet1!A:A\" or \"Sheet Name!A:G\" - sheet names with spaces are automatically quoted)"
+                "description": "A1 notation range to search for table (e.g., \"Sheet1!A:A\" or \"Tab Name!A:G\" - tab names with spaces are automatically quoted)"
               },
               "values": {
                 "type": "array",
@@ -11715,7 +11715,7 @@
               "range": {
                 "type": "string",
                 "minLength": 1,
-                "description": "A1 notation range (e.g., \"Sheet1!A1:B10\" or \"Sheet Name!A:G\" - sheet names with spaces are automatically quoted)"
+                "description": "A1 notation range (e.g., \"Sheet1!A1:B10\" or \"Tab Name!A:G\" - tab names with spaces are automatically quoted)"
               },
               "credentials": {
                 "type": "object",
@@ -11753,7 +11753,7 @@
                   "type": "string"
                 },
                 "minItems": 1,
-                "description": "Array of A1 notation ranges (sheet names with spaces are automatically quoted)"
+                "description": "Array of A1 notation ranges (tab names with spaces are automatically quoted)"
               },
               "major_dimension": {
                 "type": "string",
@@ -11820,7 +11820,7 @@
                   "properties": {
                     "range": {
                       "type": "string",
-                      "description": "A1 notation range (sheet names with spaces are automatically quoted)"
+                      "description": "A1 notation range (tab names with spaces are automatically quoted)"
                     },
                     "values": {
                       "type": "array",
@@ -11934,7 +11934,7 @@
                 "default": [
                   "Sheet1"
                 ],
-                "description": "Titles for the initial sheets"
+                "description": "Tab names for the initial tabs (these are the tabs at the bottom of a spreadsheet, not the spreadsheet name)"
               },
               "credentials": {
                 "type": "object",
@@ -11958,7 +11958,7 @@
                 "enum": [
                   "add_sheet"
                 ],
-                "description": "Add a new sheet to spreadsheet"
+                "description": "Add a new tab to spreadsheet"
               },
               "spreadsheet_id": {
                 "type": "string",
@@ -11968,7 +11968,7 @@
               "sheet_title": {
                 "type": "string",
                 "minLength": 1,
-                "description": "Title for the new sheet"
+                "description": "Tab name for the new tab (this is the tab at the bottom of a spreadsheet, not the spreadsheet name)"
               },
               "row_count": {
                 "type": "number",
@@ -12005,7 +12005,7 @@
                 "enum": [
                   "delete_sheet"
                 ],
-                "description": "Delete a sheet from spreadsheet"
+                "description": "Delete a tab from spreadsheet"
               },
               "spreadsheet_id": {
                 "type": "string",
@@ -12740,7 +12740,7 @@
                 "enum": [
                   "add_sheet"
                 ],
-                "description": "Add a new sheet to spreadsheet"
+                "description": "Add a new tab to spreadsheet"
               },
               "success": {
                 "type": "boolean",
@@ -12752,7 +12752,7 @@
               },
               "sheet_title": {
                 "type": "string",
-                "description": "Title of the added sheet"
+                "description": "Tab name of the added tab"
               },
               "error": {
                 "type": "string",
@@ -12774,7 +12774,7 @@
                 "enum": [
                   "delete_sheet"
                 ],
-                "description": "Delete a sheet from spreadsheet"
+                "description": "Delete a tab from spreadsheet"
               },
               "success": {
                 "type": "boolean",
@@ -12798,7 +12798,7 @@
           }
         ]
       },
-      "usageExample": "// Read Values example\nconst googleSheets_read_values = new GoogleSheetsBubble({\n  operation: \"read_values\", // Read values from a range\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\", // Major dimension for the values\n  value_render_option: \"FORMATTED_VALUE\" // options: \"FORMATTED_VALUE\", \"UNFORMATTED_VALUE\", \"FORMULA\", // How values should be represented in the output\n  date_time_render_option: \"SERIAL_NUMBER\" // options: \"SERIAL_NUMBER\", \"FORMATTED_STRING\", // How date/time values should be rendered\n});\n\nconst result = await googleSheets_read_values.action();\n// outputSchema for result.data when operation === 'read_values':\n// {\n//   operation: \"read_values\" // Read values from a range,\n//   success: boolean // Whether the operation was successful,\n//   range: string | undefined // The range that was read,\n//   values: unknown[][] | undefined // The values that were read,\n//   major_dimension: string | undefined // Major dimension of the returned values,\n//   error: string // Error message if operation failed\n// }\n\n\n// Write Values example\nconst googleSheets_write_values = new GoogleSheetsBubble({\n  operation: \"write_values\", // Write values to a range\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\", // Major dimension for the values\n  value_input_option: \"RAW\" // options: \"RAW\", \"USER_ENTERED\", // How input data should be interpreted\n  include_values_in_response: false // default, // Include updated values in response\n});\n\nconst result = await googleSheets_write_values.action();\n// outputSchema for result.data when operation === 'write_values':\n// {\n//   operation: \"write_values\" // Write values to a range,\n//   success: boolean // Whether the operation was successful,\n//   updated_range: string | undefined // The range that was updated,\n//   updated_rows: number | undefined // Number of rows updated,\n//   updated_columns: number | undefined // Number of columns updated,\n//   updated_cells: number | undefined // Number of cells updated,\n//   updated_data: { range: string // The A1 notation range, majorDimension: \"ROWS\" | \"COLUMNS\" | undefined // Major dimension of the values, values: unknown[][] // The data values as array of arrays } | undefined // Updated data if requested,\n//   error: string // Error message if operation failed\n// }\n\n\n// Update Values example\nconst googleSheets_update_values = new GoogleSheetsBubble({\n  operation: \"update_values\", // Update values in a specific range\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\", // Major dimension for the values\n  value_input_option: \"RAW\" // options: \"RAW\", \"USER_ENTERED\", // How input data should be interpreted\n  include_values_in_response: false // default, // Include updated values in response\n});\n\nconst result = await googleSheets_update_values.action();\n// outputSchema for result.data when operation === 'update_values':\n// {\n//   operation: \"update_values\" // Update values in a specific range,\n//   success: boolean // Whether the operation was successful,\n//   updated_range: string | undefined // The range that was updated,\n//   updated_rows: number | undefined // Number of rows updated,\n//   updated_columns: number | undefined // Number of columns updated,\n//   updated_cells: number | undefined // Number of cells updated,\n//   updated_data: { range: string // The A1 notation range, majorDimension: \"ROWS\" | \"COLUMNS\" | undefined // Major dimension of the values, values: unknown[][] // The data values as array of arrays } | undefined // Updated data if requested,\n//   error: string // Error message if operation failed\n// }\n\n\n// Append Values example\nconst googleSheets_append_values = new GoogleSheetsBubble({\n  operation: \"append_values\", // Append values to the end of a table\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\", // Major dimension for the values\n  value_input_option: \"RAW\" // options: \"RAW\", \"USER_ENTERED\", // How input data should be interpreted\n  insert_data_option: \"OVERWRITE\" // options: \"OVERWRITE\", \"INSERT_ROWS\", // How data should be inserted\n  include_values_in_response: false // default, // Include appended values in response\n});\n\nconst result = await googleSheets_append_values.action();\n// outputSchema for result.data when operation === 'append_values':\n// {\n//   operation: \"append_values\" // Append values to the end of a table,\n//   success: boolean // Whether the operation was successful,\n//   table_range: string | undefined // The table range values were appended to,\n//   updated_range: string | undefined // The range that was updated,\n//   updated_rows: number | undefined // Number of rows updated,\n//   updated_columns: number | undefined // Number of columns updated,\n//   updated_cells: number | undefined // Number of cells updated,\n//   error: string // Error message if operation failed\n// }\n\n\n// Clear Values example\nconst googleSheets_clear_values = new GoogleSheetsBubble({\n  operation: \"clear_values\", // Clear values from a range\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n});\n\nconst result = await googleSheets_clear_values.action();\n// outputSchema for result.data when operation === 'clear_values':\n// {\n//   operation: \"clear_values\" // Clear values from a range,\n//   success: boolean // Whether the operation was successful,\n//   cleared_range: string | undefined // The range that was cleared,\n//   error: string // Error message if operation failed\n// }\n\n\n// Batch Read Values example\nconst googleSheets_batch_read_values = new GoogleSheetsBubble({\n  operation: \"batch_read_values\", // Read multiple ranges at once\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\", // Major dimension for the values\n  value_render_option: \"FORMATTED_VALUE\" // options: \"FORMATTED_VALUE\", \"UNFORMATTED_VALUE\", \"FORMULA\", // How values should be represented in the output\n  date_time_render_option: \"SERIAL_NUMBER\" // options: \"SERIAL_NUMBER\", \"FORMATTED_STRING\", // How date/time values should be rendered\n});\n\nconst result = await googleSheets_batch_read_values.action();\n// outputSchema for result.data when operation === 'batch_read_values':\n// {\n//   operation: \"batch_read_values\" // Read multiple ranges at once,\n//   success: boolean // Whether the operation was successful,\n//   value_ranges: { range: string // The A1 notation range, majorDimension: \"ROWS\" | \"COLUMNS\" | undefined // Major dimension of the values, values: unknown[][] // The data values as array of arrays }[] | undefined // Array of value ranges that were read,\n//   error: string // Error message if operation failed\n// }\n\n\n// Batch Update Values example\nconst googleSheets_batch_update_values = new GoogleSheetsBubble({\n  operation: \"batch_update_values\", // Update multiple ranges at once\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  value_ranges: [{ major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\" }], // Array of value ranges to update\n  value_input_option: \"RAW\" // options: \"RAW\", \"USER_ENTERED\", // How input data should be interpreted\n  include_values_in_response: false // default, // Include updated values in response\n});\n\nconst result = await googleSheets_batch_update_values.action();\n// outputSchema for result.data when operation === 'batch_update_values':\n// {\n//   operation: \"batch_update_values\" // Update multiple ranges at once,\n//   success: boolean // Whether the operation was successful,\n//   total_updated_rows: number | undefined // Total number of rows updated across all ranges,\n//   total_updated_columns: number | undefined // Total number of columns updated across all ranges,\n//   total_updated_cells: number | undefined // Total number of cells updated across all ranges,\n//   total_updated_sheets: number | undefined // Total number of sheets updated,\n//   responses: { updated_range: string | undefined // Range that was updated, updated_rows: number | undefined // Number of rows updated in this range, updated_columns: number | undefined // Number of columns updated in this range, updated_cells: number | undefined // Number of cells updated in this range }[] | undefined // Individual update responses,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Spreadsheet Info example\nconst googleSheets_get_spreadsheet_info = new GoogleSheetsBubble({\n  operation: \"get_spreadsheet_info\", // Get spreadsheet metadata and properties\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  include_grid_data: false // default, // Include grid data in response\n});\n\nconst result = await googleSheets_get_spreadsheet_info.action();\n// outputSchema for result.data when operation === 'get_spreadsheet_info':\n// {\n//   operation: \"get_spreadsheet_info\" // Get spreadsheet metadata and properties,\n//   success: boolean // Whether the operation was successful,\n//   spreadsheet: { spreadsheetId: string // Unique spreadsheet identifier, properties: { title: string // Spreadsheet title, locale: string | undefined // Spreadsheet locale, autoRecalc: string | undefined // Auto recalc setting, timeZone: string | undefined // Time zone } | undefined // Spreadsheet properties, sheets: { properties: { sheetId: number // Sheet ID, title: string // Sheet title, index: number // Sheet index, sheetType: string | undefined // Sheet type, gridProperties: { rowCount: number | undefined // Number of rows in the sheet, columnCount: number | undefined // Number of columns in the sheet } | undefined // Grid properties of the sheet } // Sheet properties }[] | undefined // List of sheets in the spreadsheet, spreadsheetUrl: string | undefined // URL to the spreadsheet } | undefined // Spreadsheet information,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create Spreadsheet example\nconst googleSheets_create_spreadsheet = new GoogleSheetsBubble({\n  operation: \"create_spreadsheet\", // Create a new spreadsheet\n  title: \"example string\", // Title for the new spreadsheet\n  sheet_titles: [\"Sheet1\"] // default, // Titles for the initial sheets\n});\n\nconst result = await googleSheets_create_spreadsheet.action();\n// outputSchema for result.data when operation === 'create_spreadsheet':\n// {\n//   operation: \"create_spreadsheet\" // Create a new spreadsheet,\n//   success: boolean // Whether the operation was successful,\n//   spreadsheet: { spreadsheetId: string // Unique spreadsheet identifier, properties: { title: string // Spreadsheet title, locale: string | undefined // Spreadsheet locale, autoRecalc: string | undefined // Auto recalc setting, timeZone: string | undefined // Time zone } | undefined // Spreadsheet properties, sheets: { properties: { sheetId: number // Sheet ID, title: string // Sheet title, index: number // Sheet index, sheetType: string | undefined // Sheet type, gridProperties: { rowCount: number | undefined // Number of rows in the sheet, columnCount: number | undefined // Number of columns in the sheet } | undefined // Grid properties of the sheet } // Sheet properties }[] | undefined // List of sheets in the spreadsheet, spreadsheetUrl: string | undefined // URL to the spreadsheet } | undefined // Created spreadsheet information,\n//   error: string // Error message if operation failed\n// }\n\n\n// Add Sheet example\nconst googleSheets_add_sheet = new GoogleSheetsBubble({\n  operation: \"add_sheet\", // Add a new sheet to spreadsheet\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  sheet_title: \"example string\", // Title for the new sheet\n  row_count: 1000 // default, // Number of rows in the new sheet\n  column_count: 26 // default, // Number of columns in the new sheet\n});\n\nconst result = await googleSheets_add_sheet.action();\n// outputSchema for result.data when operation === 'add_sheet':\n// {\n//   operation: \"add_sheet\" // Add a new sheet to spreadsheet,\n//   success: boolean // Whether the operation was successful,\n//   sheet_id: number | undefined // ID of the added sheet,\n//   sheet_title: string | undefined // Title of the added sheet,\n//   error: string // Error message if operation failed\n// }\n\n\n// Delete Sheet example\nconst googleSheets_delete_sheet = new GoogleSheetsBubble({\n  operation: \"delete_sheet\", // Delete a sheet from spreadsheet\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  sheet_id: 42, // ID of the sheet to delete\n});\n\nconst result = await googleSheets_delete_sheet.action();\n// outputSchema for result.data when operation === 'delete_sheet':\n// {\n//   operation: \"delete_sheet\" // Delete a sheet from spreadsheet,\n//   success: boolean // Whether the operation was successful,\n//   deleted_sheet_id: number | undefined // ID of the deleted sheet,\n//   error: string // Error message if operation failed\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`google-sheets failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
+      "usageExample": "// Read Values example\nconst googleSheets_read_values = new GoogleSheetsBubble({\n  operation: \"read_values\", // Read values from a range\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\", // Major dimension for the values\n  value_render_option: \"FORMATTED_VALUE\" // options: \"FORMATTED_VALUE\", \"UNFORMATTED_VALUE\", \"FORMULA\", // How values should be represented in the output\n  date_time_render_option: \"SERIAL_NUMBER\" // options: \"SERIAL_NUMBER\", \"FORMATTED_STRING\", // How date/time values should be rendered\n});\n\nconst result = await googleSheets_read_values.action();\n// outputSchema for result.data when operation === 'read_values':\n// {\n//   operation: \"read_values\" // Read values from a range,\n//   success: boolean // Whether the operation was successful,\n//   range: string | undefined // The range that was read,\n//   values: unknown[][] | undefined // The values that were read,\n//   major_dimension: string | undefined // Major dimension of the returned values,\n//   error: string // Error message if operation failed\n// }\n\n\n// Write Values example\nconst googleSheets_write_values = new GoogleSheetsBubble({\n  operation: \"write_values\", // Write values to a range\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\", // Major dimension for the values\n  value_input_option: \"RAW\" // options: \"RAW\", \"USER_ENTERED\", // How input data should be interpreted\n  include_values_in_response: false // default, // Include updated values in response\n});\n\nconst result = await googleSheets_write_values.action();\n// outputSchema for result.data when operation === 'write_values':\n// {\n//   operation: \"write_values\" // Write values to a range,\n//   success: boolean // Whether the operation was successful,\n//   updated_range: string | undefined // The range that was updated,\n//   updated_rows: number | undefined // Number of rows updated,\n//   updated_columns: number | undefined // Number of columns updated,\n//   updated_cells: number | undefined // Number of cells updated,\n//   updated_data: { range: string // The A1 notation range, majorDimension: \"ROWS\" | \"COLUMNS\" | undefined // Major dimension of the values, values: unknown[][] // The data values as array of arrays } | undefined // Updated data if requested,\n//   error: string // Error message if operation failed\n// }\n\n\n// Update Values example\nconst googleSheets_update_values = new GoogleSheetsBubble({\n  operation: \"update_values\", // Update values in a specific range\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\", // Major dimension for the values\n  value_input_option: \"RAW\" // options: \"RAW\", \"USER_ENTERED\", // How input data should be interpreted\n  include_values_in_response: false // default, // Include updated values in response\n});\n\nconst result = await googleSheets_update_values.action();\n// outputSchema for result.data when operation === 'update_values':\n// {\n//   operation: \"update_values\" // Update values in a specific range,\n//   success: boolean // Whether the operation was successful,\n//   updated_range: string | undefined // The range that was updated,\n//   updated_rows: number | undefined // Number of rows updated,\n//   updated_columns: number | undefined // Number of columns updated,\n//   updated_cells: number | undefined // Number of cells updated,\n//   updated_data: { range: string // The A1 notation range, majorDimension: \"ROWS\" | \"COLUMNS\" | undefined // Major dimension of the values, values: unknown[][] // The data values as array of arrays } | undefined // Updated data if requested,\n//   error: string // Error message if operation failed\n// }\n\n\n// Append Values example\nconst googleSheets_append_values = new GoogleSheetsBubble({\n  operation: \"append_values\", // Append values to the end of a table\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\", // Major dimension for the values\n  value_input_option: \"RAW\" // options: \"RAW\", \"USER_ENTERED\", // How input data should be interpreted\n  insert_data_option: \"OVERWRITE\" // options: \"OVERWRITE\", \"INSERT_ROWS\", // How data should be inserted\n  include_values_in_response: false // default, // Include appended values in response\n});\n\nconst result = await googleSheets_append_values.action();\n// outputSchema for result.data when operation === 'append_values':\n// {\n//   operation: \"append_values\" // Append values to the end of a table,\n//   success: boolean // Whether the operation was successful,\n//   table_range: string | undefined // The table range values were appended to,\n//   updated_range: string | undefined // The range that was updated,\n//   updated_rows: number | undefined // Number of rows updated,\n//   updated_columns: number | undefined // Number of columns updated,\n//   updated_cells: number | undefined // Number of cells updated,\n//   error: string // Error message if operation failed\n// }\n\n\n// Clear Values example\nconst googleSheets_clear_values = new GoogleSheetsBubble({\n  operation: \"clear_values\", // Clear values from a range\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n});\n\nconst result = await googleSheets_clear_values.action();\n// outputSchema for result.data when operation === 'clear_values':\n// {\n//   operation: \"clear_values\" // Clear values from a range,\n//   success: boolean // Whether the operation was successful,\n//   cleared_range: string | undefined // The range that was cleared,\n//   error: string // Error message if operation failed\n// }\n\n\n// Batch Read Values example\nconst googleSheets_batch_read_values = new GoogleSheetsBubble({\n  operation: \"batch_read_values\", // Read multiple ranges at once\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\", // Major dimension for the values\n  value_render_option: \"FORMATTED_VALUE\" // options: \"FORMATTED_VALUE\", \"UNFORMATTED_VALUE\", \"FORMULA\", // How values should be represented in the output\n  date_time_render_option: \"SERIAL_NUMBER\" // options: \"SERIAL_NUMBER\", \"FORMATTED_STRING\", // How date/time values should be rendered\n});\n\nconst result = await googleSheets_batch_read_values.action();\n// outputSchema for result.data when operation === 'batch_read_values':\n// {\n//   operation: \"batch_read_values\" // Read multiple ranges at once,\n//   success: boolean // Whether the operation was successful,\n//   value_ranges: { range: string // The A1 notation range, majorDimension: \"ROWS\" | \"COLUMNS\" | undefined // Major dimension of the values, values: unknown[][] // The data values as array of arrays }[] | undefined // Array of value ranges that were read,\n//   error: string // Error message if operation failed\n// }\n\n\n// Batch Update Values example\nconst googleSheets_batch_update_values = new GoogleSheetsBubble({\n  operation: \"batch_update_values\", // Update multiple ranges at once\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  value_ranges: [{ major_dimension: \"ROWS\" // options: \"ROWS\", \"COLUMNS\" }], // Array of value ranges to update\n  value_input_option: \"RAW\" // options: \"RAW\", \"USER_ENTERED\", // How input data should be interpreted\n  include_values_in_response: false // default, // Include updated values in response\n});\n\nconst result = await googleSheets_batch_update_values.action();\n// outputSchema for result.data when operation === 'batch_update_values':\n// {\n//   operation: \"batch_update_values\" // Update multiple ranges at once,\n//   success: boolean // Whether the operation was successful,\n//   total_updated_rows: number | undefined // Total number of rows updated across all ranges,\n//   total_updated_columns: number | undefined // Total number of columns updated across all ranges,\n//   total_updated_cells: number | undefined // Total number of cells updated across all ranges,\n//   total_updated_sheets: number | undefined // Total number of sheets updated,\n//   responses: { updated_range: string | undefined // Range that was updated, updated_rows: number | undefined // Number of rows updated in this range, updated_columns: number | undefined // Number of columns updated in this range, updated_cells: number | undefined // Number of cells updated in this range }[] | undefined // Individual update responses,\n//   error: string // Error message if operation failed\n// }\n\n\n// Get Spreadsheet Info example\nconst googleSheets_get_spreadsheet_info = new GoogleSheetsBubble({\n  operation: \"get_spreadsheet_info\", // Get spreadsheet metadata and properties\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  include_grid_data: false // default, // Include grid data in response\n});\n\nconst result = await googleSheets_get_spreadsheet_info.action();\n// outputSchema for result.data when operation === 'get_spreadsheet_info':\n// {\n//   operation: \"get_spreadsheet_info\" // Get spreadsheet metadata and properties,\n//   success: boolean // Whether the operation was successful,\n//   spreadsheet: { spreadsheetId: string // Unique spreadsheet identifier, properties: { title: string // Spreadsheet title, locale: string | undefined // Spreadsheet locale, autoRecalc: string | undefined // Auto recalc setting, timeZone: string | undefined // Time zone } | undefined // Spreadsheet properties, sheets: { properties: { sheetId: number // Sheet ID, title: string // Sheet title, index: number // Sheet index, sheetType: string | undefined // Sheet type, gridProperties: { rowCount: number | undefined // Number of rows in the sheet, columnCount: number | undefined // Number of columns in the sheet } | undefined // Grid properties of the sheet } // Sheet properties }[] | undefined // List of sheets in the spreadsheet, spreadsheetUrl: string | undefined // URL to the spreadsheet } | undefined // Spreadsheet information,\n//   error: string // Error message if operation failed\n// }\n\n\n// Create Spreadsheet example\nconst googleSheets_create_spreadsheet = new GoogleSheetsBubble({\n  operation: \"create_spreadsheet\", // Create a new spreadsheet\n  title: \"example string\", // Title for the new spreadsheet\n  sheet_titles: [\"Sheet1\"] // default, // Tab names for the initial tabs (these are the tabs at the bottom of a spreadsheet, not the spreadsheet name)\n});\n\nconst result = await googleSheets_create_spreadsheet.action();\n// outputSchema for result.data when operation === 'create_spreadsheet':\n// {\n//   operation: \"create_spreadsheet\" // Create a new spreadsheet,\n//   success: boolean // Whether the operation was successful,\n//   spreadsheet: { spreadsheetId: string // Unique spreadsheet identifier, properties: { title: string // Spreadsheet title, locale: string | undefined // Spreadsheet locale, autoRecalc: string | undefined // Auto recalc setting, timeZone: string | undefined // Time zone } | undefined // Spreadsheet properties, sheets: { properties: { sheetId: number // Sheet ID, title: string // Sheet title, index: number // Sheet index, sheetType: string | undefined // Sheet type, gridProperties: { rowCount: number | undefined // Number of rows in the sheet, columnCount: number | undefined // Number of columns in the sheet } | undefined // Grid properties of the sheet } // Sheet properties }[] | undefined // List of sheets in the spreadsheet, spreadsheetUrl: string | undefined // URL to the spreadsheet } | undefined // Created spreadsheet information,\n//   error: string // Error message if operation failed\n// }\n\n\n// Add Sheet example\nconst googleSheets_add_sheet = new GoogleSheetsBubble({\n  operation: \"add_sheet\", // Add a new tab to spreadsheet\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  sheet_title: \"example string\", // Tab name for the new tab (this is the tab at the bottom of a spreadsheet, not the spreadsheet name)\n  row_count: 1000 // default, // Number of rows in the new sheet\n  column_count: 26 // default, // Number of columns in the new sheet\n});\n\nconst result = await googleSheets_add_sheet.action();\n// outputSchema for result.data when operation === 'add_sheet':\n// {\n//   operation: \"add_sheet\" // Add a new tab to spreadsheet,\n//   success: boolean // Whether the operation was successful,\n//   sheet_id: number | undefined // ID of the added sheet,\n//   sheet_title: string | undefined // Tab name of the added tab,\n//   error: string // Error message if operation failed\n// }\n\n\n// Delete Sheet example\nconst googleSheets_delete_sheet = new GoogleSheetsBubble({\n  operation: \"delete_sheet\", // Delete a tab from spreadsheet\n  spreadsheet_id: \"example string\", // Google Sheets spreadsheet ID\n  sheet_id: 42, // ID of the sheet to delete\n});\n\nconst result = await googleSheets_delete_sheet.action();\n// outputSchema for result.data when operation === 'delete_sheet':\n// {\n//   operation: \"delete_sheet\" // Delete a tab from spreadsheet,\n//   success: boolean // Whether the operation was successful,\n//   deleted_sheet_id: number | undefined // ID of the deleted sheet,\n//   error: string // Error message if operation failed\n// }\n\n\n// Always check success status before using data\nif (!result.success) {\n  throw new Error(`google-sheets failed: ${result.error}`);\n}\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
       "requiredCredentials": [
         "GOOGLE_SHEETS_CRED"
       ]
@@ -34657,7 +34657,7 @@
       "type": "tool",
       "shortDescription": "Scrapes content from a single web page. Useful after web-search-tool to get the full content of a page. Also useful if you need to understand a site's structure or content.",
       "useCase": "General purpose bubble for various workflow needs",
-      "inputSchema": "{\n  url: string // The URL to scrape content from,\n  format: \"markdown\" | \"html\" // Content format to extract (default: markdown),\n  onlyMainContent: boolean // Extract only main content, filtering out navigation/footers,\n  credentials: Record<string, string> | undefined // Required credentials including FIRECRAWL_API_KEY\n}",
+      "inputSchema": "{\n  url: string // The URL to scrape content from,\n  format: \"markdown\" | \"html\" // Content format to extract (default: markdown), only use html if looking for particular html elements,\n  onlyMainContent: boolean // Extract only main content, filtering out navigation/footers,\n  credentials: Record<string, string> | undefined // Required credentials including FIRECRAWL_API_KEY\n}",
       "outputSchema": "{\n  content: string // Scraped content in requested format,\n  title: string // Page title if available,\n  url: string // The original URL that was scraped,\n  format: string // Format of the returned content,\n  success: boolean // Whether the scraping was successful,\n  error: string // Error message if scraping failed,\n  creditsUsed: number // Number of credits used,\n  metadata: { statusCode: number | undefined, loadTime: number | undefined } | undefined // Additional metadata about the scrape\n}",
       "inputJsonSchema": {
         "type": "object",
@@ -34674,7 +34674,7 @@
               "html"
             ],
             "default": "markdown",
-            "description": "Content format to extract (default: markdown)"
+            "description": "Content format to extract (default: markdown), only use html if looking for particular html elements"
           },
           "onlyMainContent": {
             "type": "boolean",
@@ -34751,7 +34751,7 @@
         ],
         "additionalProperties": false
       },
-      "usageExample": "// Example usage of web-scrape-tool bubble\nconst webScrapeTool = new WebScrapeTool({\n  url: \"example string\", // The URL to scrape content from,\n  format: \"markdown\" // options: \"markdown\", \"html\", // Content format to extract (default: markdown),\n  onlyMainContent: true // default, // Extract only main content, filtering out navigation/footers,\n});\n\nconst result = await webScrapeTool.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//   content: string // Scraped content in requested format,\n//   title: string // Page title if available,\n//   url: string // The original URL that was scraped,\n//   format: string // Format of the returned content,\n//   success: boolean // Whether the scraping was successful,\n//   error: string // Error message if scraping failed,\n//   creditsUsed: number // Number of credits used,\n//   metadata: { statusCode: number | undefined, loadTime: number | undefined } | undefined // Additional metadata about the scrape\n// }\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
+      "usageExample": "// Example usage of web-scrape-tool bubble\nconst webScrapeTool = new WebScrapeTool({\n  url: \"example string\", // The URL to scrape content from,\n  format: \"markdown\" // options: \"markdown\", \"html\", // Content format to extract (default: markdown), only use html if looking for particular html elements,\n  onlyMainContent: true // default, // Extract only main content, filtering out navigation/footers,\n});\n\nconst result = await webScrapeTool.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//   content: string // Scraped content in requested format,\n//   title: string // Page title if available,\n//   url: string // The original URL that was scraped,\n//   format: string // Format of the returned content,\n//   success: boolean // Whether the scraping was successful,\n//   error: string // Error message if scraping failed,\n//   creditsUsed: number // Number of credits used,\n//   metadata: { statusCode: number | undefined, loadTime: number | undefined } | undefined // Additional metadata about the scrape\n// }\n\n// Access the actual data\nconst actualData = result.data;\nconsole.log(actualData);",
       "requiredCredentials": [
         "FIRECRAWL_API_KEY"
       ]

package/package.json

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