@hasna/connectors 0.0.6 → 0.2.0

package/connectors/connect-browseruse/CLAUDE.md

@@ -1,172 +0,0 @@
-# CLAUDE.md
-
-This file provides guidance to Claude Code when working with this repository.
-
-## Project Overview
-
-connect-browseruse is a TypeScript connector for Browser Use Cloud API (browser-use.com) with multi-profile configuration support. It provides CLI and programmatic access to AI-powered browser automation tasks, sessions, and skills.
-
-## Build & Run Commands
-
-```bash
-# Install dependencies
-bun install
-
-# Run CLI in development
-bun run dev
-
-# Build for distribution
-bun run build
-
-# Type check
-bun run typecheck
-```
-
-## Code Style
-
-- TypeScript with strict mode
-- ESM modules (`type: module`)
-- Async/await for all async operations
-- Minimal dependencies: commander, chalk
-- Type annotations required everywhere
-
-## Project Structure
-
-```
-src/
-├── api/           # API client modules
-│   ├── client.ts  # HTTP client with authentication
-│   └── index.ts   # Main connector class
-├── cli/
-│   └── index.ts   # CLI commands
-├── types/
-│   └── index.ts   # TypeScript types
-├── utils/
-│   ├── config.ts  # Multi-profile configuration
-│   └── output.ts  # CLI output formatting
-└── index.ts       # Library exports
-```
-
-## Authentication
-
-Bearer Token authentication. Credentials can be set via:
-- Environment variable (see below)
-- Profile configuration: `connect-browseruse config set-key <key>`
-
-
-## Key Patterns
-
-### Multi-Profile Configuration
-
-Profiles stored in `~/.connect/connect-browseruse/profiles/`:
-- Each profile is a separate JSON file
-- `current_profile` file tracks active profile
-- `--profile` flag overrides for single command
-- Environment variables override profile config
-
-### Authentication
-
-Uses Bearer token authentication for all requests. API key can be set via:
-- Environment variable: `BROWSER_USE_API_KEY`
-- Profile configuration: `connect-browseruse config set api-key <key>`
-
-### Service APIs
-
-Each API endpoint has its own module:
-- **TasksApi**: Create, list, get, stop, pause, resume tasks
-- **SessionsApi**: Manage agent sessions with public sharing
-- **ProfilesApi**: Browser profiles for persistent state
-- **BrowsersApi**: Direct CDP browser sessions
-- **SkillsApi**: User-created skills
-- **MarketplaceApi**: Browse and discover marketplace skills
-- **FilesApi**: Upload/download files via presigned URLs
-- **BillingApi**: Account credits and plan info
-
-## CLI Commands
-
-### Tasks
-```bash
-connect-browseruse tasks list                    # List all tasks
-connect-browseruse tasks create "Search for AI"  # Create new task
-connect-browseruse tasks get <id>                # Get task details
-connect-browseruse tasks stop <id>               # Stop running task
-connect-browseruse tasks pause <id>              # Pause task
-connect-browseruse tasks resume <id>             # Resume paused task
-connect-browseruse tasks logs <id>               # View task logs
-```
-
-### Sessions
-```bash
-connect-browseruse sessions list                 # List sessions
-connect-browseruse sessions get <id>             # Get session details
-connect-browseruse sessions create               # Create new session
-connect-browseruse sessions delete <id>          # Delete session
-connect-browseruse sessions share <id>           # Create public share
-connect-browseruse sessions unshare <id>         # Remove public share
-```
-
-### Browser Profiles
-```bash
-connect-browseruse profiles list                 # List browser profiles
-connect-browseruse profiles get <id>             # Get profile details
-connect-browseruse profiles create --name "My Profile" # Create profile
-connect-browseruse profiles delete <id>          # Delete profile
-```
-
-### Skills & Marketplace
-```bash
-connect-browseruse skills list                   # List user skills
-connect-browseruse skills get <id>               # Get skill details
-connect-browseruse skills create --name "Login" --parameter "url:string" # Create skill
-connect-browseruse skills delete <id>            # Delete skill
-connect-browseruse skills run <id> -p '{"url":"example.com"}' # Run skill
-
-connect-browseruse marketplace list              # List marketplace skills
-connect-browseruse marketplace get <id>          # Get marketplace skill
-```
-
-### Billing
-```bash
-connect-browseruse billing show                  # Show billing info
-connect-browseruse billing credits               # Show credit balance
-connect-browseruse billing plan                  # Show current plan
-```
-
-### Quick Run
-```bash
-connect-browseruse run "Navigate to google.com"  # Quick task execution
-connect-browseruse run "Search for news" --timeout 120000
-```
-
-### Profile & Config
-```bash
-connect-browseruse profile list                  # List profiles
-connect-browseruse profile use <name>            # Switch profile
-connect-browseruse profile create <name>         # Create profile
-connect-browseruse profile delete <name>         # Delete profile
-connect-browseruse config set api-key <key>      # Set API key
-connect-browseruse config set base-url <url>     # Set base URL
-connect-browseruse config show                   # Show current config
-```
-
-## Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `BROWSER_USE_API_KEY` | Browser Use API key (overrides profile) |
-| `BROWSER_USE_BASE_URL` | Base URL (default: https://api.browser-use.com) |
-
-## Data Storage
-
-```
-~/.connect/connect-browseruse/
-├── current_profile   # Active profile name
-└── profiles/
-    ├── default.json  # Default profile
-    └── {name}.json   # Named profiles
-```
-
-## Dependencies
-
-- commander: CLI framework
-- chalk: Terminal styling

package/connectors/connect-browseruse/GEMINI.md

@@ -1,172 +0,0 @@
-# GEMINI.md
-
-This file provides guidance to Gemini when working with this repository.
-
-## Project Overview
-
-connect-browseruse is a TypeScript connector for Browser Use Cloud API (browser-use.com) with multi-profile configuration support. It provides CLI and programmatic access to AI-powered browser automation tasks, sessions, and skills.
-
-## Build & Run Commands
-
-```bash
-# Install dependencies
-bun install
-
-# Run CLI in development
-bun run dev
-
-# Build for distribution
-bun run build
-
-# Type check
-bun run typecheck
-```
-
-## Code Style
-
-- TypeScript with strict mode
-- ESM modules (`type: module`)
-- Async/await for all async operations
-- Minimal dependencies: commander, chalk
-- Type annotations required everywhere
-
-## Project Structure
-
-```
-src/
-├── api/           # API client modules
-│   ├── client.ts  # HTTP client with authentication
-│   └── index.ts   # Main connector class
-├── cli/
-│   └── index.ts   # CLI commands
-├── types/
-│   └── index.ts   # TypeScript types
-├── utils/
-│   ├── config.ts  # Multi-profile configuration
-│   └── output.ts  # CLI output formatting
-└── index.ts       # Library exports
-```
-
-## Authentication
-
-Bearer Token authentication. Credentials can be set via:
-- Environment variable (see below)
-- Profile configuration: `connect-browseruse config set-key <key>`
-
-
-## Key Patterns
-
-### Multi-Profile Configuration
-
-Profiles stored in `~/.connect/connect-browseruse/profiles/`:
-- Each profile is a separate JSON file
-- `current_profile` file tracks active profile
-- `--profile` flag overrides for single command
-- Environment variables override profile config
-
-### Authentication
-
-Uses Bearer token authentication for all requests. API key can be set via:
-- Environment variable: `BROWSER_USE_API_KEY`
-- Profile configuration: `connect-browseruse config set api-key <key>`
-
-### Service APIs
-
-Each API endpoint has its own module:
-- **TasksApi**: Create, list, get, stop, pause, resume tasks
-- **SessionsApi**: Manage agent sessions with public sharing
-- **ProfilesApi**: Browser profiles for persistent state
-- **BrowsersApi**: Direct CDP browser sessions
-- **SkillsApi**: User-created skills
-- **MarketplaceApi**: Browse and discover marketplace skills
-- **FilesApi**: Upload/download files via presigned URLs
-- **BillingApi**: Account credits and plan info
-
-## CLI Commands
-
-### Tasks
-```bash
-connect-browseruse tasks list                    # List all tasks
-connect-browseruse tasks create "Search for AI"  # Create new task
-connect-browseruse tasks get <id>                # Get task details
-connect-browseruse tasks stop <id>               # Stop running task
-connect-browseruse tasks pause <id>              # Pause task
-connect-browseruse tasks resume <id>             # Resume paused task
-connect-browseruse tasks logs <id>               # View task logs
-```
-
-### Sessions
-```bash
-connect-browseruse sessions list                 # List sessions
-connect-browseruse sessions get <id>             # Get session details
-connect-browseruse sessions create               # Create new session
-connect-browseruse sessions delete <id>          # Delete session
-connect-browseruse sessions share <id>           # Create public share
-connect-browseruse sessions unshare <id>         # Remove public share
-```
-
-### Browser Profiles
-```bash
-connect-browseruse profiles list                 # List browser profiles
-connect-browseruse profiles get <id>             # Get profile details
-connect-browseruse profiles create --name "My Profile" # Create profile
-connect-browseruse profiles delete <id>          # Delete profile
-```
-
-### Skills & Marketplace
-```bash
-connect-browseruse skills list                   # List user skills
-connect-browseruse skills get <id>               # Get skill details
-connect-browseruse skills create --name "Login" --parameter "url:string" # Create skill
-connect-browseruse skills delete <id>            # Delete skill
-connect-browseruse skills run <id> -p '{"url":"example.com"}' # Run skill
-
-connect-browseruse marketplace list              # List marketplace skills
-connect-browseruse marketplace get <id>          # Get marketplace skill
-```
-
-### Billing
-```bash
-connect-browseruse billing show                  # Show billing info
-connect-browseruse billing credits               # Show credit balance
-connect-browseruse billing plan                  # Show current plan
-```
-
-### Quick Run
-```bash
-connect-browseruse run "Navigate to google.com"  # Quick task execution
-connect-browseruse run "Search for news" --timeout 120000
-```
-
-### Profile & Config
-```bash
-connect-browseruse profile list                  # List profiles
-connect-browseruse profile use <name>            # Switch profile
-connect-browseruse profile create <name>         # Create profile
-connect-browseruse profile delete <name>         # Delete profile
-connect-browseruse config set api-key <key>      # Set API key
-connect-browseruse config set base-url <url>     # Set base URL
-connect-browseruse config show                   # Show current config
-```
-
-## Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `BROWSER_USE_API_KEY` | Browser Use API key (overrides profile) |
-| `BROWSER_USE_BASE_URL` | Base URL (default: https://api.browser-use.com) |
-
-## Data Storage
-
-```
-~/.connect/connect-browseruse/
-├── current_profile   # Active profile name
-└── profiles/
-    ├── default.json  # Default profile
-    └── {name}.json   # Named profiles
-```
-
-## Dependencies
-
-- commander: CLI framework
-- chalk: Terminal styling

package/connectors/connect-browseruse/README.md

@@ -1,153 +0,0 @@
-# connect-browseruse
-
-Browser Use Cloud API connector CLI - AI-powered browser automation tasks, sessions, and skills
-
-## Installation
-
-```bash
-bun install -g @hasna/connect-browseruse
-```
-
-## Quick Start
-
-```bash
-# Set your API key
-connect-browseruse config set-key YOUR_API_KEY
-
-# Or use environment variable
-export BROWSER_USE_API_KEY=YOUR_API_KEY
-```
-
-## CLI Commands
-
-### Tasks
-```bash
-connect-browseruse tasks list                    # List all tasks
-connect-browseruse tasks create "Search for AI"  # Create new task
-connect-browseruse tasks get <id>                # Get task details
-connect-browseruse tasks stop <id>               # Stop running task
-connect-browseruse tasks pause <id>              # Pause task
-connect-browseruse tasks resume <id>             # Resume paused task
-connect-browseruse tasks logs <id>               # View task logs
-```
-
-### Sessions
-```bash
-connect-browseruse sessions list                 # List sessions
-connect-browseruse sessions get <id>             # Get session details
-connect-browseruse sessions create               # Create new session
-connect-browseruse sessions delete <id>          # Delete session
-connect-browseruse sessions share <id>           # Create public share
-connect-browseruse sessions unshare <id>         # Remove public share
-```
-
-### Browser Profiles
-```bash
-connect-browseruse profiles list                 # List browser profiles
-connect-browseruse profiles get <id>             # Get profile details
-connect-browseruse profiles create --name "My Profile" # Create profile
-connect-browseruse profiles delete <id>          # Delete profile
-```
-
-### Skills & Marketplace
-```bash
-connect-browseruse skills list                   # List user skills
-connect-browseruse skills get <id>               # Get skill details
-connect-browseruse skills create --name "Login" --parameter "url:string" # Create skill
-connect-browseruse skills delete <id>            # Delete skill
-connect-browseruse skills run <id> -p '{"url":"example.com"}' # Run skill
-
-connect-browseruse marketplace list              # List marketplace skills
-connect-browseruse marketplace get <id>          # Get marketplace skill
-```
-
-### Billing
-```bash
-connect-browseruse billing show                  # Show billing info
-connect-browseruse billing credits               # Show credit balance
-connect-browseruse billing plan                  # Show current plan
-```
-
-### Quick Run
-```bash
-connect-browseruse run "Navigate to google.com"  # Quick task execution
-connect-browseruse run "Search for news" --timeout 120000
-```
-
-### Profile & Config
-```bash
-connect-browseruse profile list                  # List profiles
-connect-browseruse profile use <name>            # Switch profile
-connect-browseruse profile create <name>         # Create profile
-connect-browseruse profile delete <name>         # Delete profile
-connect-browseruse config set api-key <key>      # Set API key
-connect-browseruse config set base-url <url>     # Set base URL
-connect-browseruse config show                   # Show current config
-```
-
-## Profile Management
-
-```bash
-# Create profiles for different accounts
-connect-browseruse profile create work --api-key xxx --use
-connect-browseruse profile create personal --api-key yyy
-
-# Switch profiles
-connect-browseruse profile use work
-
-# Use profile for single command
-connect-browseruse -p personal <command>
-
-# List profiles
-connect-browseruse profile list
-```
-
-## Library Usage
-
-```typescript
-import { Browseruse } from '@hasna/connect-browseruse';
-
-const client = new Browseruse({ apiKey: 'YOUR_API_KEY' });
-
-// Use the client
-// See CLAUDE.md for detailed API documentation
-```
-
-## Environment Variables
-
-| Variable | Description |
-|----------|-------------|
-| `BROWSER_USE_API_KEY` | Browser Use API key (overrides profile) |
-| `BROWSER_USE_BASE_URL` | Base URL (default: https://api.browser-use.com) |
-
-## Data Storage
-
-Configuration stored in `~/.connect/connect-browseruse/`:
-
-```
-~/.connect/connect-browseruse/
-├── current_profile   # Active profile name
-└── profiles/
-    ├── default.json  # Default profile
-    └── {name}.json   # Named profiles
-```
-
-## Development
-
-```bash
-# Install dependencies
-bun install
-
-# Run CLI in development
-bun run dev
-
-# Build
-bun run build
-
-# Type check
-bun run typecheck
-```
-
-## License
-
-MIT

package/connectors/connect-browseruse/package.json

@@ -1,52 +0,0 @@
-{
-  "name": "@hasna/connect-browseruse",
-  "version": "0.0.2",
-  "description": "Browser Use Cloud API connector CLI - AI-powered browser automation tasks, sessions, and skills",
-  "type": "module",
-  "bin": {
-    "connect-browseruse": "./bin/index.js"
-  },
-  "exports": {
-    ".": {
-      "import": "./dist/index.js",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "main": "./dist/index.js",
-  "types": "./dist/index.d.ts",
-  "scripts": {
-    "build": "bun build ./src/index.ts --outdir ./dist --target bun && bun build ./src/cli/index.ts --outdir ./bin --target bun",
-    "dev": "bun run ./src/cli/index.ts",
-    "typecheck": "tsc --noEmit",
-    "prepublishOnly": "bun run build"
-  },
-  "keywords": [
-    "browser-use",
-    "browser",
-    "automation",
-    "ai-agent",
-    "web-scraping",
-    "connector",
-    "cli",
-    "typescript",
-    "bun",
-    "hasna"
-  ],
-  "author": "Hasna",
-  "license": "MIT",
-  "devDependencies": {
-    "@types/bun": "latest",
-    "typescript": "^5"
-  },
-  "dependencies": {
-    "commander": "^12.1.0",
-    "chalk": "^5.3.0"
-  },
-  "engines": {
-    "bun": ">=1.0.0"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/hasna/opensource-connectors.git"
-  }
-}

package/connectors/connect-browseruse/src/api/billing.ts

@@ -1,32 +0,0 @@
-import type { BrowserUseClient } from './client';
-import type { AccountBilling } from '../types';
-
-/**
- * Billing API
- */
-export class BillingApi {
-  constructor(private client: BrowserUseClient) {}
-
-  /**
-   * Get account billing information
-   */
-  async getAccount(): Promise<AccountBilling> {
-    return this.client.get<AccountBilling>('/v2/billing');
-  }
-
-  /**
-   * Get current credit balance
-   */
-  async getCredits(): Promise<number> {
-    const account = await this.getAccount();
-    return account.credits;
-  }
-
-  /**
-   * Get current plan
-   */
-  async getPlan(): Promise<string> {
-    const account = await this.getAccount();
-    return account.plan;
-  }
-}

package/connectors/connect-browseruse/src/api/browsers.ts

@@ -1,50 +0,0 @@
-import type { BrowserUseClient } from './client';
-import type {
-  BrowserSession,
-  CreateBrowserSessionParams,
-  ListBrowserSessionsParams,
-  PaginatedResponse,
-} from '../types';
-
-/**
- * Browsers API (Direct CDP browser sessions)
- */
-export class BrowsersApi {
-  constructor(private client: BrowserUseClient) {}
-
-  /**
-   * List all browser sessions
-   */
-  async list(params?: ListBrowserSessionsParams): Promise<PaginatedResponse<BrowserSession>> {
-    return this.client.get<PaginatedResponse<BrowserSession>>('/v2/browsers', {
-      limit: params?.limit,
-      cursor: params?.cursor,
-    });
-  }
-
-  /**
-   * Create a new browser session
-   */
-  async create(params?: CreateBrowserSessionParams): Promise<BrowserSession> {
-    return this.client.post<BrowserSession>('/v2/browsers', {
-      profile_id: params?.profileId,
-      proxy_url: params?.proxyUrl,
-    });
-  }
-
-  /**
-   * Get a browser session by ID
-   */
-  async get(browserId: string): Promise<BrowserSession> {
-    return this.client.get<BrowserSession>(`/v2/browsers/${browserId}`);
-  }
-
-  /**
-   * Stop a browser session
-   */
-  async stop(browserId: string): Promise<BrowserSession> {
-    return this.client.patch<BrowserSession>(`/v2/browsers/${browserId}`, {
-      action: 'stop',
-    });
-  }
-}