npm - @meterapp/car-image-sdk - Versions diffs - 1.1.0 → 1.3.0 - Mend

@meterapp/car-image-sdk 1.1.0 → 1.3.0

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.

Files changed (19) hide show

package/dist/mcp/index.d.ts CHANGED Viewed

@@ -13,9 +13,27 @@ import * as z from "zod";
 export declare const MCP_SERVER_INFO: {
     readonly name: "car-image-api";
     readonly title: "Car Image API";
-    readonly version: "1.1.0";
+    readonly version: "1.3.0";
     readonly websiteUrl: "https://carimage.dev";
 };
+/**
+ * Which tools a server exposes. `core` is what an agent needs to find, render
+ * and embed a car; the request board and the two "about you" tools live in
+ * `all`, for hosts that opt in (`?toolset=all` on the remote URL,
+ * `car-image mcp --toolset all` locally). Fewer, sharper tools cost less
+ * context and make the right one easier to pick.
+ */
+export declare const MCP_TOOLSETS: {
+    readonly core: readonly ["get_car_image", "create_car_image_urls", "search_vehicles", "resolve_vehicle", "list_image_options", "get_account", "rate_image", "describe_api"];
+    readonly all: readonly ["get_car_image", "create_car_image_urls", "search_vehicles", "resolve_vehicle", "list_image_options", "get_account", "rate_image", "describe_api", "list_requests", "request_vehicle", "request_feature", "get_request", "upvote_request", "comment_on_request", "share_building", "share_referral"];
+};
+export type McpToolset = keyof typeof MCP_TOOLSETS;
+export declare const DEFAULT_MCP_TOOLSET: McpToolset;
+export declare const MCP_TOOLSET_NAMES: McpToolset[];
+export declare function isMcpToolset(value: unknown): value is McpToolset;
+/** The server instructions for a toolset; `all` includes the request board paragraph. */
+export declare function mcpInstructions(toolset?: McpToolset): string;
+/** Instructions for the full toolset; kept for callers that predate toolsets. */
 export declare const MCP_INSTRUCTIONS: string;
 export declare const imageInputSchema: z.ZodObject<{
     make: z.ZodString;
@@ -54,6 +72,14 @@ export declare const imageInputSchema: z.ZodObject<{
     }>>;
     width: z.ZodOptional<z.ZodNumber>;
     height: z.ZodOptional<z.ZodNumber>;
+    fit: z.ZodOptional<z.ZodEnum<{
+        contain: "contain";
+        cover: "cover";
+        inside: "inside";
+    }>>;
+    background: z.ZodOptional<z.ZodString>;
+    trim: z.ZodOptional<z.ZodBoolean>;
+    padding: z.ZodOptional<z.ZodNumber>;
     format: z.ZodDefault<z.ZodEnum<{
         png: "png";
         webp: "webp";
@@ -99,6 +125,14 @@ export declare const MCP_TOOL_SCHEMAS: {
         }>>;
         width: z.ZodOptional<z.ZodNumber>;
         height: z.ZodOptional<z.ZodNumber>;
+        fit: z.ZodOptional<z.ZodEnum<{
+            contain: "contain";
+            cover: "cover";
+            inside: "inside";
+        }>>;
+        background: z.ZodOptional<z.ZodString>;
+        trim: z.ZodOptional<z.ZodBoolean>;
+        padding: z.ZodOptional<z.ZodNumber>;
         format: z.ZodDefault<z.ZodEnum<{
             png: "png";
             webp: "webp";
@@ -143,6 +177,14 @@ export declare const MCP_TOOL_SCHEMAS: {
             }>>;
             width: z.ZodOptional<z.ZodNumber>;
             height: z.ZodOptional<z.ZodNumber>;
+            fit: z.ZodOptional<z.ZodEnum<{
+                contain: "contain";
+                cover: "cover";
+                inside: "inside";
+            }>>;
+            background: z.ZodOptional<z.ZodString>;
+            trim: z.ZodOptional<z.ZodBoolean>;
+            padding: z.ZodOptional<z.ZodNumber>;
             format: z.ZodDefault<z.ZodEnum<{
                 png: "png";
                 webp: "webp";
@@ -151,6 +193,8 @@ export declare const MCP_TOOL_SCHEMAS: {
         }, z.core.$strip>>;
         ttl_seconds: z.ZodOptional<z.ZodNumber>;
         max_uses: z.ZodOptional<z.ZodNumber>;
+        renew: z.ZodOptional<z.ZodBoolean>;
+        renew_days: z.ZodOptional<z.ZodNumber>;
     }, z.core.$strip>;
     readonly search_vehicles: z.ZodObject<{
         query: z.ZodString;
@@ -264,6 +308,554 @@ export declare const MCP_TOOL_SCHEMAS: {
 };
 export type McpToolName = keyof typeof MCP_TOOL_SCHEMAS;
 export type McpToolInput<N extends McpToolName> = z.infer<(typeof MCP_TOOL_SCHEMAS)[N]>;
+export declare const MCP_TOOL_OUTPUT_SCHEMAS: {
+    readonly get_car_image: z.ZodObject<{
+        credits_charged: z.ZodNullable<z.ZodNumber>;
+        credits_remaining: z.ZodNullable<z.ZodNumber>;
+        source: z.ZodNullable<z.ZodEnum<{
+            cache: "cache";
+            generated: "generated";
+        }>>;
+        width: z.ZodNullable<z.ZodNumber>;
+        height: z.ZodNullable<z.ZodNumber>;
+        content_type: z.ZodString;
+        etag: z.ZodNullable<z.ZodString>;
+        request_id: z.ZodNullable<z.ZodString>;
+        vehicle: z.ZodObject<{
+            make: z.ZodString;
+            model: z.ZodString;
+            year: z.ZodNumber;
+            view: z.ZodEnum<{
+                front: "front";
+                "front-3-4": "front-3-4";
+                side: "side";
+                "side-right": "side-right";
+                rear: "rear";
+                "rear-3-4": "rear-3-4";
+            }>;
+            color: z.ZodEnum<{
+                white: "white";
+                black: "black";
+                gray: "gray";
+                silver: "silver";
+                blue: "blue";
+                red: "red";
+                green: "green";
+                brown: "brown";
+                beige: "beige";
+                tan: "tan";
+                orange: "orange";
+                yellow: "yellow";
+                gold: "gold";
+                burgundy: "burgundy";
+                purple: "purple";
+            }>;
+            width: z.ZodOptional<z.ZodNumber>;
+            height: z.ZodOptional<z.ZodNumber>;
+            fit: z.ZodOptional<z.ZodEnum<{
+                contain: "contain";
+                cover: "cover";
+                inside: "inside";
+            }>>;
+            background: z.ZodOptional<z.ZodString>;
+            trim: z.ZodOptional<z.ZodBoolean>;
+            padding: z.ZodOptional<z.ZodNumber>;
+            format: z.ZodEnum<{
+                png: "png";
+                webp: "webp";
+                jpg: "jpg";
+                auto: "auto";
+            }>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+    readonly create_car_image_urls: z.ZodObject<{
+        data: z.ZodArray<z.ZodObject<{
+            id: z.ZodString;
+            url: z.ZodString;
+            expires_at: z.ZodString;
+            max_uses: z.ZodNumber;
+            renews_until: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            vehicle: z.ZodObject<{
+                make: z.ZodString;
+                model: z.ZodString;
+                year: z.ZodNumber;
+                view: z.ZodEnum<{
+                    front: "front";
+                    "front-3-4": "front-3-4";
+                    side: "side";
+                    "side-right": "side-right";
+                    rear: "rear";
+                    "rear-3-4": "rear-3-4";
+                }>;
+                color: z.ZodEnum<{
+                    white: "white";
+                    black: "black";
+                    gray: "gray";
+                    silver: "silver";
+                    blue: "blue";
+                    red: "red";
+                    green: "green";
+                    brown: "brown";
+                    beige: "beige";
+                    tan: "tan";
+                    orange: "orange";
+                    yellow: "yellow";
+                    gold: "gold";
+                    burgundy: "burgundy";
+                    purple: "purple";
+                }>;
+                width: z.ZodOptional<z.ZodNumber>;
+                height: z.ZodOptional<z.ZodNumber>;
+                fit: z.ZodOptional<z.ZodEnum<{
+                    contain: "contain";
+                    cover: "cover";
+                    inside: "inside";
+                }>>;
+                background: z.ZodOptional<z.ZodString>;
+                trim: z.ZodOptional<z.ZodBoolean>;
+                padding: z.ZodOptional<z.ZodNumber>;
+                format: z.ZodEnum<{
+                    png: "png";
+                    webp: "webp";
+                    jpg: "jpg";
+                    auto: "auto";
+                }>;
+            }, z.core.$loose>;
+        }, z.core.$loose>>;
+        billing: z.ZodObject<{
+            charged_on: z.ZodLiteral<"creation">;
+            credits_charged: z.ZodNumber;
+            credits_remaining: z.ZodNumber;
+            renewal: z.ZodOptional<z.ZodNullable<z.ZodObject<{
+                window_seconds: z.ZodNumber;
+                credits_per_window: z.ZodNumber;
+                until: z.ZodString;
+            }, z.core.$loose>>>;
+        }, z.core.$loose>;
+        request_id: z.ZodString;
+    }, z.core.$loose>;
+    readonly search_vehicles: z.ZodObject<{
+        data: z.ZodObject<{
+            query: z.ZodString;
+            results: z.ZodArray<z.ZodObject<{
+                kind: z.ZodEnum<{
+                    make: "make";
+                    model: "model";
+                }>;
+                make: z.ZodString;
+                make_slug: z.ZodString;
+                model: z.ZodNullable<z.ZodString>;
+                model_slug: z.ZodNullable<z.ZodString>;
+                vehicle_type: z.ZodNullable<z.ZodString>;
+                years: z.ZodArray<z.ZodNumber>;
+                match_kind: z.ZodNullable<z.ZodString>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+    readonly resolve_vehicle: z.ZodObject<{
+        data: z.ZodObject<{
+            params: z.ZodObject<{
+                make: z.ZodString;
+                model: z.ZodString;
+                year: z.ZodNumber;
+                view: z.ZodEnum<{
+                    front: "front";
+                    "front-3-4": "front-3-4";
+                    side: "side";
+                    "side-right": "side-right";
+                    rear: "rear";
+                    "rear-3-4": "rear-3-4";
+                }>;
+                color: z.ZodEnum<{
+                    white: "white";
+                    black: "black";
+                    gray: "gray";
+                    silver: "silver";
+                    blue: "blue";
+                    red: "red";
+                    green: "green";
+                    brown: "brown";
+                    beige: "beige";
+                    tan: "tan";
+                    orange: "orange";
+                    yellow: "yellow";
+                    gold: "gold";
+                    burgundy: "burgundy";
+                    purple: "purple";
+                }>;
+            }, z.core.$loose>;
+            display: z.ZodOptional<z.ZodObject<{
+                make_name: z.ZodString;
+                model_name: z.ZodString;
+            }, z.core.$loose>>;
+            candidates: z.ZodArray<z.ZodObject<{
+                make_name: z.ZodOptional<z.ZodString>;
+                make_slug: z.ZodOptional<z.ZodString>;
+                model_name: z.ZodOptional<z.ZodString>;
+                model_slug: z.ZodOptional<z.ZodString>;
+                years: z.ZodOptional<z.ZodArray<z.ZodNumber>>;
+                match_kind: z.ZodOptional<z.ZodString>;
+            }, z.core.$loose>>;
+            confidence: z.ZodEnum<{
+                medium: "medium";
+                high: "high";
+                low: "low";
+            }>;
+            image_path: z.ZodOptional<z.ZodString>;
+            extracted: z.ZodOptional<z.ZodObject<{}, z.core.$loose>>;
+        }, z.core.$loose>;
+        cli: z.ZodString;
+    }, z.core.$loose>;
+    readonly list_image_options: z.ZodObject<{
+        data: z.ZodObject<{
+            views: z.ZodArray<z.ZodObject<{
+                id: z.ZodEnum<{
+                    front: "front";
+                    "front-3-4": "front-3-4";
+                    side: "side";
+                    "side-right": "side-right";
+                    rear: "rear";
+                    "rear-3-4": "rear-3-4";
+                }>;
+                label: z.ZodString;
+                yaw_degrees: z.ZodNumber;
+                description: z.ZodString;
+                aliases: z.ZodArray<z.ZodString>;
+            }, z.core.$loose>>;
+            colors: z.ZodArray<z.ZodObject<{
+                name: z.ZodEnum<{
+                    white: "white";
+                    black: "black";
+                    gray: "gray";
+                    silver: "silver";
+                    blue: "blue";
+                    red: "red";
+                    green: "green";
+                    brown: "brown";
+                    beige: "beige";
+                    tan: "tan";
+                    orange: "orange";
+                    yellow: "yellow";
+                    gold: "gold";
+                    burgundy: "burgundy";
+                    purple: "purple";
+                }>;
+                hex: z.ZodString;
+            }, z.core.$loose>>;
+            sizes: z.ZodObject<{
+                presets: z.ZodRecord<z.ZodString, z.ZodNumber>;
+                max: z.ZodNumber;
+            }, z.core.$loose>;
+            formats: z.ZodArray<z.ZodEnum<{
+                png: "png";
+                webp: "webp";
+                jpg: "jpg";
+            }>>;
+            pricing: z.ZodObject<{
+                credits_per_image: z.ZodNumber;
+                credits_per_dollar: z.ZodNumber;
+                free_credits: z.ZodOptional<z.ZodNumber>;
+                packs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    credits: z.ZodNumber;
+                    cents: z.ZodNumber;
+                    label: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+            }, z.core.$loose>;
+            catalog: z.ZodObject<{
+                makes: z.ZodNumber;
+                models: z.ZodNumber;
+                years: z.ZodTuple<[z.ZodNumber, z.ZodNumber], null>;
+                sources: z.ZodArray<z.ZodString>;
+            }, z.core.$loose>;
+        }, z.core.$loose>;
+    }, z.core.$loose>;
+    readonly get_account: z.ZodObject<{
+        data: z.ZodObject<{
+            credits: z.ZodNumber;
+            credits_usd: z.ZodNumber;
+            auto_reload: z.ZodBoolean;
+            has_payment_method: z.ZodBoolean;
+            pricing: z.ZodObject<{
+                credits_per_image: z.ZodNumber;
+                credits_per_dollar: z.ZodNumber;
+                free_credits: z.ZodOptional<z.ZodNumber>;
+                packs: z.ZodOptional<z.ZodArray<z.ZodObject<{
+                    credits: z.ZodNumber;
+                    cents: z.ZodNumber;
+                    label: z.ZodOptional<z.ZodString>;
+                }, z.core.$loose>>>;
+            }, z.core.$loose>;
+            key: z.ZodOptional<z.ZodObject<{
+                id: z.ZodOptional<z.ZodString>;
+                scopes: z.ZodArray<z.ZodString>;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+        links: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+        request_id: z.ZodOptional<z.ZodString>;
+    }, z.core.$loose>;
+    readonly rate_image: z.ZodObject<{
+        data: z.ZodObject<{
+            asset_id: z.ZodOptional<z.ZodNullable<z.ZodString>>;
+            flagged: z.ZodBoolean;
+            rating: z.ZodOptional<z.ZodNumber>;
+            verdict: z.ZodOptional<z.ZodEnum<{
+                good: "good";
+                bad: "bad";
+            }>>;
+        }, z.core.$loose>;
+        request_id: z.ZodString;
+    }, z.core.$loose>;
+    readonly list_requests: z.ZodObject<{
+        data: z.ZodArray<z.ZodObject<{
+            comments: z.ZodNumber;
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                vehicle: "vehicle";
+                feature: "feature";
+            }>;
+            title: z.ZodString;
+            body: z.ZodNullable<z.ZodString>;
+            vehicle: z.ZodNullable<z.ZodObject<{
+                make: z.ZodString;
+                model: z.ZodString;
+                year: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$loose>>;
+            status: z.ZodEnum<{
+                open: "open";
+                planned: "planned";
+                in_progress: "in_progress";
+                done: "done";
+                declined: "declined";
+            }>;
+            votes: z.ZodNumber;
+            author: z.ZodString;
+            url: z.ZodString;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+            viewer: z.ZodOptional<z.ZodObject<{
+                voted: z.ZodBoolean;
+            }, z.core.$loose>>;
+        }, z.core.$loose>>;
+        next_cursor: z.ZodNullable<z.ZodString>;
+        request_id: z.ZodString;
+    }, z.core.$loose>;
+    readonly request_vehicle: z.ZodObject<{
+        data: z.ZodObject<{
+            comments: z.ZodNumber;
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                vehicle: "vehicle";
+                feature: "feature";
+            }>;
+            title: z.ZodString;
+            body: z.ZodNullable<z.ZodString>;
+            vehicle: z.ZodNullable<z.ZodObject<{
+                make: z.ZodString;
+                model: z.ZodString;
+                year: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$loose>>;
+            status: z.ZodEnum<{
+                open: "open";
+                planned: "planned";
+                in_progress: "in_progress";
+                done: "done";
+                declined: "declined";
+            }>;
+            votes: z.ZodNumber;
+            author: z.ZodString;
+            url: z.ZodString;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+            viewer: z.ZodOptional<z.ZodObject<{
+                voted: z.ZodBoolean;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+        deduplicated: z.ZodBoolean;
+        request_id: z.ZodString;
+    }, z.core.$loose>;
+    readonly request_feature: z.ZodObject<{
+        data: z.ZodObject<{
+            comments: z.ZodNumber;
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                vehicle: "vehicle";
+                feature: "feature";
+            }>;
+            title: z.ZodString;
+            body: z.ZodNullable<z.ZodString>;
+            vehicle: z.ZodNullable<z.ZodObject<{
+                make: z.ZodString;
+                model: z.ZodString;
+                year: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$loose>>;
+            status: z.ZodEnum<{
+                open: "open";
+                planned: "planned";
+                in_progress: "in_progress";
+                done: "done";
+                declined: "declined";
+            }>;
+            votes: z.ZodNumber;
+            author: z.ZodString;
+            url: z.ZodString;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+            viewer: z.ZodOptional<z.ZodObject<{
+                voted: z.ZodBoolean;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+        deduplicated: z.ZodBoolean;
+        request_id: z.ZodString;
+    }, z.core.$loose>;
+    readonly get_request: z.ZodObject<{
+        data: z.ZodObject<{
+            comment_count: z.ZodNumber;
+            comments: z.ZodArray<z.ZodObject<{
+                id: z.ZodString;
+                request_id: z.ZodString;
+                body: z.ZodString;
+                author: z.ZodString;
+                created_at: z.ZodString;
+            }, z.core.$loose>>;
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                vehicle: "vehicle";
+                feature: "feature";
+            }>;
+            title: z.ZodString;
+            body: z.ZodNullable<z.ZodString>;
+            vehicle: z.ZodNullable<z.ZodObject<{
+                make: z.ZodString;
+                model: z.ZodString;
+                year: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$loose>>;
+            status: z.ZodEnum<{
+                open: "open";
+                planned: "planned";
+                in_progress: "in_progress";
+                done: "done";
+                declined: "declined";
+            }>;
+            votes: z.ZodNumber;
+            author: z.ZodString;
+            url: z.ZodString;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+            viewer: z.ZodOptional<z.ZodObject<{
+                voted: z.ZodBoolean;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+        request_id: z.ZodString;
+    }, z.core.$loose>;
+    readonly upvote_request: z.ZodObject<{
+        data: z.ZodObject<{
+            comments: z.ZodNumber;
+            id: z.ZodString;
+            kind: z.ZodEnum<{
+                vehicle: "vehicle";
+                feature: "feature";
+            }>;
+            title: z.ZodString;
+            body: z.ZodNullable<z.ZodString>;
+            vehicle: z.ZodNullable<z.ZodObject<{
+                make: z.ZodString;
+                model: z.ZodString;
+                year: z.ZodNullable<z.ZodNumber>;
+            }, z.core.$loose>>;
+            status: z.ZodEnum<{
+                open: "open";
+                planned: "planned";
+                in_progress: "in_progress";
+                done: "done";
+                declined: "declined";
+            }>;
+            votes: z.ZodNumber;
+            author: z.ZodString;
+            url: z.ZodString;
+            created_at: z.ZodString;
+            updated_at: z.ZodString;
+            viewer: z.ZodOptional<z.ZodObject<{
+                voted: z.ZodBoolean;
+            }, z.core.$loose>>;
+        }, z.core.$loose>;
+        request_id: z.ZodString;
+    }, z.core.$loose>;
+    readonly comment_on_request: z.ZodObject<{
+        data: z.ZodObject<{
+            id: z.ZodString;
+            request_id: z.ZodString;
+            body: z.ZodString;
+            author: z.ZodString;
+            created_at: z.ZodString;
+        }, z.core.$loose>;
+        request_id: z.ZodString;
+    }, z.core.$loose>;
+    readonly share_building: z.ZodObject<{
+        data: z.ZodObject<{
+            building: z.ZodString;
+            updated_at: z.ZodString;
+        }, z.core.$loose>;
+        request_id: z.ZodString;
+    }, z.core.$loose>;
+    readonly share_referral: z.ZodObject<{
+        data: z.ZodObject<{
+            source: z.ZodEnum<{
+                search: "search";
+                ai_assistant: "ai_assistant";
+                github: "github";
+                npm: "npm";
+                twitter_x: "twitter_x";
+                linkedin: "linkedin";
+                reddit: "reddit";
+                hacker_news: "hacker_news";
+                youtube: "youtube";
+                friend_or_colleague: "friend_or_colleague";
+                blog_or_article: "blog_or_article";
+                other: "other";
+            }>;
+            detail: z.ZodNullable<z.ZodString>;
+            updated_at: z.ZodString;
+        }, z.core.$loose>;
+        request_id: z.ZodString;
+    }, z.core.$loose>;
+};
+/** The tools that promise structured content, i.e. everything but `describe_api`. */
+export type McpToolWithOutput = keyof typeof MCP_TOOL_OUTPUT_SCHEMAS;
+export type McpToolOutput<N extends McpToolWithOutput> = z.infer<(typeof MCP_TOOL_OUTPUT_SCHEMAS)[N]>;
+/** A catalog hit as either server holds it: the library's camelCase or the REST spelling. */
+export interface VehicleMatchSource {
+    kind: "make" | "model";
+    makeName?: string;
+    makeSlug?: string;
+    modelName?: string;
+    modelSlug?: string;
+    vehicleType?: string;
+    matchKind?: string;
+    make_name?: string;
+    make_slug?: string;
+    model_name?: string;
+    model_slug?: string;
+    vehicle_type?: string;
+    match_kind?: string;
+    years?: number[];
+}
+/**
+ * Normalizes a catalog hit into the one shape `search_vehicles` promises.
+ *
+ * The remote server reads the catalog library (camelCase) and the stdio one
+ * reads `GET /api/v1/vehicles?q=` (snake_case, and it omits `model_name`
+ * entirely on a make hit rather than sending null). Agents pass these straight
+ * to get_car_image, so both are mapped onto `make`/`model` with explicit nulls.
+ */
+export declare function toVehicleMatch(source: VehicleMatchSource): McpToolOutput<"search_vehicles">["data"]["results"][number];
+/**
+ * Normalizes the options payload into the one shape `list_image_options`
+ * promises. `GET /api/v1/images/options` describes formats and catalog sources
+ * as objects and the year span as `{from, to}`; agents want bare ids and a
+ * `[from, to]` pair, so both that shape and an already-flat one are accepted.
+ * Anything else in the payload (`limits`, `sizes.source`) rides along untouched.
+ */
+export declare function toImageOptions(data: unknown): McpToolOutput<"list_image_options">["data"];
 export interface McpToolAnnotations {
     title?: string;
     readOnlyHint?: boolean;
@@ -276,6 +868,8 @@ export interface McpToolDefinition<N extends McpToolName = McpToolName> {
     title: string;
     description: string;
     inputSchema: (typeof MCP_TOOL_SCHEMAS)[N];
+    /** What `structuredContent` will hold; absent only on `describe_api`, which answers in prose. */
+    outputSchema?: N extends McpToolWithOutput ? (typeof MCP_TOOL_OUTPUT_SCHEMAS)[N] : undefined;
     annotations: McpToolAnnotations;
 }
 export declare const MCP_TOOLS: {

package/dist/mcp/index.d.ts.map CHANGED Viewed

	@@ -1 +1 @@
1	- {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AACH,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC;~~AA6BzB~~,eAAO,MAAM,eAAe;;;;;CAKlB,CAAC;AAEX,eAAO,MAAM,gBAAgB,~~QAY0R~~,CAAC;~~AASxT~~,eAAO,MAAM,gBAAgB~~;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;iBAuB3B~~,CAAC;AAEH,MAAM,MAAM,UAAU,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,gBAAgB,CAAC,CAAC;AAE1D,eAAO,MAAM,gBAAgB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;CAqGnB,CAAC;AAEX,MAAM,MAAM,WAAW,GAAG,MAAM,OAAO,gBAAgB,CAAC;AACxD,MAAM,MAAM,YAAY,CAAC,CAAC,SAAS,WAAW,IAAI,CAAC,CAAC,KAAK,CAAC,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;~~AAExF~~,MAAM,WAAW,kBAAkB;IACjC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,YAAY,CAAC,EAAE,OAAO,CAAC;IACvB,eAAe,CAAC,EAAE,OAAO,CAAC;IAC1B,cAAc,CAAC,EAAE,OAAO,CAAC;IACzB,aAAa,CAAC,EAAE,OAAO,CAAC;CACzB;AAED,MAAM,WAAW,iBAAiB,CAAC,CAAC,SAAS,WAAW,GAAG,WAAW;IACpE,IAAI,EAAE,CAAC,CAAC;IACR,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,WAAW,EAAE,CAAC,OAAO,gBAAgB,CAAC,CAAC,CAAC,CAAC,CAAC;IAC1C,WAAW,EAAE,kBAAkB,CAAC;CACjC;AAED,eAAO,MAAM,SAAS,EAAE;KAAG,CAAC,IAAI,WAAW,GAAG,iBAAiB,CAAC,CAAC,CAAC;~~CA8HjE~~,CAAC;AAEF,eAAO,MAAM,aAAa,EAAE,iBAAiB,EAAoD,CAAC;AAElG,MAAM,WAAW,oBAAoB;IACnC,MAAM,EAAE,KAAK,GAAG,MAAM,GAAG,QAAQ,CAAC;IAClC,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,QAAQ,GAAG,QAAQ,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,MAAM,EAAE,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,GAAG,CAAC,EAAE,MAAM,CAAC;CACd;AAED,wFAAwF;AACxF,eAAO,MAAM,aAAa,EAAE,oBAAoB,~~EA4O~~/C,CAAC;AAEF,oFAAoF;AACpF,wBAAgB,kBAAkB,CAAC,MAAM,CAAC,EAAE,MAAM,GAAG,MAAM,CA8B1D;AAED,sDAAsD;AACtD,MAAM,MAAM,cAAc,GAAG;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;CACd,CAAA;AAED,uDAAuD;AACvD,MAAM,MAAM,eAAe,GAAG;IAC5B,IAAI,EAAE,OAAO,CAAC;IACd,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;CAClB,CAAA;AAED,MAAM,MAAM,aAAa,GAAG;IAC1B,OAAO,EAAE,KAAK,CAAC,cAAc,GAAG,eAAe,CAAC,CAAC;IACjD,iBAAiB,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IAC5C,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB,CAAA;AAED,mEAAmE;AACnE,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO,CAAC,EAAE,MAAM,GAAG,aAAa,CAG9F;AAED,sEAAsE;AACtE,wBAAgB,eAAe,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,GAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAM,GAAG,aAAa,CAMnG;AAED,6EAA6E;AAC7E,wBAAgB,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS,GAAG,MAAM,CAerE"}
1	+ {"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/mcp/index.ts"],"names":[],"mappings":"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"}