@hasna/connectors 0.0.1

package/connectors/connect-googlegemini/AGENTS.md

@@ -0,0 +1,184 @@
+# AGENTS.md
+
+This file provides guidance to AI coding agents when working with this repository.
+
+## Project Overview
+
+connect-googlegemini is a TypeScript connector for the Google Gemini API with multi-profile configuration support. It provides CLI and programmatic access to text generation, image generation (Nano Banana), video generation (Veo), text-to-speech, and embeddings.
+
+## 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
+
+API Key authentication. Credentials can be set via:
+- Environment variable (see below)
+- Profile configuration: `connect-googlegemini config set-key <key>`
+
+
+## Key Patterns
+
+### Multi-Profile Configuration
+
+Profiles stored in `~/.connect/connect-googlegemini/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 API key authentication via URL parameter. API key can be set via:
+- Environment variable: `GEMINI_API_KEY`
+- Profile configuration: `connect-googlegemini config set api-key <key>`
+
+### API Modules
+
+- **GenerateApi**: Text generation with streaming support
+- **ImagesApi**: Image generation and editing (Nano Banana)
+- **VideoApi**: Video generation with long-running operations (Veo)
+- **SpeechApi**: Text-to-speech with 30 voices
+- **EmbeddingsApi**: Text embeddings with similarity calculation
+- **FilesApi**: File upload and management
+- **ModelsApi**: Model listing and info
+
+### Long-Running Operations
+
+Video generation uses long-running operations:
+1. Start generation with `predictLongRunning`
+2. Poll operation status until `done: true`
+3. Extract video from response
+
+## API Modules
+
+- **GenerateApi**: Text generation with streaming support
+- **ImagesApi**: Image generation and editing (Nano Banana)
+- **VideoApi**: Video generation with long-running operations (Veo)
+- **SpeechApi**: Text-to-speech with 30 voices
+- **EmbeddingsApi**: Text embeddings with similarity calculation
+- **FilesApi**: File upload and management
+- **ModelsApi**: Model listing and info
+
+### Long-Running Operations
+
+Video generation uses long-running operations:
+1. Start generation with `predictLongRunning`
+2. Poll operation status until `done: true`
+3. Extract video from response
+
+## CLI Commands
+
+### Text Generation
+```bash
+connect-googlegemini ask <prompt>                  # Quick text
+connect-googlegemini generate text <prompt>        # With options
+connect-googlegemini generate json <prompt>        # JSON output
+connect-googlegemini generate tokens <text>        # Count tokens
+```
+
+### Image Generation (Nano Banana)
+```bash
+connect-googlegemini image generate <prompt>       # Generate
+connect-googlegemini image edit <img> <instruction> # Edit
+connect-googlegemini image describe <img>          # Vision
+```
+
+### Video Generation (Veo)
+```bash
+connect-googlegemini video generate <prompt>       # Generate
+connect-googlegemini video status <op>             # Status
+connect-googlegemini video models                  # List
+```
+
+### Speech
+```bash
+connect-googlegemini speech generate <text>        # TTS
+connect-googlegemini speech voices                 # List
+```
+
+### Embeddings
+```bash
+connect-googlegemini embed text <text>             # Embed
+connect-googlegemini embed similarity <t1> <t2>    # Compare
+```
+
+### Files
+```bash
+connect-googlegemini files list                    # List
+connect-googlegemini files upload <path>           # Upload
+connect-googlegemini files delete <name>           # Delete
+```
+
+### Models
+```bash
+connect-googlegemini models list                   # All models
+connect-googlegemini models info <model>           # Model info
+```
+
+### Profile & Config
+```bash
+connect-googlegemini profile list                  # List
+connect-googlegemini profile use <name>            # Switch
+connect-googlegemini config set api-key <key>      # Set key
+connect-googlegemini config show                   # Show
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `GEMINI_API_KEY` | Google Gemini API key |
+| `GEMINI_BASE_URL` | Base URL override |
+
+## Data Storage
+
+```
+~/.connect/connect-googlegemini/
+├── current_profile   # Active profile name
+└── profiles/
+    ├── default.json  # Default profile
+    └── {name}.json   # Named profiles
+```
+
+## Dependencies
+
+- commander: CLI framework
+- chalk: Terminal styling

package/connectors/connect-googlegemini/CLAUDE.md

@@ -0,0 +1,184 @@
+# CLAUDE.md
+
+This file provides guidance to Claude Code when working with this repository.
+
+## Project Overview
+
+connect-googlegemini is a TypeScript connector for the Google Gemini API with multi-profile configuration support. It provides CLI and programmatic access to text generation, image generation (Nano Banana), video generation (Veo), text-to-speech, and embeddings.
+
+## 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
+
+API Key authentication. Credentials can be set via:
+- Environment variable (see below)
+- Profile configuration: `connect-googlegemini config set-key <key>`
+
+
+## Key Patterns
+
+### Multi-Profile Configuration
+
+Profiles stored in `~/.connect/connect-googlegemini/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 API key authentication via URL parameter. API key can be set via:
+- Environment variable: `GEMINI_API_KEY`
+- Profile configuration: `connect-googlegemini config set api-key <key>`
+
+### API Modules
+
+- **GenerateApi**: Text generation with streaming support
+- **ImagesApi**: Image generation and editing (Nano Banana)
+- **VideoApi**: Video generation with long-running operations (Veo)
+- **SpeechApi**: Text-to-speech with 30 voices
+- **EmbeddingsApi**: Text embeddings with similarity calculation
+- **FilesApi**: File upload and management
+- **ModelsApi**: Model listing and info
+
+### Long-Running Operations
+
+Video generation uses long-running operations:
+1. Start generation with `predictLongRunning`
+2. Poll operation status until `done: true`
+3. Extract video from response
+
+## API Modules
+
+- **GenerateApi**: Text generation with streaming support
+- **ImagesApi**: Image generation and editing (Nano Banana)
+- **VideoApi**: Video generation with long-running operations (Veo)
+- **SpeechApi**: Text-to-speech with 30 voices
+- **EmbeddingsApi**: Text embeddings with similarity calculation
+- **FilesApi**: File upload and management
+- **ModelsApi**: Model listing and info
+
+### Long-Running Operations
+
+Video generation uses long-running operations:
+1. Start generation with `predictLongRunning`
+2. Poll operation status until `done: true`
+3. Extract video from response
+
+## CLI Commands
+
+### Text Generation
+```bash
+connect-googlegemini ask <prompt>                  # Quick text
+connect-googlegemini generate text <prompt>        # With options
+connect-googlegemini generate json <prompt>        # JSON output
+connect-googlegemini generate tokens <text>        # Count tokens
+```
+
+### Image Generation (Nano Banana)
+```bash
+connect-googlegemini image generate <prompt>       # Generate
+connect-googlegemini image edit <img> <instruction> # Edit
+connect-googlegemini image describe <img>          # Vision
+```
+
+### Video Generation (Veo)
+```bash
+connect-googlegemini video generate <prompt>       # Generate
+connect-googlegemini video status <op>             # Status
+connect-googlegemini video models                  # List
+```
+
+### Speech
+```bash
+connect-googlegemini speech generate <text>        # TTS
+connect-googlegemini speech voices                 # List
+```
+
+### Embeddings
+```bash
+connect-googlegemini embed text <text>             # Embed
+connect-googlegemini embed similarity <t1> <t2>    # Compare
+```
+
+### Files
+```bash
+connect-googlegemini files list                    # List
+connect-googlegemini files upload <path>           # Upload
+connect-googlegemini files delete <name>           # Delete
+```
+
+### Models
+```bash
+connect-googlegemini models list                   # All models
+connect-googlegemini models info <model>           # Model info
+```
+
+### Profile & Config
+```bash
+connect-googlegemini profile list                  # List
+connect-googlegemini profile use <name>            # Switch
+connect-googlegemini config set api-key <key>      # Set key
+connect-googlegemini config show                   # Show
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `GEMINI_API_KEY` | Google Gemini API key |
+| `GEMINI_BASE_URL` | Base URL override |
+
+## Data Storage
+
+```
+~/.connect/connect-googlegemini/
+├── current_profile   # Active profile name
+└── profiles/
+    ├── default.json  # Default profile
+    └── {name}.json   # Named profiles
+```
+
+## Dependencies
+
+- commander: CLI framework
+- chalk: Terminal styling

package/connectors/connect-googlegemini/GEMINI.md

@@ -0,0 +1,184 @@
+# GEMINI.md
+
+This file provides guidance to Gemini when working with this repository.
+
+## Project Overview
+
+connect-googlegemini is a TypeScript connector for the Google Gemini API with multi-profile configuration support. It provides CLI and programmatic access to text generation, image generation (Nano Banana), video generation (Veo), text-to-speech, and embeddings.
+
+## 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
+
+API Key authentication. Credentials can be set via:
+- Environment variable (see below)
+- Profile configuration: `connect-googlegemini config set-key <key>`
+
+
+## Key Patterns
+
+### Multi-Profile Configuration
+
+Profiles stored in `~/.connect/connect-googlegemini/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 API key authentication via URL parameter. API key can be set via:
+- Environment variable: `GEMINI_API_KEY`
+- Profile configuration: `connect-googlegemini config set api-key <key>`
+
+### API Modules
+
+- **GenerateApi**: Text generation with streaming support
+- **ImagesApi**: Image generation and editing (Nano Banana)
+- **VideoApi**: Video generation with long-running operations (Veo)
+- **SpeechApi**: Text-to-speech with 30 voices
+- **EmbeddingsApi**: Text embeddings with similarity calculation
+- **FilesApi**: File upload and management
+- **ModelsApi**: Model listing and info
+
+### Long-Running Operations
+
+Video generation uses long-running operations:
+1. Start generation with `predictLongRunning`
+2. Poll operation status until `done: true`
+3. Extract video from response
+
+## API Modules
+
+- **GenerateApi**: Text generation with streaming support
+- **ImagesApi**: Image generation and editing (Nano Banana)
+- **VideoApi**: Video generation with long-running operations (Veo)
+- **SpeechApi**: Text-to-speech with 30 voices
+- **EmbeddingsApi**: Text embeddings with similarity calculation
+- **FilesApi**: File upload and management
+- **ModelsApi**: Model listing and info
+
+### Long-Running Operations
+
+Video generation uses long-running operations:
+1. Start generation with `predictLongRunning`
+2. Poll operation status until `done: true`
+3. Extract video from response
+
+## CLI Commands
+
+### Text Generation
+```bash
+connect-googlegemini ask <prompt>                  # Quick text
+connect-googlegemini generate text <prompt>        # With options
+connect-googlegemini generate json <prompt>        # JSON output
+connect-googlegemini generate tokens <text>        # Count tokens
+```
+
+### Image Generation (Nano Banana)
+```bash
+connect-googlegemini image generate <prompt>       # Generate
+connect-googlegemini image edit <img> <instruction> # Edit
+connect-googlegemini image describe <img>          # Vision
+```
+
+### Video Generation (Veo)
+```bash
+connect-googlegemini video generate <prompt>       # Generate
+connect-googlegemini video status <op>             # Status
+connect-googlegemini video models                  # List
+```
+
+### Speech
+```bash
+connect-googlegemini speech generate <text>        # TTS
+connect-googlegemini speech voices                 # List
+```
+
+### Embeddings
+```bash
+connect-googlegemini embed text <text>             # Embed
+connect-googlegemini embed similarity <t1> <t2>    # Compare
+```
+
+### Files
+```bash
+connect-googlegemini files list                    # List
+connect-googlegemini files upload <path>           # Upload
+connect-googlegemini files delete <name>           # Delete
+```
+
+### Models
+```bash
+connect-googlegemini models list                   # All models
+connect-googlegemini models info <model>           # Model info
+```
+
+### Profile & Config
+```bash
+connect-googlegemini profile list                  # List
+connect-googlegemini profile use <name>            # Switch
+connect-googlegemini config set api-key <key>      # Set key
+connect-googlegemini config show                   # Show
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `GEMINI_API_KEY` | Google Gemini API key |
+| `GEMINI_BASE_URL` | Base URL override |
+
+## Data Storage
+
+```
+~/.connect/connect-googlegemini/
+├── current_profile   # Active profile name
+└── profiles/
+    ├── default.json  # Default profile
+    └── {name}.json   # Named profiles
+```
+
+## Dependencies
+
+- commander: CLI framework
+- chalk: Terminal styling

package/connectors/connect-googlegemini/README.md

@@ -0,0 +1,143 @@
+# connect-googlegemini
+
+Google Gemini API connector CLI - Text, image, video generation with Gemini, Nano Banana, and Veo models
+
+## Installation
+
+```bash
+bun install -g @hasna/connect-googlegemini
+```
+
+## Quick Start
+
+```bash
+# Set your API key
+connect-googlegemini config set-key YOUR_API_KEY
+
+# Or use environment variable
+export GEMINI_API_KEY=YOUR_API_KEY
+```
+
+## CLI Commands
+
+### Text Generation
+```bash
+connect-googlegemini ask <prompt>                  # Quick text
+connect-googlegemini generate text <prompt>        # With options
+connect-googlegemini generate json <prompt>        # JSON output
+connect-googlegemini generate tokens <text>        # Count tokens
+```
+
+### Image Generation (Nano Banana)
+```bash
+connect-googlegemini image generate <prompt>       # Generate
+connect-googlegemini image edit <img> <instruction> # Edit
+connect-googlegemini image describe <img>          # Vision
+```
+
+### Video Generation (Veo)
+```bash
+connect-googlegemini video generate <prompt>       # Generate
+connect-googlegemini video status <op>             # Status
+connect-googlegemini video models                  # List
+```
+
+### Speech
+```bash
+connect-googlegemini speech generate <text>        # TTS
+connect-googlegemini speech voices                 # List
+```
+
+### Embeddings
+```bash
+connect-googlegemini embed text <text>             # Embed
+connect-googlegemini embed similarity <t1> <t2>    # Compare
+```
+
+### Files
+```bash
+connect-googlegemini files list                    # List
+connect-googlegemini files upload <path>           # Upload
+connect-googlegemini files delete <name>           # Delete
+```
+
+### Models
+```bash
+connect-googlegemini models list                   # All models
+connect-googlegemini models info <model>           # Model info
+```
+
+### Profile & Config
+```bash
+connect-googlegemini profile list                  # List
+connect-googlegemini profile use <name>            # Switch
+connect-googlegemini config set api-key <key>      # Set key
+connect-googlegemini config show                   # Show
+```
+
+## Profile Management
+
+```bash
+# Create profiles for different accounts
+connect-googlegemini profile create work --api-key xxx --use
+connect-googlegemini profile create personal --api-key yyy
+
+# Switch profiles
+connect-googlegemini profile use work
+
+# Use profile for single command
+connect-googlegemini -p personal <command>
+
+# List profiles
+connect-googlegemini profile list
+```
+
+## Library Usage
+
+```typescript
+import { Googlegemini } from '@hasna/connect-googlegemini';
+
+const client = new Googlegemini({ apiKey: 'YOUR_API_KEY' });
+
+// Use the client
+// See CLAUDE.md for detailed API documentation
+```
+
+## Environment Variables
+
+| Variable | Description |
+|----------|-------------|
+| `GEMINI_API_KEY` | Google Gemini API key |
+| `GEMINI_BASE_URL` | Base URL override |
+
+## Data Storage
+
+Configuration stored in `~/.connect/connect-googlegemini/`:
+
+```
+~/.connect/connect-googlegemini/
+├── 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