ai-vision-mcp 0.0.4 → 0.0.5-dev.2

package/README.md

@@ -112,13 +112,13 @@ claude mcp add ai-vision-mcp \
 ```
 
 
-Note: Increase the MCP tool timeout to about 5 minutes by updating `~\.claude\settings.json` as follows:
+Note: Increase the MCP startup timeout to 1 minutes and MCP tool execution timeout to about 5 minutes by updating `~\.claude\settings.json` as follows:
 
 ```json
 {
   "env": {
-    "MCP_TIMEOUT": "20000", // Give the MCP server 20s to start.
-    "MCP_TOOL_TIMEOUT": "300000" // Allow each tool calls before timeout.
+    "MCP_TIMEOUT": "60000",
+    "MCP_TOOL_TIMEOUT": "300000"
   }
 }
 ```
@@ -309,12 +309,12 @@ Detects objects in an image using AI vision models and generates annotated image
 **Configuration:**
 This function uses optimized default parameters for object detection and does not accept runtime `options` parameter. To customize the AI parameters (temperature, topP, topK, maxTokens), use environment variables:
 
-```bash
-# Recommended settings for object detection (these are now the defaults)
-export TEMPERATURE_FOR_DETECT_OBJECTS_IN_IMAGE=0.0     # Deterministic responses
-export TOP_P_FOR_DETECT_OBJECTS_IN_IMAGE=0.95          # Nucleus sampling
-export TOP_K_FOR_DETECT_OBJECTS_IN_IMAGE=30            # Vocabulary selection
-export MAX_TOKENS_FOR_DETECT_OBJECTS_IN_IMAGE=8192     # High token limit for JSON
+```
+# Recommended environment variable settings for object detection (these are now the defaults)
+TEMPERATURE_FOR_DETECT_OBJECTS_IN_IMAGE=0.0     # Deterministic responses
+TOP_P_FOR_DETECT_OBJECTS_IN_IMAGE=0.95          # Nucleus sampling
+TOP_K_FOR_DETECT_OBJECTS_IN_IMAGE=30            # Vocabulary selection
+MAX_TOKENS_FOR_DETECT_OBJECTS_IN_IMAGE=8192     # High token limit for JSON
 ```
 
 **File Handling Logic:**
@@ -388,139 +388,109 @@ Analyzes a video using AI and returns a detailed description.
 **Note:** Only YouTube URLs are supported for public video URLs. Other public video URLs are not currently supported.
 
 
-### Environment Variables
-| Variable | Required | Description | Default |
-|-----------|-----------|-------------|---------|
-| **Provider Selection** ||||
-| `IMAGE_PROVIDER` | Yes | Provider for image analysis | `google`,`vertex_ai` |
-| `VIDEO_PROVIDER` | Yes | Provider for video analysis | `google`,`vertex_ai` |
-| **Model Selection** ||||
-| `IMAGE_MODEL` | No | Model for image analysis | `gemini-2.5-flash-lite` |
-| `VIDEO_MODEL` | No | Model for video analysis | `gemini-2.5-flash` |
-| **Function-specific Model Selection** ||||
-| `ANALYZE_IMAGE_MODEL` | No | Model for analyze_image function | Uses `IMAGE_MODEL` |
-| `COMPARE_IMAGES_MODEL` | No | Model for compare_images function | Uses `IMAGE_MODEL` |
-| `DETECT_OBJECTS_IN_IMAGE_MODEL` | No | Model for detect_objects_in_image function | Uses `IMAGE_MODEL` |
-| `ANALYZE_VIDEO_MODEL` | No | Model for analyze_video function | Uses `VIDEO_MODEL` |
-| **Google Gemini API** ||||
-| `GEMINI_API_KEY` | Yes if `IMAGE_PROVIDER` or `VIDEO_PROVIDER` = `google` | Google Gemini API key | Required for Gemini |
-| `GEMINI_BASE_URL` | No | Gemini API base URL | `https://generativelanguage.googleapis.com` |
-| **Vertex AI** ||||
-| `VERTEX_CREDENTIALS` | Yes if `IMAGE_PROVIDER` or `VIDEO_PROVIDER` = `vertex_ai` | Path to GCP service account JSON | Required for Vertex AI |
-| `VERTEX_PROJECT_ID` | Auto | Google Cloud project ID | Auto-derived from credentials |
-| `VERTEX_LOCATION` | No | Vertex AI region | `us-central1` |
-| `VERTEX_ENDPOINT` | No | Vertex AI endpoint URL | `https://aiplatform.googleapis.com` |
-| **Google Cloud Storage (Vertex AI)** ||||
-| `GCS_BUCKET_NAME` | Yes if `IMAGE_PROVIDER` or `VIDEO_PROVIDER` = `vertex_ai` | GCS bucket name for Vertex AI uploads | Required for Vertex AI |
-| `GCS_CREDENTIALS` | No | Path to GCS credentials | Defaults to `VERTEX_CREDENTIALS` |
-| `GCS_PROJECT_ID` | No | GCS project ID | Auto-derived from `VERTEX_CREDENTIALS` |
-| `GCS_REGION` | No | GCS region | Defaults to `VERTEX_LOCATION` |
-| **API Configuration** ||||
-| `TEMPERATURE` | No | AI response temperature (0.0–2.0) | `0.8` |
-| `TOP_P` | No | Top-p sampling parameter (0.0–1.0) | `0.95` |
-| `TOP_K` | No | Top-k sampling parameter (1–100) | `30` |
-| `MAX_TOKENS` | No | Maximum tokens for analysis (1–8192) | `1000` |
-| **Task-type level Configuration** |||||
-| `TEMPERATURE_FOR_IMAGE` | No | Image-specific temperature (0.0–2.0) | Uses `TEMPERATURE` |
-| `TOP_P_FOR_IMAGE` | No | Image-specific top-p (0.0–1.0) | Uses `TOP_P` |
-| `TOP_K_FOR_IMAGE` | No | Image-specific top-k (1–100) | Uses `TOP_K` |
-| `TEMPERATURE_FOR_VIDEO` | No | Video-specific temperature (0.0–2.0) | Uses `TEMPERATURE` |
-| `TOP_P_FOR_VIDEO` | No | Video-specific top-p (0.0–1.0) | Uses `TOP_P` |
-| `TOP_K_FOR_VIDEO` | No | Video-specific top-k (1–100) | Uses `TOP_K` |
-| `MAX_TOKENS_FOR_IMAGE` | No | Maximum tokens for image analysis | Uses `MAX_TOKENS` |
-| `MAX_TOKENS_FOR_VIDEO` | No | Maximum tokens for video analysis | Uses `MAX_TOKENS` |
-| **Function-specific Configuration** |||||
-| `TEMPERATURE_FOR_ANALYZE_IMAGE` | No | Temperature for analyze_image function (0.0–2.0) | Uses `TEMPERATURE_FOR_IMAGE` |
-| `TOP_P_FOR_ANALYZE_IMAGE` | No | Top-p for analyze_image function (0.0–1.0) | Uses `TOP_P_FOR_IMAGE` |
-| `TOP_K_FOR_ANALYZE_IMAGE` | No | Top-k for analyze_image function (1–100) | Uses `TOP_K_FOR_IMAGE` |
-| `MAX_TOKENS_FOR_ANALYZE_IMAGE` | No | Max tokens for analyze_image function | Uses `MAX_TOKENS_FOR_IMAGE` |
-| `TEMPERATURE_FOR_COMPARE_IMAGES` | No | Temperature for compare_images function (0.0–2.0) | Uses `TEMPERATURE_FOR_IMAGE` |
-| `TOP_P_FOR_COMPARE_IMAGES` | No | Top-p for compare_images function (0.0–1.0) | Uses `TOP_P_FOR_IMAGE` |
-| `TOP_K_FOR_COMPARE_IMAGES` | No | Top-k for compare_images function (1–100) | Uses `TOP_K_FOR_IMAGE` |
-| `MAX_TOKENS_FOR_COMPARE_IMAGES` | No | Max tokens for compare_images function | Uses `MAX_TOKENS_FOR_IMAGE` |
-| `TEMPERATURE_FOR_DETECT_OBJECTS_IN_IMAGE` | No | Temperature for detect_objects_in_image function (0.0–2.0) | `0.0` |
-| `TOP_P_FOR_DETECT_OBJECTS_IN_IMAGE` | No | Top-p for detect_objects_in_image function (0.0–1.0) | `0.95` |
-| `TOP_K_FOR_DETECT_OBJECTS_IN_IMAGE` | No | Top-k for detect_objects_in_image function (1–100) | `30` |
-| `MAX_TOKENS_FOR_DETECT_OBJECTS_IN_IMAGE` | No | Max tokens for detect_objects_in_image function | `8192` |
-| `TEMPERATURE_FOR_ANALYZE_VIDEO` | No | Temperature for analyze_video function (0.0–2.0) | Uses `TEMPERATURE_FOR_VIDEO` |
-| `TOP_P_FOR_ANALYZE_VIDEO` | No | Top-p for analyze_video function (0.0–1.0) | Uses `TOP_P_FOR_VIDEO` |
-| `TOP_K_FOR_ANALYZE_VIDEO` | No | Top-k for analyze_video function (1–100) | Uses `TOP_K_FOR_VIDEO` |
-| `MAX_TOKENS_FOR_ANALYZE_VIDEO` | No | Max tokens for analyze_video function | Uses `MAX_TOKENS_FOR_VIDEO` |
-| **File Processing** ||||
-| `MAX_IMAGE_SIZE` | No | Maximum image size in bytes | `20971520` (20 MB) |
-| `MAX_VIDEO_SIZE` | No | Maximum video size in bytes | `2147483648` (2 GB) |
-| `MAX_VIDEO_DURATION` | No | Maximum video duration (seconds) | `3600` (1 hour) |
-| `MAX_IMAGES_FOR_COMPARISON` | No | Maximum number of images for comparison, used by compare_images() mcp function | `4` |
-| `ALLOWED_IMAGE_FORMATS` | No | Comma-separated image formats | `png,jpg,jpeg,webp,gif,bmp,tiff` |
-| `ALLOWED_VIDEO_FORMATS` | No | Comma-separated video formats | `mp4,mov,avi,mkv,webm,flv,wmv,3gp` |
-| **Development** ||||
-| `LOG_LEVEL` | No | Logging level | `info` |
-| `NODE_ENV` | No | Environment mode | `development` |
-| `GEMINI_FILES_API_THRESHOLD` | No | Size threshold for Gemini Files API (bytes) | `10485760` (10 MB) |
-| `VERTEX_AI_FILES_API_THRESHOLD` | No | Size threshold for Vertex AI uploads (bytes) | `0` |
+## Environment Configuration
 
+For basic setup, you only need to configure the provider selection and required credentials:
 
-<details>
-<summary>More on Environment Variable Logic (Optional to learn) </summary>
+### Google AI Studio Provider (Recommended)
+```bash
+export IMAGE_PROVIDER="google"
+export VIDEO_PROVIDER="google"
+export GEMINI_API_KEY="your-gemini-api-key"
+```
+
+### Vertex AI Provider (Production)
+```bash
+export IMAGE_PROVIDER="vertex_ai"
+export VIDEO_PROVIDER="vertex_ai"
+export VERTEX_CREDENTIALS="/path/to/service-account.json"
+export GCS_BUCKET_NAME="your-gcs-bucket"
+```
+
+### 📖 **Detailed Configuration Guide**
+
+For comprehensive environment variable documentation, including:
+- Complete configuration reference (60+ environment variables)
+- Function-specific optimization examples
+- Advanced configuration patterns
+- Troubleshooting guidance
 
-The MCP server uses a four-level configuration priority system for AI parameters (highest to lowest):
+👉 **[See Environment Variable Guide](docs/environment-variable-guide.md)**
+
+### Configuration Priority Overview
+
+The server uses a hierarchical configuration system where more specific settings override general ones:
+
+1. **LLM-assigned values** (runtime parameters in tool calls)
+2. **Function-specific variables** (`TEMPERATURE_FOR_ANALYZE_IMAGE`, etc.)
+3. **Task-specific variables** (`TEMPERATURE_FOR_IMAGE`, etc.)
+4. **Universal variables** (`TEMPERATURE`, etc.)
+5. **System defaults**
+
+<details>
+<summary><strong>Quick Configuration Examples</strong></summary>
 
-1. **LLM-assigned values** - Parameters passed directly in tool calls (e.g., `{"temperature": 0.1}`)
-2. **Function-specific variables** - `TEMPERATURE_FOR_ANALYZE_IMAGE`, `MAX_TOKENS_FOR_COMPARE_IMAGES`, etc.
-3. **Task-specific variables** - `TEMPERATURE_FOR_IMAGE`, `MAX_TOKENS_FOR_VIDEO`, etc.
-4. **Universal variables** - `TEMPERATURE`, `MAX_TOKENS`, etc.
-5. **System defaults** - Built-in fallback values
+**Basic Optimization:**
+```bash
+# General settings
+export TEMPERATURE=0.7
+export MAX_TOKENS=1500
 
-For model selection, the server uses a three-level hierarchy (highest to lowest):
+# Task-specific optimization
+export TEMPERATURE_FOR_IMAGE=0.2     # More precise for images
+export TEMPERATURE_FOR_VIDEO=0.5     # More creative for videos
+```
 
-1. **Function-specific models** - `ANALYZE_IMAGE_MODEL`, `COMPARE_IMAGES_MODEL`, `ANALYZE_VIDEO_MODEL`
-2. **Task-specific models** - `IMAGE_MODEL`, `VIDEO_MODEL`
-3. **System defaults** - Built-in fallback models (`gemini-2.5-flash-lite`, `gemini-2.5-flash`)
+**Function-specific Optimization:**
+```bash
+# Optimize individual functions
+export TEMPERATURE_FOR_ANALYZE_IMAGE=0.1
+export TEMPERATURE_FOR_COMPARE_IMAGES=0.3
+export TEMPERATURE_FOR_DETECT_OBJECTS_IN_IMAGE=0.0  # Deterministic
+export MAX_TOKENS_FOR_DETECT_OBJECTS_IN_IMAGE=8192   # High token limit
+```
 
-**Example Usage:**
+**Model Selection:**
 ```bash
-# AI Parameters configuration
-TEMPERATURE=0.3
-MAX_TOKENS=600
-
-# Task-specific overrides
-TEMPERATURE_FOR_IMAGE=0.1  # More precise for image analysis
-MAX_TOKENS_FOR_VIDEO=1200   # Longer responses for video content
-
-# Function-specific overrides
-TEMPERATURE_FOR_ANALYZE_IMAGE=0.05     # Very precise for single image analysis
-TEMPERATURE_FOR_COMPARE_IMAGES=0.2     # More creative for comparisons
-MAX_TOKENS_FOR_COMPARE_IMAGES=1500      # Longer responses for image comparisons
-TEMPERATURE_FOR_DETECT_OBJECTS_IN_IMAGE=0.0   # Deterministic for object detection
-MAX_TOKENS_FOR_DETECT_OBJECTS_IN_IMAGE=8192   # Higher token limit for structured output
-TEMPERATURE_FOR_ANALYZE_VIDEO=0.1      # Precise video analysis
-
-# Model selection configuration
-ANALYZE_IMAGE_MODEL="gemini-2.5-flash-lite"          # Fast, cost-effective for single image analysis
-COMPARE_IMAGES_MODEL="gemini-2.5-flash-lite"
-DETECT_OBJECTS_IN_IMAGE_MODEL="gemini-2.5-flash-lite"  # Structured output capable model
-ANALYZE_VIDEO_MODEL="gemini-2.5-flash-pro"           # Most capable for video analysis
-
-# Task-specific models (existing pattern still works)
-IMAGE_MODEL="gemini-2.5-flash"
-VIDEO_MODEL="gemini-2.5-flash-pro"
-
-# Resolution order for analyze_image:
-# 1. ANALYZE_IMAGE_MODEL
-# 2. IMAGE_MODEL
-# 3. System default ("gemini-2.5-flash-lite")
-
-# Resolution order for detect_objects_in_image:
-# 1. DETECT_OBJECTS_IN_IMAGE_MODEL
-# 2. IMAGE_MODEL
-# 3. System default ("gemini-2.5-flash-lite")
-
-# LLM can still override at runtime via tool parameters
-```
-
-This allows you to set sensible defaults while maintaining granular control per task type and per function, with a clean and maintainable 3-level hierarchy.
+# Choose models per function
+export ANALYZE_IMAGE_MODEL="gemini-2.5-flash-lite"
+export COMPARE_IMAGES_MODEL="gemini-2.5-flash"
+export ANALYZE_VIDEO_MODEL="gemini-2.5-flash-pro"
+```
 </details>
 
+## Troubleshooting (stdio / Codex / Claude Code)
+
+### 1) "Transport closed" / tool call fails
+
+If you see errors like:
+
+- `tools/call failed: Transport closed`
+
+Common causes:
+
+**A) Image annotation dependency failed to load**
+
+This server uses [`imagescript`](https://github.com/matmen/ImageScript) for image annotation/dimension extraction.
+
+Verify it loads:
+
+```bash
+npm run doctor
+# or
+npm run check:imagescript
+```
+
+**B) stdout logs corrupt stdio MCP framing**
+
+This server uses the MCP **stdio** transport (newline-delimited JSON-RPC over stdout).
+
+- ✅ stdout must contain **only** MCP JSON-RPC messages
+- ✅ write logs to **stderr** (e.g. `console.error`)
+- ❌ do not use `console.log` in stdio MCP servers
+
+If stdout is polluted, clients (Codex/Claude Code) may disconnect and report `Transport closed`.
+
 ## Development
 
 ### Prerequisites

package/dist/cli/commands/analyze-image.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from '../../types/Config.js';
+export declare function runAnalyzeImage(args: string[], config: Config): Promise<void>;
+//# sourceMappingURL=analyze-image.d.ts.map

package/dist/cli/commands/analyze-image.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-image.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze-image.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAOpD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCnF"}

package/dist/cli/commands/analyze-image.js

@@ -0,0 +1,30 @@
+import { ConfigService } from '../../services/ConfigService.js';
+import { VisionProviderFactory } from '../../providers/factory/ProviderFactory.js';
+import { FileService } from '../../services/FileService.js';
+import { analyze_image } from '../../tools/analyze_image.js';
+import { parseOptions, formatOutput, handleError, parseArgs } from '../utils.js';
+export async function runAnalyzeImage(args, config) {
+    const { positional, options } = parseArgs(args);
+    if (positional.length < 1) {
+        console.error('Error: Image source required');
+        console.error('Usage: ai-vision analyze-image <source> --prompt <text>');
+        process.exit(1);
+    }
+    const imageSource = positional[0];
+    const prompt = options.prompt;
+    if (!prompt) {
+        console.error('Error: --prompt is required');
+        process.exit(1);
+    }
+    const configService = ConfigService.getInstance();
+    const imageProvider = VisionProviderFactory.createProviderWithValidation(config, 'image');
+    const imageFileService = new FileService(configService, 'image', imageProvider);
+    try {
+        const result = await analyze_image({ imageSource, prompt, options: parseOptions(options) }, config, imageProvider, imageFileService);
+        console.log(formatOutput(result, 'json' in options));
+    }
+    catch (error) {
+        handleError(error, 'json' in options);
+    }
+}
+//# sourceMappingURL=analyze-image.js.map

package/dist/cli/commands/analyze-image.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-image.js","sourceRoot":"","sources":["../../../src/cli/commands/analyze-image.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc,EAAE,MAAc;IAElE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAGD,MAAM,aAAa,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,aAAa,GAAG,qBAAqB,CAAC,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1F,MAAM,gBAAgB,GAAG,IAAI,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,aAAoB,CAAC,CAAC;IAGvF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,EACvD,MAAM,EACN,aAAa,EACb,gBAAgB,CACjB,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/cli/commands/analyze-video.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from '../../types/Config.js';
+export declare function runAnalyzeVideo(args: string[], config: Config): Promise<void>;
+//# sourceMappingURL=analyze-video.d.ts.map

package/dist/cli/commands/analyze-video.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-video.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/analyze-video.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAOpD,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCnF"}

package/dist/cli/commands/analyze-video.js

@@ -0,0 +1,30 @@
+import { ConfigService } from '../../services/ConfigService.js';
+import { VisionProviderFactory } from '../../providers/factory/ProviderFactory.js';
+import { FileService } from '../../services/FileService.js';
+import { analyze_video } from '../../tools/analyze_video.js';
+import { parseOptions, formatOutput, handleError, parseArgs } from '../utils.js';
+export async function runAnalyzeVideo(args, config) {
+    const { positional, options } = parseArgs(args);
+    if (positional.length < 1) {
+        console.error('Error: Video source required');
+        console.error('Usage: ai-vision analyze-video <source> --prompt <text>');
+        process.exit(1);
+    }
+    const videoSource = positional[0];
+    const prompt = options.prompt;
+    if (!prompt) {
+        console.error('Error: --prompt is required');
+        process.exit(1);
+    }
+    const configService = ConfigService.getInstance();
+    const videoProvider = VisionProviderFactory.createProviderWithValidation(config, 'video');
+    const videoFileService = new FileService(configService, 'video', videoProvider);
+    try {
+        const result = await analyze_video({ videoSource, prompt, options: parseOptions(options) }, config, videoProvider, videoFileService);
+        console.log(formatOutput(result, 'json' in options));
+    }
+    catch (error) {
+        handleError(error, 'json' in options);
+    }
+}
+//# sourceMappingURL=analyze-video.js.map

package/dist/cli/commands/analyze-video.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"analyze-video.js","sourceRoot":"","sources":["../../../src/cli/commands/analyze-video.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,eAAe,CAAC,IAAc,EAAE,MAAc;IAElE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,yDAAyD,CAAC,CAAC;QACzE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAGD,MAAM,aAAa,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,aAAa,GAAG,qBAAqB,CAAC,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1F,MAAM,gBAAgB,GAAG,IAAI,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,aAAoB,CAAC,CAAC;IAGvF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,aAAa,CAChC,EAAE,WAAW,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,EACvD,MAAM,EACN,aAAa,EACb,gBAAgB,CACjB,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/cli/commands/compare-images.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from '../../types/Config.js';
+export declare function runCompareImages(args: string[], config: Config): Promise<void>;
+//# sourceMappingURL=compare-images.d.ts.map

package/dist/cli/commands/compare-images.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-images.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/compare-images.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAOpD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAoCpF"}

package/dist/cli/commands/compare-images.js

@@ -0,0 +1,30 @@
+import { ConfigService } from '../../services/ConfigService.js';
+import { VisionProviderFactory } from '../../providers/factory/ProviderFactory.js';
+import { FileService } from '../../services/FileService.js';
+import { compare_images } from '../../tools/compare_images.js';
+import { parseOptions, formatOutput, handleError, parseArgs } from '../utils.js';
+export async function runCompareImages(args, config) {
+    const { positional, options } = parseArgs(args);
+    if (positional.length < 2) {
+        console.error('Error: At least 2 image sources required');
+        console.error('Usage: ai-vision compare-images <source1> <source2> [source3...] --prompt <text>');
+        process.exit(1);
+    }
+    const imageSources = positional;
+    const prompt = options.prompt;
+    if (!prompt) {
+        console.error('Error: --prompt is required');
+        process.exit(1);
+    }
+    const configService = ConfigService.getInstance();
+    const imageProvider = VisionProviderFactory.createProviderWithValidation(config, 'image');
+    const imageFileService = new FileService(configService, 'image', imageProvider);
+    try {
+        const result = await compare_images({ imageSources, prompt, options: parseOptions(options) }, config, imageProvider, imageFileService);
+        console.log(formatOutput(result, 'json' in options));
+    }
+    catch (error) {
+        handleError(error, 'json' in options);
+    }
+}
+//# sourceMappingURL=compare-images.js.map

package/dist/cli/commands/compare-images.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"compare-images.js","sourceRoot":"","sources":["../../../src/cli/commands/compare-images.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,cAAc,EAAE,MAAM,+BAA+B,CAAC;AAC/D,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc,EAAE,MAAc;IAEnE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,0CAA0C,CAAC,CAAC;QAC1D,OAAO,CAAC,KAAK,CAAC,kFAAkF,CAAC,CAAC;QAClG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,YAAY,GAAG,UAAU,CAAC;IAChC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAE9B,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAGD,MAAM,aAAa,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,aAAa,GAAG,qBAAqB,CAAC,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1F,MAAM,gBAAgB,GAAG,IAAI,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,aAAoB,CAAC,CAAC;IAGvF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,cAAc,CACjC,EAAE,YAAY,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,EACxD,MAAM,EACN,aAAa,EACb,gBAAgB,CACjB,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/cli/commands/detect-objects.d.ts

@@ -0,0 +1,3 @@
+import type { Config } from '../../types/Config.js';
+export declare function runDetectObjects(args: string[], config: Config): Promise<void>;
+//# sourceMappingURL=detect-objects.d.ts.map

package/dist/cli/commands/detect-objects.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-objects.d.ts","sourceRoot":"","sources":["../../../src/cli/commands/detect-objects.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAOpD,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqCpF"}

package/dist/cli/commands/detect-objects.js

@@ -0,0 +1,31 @@
+import { ConfigService } from '../../services/ConfigService.js';
+import { VisionProviderFactory } from '../../providers/factory/ProviderFactory.js';
+import { FileService } from '../../services/FileService.js';
+import { detect_objects_in_image } from '../../tools/detect_objects_in_image.js';
+import { parseOptions, formatOutput, handleError, parseArgs } from '../utils.js';
+export async function runDetectObjects(args, config) {
+    const { positional, options } = parseArgs(args);
+    if (positional.length < 1) {
+        console.error('Error: Image source required');
+        console.error('Usage: ai-vision detect-objects <source> --prompt <text>');
+        process.exit(1);
+    }
+    const imageSource = positional[0];
+    const prompt = options.prompt;
+    const outputFilePath = options.output;
+    if (!prompt) {
+        console.error('Error: --prompt is required');
+        process.exit(1);
+    }
+    const configService = ConfigService.getInstance();
+    const imageProvider = VisionProviderFactory.createProviderWithValidation(config, 'image');
+    const imageFileService = new FileService(configService, 'image', imageProvider);
+    try {
+        const result = await detect_objects_in_image({ imageSource, prompt, outputFilePath, options: parseOptions(options) }, config, imageProvider, imageFileService);
+        console.log(formatOutput(result, 'json' in options));
+    }
+    catch (error) {
+        handleError(error, 'json' in options);
+    }
+}
+//# sourceMappingURL=detect-objects.js.map

package/dist/cli/commands/detect-objects.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"detect-objects.js","sourceRoot":"","sources":["../../../src/cli/commands/detect-objects.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAChE,OAAO,EAAE,qBAAqB,EAAE,MAAM,4CAA4C,CAAC;AACnF,OAAO,EAAE,WAAW,EAAE,MAAM,+BAA+B,CAAC;AAC5D,OAAO,EAAE,uBAAuB,EAAE,MAAM,wCAAwC,CAAC;AACjF,OAAO,EAAE,YAAY,EAAE,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAEjF,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,IAAc,EAAE,MAAc;IAEnE,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,GAAG,SAAS,CAAC,IAAI,CAAC,CAAC;IAEhD,IAAI,UAAU,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC1B,OAAO,CAAC,KAAK,CAAC,8BAA8B,CAAC,CAAC;QAC9C,OAAO,CAAC,KAAK,CAAC,0DAA0D,CAAC,CAAC;QAC1E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,WAAW,GAAG,UAAU,CAAC,CAAC,CAAC,CAAC;IAClC,MAAM,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAC9B,MAAM,cAAc,GAAG,OAAO,CAAC,MAAM,CAAC;IAEtC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAGD,MAAM,aAAa,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,aAAa,GAAG,qBAAqB,CAAC,4BAA4B,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC1F,MAAM,gBAAgB,GAAG,IAAI,WAAW,CAAC,aAAa,EAAE,OAAO,EAAE,aAAoB,CAAC,CAAC;IAGvF,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,uBAAuB,CAC1C,EAAE,WAAW,EAAE,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,YAAY,CAAC,OAAO,CAAC,EAAE,EACvE,MAAM,EACN,aAAa,EACb,gBAAgB,CACjB,CAAC;QAEF,OAAO,CAAC,GAAG,CAAC,YAAY,CAAC,MAAM,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC,CAAC;IACvD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,WAAW,CAAC,KAAK,EAAE,MAAM,IAAI,OAAO,CAAC,CAAC;IACxC,CAAC;AACH,CAAC"}

package/dist/cli/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export declare function runCli(args: string[]): Promise<void>;
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAQA,wBAAsB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CA+B1D"}

package/dist/cli/index.js

@@ -0,0 +1,63 @@
+#!/usr/bin/env node
+import { ConfigService } from '../services/ConfigService.js';
+import { runAnalyzeImage } from './commands/analyze-image.js';
+import { runCompareImages } from './commands/compare-images.js';
+import { runDetectObjects } from './commands/detect-objects.js';
+import { runAnalyzeVideo } from './commands/analyze-video.js';
+export async function runCli(args) {
+    const command = args[0];
+    const commandArgs = args.slice(1);
+    const configService = ConfigService.getInstance();
+    const config = configService.getConfig();
+    switch (command) {
+        case 'analyze-image':
+            await runAnalyzeImage(commandArgs, config);
+            break;
+        case 'compare-images':
+            await runCompareImages(commandArgs, config);
+            break;
+        case 'detect-objects':
+            await runDetectObjects(commandArgs, config);
+            break;
+        case 'analyze-video':
+            await runAnalyzeVideo(commandArgs, config);
+            break;
+        case 'help':
+        case '--help':
+        case '-h':
+            showHelp();
+            break;
+        default:
+            console.error(`Unknown command: ${command}`);
+            showHelp();
+            process.exit(1);
+    }
+}
+function showHelp() {
+    console.log(`
+ai-vision CLI
+
+Usage: ai-vision <command> [options]
+
+Commands:
+  analyze-image <source>       Analyze an image
+  compare-images <sources...>  Compare multiple images (2-4)
+  detect-objects <source>      Detect objects in an image
+  analyze-video <source>       Analyze a video
+
+Global Options:
+  --prompt <text>              The analysis prompt (required)
+  --json                       Output raw JSON
+  --temperature <num>          Temperature 0-2 (default: 0.7)
+  --top-p <num>                Top P 0-1
+  --top-k <num>                Top K 1-100
+  --max-tokens <num>           Max output tokens
+  --help                       Show this help
+
+Examples:
+  ai-vision analyze-image https://example.com/img.jpg --prompt "describe"
+  ai-vision compare-images img1.jpg img2.jpg --prompt "find differences" --json
+  ai-vision detect-objects photo.jpg --prompt "find all cars" --output annotated.jpg
+`);
+}
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,8BAA8B,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAC9D,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,gBAAgB,EAAE,MAAM,8BAA8B,CAAC;AAChE,OAAO,EAAE,eAAe,EAAE,MAAM,6BAA6B,CAAC;AAE9D,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,IAAc;IACzC,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;IACxB,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;IAGlC,MAAM,aAAa,GAAG,aAAa,CAAC,WAAW,EAAE,CAAC;IAClD,MAAM,MAAM,GAAG,aAAa,CAAC,SAAS,EAAE,CAAC;IAEzC,QAAQ,OAAO,EAAE,CAAC;QAChB,KAAK,eAAe;YAClB,MAAM,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM;QACR,KAAK,gBAAgB;YACnB,MAAM,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM;QACR,KAAK,gBAAgB;YACnB,MAAM,gBAAgB,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAC5C,MAAM;QACR,KAAK,eAAe;YAClB,MAAM,eAAe,CAAC,WAAW,EAAE,MAAM,CAAC,CAAC;YAC3C,MAAM;QACR,KAAK,MAAM,CAAC;QACZ,KAAK,QAAQ,CAAC;QACd,KAAK,IAAI;YACP,QAAQ,EAAE,CAAC;YACX,MAAM;QACR;YACE,OAAO,CAAC,KAAK,CAAC,oBAAoB,OAAO,EAAE,CAAC,CAAC;YAC7C,QAAQ,EAAE,CAAC;YACX,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IACpB,CAAC;AACH,CAAC;AAED,SAAS,QAAQ;IACf,OAAO,CAAC,GAAG,CAAC;;;;;;;;;;;;;;;;;;;;;;;;CAwBb,CAAC,CAAC;AACH,CAAC"}

package/dist/cli/utils.d.ts

@@ -0,0 +1,17 @@
+import type { AnalysisResult } from '../types/Providers.js';
+import type { ObjectDetectionResponse } from '../types/ObjectDetection.js';
+import type { VideoMetadata } from '../types/Analysis.js';
+export declare function parseOptions(options: Record<string, string>): {
+    temperature?: number;
+    topP?: number;
+    topK?: number;
+    maxTokens?: number;
+    videoMetadata?: VideoMetadata;
+};
+export declare function formatOutput(result: AnalysisResult | ObjectDetectionResponse, jsonMode?: boolean): string;
+export declare function handleError(error: unknown, jsonMode?: boolean): never;
+export declare function parseArgs(args: string[]): {
+    positional: string[];
+    options: Record<string, string>;
+};
+//# sourceMappingURL=utils.d.ts.map

package/dist/cli/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../src/cli/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,uBAAuB,CAAC;AAC5D,OAAO,KAAK,EAAE,uBAAuB,EAAE,MAAM,6BAA6B,CAAC;AAC3E,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAC;AAE1D,wBAAgB,YAAY,CAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG;IAC7D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,aAAa,CAAC;CAC/B,CA2CA;AAED,wBAAgB,YAAY,CAC1B,MAAM,EAAE,cAAc,GAAG,uBAAuB,EAChD,QAAQ,CAAC,EAAE,OAAO,GACjB,MAAM,CAeR;AAED,wBAAgB,WAAW,CAAC,KAAK,EAAE,OAAO,EAAE,QAAQ,CAAC,EAAE,OAAO,GAAG,KAAK,CAiBrE;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG;IAAE,UAAU,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAAE,CAuBnG"}

package/dist/cli/utils.js

@@ -0,0 +1,85 @@
+export function parseOptions(options) {
+    const result = {};
+    if (options.temperature) {
+        result.temperature = parseFloat(options.temperature);
+    }
+    if (options['top-p'] || options.topP) {
+        result.topP = parseFloat(options['top-p'] || options.topP);
+    }
+    if (options['top-k'] || options.topK) {
+        result.topK = parseInt(options['top-k'] || options.topK);
+    }
+    if (options['max-tokens'] || options.maxTokens) {
+        result.maxTokens = parseInt(options['max-tokens'] || options.maxTokens);
+    }
+    const videoMetadata = {};
+    if (options['start-offset'] || options.startOffset) {
+        videoMetadata.startOffset = options['start-offset'] || options.startOffset;
+    }
+    if (options['end-offset'] || options.endOffset) {
+        videoMetadata.endOffset = options['end-offset'] || options.endOffset;
+    }
+    if (options.fps) {
+        const fpsValue = parseFloat(options.fps);
+        if (!isNaN(fpsValue)) {
+            videoMetadata.fps = fpsValue;
+        }
+    }
+    if (videoMetadata.startOffset !== undefined || videoMetadata.endOffset !== undefined || videoMetadata.fps !== undefined) {
+        result.videoMetadata = videoMetadata;
+    }
+    return result;
+}
+export function formatOutput(result, jsonMode) {
+    if (jsonMode) {
+        return JSON.stringify(result, null, 2);
+    }
+    if ('text' in result) {
+        return result.text;
+    }
+    if ('detections' in result) {
+        return result.summary || JSON.stringify(result.detections, null, 2);
+    }
+    return JSON.stringify(result, null, 2);
+}
+export function handleError(error, jsonMode) {
+    if (jsonMode) {
+        const errorResponse = {
+            error: true,
+            message: error instanceof Error ? error.message : 'An unknown error occurred',
+        };
+        console.log(JSON.stringify(errorResponse, null, 2));
+    }
+    else {
+        if (error instanceof Error) {
+            console.error(`Error: ${error.message}`);
+        }
+        else {
+            console.error('An unknown error occurred');
+        }
+    }
+    process.exit(1);
+}
+export function parseArgs(args) {
+    const positional = [];
+    const options = {};
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        if (arg.startsWith('--')) {
+            const key = arg.replace('--', '');
+            const nextArg = args[i + 1];
+            if (nextArg !== undefined && !nextArg.startsWith('--')) {
+                options[key] = nextArg;
+                i++;
+            }
+            else {
+                options[key] = '';
+            }
+        }
+        else {
+            positional.push(arg);
+        }
+    }
+    return { positional, options };
+}
+//# sourceMappingURL=utils.js.map