image-tiler-mcp-server 1.2.0 → 1.6.0

package/README.md

@@ -3,10 +3,10 @@
 Split large images into optimally-sized tiles so LLM vision models see every detail — no downscaling, no lost text.
 
 <p align="center">
-  <img src="assets/preview.webp" alt="Preview of image tiling grid for veguitas.com" width="100%" />
+  <img src="assets/preview.gif" alt="Preview of image tiling grid with advised vision models size and token estimates" width="100%" />
 </p>
 
-## Why tiling matters
+## 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.
 
@@ -20,7 +20,7 @@ LLM vision systems have a **maximum input resolution**. When you send an image l
 
 Each tile is processed at **full resolution** — no downscaling — preserving text, UI elements, and fine detail across the entire image.
 
-See [sample of generated tiles here.](https://github.com/keiver/image-tiler-mcp-server/tree/main/assets/tiles/)
+**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.
 
 ### Supported Models
 
@@ -43,11 +43,17 @@ Splits a large image into tiles and saves them to disk.
 
 | Parameter | Type | Required | Default | Description |
 |---|---|---|---|---|
-| `filePath` | string | yes | — | Absolute or relative path to the image file |
+| `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 |
 
+*At least one image source (`filePath`, `sourceUrl`, `dataUrl`, or `imageBase64`) is required.
+
 Returns JSON metadata with grid dimensions, tile count, model used, estimated token cost, and per-tile file paths.
 
 ### `tiler_get_tiles`
@@ -62,6 +68,46 @@ Returns tile images as base64 in batches of 5 for the LLM to see directly.
 
 Returns text labels + image content blocks. Includes pagination hint for the next batch.
 
+### `tiler_recommend_settings`
+
+Dry-run estimator: reads image dimensions and returns cost estimates **without tiling**.
+
+| 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.
+
+### `tiler_prepare_image`
+
+One-shot convenience tool: tiles an image AND returns the first batch of tiles in a single call.
+
+| 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.
+
 ## Installation
 
 ### Claude Code
@@ -179,6 +225,77 @@ Claude will:
 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
+
+Claude 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
+
+Claude 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?
+
+Claude 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
+
+Claude 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
+→ tiler_tile_image(sourceUrl="https://example.com/screenshot.png")
+
+> Tile this base64 image
+→ 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
+
+Claude 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 full-page screenshot with your browser extension
@@ -250,10 +367,19 @@ assets/tiles/landscape/
     { "index": 1, "row": 0, "col": 1, "position": "1092,0", "dimensions": "1092×1092", "filePath": "/path/to/assets/tiles/landscape/tile_000_001.png" },
     "... 30 more tiles"
   ],
-  "previewPath": "/path/to/assets/tiles/landscape/preview.html"
+  "previewPath": "/path/to/assets/tiles/landscape/preview.html",
+  "resize": {
+    "originalWidth": 7680,
+    "originalHeight": 4032,
+    "resizedWidth": 2048,
+    "resizedHeight": 1076,
+    "scaleFactor": 0.267
+  }
 }
 ```
 
+> The `resize` field is only present when `maxDimension` triggered an actual downscale. If the image was already within bounds, it's omitted.
+
 ### Portrait example
 
 `assets/portrait.png` (3600x22810) tiled with Claude defaults produces a 4x21 grid of 84 tiles (~133,560 tokens).
@@ -339,9 +465,13 @@ PNG, JPEG, WebP, TIFF, GIF
 
 ## Security
 
-This is a **local MCP server** that runs on your machine via stdio. It operates with the same filesystem permissions as the MCP client process that spawns it. File paths provided to the tools are resolved and accessed directly — there is no sandboxing or path restriction beyond your OS-level permissions.
+This is a **local MCP server** designed to run on your machine via stdio. It operates with the same filesystem permissions as the MCP client process that spawns it.
+
+**Trust model:** This server trusts its MCP client. Path parameters (`filePath`, `outputDir`, `tilesDir`) are resolved and accessed directly — there is no sandboxing or path restriction beyond your OS-level permissions. This is expected for local MCP tools where the client (e.g. Claude Code) already has filesystem access.
+
+**URL downloads:** When using `sourceUrl`, the server fetches images over HTTPS only (no HTTP). Downloads are limited to 50MB with a 30-second timeout. Content-Type is validated — non-image responses (text/html, application/json, etc.) are rejected with a clear error. Downloaded files are written to a temp directory and cleaned up after processing. The server does not send any data externally — it only receives. No private/internal IP validation is performed on URLs.
 
-This is by design: MCP tools run in the user's security context, same as any CLI tool. No network access, no remote connections, no data sent externally.
+**If deploying remotely:** This server is not designed for multi-tenant or network-exposed environments. If you expose it beyond local stdio, you should add path validation (restrict to allowed directories), SSRF protection (block private IP ranges like 127.0.0.0/8, 10.0.0.0/8, 169.254.169.254), and authentication.
 
 ## Requirements
 

package/dist/constants.d.ts

@@ -18,4 +18,15 @@ export declare const MAX_TOTAL_TILES = 10000;
 export declare const MAX_TILES_PER_BATCH = 5;
 export declare const SUPPORTED_FORMATS: readonly ["png", "jpeg", "jpg", "webp", "tiff", "gif"];
 export declare const PNG_COMPRESSION_LEVEL = 6;
+export declare const DEFAULT_MAX_DIMENSION = 10000;
+export declare const MAX_DOWNLOAD_SIZE_BYTES: number;
+export declare const DOWNLOAD_TIMEOUT_MS = 30000;
+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];
 //# 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"}
+{"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"}

package/dist/constants.js

@@ -40,4 +40,16 @@ export const MAX_TOTAL_TILES = 10000;
 export const MAX_TILES_PER_BATCH = 5;
 export const SUPPORTED_FORMATS = ["png", "jpeg", "jpg", "webp", "tiff", "gif"];
 export const PNG_COMPRESSION_LEVEL = 6;
+export const DEFAULT_MAX_DIMENSION = 10000;
+// Image source resolution
+export const MAX_DOWNLOAD_SIZE_BYTES = 50 * 1024 * 1024; // 50 MB
+export const DOWNLOAD_TIMEOUT_MS = 30_000; // 30 seconds
+export const ALLOWED_URL_PROTOCOLS = ["https:"];
+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"];
 //# 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"}
+{"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"}

package/dist/index.js

@@ -4,6 +4,8 @@ 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";
 const require = createRequire(import.meta.url);
 const { version } = require("../package.json");
 const server = new McpServer({
@@ -12,6 +14,8 @@ const server = new McpServer({
 });
 registerTileImageTool(server);
 registerGetTilesTool(server);
+registerRecommendSettingsTool(server);
+registerPrepareImageTool(server);
 async function runStdio() {
     const transport = new StdioServerTransport();
     await server.connect(transport);

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;AAE5D,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;AAE7B,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,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"}

package/dist/schemas/index.d.ts

@@ -1,13 +1,45 @@
 import { z } from "zod";
+export declare const imageSourceFields: {
+    filePath: z.ZodOptional<z.ZodString>;
+    sourceUrl: z.ZodOptional<z.ZodString>;
+    dataUrl: z.ZodOptional<z.ZodString>;
+    imageBase64: z.ZodOptional<z.ZodString>;
+};
 export declare const TileImageInputSchema: {
-    filePath: z.ZodString;
     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;
     start: z.ZodDefault<z.ZodNumber>;
     end: z.ZodOptional<z.ZodNumber>;
 };
+export declare const RecommendSettingsInputSchema: {
+    model: z.ZodOptional<z.ZodEnum<["claude", "openai", "gemini", "gemini3"]>>;
+    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>;
+    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>;
+};
 //# 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;AAiBxB,eAAO,MAAM,oBAAoB;;;;;CA6BhC,CAAC;AAEF,eAAO,MAAM,mBAAmB;;;;CAqB/B,CAAC"}
+{"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"}

package/dist/schemas/index.js

@@ -1,12 +1,32 @@
 import { z } from "zod";
-import { MAX_IMAGE_DIMENSION, MAX_TILES_PER_BATCH, VISION_MODELS, DEFAULT_MODEL, MODEL_CONFIGS, } from "../constants.js";
+import { MAX_IMAGE_DIMENSION, MAX_TILES_PER_BATCH, VISION_MODELS, DEFAULT_MODEL, MODEL_CONFIGS, DEFAULT_MAX_DIMENSION, MAX_BASE64_LENGTH, MAX_DATA_URL_LENGTH, IMAGE_INTENTS, BUDGET_LEVELS, } from "../constants.js";
 const modelDescriptions = VISION_MODELS.map((m) => `"${m}" (${MODEL_CONFIGS[m].defaultTileSize}px tiles, ~${MODEL_CONFIGS[m].tokensPerTile} tokens/tile)`).join(", ");
 const defaultDescriptions = VISION_MODELS.map((m) => `${MODEL_CONFIGS[m].label}: ${MODEL_CONFIGS[m].defaultTileSize}`).join(", ");
-export const TileImageInputSchema = {
+// Shared image source fields — used by tile-image, recommend-settings, and prepare-image
+export const imageSourceFields = {
     filePath: z
         .string()
         .min(1, "File path cannot be empty")
-        .describe("Absolute or relative path to the image file to tile"),
+        .optional()
+        .describe("Absolute or relative path to the image file"),
+    sourceUrl: z
+        .string()
+        .url("Must be a valid URL")
+        .optional()
+        .describe("HTTPS URL to download the image from (max 50MB, 30s timeout)"),
+    dataUrl: z
+        .string()
+        .max(MAX_DATA_URL_LENGTH, `Data URL must not exceed ${MAX_DATA_URL_LENGTH} characters`)
+        .optional()
+        .describe('Data URL with base64-encoded image (e.g. "data:image/png;base64,...")'),
+    imageBase64: z
+        .string()
+        .max(MAX_BASE64_LENGTH, `Base64 string must not exceed ${MAX_BASE64_LENGTH} characters`)
+        .optional()
+        .describe("Raw base64-encoded image data (no data URL prefix)"),
+};
+export const TileImageInputSchema = {
+    ...imageSourceFields,
     model: z
         .enum(VISION_MODELS)
         .default(DEFAULT_MODEL)
@@ -18,6 +38,13 @@ export const TileImageInputSchema = {
         .max(MAX_IMAGE_DIMENSION, `Tile size must not exceed ${MAX_IMAGE_DIMENSION}px`)
         .optional()
         .describe(`Tile size in pixels. If omitted, uses the model's optimal default (${defaultDescriptions}). Values outside the model's supported range are automatically clamped with a warning.`),
+    maxDimension: z
+        .number()
+        .int()
+        .min(0, "maxDimension must be >= 0 (0 disables auto-downscaling)")
+        .max(MAX_IMAGE_DIMENSION, `maxDimension must not exceed ${MAX_IMAGE_DIMENSION}px`)
+        .default(DEFAULT_MAX_DIMENSION)
+        .describe(`Max dimension in px (256-${MAX_IMAGE_DIMENSION}). When set, the image is resized so its longest side fits within this value before tiling. Reduces token consumption for large images. Defaults to ${DEFAULT_MAX_DIMENSION}px. Set to 0 to disable auto-downscaling.`),
     outputDir: z
         .string()
         .optional()
@@ -41,4 +68,64 @@ export const GetTilesInputSchema = {
         .optional()
         .describe(`End tile index (0-based, inclusive). Defaults to start + ${MAX_TILES_PER_BATCH - 1}. Max ${MAX_TILES_PER_BATCH} tiles per batch to stay within MCP response limits`),
 };
+export const RecommendSettingsInputSchema = {
+    ...imageSourceFields,
+    model: z
+        .enum(VISION_MODELS)
+        .optional()
+        .describe(`Target vision model. If omitted, recommendations use the default ("${DEFAULT_MODEL}") but all-model comparison is always returned.`),
+    tileSize: z
+        .number()
+        .int()
+        .min(1, "Tile size must be a positive integer")
+        .max(MAX_IMAGE_DIMENSION, `Tile size must not exceed ${MAX_IMAGE_DIMENSION}px`)
+        .optional()
+        .describe("Override tile size. If provided, skips tile-size heuristics."),
+    maxDimension: z
+        .number()
+        .int()
+        .min(0, "maxDimension must be >= 0 (0 disables auto-downscaling)")
+        .max(MAX_IMAGE_DIMENSION, `maxDimension must not exceed ${MAX_IMAGE_DIMENSION}px`)
+        .optional()
+        .describe("Override max dimension. If provided, skips maxDimension heuristics."),
+    intent: z
+        .enum(IMAGE_INTENTS)
+        .optional()
+        .describe('Image intent hint: "text_heavy", "ui_screenshot", "diagram", "photo", or "general". Affects heuristic recommendations.'),
+    budget: z
+        .enum(BUDGET_LEVELS)
+        .optional()
+        .describe('Token budget preference: "low" (fewer tokens), "default", or "max_detail" (preserve all detail).'),
+};
+export const PrepareImageInputSchema = {
+    ...imageSourceFields,
+    model: z
+        .enum(VISION_MODELS)
+        .default(DEFAULT_MODEL)
+        .describe(`Target vision model: ${modelDescriptions}. Default: "${DEFAULT_MODEL}"`),
+    tileSize: z
+        .number()
+        .int()
+        .min(1, "Tile size must be a positive integer")
+        .max(MAX_IMAGE_DIMENSION, `Tile size must not exceed ${MAX_IMAGE_DIMENSION}px`)
+        .optional()
+        .describe(`Tile size in pixels. If omitted, uses the model's optimal default (${defaultDescriptions}).`),
+    maxDimension: z
+        .number()
+        .int()
+        .min(0, "maxDimension must be >= 0 (0 disables auto-downscaling)")
+        .max(MAX_IMAGE_DIMENSION, `maxDimension must not exceed ${MAX_IMAGE_DIMENSION}px`)
+        .default(DEFAULT_MAX_DIMENSION)
+        .describe(`Max dimension in px. Defaults to ${DEFAULT_MAX_DIMENSION}px. Set to 0 to disable.`),
+    outputDir: z
+        .string()
+        .optional()
+        .describe("Directory to save tiles. Defaults to a 'tiles' subfolder next to the source image"),
+    page: z
+        .number()
+        .int()
+        .min(0, "Page must be >= 0")
+        .default(0)
+        .describe("Tile page to return (0 = first 5, 1 = next 5, etc.). Default: 0"),
+};
 //# sourceMappingURL=index.js.map

package/dist/schemas/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,MAAM,iBAAiB,GAAG,aAAa,CAAC,GAAG,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,CAAC,eAAe,cAAc,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,eAAe,CAC9G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,mBAAmB,GAAG,aAAa,CAAC,GAAG,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;SACnC,QAAQ,CAAC,qDAAqD,CAAC;IAClE,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,aAAa,CAAC;SACnB,OAAO,CAAC,aAAa,CAAC;SACtB,QAAQ,CACP,wBAAwB,iBAAiB,eAAe,aAAa,GAAG,CACzE;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;SAC9C,GAAG,CACF,mBAAmB,EACnB,6BAA6B,mBAAmB,IAAI,CACrD;SACA,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE,mBAAmB,yFAAyF,CACnL;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mFAAmF,CACpF;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;SAC9C,QAAQ,CACP,yEAAyE,CAC1E;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;SAClC,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;SAChC,QAAQ,EAAE;SACV,QAAQ,CACP,4DAA4D,mBAAmB,GAAG,CAAC,SAAS,mBAAmB,qDAAqD,CACrK;CACJ,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/schemas/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EACL,mBAAmB,EACnB,mBAAmB,EACnB,aAAa,EACb,aAAa,EACb,aAAa,EACb,qBAAqB,EACrB,iBAAiB,EACjB,mBAAmB,EACnB,aAAa,EACb,aAAa,GACd,MAAM,iBAAiB,CAAC;AAEzB,MAAM,iBAAiB,GAAG,aAAa,CAAC,GAAG,CACzC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,MAAM,aAAa,CAAC,CAAC,CAAC,CAAC,eAAe,cAAc,aAAa,CAAC,CAAC,CAAC,CAAC,aAAa,eAAe,CAC9G,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,MAAM,mBAAmB,GAAG,aAAa,CAAC,GAAG,CAC3C,CAAC,CAAC,EAAE,EAAE,CAAC,GAAG,aAAa,CAAC,CAAC,CAAC,CAAC,KAAK,KAAK,aAAa,CAAC,CAAC,CAAC,CAAC,eAAe,EAAE,CACxE,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEb,yFAAyF;AACzF,MAAM,CAAC,MAAM,iBAAiB,GAAG;IAC/B,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,2BAA2B,CAAC;SACnC,QAAQ,EAAE;SACV,QAAQ,CAAC,6CAA6C,CAAC;IAC1D,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,GAAG,CAAC,qBAAqB,CAAC;SAC1B,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,OAAO,EAAE,CAAC;SACP,MAAM,EAAE;SACR,GAAG,CAAC,mBAAmB,EAAE,4BAA4B,mBAAmB,aAAa,CAAC;SACtF,QAAQ,EAAE;SACV,QAAQ,CAAC,uEAAuE,CAAC;IACpF,WAAW,EAAE,CAAC;SACX,MAAM,EAAE;SACR,GAAG,CAAC,iBAAiB,EAAE,iCAAiC,iBAAiB,aAAa,CAAC;SACvF,QAAQ,EAAE;SACV,QAAQ,CAAC,oDAAoD,CAAC;CAClE,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG;IAClC,GAAG,iBAAiB;IACpB,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,aAAa,CAAC;SACnB,OAAO,CAAC,aAAa,CAAC;SACtB,QAAQ,CACP,wBAAwB,iBAAiB,eAAe,aAAa,GAAG,CACzE;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;SAC9C,GAAG,CACF,mBAAmB,EACnB,6BAA6B,mBAAmB,IAAI,CACrD;SACA,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE,mBAAmB,yFAAyF,CACnL;IACH,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,yDAAyD,CAAC;SACjE,GAAG,CAAC,mBAAmB,EAAE,gCAAgC,mBAAmB,IAAI,CAAC;SACjF,OAAO,CAAC,qBAAqB,CAAC;SAC9B,QAAQ,CACP,4BAA4B,mBAAmB,uJAAuJ,qBAAqB,2CAA2C,CACvQ;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CACP,mFAAmF,CACpF;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG;IACjC,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;SAC9C,QAAQ,CACP,yEAAyE,CAC1E;IACH,KAAK,EAAE,CAAC;SACL,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,0BAA0B,CAAC;SAClC,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,uCAAuC,CAAC;IACpD,GAAG,EAAE,CAAC;SACH,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,wBAAwB,CAAC;SAChC,QAAQ,EAAE;SACV,QAAQ,CACP,4DAA4D,mBAAmB,GAAG,CAAC,SAAS,mBAAmB,qDAAqD,CACrK;CACJ,CAAC;AAEF,MAAM,CAAC,MAAM,4BAA4B,GAAG;IAC1C,GAAG,iBAAiB;IACpB,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,aAAa,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE,aAAa,iDAAiD,CACrI;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;SAC9C,GAAG,CAAC,mBAAmB,EAAE,6BAA6B,mBAAmB,IAAI,CAAC;SAC9E,QAAQ,EAAE;SACV,QAAQ,CAAC,8DAA8D,CAAC;IAC3E,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,yDAAyD,CAAC;SACjE,GAAG,CAAC,mBAAmB,EAAE,gCAAgC,mBAAmB,IAAI,CAAC;SACjF,QAAQ,EAAE;SACV,QAAQ,CAAC,qEAAqE,CAAC;IAClF,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,aAAa,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CAAC,wHAAwH,CAAC;IACrI,MAAM,EAAE,CAAC;SACN,IAAI,CAAC,aAAa,CAAC;SACnB,QAAQ,EAAE;SACV,QAAQ,CAAC,kGAAkG,CAAC;CAChH,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG;IACrC,GAAG,iBAAiB;IACpB,KAAK,EAAE,CAAC;SACL,IAAI,CAAC,aAAa,CAAC;SACnB,OAAO,CAAC,aAAa,CAAC;SACtB,QAAQ,CACP,wBAAwB,iBAAiB,eAAe,aAAa,GAAG,CACzE;IACH,QAAQ,EAAE,CAAC;SACR,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,sCAAsC,CAAC;SAC9C,GAAG,CAAC,mBAAmB,EAAE,6BAA6B,mBAAmB,IAAI,CAAC;SAC9E,QAAQ,EAAE;SACV,QAAQ,CACP,sEAAsE,mBAAmB,IAAI,CAC9F;IACH,YAAY,EAAE,CAAC;SACZ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,yDAAyD,CAAC;SACjE,GAAG,CAAC,mBAAmB,EAAE,gCAAgC,mBAAmB,IAAI,CAAC;SACjF,OAAO,CAAC,qBAAqB,CAAC;SAC9B,QAAQ,CACP,oCAAoC,qBAAqB,0BAA0B,CACpF;IACH,SAAS,EAAE,CAAC;SACT,MAAM,EAAE;SACR,QAAQ,EAAE;SACV,QAAQ,CAAC,mFAAmF,CAAC;IAChG,IAAI,EAAE,CAAC;SACJ,MAAM,EAAE;SACR,GAAG,EAAE;SACL,GAAG,CAAC,CAAC,EAAE,mBAAmB,CAAC;SAC3B,OAAO,CAAC,CAAC,CAAC;SACV,QAAQ,CAAC,iEAAiE,CAAC;CAC/E,CAAC"}

package/dist/services/image-processor.d.ts

@@ -1,7 +1,9 @@
-import type { ImageMetadata, TileGridInfo, TileImageResult } from "../types.js";
+import type { ImageMetadata, ResizeInfo, TileGridInfo, TileImageResult, ModelEstimate } from "../types.js";
 export declare function getImageMetadata(filePath: string): Promise<ImageMetadata>;
-export declare function calculateGrid(width: number, height: number, tileSize: number, tokensPerTile?: number): TileGridInfo;
-export declare function tileImage(filePath: string, tileSize: number, outputDir: string, tokensPerTile?: number): Promise<TileImageResult>;
+export declare function calculateGrid(width: number, height: number, tileSize: number, tokensPerTile?: number, maxTileSize?: number): TileGridInfo;
+export declare function computeEstimateForModel(modelKey: string, imageWidth: number, imageHeight: number, overrideTileSize?: number, effectiveMaxDimension?: number): ModelEstimate;
+export declare function resizeImage(filePath: string, maxDimension: number, outputPath: string): Promise<ResizeInfo | null>;
+export declare function tileImage(filePath: string, tileSize: number, outputDir: string, tokensPerTile?: number, maxDimension?: number, maxTileSize?: number): Promise<TileImageResult>;
 export declare function readTileAsBase64(tilePath: string): Promise<string>;
 export declare function listTilesInDirectory(tilesDir: string): Promise<string[]>;
 //# sourceMappingURL=image-processor.d.ts.map

package/dist/services/image-processor.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image-processor.d.ts","sourceRoot":"","sources":["../../src/services/image-processor.ts"],"names":[],"mappings":"AASA,OAAO,KAAK,EAAE,aAAa,EAAE,YAAY,EAAY,eAAe,EAAE,MAAM,aAAa,CAAC;AAK1F,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,aAAa,GAAE,MAAwB,GACtC,YAAY,CAYd;AAED,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAwB,GACtC,OAAO,CAAC,eAAe,CAAC,CA4E1B;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxE;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBnB"}
+{"version":3,"file":"image-processor.d.ts","sourceRoot":"","sources":["../../src/services/image-processor.ts"],"names":[],"mappings":"AAYA,OAAO,KAAK,EAAE,aAAa,EAAE,UAAU,EAAE,YAAY,EAAY,eAAe,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKrH,wBAAsB,gBAAgB,CACpC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,aAAa,CAAC,CAwBxB;AAED,wBAAgB,aAAa,CAC3B,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,MAAM,EACd,QAAQ,EAAE,MAAM,EAChB,aAAa,GAAE,MAAwB,EACvC,WAAW,CAAC,EAAE,MAAM,GACnB,YAAY,CA+Bd;AAED,wBAAgB,uBAAuB,CACrC,QAAQ,EAAE,MAAM,EAChB,UAAU,EAAE,MAAM,EAClB,WAAW,EAAE,MAAM,EACnB,gBAAgB,CAAC,EAAE,MAAM,EACzB,qBAAqB,CAAC,EAAE,MAAM,GAC7B,aAAa,CA6Bf;AAED,wBAAsB,WAAW,CAC/B,QAAQ,EAAE,MAAM,EAChB,YAAY,EAAE,MAAM,EACpB,UAAU,EAAE,MAAM,GACjB,OAAO,CAAC,UAAU,GAAG,IAAI,CAAC,CA6B5B;AAED,wBAAsB,SAAS,CAC7B,QAAQ,EAAE,MAAM,EAChB,QAAQ,EAAE,MAAM,EAChB,SAAS,EAAE,MAAM,EACjB,aAAa,GAAE,MAAwB,EACvC,YAAY,CAAC,EAAE,MAAM,EACrB,WAAW,CAAC,EAAE,MAAM,GACnB,OAAO,CAAC,eAAe,CAAC,CAgH1B;AAED,wBAAsB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAGxE;AAED,wBAAsB,oBAAoB,CACxC,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,MAAM,EAAE,CAAC,CAuBnB"}