image-tiler-mcp-server 1.6.1 → 2.0.0

package/README.md

@@ -1,11 +1,38 @@
 # image-tiler-mcp-server
 
-Split large images into optimally-sized tiles so LLM vision models see every detail - no downscaling, no lost text.
+Capture, tile, analyze, and estimate vision tokens for LLM models - so nothing gets downscaled away.
 
 <p align="center">
   <img src="assets/preview.gif" alt="Preview of image tiling grid with advised vision models size and token estimates" width="100%" />
 </p>
 
+## Usage
+
+### Tile an image
+
+> lets tile ~/Desktop/source.jpg
+
+The server shows you a comparison of supported vision models with tile counts and token estimates.
+Pick the model that matches your use case, and the server tiles the image and returns them in batches for analysis.
+
+### Capture a web page
+
+> capture screenshot of https://example.com and analyze the content
+
+The server launches Chrome, captures a full-page screenshot (scroll-stitching pages over 16,384px), then presents the same model comparison. Choose a model and the server tiles the capture for analysis.
+
+To get only the screenshot without tiling, just ask for a screenshot and stop after the comparison step.
+
+### Customize tiling
+
+| What | Example prompt |
+|------|---------------|
+| Target a specific model | "Tile hero.png for OpenAI" |
+| Keep full resolution | "Tile banner.png at full resolution, no downscaling" |
+| PNG output | "Tile diagram.png as lossless PNG" |
+| Tile from URL | "Download and tile https://example.com/chart.png" |
+| Tile from base64 | "Tile this base64 image: iVBORw0KGgo..." |
+
 ## Installation
 
 ### Claude Code
@@ -115,25 +142,25 @@ Then point your MCP config to the built file:
 
 ## Tiling for LLM Vision
 
-LLM vision systems have a **maximum input resolution**. When you send an image larger than that limit, the model silently downscales it before processing. A 3600×22810 full-page screenshot gets shrunk to ~247×1568 by Claude - text becomes unreadable, UI details disappear, and the model can't analyze what it can't see.
+LLM vision systems have a **maximum input resolution**. When you send an image larger than that limit, the model downscales it before processing. A 3600×22810 full-page screenshot gets shrunk to ~247×1568 by Claude - text becomes unreadable, UI details disappear, and the model can't analyze what it can't see.
 
 **Tiling solves this.** This MCP server:
 
 1. Reads the image dimensions and the target model's vision config
 2. Calculates an optimal grid that keeps every tile within the model's sweet spot
-3. Extracts tiles as individual PNGs and saves them to disk
+3. Extracts tiles as individual images (WebP default, PNG optional) and saves them to disk
 4. Returns metadata (grid layout, file paths, estimated token cost)
 5. Serves tiles back as base64 in paginated batches for the LLM to analyze
 
-Each tile is processed at **full resolution** - no downscaling - preserving text, UI elements, and fine detail across the entire image.
+Each tile stays within the model's sweet spot - the LLM processes it at full resolution instead of downscaling, preserving text, UI elements, and fine detail.
 
-**Auto-downscaling:** Images over 10,000px on their longest side are automatically downscaled before tiling (configurable via `maxDimension`). This prevents extreme tile counts on very long screenshots - e.g., a 3600×22810 page drops from 84 tiles / ~134K tokens to 20 tiles / ~32K tokens with no visible quality loss. Set `maxDimension=0` to disable.
+**Auto-downscaling:** Images over 10,000px on their longest side are automatically downscaled before tiling (configurable via `maxDimension`). This keeps tile counts reasonable and improves LLM comprehension by increasing content density per tile. Set `maxDimension=0` to disable, or pass a custom value (e.g., `maxDimension=5000`) for more aggressive downscaling.
 
 ### Supported Models
 
 | Model | Default tile | Tokens/tile | Max tile | ID |
 |-------|-------------|-------------|----------|-----|
-| Claude (default) | 1092px | 1590 | 1568px | `claude` |
+| Claude | 1092px | 1590 | 1568px | `claude` |
 | OpenAI (GPT-4o/o-series) | 768px | 765 | 2048px | `openai` |
 | Gemini | 768px | 258 | 768px | `gemini` |
 | Gemini 3 | 1536px | 1120 | 3072px | `gemini3` |
@@ -144,218 +171,81 @@ Each tile is processed at **full resolution** - no downscaling - preserving text
 
 ## Tools
 
-### `tiler_tile_image`
+### `tiler`
 
-Splits a large image into tiles and saves them to disk.
+One unified tool that handles all image tiling operations. The mode is auto-detected from the parameters you provide:
 
-| Parameter | Type | Required | Default | Description |
-|---|---|---|---|---|
-| `filePath` | string | no* | - | Absolute or relative path to the image file |
-| `sourceUrl` | string | no* | - | HTTPS URL to download the image from (max 50MB, 30s timeout) |
-| `dataUrl` | string | no* | - | Data URL with base64-encoded image |
-| `imageBase64` | string | no* | - | Raw base64-encoded image data |
-| `model` | string | no | `"claude"` | Target vision model: `"claude"`, `"openai"`, `"gemini"`, `"gemini3"` |
-| `tileSize` | number | no | Model default | Tile size in pixels. Clamped to model min/max with a warning if out of bounds. |
-| `maxDimension` | number | no | `10000` | Max dimension in px (0-65536). Pre-downscales the image so its longest side fits within this value before tiling. Defaults to 10000px. Set to 0 to disable auto-downscaling. No-op if already within bounds. |
-| `outputDir` | string | no | `tiles/{name}` subfolder next to source | Directory to save tiles |
+- **`tilesDir`** present → **Tile retrieval mode** (read-only pagination)
+- **`url`** or **`screenshotPath`** present → **URL capture mode** (screenshot + tile)
+- **`filePath`**, **`sourceUrl`**, **`dataUrl`**, or **`imageBase64`** present → **Tile-image mode**
 
-*At least one image source (`filePath`, `sourceUrl`, `dataUrl`, or `imageBase64`) is required.
+> **Mode priority:** When multiple mode params are present, the tool resolves by priority:
+> `tilesDir` > `url`/`screenshotPath` > `filePath`/`sourceUrl`/`dataUrl`/`imageBase64`.
+> Avoid passing params from different modes in the same call.
 
-Returns JSON metadata with grid dimensions, tile count, model used, estimated token cost, and per-tile file paths.
+**Workflow:**
 
-### `tiler_get_tiles`
+The tool uses a two-step process to let you choose the right model before tiling:
 
-Returns tile images as base64 in batches of 5 for the LLM to see directly.
+1. **Compare** - Call with only the image source. Returns a comparison table showing tile counts and token estimates for each supported model, plus an interactive HTML preview.
+2. **Tile** - Call again with the chosen `model` + `outputDir` from step 1, plus:
+   - **Image sources:** re-include your original source param (`filePath`, `sourceUrl`, etc.)
+   - **Captures:** use `screenshotPath` from step 1 (not the original `url`)
 
-| Parameter | Type | Required | Default | Description |
-|---|---|---|---|---|
-| `tilesDir` | string | yes | - | Path to tiles directory (from `tiler_tile_image`) |
-| `start` | number | no | 0 | Start tile index (0-based, inclusive) |
-| `end` | number | no | start + 4 | End tile index (0-based, inclusive) |
-
-Returns text labels + image content blocks. Includes pagination hint for the next batch.
+> **Skip the comparison step:** Provide `model` and `outputDir` on the first call to tile immediately.
 
-### `tiler_recommend_settings`
+> **Interactive model picker:** Clients that support MCP elicitation get a dropdown picker instead of the comparison table.
 
-Dry-run estimator: reads image dimensions and returns cost estimates **without tiling**.
+#### Parameters - Image Source (tile-image mode)
 
 | Parameter | Type | Required | Default | Description |
 |---|---|---|---|---|
-| `filePath` | string | no* | - | Path to image file |
-| `sourceUrl` | string | no* | - | HTTPS URL to download from |
-| `dataUrl` | string | no* | - | Data URL with base64 image |
-| `imageBase64` | string | no* | - | Raw base64 image data |
-| `model` | string | no | `"claude"` | Target vision model |
-| `tileSize` | number | no | Model default | Override tile size (skips heuristics) |
-| `maxDimension` | number | no | - | Override max dimension (skips heuristics) |
-| `intent` | string | no | - | `"text_heavy"`, `"ui_screenshot"`, `"diagram"`, `"photo"`, `"general"` |
-| `budget` | string | no | - | `"low"`, `"default"`, `"max_detail"` |
-
-*At least one image source required.
-
-Returns JSON with recommended settings, rationale, image info, grid estimate, and a comparison across all 4 models.
+| `filePath` | string | no* | - | Absolute or relative path to the image file |
+| `sourceUrl` | string | no* | - | HTTPS URL to download the image from (max 50MB, 30s timeout) |
+| `dataUrl` | string | no* | - | Data URL with base64-encoded image |
+| `imageBase64` | string | no* | - | Raw base64-encoded image data |
 
-### `tiler_prepare_image`
+*At least one image source is required for tile-image mode.
 
-One-shot convenience tool: tiles an image AND returns the first batch of tiles in a single call.
+#### Parameters - URL Capture (capture mode)
 
 | Parameter | Type | Required | Default | Description |
 |---|---|---|---|---|
-| `filePath` | string | no* | - | Path to image file |
-| `sourceUrl` | string | no* | - | HTTPS URL to download from |
-| `dataUrl` | string | no* | - | Data URL with base64 image |
-| `imageBase64` | string | no* | - | Raw base64 image data |
-| `model` | string | no | `"claude"` | Target vision model |
-| `tileSize` | number | no | Model default | Override tile size |
-| `maxDimension` | number | no | `10000` | Max dimension for auto-downscaling |
-| `outputDir` | string | no | `tiles/{name}` subfolder | Directory to save tiles |
-| `page` | number | no | `0` | Tile page (0 = tiles 0-4, 1 = tiles 5-9, etc.) |
-
-*At least one image source required.
-
-Returns tiling metadata + up to 5 tile images inline. Saves a round-trip compared to calling `tiler_tile_image` then `tiler_get_tiles` separately.
-
-## Usage
-
-### Quick Start
-
-```
-> Tile the screenshot at ./screenshots/full-page.png and analyze the layout
+| `url` | string | no | - | URL of the web page to capture. Requires Chrome/Chromium installed (or `CHROME_PATH` env var). |
+| `screenshotPath` | string | no | - | Path to a previously captured screenshot. Skips URL capture when provided. |
+| `viewportWidth` | number | no | Auto-detect (fallback 1280) | Browser viewport width in pixels (320-3840) |
+| `waitUntil` | string | no | `"load"` | When to consider the page loaded: `"load"`, `"networkidle"`, or `"domcontentloaded"` |
+| `delay` | number | no | `0` | Additional delay in ms after page load (max 30000) |
 
-Your MCP client will:
-1. Call tiler_recommend_settings(filePath="./screenshots/full-page.png") to preview token costs
-2. Call tiler_prepare_image(filePath="./screenshots/full-page.png") to tile and get the first batch
-3. Call tiler_get_tiles(tilesDir="...", start=5, end=9) for subsequent batches
-```
+Supports scroll-stitching for pages taller than 16,384px. Automatically triggers lazy-loaded images (`loading="lazy"`) before capture by scrolling through the page. Pages without lazy images are unaffected.
 
-### With Other Models
+#### Parameters - Tile Retrieval (pagination mode)
 
-```
-> Tile this image for GPT-4o analysis
-
-Your MCP client will:
-1. Call tiler_tile_image(filePath="./image.png", model="openai")
-2. Tiles sized at 768px for OpenAI's vision pipeline
-```
-
-### Auto-Downscaling
-
-Images over 10,000px are automatically downscaled before tiling. You can customize the limit:
-
-```
-> Tile this 7680x4032 screenshot but downscale to 2048px first to save tokens
-
-Your MCP client will:
-1. Call tiler_tile_image(filePath="./image.png", maxDimension=2048)
-2. Image is downscaled to 2048x1076 before tiling
-3. Fewer tiles = lower token cost (e.g., 4 tiles instead of 32)
-```
-
-To disable auto-downscaling entirely:
-
-```
-> Tile this image at full resolution, no downscaling
-
-Your MCP client will:
-1. Call tiler_tile_image(filePath="./image.png", maxDimension=0)
-2. Image is tiled at its original dimensions
-```
-
-### Estimating Costs
-
-Use `tiler_recommend_settings` to preview token costs before tiling:
-
-```
-> How many tokens would it cost to tile this 3600x22810 screenshot?
-
-Your MCP client will:
-1. Call tiler_recommend_settings(filePath="./screenshot.png")
-2. See cost estimates for all 4 models
-3. Make an informed decision before committing to tiling
-```
-
-With intent and budget hints:
-
-```
-> Estimate costs for this long document screenshot, keeping tokens low
-
-Your MCP client will:
-1. Call tiler_recommend_settings(filePath="./doc.png", intent="text_heavy", budget="low")
-2. Get optimized maxDimension recommendation for text-heavy content
-```
-
-### Using URLs / Base64
-
-All image-accepting tools (`tiler_tile_image`, `tiler_recommend_settings`, `tiler_prepare_image`) support multiple input sources:
-
-```
-> Tile this image from a URL
-
-Your MCP client will:
-1. Call tiler_tile_image(sourceUrl="https://example.com/screenshot.png")
-
-> Tile this base64 image
-
-Your MCP client will:
-1. Call tiler_tile_image(imageBase64="iVBORw0KGgo...")
-```
-
-### One-Shot Usage
-
-Use `tiler_prepare_image` to tile and get the first batch in one call:
-
-```
-> Analyze this screenshot
-
-Your MCP client will:
-1. Call tiler_prepare_image(filePath="./screenshot.png")
-2. Get tiling metadata + first 5 tiles in a single response
-3. Continue with tiler_get_tiles for remaining tiles if needed
-```
-
-### Typical Workflow
-
-1. Capture a full-page screenshot with your browser extension
-2. Ask your AI assistant: _"Tile `/path/to/screencapture-localhost-3000.png` and review all sections"_
-3. The client pages through tiles automatically, analyzing each batch
-
-## Token Cost Reference
-
-Costs vary by model. Formula: `tokens = totalTiles x tokensPerTile`
-
-### Claude (1092px tiles, 1590 tokens/tile)
-
-| Image Dimensions | Tiles | Estimated Tokens |
-|---|---|---|
-| 1440x3000 | 6 | ~9,540 |
-| 3600x5000 | 20 | ~31,800 |
-| 3600x22810 | 84 | ~133,560 |
-
-### OpenAI - GPT-4o/o-series (768px tiles, 765 tokens/tile)
-
-| Image Dimensions | Tiles | Estimated Tokens |
-|---|---|---|
-| 1440x3000 | 8 | ~6,120 |
-| 3600x5000 | 35 | ~26,775 |
-| 3600x22810 | 150 | ~114,750 |
-
-### Gemini (768px tiles, 258 tokens/tile)
-
-| Image Dimensions | Tiles | Estimated Tokens |
-|---|---|---|
-| 1440x3000 | 8 | ~2,064 |
-| 3600x5000 | 35 | ~9,030 |
-| 3600x22810 | 150 | ~38,700 |
-
-### Gemini 3 (1536px tiles, 1120 tokens/tile)
+| Parameter | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `tilesDir` | string | no | - | Path to tiles directory (returned by a previous tiling call as `outputDir`) |
+| `start` | number | no | `0` | Start tile index (0-based, inclusive) |
+| `end` | number | no | start + 4 | End tile index (0-based, inclusive). Max 5 tiles per batch. |
 
-| Image Dimensions | Tiles | Estimated Tokens |
-|---|---|---|
-| 1440x3000 | 2 | ~2,240 |
-| 3600x5000 | 12 | ~13,440 |
-| 3600x22810 | 45 | ~50,400 |
+#### Parameters - Tiling Config (shared across modes)
 
-> **Note:** Gemini 3 uses a fixed 1120 tokens per image regardless of dimensions. More tiles = more total tokens but better detail preservation.
+| Parameter | Type | Required | Default | Description |
+|---|---|---|---|---|
+| `model` | string | no | Auto (cheapest) | Target vision model: `"claude"`, `"openai"`, `"gemini"`, `"gemini3"`. Auto-selects the most token-efficient preset when omitted. |
+| `tileSize` | number | no | Model default | Tile size in pixels. Clamped to model's supported range with a warning if out of bounds. |
+| `maxDimension` | number | no | `10000` | Max dimension in px (0 to disable, or 256-65536). Values 1-255 are silently clamped to 256. Pre-downscales the image so its longest side fits within this value before tiling. |
+| `outputDir` | string | no | See below | Directory to save tiles. Defaults: for `filePath` sources, `tiles/{name}_vN/` next to source (auto-incrementing: `_v1`, `_v2`, ..., `_vN`); for `sourceUrl`/`dataUrl`/`imageBase64`, `{base}/tiles/tiled_{timestamp}_{hex}/`; for captures, `{base}/tiles/capture_{timestamp}_{hex}/`. `{base}` is `~/Desktop`, `~/Downloads`, or `~` (first available). |
+| `page` | number | no | `0` | Tile page to return (0 = first 5, 1 = next 5, etc.) |
+| `format` | string | no | `"webp"` | Output format: `"webp"` (smaller, default) or `"png"` (lossless) |
+| `includeMetadata` | boolean | no | `true` | Analyze each tile and return content hints (blank, low-detail, mixed, high-detail) and brightness stats |
+
+## Behaviors
+
+- **Source conflict:** Multiple image source params → highest-precedence source is used with a warning (`filePath` > `sourceUrl` > `dataUrl` > `imageBase64`).
+- **Re-entry:** If `outputDir` already has a preview from the comparison step, the server skips straight to tiling.
+- **Elicitation cancellation:** Cancelling the model picker returns `"Tiling cancelled by user."` without tiling.
+- **Versioned output:** Repeated tiling of the same source creates `_v1`, `_v2`, ..., `_vN` directories to avoid overwriting.
+- **Tile naming:** `tile_ROW_COL.{format}` with zero-padded 3-digit indices (e.g., `tile_000_003.webp`), row-by-row, left-to-right.
 
 ## Supported Formats
 
@@ -363,21 +253,27 @@ PNG, JPEG, WebP, TIFF, GIF
 
 ## Troubleshooting
 
-**"Command not found"** - Make sure Node.js 18+ is installed: `node --version`
+**"Command not found"** - Make sure Node.js 20+ is installed: `node --version`
 
 **"File not found"** - Use absolute paths. Relative paths resolve from the MCP server's working directory.
 
 **"MCP tools not available"** - Restart your MCP client after config changes. In Claude Code, run `/mcp` to check server status.
 
+**"Chrome not found"** - Install Google Chrome or set the `CHROME_PATH` environment variable to the Chrome executable (must be an absolute path).
+
+**Running as root / in Docker** - Set `CHROME_NO_SANDBOX=1` to launch Chrome without sandbox (also enabled automatically when running as root).
+
+**`viewportWidth` auto-detection** - Auto-detection of screen width works on macOS only. On other platforms, falls back to 1280px.
+
 ## Security
 
-Local stdio server — runs with the same filesystem permissions as the MCP client that spawns it. No path sandboxing, no SSRF protection on URL downloads.
+Local stdio server - runs with the same filesystem permissions as the MCP client that spawns it. No path sandboxing, no SSRF protection on URL downloads.
 
 **If deploying remotely:** Add path validation, SSRF protection (block private/internal IP ranges), and authentication. This server is not designed for multi-tenant or network-exposed use.
 
 ## Requirements
 
-- Node.js 18+
+- Node.js 20+
 - Compatible MCP client (Claude Code, Codex CLI, VS Code, Cursor, Claude Desktop)
 
 ## License

package/dist/constants.d.ts

@@ -1,4 +1,4 @@
-export declare const VISION_MODELS: readonly ["claude", "openai", "gemini", "gemini3"];
+export declare const VISION_MODELS: readonly ["claude", "openai", "gemini3", "gemini"];
 export type VisionModel = (typeof VISION_MODELS)[number];
 export interface ModelVisionConfig {
     defaultTileSize: number;
@@ -25,8 +25,27 @@ export declare const ALLOWED_URL_PROTOCOLS: readonly ["https:"];
 export declare const MAX_BASE64_LENGTH = 67108864;
 export declare const MAX_DATA_URL_LENGTH: number;
 export declare const MIN_REMAINDER_RATIO = 0.15;
-export declare const IMAGE_INTENTS: readonly ["text_heavy", "ui_screenshot", "diagram", "photo", "general"];
-export type ImageIntent = (typeof IMAGE_INTENTS)[number];
-export declare const BUDGET_LEVELS: readonly ["low", "default", "max_detail"];
-export type BudgetLevel = (typeof BUDGET_LEVELS)[number];
+export declare const SHARP_OPERATION_TIMEOUT_MS = 30000;
+export declare const TILE_OUTPUT_FORMATS: readonly ["png", "webp"];
+export type TileOutputFormat = (typeof TILE_OUTPUT_FORMATS)[number];
+export declare const WEBP_QUALITY = 80;
+export declare const MAX_STITCH_BYTES: number;
+export declare const MAX_CAPTURE_HEIGHT = 200000;
+export declare const CHROME_MAX_CAPTURE_HEIGHT = 16384;
+export declare const CAPTURE_DEFAULT_VIEWPORT_WIDTH = 1280;
+export declare const CAPTURE_DEFAULT_VIEWPORT_HEIGHT = 800;
+export declare const CAPTURE_DEFAULT_TIMEOUT_MS = 60000;
+export declare const CAPTURE_STITCH_SETTLE_MS = 100;
+export declare const CAPTURE_IDLE_TIMEOUT_MS = 500;
+export declare const WAIT_UNTIL_OPTIONS: readonly ["load", "networkidle", "domcontentloaded"];
+export type WaitUntil = (typeof WAIT_UNTIL_OPTIONS)[number];
+export declare const ALLOWED_CAPTURE_PROTOCOLS: readonly ["https:", "http:"];
+export declare const LAZY_LOAD_SCROLL_PAUSE_MS = 100;
+export declare const LAZY_LOAD_IMAGE_TIMEOUT_MS = 5000;
+export declare const LAZY_LOAD_TOTAL_TIMEOUT_MS = 15000;
+export declare const MAX_IMAGE_PIXELS = 256000000;
+export declare const MAX_CHROME_STDERR_BYTES = 1048576;
+export declare const MAX_CHROME_JSON_BYTES = 1048576;
+export declare const MAX_PREVIEW_PIXELS = 16000000;
+export declare const MIN_PREVIEW_WIDTH = 800;
 //# sourceMappingURL=constants.d.ts.map

package/dist/constants.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,oDAAqD,CAAC;AAChF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CA6BhE,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAAsB,CAAC;AAGnD,eAAO,MAAM,iBAAiB,QAAuC,CAAC;AACtE,eAAO,MAAM,aAAa,QAAmC,CAAC;AAC9D,eAAO,MAAM,aAAa,QAAmC,CAAC;AAC9D,eAAO,MAAM,eAAe,QAAqC,CAAC;AAElE,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AACzC,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,iBAAiB,wDAAyD,CAAC;AACxF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAG3C,eAAO,MAAM,uBAAuB,QAAmB,CAAC;AACxD,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAC1C,eAAO,MAAM,qBAAqB,qBAAsB,CAAC;AACzD,eAAO,MAAM,iBAAiB,WAAa,CAAC;AAC5C,eAAO,MAAM,mBAAmB,QAA0B,CAAC;AAG3D,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAGxC,eAAO,MAAM,aAAa,yEAA0E,CAAC;AACrG,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAO,MAAM,aAAa,2CAA4C,CAAC;AACvE,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC"}
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,aAAa,oDAAqD,CAAC;AAChF,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,CAAC,CAAC;AAEzD,MAAM,WAAW,iBAAiB;IAChC,eAAe,EAAE,MAAM,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,MAAM,CAAC;IACpB,aAAa,EAAE,MAAM,CAAC;IACtB,KAAK,EAAE,MAAM,CAAC;CACf;AAED,eAAO,MAAM,aAAa,EAAE,MAAM,CAAC,WAAW,EAAE,iBAAiB,CA6BhE,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,WAAsB,CAAC;AAGnD,eAAO,MAAM,iBAAiB,QAAuC,CAAC;AACtE,eAAO,MAAM,aAAa,QAAmC,CAAC;AAC9D,eAAO,MAAM,aAAa,QAAmC,CAAC;AAC9D,eAAO,MAAM,eAAe,QAAqC,CAAC;AAElE,eAAO,MAAM,mBAAmB,QAAQ,CAAC;AACzC,eAAO,MAAM,eAAe,QAAQ,CAAC;AACrC,eAAO,MAAM,mBAAmB,IAAI,CAAC;AACrC,eAAO,MAAM,iBAAiB,wDAAyD,CAAC;AACxF,eAAO,MAAM,qBAAqB,IAAI,CAAC;AACvC,eAAO,MAAM,qBAAqB,QAAQ,CAAC;AAG3C,eAAO,MAAM,uBAAuB,QAAmB,CAAC;AACxD,eAAO,MAAM,mBAAmB,QAAS,CAAC;AAC1C,eAAO,MAAM,qBAAqB,qBAAsB,CAAC;AACzD,eAAO,MAAM,iBAAiB,WAAa,CAAC;AAC5C,eAAO,MAAM,mBAAmB,QAA0B,CAAC;AAG3D,eAAO,MAAM,mBAAmB,OAAO,CAAC;AAGxC,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAGjD,eAAO,MAAM,mBAAmB,0BAA2B,CAAC;AAC5D,MAAM,MAAM,gBAAgB,GAAG,CAAC,OAAO,mBAAmB,CAAC,CAAC,MAAM,CAAC,CAAC;AACpE,eAAO,MAAM,YAAY,KAAK,CAAC;AAG/B,eAAO,MAAM,gBAAgB,QAAoB,CAAC;AAClD,eAAO,MAAM,kBAAkB,SAAU,CAAC;AAC1C,eAAO,MAAM,yBAAyB,QAAQ,CAAC;AAC/C,eAAO,MAAM,8BAA8B,OAAO,CAAC;AACnD,eAAO,MAAM,+BAA+B,MAAM,CAAC;AACnD,eAAO,MAAM,0BAA0B,QAAS,CAAC;AACjD,eAAO,MAAM,wBAAwB,MAAM,CAAC;AAC5C,eAAO,MAAM,uBAAuB,MAAM,CAAC;AAC3C,eAAO,MAAM,kBAAkB,sDAAuD,CAAC;AACvF,MAAM,MAAM,SAAS,GAAG,CAAC,OAAO,kBAAkB,CAAC,CAAC,MAAM,CAAC,CAAC;AAC5D,eAAO,MAAM,yBAAyB,8BAA+B,CAAC;AAGtE,eAAO,MAAM,yBAAyB,MAAM,CAAC;AAC7C,eAAO,MAAM,0BAA0B,OAAO,CAAC;AAC/C,eAAO,MAAM,0BAA0B,QAAS,CAAC;AAGjD,eAAO,MAAM,gBAAgB,YAAc,CAAC;AAC5C,eAAO,MAAM,uBAAuB,UAAY,CAAC;AACjD,eAAO,MAAM,qBAAqB,UAAY,CAAC;AAG/C,eAAO,MAAM,kBAAkB,WAAa,CAAC;AAC7C,eAAO,MAAM,iBAAiB,MAAM,CAAC"}

package/dist/constants.js

@@ -1,4 +1,4 @@
-export const VISION_MODELS = ["claude", "openai", "gemini", "gemini3"];
+export const VISION_MODELS = ["claude", "openai", "gemini3", "gemini"];
 export const MODEL_CONFIGS = {
     claude: {
         defaultTileSize: 1092,
@@ -49,7 +49,31 @@ export const MAX_BASE64_LENGTH = 67_108_864; // ~50MB decoded (base64 is ~4/3x)
 export const MAX_DATA_URL_LENGTH = MAX_BASE64_LENGTH + 256; // base64 payload + data URL prefix overhead
 // Remainder absorption: if a remainder strip is < 15% of tileSize, absorb it into the last tile
 export const MIN_REMAINDER_RATIO = 0.15;
-// Intent and budget enums for recommend-settings
-export const IMAGE_INTENTS = ["text_heavy", "ui_screenshot", "diagram", "photo", "general"];
-export const BUDGET_LEVELS = ["low", "default", "max_detail"];
+// Sharp operation timeout (guards against hangs on corrupted images)
+export const SHARP_OPERATION_TIMEOUT_MS = 30_000; // 30 seconds
+// Tile output formats
+export const TILE_OUTPUT_FORMATS = ["png", "webp"];
+export const WEBP_QUALITY = 80;
+// URL capture
+export const MAX_STITCH_BYTES = 500 * 1024 * 1024; // 500 MB cumulative buffer limit for scroll-stitching
+export const MAX_CAPTURE_HEIGHT = 200_000; // max page height for scroll-stitching (~12 segments)
+export const CHROME_MAX_CAPTURE_HEIGHT = 16384;
+export const CAPTURE_DEFAULT_VIEWPORT_WIDTH = 1280;
+export const CAPTURE_DEFAULT_VIEWPORT_HEIGHT = 800;
+export const CAPTURE_DEFAULT_TIMEOUT_MS = 60_000;
+export const CAPTURE_STITCH_SETTLE_MS = 100;
+export const CAPTURE_IDLE_TIMEOUT_MS = 500;
+export const WAIT_UNTIL_OPTIONS = ["load", "networkidle", "domcontentloaded"];
+export const ALLOWED_CAPTURE_PROTOCOLS = ["https:", "http:"];
+// Lazy loading
+export const LAZY_LOAD_SCROLL_PAUSE_MS = 100;
+export const LAZY_LOAD_IMAGE_TIMEOUT_MS = 5000;
+export const LAZY_LOAD_TOTAL_TIMEOUT_MS = 15_000;
+// Security limits
+export const MAX_IMAGE_PIXELS = 256_000_000; // 256 megapixels (~1GB decoded RGBA)
+export const MAX_CHROME_STDERR_BYTES = 1_048_576; // 1MB
+export const MAX_CHROME_JSON_BYTES = 1_048_576; // 1MB
+// Preview rendering
+export const MAX_PREVIEW_PIXELS = 16_000_000; // Safari's canvas/image rendering limit
+export const MIN_PREVIEW_WIDTH = 800; // Floor that prevents tall-image width crushing
 //# sourceMappingURL=constants.js.map

package/dist/constants.js.map

@@ -1 +1 @@
-{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,SAAS,CAAU,CAAC;AAWhF,MAAM,CAAC,MAAM,aAAa,GAA2C;IACnE,MAAM,EAAE;QACN,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;QACnB,KAAK,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE;QACN,eAAe,EAAE,GAAG;QACpB,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,GAAG;QAClB,KAAK,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE;QACN,eAAe,EAAE,GAAG;QACpB,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,GAAG;QAChB,aAAa,EAAE,GAAG;QAClB,KAAK,EAAE,QAAQ;KAChB;IACD,OAAO,EAAE;QACP,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;QACnB,KAAK,EAAE,UAAU;KAClB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAgB,QAAQ,CAAC;AAEnD,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,eAAe,CAAC;AACtE,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC;AAC9D,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC;AACxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C,0BAA0B;AAC1B,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,CAAC,aAAa;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,CAAU,CAAC;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC,CAAC,kCAAkC;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,GAAG,GAAG,CAAC,CAAC,4CAA4C;AAExG,gGAAgG;AAChG,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,iDAAiD;AACjD,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,YAAY,EAAE,eAAe,EAAE,SAAS,EAAE,OAAO,EAAE,SAAS,CAAU,CAAC;AAGrG,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,KAAK,EAAE,SAAS,EAAE,YAAY,CAAU,CAAC"}
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../src/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,QAAQ,EAAE,QAAQ,EAAE,SAAS,EAAE,QAAQ,CAAU,CAAC;AAWhF,MAAM,CAAC,MAAM,aAAa,GAA2C;IACnE,MAAM,EAAE;QACN,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;QACnB,KAAK,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE;QACN,eAAe,EAAE,GAAG;QACpB,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,GAAG;QAClB,KAAK,EAAE,QAAQ;KAChB;IACD,MAAM,EAAE;QACN,eAAe,EAAE,GAAG;QACpB,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,GAAG;QAChB,aAAa,EAAE,GAAG;QAClB,KAAK,EAAE,QAAQ;KAChB;IACD,OAAO,EAAE;QACP,eAAe,EAAE,IAAI;QACrB,WAAW,EAAE,GAAG;QAChB,WAAW,EAAE,IAAI;QACjB,aAAa,EAAE,IAAI;QACnB,KAAK,EAAE,UAAU;KAClB;CACF,CAAC;AAEF,MAAM,CAAC,MAAM,aAAa,GAAgB,QAAQ,CAAC;AAEnD,uDAAuD;AACvD,MAAM,CAAC,MAAM,iBAAiB,GAAG,aAAa,CAAC,MAAM,CAAC,eAAe,CAAC;AACtE,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC;AAC9D,MAAM,CAAC,MAAM,aAAa,GAAG,aAAa,CAAC,MAAM,CAAC,WAAW,CAAC;AAC9D,MAAM,CAAC,MAAM,eAAe,GAAG,aAAa,CAAC,MAAM,CAAC,aAAa,CAAC;AAElE,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,CAAC;AACzC,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,CAAC;AACrC,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,CAAC;AACrC,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,MAAM,EAAE,KAAK,CAAU,CAAC;AACxF,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,CAAC;AACvC,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,CAAC;AAE3C,0BAA0B;AAC1B,MAAM,CAAC,MAAM,uBAAuB,GAAG,EAAE,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,QAAQ;AACjE,MAAM,CAAC,MAAM,mBAAmB,GAAG,MAAM,CAAC,CAAC,aAAa;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,CAAC,QAAQ,CAAU,CAAC;AACzD,MAAM,CAAC,MAAM,iBAAiB,GAAG,UAAU,CAAC,CAAC,kCAAkC;AAC/E,MAAM,CAAC,MAAM,mBAAmB,GAAG,iBAAiB,GAAG,GAAG,CAAC,CAAC,4CAA4C;AAExG,gGAAgG;AAChG,MAAM,CAAC,MAAM,mBAAmB,GAAG,IAAI,CAAC;AAExC,qEAAqE;AACrE,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC,CAAC,aAAa;AAE/D,sBAAsB;AACtB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,KAAK,EAAE,MAAM,CAAU,CAAC;AAE5D,MAAM,CAAC,MAAM,YAAY,GAAG,EAAE,CAAC;AAE/B,cAAc;AACd,MAAM,CAAC,MAAM,gBAAgB,GAAG,GAAG,GAAG,IAAI,GAAG,IAAI,CAAC,CAAC,sDAAsD;AACzG,MAAM,CAAC,MAAM,kBAAkB,GAAG,OAAO,CAAC,CAAC,sDAAsD;AACjG,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,CAAC;AAC/C,MAAM,CAAC,MAAM,8BAA8B,GAAG,IAAI,CAAC;AACnD,MAAM,CAAC,MAAM,+BAA+B,GAAG,GAAG,CAAC;AACnD,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AACjD,MAAM,CAAC,MAAM,wBAAwB,GAAG,GAAG,CAAC;AAC5C,MAAM,CAAC,MAAM,uBAAuB,GAAG,GAAG,CAAC;AAC3C,MAAM,CAAC,MAAM,kBAAkB,GAAG,CAAC,MAAM,EAAE,aAAa,EAAE,kBAAkB,CAAU,CAAC;AAEvF,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC,QAAQ,EAAE,OAAO,CAAU,CAAC;AAEtE,eAAe;AACf,MAAM,CAAC,MAAM,yBAAyB,GAAG,GAAG,CAAC;AAC7C,MAAM,CAAC,MAAM,0BAA0B,GAAG,IAAI,CAAC;AAC/C,MAAM,CAAC,MAAM,0BAA0B,GAAG,MAAM,CAAC;AAEjD,kBAAkB;AAClB,MAAM,CAAC,MAAM,gBAAgB,GAAG,WAAW,CAAC,CAAC,qCAAqC;AAClF,MAAM,CAAC,MAAM,uBAAuB,GAAG,SAAS,CAAC,CAAC,MAAM;AACxD,MAAM,CAAC,MAAM,qBAAqB,GAAG,SAAS,CAAC,CAAC,MAAM;AAEtD,oBAAoB;AACpB,MAAM,CAAC,MAAM,kBAAkB,GAAG,UAAU,CAAC,CAAC,wCAAwC;AACtF,MAAM,CAAC,MAAM,iBAAiB,GAAG,GAAG,CAAC,CAAC,gDAAgD"}

package/dist/index.js

@@ -2,20 +2,33 @@
 import { createRequire } from "node:module";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
-import { registerTileImageTool } from "./tools/tile-image.js";
-import { registerGetTilesTool } from "./tools/get-tiles.js";
-import { registerRecommendSettingsTool } from "./tools/recommend-settings.js";
-import { registerPrepareImageTool } from "./tools/prepare-image.js";
+import { registerTilerTool } from "./tools/tiler.js";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
+const args = process.argv.slice(2);
+if (args.includes("--version") || args.includes("-v")) {
+    console.log(version);
+    process.exit(0);
+}
+if (args.includes("--help") || args.includes("-h")) {
+    console.log(`image-tiler-mcp-server v${version}
+
+MCP server that splits large images into optimally-sized tiles for LLM vision.
+Runs on stdio transport — designed to be launched by an MCP client.
+
+Usage:
+  image-tiler-mcp-server            Start the MCP server (stdio)
+  image-tiler-mcp-server --version  Print version and exit
+  image-tiler-mcp-server --help     Print this help and exit
+
+More info: https://github.com/keiver/image-tiler-mcp-server`);
+    process.exit(0);
+}
 const server = new McpServer({
     name: "image-tiler-mcp-server",
     version,
 });
-registerTileImageTool(server);
-registerGetTilesTool(server);
-registerRecommendSettingsTool(server);
-registerPrepareImageTool(server);
+registerTilerTool(server);
 async function runStdio() {
     const transport = new StdioServerTransport();
     await server.connect(transport);
@@ -27,6 +40,14 @@ async function shutdown() {
 }
 process.on("SIGINT", shutdown);
 process.on("SIGTERM", shutdown);
+process.on("uncaughtException", (error) => {
+    console.error("Uncaught exception:", error);
+    shutdown().catch(() => process.exit(1));
+});
+process.on("unhandledRejection", (reason) => {
+    console.error("Unhandled rejection:", reason);
+    shutdown().catch(() => process.exit(1));
+});
 runStdio().catch((error) => {
     console.error("Server error:", error);
     process.exit(1);

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,qBAAqB,EAAE,MAAM,uBAAuB,CAAC;AAC9D,OAAO,EAAE,oBAAoB,EAAE,MAAM,sBAAsB,CAAC;AAC5D,OAAO,EAAE,6BAA6B,EAAE,MAAM,+BAA+B,CAAC;AAC9E,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,wBAAwB;IAC9B,OAAO;CACR,CAAC,CAAC;AAEH,qBAAqB,CAAC,MAAM,CAAC,CAAC;AAC9B,oBAAoB,CAAC,MAAM,CAAC,CAAC;AAC7B,6BAA6B,CAAC,MAAM,CAAC,CAAC;AACtC,wBAAwB,CAAC,MAAM,CAAC,CAAC;AAEjC,KAAK,UAAU,QAAQ;IACrB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEhC,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAClC,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAC5C,OAAO,EAAE,SAAS,EAAE,MAAM,yCAAyC,CAAC;AACpE,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,iBAAiB,EAAE,MAAM,kBAAkB,CAAC;AAErD,MAAM,OAAO,GAAG,aAAa,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAC/C,MAAM,EAAE,OAAO,EAAE,GAAG,OAAO,CAAC,iBAAiB,CAAwB,CAAC;AAEtE,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAEnC,IAAI,IAAI,CAAC,QAAQ,CAAC,WAAW,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACtD,OAAO,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,IAAI,IAAI,CAAC,QAAQ,CAAC,QAAQ,CAAC,IAAI,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,EAAE,CAAC;IACnD,OAAO,CAAC,GAAG,CAAC,2BAA2B,OAAO;;;;;;;;;;4DAUY,CAAC,CAAC;IAC5D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;IAC3B,IAAI,EAAE,wBAAwB;IAC9B,OAAO;CACR,CAAC,CAAC;AAEH,iBAAiB,CAAC,MAAM,CAAC,CAAC;AAE1B,KAAK,UAAU,QAAQ;IACrB,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAChC,OAAO,CAAC,KAAK,CAAC,yCAAyC,CAAC,CAAC;AAC3D,CAAC;AAED,KAAK,UAAU,QAAQ;IACrB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;IACrB,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC;AAED,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,QAAQ,CAAC,CAAC;AAC/B,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,QAAQ,CAAC,CAAC;AAEhC,OAAO,CAAC,EAAE,CAAC,mBAAmB,EAAE,CAAC,KAAY,EAAE,EAAE;IAC/C,OAAO,CAAC,KAAK,CAAC,qBAAqB,EAAE,KAAK,CAAC,CAAC;IAC5C,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,OAAO,CAAC,EAAE,CAAC,oBAAoB,EAAE,CAAC,MAAe,EAAE,EAAE;IACnD,OAAO,CAAC,KAAK,CAAC,sBAAsB,EAAE,MAAM,CAAC,CAAC;IAC9C,QAAQ,EAAE,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AAC1C,CAAC,CAAC,CAAC;AAEH,QAAQ,EAAE,CAAC,KAAK,CAAC,CAAC,KAAc,EAAE,EAAE;IAClC,OAAO,CAAC,KAAK,CAAC,eAAe,EAAE,KAAK,CAAC,CAAC;IACtC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/schemas/index.d.ts

@@ -1,45 +1,23 @@
 import { z } from "zod";
-export declare const imageSourceFields: {
+export declare const TilerInputSchema: {
     filePath: z.ZodOptional<z.ZodString>;
     sourceUrl: z.ZodOptional<z.ZodString>;
     dataUrl: z.ZodOptional<z.ZodString>;
     imageBase64: z.ZodOptional<z.ZodString>;
-};
-export declare const TileImageInputSchema: {
-    model: z.ZodDefault<z.ZodEnum<["claude", "openai", "gemini", "gemini3"]>>;
-    tileSize: z.ZodOptional<z.ZodNumber>;
-    maxDimension: z.ZodDefault<z.ZodNumber>;
-    outputDir: z.ZodOptional<z.ZodString>;
-    filePath: z.ZodOptional<z.ZodString>;
-    sourceUrl: z.ZodOptional<z.ZodString>;
-    dataUrl: z.ZodOptional<z.ZodString>;
-    imageBase64: z.ZodOptional<z.ZodString>;
-};
-export declare const GetTilesInputSchema: {
-    tilesDir: z.ZodString;
+    url: z.ZodOptional<z.ZodString>;
+    viewportWidth: z.ZodOptional<z.ZodNumber>;
+    waitUntil: z.ZodDefault<z.ZodEnum<["load", "networkidle", "domcontentloaded"]>>;
+    delay: z.ZodDefault<z.ZodNumber>;
+    screenshotPath: z.ZodOptional<z.ZodString>;
+    tilesDir: z.ZodOptional<z.ZodString>;
     start: z.ZodDefault<z.ZodNumber>;
     end: z.ZodOptional<z.ZodNumber>;
-};
-export declare const RecommendSettingsInputSchema: {
-    model: z.ZodOptional<z.ZodEnum<["claude", "openai", "gemini", "gemini3"]>>;
+    model: z.ZodOptional<z.ZodEnum<["claude", "openai", "gemini3", "gemini"]>>;
     tileSize: z.ZodOptional<z.ZodNumber>;
-    maxDimension: z.ZodOptional<z.ZodNumber>;
-    intent: z.ZodOptional<z.ZodEnum<["text_heavy", "ui_screenshot", "diagram", "photo", "general"]>>;
-    budget: z.ZodOptional<z.ZodEnum<["low", "default", "max_detail"]>>;
-    filePath: z.ZodOptional<z.ZodString>;
-    sourceUrl: z.ZodOptional<z.ZodString>;
-    dataUrl: z.ZodOptional<z.ZodString>;
-    imageBase64: z.ZodOptional<z.ZodString>;
-};
-export declare const PrepareImageInputSchema: {
-    model: z.ZodDefault<z.ZodEnum<["claude", "openai", "gemini", "gemini3"]>>;
-    tileSize: z.ZodOptional<z.ZodNumber>;
-    maxDimension: z.ZodDefault<z.ZodNumber>;
+    maxDimension: z.ZodEffects<z.ZodDefault<z.ZodNumber>, number, number | undefined>;
     outputDir: z.ZodOptional<z.ZodString>;
     page: z.ZodDefault<z.ZodNumber>;
-    filePath: z.ZodOptional<z.ZodString>;
-    sourceUrl: z.ZodOptional<z.ZodString>;
-    dataUrl: z.ZodOptional<z.ZodString>;
-    imageBase64: z.ZodOptional<z.ZodString>;
+    format: z.ZodDefault<z.ZodEnum<["png", "webp"]>>;
+    includeMetadata: z.ZodDefault<z.ZodBoolean>;
 };
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAuBxB,eAAO,MAAM,iBAAiB;;;;;CAqB7B,CAAC;AAEF,eAAO,MAAM,oBAAoB;;;;;;;;;CAmChC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;CAqB/B,CAAC;AAEF,eAAO,MAAM,4BAA4B;;;;;;;;;;CA8BxC,CAAC;AAEF,eAAO,MAAM,uBAAuB;;;;;;;;;;CAoCnC,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAqBxB,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;CAmI5B,CAAC"}