threenative-asset-mcp 0.4.0

package/dist/fab/schemas.js

@@ -0,0 +1,105 @@
+import { z } from "zod";
+export const UpstreamSearchSchema = z
+    .object({
+    results: z.array(z.unknown()),
+    cursors: z
+        .object({
+        next: z.string().nullable().optional(),
+        previous: z.string().nullable().optional(),
+    })
+        .passthrough()
+        .optional(),
+})
+    .passthrough();
+export const UpstreamListingSchema = z
+    .record(z.string(), z.unknown())
+    .superRefine((value, context) => {
+    const id = value.uid ?? value.id ?? value.uuid;
+    const title = value.title ?? value.name;
+    if (typeof id !== "string" || id.length === 0) {
+        context.addIssue({
+            code: "custom",
+            message: "listing identity is missing",
+        });
+    }
+    if (typeof title !== "string" || title.length === 0) {
+        context.addIssue({
+            code: "custom",
+            message: "listing title is missing",
+        });
+    }
+    for (const key of [
+        "licenses",
+        "offers",
+        "assetFormats",
+        "asset_formats",
+        "formats",
+        "media",
+        "images",
+        "files",
+        "tags",
+        "categories",
+    ]) {
+        if (value[key] !== undefined && !Array.isArray(value[key])) {
+            context.addIssue({
+                code: "custom",
+                message: `${key} must be an array when present`,
+                path: [key],
+            });
+        }
+    }
+    const licenses = value.licenses ?? value.offers;
+    if (Array.isArray(licenses)) {
+        licenses.forEach((entry, index) => {
+            if (typeof entry !== "object" ||
+                entry === null ||
+                Array.isArray(entry)) {
+                context.addIssue({
+                    code: "custom",
+                    message: "license entries must be objects",
+                    path: ["licenses", index],
+                });
+                return;
+            }
+            const license = entry;
+            for (const priceKey of [
+                "price",
+                "basePrice",
+                "pricing",
+                "discountedPrice",
+                "effectivePrice",
+                "salePrice",
+            ]) {
+                const rawPrice = license[priceKey];
+                if (rawPrice === undefined)
+                    continue;
+                if (typeof rawPrice !== "object" ||
+                    rawPrice === null ||
+                    Array.isArray(rawPrice)) {
+                    context.addIssue({
+                        code: "custom",
+                        message: `${priceKey} must be an object`,
+                        path: ["licenses", index, priceKey],
+                    });
+                    continue;
+                }
+                const price = rawPrice;
+                const numeric = [
+                    price.amount,
+                    price.price,
+                    price.value,
+                    price.effectiveAmount,
+                    price.discountedAmount,
+                ].some((candidate) => typeof candidate === "number" && Number.isFinite(candidate));
+                if (!numeric) {
+                    context.addIssue({
+                        code: "custom",
+                        message: `${priceKey} has no numeric price`,
+                        path: ["licenses", index, priceKey],
+                    });
+                }
+            }
+        });
+    }
+});
+//# sourceMappingURL=schemas.js.map

package/dist/fab/schemas.js.map

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

package/dist/index.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}

package/dist/index.js

@@ -0,0 +1,58 @@
+#!/usr/bin/env node
+import { serveStdio } from "@modelcontextprotocol/server/stdio";
+import { AmbientCgClient } from "./ambientcg/client.js";
+import { AudioCatalogClient } from "./audio/client.js";
+import { BundleAssetClient } from "./bundle/client.js";
+import { DirectAssetDownloader } from "./download/direct-asset-downloader.js";
+import { FabClient } from "./fab/client.js";
+import { ItchAssetClient } from "./itch/client.js";
+import { PolyHavenClient } from "./polyhaven/client.js";
+import { SketchfabClient } from "./sketchfab/client.js";
+import { createAssetServer } from "./server.js";
+import { SmithsonianClient } from "./smithsonian/client.js";
+const fab = new FabClient();
+const polyhaven = new PolyHavenClient();
+const ambientcg = new AmbientCgClient();
+const smithsonian = new SmithsonianClient();
+const sketchfab = new SketchfabClient();
+const audio = new AudioCatalogClient();
+const directDownloader = new DirectAssetDownloader();
+const itch = new ItchAssetClient({ downloader: directDownloader });
+const bundle = new BundleAssetClient({ itch });
+void fab.prepareBrowser();
+const handle = serveStdio(() => createAssetServer({
+    fab,
+    polyhaven,
+    ambientcg,
+    smithsonian,
+    sketchfab,
+    audio,
+    directDownloader,
+    itch,
+    bundle,
+}), {
+    onerror(error) {
+        process.stderr.write(`${JSON.stringify({
+            level: "error",
+            message: "MCP transport error",
+            error: error.name,
+        })}\n`);
+    },
+});
+let closing = false;
+async function shutdown() {
+    if (closing)
+        return;
+    closing = true;
+    await Promise.allSettled([fab.close(), handle.close()]);
+}
+process.once("SIGINT", () => {
+    void shutdown().finally(() => process.exit(0));
+});
+process.once("SIGTERM", () => {
+    void shutdown().finally(() => process.exit(0));
+});
+process.once("beforeExit", () => {
+    void shutdown();
+});
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAEA,OAAO,EAAE,UAAU,EAAE,MAAM,oCAAoC,CAAC;AAEhE,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,kBAAkB,EAAE,MAAM,mBAAmB,CAAC;AACvD,OAAO,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,EAAE,qBAAqB,EAAE,MAAM,uCAAuC,CAAC;AAC9E,OAAO,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AAC5C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAE5D,MAAM,GAAG,GAAG,IAAI,SAAS,EAAE,CAAC;AAC5B,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;AACxC,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;AACxC,MAAM,WAAW,GAAG,IAAI,iBAAiB,EAAE,CAAC;AAC5C,MAAM,SAAS,GAAG,IAAI,eAAe,EAAE,CAAC;AACxC,MAAM,KAAK,GAAG,IAAI,kBAAkB,EAAE,CAAC;AACvC,MAAM,gBAAgB,GAAG,IAAI,qBAAqB,EAAE,CAAC;AACrD,MAAM,IAAI,GAAG,IAAI,eAAe,CAAC,EAAE,UAAU,EAAE,gBAAgB,EAAE,CAAC,CAAC;AACnE,MAAM,MAAM,GAAG,IAAI,iBAAiB,CAAC,EAAE,IAAI,EAAE,CAAC,CAAC;AAC/C,KAAK,GAAG,CAAC,cAAc,EAAE,CAAC;AAC1B,MAAM,MAAM,GAAG,UAAU,CACvB,GAAG,EAAE,CACH,iBAAiB,CAAC;IAChB,GAAG;IACH,SAAS;IACT,SAAS;IACT,WAAW;IACX,SAAS;IACT,KAAK;IACL,gBAAgB;IAChB,IAAI;IACJ,MAAM;CACP,CAAC,EACJ;IACA,OAAO,CAAC,KAAK;QACX,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,GAAG,IAAI,CAAC,SAAS,CAAC;YAChB,KAAK,EAAE,OAAO;YACd,OAAO,EAAE,qBAAqB;YAC9B,KAAK,EAAE,KAAK,CAAC,IAAI;SAClB,CAAC,IAAI,CACP,CAAC;IACJ,CAAC;CACA,CACF,CAAC;AAEF,IAAI,OAAO,GAAG,KAAK,CAAC;AACpB,KAAK,UAAU,QAAQ;IACrB,IAAI,OAAO;QAAE,OAAO;IACpB,OAAO,GAAG,IAAI,CAAC;IACf,MAAM,OAAO,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,KAAK,EAAE,EAAE,MAAM,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC;AAC1D,CAAC;AAED,OAAO,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,EAAE;IAC1B,KAAK,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,IAAI,CAAC,SAAS,EAAE,GAAG,EAAE;IAC3B,KAAK,QAAQ,EAAE,CAAC,OAAO,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC;AACjD,CAAC,CAAC,CAAC;AACH,OAAO,CAAC,IAAI,CAAC,YAAY,EAAE,GAAG,EAAE;IAC9B,KAAK,QAAQ,EAAE,CAAC;AAClB,CAAC,CAAC,CAAC"}

package/dist/itch/catalog.d.ts

@@ -0,0 +1,13 @@
+export type ItchPackId = "tallbeard-music-loop-bundle" | "quaternius-universal-animation-library-1" | "quaternius-universal-animation-library-2" | "brackeys-vfx-bundle" | "kaykit-platformer";
+export interface ItchPack {
+    id: ItchPackId;
+    name: string;
+    sourceId: string;
+    pageUrl: string;
+    kind: "music" | "animation" | "vfx" | "3d-model";
+    license: "CC0";
+    attributionRequired: false;
+    caution?: string;
+}
+export declare const ITCH_PACKS: readonly ItchPack[];
+//# sourceMappingURL=catalog.d.ts.map

package/dist/itch/catalog.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.d.ts","sourceRoot":"","sources":["../../src/itch/catalog.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,UAAU,GAClB,6BAA6B,GAC7B,0CAA0C,GAC1C,0CAA0C,GAC1C,qBAAqB,GACrB,mBAAmB,CAAC;AAExB,MAAM,WAAW,QAAQ;IACvB,EAAE,EAAE,UAAU,CAAC;IACf,IAAI,EAAE,MAAM,CAAC;IACb,QAAQ,EAAE,MAAM,CAAC;IACjB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,OAAO,GAAG,WAAW,GAAG,KAAK,GAAG,UAAU,CAAC;IACjD,OAAO,EAAE,KAAK,CAAC;IACf,mBAAmB,EAAE,KAAK,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,eAAO,MAAM,UAAU,EAAE,SAAS,QAAQ,EAgDhC,CAAC"}

package/dist/itch/catalog.js

@@ -0,0 +1,50 @@
+export const ITCH_PACKS = [
+    {
+        id: "tallbeard-music-loop-bundle",
+        name: "Tallbeard Music Loop Bundle",
+        sourceId: "tallbeard",
+        pageUrl: "https://tallbeard.itch.io/music-loop-bundle",
+        kind: "music",
+        license: "CC0",
+        attributionRequired: false,
+        caution: "Credit to Abstraction is optional but appreciated by the creator.",
+    },
+    {
+        id: "quaternius-universal-animation-library-1",
+        name: "Quaternius Universal Animation Library 1",
+        sourceId: "quaternius",
+        pageUrl: "https://quaternius.itch.io/universal-animation-library",
+        kind: "animation",
+        license: "CC0",
+        attributionRequired: false,
+    },
+    {
+        id: "quaternius-universal-animation-library-2",
+        name: "Quaternius Universal Animation Library 2",
+        sourceId: "quaternius",
+        pageUrl: "https://quaternius.itch.io/universal-animation-library-2",
+        kind: "animation",
+        license: "CC0",
+        attributionRequired: false,
+    },
+    {
+        id: "brackeys-vfx-bundle",
+        name: "Brackeys VFX Bundle",
+        sourceId: "brackeys-vfx",
+        pageUrl: "https://brackeysgames.itch.io/brackeys-vfx-bundle",
+        kind: "vfx",
+        license: "CC0",
+        attributionRequired: false,
+    },
+    {
+        id: "kaykit-platformer",
+        name: "KayKit Platformer Pack",
+        sourceId: "kaykit",
+        pageUrl: "https://kaylousberg.itch.io/kaykit-platformer",
+        kind: "3d-model",
+        license: "CC0",
+        attributionRequired: false,
+        caution: "Do not resell the unmodified pack or claim it as your own.",
+    },
+];
+//# sourceMappingURL=catalog.js.map

package/dist/itch/catalog.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"catalog.js","sourceRoot":"","sources":["../../src/itch/catalog.ts"],"names":[],"mappings":"AAkBA,MAAM,CAAC,MAAM,UAAU,GAAwB;IAC7C;QACE,EAAE,EAAE,6BAA6B;QACjC,IAAI,EAAE,6BAA6B;QACnC,QAAQ,EAAE,WAAW;QACrB,OAAO,EAAE,6CAA6C;QACtD,IAAI,EAAE,OAAO;QACb,OAAO,EAAE,KAAK;QACd,mBAAmB,EAAE,KAAK;QAC1B,OAAO,EAAE,mEAAmE;KAC7E;IACD;QACE,EAAE,EAAE,0CAA0C;QAC9C,IAAI,EAAE,0CAA0C;QAChD,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,wDAAwD;QACjE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,KAAK;QACd,mBAAmB,EAAE,KAAK;KAC3B;IACD;QACE,EAAE,EAAE,0CAA0C;QAC9C,IAAI,EAAE,0CAA0C;QAChD,QAAQ,EAAE,YAAY;QACtB,OAAO,EAAE,0DAA0D;QACnE,IAAI,EAAE,WAAW;QACjB,OAAO,EAAE,KAAK;QACd,mBAAmB,EAAE,KAAK;KAC3B;IACD;QACE,EAAE,EAAE,qBAAqB;QACzB,IAAI,EAAE,qBAAqB;QAC3B,QAAQ,EAAE,cAAc;QACxB,OAAO,EAAE,mDAAmD;QAC5D,IAAI,EAAE,KAAK;QACX,OAAO,EAAE,KAAK;QACd,mBAAmB,EAAE,KAAK;KAC3B;IACD;QACE,EAAE,EAAE,mBAAmB;QACvB,IAAI,EAAE,wBAAwB;QAC9B,QAAQ,EAAE,QAAQ;QAClB,OAAO,EAAE,+CAA+C;QACxD,IAAI,EAAE,UAAU;QAChB,OAAO,EAAE,KAAK;QACd,mBAAmB,EAAE,KAAK;QAC1B,OAAO,EAAE,4DAA4D;KACtE;CACO,CAAC"}

package/dist/itch/client.d.ts

@@ -0,0 +1,46 @@
+import { DirectAssetDownloader } from "../download/direct-asset-downloader.js";
+import { type ItchPack, type ItchPackId } from "./catalog.js";
+export interface ItchDownloadEntry {
+    uploadId: string;
+    name: string;
+    sizeLabel?: string;
+    suggestedFileName: string;
+}
+export interface ItchPackDownloads {
+    pack: ItchPack;
+    downloads: ItchDownloadEntry[];
+}
+export interface ResolvedItchUpload {
+    pack: ItchPack;
+    upload: ItchDownloadEntry;
+    signedFileUrl: string;
+}
+export declare class ItchAssetError extends Error {
+    readonly code: "ITCH_PACK_NOT_FOUND" | "ITCH_UPLOAD_NOT_FOUND" | "ITCH_UPSTREAM_DENIED" | "ITCH_UPSTREAM_CHANGED" | "ITCH_UNSAFE_URL";
+    readonly retryable: boolean;
+    constructor(code: "ITCH_PACK_NOT_FOUND" | "ITCH_UPLOAD_NOT_FOUND" | "ITCH_UPSTREAM_DENIED" | "ITCH_UPSTREAM_CHANGED" | "ITCH_UNSAFE_URL", message: string, retryable?: boolean);
+}
+export interface ItchAssetClientOptions {
+    fetch?: typeof globalThis.fetch;
+    downloader?: DirectAssetDownloader;
+    timeoutMs?: number;
+}
+export declare class ItchAssetClient {
+    private readonly fetch;
+    private readonly downloader;
+    private readonly timeoutMs;
+    constructor(options?: ItchAssetClientOptions);
+    getPack(packId: ItchPackId): ItchPack;
+    listDownloads(packId: ItchPackId): Promise<ItchPackDownloads>;
+    download(packId: ItchPackId, uploadId: string): Promise<{
+        pack: ItchPack;
+        upload: ItchDownloadEntry;
+        result: import("../download/direct-asset-downloader.js").DirectAssetDownloadResult;
+    }>;
+    resolveUpload(packId: ItchPackId, uploadId: string): Promise<ResolvedItchUpload>;
+    private resolveDownloadPage;
+    private requestJson;
+    private validateSignedPageUrl;
+    private validateSignedFileUrl;
+}
+//# sourceMappingURL=client.d.ts.map

package/dist/itch/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/itch/client.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,qBAAqB,EAAE,MAAM,wCAAwC,CAAC;AAC/E,OAAO,EAAc,KAAK,QAAQ,EAAE,KAAK,UAAU,EAAE,MAAM,cAAc,CAAC;AAE1E,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,iBAAiB,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,iBAAiB;IAChC,IAAI,EAAE,QAAQ,CAAC;IACf,SAAS,EAAE,iBAAiB,EAAE,CAAC;CAChC;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,MAAM,EAAE,iBAAiB,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,cAAe,SAAQ,KAAK;aAErB,IAAI,EAChB,qBAAqB,GACrB,uBAAuB,GACvB,sBAAsB,GACtB,uBAAuB,GACvB,iBAAiB;aAEL,SAAS;IAR3B,YACkB,IAAI,EAChB,qBAAqB,GACrB,uBAAuB,GACvB,sBAAsB,GACtB,uBAAuB,GACvB,iBAAiB,EACrB,OAAO,EAAE,MAAM,EACC,SAAS,UAAQ,EAIlC;CACF;AAED,MAAM,WAAW,sBAAsB;IACrC,KAAK,CAAC,EAAE,OAAO,UAAU,CAAC,KAAK,CAAC;IAChC,UAAU,CAAC,EAAE,qBAAqB,CAAC;IACnC,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AA6CD,qBAAa,eAAe;IAC1B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAA0B;IAChD,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAwB;IACnD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YAAY,OAAO,GAAE,sBAA2B,EAI/C;IAED,OAAO,CAAC,MAAM,EAAE,UAAU,GAAG,QAAQ,CASpC;IAEK,aAAa,CAAC,MAAM,EAAE,UAAU,GAAG,OAAO,CAAC,iBAAiB,CAAC,CAGlE;IAEK,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,QAAQ,EAAE,MAAM;;;;OAalD;IAEK,aAAa,CACjB,MAAM,EAAE,UAAU,EAClB,QAAQ,EAAE,MAAM,GACf,OAAO,CAAC,kBAAkB,CAAC,CAwB7B;YAEa,mBAAmB;YAuCnB,WAAW;IAiCzB,OAAO,CAAC,qBAAqB;IAoB7B,OAAO,CAAC,qBAAqB;CAwB9B"}

package/dist/itch/client.js

@@ -0,0 +1,175 @@
+import { DirectAssetDownloader } from "../download/direct-asset-downloader.js";
+import { ITCH_PACKS } from "./catalog.js";
+export class ItchAssetError extends Error {
+    code;
+    retryable;
+    constructor(code, message, retryable = false) {
+        super(message);
+        this.code = code;
+        this.retryable = retryable;
+        this.name = "ItchAssetError";
+    }
+}
+function decodeHtml(value) {
+    return value
+        .replace(/&/g, "&")
+        .replace(/"/g, '"')
+        .replace(/'|'/g, "'")
+        .replace(/&lt;/g, "<")
+        .replace(/&gt;/g, ">");
+}
+function safeSuggestedFileName(name) {
+    const cleaned = name.replace(/[\\/:*?"<>|]/g, "_").trim().slice(0, 200);
+    return /\.[A-Za-z0-9]{2,5}$/.test(cleaned) ? cleaned : `${cleaned}.zip`;
+}
+function parseDownloads(html) {
+    const entries = [];
+    const uploadPattern = /data-upload_id="(\d+)"/g;
+    for (const match of html.matchAll(uploadPattern)) {
+        const uploadId = match[1];
+        if (!uploadId || match.index === undefined)
+            continue;
+        const window = html.slice(match.index, match.index + 2_000);
+        const nameMatch = window.match(/<strong[^>]*title="([^"]+)"[^>]*>/i);
+        if (!nameMatch?.[1])
+            continue;
+        const sizeMatch = window.match(/class="file_size"[^>]*>\s*<span[^>]*>([^<]+)<\/span>/i);
+        const name = decodeHtml(nameMatch[1]).trim();
+        entries.push({
+            uploadId,
+            name,
+            ...(sizeMatch?.[1] ? { sizeLabel: decodeHtml(sizeMatch[1]).trim() } : {}),
+            suggestedFileName: safeSuggestedFileName(name),
+        });
+    }
+    return entries;
+}
+function object(value) {
+    return typeof value === "object" && value !== null && !Array.isArray(value)
+        ? value
+        : undefined;
+}
+export class ItchAssetClient {
+    fetch;
+    downloader;
+    timeoutMs;
+    constructor(options = {}) {
+        this.fetch = options.fetch ?? globalThis.fetch;
+        this.downloader = options.downloader ?? new DirectAssetDownloader();
+        this.timeoutMs = options.timeoutMs ?? 30_000;
+    }
+    getPack(packId) {
+        const pack = ITCH_PACKS.find((candidate) => candidate.id === packId);
+        if (!pack) {
+            throw new ItchAssetError("ITCH_PACK_NOT_FOUND", "The requested itch.io pack is not in the curated catalog.");
+        }
+        return pack;
+    }
+    async listDownloads(packId) {
+        const { pack, downloads } = await this.resolveDownloadPage(packId);
+        return { pack, downloads };
+    }
+    async download(packId, uploadId) {
+        const { pack, upload: selected, signedFileUrl } = await this.resolveUpload(packId, uploadId);
+        const result = await this.downloader.download({
+            provider: "itch",
+            url: signedFileUrl,
+            fileName: selected.suggestedFileName,
+            identity: `${pack.id}:${selected.uploadId}`,
+            reportedSourceUrl: pack.pageUrl,
+        });
+        return { pack, upload: selected, result };
+    }
+    async resolveUpload(packId, uploadId) {
+        const { pack, downloads, signedPageUrl } = await this.resolveDownloadPage(packId);
+        const selected = downloads.find((entry) => entry.uploadId === uploadId);
+        if (!selected) {
+            throw new ItchAssetError("ITCH_UPLOAD_NOT_FOUND", "The requested upload ID is not present on the freshly resolved itch.io download page.");
+        }
+        const fileResponse = await this.requestJson(`${pack.pageUrl}/file/${encodeURIComponent(uploadId)}?source=game_download`, signedPageUrl);
+        const signedFileUrl = fileResponse.url;
+        if (typeof signedFileUrl !== "string") {
+            throw new ItchAssetError("ITCH_UPSTREAM_CHANGED", "itch.io did not return a signed file URL.");
+        }
+        this.validateSignedFileUrl(signedFileUrl);
+        return { pack, upload: selected, signedFileUrl };
+    }
+    async resolveDownloadPage(packId) {
+        const pack = this.getPack(packId);
+        const response = await this.requestJson(`${pack.pageUrl}/download_url`);
+        const signedPageUrl = response.url;
+        if (typeof signedPageUrl !== "string") {
+            throw new ItchAssetError("ITCH_UPSTREAM_CHANGED", "itch.io did not return a signed download page URL.");
+        }
+        this.validateSignedPageUrl(pack, signedPageUrl);
+        const page = await this.fetch(signedPageUrl, {
+            redirect: "error",
+            signal: AbortSignal.timeout(this.timeoutMs),
+            headers: { "user-agent": "threenative-asset-mcp/0.4.0" },
+        });
+        if (!page.ok) {
+            throw new ItchAssetError("ITCH_UPSTREAM_DENIED", `itch.io returned HTTP ${page.status} for the signed download page.`, page.status === 429 || page.status >= 500);
+        }
+        const html = await page.text();
+        const downloads = parseDownloads(html);
+        if (downloads.length === 0) {
+            throw new ItchAssetError("ITCH_UPSTREAM_CHANGED", "itch.io returned a download page without recognizable uploads.");
+        }
+        return { pack, downloads, signedPageUrl };
+    }
+    async requestJson(url, referer) {
+        const response = await this.fetch(url, {
+            method: "POST",
+            redirect: "error",
+            signal: AbortSignal.timeout(this.timeoutMs),
+            headers: {
+                accept: "application/json",
+                "user-agent": "threenative-asset-mcp/0.4.0",
+                ...(referer ? { referer } : {}),
+            },
+        });
+        if (!response.ok) {
+            throw new ItchAssetError("ITCH_UPSTREAM_DENIED", `itch.io returned HTTP ${response.status}.`, response.status === 429 || response.status >= 500);
+        }
+        try {
+            const parsed = object(await response.json());
+            if (!parsed)
+                throw new Error("not an object");
+            return parsed;
+        }
+        catch {
+            throw new ItchAssetError("ITCH_UPSTREAM_CHANGED", "itch.io returned invalid JSON.");
+        }
+    }
+    validateSignedPageUrl(pack, value) {
+        let signed;
+        const page = new URL(pack.pageUrl);
+        try {
+            signed = new URL(value);
+        }
+        catch {
+            throw new ItchAssetError("ITCH_UNSAFE_URL", "itch.io returned an invalid URL.");
+        }
+        if (signed.protocol !== "https:" ||
+            signed.origin !== page.origin ||
+            !signed.pathname.startsWith(`${page.pathname}/download/`)) {
+            throw new ItchAssetError("ITCH_UNSAFE_URL", "itch.io returned a signed page URL outside the curated pack origin.");
+        }
+    }
+    validateSignedFileUrl(value) {
+        let signed;
+        try {
+            signed = new URL(value);
+        }
+        catch {
+            throw new ItchAssetError("ITCH_UNSAFE_URL", "itch.io returned an invalid file URL.");
+        }
+        if (signed.protocol !== "https:" ||
+            !/^itchio-mirror\.[0-9a-f]+\.r2\.cloudflarestorage\.com$/i.test(signed.hostname) ||
+            !/^\/upload2\/game\/\d+\/\d+$/.test(signed.pathname) ||
+            !signed.searchParams.has("X-Amz-Signature")) {
+            throw new ItchAssetError("ITCH_UNSAFE_URL", "itch.io returned a signed file URL outside its official mirror contract.");
+        }
+    }
+}
+//# sourceMappingURL=client.js.map

package/dist/itch/client.js.map

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

package/dist/polyhaven/client.d.ts

@@ -0,0 +1,55 @@
+export type PolyHavenAssetType = "hdris" | "textures" | "models";
+export interface PolyHavenAsset {
+    id: string;
+    name: string;
+    description?: string;
+    type: PolyHavenAssetType;
+    category?: string;
+    categoryId?: string;
+    tags: string[];
+    authors: Record<string, string>;
+    attributes: Record<string, unknown>;
+    thumbnailUrl?: string;
+    maxResolution?: number[];
+    dimensions?: number[];
+    polycount?: number;
+    downloadCount?: number;
+    publishedAt?: string;
+    filesHash?: string;
+    donated?: boolean;
+    lods?: boolean;
+}
+export interface PolyHavenFile {
+    path: string;
+    url: string;
+    sizeBytes: number;
+    md5: string;
+    dependencyOf?: string;
+    relativePath?: string;
+}
+export declare class PolyHavenClientError extends Error {
+    readonly code: "POLYHAVEN_INVALID_INPUT" | "POLYHAVEN_NOT_FOUND" | "POLYHAVEN_RATE_LIMITED" | "POLYHAVEN_UPSTREAM_UNAVAILABLE" | "POLYHAVEN_UPSTREAM_CHANGED";
+    readonly retryable: boolean;
+    constructor(code: "POLYHAVEN_INVALID_INPUT" | "POLYHAVEN_NOT_FOUND" | "POLYHAVEN_RATE_LIMITED" | "POLYHAVEN_UPSTREAM_UNAVAILABLE" | "POLYHAVEN_UPSTREAM_CHANGED", message: string, retryable?: boolean);
+}
+type FetchLike = typeof fetch;
+export declare class PolyHavenClient {
+    private readonly fetchImpl;
+    private readonly cache;
+    private readonly timeoutMs;
+    private readonly userAgent;
+    constructor(fetchImpl?: FetchLike, options?: {
+        timeoutMs?: number;
+        userAgent?: string;
+    });
+    private request;
+    listAssets(type: PolyHavenAssetType | "all"): Promise<PolyHavenAsset[]>;
+    getAsset(id: string): Promise<PolyHavenAsset>;
+    listFiles(id: string): Promise<PolyHavenFile[]>;
+    listCategories(type: PolyHavenAssetType): Promise<Array<{
+        name: string;
+        assetCount: number;
+    }>>;
+}
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/polyhaven/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../src/polyhaven/client.ts"],"names":[],"mappings":"AAKA,MAAM,MAAM,kBAAkB,GAAG,OAAO,GAAG,UAAU,GAAG,QAAQ,CAAC;AAEjE,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,EAAE,kBAAkB,CAAC;IACzB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,IAAI,EAAE,MAAM,EAAE,CAAC;IACf,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,aAAa,CAAC,EAAE,MAAM,EAAE,CAAC;IACzB,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IACtB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,OAAO,CAAC;IAClB,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,MAAM,CAAC;IAClB,GAAG,EAAE,MAAM,CAAC;IACZ,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED,qBAAa,oBAAqB,SAAQ,KAAK;IAE3C,QAAQ,CAAC,IAAI,EACT,yBAAyB,GACzB,qBAAqB,GACrB,wBAAwB,GACxB,gCAAgC,GAChC,4BAA4B;IAEhC,QAAQ,CAAC,SAAS;IARpB,YACW,IAAI,EACT,yBAAyB,GACzB,qBAAqB,GACrB,wBAAwB,GACxB,gCAAgC,GAChC,4BAA4B,EAChC,OAAO,EAAE,MAAM,EACN,SAAS,UAAQ,EAI3B;CACF;AAED,KAAK,SAAS,GAAG,OAAO,KAAK,CAAC;AA+J9B,qBAAa,eAAe;IAMxB,OAAO,CAAC,QAAQ,CAAC,SAAS;IAL5B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IACnC,OAAO,CAAC,QAAQ,CAAC,SAAS,CAAS;IAEnC,YACmB,SAAS,GAAE,SAAiB,EAC7C,OAAO,GAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,SAAS,CAAC,EAAE,MAAM,CAAA;KAAO,EAKzD;YAEa,OAAO;IAqDf,UAAU,CAAC,IAAI,EAAE,kBAAkB,GAAG,KAAK,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC,CAY5E;IAEK,QAAQ,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAKlD;IAEK,SAAS,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,EAAE,CAAC,CAIpD;IAEK,cAAc,CAClB,IAAI,EAAE,kBAAkB,GACvB,OAAO,CAAC,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,UAAU,EAAE,MAAM,CAAA;KAAE,CAAC,CAAC,CAiBtD;CACF"}