@unclick/mcp-server 0.2.3 → 0.2.4

package/dist/spotify-tool.js

@@ -0,0 +1,274 @@
+// Spotify Web API integration for the UnClick MCP server.
+// Uses the Spotify Web API via fetch - no external dependencies.
+// Users must supply a Bearer token (access token) from Spotify OAuth.
+const SPOTIFY_API_BASE = "https://api.spotify.com/v1";
+// ─── API helper ───────────────────────────────────────────────────────────────
+async function spotifyGet(token, path, params = {}) {
+    const qs = Object.keys(params).length > 0 ? `?${new URLSearchParams(params).toString()}` : "";
+    const res = await fetch(`${SPOTIFY_API_BASE}${path}${qs}`, {
+        headers: { Authorization: `Bearer ${token}` },
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const err = data.error;
+        const msg = err?.message ?? `HTTP ${res.status}`;
+        const status = err?.status ? ` (${err.status})` : "";
+        throw new Error(`Spotify API error${status}: ${msg}`);
+    }
+    return data;
+}
+// ─── Auth validation ──────────────────────────────────────────────────────────
+function requireToken(args) {
+    const token = String(args.bearer_token ?? "").trim();
+    if (!token)
+        throw new Error("bearer_token is required. Obtain one via Spotify OAuth at developer.spotify.com.");
+    return token;
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export async function spotifySearch(args) {
+    const token = requireToken(args);
+    const q = String(args.query ?? "").trim();
+    if (!q)
+        throw new Error("query is required.");
+    const type = String(args.type ?? "track");
+    const limit = Math.min(50, Math.max(1, Number(args.limit ?? 10)));
+    const offset = Math.max(0, Number(args.offset ?? 0));
+    const market = args.market ? String(args.market) : undefined;
+    const validTypes = ["track", "album", "artist", "playlist", "show", "episode"];
+    const requestedTypes = type.split(",").map((t) => t.trim());
+    const invalid = requestedTypes.filter((t) => !validTypes.includes(t));
+    if (invalid.length > 0) {
+        throw new Error(`Invalid type(s): ${invalid.join(", ")}. Valid: ${validTypes.join(", ")}.`);
+    }
+    const params = { q, type, limit: String(limit), offset: String(offset) };
+    if (market)
+        params.market = market;
+    const data = await spotifyGet(token, "/search", params);
+    const result = {};
+    if (data.tracks) {
+        result.tracks = {
+            total: data.tracks.total,
+            next: data.tracks.next,
+            items: data.tracks.items.map((t) => ({
+                id: t.id,
+                name: t.name,
+                artists: t.artists.map((a) => a.name),
+                album: t.album?.name,
+                duration_ms: t.duration_ms,
+                popularity: t.popularity,
+                preview_url: t.preview_url,
+                spotify_url: t.external_urls.spotify,
+            })),
+        };
+    }
+    if (data.albums) {
+        result.albums = {
+            total: data.albums.total,
+            next: data.albums.next,
+            items: data.albums.items.map((a) => ({
+                id: a.id,
+                name: a.name,
+                artists: a.artists.map((ar) => ar.name),
+                release_date: a.release_date,
+                total_tracks: a.total_tracks,
+                spotify_url: a.external_urls.spotify,
+            })),
+        };
+    }
+    if (data.artists) {
+        result.artists = {
+            total: data.artists.total,
+            next: data.artists.next,
+            items: data.artists.items.map((a) => ({
+                id: a.id,
+                name: a.name,
+                genres: a.genres,
+                popularity: a.popularity,
+                followers: a.followers.total,
+                spotify_url: a.external_urls.spotify,
+            })),
+        };
+    }
+    if (data.playlists) {
+        result.playlists = {
+            total: data.playlists.total,
+            next: data.playlists.next,
+            items: data.playlists.items.map((p) => ({
+                id: p.id,
+                name: p.name,
+                owner: p.owner.display_name,
+                tracks_total: p.tracks.total,
+                spotify_url: p.external_urls.spotify,
+            })),
+        };
+    }
+    return result;
+}
+export async function spotifyGetTrack(args) {
+    const token = requireToken(args);
+    const trackId = String(args.track_id ?? "").trim();
+    if (!trackId)
+        throw new Error("track_id is required.");
+    const params = {};
+    if (args.market)
+        params.market = String(args.market);
+    const track = await spotifyGet(token, `/tracks/${encodeURIComponent(trackId)}`, params);
+    return {
+        id: track.id,
+        name: track.name,
+        artists: track.artists.map((a) => ({ id: a.id, name: a.name })),
+        album: track.album ? {
+            id: track.album.id,
+            name: track.album.name,
+            release_date: track.album.release_date,
+            type: track.album.album_type,
+        } : null,
+        duration_ms: track.duration_ms,
+        explicit: track.explicit,
+        popularity: track.popularity,
+        preview_url: track.preview_url,
+        track_number: track.track_number,
+        spotify_url: track.external_urls.spotify,
+    };
+}
+export async function spotifyGetAlbum(args) {
+    const token = requireToken(args);
+    const albumId = String(args.album_id ?? "").trim();
+    if (!albumId)
+        throw new Error("album_id is required.");
+    const album = await spotifyGet(token, `/albums/${encodeURIComponent(albumId)}`);
+    return {
+        id: album.id,
+        name: album.name,
+        type: album.album_type,
+        release_date: album.release_date,
+        total_tracks: album.total_tracks,
+        artists: album.artists.map((a) => ({ id: a.id, name: a.name })),
+        label: album.label ?? null,
+        popularity: album.popularity ?? null,
+        genres: album.genres ?? [],
+        image: album.images[0]?.url ?? null,
+        spotify_url: album.external_urls.spotify,
+        tracks: album.tracks?.items.map((t) => ({
+            id: t.id,
+            name: t.name,
+            duration_ms: t.duration_ms,
+            track_number: t.track_number,
+        })) ?? [],
+    };
+}
+export async function spotifyGetArtist(args) {
+    const token = requireToken(args);
+    const artistId = String(args.artist_id ?? "").trim();
+    if (!artistId)
+        throw new Error("artist_id is required.");
+    const artist = await spotifyGet(token, `/artists/${encodeURIComponent(artistId)}`);
+    return {
+        id: artist.id,
+        name: artist.name,
+        genres: artist.genres,
+        popularity: artist.popularity,
+        followers: artist.followers.total,
+        image: artist.images[0]?.url ?? null,
+        spotify_url: artist.external_urls.spotify,
+    };
+}
+export async function spotifyGetPlaylist(args) {
+    const token = requireToken(args);
+    const playlistId = String(args.playlist_id ?? "").trim();
+    if (!playlistId)
+        throw new Error("playlist_id is required.");
+    const params = {};
+    if (args.market)
+        params.market = String(args.market);
+    const pl = await spotifyGet(token, `/playlists/${encodeURIComponent(playlistId)}`, params);
+    return {
+        id: pl.id,
+        name: pl.name,
+        description: pl.description,
+        public: pl.public,
+        owner: pl.owner.display_name,
+        followers: pl.followers.total,
+        total_tracks: pl.tracks.total,
+        image: pl.images[0]?.url ?? null,
+        spotify_url: pl.external_urls.spotify,
+        tracks: (pl.tracks.items ?? [])
+            .filter((item) => item.track !== null)
+            .map((item) => ({
+            id: item.track.id,
+            name: item.track.name,
+            artists: item.track.artists.map((a) => a.name),
+            duration_ms: item.track.duration_ms,
+        })),
+    };
+}
+export async function spotifyGetRecommendations(args) {
+    const token = requireToken(args);
+    const limit = Math.min(100, Math.max(1, Number(args.limit ?? 20)));
+    const params = { limit: String(limit) };
+    // At least one seed is required
+    const seedTracks = String(args.seed_tracks ?? "").trim();
+    const seedArtists = String(args.seed_artists ?? "").trim();
+    const seedGenres = String(args.seed_genres ?? "").trim();
+    if (!seedTracks && !seedArtists && !seedGenres) {
+        throw new Error("At least one of seed_tracks, seed_artists, or seed_genres is required.");
+    }
+    if (seedTracks)
+        params.seed_tracks = seedTracks;
+    if (seedArtists)
+        params.seed_artists = seedArtists;
+    if (seedGenres)
+        params.seed_genres = seedGenres;
+    if (args.market)
+        params.market = String(args.market);
+    if (args.min_energy !== undefined)
+        params.min_energy = String(args.min_energy);
+    if (args.max_energy !== undefined)
+        params.max_energy = String(args.max_energy);
+    if (args.min_tempo !== undefined)
+        params.min_tempo = String(args.min_tempo);
+    if (args.max_tempo !== undefined)
+        params.max_tempo = String(args.max_tempo);
+    if (args.target_valence !== undefined)
+        params.target_valence = String(args.target_valence);
+    if (args.target_danceability !== undefined)
+        params.target_danceability = String(args.target_danceability);
+    const data = await spotifyGet(token, "/recommendations", params);
+    return {
+        count: data.tracks.length,
+        tracks: data.tracks.map((t) => ({
+            id: t.id,
+            name: t.name,
+            artists: t.artists.map((a) => a.name),
+            album: t.album?.name ?? null,
+            duration_ms: t.duration_ms,
+            popularity: t.popularity,
+            preview_url: t.preview_url,
+            spotify_url: t.external_urls.spotify,
+        })),
+    };
+}
+export async function spotifyGetAudioFeatures(args) {
+    const token = requireToken(args);
+    const trackId = String(args.track_id ?? "").trim();
+    if (!trackId)
+        throw new Error("track_id is required.");
+    const features = await spotifyGet(token, `/audio-features/${encodeURIComponent(trackId)}`);
+    return {
+        id: features.id,
+        danceability: features.danceability,
+        energy: features.energy,
+        key: features.key,
+        loudness: features.loudness,
+        mode: features.mode,
+        speechiness: features.speechiness,
+        acousticness: features.acousticness,
+        instrumentalness: features.instrumentalness,
+        liveness: features.liveness,
+        valence: features.valence,
+        tempo: features.tempo,
+        time_signature: features.time_signature,
+        duration_ms: features.duration_ms,
+    };
+}
+//# sourceMappingURL=spotify-tool.js.map

package/dist/spotify-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"spotify-tool.js","sourceRoot":"","sources":["../src/spotify-tool.ts"],"names":[],"mappings":"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"}

package/dist/square-tool.d.ts

@@ -0,0 +1,5 @@
+export declare function squarePayments(args: Record<string, unknown>): Promise<unknown>;
+export declare function squareCustomers(args: Record<string, unknown>): Promise<unknown>;
+export declare function squareCatalogList(args: Record<string, unknown>): Promise<unknown>;
+export declare function squareCatalogSearch(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=square-tool.d.ts.map

package/dist/square-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"square-tool.d.ts","sourceRoot":"","sources":["../src/square-tool.ts"],"names":[],"mappings":"AAyEA,wBAAsB,cAAc,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiCpF;AAID,wBAAsB,eAAe,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAUrF;AAID,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CASvF;AAID,wBAAsB,mBAAmB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAiBzF"}

package/dist/square-tool.js

@@ -0,0 +1,133 @@
+// ─── Square REST API Tool ────────────────────────────────────────────────────
+// Covers payments, orders, customers, and catalog.
+// Auth: Access token (Bearer token).
+// Base URL: https://connect.squareup.com/v2
+// No external dependencies - native fetch only.
+const SQUARE_BASE = "https://connect.squareup.com/v2";
+// ─── Helpers ──────────────────────────────────────────────────────────────────
+function requireConfig(args) {
+    const access_token = String(args.access_token ?? "").trim();
+    if (!access_token)
+        return { error: "access_token is required (Square access token)." };
+    return { access_token };
+}
+async function squareFetch(cfg, method, path, body, query) {
+    const url = new URL(`${SQUARE_BASE}${path}`);
+    if (method === "GET" && query) {
+        for (const [k, v] of Object.entries(query)) {
+            if (v !== undefined)
+                url.searchParams.set(k, String(v));
+        }
+    }
+    let response;
+    try {
+        response = await fetch(url.toString(), {
+            method,
+            headers: {
+                Authorization: `Bearer ${cfg.access_token}`,
+                "Square-Version": "2024-01-17",
+                "Content-Type": "application/json",
+                "Accept": "application/json",
+            },
+            body: body !== undefined ? JSON.stringify(body) : undefined,
+        });
+    }
+    catch (err) {
+        return { error: `Network error: ${err instanceof Error ? err.message : String(err)}` };
+    }
+    if (response.status === 429) {
+        return { error: "Square rate limit reached. Wait before retrying.", status: 429 };
+    }
+    if (response.status === 401) {
+        return { error: "Square auth failed: invalid or missing access token.", status: 401 };
+    }
+    let data;
+    try {
+        data = await response.json();
+    }
+    catch {
+        return { error: `Non-JSON response (HTTP ${response.status})`, status: response.status };
+    }
+    if (!response.ok) {
+        const d = data;
+        return { error: d["errors"] ?? d["message"] ?? "Square API error", status: response.status };
+    }
+    return data;
+}
+// ─── square_payments ──────────────────────────────────────────────────────────
+export async function squarePayments(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    const action = String(args.action ?? "list");
+    switch (action) {
+        case "list": {
+            return squareFetch(cfg, "GET", "/payments", undefined, {
+                begin_time: args.begin_time ? String(args.begin_time) : undefined,
+                end_time: args.end_time ? String(args.end_time) : undefined,
+                cursor: args.cursor ? String(args.cursor) : undefined,
+                limit: args.limit ? Number(args.limit) : 20,
+            });
+        }
+        case "create": {
+            const source_id = String(args.source_id ?? "").trim();
+            const idempotency_key = String(args.idempotency_key ?? crypto.randomUUID());
+            if (!source_id)
+                return { error: "source_id is required for action='create'." };
+            if (!args.amount_money || typeof args.amount_money !== "object") {
+                return { error: "amount_money object is required for action='create' (e.g. {amount: 100, currency: 'USD'})." };
+            }
+            return squareFetch(cfg, "POST", "/payments", {
+                source_id,
+                idempotency_key,
+                amount_money: args.amount_money,
+                note: args.note ? String(args.note) : undefined,
+                customer_id: args.customer_id ? String(args.customer_id) : undefined,
+            });
+        }
+        default:
+            return { error: `Unknown action "${action}". Valid: list, create.` };
+    }
+}
+// ─── square_customers ─────────────────────────────────────────────────────────
+export async function squareCustomers(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    return squareFetch(cfg, "GET", "/customers", undefined, {
+        cursor: args.cursor ? String(args.cursor) : undefined,
+        limit: args.limit ? Number(args.limit) : 20,
+        sort_field: args.sort_field ? String(args.sort_field) : undefined,
+        sort_order: args.sort_order ? String(args.sort_order) : undefined,
+    });
+}
+// ─── square_catalog_list ──────────────────────────────────────────────────────
+export async function squareCatalogList(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    return squareFetch(cfg, "GET", "/catalog/list", undefined, {
+        cursor: args.cursor ? String(args.cursor) : undefined,
+        types: args.types ? String(args.types) : undefined,
+        limit: args.limit ? Number(args.limit) : 100,
+    });
+}
+// ─── square_catalog_search ────────────────────────────────────────────────────
+export async function squareCatalogSearch(args) {
+    const cfg = requireConfig(args);
+    if ("error" in cfg)
+        return cfg;
+    const text_filter = String(args.text_filter ?? "").trim();
+    if (!text_filter)
+        return { error: "text_filter (search text) is required." };
+    const objectTypes = args.object_types && Array.isArray(args.object_types)
+        ? args.object_types
+        : ["ITEM"];
+    return squareFetch(cfg, "POST", "/catalog/search", {
+        text_filter: { keyword: text_filter },
+        object_types: objectTypes,
+        limit: args.limit ? Number(args.limit) : 20,
+        cursor: args.cursor ? String(args.cursor) : undefined,
+    });
+}
+//# sourceMappingURL=square-tool.js.map

package/dist/square-tool.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"square-tool.js","sourceRoot":"","sources":["../src/square-tool.ts"],"names":[],"mappings":"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"}

package/dist/stability-tool.d.ts

@@ -0,0 +1,5 @@
+export declare function stabilityTextToImage(args: Record<string, unknown>): Promise<unknown>;
+export declare function stabilityImageToImage(args: Record<string, unknown>): Promise<unknown>;
+export declare function stabilityUpscale(args: Record<string, unknown>): Promise<unknown>;
+export declare function stabilityListEngines(args: Record<string, unknown>): Promise<unknown>;
+//# sourceMappingURL=stability-tool.d.ts.map

package/dist/stability-tool.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"stability-tool.d.ts","sourceRoot":"","sources":["../src/stability-tool.ts"],"names":[],"mappings":"AAuGA,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA2C1F;AAED,wBAAsB,qBAAqB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA+C3F;AAED,wBAAsB,gBAAgB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CA8BtF;AAED,wBAAsB,oBAAoB,CAAC,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC,CAc1F"}

package/dist/stability-tool.js

@@ -0,0 +1,190 @@
+// Stability AI API integration for the UnClick MCP server.
+// Uses the Stability AI REST API via fetch - no external dependencies.
+// Users must supply an API key from platform.stability.ai.
+const STABILITY_API_BASE = "https://api.stability.ai";
+// ─── Auth validation ──────────────────────────────────────────────────────────
+function requireKey(args) {
+    const key = String(args.api_key ?? "").trim();
+    if (!key)
+        throw new Error("api_key is required. Get one at platform.stability.ai.");
+    return key;
+}
+// ─── API helpers ──────────────────────────────────────────────────────────────
+async function stabilityGet(apiKey, path) {
+    const res = await fetch(`${STABILITY_API_BASE}${path}`, {
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            Accept: "application/json",
+        },
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? `HTTP ${res.status}`;
+        const id = data.id ? ` (id: ${data.id})` : "";
+        throw new Error(`Stability AI error${id}: ${msg}`);
+    }
+    return data;
+}
+async function stabilityPost(apiKey, path, body, acceptHeader = "application/json") {
+    const res = await fetch(`${STABILITY_API_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            "Content-Type": "application/json",
+            Accept: acceptHeader,
+        },
+        body: JSON.stringify(body),
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? `HTTP ${res.status}`;
+        const id = data.id ? ` (id: ${data.id})` : "";
+        throw new Error(`Stability AI error${id}: ${msg}`);
+    }
+    return data;
+}
+async function stabilityPostMultipart(apiKey, path, form) {
+    const res = await fetch(`${STABILITY_API_BASE}${path}`, {
+        method: "POST",
+        headers: {
+            Authorization: `Bearer ${apiKey}`,
+            Accept: "application/json",
+        },
+        body: form,
+    });
+    const data = await res.json();
+    if (!res.ok) {
+        const msg = data.message ?? `HTTP ${res.status}`;
+        throw new Error(`Stability AI error: ${msg}`);
+    }
+    return data;
+}
+// ─── Operations ───────────────────────────────────────────────────────────────
+export async function stabilityTextToImage(args) {
+    const apiKey = requireKey(args);
+    const prompt = String(args.prompt ?? "").trim();
+    if (!prompt)
+        throw new Error("prompt is required.");
+    const engineId = String(args.engine_id ?? "stable-diffusion-xl-1024-v1-0");
+    const negativePrompt = String(args.negative_prompt ?? "").trim();
+    const width = Number(args.width ?? 1024);
+    const height = Number(args.height ?? 1024);
+    const steps = Math.min(150, Math.max(10, Number(args.steps ?? 30)));
+    const cfgScale = Math.min(35, Math.max(0, Number(args.cfg_scale ?? 7)));
+    const samples = Math.min(10, Math.max(1, Number(args.samples ?? 1)));
+    const stylePreset = args.style_preset ? String(args.style_preset) : undefined;
+    const textPrompts = [{ text: prompt, weight: 1 }];
+    if (negativePrompt)
+        textPrompts.push({ text: negativePrompt, weight: -1 });
+    const body = {
+        text_prompts: textPrompts,
+        cfg_scale: cfgScale,
+        height,
+        width,
+        steps,
+        samples,
+    };
+    if (stylePreset)
+        body.style_preset = stylePreset;
+    if (args.seed !== undefined)
+        body.seed = Number(args.seed);
+    const result = await stabilityPost(apiKey, `/v1/generation/${encodeURIComponent(engineId)}/text-to-image`, body);
+    return {
+        success: true,
+        engine_id: engineId,
+        count: result.artifacts.length,
+        images: result.artifacts.map((a) => ({
+            base64: a.base64,
+            seed: a.seed,
+            finish_reason: a.finishReason,
+            note: "Decode base64 and write as PNG to save the image.",
+        })),
+    };
+}
+export async function stabilityImageToImage(args) {
+    const apiKey = requireKey(args);
+    const prompt = String(args.prompt ?? "").trim();
+    const imageUrl = String(args.image_url ?? "").trim();
+    if (!prompt)
+        throw new Error("prompt is required.");
+    if (!imageUrl)
+        throw new Error("image_url is required (URL of the source image).");
+    const engineId = String(args.engine_id ?? "stable-diffusion-xl-1024-v1-0");
+    const strength = Math.min(1, Math.max(0, Number(args.strength ?? 0.35)));
+    const steps = Math.min(150, Math.max(10, Number(args.steps ?? 30)));
+    const cfgScale = Math.min(35, Math.max(0, Number(args.cfg_scale ?? 7)));
+    const samples = Math.min(10, Math.max(1, Number(args.samples ?? 1)));
+    // Fetch the source image
+    const imgRes = await fetch(imageUrl);
+    if (!imgRes.ok)
+        throw new Error(`Failed to fetch image_url: HTTP ${imgRes.status}`);
+    const imgBlob = await imgRes.blob();
+    const form = new FormData();
+    form.append("init_image", imgBlob, "init_image.png");
+    form.append("init_image_mode", "IMAGE_STRENGTH");
+    form.append("image_strength", String(strength));
+    form.append("text_prompts[0][text]", prompt);
+    form.append("text_prompts[0][weight]", "1");
+    const negativePrompt = String(args.negative_prompt ?? "").trim();
+    if (negativePrompt) {
+        form.append("text_prompts[1][text]", negativePrompt);
+        form.append("text_prompts[1][weight]", "-1");
+    }
+    form.append("cfg_scale", String(cfgScale));
+    form.append("steps", String(steps));
+    form.append("samples", String(samples));
+    const result = await stabilityPostMultipart(apiKey, `/v1/generation/${encodeURIComponent(engineId)}/image-to-image`, form);
+    return {
+        success: true,
+        engine_id: engineId,
+        count: result.artifacts.length,
+        images: result.artifacts.map((a) => ({
+            base64: a.base64,
+            seed: a.seed,
+            finish_reason: a.finishReason,
+            note: "Decode base64 and write as PNG to save the image.",
+        })),
+    };
+}
+export async function stabilityUpscale(args) {
+    const apiKey = requireKey(args);
+    const imageUrl = String(args.image_url ?? "").trim();
+    if (!imageUrl)
+        throw new Error("image_url is required (URL of the image to upscale).");
+    const width = Number(args.width ?? 2048);
+    const engineId = String(args.engine_id ?? "esrgan-v1-x2plus");
+    // Fetch source image
+    const imgRes = await fetch(imageUrl);
+    if (!imgRes.ok)
+        throw new Error(`Failed to fetch image_url: HTTP ${imgRes.status}`);
+    const imgBlob = await imgRes.blob();
+    const form = new FormData();
+    form.append("image", imgBlob, "image.png");
+    form.append("width", String(width));
+    const result = await stabilityPostMultipart(apiKey, `/v1/generation/${encodeURIComponent(engineId)}/image-to-image/upscale`, form);
+    return {
+        success: true,
+        engine_id: engineId,
+        count: result.artifacts.length,
+        images: result.artifacts.map((a) => ({
+            base64: a.base64,
+            seed: a.seed,
+            finish_reason: a.finishReason,
+        })),
+    };
+}
+export async function stabilityListEngines(args) {
+    const apiKey = requireKey(args);
+    const engines = await stabilityGet(apiKey, "/v1/engines/list");
+    return {
+        count: engines.length,
+        engines: engines.map((e) => ({
+            id: e.id,
+            name: e.name,
+            description: e.description,
+            type: e.type,
+            ready: e.ready,
+        })),
+    };
+}
+//# sourceMappingURL=stability-tool.js.map