@agnocon/piece-browse-ai 0.1.7

package/dist/lib/triggers/task-finished-successfully.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskFinishedSuccessfullyTrigger = void 0;
+const tslib_1 = require("tslib");
+// Vendored from Activepieces packages/pieces/community/browse-ai/src/lib/triggers/task-finished-successfully.ts (MIT).
+// Generated by packages/scripts/vendor-ap.mjs - do not edit by hand.
+const pieces_common_1 = require("@agnocon/pieces-common");
+const pieces_framework_1 = require("@agnocon/pieces-framework");
+const pieces_framework_2 = require("@agnocon/pieces-framework");
+const auth_1 = require("../common/auth");
+const client_1 = require("../common/client");
+const props_1 = require("../common/props");
+const TRIGGER_KEY = 'browse-ai-task_finished_successfully';
+exports.taskFinishedSuccessfullyTrigger = (0, pieces_framework_1.createTrigger)({
+    auth: auth_1.browseAiAuth,
+    name: 'task_finished_successfully',
+    displayName: 'Task Finished Successfully',
+    description: 'Triggers when a robot finishes a task successfully.',
+    aiMetadata: {
+        description: 'Fires when a task run for the selected Browse AI robot completes successfully, delivering the finished task record with its captured/extracted data. Use to process scrape results as soon as they are ready.',
+    },
+    type: pieces_framework_1.TriggerStrategy.WEBHOOK,
+    props: {
+        robotId: props_1.robotIdDropdown,
+    },
+    onEnable(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
+            const { robotId } = context.propsValue;
+            const apiKey = context.auth.secret_text;
+            try {
+                // Verify robot exists and we have access
+                yield (0, client_1.browseAiApiCall)({
+                    method: pieces_common_1.HttpMethod.GET,
+                    auth: { apiKey },
+                    resourceUri: `/robots/${robotId}`,
+                });
+                const response = yield (0, client_1.browseAiApiCall)({
+                    method: pieces_common_1.HttpMethod.POST,
+                    auth: { apiKey },
+                    resourceUri: `/robots/${robotId}/webhooks`,
+                    body: {
+                        hookUrl: context.webhookUrl,
+                        eventType: 'taskFinishedSuccessfully',
+                    },
+                });
+                yield context.store.put(TRIGGER_KEY, response.webhook.id);
+            }
+            catch (error) {
+                if (((_a = error.response) === null || _a === void 0 ? void 0 : _a.status) === 404) {
+                    throw new Error(`Robot not found: The robot with ID "${robotId}" does not exist or you do not have access to it. Please verify the robot ID and your permissions.`);
+                }
+                if (((_b = error.response) === null || _b === void 0 ? void 0 : _b.status) === 403) {
+                    throw new Error('Access denied: You do not have permission to set up webhooks for this robot. Please check your Browse AI account permissions and ensure you have webhook access.');
+                }
+                if (((_c = error.response) === null || _c === void 0 ? void 0 : _c.status) === 400) {
+                    throw new Error(`Invalid webhook configuration: ${((_e = (_d = error.response) === null || _d === void 0 ? void 0 : _d.data) === null || _e === void 0 ? void 0 : _e.message) || error.message}. Please check your webhook URL and robot ID.`);
+                }
+                if (((_f = error.response) === null || _f === void 0 ? void 0 : _f.status) === 429) {
+                    throw new Error('Rate limit exceeded: Too many webhook requests. Please wait a moment and try again.');
+                }
+                throw new Error(`Failed to set up webhook: ${error.message || 'Unknown error occurred'}. Please check your robot ID and try again.`);
+            }
+        });
+    },
+    onDisable(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { robotId } = context.propsValue;
+            const webhookId = yield context.store.get(TRIGGER_KEY);
+            const apiKey = context.auth.secret_text;
+            if (!(0, pieces_framework_2.isNil)(webhookId)) {
+                try {
+                    yield (0, client_1.browseAiApiCall)({
+                        method: pieces_common_1.HttpMethod.DELETE,
+                        auth: { apiKey },
+                        resourceUri: `/robots/${robotId}/webhooks/${webhookId}`,
+                    });
+                }
+                catch (error) {
+                    console.warn(`Warning: Failed to clean up webhook ${webhookId}:`, error.message);
+                    // Clean up the stored webhook ID even if deletion failed
+                    yield context.store.delete(TRIGGER_KEY);
+                }
+            }
+        });
+    },
+    run(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const payload = context.payload.body;
+            if (payload.event !== 'task.finishedSuccessfully')
+                return [];
+            return [payload.task];
+        });
+    },
+    test(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { robotId } = context.propsValue;
+            const apiKey = context.auth.secret_text;
+            const response = yield (0, client_1.browseAiApiCall)({
+                method: pieces_common_1.HttpMethod.GET,
+                auth: { apiKey },
+                resourceUri: `/robots/${robotId}/tasks`,
+                query: { status: 'successful', sort: '-createdAt' },
+            });
+            return response.result.robotTasks.items;
+        });
+    },
+    sampleData: {},
+});
+//# sourceMappingURL=task-finished-successfully.js.map

package/dist/lib/triggers/task-finished-successfully.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-finished-successfully.js","sourceRoot":"","sources":["../../../src/lib/triggers/task-finished-successfully.ts"],"names":[],"mappings":"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"}

package/dist/lib/triggers/task-finished-with-error.d.ts

@@ -0,0 +1,11 @@
+import { TriggerStrategy } from '@agnocon/pieces-framework';
+export declare const taskFinishedWithErrorTrigger: import("@agnocon/pieces-framework").ITrigger<TriggerStrategy.WEBHOOK, import("@agnocon/pieces-framework").SecretTextProperty<true>, {
+    robotId: import("@agnocon/pieces-framework").DropdownProperty<string, true, import("@agnocon/pieces-framework").SecretTextProperty<true>>;
+}> | import("@agnocon/pieces-framework").ITrigger<TriggerStrategy.POLLING, import("@agnocon/pieces-framework").SecretTextProperty<true>, {
+    robotId: import("@agnocon/pieces-framework").DropdownProperty<string, true, import("@agnocon/pieces-framework").SecretTextProperty<true>>;
+}> | import("@agnocon/pieces-framework").ITrigger<TriggerStrategy.MANUAL, import("@agnocon/pieces-framework").SecretTextProperty<true>, {
+    robotId: import("@agnocon/pieces-framework").DropdownProperty<string, true, import("@agnocon/pieces-framework").SecretTextProperty<true>>;
+}> | import("@agnocon/pieces-framework").ITrigger<TriggerStrategy.APP_WEBHOOK, import("@agnocon/pieces-framework").SecretTextProperty<true>, {
+    robotId: import("@agnocon/pieces-framework").DropdownProperty<string, true, import("@agnocon/pieces-framework").SecretTextProperty<true>>;
+}>;
+//# sourceMappingURL=task-finished-with-error.d.ts.map

package/dist/lib/triggers/task-finished-with-error.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-finished-with-error.d.ts","sourceRoot":"","sources":["../../../src/lib/triggers/task-finished-with-error.ts"],"names":[],"mappings":"AAGA,OAAO,EAAiB,eAAe,EAAE,MAAM,2BAA2B,CAAC;AAQ3E,eAAO,MAAM,4BAA4B;;;;;;;;EAgIvC,CAAC"}

package/dist/lib/triggers/task-finished-with-error.js

@@ -0,0 +1,110 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.taskFinishedWithErrorTrigger = void 0;
+const tslib_1 = require("tslib");
+// Vendored from Activepieces packages/pieces/community/browse-ai/src/lib/triggers/task-finished-with-error.ts (MIT).
+// Generated by packages/scripts/vendor-ap.mjs - do not edit by hand.
+const pieces_common_1 = require("@agnocon/pieces-common");
+const pieces_framework_1 = require("@agnocon/pieces-framework");
+const pieces_framework_2 = require("@agnocon/pieces-framework");
+const auth_1 = require("../common/auth");
+const client_1 = require("../common/client");
+const props_1 = require("../common/props");
+const TRIGGER_KEY = 'browse-ai-task_finished_with_error';
+exports.taskFinishedWithErrorTrigger = (0, pieces_framework_1.createTrigger)({
+    auth: auth_1.browseAiAuth,
+    name: 'task_finished_with_error',
+    displayName: 'Task Finished with Error',
+    description: 'Triggers when a robot task run fails with an error.',
+    aiMetadata: {
+        description: 'Fires when a task run for the selected Browse AI robot finishes in a failed/error state, delivering the failed task record. Use to detect and react to scrapes that did not complete successfully.',
+    },
+    type: pieces_framework_1.TriggerStrategy.WEBHOOK,
+    props: {
+        robotId: props_1.robotIdDropdown,
+    },
+    onEnable(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            var _a, _b, _c, _d, _e, _f;
+            const { robotId } = context.propsValue;
+            const apiKey = context.auth.secret_text;
+            try {
+                // Verify robot exists and we have access
+                yield (0, client_1.browseAiApiCall)({
+                    method: pieces_common_1.HttpMethod.GET,
+                    auth: { apiKey },
+                    resourceUri: `/robots/${robotId}`,
+                });
+                const response = yield (0, client_1.browseAiApiCall)({
+                    method: pieces_common_1.HttpMethod.POST,
+                    auth: { apiKey },
+                    resourceUri: `/robots/${robotId}/webhooks`,
+                    body: {
+                        hookUrl: context.webhookUrl,
+                        eventType: 'taskFinishedWithError',
+                    },
+                });
+                yield context.store.put(TRIGGER_KEY, response.webhook.id);
+            }
+            catch (error) {
+                if (((_a = error.response) === null || _a === void 0 ? void 0 : _a.status) === 404) {
+                    throw new Error(`Robot not found: The robot with ID "${robotId}" does not exist or you do not have access to it. Please verify the robot ID and your permissions.`);
+                }
+                if (((_b = error.response) === null || _b === void 0 ? void 0 : _b.status) === 403) {
+                    throw new Error('Access denied: You do not have permission to set up webhooks for this robot. Please check your Browse AI account permissions and ensure you have webhook access.');
+                }
+                if (((_c = error.response) === null || _c === void 0 ? void 0 : _c.status) === 400) {
+                    throw new Error(`Invalid webhook configuration: ${((_e = (_d = error.response) === null || _d === void 0 ? void 0 : _d.data) === null || _e === void 0 ? void 0 : _e.message) || error.message}. Please check your webhook URL and robot ID.`);
+                }
+                if (((_f = error.response) === null || _f === void 0 ? void 0 : _f.status) === 429) {
+                    throw new Error('Rate limit exceeded: Too many webhook requests. Please wait a moment and try again.');
+                }
+                throw new Error(`Failed to set up webhook: ${error.message || 'Unknown error occurred'}. Please check your robot ID and try again.`);
+            }
+        });
+    },
+    onDisable(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { robotId } = context.propsValue;
+            const webhookId = yield context.store.get(TRIGGER_KEY);
+            const apiKey = context.auth.secret_text;
+            if (!(0, pieces_framework_2.isNil)(webhookId)) {
+                try {
+                    yield (0, client_1.browseAiApiCall)({
+                        method: pieces_common_1.HttpMethod.DELETE,
+                        auth: { apiKey },
+                        resourceUri: `/robots/${robotId}/webhooks/${webhookId}`,
+                    });
+                }
+                catch (error) {
+                    console.warn(`Warning: Failed to clean up webhook ${webhookId}:`, error.message);
+                    // Clean up the stored webhook ID even if deletion failed
+                    yield context.store.delete(TRIGGER_KEY);
+                }
+            }
+        });
+    },
+    run(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const payload = context.payload.body;
+            if (payload.event !== 'task.finishedWithError')
+                return [];
+            return [payload.task];
+        });
+    },
+    test(context) {
+        return tslib_1.__awaiter(this, void 0, void 0, function* () {
+            const { robotId } = context.propsValue;
+            const apiKey = context.auth.secret_text;
+            const response = yield (0, client_1.browseAiApiCall)({
+                method: pieces_common_1.HttpMethod.GET,
+                auth: { apiKey },
+                resourceUri: `/robots/${robotId}/tasks`,
+                query: { status: 'failed', sort: '-createdAt' },
+            });
+            return response.result.robotTasks.items;
+        });
+    },
+    sampleData: {},
+});
+//# sourceMappingURL=task-finished-with-error.js.map

package/dist/lib/triggers/task-finished-with-error.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"task-finished-with-error.js","sourceRoot":"","sources":["../../../src/lib/triggers/task-finished-with-error.ts"],"names":[],"mappings":"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"}

package/package.json

@@ -0,0 +1,46 @@
+{
+  "name": "@agnocon/piece-browse-ai",
+  "version": "0.1.7",
+  "description": "AgnoCon browse ai connector",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "default": "./dist/index.js"
+    }
+  },
+  "files": [
+    "dist",
+    "src",
+    "LICENSE.MIT-AP"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "vendor": "node ../scripts/vendor-ap.mjs piece-browse-ai"
+  },
+  "dependencies": {
+    "@agnocon/core-utils": "0.2.0",
+    "@agnocon/piece-types": "0.3.1",
+    "@agnocon/pieces-common": "0.12.8",
+    "@agnocon/pieces-framework": "0.36.0",
+    "tslib": "2.6.2"
+  },
+  "devDependencies": {
+    "@types/node": "20.17.6",
+    "typescript": "5.5.4"
+  },
+  "license": "MIT",
+  "agnocon": {
+    "originVersion": "0.1.7"
+  },
+  "publishConfig": {
+    "access": "restricted",
+    "tag": "latest"
+  },
+  "keywords": [
+    "agnocon",
+    "connector"
+  ]
+}

package/src/index.ts

@@ -0,0 +1,34 @@
+import { createCustomApiCallAction } from '@agnocon/pieces-common';
+import { createPiece } from '@agnocon/pieces-framework';
+import { browseAiAuth } from './lib/common/auth';
+import { getTaskDetailsAction } from './lib/actions/get-task-details';
+import { listRobotsAction } from './lib/actions/list-robots';
+import { runRobotAction } from './lib/actions/run-robot';
+import { taskFinishedWithErrorTrigger } from './lib/triggers/task-finished-with-error';
+import { taskFinishedSuccessfullyTrigger } from './lib/triggers/task-finished-successfully';
+import { PieceCategory } from '@agnocon/pieces-framework';
+
+export const browseAi = createPiece({
+  displayName: 'Browse AI',
+  auth: browseAiAuth,
+  minimumSupportedRelease: '0.36.1',
+  logoUrl: 'https://cdn.activepieces.com/pieces/browse-ai.png',
+  categories:[PieceCategory.PRODUCTIVITY],
+  authors: ['aryel780'],
+  actions: [
+    getTaskDetailsAction,
+    listRobotsAction,
+    runRobotAction,
+    createCustomApiCallAction({
+      auth: browseAiAuth,
+      baseUrl: () => 'https://api.browse.ai/v2',
+      authMapping: async (auth) => ({
+        Authorization: `Bearer ${auth.secret_text}`,
+      }),
+    }),
+  ],
+  triggers: [
+    taskFinishedWithErrorTrigger,
+    taskFinishedSuccessfullyTrigger,
+  ],
+});

package/src/lib/actions/get-task-details.ts

@@ -0,0 +1,52 @@
+import { createAction } from '@agnocon/pieces-framework';
+import { HttpMethod } from '@agnocon/pieces-common';
+import { browseAiApiCall } from '../common/client';
+import { browseAiAuth } from '../common/auth';
+import { robotIdDropdown, taskIdDropdown } from '../common/props';
+
+export const getTaskDetailsAction = createAction({
+  name: 'get-task-details',
+  auth: browseAiAuth,
+  displayName: 'Get Task Details',
+  description:
+    'Retrieves the details of a specific task executed by a Browse AI robot.',
+  audience: 'both',
+  aiMetadata: {
+    description:
+      'Fetches the full record of one previously-run Browse AI scraping task by robot ID and task ID, including its status and any captured/extracted data. Use to check the outcome or pull results of a known task. Requires both the robot ID and the task ID; read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {
+    robotId: robotIdDropdown,
+    taskId: taskIdDropdown,
+  },
+  async run(context) {
+    const { robotId, taskId } = context.propsValue;
+
+    try {
+      const response = await browseAiApiCall({
+        auth: { apiKey: context.auth.secret_text },
+        method: HttpMethod.GET,
+        resourceUri: `/robots/${robotId}/tasks/${taskId}`,
+      });
+
+      return response;
+    } catch (error: any) {
+      if (error.response?.status === 404) {
+        throw new Error(
+          'Task not found. Please verify the Robot ID and Task ID.'
+        );
+      }
+
+      if (error.response?.status === 401) {
+        throw new Error('Authentication failed. Please check your API key.');
+      }
+
+      throw new Error(
+        `Failed to fetch task details: ${
+          error.message || 'Unknown error occurred'
+        }`
+      );
+    }
+  },
+});

package/src/lib/actions/list-robots.ts

@@ -0,0 +1,41 @@
+import { createAction } from '@agnocon/pieces-framework';
+import { HttpMethod } from '@agnocon/pieces-common';
+import { browseAiApiCall } from '../common/client';
+import { browseAiAuth } from '../common/auth';
+
+export const listRobotsAction = createAction({
+  name: 'list-robots',
+  auth: browseAiAuth,
+  displayName: 'List Robots',
+  description: 'Retrieves all robots available in your account.',
+  audience: 'both',
+  aiMetadata: {
+    description:
+      'Lists all Browse AI robots in the connected account, returning each robot and its ID. Use to discover the available robots or resolve a robot name to the ID needed by other Browse AI actions. Takes no input; read-only and idempotent.',
+    idempotent: true,
+  },
+  props: {},
+  async run(context) {
+    try {
+      const response = await browseAiApiCall({
+        auth: { apiKey: context.auth.secret_text },
+        method: HttpMethod.GET,
+        resourceUri: '/robots',
+      });
+
+      return response;
+    } catch (error: any) {
+      if (error.response?.status === 401) {
+        throw new Error('Authentication failed. Please check your API key.');
+      }
+
+      if (error.response?.status === 429) {
+        throw new Error('Rate limit exceeded. Please wait before retrying.');
+      }
+
+      throw new Error(
+        `Failed to fetch robots: ${error.message || 'Unknown error occurred'}`
+      );
+    }
+  },
+});

package/src/lib/actions/run-robot.ts

@@ -0,0 +1,65 @@
+import { HttpMethod } from '@agnocon/pieces-common';
+import { createAction, Property } from '@agnocon/pieces-framework';
+import { browseAiApiCall } from '../common/client';
+import { browseAiAuth } from '../common/auth';
+import { robotIdDropdown, robotParameters } from '../common/props';
+
+export const runRobotAction = createAction({
+  name: 'run-robot',
+  auth: browseAiAuth,
+  displayName: 'Run a Robot',
+  description:
+    'Runs a robot on-demand with custom input parameters.',
+  audience: 'both',
+  aiMetadata: {
+    description:
+      'Starts a new on-demand run of a Browse AI robot, creating a fresh scraping task with the robot-specific input parameters (the required inputs vary per robot and are pulled from its definition). Use to trigger a scrape/extraction; results arrive asynchronously, so poll Get Task Details or use a task-finished trigger for the outcome. Not idempotent: each call queues another task run.',
+    idempotent: false,
+  },
+  props: {
+    robotId: robotIdDropdown,
+    recordVideo: Property.Checkbox({
+      displayName: 'Record Video',
+      description:
+        'Try to record a video while running the task.',
+      required: false,
+      defaultValue: false,
+    }),
+    robotParams: robotParameters,
+  },
+  async run(context) {
+    const { robotId, recordVideo } = context.propsValue;
+
+    const inputParameters = context.propsValue.robotParams ?? {};
+
+    try {
+      const response = await browseAiApiCall({
+        method: HttpMethod.POST,
+        resourceUri: `/robots/${robotId}/tasks`,
+        auth: { apiKey: context.auth.secret_text },
+        body: {
+          recordVideo: recordVideo || false,
+          inputParameters,
+        },
+      });
+
+      return response;
+    } catch (error: any) {
+      if (error.response?.status === 401) {
+        throw new Error('Authentication failed. Please check your API key.');
+      }
+
+      if (error.response?.status === 404) {
+        throw new Error('Robot not found. Please verify the robot ID.');
+      }
+
+      if (error.response?.status === 429) {
+        throw new Error('Rate limit exceeded. Please wait before retrying.');
+      }
+
+      throw new Error(
+        `Failed to run robot: ${error.message || 'Unknown error occurred'}`
+      );
+    }
+  },
+});

package/src/lib/common/auth.ts

@@ -0,0 +1,24 @@
+import { PieceAuth } from '@agnocon/pieces-framework';
+import { HttpMethod } from '@agnocon/pieces-common';
+import { browseAiApiCall } from './client';
+
+export const browseAiAuth = PieceAuth.SecretText({
+  displayName: 'API Key',
+  description: 'You can find your Browse AI API key on the dashboard under Settings → API Key.',
+  required: true,
+  validate: async ({ auth }) => {
+    try {
+      await browseAiApiCall({
+        method: HttpMethod.GET,
+        resourceUri: '/status',
+        auth: { apiKey: auth },
+      });
+      return { valid: true };
+    } catch {
+      return {
+        valid: false,
+        error: 'Invalid API Key. Please check your Browse AI credentials.',
+      };
+    }
+  },
+});

package/src/lib/common/client.ts

@@ -0,0 +1,85 @@
+import {
+  httpClient,
+  HttpMethod,
+  HttpRequest,
+  HttpMessageBody,
+  QueryParams,
+} from '@agnocon/pieces-common';
+
+export type BrowseAiAuthProps = {
+  apiKey: string;
+};
+
+export type BrowseAiApiCallParams = {
+  method: HttpMethod;
+  resourceUri: string;
+  query?: Record<string, string | number | string[] | undefined>;
+  body?: unknown;
+  auth: BrowseAiAuthProps;
+};
+
+export async function browseAiApiCall<T extends HttpMessageBody>({
+  method,
+  resourceUri,
+  query,
+  body,
+  auth,
+}: BrowseAiApiCallParams): Promise<T> {
+  const { apiKey } = auth;
+
+  if (!apiKey) {
+    throw new Error('Browse AI API key is required for authentication');
+  }
+
+  const queryParams: QueryParams = {};
+
+  if (query) {
+    for (const [key, value] of Object.entries(query)) {
+      if (value !== null && value !== undefined) {
+        queryParams[key] = String(value);
+      }
+    }
+  }
+
+  const baseUrl = `https://api.browse.ai/v2`;
+
+  const request: HttpRequest = {
+    method,
+    url: `${baseUrl}${resourceUri}`,
+    headers: {
+      Authorization: `Bearer ${apiKey}`,
+      'Content-Type': 'application/json',
+    },
+    queryParams,
+    body,
+  };
+
+  try {
+    const response = await httpClient.sendRequest<T>(request);
+    return response.body;
+  } catch (error: any) {
+    const statusCode = error.response?.status;
+    const errorData = error.response?.data;
+
+    switch (statusCode) {
+      case 400:
+        throw new Error(`Bad Request: ${errorData?.message || 'Invalid parameters'}`);
+      case 401:
+        throw new Error('Unauthorized: Invalid API key. Please check your credentials.');
+      case 403:
+        throw new Error('Forbidden: You do not have permission to access this resource.');
+      case 404:
+        throw new Error('Not Found: The requested resource does not exist.');
+      case 429:
+        throw new Error('Rate Limit Exceeded: Please slow down your requests.');
+      case 500:
+        throw new Error('Internal Server Error: Something went wrong on Browse AI’s side.');
+      default:
+        {
+        const message = errorData?.message || error.message || 'Unknown error';
+        throw new Error(`Browse AI API Error (${statusCode || 'Unknown'}): ${message}`);
+        }
+
+    }
+  }
+}